tesserae-ui 0.1.0__tar.gz

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

@@ -0,0 +1,70 @@
+name: CI
+
+# check + test + the examples, on Linux. Since tre 0.3.5.2 the engine is
+# on PyPI as `tesserae-engine` (still `import tre`), so installing
+# Tesserae installs it as a user's `pip install` would: no tre checkout, no
+# Rust toolchain, no maturin build.
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          path: tesserae
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      # See `tre`'s own ci.yml for the full real reasoning -- lavapipe
+      # (Mesa's software Vulkan implementation) is enough for a real
+      # `wgpu::Instance::request_adapter` to succeed headlessly.
+      - name: Install system dependencies
+        run: sudo apt-get update && sudo apt-get install -y mesa-vulkan-drivers libfontconfig1-dev
+
+      # tre's source at the release pyproject's floor names, checked out only
+      # for a real font file (tests/test_themes.py reads Roboto through
+      # TRE_SOURCE_DIR); the wheel ships no .ttf files. Nothing is built from it.
+      - uses: actions/checkout@v4
+        with:
+          repository: mindderivative/tre
+          ref: v0.3.5.2
+          path: tre
+
+      # Pulls `tesserae-engine` (tre) from PyPI, per pyproject's `>=` floor.
+      - name: Install tesserae (editable, dev extras)
+        working-directory: tesserae
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        working-directory: tesserae
+        env:
+          TRE_SOURCE_DIR: ${{ github.workspace }}/tre
+        run: pytest tests/
+
+      - name: Run the counter example
+        working-directory: tesserae
+        run: python examples/counter/app.py
+
+      - name: Run the multi-screen example
+        working-directory: tesserae
+        run: python examples/multi_screen/app.py
+
+      - name: Run the todo-list example
+        working-directory: tesserae
+        run: python examples/todo_list/app.py
+
+      - name: Run the app-shell example
+        working-directory: tesserae
+        run: python examples/app_shell/app.py
+
+      - name: Run the app-shell file example
+        working-directory: tesserae
+        run: python examples/app_shell_file/app.py

tesserae_ui-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,58 @@
+# Builds docs/ (MkDocs) and deploys it to GitHub Pages. Mirrors tre's
+# own real docs.yml -- see that repo's own workflow for the full real
+# reasoning behind this exact shape (separate from ci.yml's own gate,
+# scoped via `paths:` so an unrelated source commit doesn't redeploy
+# the same site, `mkdocs build --strict` catches broken internal
+# links). Unlike tre, this repo's docs never import tesserae/tre
+# itself -- pure prose + links -- so no Rust toolchain or editable
+# install is needed here at all, just the two doc-build packages.
+#
+# Real, stated manual step (not something this workflow can do for
+# itself): GitHub Pages needs "Build and deployment: GitHub Actions"
+# enabled once in this repo's own Settings > Pages before the first
+# real run of the `deploy` job below will succeed -- confirmed via
+# `gh api repos/mindderivative/tesserae/pages` returning 404 (not yet
+# enabled) at the time this workflow was added.
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".github/workflows/docs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install mkdocs mkdocs-material
+      - run: mkdocs build --strict
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

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

@@ -0,0 +1,102 @@
+name: Release
+
+# Publishes Tesserae to PyPI as `tesserae-ui` (issue #15) when a GitHub
+# Release is published. Trusted publishing (OIDC): PyPI's publisher for
+# `tesserae-ui` names this repository, this file (`release.yml`) and the
+# `pypi` environment, so no API token is stored anywhere. The `pypi`
+# environment is where a required reviewer can hold each upload.
+#
+# The build job checks everything before anything leaves: the release tag
+# matches `pyproject.toml`'s version, no dependency is PyPI's unrelated
+# `tre` (the engine publishes as `tesserae-engine`, tre#19), and the built
+# wheel passes the suite and runs the examples.
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          path: tesserae
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Check the tag and the dependencies
+        working-directory: tesserae
+        env:
+          TAG: ${{ github.event.release.tag_name }}
+        run: |
+          python - <<'EOF'
+          import os, re, sys, tomllib
+
+          project = tomllib.load(open("pyproject.toml", "rb"))["project"]
+          tag = os.environ["TAG"].removeprefix("v")
+          if tag != project["version"]:
+              sys.exit(f"the release tag {os.environ['TAG']!r} doesn't match pyproject's version {project['version']!r}")
+          names = [re.split(r"[\s<>=!~;\[(]", d, maxsplit=1)[0].lower().replace("_", "-") for d in project["dependencies"]]
+          if "tre" in names:
+              sys.exit("pyproject still depends on 'tre': on PyPI that's an unrelated regex library. "
+                       "Depend on 'tesserae-engine' (tre#19) before publishing.")
+          print(f"releasing {project['name']} {project['version']}; dependencies {names}")
+          EOF
+
+      - name: Build the sdist and wheel
+        working-directory: tesserae
+        run: |
+          pip install build twine
+          python -m build
+          twine check --strict dist/*
+
+      - name: Install system dependencies
+        run: sudo apt-get update && sudo apt-get install -y mesa-vulkan-drivers libfontconfig1-dev
+
+      # From PyPI: the wheel's dependencies, `tesserae-engine` included, as a
+      # user's `pip install tesserae-ui` would get them. The installed wheel
+      # is tested, not the checkout.
+      - name: Install the built wheel
+        run: pip install tesserae/dist/*.whl pytest
+
+      # tre's source, only for the real font file tests/test_themes.py reads.
+      - uses: actions/checkout@v4
+        with:
+          repository: mindderivative/tre
+          ref: v0.3.5.2
+          path: tre
+
+      - name: Test the built wheel
+        working-directory: tesserae
+        env:
+          TRE_SOURCE_DIR: ${{ github.workspace }}/tre
+        run: |
+          python -c "import tesserae; assert 'site-packages' in tesserae.__file__, tesserae.__file__; print(tesserae.__file__)"
+          pytest tests/
+          for example in counter multi_screen todo_list app_shell app_shell_file; do
+            python examples/$example/app.py
+          done
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: tesserae/dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/tesserae-ui
+    permissions:
+      id-token: write  # trusted publishing: PyPI accepts this job's OIDC token instead of an API token
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

tesserae_ui-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+.venv/
+.pytest_cache/
+*.egg-info/
+dist/
+build/
+/site/
+/tools/build-tracker-artifact.generated.html