Skip to content

Claude.md

Latest commit

 

History

History
65 lines (47 loc) · 1.79 KB

Claude.md

File metadata and controls

65 lines (47 loc) · 1.79 KB

Claude Code Context

Development Environment

  • Package Manager: uv
  • Development Environment: GitHub Codespaces
  • Secrets Management: API keys and secrets are managed through GitHub Codespaces secrets

Python Version Testing

This project tests across multiple Python versions:

  • Python 3.10, 3.11, 3.12, 3.13
  • Python 3.14 (upcoming release)
  • Python 3.14t (free-threaded/no-GIL build)

Pre-commit Hooks

The project uses pre-commit with the following hooks:

  • black - Code formatting
  • isort - Import sorting (black profile)
  • ruff - Fast Python linter
  • pylint - Python linter
  • mypy - Static type checking
  • zizmor - GitHub Actions security scanner
  • hadolint - Dockerfile linter

Setup

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env  # Add uv to PATH

# Install pre-commit
uv pip install pre-commit --system

# Install git hooks
pre-commit install

Multi-Version Python Setup

# Install Python versions with uv
uv python install 3.12 3.13 3.14 3.14t

# Create virtual environments for each version
uv venv --python 3.14 .venv314
uv venv --python 3.14t .venv314t  # Free-threaded (no-GIL)

# Install benchmark dependencies
uv pip install pytest pytest-benchmark pytest-asyncio numpy --python .venv314/bin/python
uv pip install pytest pytest-benchmark pytest-asyncio numpy --python .venv314t/bin/python

# Run benchmarks with specific version
.venv314/bin/pytest benchmarks/ --benchmark-only
.venv314t/bin/pytest benchmarks/ --benchmark-only

# Check GIL status
.venv314t/bin/python -c "import sys; print(f'GIL enabled: {sys._is_gil_enabled()}')"

Project Purpose

Python benchmarking suite for comparing performance across different Python versions and configurations.