algorand-python-testing 1.2.0b11__tar.gz → 1.2.0b13__tar.gz

algorand_python_testing-1.2.0b13/.github/actions/build-documentation/action.yml

@@ -0,0 +1,48 @@
+name: "Build Documentation"
+description: "Build Astro Starlight documentation using hatch"
+inputs:
+  node-version:
+    description: "Node.js version"
+    required: false
+    default: "22.x"
+  upload-pages-artifact:
+    description: "Upload docs/dist as a GitHub Pages artifact"
+    required: false
+    default: "true"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Set up Python 3.12
+      uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+      with:
+        python-version: "3.12"
+        cache: "pip"
+
+    - name: Install hatch
+      shell: bash
+      run: pip install hatch
+
+    - name: Setup Node.js
+      uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+      with:
+        node-version: ${{ inputs.node-version }}
+
+    - name: Setup pnpm
+      uses: pnpm/action-setup@0e279bb959325dab635dd2c09392533439d90093 # v6
+      with:
+        package_json_file: docs/package.json
+
+    - name: Install docs dependencies
+      shell: bash
+      run: pnpm install --frozen-lockfile --dir docs
+
+    - name: Build docs
+      shell: bash
+      run: hatch run docs:build
+
+    - name: Upload Pages artifact
+      if: inputs.upload-pages-artifact == 'true'
+      uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5
+      with:
+        path: docs/dist

{algorand_python_testing-1.2.0b11 → algorand_python_testing-1.2.0b13}/.github/workflows/cd.yaml

@@ -26,8 +26,7 @@ on:
 concurrency: release
 
 permissions:
-  contents: write
-  packages: read
+  contents: read
 
 jobs:
   release:
@@ -42,16 +41,46 @@ jobs:
       DRY_RUN: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.dry_run == 'true' && '--noop' || '' }}
       PRERELEASE: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.prerelease || 'true' }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3
+        id: app-token
+        with:
+          app-id: ${{ secrets.BOT_ID }}
+          private-key: ${{ secrets.BOT_SK }}
+
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
         with:
           fetch-depth: 0
-          token: ${{ secrets.GITHUB_TOKEN }}
+          token: ${{ steps.app-token.outputs.token }}
+
+      - name: Verify production puyapy and algorand-python dependencies
+        if: ${{ env.PRERELEASE == 'false' }}
+        run: |
+          set -euo pipefail
+          deps=$(grep -oE '"(puyapy|algorand-python)[><=!~@ ][^"]*"' pyproject.toml | tr -d '"' || true)
+          if [ -z "$deps" ]; then
+            echo "ERROR: No puyapy or algorand-python dependency found in pyproject.toml"
+            exit 1
+          fi
+          echo "Found dependencies:"
+          echo "$deps"
+          echo ""
+          failed=0
+          while IFS= read -r dep; do
+            version=$(echo "$dep" | sed -E 's/^(puyapy|algorand-python)[><=!~@ ]*//')
+            if [[ "$version" =~ ^[0-9]+\.?[0-9]*\.?[0-9]*$ ]]; then
+              echo "OK: $dep"
+            else
+              echo "ERROR: '$dep' uses non-production version ('$version')"
+              failed=1
+            fi
+          done <<< "$deps"
+          exit $failed
 
       - name: Install hatch
         run: pipx install hatch
 
       - name: Set up Python 3.12
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
         with:
           python-version: "3.12"
           cache: "pip"
@@ -77,18 +106,18 @@ jobs:
       - name: Python Semantic Release
         id: semantic-release
         if: ${{ github.ref == 'refs/heads/main' }}
-        uses: python-semantic-release/python-semantic-release@master
+        uses: python-semantic-release/python-semantic-release@350c48fcb3ffcdfd2e0a235206bc2ecea6b69df0 # v10.5.3
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
+          github_token: ${{ steps.app-token.outputs.token }}
           prerelease: ${{ env.PRERELEASE == 'true' }}
           root_options: $DRY_RUN
 
       - name: Publish to PyPI
         if: ${{ !inputs.dry_run && steps.semantic-release.outputs.released == 'true' }}
-        uses: pypa/gh-action-pypi-publish@release/v1
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0
         with:
           packages-dir: dist
 
-      - uses: actions/upload-artifact@v4 # upload artifacts so they are retained on the job
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         with:
           path: dist

{algorand_python_testing-1.2.0b11 → algorand_python_testing-1.2.0b13}/.github/workflows/ci.yaml

@@ -6,15 +6,18 @@ on:
   schedule:
     - cron: "0 8 * * 1" # Each monday 8 AM UTC
 
+permissions:
+  contents: read
+
 jobs:
   check-python:
     runs-on: "ubuntu-latest"
     steps:
       - name: Checkout source code
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Set up Python 3.12
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
         with:
           python-version: "3.12"
           cache: "pip"
@@ -22,6 +25,19 @@ jobs:
       - name: Install hatch
         run: pip install hatch
 
+      - name: Setup Node.js
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+        with:
+          node-version: "22.x"
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@0e279bb959325dab635dd2c09392533439d90093 # v6
+        with:
+          package_json_file: docs/package.json
+
+      - name: Install docs dependencies
+        run: pnpm install --frozen-lockfile --dir docs
+
       - name: Start LocalNet
         run: pipx install algokit && algokit localnet start
 
@@ -37,8 +53,11 @@ jobs:
       - name: Check wheels can be built
         run: hatch build
 
+      - name: Build docs
+        run: hatch run docs:build
+
       - name: Check doctests
-        run: hatch run docs:test
+        run: hatch run test:docs
 
   test-python-matrix:
     runs-on: "ubuntu-latest"
@@ -47,10 +66,10 @@ jobs:
         python-version: ["3.12", "3.13"]
     steps:
       - name: Checkout source code
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
         with:
           python-version: ${{ matrix.python-version }}
           cache: "pip"
@@ -68,7 +87,7 @@ jobs:
         run: hatch run examples.py${{ matrix.python-version }}:tests
 
       - name: Upload coverage artifacts
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: ${{ matrix.python-version == '3.13' }}
         with:
           name: coverage-reports

algorand_python_testing-1.2.0b13/.github/workflows/gh-pages.yaml

@@ -0,0 +1,28 @@
+name: Publish docs to GitHub Pages
+
+on:
+  workflow_call:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-publish-docs:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    steps:
+      - name: Checkout source code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Build and upload docs artifact
+        uses: ./.github/actions/build-documentation
+        with:
+          node-version: 22.x
+          upload-pages-artifact: 'true'
+
+      - name: Deploy to GitHub Pages
+        uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5

algorand_python_testing-1.2.0b13/.github/workflows/publish-devportal-docs.yml

@@ -0,0 +1,40 @@
+name: Publish DevPortal Docs
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    tags: ['v*']
+
+permissions:
+  contents: write
+
+jobs:
+  publish-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
+        with:
+          node-version: 24.x
+
+      - uses: pnpm/action-setup@0e279bb959325dab635dd2c09392533439d90093 # v6
+        with:
+          package_json_file: docs/package.json
+
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+        with:
+          python-version: '3.12'
+          cache: pip
+
+      - name: Install hatch
+        run: pip install hatch
+
+      - name: Generate API docs
+        run: hatch run docs:api
+
+      - name: Publish DevPortal Docs
+        uses: algorandfoundation/devportal/.github/actions/publish-devportal-docs@release/ak-v4
+        with:
+          docs-dir: docs

{algorand_python_testing-1.2.0b11 → algorand_python_testing-1.2.0b13}/.gitignore

@@ -18,3 +18,6 @@ coverage.xml
 
 .cursorignore
 *.puya.map
+
+# AI Agents
+.codex

{algorand_python_testing-1.2.0b11 → algorand_python_testing-1.2.0b13}/CHANGELOG.md

@@ -1,4 +1,38 @@
 # CHANGELOG
+## v1.2.0-beta.13 (2026-05-28)
+
+### Features
+
+* bootstrap starlight docs workspace and shared styling ([`f3a03d8`](https://github.com/algorandfoundation/algorand-python-testing/commit/f3a03d8f93c62cd9544e9044e5786e9bce2449c1))
+
+* replace sphinx build flow with api bridge and legacy redirects ([`f3a03d8`](https://github.com/algorandfoundation/algorand-python-testing/commit/f3a03d8f93c62cd9544e9044e5786e9bce2449c1))
+
+### Documentation
+
+* starlight docs ([`f3a03d8`](https://github.com/algorandfoundation/algorand-python-testing/commit/f3a03d8f93c62cd9544e9044e5786e9bce2449c1))
+
+* migrate top-level documentation pages to starlight ([`f3a03d8`](https://github.com/algorandfoundation/algorand-python-testing/commit/f3a03d8f93c62cd9544e9044e5786e9bce2449c1))
+
+* migrate testing guide pages and assets to starlight ([`f3a03d8`](https://github.com/algorandfoundation/algorand-python-testing/commit/f3a03d8f93c62cd9544e9044e5786e9bce2449c1))
+
+* restructure starlight docs with new concepts, quick-start and api build improvements ([`f3a03d8`](https://github.com/algorandfoundation/algorand-python-testing/commit/f3a03d8f93c62cd9544e9044e5786e9bce2449c1))
+
+* replace process.stdout with console.log in generate-examples-mdx script ([`f3a03d8`](https://github.com/algorandfoundation/algorand-python-testing/commit/f3a03d8f93c62cd9544e9044e5786e9bce2449c1))
+
+* replace process.stdout with console.log in generate-legacy-redirects.mjs script ([`f3a03d8`](https://github.com/algorandfoundation/algorand-python-testing/commit/f3a03d8f93c62cd9544e9044e5786e9bce2449c1))
+
+* restore mermaid diagrams and render them using astro-mermaid ([`f3a03d8`](https://github.com/algorandfoundation/algorand-python-testing/commit/f3a03d8f93c62cd9544e9044e5786e9bce2449c1))
+
+* restore doctest with pytest-markdown-docs and wirte into ci ([`f3a03d8`](https://github.com/algorandfoundation/algorand-python-testing/commit/f3a03d8f93c62cd9544e9044e5786e9bce2449c1))
+
+* add parentheses to @pytest.fixture decorator in conftest ([`f3a03d8`](https://github.com/algorandfoundation/algorand-python-testing/commit/f3a03d8f93c62cd9544e9044e5786e9bce2449c1))
+
+## v1.2.0-beta.12 (2026-05-13)
+
+### Features
+
+* check if depending on production release of puyapy, fail prod release otherwise ([`0632a78`](https://github.com/algorandfoundation/algorand-python-testing/commit/0632a78b5c49c8459bcba41bc58f25feac6ad613))
+
 ## v1.2.0-beta.11 (2026-04-14)
 
 ## v1.2.0-beta.10 (2026-04-14)

{algorand_python_testing-1.2.0b11 → algorand_python_testing-1.2.0b13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: algorand-python-testing
-Version: 1.2.0b11
+Version: 1.2.0b13
 Summary: Algorand Python testing library
 Project-URL: Documentation, https://github.com/algorandfoundation/puya/tree/main/algopy_testing#README.md
 Project-URL: Issues, https://github.com/algorandfoundation/puya/issues
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Testing
 Requires-Python: >=3.12
-Requires-Dist: algokit-utils>=5.0.0b1
+Requires-Dist: algokit-utils>=5.0.0b3
 Requires-Dist: algorand-python>=3
 Requires-Dist: coincurve>=19.0.1
 Requires-Dist: ecdsa>=0.17.0

algorand_python_testing-1.2.0b13/docs/.gitignore

@@ -0,0 +1,5 @@
+.astro/
+dist/
+node_modules/
+src/content/docs/api/
+src/content/docs/examples/