uv-bundler 1.0.0__tar.gz

uv_bundler-1.0.0/.github/workflows/artifacts.yml

@@ -0,0 +1,188 @@
+name: Build & Validate Artifacts
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+
+jobs:
+  # ── Build the uv-bundler distribution wheel ─────────────────────────────────
+  build-wheel:
+    name: Build uv-bundler wheel
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Build wheel
+        run: uv build --wheel
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: uv-bundler-wheel
+          path: dist/uv_bundler-*-py3-none-any.whl
+          retention-days: 1
+
+  # ── Cross-platform artifact builds ───────────────────────────────────────
+  #
+  # Three samples are built per runner, each targeting the OPPOSITE arch from
+  # the runner to exercise Ghost Resolution (uv pip compile/install --python-platform):
+  #
+  #   ubuntu-latest     (x86_64 host) → builds for linux/aarch64
+  #   ubuntu-24.04-arm  (aarch64 host) → builds for linux/x86_64
+  #
+  # Samples and formats:
+  #   single-spark-job  JAR + ZIP + PEX   pyspark (pure Python)
+  #   numpy-etl         PEX               numpy + pandas (C extensions — PEX extracts .so to disk)
+  #   lambda-zip        ZIP               boto3 (pure Python, Lambda deployment format)
+  #
+  build-linux:
+    name: Build linux/${{ matrix.target-arch }} on ${{ matrix.runner-arch }}
+    needs: build-wheel
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu-latest        # x86_64 host → aarch64 target
+            runner-arch: x86_64
+            target-arch: aarch64
+          - runner: ubuntu-24.04-arm     # aarch64 host → x86_64 target
+            runner-arch: aarch64
+            target-arch: x86_64
+    runs-on: ${{ matrix.runner }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download uv-bundler wheel
+        uses: actions/download-artifact@v4
+        with:
+          name: uv-bundler-wheel
+          path: dist
+
+      # uv must be on PATH so uv-bundler can invoke `uv pip compile/install`
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Install uv-bundler and pex
+        run: pip install dist/uv_bundler-*.whl pex
+
+      # PEX caches downloaded wheels in ~/.pex; key by arch + all PEX sample pyproject hashes
+      - name: Cache PEX downloads
+        uses: actions/cache@v4
+        with:
+          path: ~/.pex
+          key: pex-linux-${{ matrix.target-arch }}-${{ hashFiles('validation/samples/single-spark-job/pyproject.toml', 'validation/samples/numpy-etl/pyproject.toml') }}
+          restore-keys: pex-linux-${{ matrix.target-arch }}-
+
+      # ── single-spark-job (JAR + ZIP + PEX) ───────────────────────────────
+      - name: Build single-spark-job for linux/${{ matrix.target-arch }}
+        working-directory: validation/samples/single-spark-job
+        env:
+          OUT_DIR: ${{ github.workspace }}/artifacts
+        run: |
+          mkdir -p "$OUT_DIR"
+          uv-bundler --target spark-jar --arch ${{ matrix.target-arch }}
+          uv-bundler --target spark-zip --arch ${{ matrix.target-arch }}
+          uv-bundler --target spark-pex --arch ${{ matrix.target-arch }}
+
+      # ── numpy-etl (PEX — C extensions require PEX, not JAR/ZIP) ──────────
+      - name: Build numpy-etl for linux/${{ matrix.target-arch }}
+        working-directory: validation/samples/numpy-etl
+        env:
+          OUT_DIR: ${{ github.workspace }}/artifacts
+        run: |
+          uv-bundler --target etl-${{ matrix.target-arch }}
+
+      # ── lambda-zip (ZIP — pure Python boto3, Lambda deployment format) ────
+      - name: Build lambda-zip for linux/${{ matrix.target-arch }}
+        working-directory: validation/samples/lambda-zip
+        env:
+          OUT_DIR: ${{ github.workspace }}/artifacts
+        run: |
+          uv-bundler --target lambda-${{ matrix.target-arch }}
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: artifacts-linux-${{ matrix.target-arch }}
+          path: |
+            artifacts/single-spark-job-linux-${{ matrix.target-arch }}.*
+            artifacts/numpy-etl-linux-${{ matrix.target-arch }}.*
+            artifacts/lambda-zip-linux-${{ matrix.target-arch }}.*
+          retention-days: 7
+
+  # ── Runtime validation ────────────────────────────────────────────────────
+  #
+  # Each artifact set is validated on the NATIVE runner for that arch,
+  # inside python:3.10-slim Docker — the exact target environment.
+  #
+  # Separate steps per format and sample so failures are immediately visible.
+  # No packages are pre-installed: fat artifacts must be fully self-contained.
+  #
+  validate-linux:
+    name: Validate linux/${{ matrix.target-arch }}
+    needs: build-linux
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu-latest       # x86_64 runtime
+            target-arch: x86_64
+          - runner: ubuntu-24.04-arm    # aarch64 runtime
+            target-arch: aarch64
+    runs-on: ${{ matrix.runner }}
+    env:
+      SPARK_STEM: single-spark-job-linux-${{ matrix.target-arch }}
+      ETL_STEM: numpy-etl-linux-${{ matrix.target-arch }}
+      LAMBDA_STEM: lambda-zip-linux-${{ matrix.target-arch }}
+      IMAGE: python:3.10-slim
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: artifacts-linux-${{ matrix.target-arch }}
+          path: artifacts
+
+      # ── single-spark-job ─────────────────────────────────────────────────
+      - name: Run single-spark-job JAR in linux/${{ matrix.target-arch }} container
+        run: |
+          docker run --rm \
+            -v "${{ github.workspace }}/artifacts:/artifacts" \
+            "$IMAGE" \
+            sh -c "python /artifacts/$SPARK_STEM.jar | tee /dev/stderr | grep -q 'Running single Spark job with pyspark'"
+
+      - name: Run single-spark-job ZIP in linux/${{ matrix.target-arch }} container
+        run: |
+          docker run --rm \
+            -v "${{ github.workspace }}/artifacts:/artifacts" \
+            "$IMAGE" \
+            sh -c "python /artifacts/$SPARK_STEM.zip | tee /dev/stderr | grep -q 'Running single Spark job with pyspark'"
+
+      - name: Run single-spark-job PEX in linux/${{ matrix.target-arch }} container
+        run: |
+          docker run --rm \
+            -v "${{ github.workspace }}/artifacts:/artifacts" \
+            "$IMAGE" \
+            sh -c "python /artifacts/$SPARK_STEM.pex | tee /dev/stderr | grep -q 'Running single Spark job with pyspark'"
+
+      # ── numpy-etl (native numpy/pandas C extensions via PEX) ─────────────
+      - name: Run numpy-etl PEX in linux/${{ matrix.target-arch }} container
+        run: |
+          docker run --rm \
+            -v "${{ github.workspace }}/artifacts:/artifacts" \
+            "$IMAGE" \
+            sh -c "python /artifacts/$ETL_STEM.pex | tee /dev/stderr | grep -q 'ETL complete'"
+
+      # ── lambda-zip (pure Python boto3 in ZIP format) ──────────────────────
+      - name: Run lambda-zip ZIP in linux/${{ matrix.target-arch }} container
+        run: |
+          docker run --rm \
+            -v "${{ github.workspace }}/artifacts:/artifacts" \
+            "$IMAGE" \
+            sh -c "python /artifacts/$LAMBDA_STEM.zip | tee /dev/stderr | grep -q 'lambda ok'"

uv_bundler-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,97 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+
+jobs:
+  # ── Lint & typecheck (runs once, not in matrix) ──────────────────────────
+  lint:
+    name: Lint & Typecheck
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+          python-version: "3.12"
+
+      - run: uv sync --all-extras
+
+      - name: Ruff + Black
+        run: |
+          uv run ruff check .
+          uv run black --check .
+
+      - name: Mypy
+        run: uv run mypy src
+
+  # ── Unit tests (matrix across supported Python versions) ─────────────────
+  unit:
+    name: Unit / Python ${{ matrix.python-version }}
+    needs: lint
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+          python-version: ${{ matrix.python-version }}
+
+      - run: uv sync --all-extras
+
+      - name: Run unit tests
+        run: uv run pytest tests/unit -q
+
+  # ── Integration tests (single Python version, gated on unit) ─────────────
+  integration:
+    name: Integration Tests
+    needs: unit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+          python-version: "3.12"
+
+      - run: uv sync --all-extras
+
+      - name: Run integration tests
+        run: uv run pytest tests/integration -q
+
+  # ── Benchmarks (only on push to main, not on every PR) ───────────────────
+  benchmarks:
+    name: Benchmarks
+    needs: unit
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+          python-version: "3.12"
+
+      - run: uv sync --all-extras
+
+      - name: Run benchmarks
+        run: uv run pytest tests/benchmarks -q -k bench

uv_bundler-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,43 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # setuptools-scm needs full history for version
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Build wheel and sdist
+        run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/uv-bundler
+    permissions:
+      id-token: write  # required for trusted publishing (OIDC)
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

uv_bundler-1.0.0/.gitignore

@@ -0,0 +1,222 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Intellij
+.idea
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer,
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Docs
+docs/IMPLEMENTATION_PLAN.md
+.trae/
+
+# Validation
+.hypothesis
+.venv_validation/
+.venv_*
+validation/out/
+Validation/VALIDATION_PLAN.md
+validation/**/.uv-bundler

uv_bundler-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,23 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+  - repo: https://github.com/psf/black
+    rev: 24.10.0
+    hooks:
+      - id: black
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.10.0
+    hooks:
+      - id: mypy
+        files: ^src/
+        additional_dependencies:
+          - pydantic>=2.5

uv_bundler-1.0.0/.python-version

@@ -0,0 +1 @@
+3.10