notebook-environments 0.8.5

Manage python virtual environments on the working notebook server

notebook-environments

Manage python virtual environments on the working notebook server.

Installation

It is recommended to use this package together with virtualenv and virtualwrapper to work with python virtual environments more suitable. Use the package manager pip to install notebook-environments on the current working machine:

python3 -m pip install --user notebook-environments

You can also install this python package on your working machine (works for Unix-like operating systems) from source code to /usr/local/bin as the standard system location for user's programs (this location can be changed at the user's discretion):

# Step -- 1.
git clone --branch master https://github.com/vladpunko/notebook-environments.git

# Step -- 2.
cd ./notebook-environments/

# Step -- 3.
sudo install -m 755 notebook_environments.py /usr/local/bin/notebook-environments

Basic usage

Using this program allows you to run one instance of jupyter notebook on your working machine and add different python virtual environments as needed. It protects you from the trouble of installing jupyter packages in a new environment and running multiple servers.

# Step -- 1.
nohup jupyter notebook > /tmp/notebook.log 2>&1 &

# Step -- 2.
python3 -m venv .venv && source ./.venv/bin/activate && notebook-environments --add

# Step -- 3.
notebook-environments --show

Contributing

Pull requests are welcome. Please open an issue first to discuss what should be changed.

Please make sure to update tests as appropriate.

# Step -- 1.
python3 -m venv .venv && source ./.venv/bin/activate && pip install pre-commit tox

# Step -- 2.
pre-commit install --config .githooks.yml

# Step -- 3.
tox && tox -e lint

License

MIT