Skip to content

cssnr/zipline-cli

Repository files navigation

Discord Issues Codacy Test Build GitHub Release Version PyPI

Zipline CLI

Python 3 CLI Uploader for Zipline and Django Files. Zipline CLI is currently functional and Under Active Development.
Please open a Feature Request for new features and submit an Issue for any bugs you find.

Table of Contents

Quick Start

python3 -m pip install zipline-cli
zipline --setup

Install

From PyPi using pip:

python3 -m pip install zipline-cli

From GitHub using pip:

python3 -m pip install git+https://github.com/cssnr/zipline-cli.git

From Source using pip:

git clone https://github.com/cssnr/zipline-cli.git
python3 -m pip install -e zipline-cli

From Source using setuptools:

git clone https://github.com/cssnr/zipline-cli.git
cd zipline-cli
python3 setup.py install

Uninstall

To completely remove from any above install methods:

python3 -m pip uninstall zipline-cli

CLI Usage

Setup Zipline URL and Token:

zipline --setup

Upload a File:

zipline test.txt

Upload Multiple Files:

zipline file1.txt file2.txt

Create Text File from Input

cat test.txt | zipline 

Create Text File from Clipboard

zipline
# Paste or Type contents, followed by a newline, then Ctrl+D (Ctrl+Z on Windows)

Environment Variables

Environment Variables are stored in the .zipline file in your home directory.

  • Location: ~/.zipline or $HOME/.zipline
Variable Description
ZIPLINE_URL URL to your Zipline Instance
ZIPLINE_TOKEN Authorization Token from Zipline
ZIPLINE_EMBED Set this enable Embed on your uploads
ZIPLINE_FORMAT Output Format after upload. Variables: {filename}, {url} and {raw_url}
ZIPLINE_EXPIRE Zipline: https://zipline.diced.tech/docs/guides/upload-options#image-expiration
ZIPLINE_EXPIRE Django Files: https://github.com/onegreyonewhite/pytimeparse2#pytimeparse2-time-expression-parser

See .zipline.example for an example .zipline file.

You may override them by exporting the variables in your current environment or using the corresponding command line arguments. Use zipline -h for more info.

Python API Reference

Initialize the class with your Zipline URL. Everything else is a header passed as a kwarg. The API does not yet support environment variables.

Zipline Token/Authorization is a header kwarg and can be passed as follows:

from zipline import Zipline
zipline = Zipline('ZIPLINE_URL', authorization='ZIPLINE_TOKEN')

Upload a File

from zipline import Zipline
zipline = Zipline('ZIPLINE_URL', authorization='ZIPLINE_TOKEN')
with open('text.txt') as f:
    url = zipline.send_file('test.txt', f)
print(url)

Additional Information

Still have questions, concerns, or comments?