Main

.env.example

@@ -0,0 +1,6 @@
+# Copy to .env and fill in. .env is gitignored.
+TCAPTCHA_BASE_URL=https://t.captcha.qq.com
+TCAPTCHA_LLM_API_KEY=sk-your-relay-key-here
+TCAPTCHA_LLM_BASE_URL=https://your-relay.example.com
+TCAPTCHA_LLM_MODEL=gpt-5.4
+TCAPTCHA_LLM_TIMEOUT=30

.github/actions/setup-python-env/action.yml

@@ -0,0 +1,40 @@
+name: "Setup Python Environment"
+description: "Set up Python + uv and sync project dependencies"
+
+inputs:
+  python-version:
+    description: "Python version to use"
+    required: true
+    default: "3.12"
+  uv-version:
+    description: "uv version to use"
+    required: true
+    default: "0.5.11"
+  extras:
+    description: "Comma-separated extras to install (e.g. 'dev,icon-click')"
+    required: false
+    default: "dev"
+
+runs:
+  using: "composite"
+  steps:
+    - uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
+      with:
+        version: ${{ inputs.uv-version }}
+        enable-cache: 'true'
+        cache-suffix: ${{ inputs.python-version }}
+
+    - name: Install Python dependencies
+      shell: bash
+      run: |
+        EXTRA_FLAGS=""
+        IFS=',' read -ra EXTRAS <<< "${{ inputs.extras }}"
+        for e in "${EXTRAS[@]}"; do
+          [ -n "$e" ] && EXTRA_FLAGS="$EXTRA_FLAGS --extra $e"
+        done
+        uv sync --frozen $EXTRA_FLAGS

.github/workflows/main.yml

@@ -0,0 +1,64 @@
+name: Main
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up the environment
+        uses: ./.github/actions/setup-python-env
+
+      - name: Ruff lint
+        run: uv run ruff check .
+
+      - name: Ruff format check
+        run: uv run ruff format --check .
+
+  tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+      fail-fast: false
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up the environment
+        uses: ./.github/actions/setup-python-env
+        with:
+          python-version: ${{ matrix.python-version }}
+          extras: "dev,icon-click"
+
+      - name: Run tests (skip network)
+        run: uv run pytest tests -m "not network"
+
+  build-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up the environment
+        uses: ./.github/actions/setup-python-env
+
+      - name: Build sdist + wheel
+        run: uv build
+
+      - name: Check distribution metadata
+        run: |
+          uv run --with twine twine check dist/*
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ github.sha }}
+          path: dist/
+          retention-days: 7

.github/workflows/on-release-main.yml

@@ -0,0 +1,80 @@
+name: release-main
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  set-version:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Export tag
+        id: vars
+        # Strip leading "v" if present (so v1.2.3 -> 1.2.3)
+        run: |
+          TAG=${GITHUB_REF#refs/tags/}
+          TAG=${TAG#v}
+          echo "tag=$TAG" >> $GITHUB_OUTPUT
+
+      - name: Update project version in pyproject.toml
+        env:
+          RELEASE_VERSION: ${{ steps.vars.outputs.tag }}
+        run: |
+          sed -i "s/^version = \".*\"/version = \"$RELEASE_VERSION\"/" pyproject.toml
+          grep '^version' pyproject.toml
+
+      - name: Upload updated pyproject.toml
+        uses: actions/upload-artifact@v4
+        with:
+          name: pyproject-toml
+          path: pyproject.toml
+
+  publish:
+    runs-on: ubuntu-latest
+    needs: [set-version]
+    # Trusted Publishing via OIDC — no PyPI token needed.
+    permissions:
+      id-token: write
+      contents: read
+    environment:
+      name: pypi
+      url: https://pypi.org/p/crack-tcaptcha
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up the environment
+        uses: ./.github/actions/setup-python-env
+
+      - name: Download updated pyproject.toml
+        uses: actions/download-artifact@v4
+        with:
+          name: pyproject-toml
+
+      - name: Build package
+        run: uv build
+
+      - name: Verify dist
+        run: uv run --with twine twine check dist/*
+
+      - name: Publish to PyPI
+        run: uv publish --trusted-publishing always
+
+  deploy-docs:
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up the environment
+        uses: ./.github/actions/setup-python-env
+        with:
+          extras: "dev,docs"
+
+      - name: Deploy MkDocs to gh-pages
+        run: uv run mkdocs gh-deploy --force

.gitignore

@@ -12,7 +12,6 @@ node_modules
 site
 *.so
 *.whl
-uv.lock
 .env
 *.onnx
 origin_papers/