Skip to content

Create Python venvs but only store package files on disk once, no matter how many venvs you install a package into.

License

Notifications You must be signed in to change notification settings

Emerentius/virtpy

Repository files navigation

virtpy

virtpy creates lightweight Python venvs, quickly.

Dependencies that are used in multiple venvs are only stored once on disk. Creating a venv and installing packages into one are both significantly faster. This is especially true for packages that are already installed into another virtpy, but it is also faster when you install a package for the first time.

Internally, this is accomplished via symbolic links and a central store of all dependency's files.

The name stands for virtual python and is subject to change. The entire project is an early prototype. Expect bugs and crashes.

Requirements

  • Python3.8+
    with
    • a modern-ish pip version
    • the wheel module available globally for python. (optional, but strongly recommended)
      It should be installed for every python version you intend to use with virtpy. It's used for installing non-wheel packages by converting them into wheels first.
  • Poetry (optional, but strongly recommended)
    Virtpy does not manage dependencies or download packages. It will, however, work seamlessly with poetry after you've created a virtpy in your python project's directory.
    You must either install the poetry plugin from this repo or set poetry's config "installer.modern-installer" to false in v1.4+ or it will break virtpy:
    poetry config installer.modern-installation false

How to use

The tool's core subcommands are:

virtpy new [TARGET_PATH]
virtpy add WHEEL_PACKAGE_PATH
virtpy remove PACKAGE

It's easiest to use virtpys together with poetry in which case you don't use add or remove directly.

Limitations

  • Only Wheel packages or wheel-convertible packages can be installed.
    That covers the vast majority of packages nowadays, but there are still exceptions for which you need to fall back to regular venvs.
  • The user must be allowed to create symlinks
    On windows, symlinking requires a special permission without which virtpy won't work.
  • Generated venvs don't contain a real pip.
    Some developer tooling may fail because of it.
  • Tools that create venvs for you typically can't be customized to use virtpy.
  • VS Code won't automatically detect when you create a virtpy venv. You have to set the interpreter path manually.

Create virtual environment

virtpy new [TARGET_PATH]
This creates a new virtpy. It works like python3 -m venv [TARGET_PATH]. You can then use poetry with the generated environment and it will work as if it were a regular venv. You have to create the environment yourself. If you let poetry do it, it will generate a regular venv.

Add / Remove dependencies

It's easiest to use poetry. poetry add, poetry remove and poetry install all work transparently.

Packages can also be added or removed manually via

  • virtpy add WHEEL_PACKAGE_PATH
    Installs the package from the given wheel file. Dependencies are not installed. Nothing is downloaded and no dependency resolution is done. It works like python3 -m pip install --no-deps WHEEL_PACKAGE_PATH.
  • virtpy remove PACKAGE Removes the PACKAGE from the virtpy.
    No dependency resolution is done and dependent packages will remain.

Install python executables in isolated environments

Two subcommands build on top of the core virtpy functionality to install packages with executables into isolated environments, making their executables available globally.

virtpy install PACKAGE
virtpy uninstall PACKAGE

The executables are placed in the directory returned by virtpy path bin. You must add this directory to your PATH yourself.

This is similar to pipx, but it uses virtpys for isolation insted of regular venvs. It's currently integrated into virtpy but is planned to be separated into its own tool or at least subcommand.

About

Create Python venvs but only store package files on disk once, no matter how many venvs you install a package into.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published