test-uv-app4 0.1.0__tar.gz

test_uv_app4-0.1.0/.env.example

@@ -0,0 +1,17 @@
+# PyPI Publishing Tokens
+# Copy this file to .env and add your actual tokens
+# Get tokens from: https://pypi.org/manage/account/token/
+
+# PyPI Token (for main pypi.org)
+PYPI_TOKEN=
+
+# TestPyPI Token (for test.pypi.org)
+TEST_PYPI_TOKEN=
+
+# ReadTheDocs Token (optional)
+# Get from: https://readthedocs.org/accounts/tokens/
+RTD_TOKEN=
+
+# GitHub Token (optional, for gh CLI)
+# Get from: https://github.com/settings/tokens
+GITHUB_TOKEN=

test_uv_app4-0.1.0/.github/workflows/delete_workflow_runs.yml

@@ -0,0 +1,72 @@
+name: Delete old workflow runs
+on:
+  workflow_dispatch:
+    inputs:
+      days:
+        description: "Days to retain runs"
+        default: "30"
+      minimum_runs:
+        description: "Minimum runs to keep"
+        default: "6"
+      use_daily_retention:
+        description: "Enable daily retention (keep minimum runs per day instead of overall)"
+        default: "false"
+        type: choice
+        options:
+          - "false"
+          - "true"
+      delete_workflow_pattern:
+        description: "Workflow name or filename (omit for all). Use `|` to separate multiple filters (e.g. 'build|deploy')."
+      delete_workflow_by_state_pattern:
+        description: "Workflow state: active, deleted, disabled_fork, disabled_inactivity, disabled_manually"
+        default: "ALL"
+        type: choice
+        options:
+          - "ALL"
+          - active
+          - deleted
+          - disabled_inactivity
+          - disabled_manually
+      delete_run_by_conclusion_pattern:
+        description: "Run conclusion: action_required, cancelled, failure, skipped, success"
+        default: "ALL"
+        type: choice
+        options:
+          - "ALL"
+          - "Unsuccessful: action_required,cancelled,failure,skipped"
+          - action_required
+          - cancelled
+          - failure
+          - skipped
+          - success
+      dry_run:
+        description: "Simulate deletions"
+        default: "false"
+        type: choice
+        options:
+          - "false"
+          - "true"
+jobs:
+  delete-runs:
+    runs-on: ubuntu-latest
+    permissions:
+      actions: write
+      contents: read
+    steps:
+      - name: Delete workflow runs
+        uses: Mattraks/delete-workflow-runs@v2
+        with:
+          token: ${{ github.token }}
+          repository: ${{ github.repository }}
+          retain_days: ${{ github.event.inputs.days }}
+          keep_minimum_runs: ${{ github.event.inputs.minimum_runs }}
+          use_daily_retention: ${{ github.event.inputs.use_daily_retention }}
+          delete_workflow_pattern: ${{ github.event.inputs.delete_workflow_pattern }}
+          delete_workflow_by_state_pattern: ${{ github.event.inputs.delete_workflow_by_state_pattern }}
+          delete_run_by_conclusion_pattern: >-
+            ${{
+              startsWith(github.event.inputs.delete_run_by_conclusion_pattern, 'Unsuccessful:') &&
+              'action_required,cancelled,failure,skipped' ||
+              github.event.inputs.delete_run_by_conclusion_pattern
+            }}
+          dry_run: ${{ github.event.inputs.dry_run }}

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

@@ -0,0 +1,98 @@
+name: Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - '**/*.rst'
+      - '**/*.md'
+      - 'pyproject.toml'
+      - '.readthedocs.yaml'
+  pull_request:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - '**/*.rst'
+      - '**/*.md'
+      - 'pyproject.toml'
+      - '.readthedocs.yaml'
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install UV
+        uses: astral-sh/setup-uv@v5
+
+      - name: Cache UV dependencies
+        uses: actions/cache@v4
+        with:
+          path: .venv
+          key: ${{ runner.os }}-uv-${{ hashFiles('**/uv.lock', '**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-uv-
+
+      - name: Install Dependencies
+        run: |
+          uv sync --group docs
+
+      - name: Check Documentation Quality
+        run: |
+          cd docs
+          uv run doc8 . || echo "Documentation quality check found issues"
+          uv run make linkcheck || echo "Link check found broken links"
+        continue-on-error: true
+
+      - name: Build Documentation
+        run: |
+          cd docs
+          uv run make SPHINXOPTS="-v" html
+        env:
+          PYTHONPATH: ${{ github.workspace }}/src
+          SPHINX_DEBUG: 1
+
+      - name: Check Build Output
+        if: always()
+        run: |
+          echo "Checking docs build directory..."
+          cd docs/_build/html
+          ls -la
+          if [ -f "index.html" ]; then
+            echo "Documentation built successfully"
+          else
+            echo "Documentation build failed - no index.html"
+            exit 1
+          fi
+
+      - name: Upload Documentation Artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: documentation
+          path: docs/_build/html/
+          compression-level: 0
+
+      - name: Comment PR with documentation preview
+        if: github.event_name == 'pull_request' && success()
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const artifactUrl = 'https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}';
+            const body = '📚 Documentation preview is available! [Download the artifact](' + artifactUrl + ') and view locally.';
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: body
+            });

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

@@ -0,0 +1,165 @@
+name: Release
+
+on:
+  push:
+    tags: ['v*']
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+
+  tests:
+    uses: ./.github/workflows/tests.yml
+
+  release:
+    needs: tests
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install UV
+        uses: astral-sh/setup-uv@v5
+
+      - name: Cache UV dependencies
+        uses: actions/cache@v4
+        with:
+          path: .venv
+          key: ${{ runner.os }}-uv-${{ hashFiles('**/uv.lock', '**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-uv-
+
+      - name: Determine release type and latest status
+        id: release-info
+        run: |
+          TAG_NAME=${{ github.ref_name }}
+          VERSION=${TAG_NAME#v}
+
+          echo "tag_name=$TAG_NAME" >> $GITHUB_OUTPUT
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+          # Determine if this should be marked as latest
+          # Latest = stable releases (x.y.z) and post releases (x.y.z.postN)
+          if [[ $VERSION =~ ^[0-9]+\.[0-9]+\.[0-9]+(\.(post)[0-9]+)?$ ]]; then
+            echo "is_latest=true" >> $GITHUB_OUTPUT
+            echo "release_type=release" >> $GITHUB_OUTPUT
+            echo "📦 Stable release - will be marked as latest"
+          elif [[ $VERSION =~ ^[0-9]+\.[0-9]+\.[0-9]+[-\.]?(a|alpha|b|beta|rc)[0-9]*$ ]]; then
+            echo "is_latest=false" >> $GITHUB_OUTPUT
+            echo "release_type=prerelease" >> $GITHUB_OUTPUT
+            echo "🧪 Pre-release - will NOT be marked as latest"
+          elif [[ $VERSION =~ ^[0-9]+\.[0-9]+\.[0-9]+[-\.]?(dev)[0-9]*$ ]]; then
+            echo "is_latest=false" >> $GITHUB_OUTPUT
+            echo "release_type=dev" >> $GITHUB_OUTPUT
+            echo "🚧 Development release - will NOT be marked as latest"
+          else
+            echo "is_latest=false" >> $GITHUB_OUTPUT
+            echo "release_type=draft" >> $GITHUB_OUTPUT
+            echo "📝 Draft release - will NOT be marked as latest"
+          fi
+
+      - name: Extract release notes from tag
+        id: release-notes
+        run: |
+          VERSION=${{ steps.release-info.outputs.version }}
+          TAG_NAME=${{ steps.release-info.outputs.tag_name }}
+
+          echo "Extracting message from tag $TAG_NAME..."
+          git tag -l --format='%(contents)' "$TAG_NAME" > RELEASE_NOTES.md
+
+          if [ ! -s RELEASE_NOTES.md ]; then
+            echo "Warning: Could not extract tag message for $TAG_NAME"
+            echo "Creating simple release notes..."
+            echo "# Release $TAG_NAME" > RELEASE_NOTES.md
+            echo "" >> RELEASE_NOTES.md
+            echo "See CHANGELOG.md for details." >> RELEASE_NOTES.md
+          fi
+
+          echo "Release notes content:"
+          cat RELEASE_NOTES.md
+
+      - name: Build package
+        run: ./run.sh build
+
+      # Always test on TestPyPI first
+      - name: Test PyPI release
+        env:
+          TEST_PYPI_TOKEN: ${{ secrets.TEST_PYPI_TOKEN }}
+        run: ./run.sh publish:test:strict
+
+      - name: Test installation from TestPyPI
+        run: |
+          python -m venv test_env
+          source test_env/bin/activate
+          pip install --index-url https://test.pypi.org/simple/ \
+              --extra-index-url https://pypi.org/simple \
+              test-uv-app4
+          SITE_PACKAGES=$(python -c "import site; print(site.getsitepackages()[0])")
+          export PYTHONPATH="${SITE_PACKAGES}:${PYTHONPATH:-}"
+          python -c "import test_uv_app4; print('Installed version: ' + test_uv_app4.__version__)"
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          body_path: RELEASE_NOTES.md
+          # Key improvement: Control latest tag assignment
+          make_latest: ${{ steps.release-info.outputs.is_latest }}
+          prerelease: ${{ steps.release-info.outputs.release_type == 'prerelease' || steps.release-info.outputs.release_type == 'dev' }}
+          draft: ${{ steps.release-info.outputs.release_type == 'draft' }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      # Only publish stable releases to PyPI
+      - name: Publish to PyPI
+        if: steps.release-info.outputs.release_type == 'release'
+        env:
+          PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
+        run: ./run.sh publish:strict
+
+      # Update ReadTheDocs for all tagged versions
+      # Note: Set RTD default version to "stable" in project settings for best UX
+      - name: Update ReadTheDocs
+        run: |
+          TAG_NAME=${{ steps.release-info.outputs.tag_name }}
+          echo "Activating version $TAG_NAME via API..."
+          for i in 1 2 3 4 5; do
+            RESPONSE=$(curl -s -o /dev/null -w "%{http_code}" -X PATCH \
+              -H "Authorization: Token ${{ secrets.RTD_TOKEN }}" \
+              -H "Content-Type: application/json" \
+              -d '{"active": true}' \
+              "https://readthedocs.org/api/v3/projects/test-uv-app4/versions/$TAG_NAME/")
+            if [ "$RESPONSE" = "204" ]; then
+              echo "Successfully activated version $TAG_NAME"
+              break
+            fi
+            echo "Attempt $i: RTD returned HTTP $RESPONSE, retrying in 15s..."
+            sleep 15
+          done
+          if [ "$RESPONSE" != "204" ]; then
+            echo "Warning: Failed to activate $TAG_NAME after 5 attempts (last HTTP $RESPONSE)"
+          fi
+        continue-on-error: true
+
+      - name: Release Summary
+        run: |
+          echo "## 🚀 Release Summary" >> $GITHUB_STEP_SUMMARY
+          echo "- **Version**: ${{ steps.release-info.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Type**: ${{ steps.release-info.outputs.release_type }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Latest**: ${{ steps.release-info.outputs.is_latest }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **ReadTheDocs**: ✅ Updated" >> $GITHUB_STEP_SUMMARY
+          if [[ "${{ steps.release-info.outputs.release_type }}" == "release" ]]; then
+            echo "- **PyPI**: ✅ Published" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "- **PyPI**: ⏭️ Skipped (not a stable release)" >> $GITHUB_STEP_SUMMARY
+          fi

test_uv_app4-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,55 @@
+# This workflow was inspired by Eric Riddoch's "built-test-publish.yaml"
+# but has been fully re-implemented and adapted for this project.
+
+name: Tests
+
+on:
+  workflow_call:
+  workflow_dispatch:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install UV
+        uses: astral-sh/setup-uv@v5
+
+      - name: Cache UV dependencies
+        uses: actions/cache@v4
+        with:
+          path: .venv
+          key: ${{ runner.os }}-uv-${{ hashFiles('**/uv.lock', '**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-uv-
+
+      - name: Install dependencies
+        run: ./run.sh install:all
+
+      - name: Check code formatting with black
+        run: ./run.sh format:check:black
+
+      - name: Check import sorting with isort
+        run: ./run.sh format:check:isort
+
+      - name: Run type checking with mypy
+        run: ./run.sh lint:mypy
+
+      - name: Run linting with flake8
+        run: ./run.sh lint:flake8
+
+      - name: Run tests
+        run: ./run.sh tests || [ $? -eq 5 ]

test_uv_app4-0.1.0/.github/workflows/update_rtd.yml

@@ -0,0 +1,69 @@
+name: Update ReadTheDocs
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to update on ReadTheDocs'
+        required: true
+        type: string
+
+jobs:
+  update_rtd:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: List all versions on ReadTheDocs
+        run: |
+          echo "Listing all versions on ReadTheDocs..."
+          curl -s \
+            -H "Authorization: Token ${{ secrets.RTD_TOKEN }}" \
+            "https://readthedocs.org/api/v3/projects/test-uv-app4/versions/" | jq
+
+      - name: Create tag if needed
+        run: |
+          TAG="v${{ github.event.inputs.version }}"
+          if ! git tag -l | grep -q "^$TAG$"; then
+            echo "Tag $TAG doesn't exist locally. Creating it..."
+            git tag $TAG
+            git push origin $TAG
+            echo "Tag $TAG created and pushed."
+          else
+            echo "Tag $TAG already exists."
+          fi
+
+      - name: Sync versions
+        run: |
+          echo "Syncing versions with ReadTheDocs..."
+          curl -X POST \
+            -H "Authorization: Token ${{ secrets.RTD_TOKEN }}" \
+            -H "Content-Type: application/json" \
+            "https://readthedocs.org/api/v3/projects/test-uv-app4/sync/"
+
+      - name: Wait for sync to complete
+        run: sleep 20
+
+      - name: Active version
+        run: |
+          echo "Activating version v${{ github.event.inputs.version }}"
+          curl -X PATCH \
+            -H "Authorization: Token ${{ secrets.RTD_TOKEN }}" \
+            -H "Content-Type: application/json" \
+            -d '{"active": true}' \
+            "https://readthedocs.org/api/v3/projects/test-uv-app4/versions/v${{ github.event.inputs.version }}/"
+
+      - name: Trigger build
+        run: |
+          echo "Triggering build for version ${{ github.event.inputs.version }}..."
+          curl -X POST \
+            -H "Authorization: Token ${{ secrets.RTD_TOKEN }}" \
+            -H "Content-Type: application/json" \
+            "https://readthedocs.org/api/v3/projects/test-uv-app4/versions/v${{ github.event.inputs.version }}/builds/"
+
+      - name: Check build status
+        run: |
+          echo "View builds at https://readthedocs.org/projects/test-uv-app4/builds/"

test_uv_app4-0.1.0/.gitignore

@@ -0,0 +1,49 @@
+# Secrets
+.pypirc
+.env
+
+# Compiled and Cached Files
+__pycache__/
+.mypy_cache/
+.mypy_cache_test/
+.mypy_cache_diff/
+.ipynb_checkpoints/
+.pytest_cache
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+
+# Logs
+*.log
+
+# Documentation
+docs/_build/
+
+# Test and Coverage
+htmlcov/
+.coverage
+coverage.xml
+
+# VS Code
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+*.code-workspace
+
+# Claude
+.claude/*
+
+# Environment
+.venv
+env/
+venv/
+ENV/
+
+# Misc
+.DS_Store
+*.pkl
+*.pickle

test_uv_app4-0.1.0/.readthedocs.yaml

@@ -0,0 +1,10 @@
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.10"
+  commands:
+    - pip install uv
+    - uv sync --group docs
+    - uv run python -m sphinx -T -b html -d _build/doctrees -D language=en docs $READTHEDOCS_OUTPUT/html

test_uv_app4-0.1.0/.vscode/launch.json

@@ -0,0 +1,80 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Debug Prolog Files",
+            "type": "prolog",
+            "request": "launch",
+            "runtimeExecutable": "/opt/homebrew/bin/swipl",
+            "runtimeArgs": [
+                    "-s", "${file}",
+                    "-g", "start",
+                    "-t", "halt",
+                    "-q",
+                ],
+            "env": {},
+            "program": "${file}",
+            "cwd": "${fileDirname}",
+            "startupQuery": "main",
+            "stopOnEntry": true,
+            "traceCmds": {
+                "continue": ["leap", "l"],
+                "stepover": ["skip", "s"],
+                "stepinto": ["creep", "c"],
+                "stepout": ["up", "u"]
+            }
+        },
+        {
+            "name": "Run Prolog Files",
+            "type": "prolog",
+            "request": "launch",
+            "runtimeExecutable": "/opt/homebrew/bin/swipl",
+            "runtimeArgs": [
+                "-s", "${file}",
+                "-g", "main",
+                "-t", "halt",
+
+            ],
+            "env": {},
+            "program": "${file}",
+            "cwd": "${fileDirname}",
+            "stopOnEntry": false,
+            "startupQuery": "main",
+            "traceCmds": {
+                "continue": ["leap", "l"],
+                "stepover": ["skip", "s"],
+                "stepinto": ["creep", "c"],
+                "stepout": ["up", "u"]
+            }
+        },
+        {
+            "name": "Python with Prolog",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${file}",
+            "console": "integratedTerminal",
+            "justMyCode": true,
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/src:${PYTHONPATH}",
+                "DYLD_LIBRARY_PATH": "/opt/homebrew/Cellar/swi-prolog/9.2.8/lib/swipl/lib/arm64-darwin:/opt/homebrew/Cellar/swi-prolog/9.2.8/lib/Frameworks",
+                "SWI_HOME_DIR": "/opt/homebrew/Cellar/swi-prolog/9.2.8/lib/swipl"
+            },
+        },
+        {
+            "name": "Python (Regular)",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${file}",
+            "console": "integratedTerminal",
+            "justMyCode": true
+        },
+        {
+            "name": "Python Main",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${workspaceFolder}/main.py",
+            "console": "integratedTerminal",
+            "justMyCode": true
+        }
+    ]
+}