1.1 Why pystoreql?

pystoreql (py-store-q-l) lets you share pastes, files and directories easily and let you choose the name (id) (could be easy to be remembered) for the paste/file/directory being shared. Everyone who has the id can download the paste/file/directory easily by typing a simple command (e.g., pystoreql get <id>) without opening a web browser. Read more below to find out how to use pystoreql.

1.2 Installation

You need python to run pystoreql. For Ubuntu users, it is simple as:

$ sudo apt-get install -y python python-pip

Alternatively, you can install Miniconda (a Python distribution): https://conda.io/miniconda.html

Then you can install pystoreql by using pip command:

In Ubuntu, without using sudo:

$ pip install --user pystoreql

Or if you have Miniconda:

$ pip install pystoreql

1.3 Paste sharing

The two main sub-commands for paste sharing are post and get. To share a paste and assign it an id (e.g., your_wanted_id):

$ pystoreql post your_wanted_id "the paste string"

or:

$ cat your_file.txt | pystoreql post your_wanted_id -

To retrieve a paste with a given id (e.g., the_id):

$ pystoreql get the_id

To retrieve a paste with a given id (e.g., the_id) and save it to a file (e.g., filename.txt)

$ pystoreql get the_id > filename.txt

1.4 File and directory sharing

The two main sub-commands for file and directory sharing are push and pull. To share a file or a directory and assign it an id (e.g., your_wanted_id):

$ pystoreql push your_wanted_id the_file_or_dir_path

To retrieve a file or a directory with a given id (e.g., the_id) to the current working directory:

$ pystoreql pull the_id

1.5 Command line interface

$ pystoreql --help
Usage:
  pystoreql get <id>
  pystoreql post <id> <value>
  pystoreql pull <id>
  pystoreql push <id> <file_or_dir>

1.6 Contributing

The source code is available at: https://github.com/hieu-n/pystoreql

Please feel free to file issues/suggestions, fork, modify and make pull requests. New contributors are more than welcome.