tkwry 0.0.1__tar.gz

tkwry-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,115 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Linux system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            libwebkit2gtk-4.1-dev \
+            libgtk-3-dev \
+            libglib2.0-dev
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install ruff
+        run: pip install "ruff>=0.9"
+
+      - name: Ruff
+        run: ruff check tkwry tests examples
+
+      - name: Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - run: cargo fmt --check
+
+      - name: Clippy
+        env:
+          # setup-python points PKG_CONFIG_PATH at Python only; use system GTK.
+          PKG_CONFIG_PATH: ""
+        run: cargo clippy -- -D warnings
+
+  test:
+    name: Test (${{ matrix.os }}, py${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            python-version: "3.12"
+          - os: windows-latest
+            python-version: "3.12"
+          - os: macos-latest
+            python-version: "3.12"
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Linux system dependencies
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            libwebkit2gtk-4.1-dev \
+            libgtk-3-dev \
+            libglib2.0-dev \
+            xvfb
+
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install maturin pytest
+
+      - name: Build and install
+        shell: bash
+        env:
+          PKG_CONFIG_PATH: ""
+        run: |
+          maturin build --release --out dist
+          pip install dist/*.whl
+
+      - name: Configure Tcl/Tk (Windows)
+        if: runner.os == 'Windows'
+        shell: bash
+        run: |
+          echo "TCL_LIBRARY=${pythonLocation}/tcl/tcl8.6" >> "$GITHUB_ENV"
+          echo "TK_LIBRARY=${pythonLocation}/tcl/tk8.6" >> "$GITHUB_ENV"
+
+      - name: Run tests (Linux)
+        if: runner.os == 'Linux'
+        shell: bash
+        env:
+          DISPLAY: :99
+          TK_SILENCE_DEPRECATION: "1"
+        run: xvfb-run -a pytest tests/ -v
+
+      - name: Run tests (Windows / macOS)
+        if: runner.os != 'Linux'
+        shell: bash
+        env:
+          TK_SILENCE_DEPRECATION: "1"
+        run: pytest tests/ -v

tkwry-0.0.1/.github/workflows/release.yml

@@ -0,0 +1,132 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  sdist:
+    name: Source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  wheels:
+    name: Wheel (${{ matrix.id }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - id: windows
+            os: windows-latest
+            target: ""
+          - id: macos-arm64
+            os: macos-latest
+            target: aarch64-apple-darwin
+          - id: macos-x86_64
+            os: macos-latest
+            target: x86_64-apple-darwin
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - name: Add Rust target
+        if: matrix.target != ''
+        run: rustup target add ${{ matrix.target }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build abi3 wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheel-${{ matrix.id }}
+          path: dist/*.whl
+
+  github-release:
+    name: GitHub Release
+    runs-on: ubuntu-latest
+    needs: [sdist, wheels]
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheel-*
+          merge-multiple: true
+          path: dist
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist
+
+      - name: List dist
+        shell: bash
+        run: ls -la dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: [sdist, wheels]
+    environment:
+      name: pypi
+      url: https://pypi.org/p/tkwry
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheel-*
+          merge-multiple: true
+          path: dist
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist
+
+      - name: List dist
+        shell: bash
+        run: ls -la dist/
+
+      - name: Publish
+        uses: PyO3/maturin-action@v1
+        with:
+          command: upload
+          args: --non-interactive --skip-existing dist/*

tkwry-0.0.1/.gitignore

@@ -0,0 +1,33 @@
+__pycache__/
+*.py[cod]
+*$py.class
+.Python
+.venv/
+venv/
+dist/
+dist-test/
+build/
+target/
+*.egg-info/
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+.DS_Store
+
+# Local / private
+NOTES.md
+.env
+.env.*
+*.local
+*競合*
+*conflicted copy*
+
+# Built extension modules
+*.so
+*.pyd
+*.dylib
+*.whl
+tkwry/_core*.so
+tkwry/_core*.pyd

tkwry-0.0.1/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [0.0.1] - 2026-06-23
+
+### Added
+
+- `WebView` widget — embed wry as a true child of a Tkinter `Frame` (HWND / NSView / X11)
+- Layout sync for `pack`, `grid`, `place`, tabs, and `PanedWindow`
+- IPC bridge (`window.ipc.postMessage`) with Tk-thread queueing
+- Navigation hooks: `on_navigation`, `on_page_load`, `on_title_changed`, `on_new_window`
+- Native OS drag-and-drop into the WebView (`drag_drop_handler`, `DragDropEvent`)
+- `load_url`, `load_html`, `reload`, `eval_js`, `eval_js_with_callback`
+- DevTools, `focus`, `background_color`, `user_agent`, `initialization_script`
+- URL normalization and `http`/`https` validation
+- Pre-built **abi3** wheels for Windows (x86_64) and macOS (arm64 + Intel)
+- Examples: `url_demo`, `ipc_demo`, `multi_demo`, `plotly_demo`, `dnd_demo`
+- CI on Linux (Xvfb + WebKitGTK), Windows, and macOS
+
+### Known limitations
+
+- **Alpha** — APIs may change without notice
+- **macOS** — child `Frame`s share the toplevel content view; tkwry syncs bounds and visibility automatically (including `ttk.Notebook` tabs)
+- **Linux** — no PyPI wheels; build from source with WebKitGTK 4.1
+- **DevTools** — uses private APIs on macOS; avoid in App Store release builds
+- Drag-and-drop targets the WebView region only (not arbitrary Tk widgets)
+
+[0.0.1]: https://github.com/mashu3/tkwry/releases/tag/v0.0.1