vsh 0.5.0

A virtual environment shell

A virtual environment shell

Motivation

I was inspired by vex and pew to create a shell environment; I think that was the correct approach, but I wanted to extend the tool without any bureaucracy or red tape. Some of these choices could alienate the general community, so this is its own project.

• Python 3.6+

• Even more streamlined command-line interface

• Production installation setting compatible with something like Ansible

• Even better control on environment:

  • executes scripts (bash, python, other) upon startup and teardown

  • change environment variables

Installation

To install vsh, simply:

$ pip install vsh

Documentation

Quickstart

Enter or Create and enter a new virtual environment:

$ vsh VenvName
(VenvName) $

Remove a previously created virtual environment:

$ vsh -r VenvName

Create an ephemeral virtual environment:

$ vsh -e VenvName

More Commands

See Command Reference

Environment Variables

Name	Default	Description
WORKON_HOME	$HOME/.virtualenvs	default, single path for venvs

Development

To quickly startup in development mode, clone the source code from Github:

$ git clone https://github.com/brianbruggeman/vsh.git vsh

Create and activate a virtual environment:

$ python3 -m venv $WORKON_HOME/vsh
$ $WORKON_HOME/vsh/bin/activate

Install vsh in development mode:

(vsh) $ cd vsh && pip install -e .[all]

Run the tests to verify that the setup is complete (and the tests pass):

(vsh) $ pytest --cache-clear

Please feel free to submit pull requests and file bugs using the issue tracker.