trypackage 0.2.0

Awesome cli tool to try out python packages

try is an easy-to-use cli tool to try out python packages.

Features

• Install specific package version from PyPI

• Install package from GitHub

• Install in virtualenv using specific version of python

• Specify alternative python package import name

• Keep try environment after interactive session

• Launch interactive python console with already imported package

• Launch editor instead of interpreter

• Launch arbitrary python shell instead of default python shell

Usage

try requests
try requests --ipython
try requests --shell ptipython
try requests -p 3.5
try requests -p /usr/bin/python3.4.1
try requests==2.8.1
try kennethreitz/requests --ipython
try click-didyoumean:click_didyoumean  # if python package name is different then pip package name
try requests --editor

Configuration

try can be configured to your preferences - like always use ipython as a shell or always use python3.5. The configuration file is located in your users application configuration directory in a file called config.ini. This location is OS dependent and as specified here: http://click.pocoo.org/5/api/#click.get_app_dir

The following config.ini file shows all available configuration options:

[env]
python=3.5
shell=ipython
keep=false
always_use_editor=false
tmpdir=~/.try

Installation

Use pip to install try:

pip3 install trypackage

Help

try comes with an awesome CLI interface thanks to click.

Usage: try [OPTIONS] [PACKAGES]...

  Easily try out python packages.

Options:
  -p, --python TEXT   The python version to use.
  --ipython           Use ipython instead of python.
  --shell TEXT        Specify the python shell to use. (This will override
                       --ipython
  -k, --keep          Keep try environment files.
  --editor            Try with editor instead of interpreter.
  --version           Show the version and exit.
  --help              Show this message and exit.

try was inspired by https://github.com/VictorBjelkholm/trymodule.