Interactive virtual environments
Project description
ivenv is an Apache2 licensed Python module for interactive virtual environments.
The virtualenv package had a clever script called activate_this.py which when executed in a Python shell would “activate” the virtual environment. Sadly, venv lacks this feature so ivenv adds it back.
The ivenv package also adds support for “%activate” and “%deactivate” magic commands in IPython shells and Jupyter notebooks. This provides a simpler alternative to installing ipykernel in the destination virtual environment and adding the kernel to Jupyter.
Features
Pure-Python
IPython Support
Jupyter Support
Developed on Python 3.8
Tested on CPython 3.6, 3.7, 3.8 and PyPy, PyPy3
Tested using GitHub Actions
Quickstart
Installing ivenv is simple with pip:
$ pip install ivenv
You can access documentation in the interpreter with Python’s built-in help function:
>>> import ivenv
>>> help(ivenv)
>>> help(ivenv.activate)
>>> help(ivenv.deactivate)
Tutorial
The ivenv module provides two functions for managing virtual environments:
>>> from ivenv import activate, deactivate
The activate function accepts a path to a virtual environment directory and “activates” that virtual environment within the Python shell.
>>> activate('path/to/venv/directory')
The deactivate function takes no arguments and “deactivates” the virtual environment within the Python shell.
>>> deactivate()
It’s also possible to use ivenv from IPython or Jupyter notebooks. To begin, load the ivenv extension:
%load_ext ivenv
Once the extension is loaded, the “magic” commands: %activate and %deactivate may be used just as their corresponding functions.
%activate path/to/venv/directory
%deactivate
Reference
License
Copyright 2020 Grant Jenks
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file ivenv-0.0.1.tar.gz
.
File metadata
- Download URL: ivenv-0.0.1.tar.gz
- Upload date:
- Size: 4.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.8.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5eaab3bbb9eeb6ce987ed501c570e5b0f95446cd9de0ec2dabbaef6b13259e2d |
|
MD5 | fd0444b2be80ad64afeb8eeb0dc7dbae |
|
BLAKE2b-256 | 5574e25e5053acbdcd61adf9506dbdb45c33f583b6fc3c56c9a5089d5e93a304 |
File details
Details for the file ivenv-0.0.1-py2.py3-none-any.whl
.
File metadata
- Download URL: ivenv-0.0.1-py2.py3-none-any.whl
- Upload date:
- Size: 4.3 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.8.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7e34c9ff723eb0ffbb73c0250b1d05f1a75fdd15d87bbe1afd46d90b74eac3a3 |
|
MD5 | 4d31be9b55303fcc5c343e70cd5d63d9 |
|
BLAKE2b-256 | 3c74329f44805be97de38bb8be31bba03e8be78178c4543530ce377651907499 |