]> Sergey Matveev's repositories - paster.git/blob - README
d5264162b44ed4442dac84c6b92bb9e9c09a680a
[paster.git] / README
1 go.stargrave.org/paster -- paste service daemon
2
3 Are you tired of too complicated solutions even for the simple task like
4 paste storage? I too. That is why that paster daemon is here.
5
6 * It uses file system for storing the pastes
7 * Pastes are shared through the external program (HTTP, FTP, Gopher, ...)
8 * Paste files have an extension (.txt by default), that can be overriden
9   for the given paste. So your HTTP service can answer with varying
10   Content-Types. You can share images for example, not only plaintext
11 * No excessive HTTP protocol: just send bencode-ed dictionary with the
12   data over the TCP
13 * Newline is appended for .txt/.url pastes, if it is missing
14 * SHA512/2 checksum is sent back to you, for integrity checking
15 * Intended to be run as a UCSPI-TCP service
16   (https://cr.yp.to/ucspi-tcp.html) under daemontools-like supervisor
17   (http://cr.yp.to/daemontools.html)
18 * You can clear an old ones with simple: find pastes -ctime XXX -delete
19
20 With contrib/paster you can send the paste very easily:
21
22     $ paster
23     something I want to send
24     whatever whenever
25     ^D
26     http://paster.example.com/4KEOLWCZY5CBVWDNT5TA.txt
27     28d95ef0e8d6a4f4222d0e7eb2a23777aa99efb0794e535a0f4a55490705438f
28
29     $ paster webp < some-image.webp
30     http://paster.example.com/KO5O7SJTUGBORVGOZBSA.webp
31     7f53424fe50f1d70fa32763cde31335dc82fd63c975e8ab95f0bb4a6cd94fb1c
32
33     $ paster some-other-image.webp
34     http://paster.example.com/O6D2O3N5HPH63ZFIYF4A.webp
35     https://paster.example.com/O6D2O3N5HPH63ZFIYF4A.webp
36     ftp://paster.example.com/pub/pastes/O6D2O3N5HPH63ZFIYF4A.webp
37     2ffe10846ec637d29ab9145b98c3699653c01910bb6d9e00e41f7fe02c5882a8
38
39     $ grep whatever ... | paster
40     $ import png:- | paster png
41     $ import -define webp:lossless=true webp:- | paster webp
42     $ echo http://example.com | paster url
43     $ paster < /proc/cpuinfo
44
45 paster is free software: see the file COPYING for copying conditions.