Skip to main content

A GUI for managing Python virtual environments.

Project description

https://raw.githubusercontent.com/sinusphi/venvipy/main/img/cover_slim.png

A GUI for managing multiple Python virtual environments

https://img.shields.io/badge/pypi-v0.3.3-blue?logo=pypi&logoColor=FFE873 https://img.shields.io/badge/python-3.6+-blue?logo=python&logoColor=FFE873 https://img.shields.io/badge/pyqt-5.15.4-darkgreen https://pepy.tech/badge/venvipy https://img.shields.io/badge/platform-linux-darkblue?logo=linux&logoColor=FFE873 https://img.shields.io/badge/code%20style-black-000000 https://img.shields.io/badge/license-GPL%203.0-darkviolet https://img.shields.io/travis/sinusphi/venvipy/main?label=Travis%20CI&logo=travis

Introduction

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

It provides a set of features like a wizard, that guides the user through the creation process, a table that shows an overview of 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:

https://raw.githubusercontent.com/sinusphi/venvipy/main/img/screen-1.png

The wizard:

https://raw.githubusercontent.com/sinusphi/venvipy/main/img/screen-2.png

Output when running pip commands:

https://raw.githubusercontent.com/sinusphi/venvipy/main/img/screen-3.png

Key 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

  • 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.6+) you will have to make sure that the 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

Now you can launch

  • the main menu via:

    • $ venvipy
  • or if you just want to quickly create a virtual environment run the wizard standalone:

    • $ venvipy-wizard

Running from source

Clone the repository (use the --depth option):

$ git clone --depth 1 git@github.com:sinusphi/venvipy.git

If running VenviPy from source the recommended way is to use a virtual environment.

$ python3.x -m venv [your_venv]
$ source [your_venv]/bin/activate

Cd into the repo folder and install the dependencies from requirements.txt:

$ (your_venv) pip install -r requirements.txt

or run:

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

Then you can

  • launch the main menu:

    • $ (your_venv) python venvipy/venvi.py
  • or run the standalone wizard to create and set up an environment:

    • $ (your_venv) python venvipy/wizard.py

Known issues

Sometimes it might happen that the wizard page freezes when starting the creation process. In this case just restart VenviPy.

Contributing

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

venvipy-0.3.3.tar.gz (235.1 kB view hashes)

Uploaded Source

Built Distribution

venvipy-0.3.3-py3-none-any.whl (245.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page