just-buildit 0.3.11__tar.gz

just_buildit-0.3.11/.github/workflows/ci.yml

@@ -0,0 +1,145 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+# Force uv to use managed (python-build-standalone) interpreters. Under
+# setup-uv@v8, `uv run -p X` on macOS would otherwise select the Xcode system
+# Python, whose headers aren't where the build looks (no Python.h) — the
+# managed builds ship the headers we compile against.
+env:
+  UV_PYTHON_PREFERENCE: only-managed
+
+jobs:
+  # There was no lint job at all before this. Every pre-commit hook, every
+  # drift gate and every check in `make lint` ran on NO pull request -- which
+  # is worse than not having them, because the repo reads as gated.
+  #
+  # `make lint` and nothing else: the Makefile is the SSOT for how each tool
+  # runs, so a job that re-listed the tools here would be a second copy free to
+  # drift -- which is exactly what happened to the test command, where ci.yml
+  # passed `--with pip --with numpy` and the Makefile did not, so `make test`
+  # could not pass while CI was green.
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6.0.2
+      - uses: astral-sh/setup-uv@v8.1.0
+        with:
+          python-version: "3.12"
+      - run: make lint
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, ubuntu-24.04-arm]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6.0.2
+      - uses: astral-sh/setup-uv@v8.1.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install meson + ninja (Linux)
+        if: runner.os == 'Linux'
+        run: sudo apt-get install -y ninja-build && uv tool install meson
+      - name: Install meson + ninja (macOS)
+        if: runner.os == 'macOS'
+        run: brew install ninja && uv tool install meson
+      - run: make test TEST_PYTHON=${{ matrix.python-version }}
+
+  test-bazel:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6.0.2
+      - uses: astral-sh/setup-uv@v8.1.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: sudo apt-get update && sudo apt-get install -y bazel-bootstrap && sudo ln -sf /usr/bin/bazel-bootstrap /usr/local/bin/bazel
+      - run: uv run --no-project -p ${{ matrix.python-version }} python -m unittest tests.test_examples.TestBazelExample -v
+
+  test-just-makeit:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        # just-makeit (the scaffolding CLI) requires Python >=3.11 and its
+        # generated projects target >=3.11, so this integration only runs on
+        # 3.11+. just-buildit's 3.8+ floor is covered by the test/test-bazel
+        # jobs above.
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6.0.2
+      - uses: astral-sh/setup-uv@v8.1.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv tool install just-makeit
+      - run: uv run --no-project -p ${{ matrix.python-version }} --with pip --with numpy python -m unittest tests.test_examples.TestJustMakeitExample -v
+
+  test-windows-ucrt64:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v6.0.2
+      - uses: msys2/setup-msys2@v2
+        with:
+          msystem: UCRT64
+          install: >-
+            mingw-w64-ucrt-x86_64-python
+            mingw-w64-ucrt-x86_64-gcc
+            mingw-w64-ucrt-x86_64-cmake
+            make
+          update: true
+      - shell: msys2 {0}
+        run: python -m unittest tests.test_build tests.test_examples tests.test_cli -v
+
+  # The one check main's ruleset requires -- and it did not exist. The rule
+  # named `CI passed`, no job produced it, so `mergeable_state` was `blocked`
+  # on every pull request with every check green. A required check that nothing
+  # reports is not a strict gate; it is a repository that cannot merge, and it
+  # reads as ordinary CI slowness until someone looks at the ruleset.
+  #
+  # `if: always()` with an explicit failure scan rather than plain `needs:`,
+  # so a SKIPPED job does not read as a failure and a failed one cannot be
+  # skipped past.
+  ci-passed:
+    name: CI passed
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    needs:
+      [lint, test, test-bazel, test-just-makeit, test-windows-ucrt64]
+    if: always()
+    steps:
+      - run: |
+          if [[ "${{ contains(needs.*.result, 'failure') }}" == "true" ]]; then
+            exit 1
+          fi
+          if [[ "${{ contains(needs.*.result, 'cancelled') }}" == "true" ]]; then
+            exit 1
+          fi
+
+  trigger-mirror:
+    name: Trigger docs mirror refresh
+    # Nudges just-buildit.github.io's mirror.yml (repository_dispatch:
+    # mirror) to refresh immediately instead of waiting for its daily cron.
+    # Never blocks anything else in this repo — not a required check.
+    #
+    # Hangs off `ci-passed` rather than re-listing the matrix. The comment
+    # here used to say no aggregator existed "unlike just-bashit/just-makeit"
+    # — which was true, and was also why main's ruleset required a check
+    # nothing produced and no pull request could merge.
+    needs: ci-passed
+    runs-on: ubuntu-latest
+    if: |
+      github.event_name == 'push' && github.ref == 'refs/heads/main' &&
+      !contains(needs.*.result, 'failure') && !contains(needs.*.result, 'cancelled')
+    steps:
+      - name: Dispatch mirror refresh
+        env:
+          GH_TOKEN: ${{ secrets.MIRROR_DISPATCH_TOKEN }}
+        run: |
+          gh api repos/just-buildit/just-buildit.github.io/dispatches \
+            -f event_type=mirror

just_buildit-0.3.11/.github/workflows/docs.yml

@@ -0,0 +1,65 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+# Only one deploy at a time; don't cancel in-progress deploys.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  # ------------------------------------------------------------------
+  # Build — runs on every push and PR
+  # ------------------------------------------------------------------
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6.0.2
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          python-version: '3.12'
+
+      - name: Install deps
+        run: PYTHONPATH=src uv sync --group dev --no-build-isolation
+
+      - name: Build Zensical site
+        run: uv run zensical build --clean
+
+      - name: Configure Pages
+        if: github.ref == 'refs/heads/main'
+        uses: actions/configure-pages@v5
+
+      - name: Upload pages artifact
+        if: github.ref == 'refs/heads/main'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site/
+
+  # ------------------------------------------------------------------
+  # Deploy — only on push to main
+  # ------------------------------------------------------------------
+  deploy:
+    name: Deploy
+    if: github.ref == 'refs/heads/main'
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

just_buildit-0.3.11/.github/workflows/release.yml

@@ -0,0 +1,174 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  # Manual dry-run: runs the full test + build matrix (incl. macOS) WITHOUT
+  # publishing, so a release can be verified before tagging. The publish job
+  # is gated to tag pushes only (see its `if:` below).
+  workflow_dispatch:
+
+# Force uv to use managed interpreters (see ci.yml for the macOS/setup-uv@v8
+# rationale — the Xcode system Python lacks the headers we build against).
+env:
+  UV_PYTHON_PREFERENCE: only-managed
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, ubuntu-24.04-arm]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6.0.2
+      - uses: astral-sh/setup-uv@v8.1.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv run --no-project -p ${{ matrix.python-version }} python -m unittest tests.test_build tests.test_examples tests.test_cli tests.test_metadata -v
+
+  test-windows-ucrt64:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v6.0.2
+      - uses: msys2/setup-msys2@v2
+        with:
+          msystem: UCRT64
+          install: >-
+            mingw-w64-ucrt-x86_64-python
+            mingw-w64-ucrt-x86_64-gcc
+            mingw-w64-ucrt-x86_64-cmake
+            make
+          update: true
+      - shell: msys2 {0}
+        run: python -m unittest tests.test_build tests.test_examples -v
+
+  test-bazel:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6.0.2
+      - uses: astral-sh/setup-uv@v8.1.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: sudo apt-get update && sudo apt-get install -y bazel-bootstrap && sudo ln -sf /usr/bin/bazel-bootstrap /usr/local/bin/bazel
+      - run: uv run --no-project -p ${{ matrix.python-version }} python -m unittest tests.test_examples.TestBazelExample -v
+
+  build:
+    needs: [test, test-bazel, test-windows-ucrt64]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6.0.2
+      - uses: astral-sh/setup-uv@v8.1.0
+        with:
+          python-version: "3.11"
+      - run: PYTHONPATH=src uv build --wheel --no-build-isolation --python 3.11
+      # The sdist is what carries everything outside src/ -- examples above
+      # all. Publishing only the wheel made repo-level work unreachable from
+      # PyPI at every version (#19).
+      - run: PYTHONPATH=src uv build --sdist --no-build-isolation --python 3.11
+      - uses: actions/upload-artifact@v7.0.1
+        with:
+          name: dist
+          path: dist/
+
+  smoke:
+    name: Smoke test the wheel and the sdist
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v8.0.1
+        with:
+          name: dist
+          path: dist/
+
+      - uses: astral-sh/setup-uv@v8.1.0
+        with:
+          python-version: "3.12"
+
+      - name: Install the built wheel into a fresh venv
+        run: |
+          wheel="$(ls dist/*.whl)"
+          uv venv .smoke
+          uv pip install --python .smoke "$wheel"
+
+      - name: Version matches the tag
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          source .smoke/bin/activate
+          pkg_ver="$(python -c 'from importlib.metadata import version; print(version("just-buildit"))')"
+          want="${GITHUB_REF_NAME#v}"
+          if [ "$pkg_ver" != "$want" ]; then
+            echo "::error::version mismatch (want $want, got $pkg_ver)"; exit 1
+          fi
+          echo "Version OK: $pkg_ver"
+
+      - name: CLI smoke (inspect + build)
+        run: |
+          source .smoke/bin/activate
+          just-buildit --help
+
+      # An sdist that is published but never installed is an unchecked
+      # artifact. Both halves matter: that it CONTAINS the tree, and that it
+      # BUILDS from it.
+      - name: The sdist carries the repo tree, not just the package
+        run: |
+          sdist="$(ls dist/*.tar.gz)"
+          echo "inspecting $sdist"
+          n_examples="$(tar tzf "$sdist" | grep -c '/examples/' || true)"
+          echo "entries under examples/: $n_examples"
+          if [ "$n_examples" -eq 0 ]; then
+            echo "::error::sdist carries no examples/ -- see #19"; exit 1
+          fi
+
+      - name: The sdist builds
+        run: |
+          sdist="$(ls dist/*.tar.gz)"
+          uv venv .sdist-smoke
+          uv pip install --python .sdist-smoke "$sdist"
+          .sdist-smoke/bin/python -c 'import just_buildit; print(just_buildit.__name__, "ok")'
+
+  publish:
+    needs: smoke
+    # Only ever publish for a real version tag — never on a manual dry-run.
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8.0.1
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6.0.2
+
+      - name: Extract changelog section for this tag
+        run: |
+          TAG="${GITHUB_REF_NAME}"
+          VER="${TAG#v}"
+          awk -v ver="$VER" \
+            'index($0, "## [" ver "]") == 1 {found=1; next}
+             found && /^## / {exit}
+             found {print}' CHANGELOG.md > release-notes.md
+          cat release-notes.md
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "${GITHUB_REF_NAME}" \
+            --title "${GITHUB_REF_NAME}" \
+            --latest \
+            --notes-file release-notes.md

just_buildit-0.3.11/.gitignore

@@ -0,0 +1,29 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# uv init artifacts
+main.py
+*.zip
+
+# Example build artifacts
+examples/**/_build/
+examples/bazel/bazel-*
+
+# Test fixture build output
+tests/fixture/dist/
+
+# Zensical build output
+site/
+
+# Editor config. Deliberately not tracked: VS Code writes machine-specific
+# absolute paths into it (cmake.sourceDirectory pointed at one machine's
+# $HOME for the life of the file). See #16.
+.vscode/

just_buildit-0.3.11/.pre-commit-config.yaml

@@ -0,0 +1,52 @@
+# python-only = canonical base + Python (ruff). See
+# ~/mcp-store/configs/.pre-commit-config.yaml for the shared base this
+# extends. ruff settings live in [tool.ruff] in pyproject.toml (not a
+# standalone ruff.toml). mypy is configured in [tool.mypy] for manual/CI
+# use but intentionally not wired in here — matching sibling projects
+# (doppler, just-makeit), which also run mypy outside of pre-commit.
+#
+# src/just_buildit/_vendor/ is a vendored MIT-licensed tomli backport and
+# is excluded everywhere below — left byte-for-byte as upstream ships it.
+exclude: ^src/just_buildit/_vendor/
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-yaml
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: check-added-large-files
+        args: [--maxkb=500]
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.11.28
+    hooks:
+      - id: uv-lock
+
+  # Dispatches inward so a hook cannot format differently from `make format`.
+  # Versions come from pyproject.toml's dev group via uv.lock, so there is no
+  # `rev:` and no additional_dependencies list to drift. Paths and exclusions
+  # live in the Makefile, which is the SSOT for HOW every tool runs.
+  - repo: local
+    hooks:
+      - id: ruff
+        name: ruff
+        entry: make -s lint-ruff
+        language: system
+        types: [python]
+        pass_filenames: false
+      - id: ruff-format
+        name: ruff format
+        entry: make -s lint-ruff-format
+        language: system
+        types: [python]
+        pass_filenames: false
+      - id: mdformat
+        name: mdformat
+        entry: make -s lint-mdformat
+        language: system
+        types: [markdown]
+        pass_filenames: false

just_buildit-0.3.11/.python-version

@@ -0,0 +1 @@
+3.12