robotframework-javagui 0.6.0__tar.gz

robotframework_javagui-0.6.0/.github/workflows/ci.yml

@@ -0,0 +1,194 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  build-test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-14]
+        python: ["3.10", "3.12", "3.14"]
+    defaults:
+      run:
+        shell: bash
+    env:
+      CARGO_TERM_COLOR: always
+      RUST_BACKTRACE: 1
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v2
+        with:
+          version: latest
+
+      - name: Setup Python (primary, via uv)
+        id: setup_python_primary
+        run: uv python install ${{ matrix.python }}
+        continue-on-error: ${{ matrix.python == '3.14' }}
+
+      - name: Setup Python (fallback to 3.13, via uv)
+        if: ${{ matrix.python == '3.14' && steps.setup_python_primary.outcome == 'failure' }}
+        run: uv python install 3.13
+
+      - name: Show uv and Python versions
+        run: |
+          uv --version
+          uv run python --version
+
+      - name: Setup Java 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: "17"
+          cache: maven
+
+      - name: Setup Rust (stable)
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache Cargo
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Install dependencies (dev)
+        run: uv sync --all-extras --group dev
+
+      - name: Install build tools
+        run: uv tool install maturin
+
+      - name: Install Linux UI dependencies
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            xvfb \
+            libgtk-3-0 \
+            libglib2.0-0 \
+            libx11-6 \
+            libxext6 \
+            libxrender1 \
+            libxtst6 \
+            libxi6 \
+            libxrandr2 \
+            libxcomposite1 \
+            libxdamage1 \
+            libxkbcommon0
+          sudo apt-get install -y libasound2 || sudo apt-get install -y libasound2t64
+
+      - name: Start Xvfb
+        if: runner.os == 'Linux'
+        run: |
+          Xvfb :99 -screen 0 1920x1080x24 > /tmp/xvfb.log 2>&1 &
+          echo "DISPLAY=:99" >> "$GITHUB_ENV"
+
+      - name: Build test apps (Swing/SWT/RCP-mock)
+        if: runner.os != 'macOS'
+        run: |
+          cd tests/apps
+          (cd swing && mvn clean package)
+          (cd swt && mvn clean package)
+          (cd rcp-mock && mvn clean package)
+
+      - name: Build test apps (Swing/SWT/RCP-mock, macOS arm64)
+        if: runner.os == 'macOS'
+        run: |
+          cd tests/apps
+          (cd swing && mvn clean package)
+          (cd swt && mvn clean package -Pswt-mac-arm64)
+          (cd rcp-mock && mvn clean package -Pswt-mac-arm64)
+
+      - name: Build full package (agent + wheel)
+        run: uv run invoke build
+
+      - name: Add Windows port tools to PATH
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Add-Content -Path $env:GITHUB_PATH -Value "$PWD\\scripts\\ci\\win-tools"
+
+      - name: Diagnostic Swing app startup (Linux/macOS)
+        if: runner.os != 'Windows'
+        run: bash scripts/ci/diagnostic-swing.sh
+
+      - name: Diagnostic Swing app startup (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: scripts/ci/diagnostic-swing.ps1
+
+      - name: Diagnostic SWT app startup (Linux/macOS)
+        if: runner.os != 'Windows'
+        run: bash scripts/ci/diagnostic-swt.sh
+
+      - name: Diagnostic SWT app startup (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: scripts/ci/diagnostic-swt.ps1
+
+      - name: Cleanup test apps (Linux/macOS)
+        if: runner.os != 'Windows'
+        run: bash scripts/ci/cleanup-test-apps.sh
+
+      - name: Cleanup test apps (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: scripts/ci/cleanup-test-apps.ps1
+
+      - name: Smoke Robot Tests (Swing/SWT/RCP)
+        if: runner.os != 'macOS'
+        run: |
+          uv run robot --outputdir tests/robot/output-smoke \
+            tests/robot/swing/01_connection.robot \
+            tests/robot/swt/01_connection.robot \
+            tests/robot/rcp/01_connection.robot
+
+      - name: Smoke Robot Tests (macOS only, no RCP)
+        if: runner.os == 'macOS'
+        run: |
+          uv run robot --outputdir tests/robot/output-smoke \
+            tests/robot/swing/01_connection.robot \
+            tests/robot/swt/01_connection.robot
+
+      - name: Run Robot Framework tests (incl. Swing/SWT/RCP)
+        if: runner.os != 'macOS'
+        run: uv run robot --outputdir tests/robot/output tests/robot/
+
+      - name: Run Robot Framework tests (macOS only, no RCP)
+        if: runner.os == 'macOS'
+        run: uv run robot --outputdir tests/robot/output tests/robot/swing tests/robot/swt
+
+      - name: Run Python tests
+        run: uv run pytest tests/python/
+
+      - name: Upload Robot logs
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: robot-logs-${{ matrix.os }}-py${{ matrix.python }}
+          path: |
+            tests/robot/output-smoke/**
+            tests/robot/output/**
+          if-no-files-found: warn
+
+      - name: Upload build artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-${{ matrix.os }}-py${{ matrix.python }}
+          path: |
+            target/wheels/*.whl
+            agent/target/*.jar
+            python/JavaGui/jars/*.jar
+          if-no-files-found: warn

robotframework_javagui-0.6.0/.github/workflows/release.yml

@@ -0,0 +1,255 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Tag to release (e.g. v0.1.0)"
+        required: true
+      version:
+        description: "Package version (optional, defaults to tag without 'v' prefix)"
+        required: false
+      publish_pypi:
+        description: "Publish to PyPI"
+        required: false
+        default: "false"
+        type: boolean
+
+jobs:
+  # =============================================================================
+  # Build Java Agent (single build, shared across all platforms)
+  # =============================================================================
+  build-agent:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Java 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: "17"
+          cache: maven
+
+      - name: Build Java Agent
+        run: |
+          cd agent
+          mvn clean package -DskipTests
+          ls -la target/*.jar
+
+      - name: Upload Java Agent
+        uses: actions/upload-artifact@v4
+        with:
+          name: java-agent
+          path: agent/target/javagui-agent.jar
+          if-no-files-found: error
+
+  # =============================================================================
+  # Build Python Wheels (ABI3 - one wheel per OS works for all Python versions)
+  # Uses manylinux containers on Linux for broad glibc compatibility
+  # =============================================================================
+  build-wheels:
+    needs: build-agent
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+            manylinux: "2_17"
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+          - os: macos-14
+            target: aarch64-apple-darwin
+    defaults:
+      run:
+        shell: bash
+    env:
+      CARGO_TERM_COLOR: always
+      RUST_BACKTRACE: 1
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Download Java Agent
+        uses: actions/download-artifact@v4
+        with:
+          name: java-agent
+          path: agent/target/
+
+      - name: Copy agent JAR to package
+        run: |
+          mkdir -p python/JavaGui/jars
+          cp agent/target/javagui-agent.jar python/JavaGui/jars/javagui-agent.jar
+          ls -la python/JavaGui/jars/
+
+      - name: Build wheel (Linux - manylinux container)
+        if: runner.os == 'Linux'
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          manylinux: ${{ matrix.manylinux }}
+          args: --release --strip
+
+      - name: Build wheel (non-Linux)
+        if: runner.os != 'Linux'
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --strip
+
+      - name: Verify wheel
+        run: |
+          ls -la target/wheels/
+          echo "ABI3 wheel works for all Python versions 3.8+"
+
+          # Verify only one wheel was built (ABI3)
+          WHEEL_COUNT=$(ls -1 target/wheels/*.whl 2>/dev/null | wc -l)
+          if [ "$WHEEL_COUNT" -ne 1 ]; then
+            echo "ERROR: Expected 1 ABI3 wheel, found $WHEEL_COUNT"
+            ls -la target/wheels/
+            exit 1
+          fi
+
+      - name: Upload wheel
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheel-${{ matrix.os }}
+          path: target/wheels/*.whl
+          if-no-files-found: error
+
+  # =============================================================================
+  # Create Draft GitHub Release
+  # =============================================================================
+  release:
+    runs-on: ubuntu-latest
+    needs: [build-agent, build-wheels]
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist-artifacts
+
+      - name: Organize release files
+        run: |
+          mkdir -p release-files/wheels
+          mkdir -p release-files/agent
+
+          # Collect all wheels
+          find dist-artifacts -name "*.whl" -exec cp {} release-files/wheels/ \;
+
+          # Collect agent JAR
+          find dist-artifacts -name "*.jar" -exec cp {} release-files/agent/ \;
+
+          echo "=== Wheels ==="
+          ls -la release-files/wheels/
+          echo "=== Agent ==="
+          ls -la release-files/agent/
+
+          # Verify exactly 3 ABI3 wheels (one per platform)
+          WHEEL_COUNT=$(ls -1 release-files/wheels/*.whl 2>/dev/null | wc -l)
+          ABI3_COUNT=$(ls -1 release-files/wheels/*-cp38-abi3-*.whl 2>/dev/null | wc -l)
+          echo "Total wheels: $WHEEL_COUNT (expected: 3)"
+          echo "ABI3 wheels: $ABI3_COUNT (expected: 3)"
+
+          if [ "$WHEEL_COUNT" -ne 3 ] || [ "$ABI3_COUNT" -ne 3 ]; then
+            echo "ERROR: Expected exactly 3 ABI3 wheels (one per platform)"
+            echo "Found $WHEEL_COUNT total wheels, $ABI3_COUNT ABI3 wheels"
+            exit 1
+          fi
+
+      - name: Determine version
+        id: version
+        run: |
+          if [ -n "${{ inputs.version }}" ]; then
+            echo "version=${{ inputs.version }}" >> $GITHUB_OUTPUT
+          else
+            # Strip 'v' prefix from tag
+            echo "version=${TAG#v}" >> $GITHUB_OUTPUT
+          fi
+        env:
+          TAG: ${{ inputs.tag }}
+
+      - name: Create draft GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          draft: true
+          tag_name: ${{ inputs.tag }}
+          name: "Release ${{ inputs.tag }}"
+          generate_release_notes: true
+          body: |
+            ## robotframework-javagui ${{ steps.version.outputs.version }}
+
+            ### Installation
+
+            ```bash
+            pip install robotframework-javagui==${{ steps.version.outputs.version }}
+            ```
+
+            ### Downloads
+
+            - **Python Wheels**: ABI3 wheels compatible with Python 3.8+ (one per platform)
+            - **Java Agent**: `javagui-agent.jar`
+
+            ### Changes
+
+            See below for auto-generated release notes.
+          files: |
+            release-files/wheels/*.whl
+            release-files/agent/*.jar
+
+  # =============================================================================
+  # Publish to PyPI (optional, triggered by input)
+  # =============================================================================
+  publish-pypi:
+    runs-on: ubuntu-latest
+    needs: [build-wheels]
+    if: ${{ inputs.publish_pypi == true }}
+    environment: release  # GitHub Environment for trusted publishing
+    permissions:
+      id-token: write  # Required for trusted publishing
+
+    steps:
+      - name: Download wheel artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheel-*
+          path: dist-artifacts
+          merge-multiple: true
+
+      - name: Collect wheels for PyPI
+        run: |
+          mkdir -p dist/pypi
+          find dist-artifacts -name "*.whl" -exec cp {} dist/pypi/ \;
+
+          echo "=== Wheels to publish ==="
+          ls -la dist/pypi/
+
+          # Verify exactly 3 ABI3 wheels (one per platform)
+          WHEEL_COUNT=$(ls -1 dist/pypi/*.whl 2>/dev/null | wc -l)
+          ABI3_COUNT=$(ls -1 dist/pypi/*-cp38-abi3-*.whl 2>/dev/null | wc -l)
+          echo "Total wheels: $WHEEL_COUNT (expected: 3)"
+          echo "ABI3 wheels: $ABI3_COUNT (expected: 3)"
+
+          if [ "$WHEEL_COUNT" -ne 3 ] || [ "$ABI3_COUNT" -ne 3 ]; then
+            echo "ERROR: Expected exactly 3 ABI3 wheels for PyPI upload"
+            echo "Found $WHEEL_COUNT total wheels, $ABI3_COUNT ABI3 wheels"
+            exit 1
+          fi
+
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/pypi/
+          # No password needed - uses OIDC trusted publishing
+          # Requires PyPI trusted publisher configured for:
+          #   - Owner: manykarim
+          #   - Repo: robotframework-javaui
+          #   - Workflow: release.yml
+          #   - Environment: release

robotframework_javagui-0.6.0/.gitignore

@@ -0,0 +1,148 @@
+# =============================================================================
+# Rust
+# =============================================================================
+/target/
+**/*.rs.bk
+
+# =============================================================================
+# Python
+# =============================================================================
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.dylib
+*.dll
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# Type checkers
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# =============================================================================
+# Java
+# =============================================================================
+agent/target/
+agent/build/
+agent/.gradle/
+demo/target/
+demo/build/
+demo/.gradle/
+tests/apps/*/target/
+tests/apps/*/dependency-reduced-pom.xml
+*.class
+
+# =============================================================================
+# Node.js
+# =============================================================================
+node_modules/
+package-lock.json
+package.json
+
+# =============================================================================
+# Demo Applications (large binary files)
+# =============================================================================
+demo/*.jar
+demo/*.tar.gz
+demo/dbeaver/
+demo/jdk-*/
+!demo/src/
+
+# =============================================================================
+# Test Output
+# =============================================================================
+**/results/
+**/output/
+output.xml
+log.html
+report.html
+screenshot*.png
+custom_screenshot.png
+
+# Pytest
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# =============================================================================
+# IDE / Editor
+# =============================================================================
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.project
+.classpath
+.settings/
+*.iml
+
+# OS
+.DS_Store
+Thumbs.db
+
+# =============================================================================
+# Claude Code / Flow
+# =============================================================================
+.claude/
+.claude-flow/
+.hive-mind/
+.swarm/
+.mcp.json
+CLAUDE.md
+PIPE
+agents/
+memory/
+
+# =============================================================================
+# Database files
+# =============================================================================
+*.db
+*.db-journal
+*.db-wal
+*.db-shm
+*.sqlite
+*.sqlite-journal
+*.sqlite-wal
+
+# =============================================================================
+# Temporary / Generated Files
+# =============================================================================
+*.tmp
+*.temp
+*.bak
+*.log
+runswttests.txt
+hive-mind-prompt-*.txt
+claude-flow
+
+# Bundled JARs (copied from agent/target during build)
+python/JavaGui/jars/
+
+# Third-party demo/showcase binaries used for manual exploration (do not ship)
+example-apps/*.jar

robotframework_javagui-0.6.0/.python-version

@@ -0,0 +1 @@
+3.11.7

robotframework_javagui-0.6.0/AGENTS.md

@@ -0,0 +1,39 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- `src/`: Rust core (PyO3 bindings, locator parsing, RPC/connection logic).
+- `python/JavaGui/`: Python package that exposes Swing/Swt/Rcp keywords; bundled JARs live in `python/JavaGui/jars/`.
+- `agent/`: Java agent (Maven project; built JARs in `agent/target/`).
+- `tests/robot/`: Robot Framework suites (numbered `NN_*.robot`), plus toolkit-specific folders.
+- `tests/python/` and `tests/unit/`: Pytest suites for Python bindings and smaller unit checks.
+- `docs/`, `schemas/`, `scripts/`: supporting docs, schemas, and helper scripts.
+
+## Build, Test, and Development Commands
+- `uv pip install -e ".[dev]"`: install dev dependencies (project uses `uv`).
+- `invoke build-dev`: build the Java agent (fat JAR), copy it into the Python package, and compile the Rust extension for local use.
+- `invoke build`: full build (agent + wheel) for distribution.
+- `cd tests/apps && mvn package`: build the Swing/SWT/RCP test applications used by Robot suites.
+- `uv run robot tests/robot/`: run all Robot suites (outputs under `tests/robot/output/`).
+- `uv run robot tests/robot/02_locators.robot`: run a specific Robot suite.
+- `uv run pytest tests/python/`: run Python tests (pytest config lives in `pyproject.toml`).
+- `invoke lint`: run `ruff` on Python and `cargo clippy -D warnings` on Rust.
+- `invoke format-all`: format Python (`ruff format`) and Rust (`cargo fmt`).
+
+## Coding Style & Naming Conventions
+- Python: 4-space indentation, 100-char lines, formatted with `ruff format`, linted by `ruff`, typed with `mypy`.
+- Rust: use `cargo fmt`; keep clippy clean (`cargo clippy -D warnings`).
+- Robot: `.robot` files use numeric prefixes (`01_connection.robot`) and readable test-case names.
+
+## Testing Guidelines
+- Build the test apps in `tests/apps/` before running Robot suites (they exercise Swing/SWT/RCP UIs).
+- Robot Framework tests live in `tests/robot/`; run via `uv run robot ...`, outputs default to `tests/robot/output/`.
+- Pytest files follow `test_*.py` naming, with tests named `test_*` (see `tests/python/pytest.ini`).
+- Add coverage for new keywords/locators with both Robot suites and focused pytest unit tests where possible.
+
+## Commit & Pull Request Guidelines
+- Commit messages follow a conventional prefix (examples in history: `fix:`, `docs:`). Use `type: summary`.
+- PRs should describe behavior changes, list test commands run, and link related issues when applicable.
+
+## Configuration Notes
+- Build metadata is in `Cargo.toml` and `pyproject.toml`; update both if you change versioning.
+- Java agent artifact is expected at `agent/target/javagui-agent.jar`.