Python venv Project Setup Cheat Sheet

mkdir myapp && cd myapp && python -m venv .venv

# Create a project folder and initialize a virtual environment.

.venv/
venv/
__pycache__/
*.pyc

# Add the environment directory to .gitignore.

python -m pip install black ruff pytest

# Install formatter, linter, and test tooling in the venv.

[build-system]
requires = ["setuptools>=68", "wheel"]
build-backend = "setuptools.build_meta"

[project]
name = "myapp"
version = "0.1.0"
dependencies = [
  "requests>=2.31",
]

# Basic modern packaging metadata for a local project.

python -m pip install -e .

# Install the current project into the venv in editable mode.

python -m pip install -e ".[dev,test]"

# Install project plus optional development dependencies.

```bash
python -m venv .venv
source .venv/bin/activate
python -m pip install -U pip setuptools wheel
python -m pip install -r requirements.txt
```

# Copy-paste setup commands for local onboarding.

setup:
  python -m venv .venv
  . .venv/bin/activate && python -m pip install -U pip setuptools wheel
  . .venv/bin/activate && python -m pip install -r requirements.txt

# Automate local environment setup for contributors.

layout python python3

# Example .envrc for shells that use direnv.