blicket 0.1.0__tar.gz

blicket-0.1.0/.gitattributes

@@ -0,0 +1,2 @@
+# meson dist packs the sdist from git; the examples stay out of it.
+examples/ export-ignore

blicket-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,73 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  UV_LOCKED: "1"
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          enable-cache: true
+      # blicket is built without isolation, so the environment with the build tools comes first.
+      - run: uv sync
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run ty check
+      - run: uv run pytest
+      - run: uv build
+      - name: Wheel smoke test
+        run: |
+          uv venv "$RUNNER_TEMP/smoke"
+          uv pip install --python "$RUNNER_TEMP/smoke" dist/*.whl
+          cd tests/projects/minimal
+          "$RUNNER_TEMP/smoke/bin/blicket" list > "$RUNNER_TEMP/list.txt"
+          diff expected-list.txt "$RUNNER_TEMP/list.txt"
+
+  viewer:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6 # the version from packageManager in viewer/package.json
+        with:
+          package_json_file: viewer/package.json
+          cache: true
+          cache_dependency_path: viewer/pnpm-lock.yaml
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 24
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          enable-cache: true
+      - name: Test, type-check and lint (oxlint) the viewer
+        working-directory: viewer
+        run: |
+          pnpm install --frozen-lockfile
+          pnpm test
+          pnpm typecheck
+          pnpm lint
+      # The release wheel: meson generates the viewer and installs it as blicket/_viewer. blicket
+      # builds without isolation (see [tool.uv]), so the build tools must be in the environment.
+      - run: uv sync --only-group build
+      - run: uv build --wheel -Csetup-args=-Dviewer=enabled
+      - name: The installed wheel finds its viewer
+        run: |
+          uv venv "$RUNNER_TEMP/viewer"
+          uv pip install --python "$RUNNER_TEMP/viewer" dist/*.whl
+          env -u BLICKET_VIEWER "$RUNNER_TEMP/viewer/bin/python" -c "from blicket import viewer; viewer.find()"

blicket-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,80 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+permissions: {}
+
+env:
+  UV_LOCKED: "1"
+
+jobs:
+  release-pr:
+    name: Release PR
+    if: github.repository_owner == 'tobiasdiez'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+    steps:
+      - name: Create Release PR
+        uses: googleapis/release-please-action@45996ed1f6d02564a971a2fa1b5860e934307cf7 # v5.0.0
+        id: release
+        with:
+          # A personal access token: CI does not run on PRs opened with GITHUB_TOKEN.
+          token: ${{ secrets.RELEASE_PR_TOKEN }}
+
+  publish:
+    name: Publish to PyPI
+    needs: release-pr
+    if: needs.release-pr.outputs.release_created == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    environment:
+      name: pypi
+      url: https://pypi.org/p/blicket
+    permissions:
+      contents: read
+      id-token: write
+      attestations: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@ea17c68df8912ef543352723c149a84f56e3d413 # v6.1.0
+        with:
+          package_json_file: viewer/package.json
+
+      - name: Install node
+        uses: actions/setup-node@v7
+        with:
+          node-version: 24
+          package-manager-cache: false
+      
+      - name: Install uv
+        uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          enable-cache: false
+      
+      - name: Install dependencies
+        run: uv sync --only-group build
+
+      - name: Build
+        run: |
+          uv build --sdist
+          uv build --wheel -Csetup-args=-Dviewer=enabled
+      
+      - name: Smoketest
+        run: |
+          uv venv "$RUNNER_TEMP/release"
+          uv pip install --python "$RUNNER_TEMP/release" dist/*.whl
+          env -u BLICKET_VIEWER "$RUNNER_TEMP/release/bin/python" -c "from blicket import viewer; viewer.find()"
+      
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

blicket-0.1.0/.gitignore

@@ -0,0 +1,23 @@
+# example model runs (hundreds of MB, never pushed)
+data_out
+
+# blicket build output and local store
+.blicket/
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+*.egg-info/
+/build/
+/dist/
+
+# viewer
+viewer/node_modules/
+viewer/.nuxt/
+viewer/.output/
+viewer/dist
+viewer/*.tsbuildinfo
+
+# AI
+.claude/skills/feature-loop

blicket-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

blicket-0.1.0/.release-please-manifest.json

@@ -0,0 +1 @@
+{".":"0.1.0"}

blicket-0.1.0/AGENTS.md

@@ -0,0 +1,3 @@
+## Code
+
+- Comments and docstrings describe the code as it is. They never refer to milestones or timelines.

blicket-0.1.0/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+
+## 0.1.0 (2026-11-02)
+
+
+### 🔖 Features
+
+* axis scales, x_scale and y_scale on line plots and in the manifest ([7c7ace3](https://github.com/tobiasdiez/blicket/commit/7c7ace37fd2e7e8bec9596c96196e894a921dc16))
+* bk.plots.sankey, a Sankey plot type drawn with d3-sankey-diagram ([93be5d3](https://github.com/tobiasdiez/blicket/commit/93be5d3cb1a82c78d354c16bdce674b9974c47e6))
+* bk.Skip, the status of a Blick that does not apply to a run ([fbae119](https://github.com/tobiasdiez/blicket/commit/fbae1193d8fe8bcb85df07adc2f6f80883c00deb))
+* blicket check, baseline resolution and the comparison next to the build (M0.7) ([94c7889](https://github.com/tobiasdiez/blicket/commit/94c788911ae68a14e87ba918caaa1ff141a48589))
+* change detection, the diff half of the plot type contract (M0.5) ([0b96d2a](https://github.com/tobiasdiez/blicket/commit/0b96d2a32d4bc223b13a68c1c8aa5170bbf5a3b0))
+* loader protocol, tables and the headless build (M0.2) ([e46088d](https://github.com/tobiasdiez/blicket/commit/e46088dd84fe00ff3c2927dd246487b6759aa7d8))
+* negative stacks, layers below zero in stacked_area and stacked_bar ([957972e](https://github.com/tobiasdiez/blicket/commit/957972e5b85ce349ee4ca6ab1a5088701e06560e))
+* package skeleton, Blick registry and blicket list (M0.1) ([0a6b858](https://github.com/tobiasdiez/blicket/commit/0a6b858ff6848fb20907c683289b40eaa1f26d44))
+* remind-mfa example with ten Blicks and the blicketconf convention (M0.3) ([fe60daf](https://github.com/tobiasdiez/blicket/commit/fe60daf47971848400a061586f7caed3fa37a881))
+* the Blick builder on the dev server, blicket dev and the dataset protocol (M2.1) ([57b9421](https://github.com/tobiasdiez/blicket/commit/57b94211ffb563edd1e8e338c4b0b36057d8fce0))
+* the Blick sidebar, preview cards and pins on the overview ([9326973](https://github.com/tobiasdiez/blicket/commit/9326973e7794398383024bb47518ad126d029b05))
+* the comparison in the viewer, with change charts (M0.7b) ([81d752e](https://github.com/tobiasdiez/blicket/commit/81d752ef767423aefe71ca86b3ede0a17f516221))
+* the REMIND example, the Summary chapter of compareScenarios as 20 Blicks ([91ae787](https://github.com/tobiasdiez/blicket/commit/91ae7871533ffd6d0e8ed90726142bd8d2cd8f3c))
+* the store, blicket push and blicket diff (M0.6) ([604e20c](https://github.com/tobiasdiez/blicket/commit/604e20c2b01ef0525d750066a39d755754695c8b))
+* the viewer, blicket serve and build-time controls (M1) ([fe4d2dd](https://github.com/tobiasdiez/blicket/commit/fe4d2dd70e27617a070f895306f5841627f1a75f))
+
+
+### 🐛 Bug Fixes
+
+* require typer 0.27.2, the release that added TyperException ([4e777bd](https://github.com/tobiasdiez/blicket/commit/4e777bda66d3736e8512021d746a3dc0cc346227))
+
+
+### 📚 Documentation
+
+* drop M0.4, defer M0.5, plan M1 (the viewer) ([404fcfa](https://github.com/tobiasdiez/blicket/commit/404fcfa7f4e406895adbedf6ba008ae712752371))
+* measurements, the tolerance default, the M0 verification walk and installation (M0.8) ([444eb87](https://github.com/tobiasdiez/blicket/commit/444eb8754ae0ddf741847e85c9e4fdb7aba761e0))
+* plan M0.2, record its decisions and the manifest amendment ([6ac5d3c](https://github.com/tobiasdiez/blicket/commit/6ac5d3c3d33284a61c39a8bc06a23d2cdda7a5b7))
+* plan M0.3, record its measurements and the blicketconf convention ([0a513c8](https://github.com/tobiasdiez/blicket/commit/0a513c839487bd3316dea7671034a1d695be9558))
+* split M0 into tasks, plan M0.1, add working conventions ([23ccf21](https://github.com/tobiasdiez/blicket/commit/23ccf212a4db1a0ba296f6f9c323430ad4acb2d6))
+
+
+### 🧹 Miscellaneous
+
+* add release-please workflow and PyPI publishing ([#3](https://github.com/tobiasdiez/blicket/issues/3)) ([70812b5](https://github.com/tobiasdiez/blicket/commit/70812b51a1b6fdd0e2b2512bbef22742a2695de6))
+* initial plan ([1072016](https://github.com/tobiasdiez/blicket/commit/1072016f124df55f71f312cfa1e9347d36f4d280))
+* re-lock the examples against blicket's typer bound ([d2766a2](https://github.com/tobiasdiez/blicket/commit/d2766a21a16ff2b6f149c414979171c0cf65e86e))
+* update the remind-mfa example's lock file ([2fe15f2](https://github.com/tobiasdiez/blicket/commit/2fe15f2596fa66406db9624a5591d18ca5f53ea6))

blicket-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tobias Diez
+
+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.