gpyui 0.1.0__tar.gz

gpyui-0.1.0/.github/workflows/checks.yml

@@ -0,0 +1,27 @@
+name: Python checks
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: checks-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    env:
+      UV_PROJECT_ENVIRONMENT: .venv-tools
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - uses: astral-sh/setup-uv@v6
+      - run: uv sync --locked --only-group dev
+      - run: uv run --locked --only-group dev just check

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

@@ -0,0 +1,79 @@
+name: Documentation
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: docs-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: read
+    outputs:
+      pages_enabled: ${{ steps.pages.outputs.enabled }}
+    env:
+      UV_PROJECT_ENVIRONMENT: .venv-docs
+    steps:
+      - name: Check GitHub Pages configuration
+        id: pages
+        if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+        run: |
+          if gh api "repos/$GH_REPO/pages" --jq .build_type > "$RUNNER_TEMP/pages-type" 2> "$RUNNER_TEMP/pages-error"; then
+            if [ "$(cat "$RUNNER_TEMP/pages-type")" = workflow ]; then
+              echo 'enabled=true' >> "$GITHUB_OUTPUT"
+            else
+              echo '::warning::Select GitHub Actions in Settings > Pages to publish the documentation.'
+              echo 'enabled=false' >> "$GITHUB_OUTPUT"
+            fi
+          elif grep -q 'HTTP 404' "$RUNNER_TEMP/pages-error"; then
+            echo '::warning::Enable GitHub Pages with the GitHub Actions source, then run this workflow again.'
+            echo 'enabled=false' >> "$GITHUB_OUTPUT"
+          else
+            cat "$RUNNER_TEMP/pages-error" >&2
+            exit 1
+          fi
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - uses: astral-sh/setup-uv@v6
+      - run: uv sync --locked --only-group docs
+      - run: uv run --locked --only-group docs python scripts/generate-docs.py --check
+      - run: uv run --locked --only-group docs zensical build --strict --clean
+      - run: uv run --locked --only-group docs python scripts/check-docs-site.py
+      - uses: actions/upload-artifact@v4
+        with:
+          name: gpyui-docs
+          path: site/
+          retention-days: 7
+      - uses: actions/upload-pages-artifact@v3
+        if: steps.pages.outputs.enabled == 'true'
+        with:
+          path: site/
+
+  deploy:
+    if: needs.build.outputs.pages_enabled == 'true' && github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/deploy-pages@v4
+        id: deployment

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

@@ -0,0 +1,214 @@
+name: Build wheels
+
+on:
+  pull_request:
+    paths:
+      - .github/workflows/release.yml
+      - Cargo.toml
+      - Cargo.lock
+      - rust-toolchain.toml
+      - pyproject.toml
+      - src/**
+      - tests/**
+      - examples/**
+      - scripts/wheel*.py
+      - scripts/wheel-build-deps.sh
+      - scripts/test-native.sh
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+    inputs:
+      github_release:
+        description: Create a GitHub prerelease after all wheel tests pass (select a version tag)
+        type: boolean
+        default: false
+      publish:
+        description: Publish to PyPI after all wheel tests pass (select a version tag)
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+
+concurrency:
+  group: wheels-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  prepare:
+    runs-on: ubuntu-24.04
+    outputs:
+      rust: ${{ steps.config.outputs.rust }}
+      maturin: ${{ steps.config.outputs.maturin }}
+      version: ${{ steps.config.outputs.version }}
+      builds: ${{ steps.config.outputs.builds }}
+      tests: ${{ steps.config.outputs.tests }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - id: config
+        env:
+          PUBLISH: ${{ inputs.publish || false }}
+          RELEASE: ${{ inputs.github_release || false }}
+        run: python scripts/wheel-ci.py prepare
+
+  build:
+    name: Wheel / ${{ matrix.name }}
+    needs: prepare
+    runs-on: ${{ matrix.runner }}
+    timeout-minutes: 90
+    strategy:
+      fail-fast: false
+      matrix: ${{ fromJSON(needs.prepare.outputs.builds) }}
+    defaults:
+      run:
+        shell: bash
+    env:
+      CARGO_BUILD_JOBS: "2"
+      MACOSX_DEPLOYMENT_TARGET: "12.0"
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - uses: Swatinem/rust-cache@v2
+        with:
+          shared-key: wheel-${{ matrix.name }}
+          cache-on-failure: true
+      - name: Build Linux wheel against system desktop libraries
+        if: runner.os == 'Linux'
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          # Mesa uses GPUI's XCB connection. Bundling another libxcb crashes.
+          manylinux: "off"
+          container: quay.io/pypa/manylinux_2_28_${{ matrix.arch }}:latest
+          rust-toolchain: ${{ needs.prepare.outputs.rust }}
+          maturin-version: ${{ needs.prepare.outputs.maturin }}
+          args: --release --locked --strip ${{ matrix.sdist }} --auditwheel skip --out dist --interpreter /opt/python/cp312-cp312/bin/python
+          before-script-linux: bash scripts/wheel-build-deps.sh
+      - name: Build macOS or Windows wheel
+        if: runner.os != 'Linux'
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          rust-toolchain: ${{ needs.prepare.outputs.rust }}
+          maturin-version: ${{ needs.prepare.outputs.maturin }}
+          args: --release --locked --strip --out dist --interpreter python
+      - uses: astral-sh/setup-uv@v6
+      - name: Validate wheel contents and metadata
+        env:
+          WHEEL_PLATFORM: ${{ matrix.platform }}
+        run: |
+          python scripts/wheel-ci.py check
+          uvx --from twine==7.0.0 twine check --strict dist/*
+      - name: Audit Linux dependencies
+        if: runner.os == 'Linux'
+        run: uvx --from auditwheel==6.8.2 auditwheel show dist/*.whl
+      - uses: actions/upload-artifact@v4
+        with:
+          name: gpyui-dist-${{ matrix.name }}
+          path: dist/*
+          if-no-files-found: error
+          retention-days: 14
+
+  test:
+    name: Installed wheel / ${{ matrix.name }} / Python ${{ matrix.python }}
+    needs: [prepare, build]
+    runs-on: ${{ matrix.runner }}
+    timeout-minutes: 20
+    strategy:
+      fail-fast: false
+      matrix: ${{ fromJSON(needs.prepare.outputs.tests) }}
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - uses: astral-sh/setup-uv@v6
+      - uses: actions/download-artifact@v4
+        with:
+          name: gpyui-dist-${{ matrix.name }}
+          path: dist
+      - name: Install Linux native runtime and test tools
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y xvfb xdotool imagemagick mesa-vulkan-drivers \
+            libvulkan1 libfontconfig1 libfreetype6 libxcb1 libxkbcommon0 \
+            libxkbcommon-x11-0 fonts-dejavu-core
+      - name: Install and verify the wheel without rebuilding
+        run: python scripts/wheel-ci.py install
+      - name: Run Python and bridge tests
+        run: python scripts/wheel-ci.py test
+      - name: Select software Vulkan driver
+        if: runner.os == 'Linux'
+        run: |
+          python - <<'PYTHON'
+          import os
+          from pathlib import Path
+          drivers = list(Path('/usr/share/vulkan/icd.d').glob('lvp*.json'))
+          assert len(drivers) == 1, drivers
+          with open(os.environ['GITHUB_ENV'], 'a') as output:
+              print(f'VK_DRIVER_FILES={drivers[0]}', file=output)
+          PYTHON
+      - name: Run Linux window interaction tests
+        if: runner.os == 'Linux'
+        run: scripts/test-native.sh
+      - name: Run native window, state and lifecycle smoke test
+        if: runner.os != 'Linux'
+        run: python scripts/wheel-ci.py native
+      - uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: native-test-failure-${{ matrix.name }}-${{ matrix.python }}
+          path: artifacts/
+          retention-days: 7
+
+  release:
+    name: GitHub release with verified wheels
+    if: (github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')) || (github.event_name == 'workflow_dispatch' && inputs.github_release)
+    needs: [prepare, build, test]
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: gpyui-dist-*
+          merge-multiple: true
+          path: dist
+      - name: Create checksums and release notes
+        run: python scripts/wheel-ci.py release
+      - name: Publish GitHub prerelease
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: v${{ needs.prepare.outputs.version }}
+        run: |
+          gh release create "$TAG" --verify-tag --draft --prerelease \
+            --title "gpyui $TAG" --notes-file artifacts/release-notes.md
+          gh release upload "$TAG" dist/*
+          gh release edit "$TAG" --draft=false
+
+  publish:
+    name: Publish tested distributions to PyPI
+    if: github.event_name == 'workflow_dispatch' && inputs.publish
+    needs: [prepare, build, test]
+    runs-on: ubuntu-24.04
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: gpyui-dist-*
+          merge-multiple: true
+          path: dist
+      - uses: astral-sh/setup-uv@v6
+      - run: uv publish --trusted-publishing always

gpyui-0.1.0/.gitignore

@@ -0,0 +1,20 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+target/
+*.so
+*.pyd
+.pytest_cache/
+.ruff_cache/
+artifacts/
+.venv-docs/
+.venv-tools/
+site/
+.cache/

gpyui-0.1.0/.python-version

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

gpyui-0.1.0/AGENTS.md

@@ -0,0 +1,17 @@
+# Project intent
+
+The user's goal is a reusable Python UI toolkit exposing Longbridge's GPUI Kit
+components, enabling complete native desktop apps written entirely in Python,
+comparable in use to Tkinter and other Python UI libraries. The working name is
+gpyui; package-name availability has not been checked.
+
+Keep Rust behind the Python API. Rust owns native windows, rendering, component
+state and text editing; Python authors own composition and application behavior.
+Use actual GPUI Kit components and verify wrappers against the pinned upstream
+sources. The column, label, text input and button are the first milestone, not
+the final scope or a demo-specific backend.
+
+Extend component coverage and Python access to layout, styling, events, state and
+application lifecycle as the toolkit develops. Distinguish implemented support
+from planned capabilities. See README.md and docs/architecture.md for the current
+API, source evidence and constraints.