ui-locator-cli 0.1.0__tar.gz

ui_locator_cli-0.1.0/.env.example

@@ -0,0 +1,30 @@
+# ui-locator secrets.
+#
+# Non-secret settings (provider, endpoint, model, prompt style) belong in
+# .ui-locator/config.toml, where they can be committed and switched with
+# `--use <profile>`. Run `ui-locator init` to create it, then keep only keys
+# here (this file, or .ui-locator/.env, is gitignored by that template).
+#
+# Check what actually resolved with: ui-locator config show
+
+UI_LOCATOR_OPENAI_API_KEY=<your-api-key>
+# UI_LOCATOR_ANTHROPIC_API_KEY=<your-anthropic-api-key>
+
+# Everything below can equally live in .ui-locator/config.toml; environment
+# variables win over it, which makes them handy for one-off overrides.
+
+# UI_LOCATOR_USE=qwen-cloud            # pick a [models.<name>] profile
+# UI_LOCATOR_PROVIDER=openai
+# UI_LOCATOR_OPENAI_BASE_URL=https://api.fireworks.ai/inference/v1
+# UI_LOCATOR_OPENAI_MODEL=accounts/fireworks/models/qwen3p7-plus
+# UI_LOCATOR_OPENAI_PROMPT=qwen        # required for Qwen: parses <box>, not <point>
+
+# Element map
+# UI_LOCATOR_MAP_DIR=/path/to/map      # default: <project>/.ui-locator/map
+# UI_LOCATOR_SESSION=run-42            # tag learned entries
+# UI_LOCATOR_USE_MAP=false             # ignore stored positions
+# UI_LOCATOR_VERIFY=true               # re-check a crop before trusting one
+
+# Misc
+# UI_LOCATOR_THINK=true
+# UI_LOCATOR_MAX_TOKENS=512

ui_locator_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,138 @@
+name: publish
+
+# Publishes to PyPI when a GitHub release is published, so the release notes
+# and the uploaded version are always the same event. Can also be run by hand
+# against TestPyPI to rehearse.
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      target:
+        description: Index to upload to
+        type: choice
+        default: testpypi
+        options: [testpypi, pypi]
+
+permissions:
+  contents: read
+
+jobs:
+  # uv.lock is not committed, so CI resolves dependencies fresh -- exactly how a
+  # user installing from PyPI does. Both ends of the supported range are tested
+  # because typer 0.27 stopped being click-based, which a single "latest" job
+  # caught only by accident.
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        typer: ["typer", "typer==0.16.0"]
+    name: test (${{ matrix.typer }})
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+
+      - name: Install the project
+        run: |
+          uv sync --extra dev
+          uv pip install '${{ matrix.typer }}'
+
+      - name: Lint
+        run: uv run --no-sync ruff check src tests bench
+
+      - name: Type-check
+        run: uv run --no-sync mypy
+
+      - name: Test
+        run: uv run --no-sync pytest -q
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+
+      - name: Install the project
+        run: uv sync --extra dev
+
+      # A tag that disagrees with pyproject.toml would publish a version nobody
+      # asked for, and PyPI never lets a version be reused.
+      - name: Check the tag matches the project version
+        if: github.event_name == 'release'
+        run: |
+          version=$(uv run python -c "import tomllib,pathlib;print(tomllib.loads(pathlib.Path('pyproject.toml').read_text())['project']['version'])")
+          tag="${GITHUB_REF_NAME#v}"
+          echo "pyproject: $version — tag: $tag"
+          if [ "$version" != "$tag" ]; then
+            echo "::error::tag '$GITHUB_REF_NAME' does not match version '$version' in pyproject.toml"
+            exit 1
+          fi
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      # The skill is package data; if it ever falls out of the wheel,
+      # `ui-locator skill install` silently has nothing to install.
+      - name: Check the bundled skill is in the wheel
+        run: |
+          uv run python - <<'PY'
+          import glob, sys, zipfile
+          wheel = glob.glob("dist/*.whl")[0]
+          names = zipfile.ZipFile(wheel).namelist()
+          if "ui_locator/skill/SKILL.md" not in names:
+              sys.exit(f"SKILL.md missing from {wheel}")
+          print(f"ok: SKILL.md present in {wheel}")
+          PY
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: ${{ github.event_name == 'release' && 'pypi' || inputs.target }}
+    permissions:
+      id-token: write # PEP 740 attestations (and Trusted Publishing, see below)
+    env:
+      HAS_TEST_TOKEN: ${{ secrets.TEST_PYPI_API_TOKEN != '' }}
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        if: >-
+          github.event_name == 'workflow_dispatch' && inputs.target == 'testpypi'
+          && env.HAS_TEST_TOKEN == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          password: ${{ secrets.TEST_PYPI_API_TOKEN }}
+
+      - name: Note a skipped TestPyPI upload
+        if: >-
+          github.event_name == 'workflow_dispatch' && inputs.target == 'testpypi'
+          && env.HAS_TEST_TOKEN != 'true'
+        run: |
+          echo "::notice::Built and round-tripped the artifacts; TestPyPI upload"\
+            " skipped because TEST_PYPI_API_TOKEN is not set."
+
+      - name: Publish to PyPI
+        if: github.event_name == 'release' || inputs.target == 'pypi'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          # Prefer Trusted Publishing: configure a publisher for this repo and
+          # workflow at https://pypi.org/manage/project/ui-locator-cli/settings/publishing/
+          # then delete the line below — GitHub mints a short-lived OIDC token
+          # per run and there is no long-lived secret to leak or rotate.
+          password: ${{ secrets.PYPI_API_TOKEN }}

ui_locator_cli-0.1.0/.gitignore

@@ -0,0 +1,48 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+build/
+dist/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# uv
+uv.lock
+
+# Local secrets / environment
+.env
+.env.*
+!.env.example
+
+# Local ui-locator project (config + element map) used while developing.
+# In a real automation repo you *would* commit .ui-locator/config.toml and
+# .ui-locator/map/ -- here it is just scratch, and .env holds a live API key.
+.ui-locator/
+
+# Annotated output of --annotate, and local working screenshots
+*_test.png
+/screen.png
+
+# Tooling
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Editor / OS
+.DS_Store
+.vscode/
+.idea/
+
+# Models / data (local caches)
+weights/
+*.pt
+*.safetensors

ui_locator_cli-0.1.0/.python-version

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

ui_locator_cli-0.1.0/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 ui-locator contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.