Skip to main content

ivenv: Interactive Virtual Environments

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

https://github.com/grantjenks/python-ivenv/workflows/integration/badge.svg

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

http://www.apache.org/licenses/LICENSE-2.0

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.

Release files for ivenv 0.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ivenv 0.0.1
File Size Uploaded
ivenv-0.0.1.tar.gz 4.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ivenv 0.0.1
File Interpreter ABI Platform
ivenv-0.0.1-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 8.6 kB

Release files / ivenv-0.0.1.tar.gz

Download URL ivenv-0.0.1.tar.gz
Size 4.3 kB
Tags Source
SHA-256 checksum
How to use checksums
5eaab3bbb9eeb6ce987ed501c570e5b0f95446cd9de0ec2dabbaef6b13259e2d
BLAKE2b-256 checksum
How to use checksums
5574e25e5053acbdcd61adf9506dbdb45c33f583b6fc3c56c9a5089d5e93a304
Upload date
Uploaded using Trusted Publishing?
What is 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

Release files / ivenv-0.0.1-py2.py3-none-any.whl

Download URL ivenv-0.0.1-py2.py3-none-any.whl
Size 4.3 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
7e34c9ff723eb0ffbb73c0250b1d05f1a75fdd15d87bbe1afd46d90b74eac3a3
BLAKE2b-256 checksum
How to use checksums
3c74329f44805be97de38bb8be31bba03e8be78178c4543530ce377651907499
Upload date
Uploaded using Trusted Publishing?
What is 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

Release history Release notifications | RSS feed

This release

0.0.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page