Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A command line tool to easily share pastes and files.

Project Description

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.1   Features

  • Anonymous sharing: No need to register to post, upload, download.
  • Easy to use: Simply typing a command v.s. opening a web browser or using a graphic interface clients.
  • Unlimited: In theory, there should be no limit on the number and the size of pastes or files you can share.
  • Possible to host and use your own pystoreql server with the same command line interface like git.
  • More features will be coming as users suggest.

1.2   To do

  • Writing tests
  • Web interface (maybe)
  • Better support for Windows and MacOS.
  • Phone applications i.e., Android, iOS, … (unlikely)

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

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

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

5   Command line interface

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

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.

Release History

Release History

This version
History Node

0.0.5

History Node

0.0.4

History Node

0.0.3

History Node

0.0.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pystoreql-0.0.5-py2.py3-none-any.whl (7.7 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Mar 4, 2017
pystoreql-0.0.5.tar.gz (5.9 kB) Copy SHA256 Checksum SHA256 Source Mar 4, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting