every-python 0.2.0__tar.gz

every_python-0.2.0/.github/workflows/build.yml

@@ -0,0 +1,33 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build-and-publish:
+    name: Build and publish Python distribution to PyPI
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.14"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish

every_python-0.2.0/.github/workflows/integration.yml

@@ -0,0 +1,77 @@
+name: Integration Tests
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ main ]
+    paths:
+      - 'every_python/**'
+      - '.github/workflows/integration.yml'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'every_python/**'
+      - '.github/workflows/integration.yml'
+
+jobs:
+  integration:
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu-24.04
+            os: Linux
+          - runner: windows-2022
+            os: Windows
+          - runner: macos-14
+            os: macOS
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+            python-version: "3.14"
+
+      - name: Install system dependencies (Linux)
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y lsof
+          sudo bash -c "$(wget -O - https://apt.llvm.org/llvm.sh)" ./llvm.sh 20
+          echo "$(llvm-config-20 --bindir)" >> $GITHUB_PATH
+
+      - name: Install LLVM (macOS)
+        if: runner.os == 'macOS'
+        run: brew install llvm@20
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+            enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Install package in editable mode
+        run: uv pip install -e .
+
+      - name: Test LLVM detection (Linux/macOS)
+        if: runner.os != 'Windows'
+        run: |
+          uv run python -c "from every_python.utils import check_llvm_available; import sys; sys.exit(0 if check_llvm_available('20') else 1)"
+
+      - name: Test build without JIT
+        run: uv run every-python install v3.13.0 --verbose
+
+      - name: Verify non-JIT build works
+        run: uv run every-python run v3.13.0 -- --version
+
+      - name: Test build with JIT
+        # Use commit that I know has JIT support with LLVM 20
+        run: uv run every-python install 42d014086098d3d70cacb4d8993f04cace120c12 --jit --verbose
+
+      - name: Verify JIT build works
+       # Use commit that I know has JIT support with LLVM 20
+        run: uv run every-python run 42d014086098d3d70cacb4d8993f04cace120c12 --jit -- --version

every_python-0.2.0/.github/workflows/lint.yml

@@ -0,0 +1,40 @@
+name: Lint
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'every_python/**'
+      - 'tests/**'
+      - '.github/workflows/lint.yml'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'every_python/**'
+      - 'tests/**'
+      - '.github/workflows/lint.yml'
+
+jobs:
+  ruff:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run Ruff linter
+        run: uv run ruff check every_python/
+
+      - name: Run Ruff formatter
+        run: uv run ruff format --check every_python/

every_python-0.2.0/.github/workflows/test.yml

@@ -0,0 +1,59 @@
+name: Test
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'every_python/**'
+      - 'tests/**'
+      - 'pyproject.toml'
+      - '.github/workflows/test.yml'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'every_python/**'
+      - 'tests/**'
+      - 'pyproject.toml'
+      - '.github/workflows/test.yml'
+
+jobs:
+  test:
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - target: x86_64-unknown-linux-gnu/gcc
+            architecture: x86_64
+            runner: ubuntu-24.04
+          - target: aarch64-unknown-linux-gnu/gcc
+            architecture: aarch64
+            runner: ubuntu-24.04-arm
+          - target: x86_64-pc-windows-msvc/msvc
+            architecture: x64
+            runner: windows-2022
+          - target: aarch64-pc-windows-msvc/msvc
+            architecture: ARM64
+            runner: windows-11-arm
+          - target: x86_64-apple-darwin/clang
+            architecture: x86_64
+            runner: macos-15-intel
+          - target: aarch64-apple-darwin/clang
+            architecture: aarch64
+            runner: macos-14
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+            python-version: "3.14"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+            enable-cache: true
+      - name: Install dependencies
+        run: uv sync
+      - name: Run tests
+        run: uv run pytest -v

every_python-0.2.0/.github/workflows/typecheck.yml

@@ -0,0 +1,39 @@
+name: Type Check
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'every_python/**'
+      - 'tests/**'
+      - 'pyproject.toml'
+      - '.github/workflows/typecheck.yml'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'every_python/**'
+      - 'tests/**'
+      - 'pyproject.toml'
+      - '.github/workflows/typecheck.yml'
+
+jobs:
+  pyright:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.14"
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Run Pyright
+        run: uv run pyright

every_python-0.2.0/.gitignore

@@ -0,0 +1,32 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual environments
+.venv/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Ruff
+.ruff_cache/
+
+# OS
+.DS_Store
+*.log
+
+# Pytest
+.cache/
+.pytest_cache/
+
+test_jit_api.py

every_python-0.2.0/.pre-commit-config.yaml

@@ -0,0 +1,28 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.4
+    hooks:
+      # Run the linter
+      - id: ruff
+        args: [--fix]
+        files: '^every_python/.*\.py$'
+      # Run the formatter
+      - id: ruff-format
+        files: '^every_python/.*\.py$'
+
+  - repo: local
+    hooks:
+      - id: pytest
+        name: pytest
+        entry: uv run --frozen --group dev pytest
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [commit]
+      - id: pyright
+        name: pyright
+        entry: uv run pyright every_python/
+        language: system
+        pass_filenames: false
+        types: [python]
+        stages: [commit]

every_python-0.2.0/.python-version

@@ -0,0 +1 @@
+3.14.0

every_python-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Savannah Ostrowski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

every_python-0.2.0/PKG-INFO

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: every-python
+Version: 0.2.0
+Summary: Build and run any commit of CPython
+Project-URL: Homepage, https://github.com/savannahostrowski/every-python
+Project-URL: Repository, https://github.com/savannahostrowski/every-python
+Project-URL: Issues, https://github.com/savannahostrowski/gruyere/issues
+Author-email: Savannah Ostrowski <savannah@python.org>
+License: MIT
+License-File: LICENSE
+Keywords: ports,processes,tui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.14
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.20.0
+Description-Content-Type: text/markdown
+
+# every-python
+
+Build and run any commit of CPython, inspired by [every-ts](https://github.com/jakebailey/every-ts).
+
+## Why does this exist?
+
+Building CPython from source is time-consuming. `every-python` makes it easy to:
+- Test your code against different Python versions
+- Reproduce bugs in specific commits
+- Test experimental features like the JIT compiler
+- Bisect to find which commit introduced a regression
+
+## Features
+
+- **Build any CPython commit** - main, release tags, or specific commits
+- **Build with experimental JIT support** - Build with `--enable-experimental-jit` (includes LLVM version detection)
+- **Smart caching** - Builds cached in `~/.every-python/builds/` for instant reuse
+- **Git bisect integration** - Automatically find which commit introduced a bug
+
+## How it works
+
+`every-python` makes a [blobless clone](https://github.blog/open-source/git/get-up-to-speed-with-partial-clone-and-shallow-clone/) of the CPython repository (~200MB), checks out the version you want, and builds it locally with `--with-pydebug`. Built versions are cached in `~/.every-python/builds/` for reuse.
+
+## Installation
+
+```bash
+# From PyPI (once published)
+uv tool install every-python
+# or
+pipx install every-python
+# or
+pip install every-python
+
+# Development install from source
+git clone https://github.com/yourusername/every-python.git
+cd every-python
+uv sync
+```
+
+## Requirements
+
+- Git
+- [CPython build dependencies](https://devguide.python.org/getting-started/setup-building/)
+- [LLVM](https://github.com/python/cpython/blob/main/Tools/jit/README.md), for JIT builds
+
+## Usage
+
+### Build and install a Python version
+
+```bash
+# Build from main branch
+every-python install main
+
+# Build from a release tag
+every-python install v3.13.0
+
+# Build from a specific commit
+every-python install abc123d
+
+# Show build output (useful for debugging build failures)
+every-python install main --verbose
+```
+
+### Run Python with a specific version
+
+```bash
+# Run Python REPL
+every-python run main -- python
+
+# Run a script
+every-python run v3.13.0 -- python your_script.py
+
+# Run with arguments
+every-python run main -- python -c "print('Hello!')"
+```
+
+If the version isn't built yet, it will build it automatically.
+
+### Build with JIT compiler (experimental)
+
+Build Python with the experimental JIT compiler:
+
+```bash
+# Build with JIT enabled
+every-python install main --jit
+
+# Run with JIT-enabled build
+every-python run main --jit -- python -c "print('Hello from JIT!')"
+
+# Bisect with JIT to find JIT-specific bugs
+every-python bisect --good v3.13.0 --bad main --jit --run "python test.py"
+```
+
+**JIT Requirements:**
+`every-python` will attempt to detect the correct version of LLVM for the commit being built from `LLVM_VERSION` specified in `Tools/jit/_llvm.py` at the time of the commit. If you are missing the required LLVM version, you will see an error during the build. For more information on installing LLVM, see [CPython JIT documentation](https://github.com/python/cpython/blob/main/Tools/jit/README.md).
+
+Note: LLVM is only needed at build time, not at runtime. JIT and non-JIT builds are stored separately.
+
+### List built versions
+
+```bash
+every-python list-builds
+```
+
+### Clean up builds
+
+```bash
+# Remove a specific build
+every-python clean v3.13.0
+
+# Remove all builds
+every-python clean --all
+```
+
+### Bisect to find bugs
+
+Use git bisect to automatically find which commit introduced a bug:
+
+```bash
+# Find when a test started failing
+# Exit with code 0 = good commit, 1 = bad commit
+every-python bisect \
+  --good v3.13.0 \
+  --bad main \
+  --run "python test_my_feature.py"
+
+# Bisect with JIT-enabled builds
+every-python bisect \
+  --good v3.12.0 \
+  --bad main \
+  --jit \
+  --run "python test_jit_api.py"
+```
+
+This will:
+1. Resolve the good and bad commits
+2. Start a git bisect
+3. Build each commit that git bisect tests
+4. Run your test command
+5. Automatically mark commits as good/bad based on exit code:
+   - Exit 0 = good commit
+   - Exit 1-127 (except 125) = bad commit
+   - Exit 125 = skip this commit (can't test it)
+6. Find the exact commit that introduced the change
+
+**Note on bisecting across branches:** Bisecting between release tags and main can be tricky due to backporting. For best results, bisect within a single branch (e.g., use commit hashes on main instead of crossing from v3.12.0 to main).
+
+**Writing test scripts for bisect:** Your test script should exit with code 0 for "good" (old/expected behavior) and 1 for "bad" (new/broken behavior). For example, if I wanted to find when `_jit` was added to the `sys` module, I could use this script:
+
+```python
+import sys
+# Exit 0 (good) = feature doesn't exist yet
+# Exit 1 (bad) = feature exists
+if hasattr(sys, "_jit"):
+    sys.exit(1)  # Feature exists - mark as "bad"
+sys.exit(0)  # Feature doesn't exist - mark as "good"
+```
+
+## Project Structure
+
+```
+~/.every-python/
+├── cpython/          # Blobless clone of CPython repository
+└── builds/           # Cached builds
+    ├── abc123d/      # Build for commit abc123d
+    ├── abc123d-jit/  # JIT build for commit abc123d
+    └── def456e/      # Build for commit def456e
+```
+
+## License
+
+MIT