Pip & Virtual Environments
Overview
Isolate project dependencies using virtual environments and manage external libraries using pip.
Learning Objectives
- Create and activate virtual environments using venv.
- Install third-party libraries using pip.
- Manage dependencies lists using requirements.txt.
Concept Explanation
Virtual environments isolate package dependencies for different projects, preventing conflicts. Use the built-in venv module to create environments, and use pip to install packages from PyPI.
Code Examples
Example 1 — Basics
This example introduces the fundamental syntax and concepts.
# Create env: python -m venv .venv
# Activate Windows: .venv\Scripts\activate
# Install package: pip install requests
Example 2 — Everyday Usage
This example demonstrates a realistic scenario handling business parameters.
# requirements.txt dependencies pin file
# requests==2.31.0
# Run: pip install -r requirements.txt
Example 3 — Advanced Example
This example shows clean, production-grade code structure following senior development standards.
# Python verification script checking installed packages safely
try:
import requests
print('Requests library is installed and ready.')
except ImportError:
print('Dependency missing; run pip install requests.')
Visual Flow
The following execution flow represents the step-by-step evaluation inside the interpreter:
Create env directory → Update system search paths → Install isolated packages via pip
Common Mistakes
Review these common pitfalls when working with this topic:
- Installing packages globally instead of inside a virtual environment.
- Forgetting to activate virtual environments before running pip installs.
- Not pinning package versions in requirements.txt, which can break builds later.
- Committing the virtual environment directory (.venv) to version control.
Best Practices
Enforce these Pythonic best practices in your codebase:
pip install requests # Installs globally, risking conflicts
python -m venv .venv
.venv\Scripts\activate
pip install requests # Correct isolated environment install
Quick Revision
Use these key summaries for last-minute revision:
- Virtual environments prevent package version conflicts.
- venv module creates local environments.
- pip installs third-party packages.
- requirements.txt lists project packages.
- pip freeze prints current environment packages.
- Never check .venv folders into Git.
DataPlayArena Technical Editorial Board
Curated & maintained by enterprise data platform engineers with 10+ years in distributed systems.
Runtime Verification Standards: Every code example, query, and architecture diagram in this tutorial is compiled and verified against real runtimes (Apache Spark 3.5, Python 3.11, PostgreSQL, and DuckDB). If you spot any errata or want to suggest improvements, please submit feedback.