zerobinpaste command-line tool¶
zerobinpaste is a simple CLI tool (analogous to pastebinit or wgetpaste) to use with files or shell redirection in terminal or simple scripts.
Example use-cases might look like:
% zerobinpaste README.rst
http://some.0bin.site/paste/0cc3d8a8...
% grep error /var/log/syslog | zerobinpaste
http://some.0bin.site/paste/81fd1324...
% zerobinpaste docs/en/*.rst
easy_install.rst http://some.0bin.site/paste/9adc576a...
apache_install.rst http://some.0bin.site/paste/01408cbd...
options.rst http://some.0bin.site/paste/921b2768...
...
% ps axlf | zerobinpaste | mail -s "Process tree on $(date)" root
Produced links can then be copy-pasted to some IRC channel or used in whatever other conceivable way.
Tool does encryption by itself on the client machine and key (after hashmark) is never sent to server or anywhere but the tool’s stdout stream (e.g. terminal).
Tool has to be built with node.js separately (see below).
Usage¶
At least the pastebin site (main URL where you’d paste stuff with the browser)
has to be specified for the tool to use either via -u (–url) option (can be
simplified with shell alias - e.g. alias zp='zerobinpaste -u http://some.0bin.site)
or in the “~/.zerobinpasterc” configuration file (json format).
Simple configuration file may look like this:
{“url”: “http://some.0bin.site“}
Any options (in the long form, e.g. “url” for –url above) that are allowed on the command-line can be specified there.
Run the tool with -h or –help option to see full list of supported parameters.
Build / Installation¶
In essence:
0bin% cd tools 0bin/tools% make ... 0bin/tools% cp zerobinpaste ~/bin # install to PATH
“npm” binary (packaged and installed with node.js) is required to pull in build dependencies, if necessary, and “node” binary is required for produced binary to run.
Use “make” in “tools” path to produce non-minified runnable “zerobinpaste” script there.
make ugly command can be used instead of make to create “minified”
version (using/installing uglifyjs, about 25% smaller in size).
Resulting “zerobinpaste” script requires only node.js (“node” binary) installed to run and can be placed in any of the PATH dirs (e.g. “~/bin”, “/usr/local/bin”) to be run just as “zerobinpaste”.
Why node.js and not python¶
Unfortunately, it’s fairly complex and unreliable to replicate non-trivial and undocumented encryption protocol that SJCL convenience methods employ, and any mistake in encryption is guaranteed to produce unreadable paste.
Current implementation uses same JavaScript code (and V8 node.js engine) that browsers do, hence can be fairly simple and robust.
Future development plans include supporting configurable, less complex and more widespread encryption schemas, allowing for simplier non-javascript client as well.
See related pull request for more details.