motui 1.0.0__tar.gz

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

@@ -0,0 +1,64 @@
+# The gate, on both platforms, on every push and pull request.
+#
+# One interpreter (3.12, the package's floor), one pinned uv (the version
+# the group's agents ran the local gates with), and the spec's gate lines:
+# pytest, framebench, the golden check and the two piped demo runs.  The
+# lines a shell would spell differently are the redirect (``< /dev/null`` /
+# ``< NUL``) and the framebench pipe (its output kept in the log while the
+# hash line is checked), so those two steps carry a small ``python -c``
+# wrapper instead of branching on ``runner.os``: one spelling, every shell.
+
+name: ci
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: uv, pinned to the dev toolchain
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.12.21"
+
+      - name: install -- the lock is the dependency set, CI does not drift it
+        run: uv sync --locked
+
+      - name: pytest
+        run: uv run pytest -q
+
+      - name: framebench -- exit 0 and the render-hash line present
+        # The digest's *value* is not asserted: it is a property of the
+        # machine's rendering, and a moved hash is a finding for a human,
+        # not a red CI.  The exit code and the line's presence are asserted.
+        run: |
+          uv run python -c "import re, subprocess, sys; done = subprocess.run([sys.executable, 'tools/framebench.py'], capture_output=True, text=True); sys.stdout.write(done.stdout); sys.stderr.write(done.stderr); raise SystemExit(0 if done.returncode == 0 and re.search(r'^render-hash  : [0-9a-f]{64}$', done.stdout, re.M) else 1)"
+
+      - name: golden frames -- every page byte for byte
+        run: uv run python tools/golden.py --check
+
+      - name: demo -- the piped replay, stdin on the null device
+        # ``< /dev/null`` is bash's spelling and ``< NUL`` is cmd's;
+        # PowerShell has no redirection operator at all.  The wrapper is the
+        # one spelling all three shells run, so the step needs no branch.
+        run: |
+          uv run python -c "import subprocess, sys; raise SystemExit(subprocess.run([sys.executable, '-m', 'motui'], stdin=subprocess.DEVNULL).returncode)"
+
+      - name: demo -- every page dumped
+        run: uv run python -m motui --pages

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

@@ -0,0 +1,61 @@
+# Releases: a ``v*`` tag builds the package and publishes it.
+#
+# Written now, run later: this group ships the file configured and does not
+# push, tag or execute it -- the first real run is the maintainer's call.
+#
+# Publishing is PyPI **trusted publishing** (an OIDC exchange, no API token):
+# there are no secrets in this repository.  The one-time setup lives on PyPI:
+# add a publisher (or a "pending publisher") for this repository and this
+# workflow file, and give it the environment name spelled below -- ``pypi``.
+# The job's ``environment:`` must match that name exactly; the job-level
+# ``id-token: write`` is what lets the publish step mint the token PyPI
+# verifies.  Change the name here if the publisher is configured with
+# another one; nothing else in this file needs touching.
+#
+# The matrix builds on both platforms -- the cross-platform proof -- and the
+# wheel is pure Python (``py3-none-any``), so exactly one upload happens:
+# the Linux leg's.  A run of this workflow without the publisher configured
+# fails at the last step and publishes nothing.
+
+name: release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  release:
+    name: ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    # The environment name PyPI's trusted publisher must carry (see above).
+    # It gates the whole job -- the Windows leg included, deliberately: the
+    # two legs are one release.
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: uv, pinned to the dev toolchain
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.12.21"
+
+      - name: build -- the sdist and the wheel, from the locked tree
+        run: uv build
+
+      - name: publish to PyPI -- trusted publishing, one upload
+        if: runner.os == 'Linux'
+        uses: pypa/gh-action-pypi-publish@release/v1

motui-1.0.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.zcode/

motui-1.0.0/LICENSE

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