A virtual environment shell
Project description
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.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.