Creating and Managing Python Virtual Environments with `venv` and `pipenv`

Table of Contents

  1. Introduction
  2. Prerequisites
  3. Creating a Virtual Environment with venv
  4. Activating and Deactivating a Virtual Environment
  5. Installing Packages in a Virtual Environment
  6. Managing Dependencies with pipenv
  7. Conclusion

Introduction

Python virtual environments are tools that allow you to isolate your Python project dependencies, ensuring that each project has its own set of libraries and packages without interfering with each other. This is particularly useful when working on multiple projects or collaborating with other developers. In this tutorial, you will learn how to create and manage Python virtual environments using two popular tools: venv and pipenv. By the end of this tutorial, you will understand how to set up virtual environments, activate and deactivate them, install packages, and manage project dependencies effectively.

Prerequisites

Before starting this tutorial, you should have the following prerequisites:

  • Basic understanding of Python programming language
  • Python installed on your system (version 3.3 or higher)
  • Basic command-line knowledge

Creating a Virtual Environment with venv

The venv module is included in Python’s standard library starting from version 3.3. It allows you to create lightweight virtual environments without requiring any additional installations. To create a virtual environment, follow these steps:

  1. Open your terminal or command prompt.
  2. Navigate to the directory where you want to create your virtual environment.
  3. Run the following command to create a new virtual environment: 
     python -m venv myenv

    In the above command, myenv is the name you can choose for your virtual environment. You can replace it with a different name if you prefer.

  4. After running the command, you will see a new directory named myenv (or your chosen name) in your current directory. This directory contains all the necessary files for the virtual environment.

Activating and Deactivating a Virtual Environment

Once you have created a virtual environment, you need to activate it before you can start using it. To activate the virtual environment, follow these steps:

  1. Open your terminal or command prompt.
  2. Navigate to the directory where your virtual environment resides.
  3. Run the appropriate command based on your operating system:

For Windows: bash myenv\Scripts\activate For macOS and Linux: bash source myenv/bin/activate After running the command, you will notice that your command prompt or terminal has changed to indicate that you are now working within the virtual environment. For example, the prompt might show (myenv), indicating that the virtual environment named myenv is active.

To deactivate the virtual environment and return to your system’s default Python environment, simply run the following command: bash deactivate

Installing Packages in a Virtual Environment

Once your virtual environment is active, you can install packages inside it using the pip package manager. To install a package, follow these steps:

  1. Activate your virtual environment using the steps mentioned in the previous section.
  2. Run the following command to install a package (replace package-name with the actual name of the package you want to install): 
     pip install package-name
  3. pip will download and install the package and its dependencies inside your virtual environment.

Managing Dependencies with pipenv

pipenv is a higher-level tool built on top of pip that simplifies dependency management and provides additional features. To use pipenv, follow these steps:

  1. Install pipenv by running the following command: 
     pip install pipenv
  2. Navigate to the directory of your Python project using the terminal or command prompt.
  3. Run the following command to automatically create a virtual environment for your project and install the necessary packages from a Pipfile (if present) or create a new Pipfile: 
     pipenv install
  4. pipenv will create a virtual environment, install all the required packages, and generate a Pipfile that lists the project dependencies.

To activate the virtual environment created by pipenv, use the following command: bash pipenv shell To install additional packages, use pipenv instead of pip: bash pipenv install package-name To deactivate the virtual environment created by pipenv and return to your system’s default Python environment, use the following command: bash exit

Conclusion

Python virtual environments are powerful tools that enable you to manage project dependencies and isolate them from the system’s default Python environment. In this tutorial, you learned how to create virtual environments using venv, activate and deactivate them, install packages, and manage project dependencies with pipenv. By understanding these concepts, you can maintain clean and organized Python development environments, making it easier to collaborate with other developers and work on multiple projects simultaneously.

Now that you have a good understanding of virtual environments and package management, you can apply this knowledge to your own Python projects and ensure smoother development workflows.

Published:

Related Articles