tiny-bclibc-wasm 0.0.1__tar.gz

tiny_bclibc_wasm-0.0.1/.github/dependabot.yml

@@ -0,0 +1,30 @@
+version: 2
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      python-dependencies:
+        patterns:
+          - "*"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      actions:
+        patterns:
+          - "*"
+
+  # The bclibc submodule: a weekly PR when its tracked branch (.gitmodules) moves.
+  - package-ecosystem: "gitsubmodule"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "pre-commit"
+    directory: "/"
+    schedule:
+      interval: "weekly"

tiny_bclibc_wasm-0.0.1/.github/workflows/pre-commit.yml

@@ -0,0 +1,90 @@
+name: Pre-commit
+
+# Same flow as py-ballisticcalc's: run every hook; on a pull request from this repo, commit what the
+# auto-fixing hooks (ruff) changed and verify again; anywhere else, changed files are a failure.
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+  workflow_call:
+
+concurrency:
+  group: pre-commit-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+
+jobs:
+  pre-commit:
+    name: pre-commit run --all-files
+    runs-on: ubuntu-latest
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0 # setuptools_scm needs tags for the package version
+          ref: ${{ github.head_ref || github.ref_name }}
+          submodules: recursive # the uv-sync hook compiles the .wasm modules from the bclibc submodule
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4
+        with:
+          python-version: "3.11"
+
+      - name: Fetch micropython-bclibc's natmod test suite (run by the pytest hook)
+        run: |
+          curl -sSfL -o "$RUNNER_TEMP/test_bclibc.py" \
+            https://raw.githubusercontent.com/ballistics-lab/micropython-bclibc/main/tests/test_bclibc.py
+          echo "BCLIBC_NATMOD_SUITE=$RUNNER_TEMP/test_bclibc.py" >> "$GITHUB_ENV"
+
+      - name: Install pre-commit
+        run: uv tool install pre-commit
+
+      - name: Run pre-commit
+        id: first_run
+        continue-on-error: true
+        run: pre-commit run --all-files --show-diff-on-failure
+
+      - name: Check for changes
+        id: diff
+        run: |
+          if [ -n "$(git status --porcelain)" ]; then
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Fail (no auto-fixable changes, but hooks failed)
+        if: steps.diff.outputs.changed == 'false' && steps.first_run.outcome == 'failure'
+        run: exit 1
+
+      - name: Fail (changes produced, but not on a pull_request)
+        if: steps.diff.outputs.changed == 'true' && github.event_name != 'pull_request'
+        run: |
+          echo "pre-commit modified files, but auto-commit only runs on pull_request events."
+          git status --porcelain
+          exit 1
+
+      - name: Re-run pre-commit after auto-fixes
+        id: verify_run
+        if: steps.diff.outputs.changed == 'true' && github.event_name == 'pull_request'
+        continue-on-error: true
+        run: pre-commit run --all-files --show-diff-on-failure
+
+      - name: Fail (issues remain after auto-fix)
+        if: steps.diff.outputs.changed == 'true' && github.event_name == 'pull_request' && steps.verify_run.outcome == 'failure'
+        run: exit 1
+
+      - name: Commit and push auto-fixes
+        if: steps.diff.outputs.changed == 'true' && github.event_name == 'pull_request' && steps.verify_run.outcome == 'success'
+        env:
+          # through the environment, not inlined: a branch name is attacker-controlled text
+          BRANCH: ${{ github.head_ref || github.ref_name }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add -A
+          git commit -m "style: auto-fix via pre-commit"
+          git push origin "HEAD:$BRANCH"

tiny_bclibc_wasm-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,144 @@
+name: Publish
+
+# On a v* tag: build the sdist and the (pure-Python, py3-none-any) wheel, publish them to PyPI, and
+# draft a GitHub release carrying them plus what non-pip users need:
+#   tiny_bclibc_dp.wasm / tiny_bclibc_sp.wasm   the modules themselves, for any other host
+#   tiny_bclibc-pythonista.zip                  the ready-to-copy package folder for Pythonista
+#
+# workflow_dispatch builds (and optionally publishes to TestPyPI) without a tag.
+#
+# PyPI publishing uses trusted publishing: the `pypi` / `testpypi` environments must exist in this
+# repo, and the project on PyPI must list this repo + workflow (publish.yml) as a trusted publisher.
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      testpypi:
+        description: "Publish to TestPyPI"
+        required: false
+        type: boolean
+        default: false
+      version:
+        description: "Override version (e.g. 0.1.0rc1); TestPyPI needs one without a dev/local suffix"
+        required: false
+        type: string
+        default: ""
+
+run-name: >
+  Publish → ${{ github.event_name == 'push' && 'PyPI' ||
+      inputs.testpypi && 'TestPyPI' || 'build only' }}
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build sdist + wheel
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0 # setuptools_scm needs tags
+          submodules: recursive
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4
+
+      - name: Build (the wheel is built from the sdist, so this proves the sdist builds on its own)
+        env:
+          SETUPTOOLS_SCM_PRETEND_VERSION: ${{ inputs.version }}
+          # PyPI/TestPyPI reject local version segments (+g<hash>); keep them on build-only runs.
+          SETUPTOOLS_SCM_OVERRIDES_FOR_TINY_BCLIBC_WASM: >-
+            ${{ (github.event_name == 'push' || inputs.testpypi) && '{local_scheme = "no-local-version"}' || '' }}
+        run: uv build --out-dir dist
+
+      - name: Smoke-test the wheel in a clean environment
+        run: |
+          uv venv -q /tmp/smoke
+          uv pip install -q --python /tmp/smoke dist/*.whl
+          cd /tmp && TINY_BCLIBC_HOST=node /tmp/smoke/bin/python -c "
+          import tiny_bclibc as bc
+          shot = bc.Shot(bc=0.31, weight_grain=168, diameter_inch=0.308, muzzle_velocity_fps=2750, sight_height_ft=0.125)
+          angle = bc.zero(shot, 300 / 0.3048)
+          print(bc.version(), bc.host(), angle)
+          assert abs(angle - 0.002502) < 1e-4
+          "
+
+      - name: Release extras (standalone .wasm, Pythonista zip)
+        run: |
+          mkdir -p extras
+          python3 - <<'EOF'
+          import glob, zipfile
+          wheel = zipfile.ZipFile(glob.glob("dist/*.whl")[0])
+          with zipfile.ZipFile("extras/tiny_bclibc-pythonista.zip", "w", zipfile.ZIP_DEFLATED) as z:
+              for name in wheel.namelist():
+                  if name.startswith("tiny_bclibc/"):
+                      z.writestr(name, wheel.read(name))
+                      if name.endswith(".wasm"):
+                          open("extras/" + name.split("/")[-1], "wb").write(wheel.read(name))
+              z.write("examples/basic.py", "basic.py")
+          EOF
+          ls -l dist extras
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist
+          retention-days: 14
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: extras
+          path: extras
+          retention-days: 14
+
+  publish:
+    needs: build
+    if: github.event_name == 'push' || inputs.testpypi
+    runs-on: ubuntu-latest
+    environment: ${{ github.event_name == 'push' && 'pypi' || 'testpypi' }}
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI
+        if: github.event_name == 'push'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+
+      - name: Publish to TestPyPI
+        if: github.event_name == 'workflow_dispatch'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+          repository-url: https://test.pypi.org/legacy/
+
+  release:
+    needs: build
+    if: github.event_name == 'push'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          path: artifacts
+
+      - name: Create GitHub release (draft)
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create "${{ github.ref_name }}" \
+            --repo "${{ github.repository }}" \
+            --title "tiny-bclibc-wasm ${{ github.ref_name }}" \
+            --generate-notes \
+            --draft \
+            artifacts/dist/* artifacts/extras/*

tiny_bclibc_wasm-0.0.1/.github/workflows/tests.yml

@@ -0,0 +1,187 @@
+name: Tests
+
+# Builds the package from source (which compiles the .wasm modules with the ziglang build requirement)
+# and runs the suite once per WebAssembly runtime, selected with pytest's --wasm-runtime (see
+# tests/conftest.py; a runtime that can't start fails the step, it is never skipped):
+#
+#   test:     every OS x CPython oldest/newest + PyPy, on wasmtime and on Node (both available on
+#             every runner), and on wasm3 where pywasm3 installs (CPython 3.11+; built from git).
+#   jsc:      WebKitGTK's JavaScriptCore -- the engine behind Pythonista's JSContext -- with its JIT
+#             and without it (iOS apps like Pythonista run it without), as the stand-in for an iOS
+#             device.
+#   coverage: combines the Ubuntu runs of all the runtimes (each one exercises its own host class
+#             in _runner.py) and uploads the result to Codecov.
+
+on:
+  push:
+    paths-ignore: &non-code-paths
+      - "**.md"
+      - "LICENSE"
+  pull_request:
+    paths-ignore: *non-code-paths
+  workflow_dispatch:
+
+concurrency:
+  group: tests-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: ${{ matrix.os }} / ${{ matrix.python-version }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.14", "pypy3.11"]
+    defaults:
+      run:
+        shell: bash
+    env:
+      # Coverage only from Ubuntu: one path layout to combine, and the runtimes behave the same
+      # elsewhere (which the other legs still verify).
+      COV_ARGS: ${{ matrix.os == 'ubuntu-latest' && '--cov --cov-report=' || '' }}
+      COV_ID: ${{ matrix.os }}-${{ matrix.python-version }}
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0 # setuptools_scm needs tags for the package version
+          submodules: recursive
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Fetch micropython-bclibc's natmod test suite
+        run: |
+          curl -sSfL -o "$RUNNER_TEMP/test_bclibc.py" \
+            https://raw.githubusercontent.com/ballistics-lab/micropython-bclibc/main/tests/test_bclibc.py
+          echo "BCLIBC_NATMOD_SUITE=$RUNNER_TEMP/test_bclibc.py" >> "$GITHUB_ENV"
+
+      - name: Build and install (compiles the .wasm modules)
+        run: uv sync --locked
+
+      - name: pytest --wasm-runtime wasmtime
+        run: uv run --locked pytest -v --wasm-runtime wasmtime $COV_ARGS
+        env:
+          COVERAGE_FILE: .coverage.${{ env.COV_ID }}-wasmtime
+
+      - name: pytest --wasm-runtime node
+        if: ${{ !cancelled() }} # run every runtime even if an earlier one failed
+        run: uv run --locked pytest -v --wasm-runtime node $COV_ARGS
+        env:
+          COVERAGE_FILE: .coverage.${{ env.COV_ID }}-node
+
+      - name: pytest --wasm-runtime wasm3
+        # pywasm3 is a dev dependency only on CPython >= 3.11 (see pyproject.toml)
+        if: ${{ !cancelled() && matrix.python-version != '3.10' && !startsWith(matrix.python-version, 'pypy') }}
+        run: uv run --locked pytest -v --wasm-runtime wasm3 $COV_ARGS
+        env:
+          COVERAGE_FILE: .coverage.${{ env.COV_ID }}-wasm3
+
+      - name: Example
+        run: uv run --locked python examples/basic.py
+
+      - name: Upload coverage data
+        if: ${{ matrix.os == 'ubuntu-latest' && !cancelled() }}
+        uses: actions/upload-artifact@v7
+        with:
+          name: coverage-data-${{ env.COV_ID }}
+          path: .coverage.*
+          include-hidden-files: true
+          if-no-files-found: error
+          retention-days: 3
+
+  jsc:
+    name: WebKitGTK JavaScriptCore
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+          submodules: recursive
+
+      - name: Install JavaScriptCore + PyGObject
+        run: |
+          sudo apt-get update -q
+          sudo apt-get install -y -q gir1.2-javascriptcoregtk-4.1 python3-gi
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4
+
+      - name: Fetch micropython-bclibc's natmod test suite
+        run: |
+          curl -sSfL -o "$RUNNER_TEMP/test_bclibc.py" \
+            https://raw.githubusercontent.com/ballistics-lab/micropython-bclibc/main/tests/test_bclibc.py
+          echo "BCLIBC_NATMOD_SUITE=$RUNNER_TEMP/test_bclibc.py" >> "$GITHUB_ENV"
+
+      # python3-gi is built for the distribution's own Python, so use that interpreter with its
+      # site-packages visible.
+      - name: Build and install into a system-site-packages venv
+        run: |
+          uv venv --system-site-packages --python /usr/bin/python3 .venv
+          uv pip install -e . pytest pytest-cov
+
+      - name: pytest --wasm-runtime gi-jsc (JIT on)
+        run: .venv/bin/python -m pytest -v --wasm-runtime gi-jsc --cov --cov-report=
+        env:
+          JSC_useJIT: "true"
+          COVERAGE_FILE: .coverage.jsc-jit
+
+      - name: pytest --wasm-runtime gi-jsc (JIT off, as on iOS)
+        if: ${{ !cancelled() }}
+        run: .venv/bin/python -m pytest -v --wasm-runtime gi-jsc --cov --cov-report=
+        env:
+          JSC_useJIT: "false"
+          COVERAGE_FILE: .coverage.jsc-nojit
+
+      - name: Example
+        run: TINY_BCLIBC_HOST=gi-jsc .venv/bin/python examples/basic.py
+
+      - name: Upload coverage data
+        if: ${{ !cancelled() }}
+        uses: actions/upload-artifact@v7
+        with:
+          name: coverage-data-jsc
+          path: .coverage.*
+          include-hidden-files: true
+          if-no-files-found: error
+          retention-days: 3
+
+  coverage:
+    name: Combine coverage + Codecov
+    needs: [test, jsc]
+    if: ${{ !cancelled() && github.actor != 'dependabot[bot]' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write # Codecov OIDC upload, no token secret needed
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4
+
+      - name: Download coverage data
+        uses: actions/download-artifact@v8
+        with:
+          pattern: coverage-data-*
+          merge-multiple: true
+
+      - name: Combine coverage
+        run: |
+          uvx coverage combine
+          uvx coverage report
+          uvx coverage xml
+          uvx coverage report --format=markdown >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Upload to Codecov
+        uses: codecov/codecov-action@v7
+        with:
+          use_oidc: true
+          files: ./coverage.xml
+          fail_ci_if_error: true

tiny_bclibc_wasm-0.0.1/.gitignore

@@ -0,0 +1,24 @@
+**/__pycache__
+**/.ruff_cache/
+**/.pytest_cache/
+**/.idea
+**/*.pyd
+**/*.so
+**/*.dylib
+**/build
+**/dist
+**/wheelhouse
+**/*.egg-info
+**/.venv
+**/*.ps1
+**/debug
+.vscode
+
+# build_wasm.py output (compiled on every build from the bclibc submodule, shipped inside the wheel)
+src/tiny_bclibc/*.wasm
+src/tiny_bclibc/_bclibc_version.txt
+# coverage
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/

tiny_bclibc_wasm-0.0.1/.gitmodules

@@ -0,0 +1,4 @@
+[submodule "bclibc"]
+	path = bclibc
+	url = https://github.com/ballistics-lab/bclibc.git
+	branch = tiny-bclibc-wasm

tiny_bclibc_wasm-0.0.1/.pre-commit-config.yaml

@@ -0,0 +1,68 @@
+default_install_hook_types: [pre-commit]
+default_language_version:
+  python: python3
+
+repos:
+  - repo: local
+    hooks:
+      - id: uv-lock
+        name: uv lock check
+        entry: uv
+        # --check only, not --upgrade: same reasoning as py-ballisticcalc's hook -- --upgrade would
+        # re-resolve to whatever is newest on PyPI at run time and fail later pushes with no code
+        # change involved. --check only verifies uv.lock still matches pyproject.toml.
+        args: ["lock", "--check"]
+        language: system
+        pass_filenames: false
+        files: '^(pyproject\.toml|uv\.lock)$'
+
+      - id: uv-sync
+        name: uv sync before hooks
+        entry: uv
+        # Rebuilds the editable install -- and with it the .wasm modules -- whenever pyproject.toml's
+        # [tool.uv] cache-keys changed (build hooks, wrapper C source, tiny_bclibc headers).
+        args: ["sync"]
+        language: system
+        pass_filenames: false
+
+      - id: uv-pyright
+        name: pyright
+        entry: uv
+        args: ["run", "pyright"]
+        language: system
+        pass_filenames: false
+        files: '\.pyi?$'
+
+      - id: uv-stubtest
+        name: stubtest (__init__.pyi matches the module)
+        entry: uv
+        args: ["run", "python", "-m", "mypy.stubtest", "tiny_bclibc"]
+        language: system
+        pass_filenames: false
+        files: '^src/.*\.pyi?$'
+
+      - id: uv-ruff-check
+        name: ruff lint & fix
+        entry: uv
+        args: ["run", "ruff", "check", "--fix"]
+        language: system
+        pass_filenames: false
+        files: '\.pyi?$'
+
+      - id: uv-ruff-format
+        name: ruff format
+        entry: uv
+        args: ["run", "ruff", "format"]
+        language: system
+        pass_filenames: false
+        files: '\.pyi?$'
+
+      - id: uv-pytest
+        name: pytest
+        entry: uv
+        # Fast (well under a second): host agreement + micropython-bclibc's natmod suite in both
+        # precisions (skipped when ../micropython-bclibc isn't checked out).
+        args: ["run", "pytest", "-q"]
+        language: system
+        pass_filenames: false
+        files: '(\.py|\.c|\.h|pyproject\.toml)$'

tiny_bclibc_wasm-0.0.1/MANIFEST.in

@@ -0,0 +1,13 @@
+# The sdist must be buildable on its own: build hooks plus the tiny_bclibc sources they compile
+# From the bclibc submodule only what build_wasm.py compiles: setuptools_scm would otherwise ship all
+# of it (the C++ engine, its CI, ...), and without the explicit grafts a fresh clone that setuptools_scm
+# doesn't list would ship none of it.
+include build_wasm.py setup.py README.md
+graft src
+prune bclibc
+graft bclibc/tiny_bclibc/include
+graft bclibc/tiny_bclibc/wasm
+include bclibc/LICENSE
+graft tests
+graft examples
+global-exclude *.wasm __pycache__ *.py[cod]