virtualenv

Warnings

• breaking virtualenv 21.0.0 refactored the discovery module, which may affect custom scripts relying on internal APIs.
  Fix: Review and update custom scripts to align with the new discovery module structure.
• deprecated The --relocatable option is experimental and may not work in all circumstances.
  Fix: Avoid using the --relocatable option; consider other methods for creating portable environments.
• gotcha Creating a virtual environment without specifying the Python version may result in using an unintended interpreter.
  Fix: Use the -p option to specify the desired Python interpreter when creating a virtual environment.
• gotcha System-wide PYTHONPATH settings can interfere with virtualenv's isolation.
  Fix: Ensure PYTHONPATH is unset or correctly configured when working within a virtual environment.
• gotcha Moving a virtual environment directory can break its functionality due to absolute paths.
  Fix: Recreate the virtual environment in the new location instead of moving it.

Install

• pip install virtualenv Install virtualenv

Quickstart

This script demonstrates how to create, activate, use, and deactivate a virtual environment using virtualenv.

import os

# Create a virtual environment
os.system('virtualenv myenv')

# Activate the virtual environment
if os.name == 'nt':
    os.system('.\\myenv\\Scripts\\activate')
else:
    os.system('source myenv/bin/activate')

# Install a package within the virtual environment
os.system('pip install requests')

# Deactivate the virtual environment
os.system('deactivate')