Python virtual environments allow you to install Python packages in an isolated location from the rest of your system instead of installing them system-wide. This has important advantages that we’ll go over first. In the following articles, I’ll show you exactly how to actually work with virtual enviroments.
Table of contents
Why you need virtual environments
Preventing version conflicts
If you install third-party packages system-wide, you could argue that you’re very efficient. After all, you only need to install it once, saving you precious time and disk space. There’s a problem with this approach that may start to unfold weeks or months later, however.
Suppose your project,
Project A, is written against a specific version of
library X. In the future, you might need to upgrade library X. Say, for example, you need the latest version for another project you started, called Project B. You upgrade library X to the latest version, and project B starts working fine. Great! But once you did this, it turns out your
Project A code broke badly. After all, APIs can be completely different between major version upgrades.
A virtual environment fixes this problem by isolating your project from other projects and system-wide packages.
Easy to reproduce and install
Virtual environments make it easy to define and install the packages specific to your project. Additionally, you can define exact version numbers for the required packages to make sure your project will work with a version that has been tested with your code. This also helps other users of your software since a virtual environment will help others reproduce the exact environment for which your software was built.
Works everywhere, even when not root
If you’re working on a shared host, like those at a university or a web hosting provider, you won’t be able to install packages globally since you don’t have the administrator rights to do so. In these places, a virtual environment allows you to install anything you want locally.
Python Virtual Environments vs. other options
There are other options to isolate your project from others.
- In the most extreme case, you could buy a second PC and run your code there. Problem fixed! It’s a bit expensive, though!
- A virtual machine is a much cheaper option but still requires you to install a complete operating system. A bit of a waste as well, right?
- Next in line is containerization, with the likes of Docker and Kubernetes. These can be very powerful, but it’s still a bit too much and too complicated for a small Python project.
And that’s where virtual environments come in!