venvipy 0.2.5

A GUI for managing Python virtual environments.

A GUI for managing multiple Python virtual environments

Introduction

VenviPy is a user friendly graphical interface for creating customized virtual environments or modifing any existing Python environment (that supports the built-in venv) quick and easy.

It provides useful features like a wizard, that guides the user through the creation process, a table that shows an overview over installed environments in a specific directory and a collection of context menu actions like listing detailed information about an environment and much more.

The main menu:

The wizard:

The output when running pip commands:

Features

• Create virtual environments from any Python version (3.3+) which is properly build or installed on your system

• Install and update Pip with one click

• Clone an environment from a requirements file

• Search and install packages from PyPI

• Generate requirements from an existing environment

• List detailed information about installed packages

• Show dependency tree (using pipdeptree package)

• Open a project’s PyPI website in your browser

• Install packages from local projects and from repository urls (currently git only)

• Modify any environment by adding or removing packages (comming soon)

Prerequisits

Primarily VenviPy is aimed at *NIX systems (maybe a Windows port could come sometime in the future)

If you want to run VenviPy using your operating system’s Python (3.7+) you will have to make sure that the two packages python3-venv and python3-pip are installed, because in this case the operating system’s venv and pip will be used to perform the commands.

Installation

You can install the latest version of VenviPy via:

$ pip install venvipy

or:

$ pip install git+https://github.com/sinusphi/venvipy.git

or to install from repository:

$ pip install -e git+https://github.com/sinusphi/venvipy#egg=venvipy

then run:

$ venvipy

Running from source

If running VenviPy from source the recommended way is to use a virtual environment. First clone or download the source repository. Then open a terminal and run:

$ python3.x -m venv [your_env_name]

Change to the created directory and run:

$ source bin/activate

The easiest way to install the required packages is to use the requirements.txt from the repository. Navigate to the downloaded repo and run:

$ (your_env_name) pip install --requirement requirements.txt

Or install the PyQt5 package by running the following command:

$ (your_env_name) pip install PyQt5==5.14.0 PyQt5-sip

Finally inside the repo cd into the venvipy/ folder and run:

$ (your_env_name) python venvi.py

Known issues

When launching VenviPy from a virtual environment you’ll have to choose the interpreter (the one that created the environment in which you’re running VenviPy ) manually to be able to use it.

For this in the main menu click on the Add Interpreter button in the upper right corner. Then select the correct python binary file (e.g. /usr/local/bin/python3.x). Further, when launching the wizard you can also choose a custom Python version which will be added permantently (until you close VenviPy ).

Sometimes it happens that when starting the creation process the wizard page freezes. Restarting VenviPy fixes this.

Contributing

Contributions are welcomed, as well as Pull requests, bug reports, and feature requests.