nonebot-plugin-htmlrender 0.7.0a3__tar.gz → 0.7.1__tar.gz

nonebot_plugin_htmlrender-0.7.1/.github/workflows/auto-tag.yml

@@ -0,0 +1,89 @@
+name: Auto Tag on Release Merge
+
+on:
+  pull_request:
+    types: [closed]
+    branches: [master]
+
+concurrency:
+  group: auto-tag-master
+  cancel-in-progress: false
+
+jobs:
+  tag-and-dispatch:
+    name: Tag merged version & dispatch publish
+    # Skip fork PRs: GITHUB_TOKEN from forks is read-only and cannot push tags
+    # or dispatch workflows. Version-bump PRs must originate from same-repo branches.
+    if: >-
+      github.event.pull_request.merged == true &&
+      github.event.pull_request.head.repo.full_name == github.repository
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: write
+      actions: write
+    steps:
+      - name: Checkout master
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          ref: master
+          fetch-depth: 0
+          fetch-tags: true
+          persist-credentials: false
+
+      - name: Install the latest version of uv
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78
+        with:
+          enable-cache: true
+
+      - name: Read version from pyproject
+        id: version
+        shell: bash
+        run: |
+          VERSION=$(uv version --short)
+          TAG="v${VERSION}"
+          echo "version=${VERSION}" >> "${GITHUB_OUTPUT}"
+          echo "tag=${TAG}" >> "${GITHUB_OUTPUT}"
+          echo "Resolved: ${VERSION} -> tag ${TAG}"
+
+      - name: Check if tag already exists
+        id: check
+        shell: bash
+        env:
+          TAG: ${{ steps.version.outputs.tag }}
+        run: |
+          if git rev-parse -q --verify "refs/tags/${TAG}" >/dev/null; then
+            echo "exists=true" >> "${GITHUB_OUTPUT}"
+            echo "Tag ${TAG} already exists; skipping."
+          else
+            echo "exists=false" >> "${GITHUB_OUTPUT}"
+          fi
+
+      - name: Create and push tag
+        if: steps.check.outputs.exists == 'false'
+        shell: bash
+        env:
+          TAG: ${{ steps.version.outputs.tag }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
+          PR_TITLE: ${{ github.event.pull_request.title }}
+          MERGE_SHA: ${{ github.event.pull_request.merge_commit_sha }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git remote set-url origin "https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git"
+          git tag -a "${TAG}" -m "Release ${TAG} (#${PR_NUMBER}: ${PR_TITLE})" -m "Merge commit: ${MERGE_SHA}"
+          git push origin "${TAG}"
+          echo "Pushed tag: ${TAG}"
+
+      - name: Dispatch publish workflow
+        if: steps.check.outputs.exists == 'false'
+        shell: bash
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAG: ${{ steps.version.outputs.tag }}
+        run: |
+          gh workflow run publish.yml \
+            --ref master \
+            -f release_tag="${TAG}"
+          echo "Dispatched publish.yml with release_tag=${TAG}"

nonebot_plugin_htmlrender-0.7.1/.github/workflows/ci.yml

@@ -0,0 +1,245 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+  workflow_dispatch:
+    inputs:
+      debug_enabled:
+        description: Enable extra debug diagnostics
+        required: false
+        default: false
+        type: boolean
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  ruff:
+    name: Ruff
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          persist-credentials: false
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78
+        with:
+          python-version: "3.12"
+          enable-cache: true
+          cache-suffix: lint-type-${{ github.event_name }}
+
+      - name: Show Runner Context
+        run: |
+          echo "Runner: $RUNNER_NAME ($RUNNER_OS/$RUNNER_ARCH)"
+          python --version
+          uv --version
+
+      - name: Sync deps
+        run: uv sync --locked --all-extras --all-groups
+
+      - name: Ruff
+        run: uv run ruff check .
+
+  ty:
+    name: Ty
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          persist-credentials: false
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78
+        with:
+          python-version: "3.12"
+          enable-cache: true
+          cache-suffix: ty-${{ github.event_name }}
+
+      - name: Sync deps
+        run: uv sync --locked --all-extras --all-groups
+
+      - name: Ty
+        run: uv run ty check
+
+  basedpyright:
+    name: Basedpyright
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          persist-credentials: false
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78
+        with:
+          python-version: "3.12"
+          enable-cache: true
+          cache-suffix: basedpyright-${{ github.event_name }}
+
+      - name: Sync deps
+        run: uv sync --locked --all-extras --all-groups
+
+      - name: Basedpyright
+        run: uv run basedpyright .
+
+  package:
+    name: Package Build
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    env:
+      BUILD_LOG: package-build.log
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          persist-credentials: false
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78
+        with:
+          python-version: "3.12"
+          enable-cache: true
+          cache-suffix: package-${{ github.event_name }}
+
+      - name: Build distributions
+        run: |
+          set -o pipefail
+          uv build 2>&1 | tee "${BUILD_LOG}"
+
+      - name: Validate distributions
+        run: uv run --no-project --with twine twine check dist/*
+
+      - name: Show built distributions
+        run: |
+          ls -la dist
+          sha256sum dist/* || true
+
+      - name: Upload built distributions
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
+        with:
+          name: package-dist
+          path: dist/
+          if-no-files-found: error
+          retention-days: 14
+
+      - name: Upload build logs
+        if: ${{ always() }}
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
+        with:
+          name: package-build-logs
+          path: ${{ env.BUILD_LOG }}
+          if-no-files-found: warn
+          retention-days: 14
+
+  remote-browser-render:
+    name: Remote Browser Render Smoke (Docker)
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    env:
+      RENDER_IMAGE: htmlrender-remote-test:ci
+      PLAYWRIGHT_IMAGE: htmlrender-playwright:ci
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          persist-credentials: false
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@e468171a9de216ec08956ac3ada2f0791b6bd435
+
+      - name: Build remote smoke render image
+        uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83
+        with:
+          context: .
+          file: tests/infra/dockerfile.remote-test
+          load: true
+          tags: ${{ env.RENDER_IMAGE }}
+          cache-from: type=gha,scope=remote-smoke
+          cache-to: type=gha,scope=remote-smoke,mode=max
+          build-args: |
+            PYTHON_BASE_IMAGE=python:3.12-bookworm
+
+      - name: Resolve Playwright version
+        id: playwright-version
+        shell: bash
+        run: |
+          PLAYWRIGHT_VERSION=$(python3 - <<'PY'
+          from pathlib import Path
+
+          try:
+              import tomllib
+          except ModuleNotFoundError:
+              tomllib = None
+
+
+          def parse_package_version(text, package_name):
+              if tomllib is not None:
+                  lock = tomllib.loads(text)
+                  for package in lock["package"]:
+                      if package["name"] == package_name:
+                          return package["version"]
+                  return None
+
+              current_name = None
+              for line in text.splitlines():
+                  stripped = line.strip()
+                  if stripped == "[[package]]":
+                      current_name = None
+                      continue
+                  if stripped.startswith("name = "):
+                      current_name = stripped.split('"', 2)[1]
+                      continue
+                  if current_name == package_name and stripped.startswith("version = "):
+                      return stripped.split('"', 2)[1]
+              return None
+
+
+          version = parse_package_version(Path("uv.lock").read_text(), "playwright")
+          if version is None:
+              raise SystemExit("playwright package not found in uv.lock")
+          print(version)
+          PY
+          )
+          echo "version=${PLAYWRIGHT_VERSION}" >> "${GITHUB_OUTPUT}"
+          echo "Resolved Playwright version: ${PLAYWRIGHT_VERSION}"
+
+      - name: Build playwright server image
+        uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83
+        with:
+          context: .
+          file: tests/infra/dockerfile.playwright-server
+          load: true
+          tags: ${{ env.PLAYWRIGHT_IMAGE }}
+          cache-from: type=gha,scope=playwright-server
+          cache-to: type=gha,scope=playwright-server,mode=max
+          build-args: |
+            PLAYWRIGHT_VERSION=${{ steps.playwright-version.outputs.version }}
+
+      - name: Build and run remote smoke
+        run: docker compose -f tests/infra/docker-compose.remote-test.yaml up --abort-on-container-exit --exit-code-from render
+
+      - name: Capture compose logs
+        if: ${{ always() }}
+        run: docker compose -f tests/infra/docker-compose.remote-test.yaml logs > remote-smoke-compose.log
+
+      - name: Upload remote smoke logs
+        if: ${{ always() }}
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
+        with:
+          name: remote-smoke-compose-logs
+          path: remote-smoke-compose.log
+          if-no-files-found: warn
+          retention-days: 14
+
+      - name: Teardown compose
+        if: always()
+        run: docker compose -f tests/infra/docker-compose.remote-test.yaml down -v

nonebot_plugin_htmlrender-0.7.1/.github/workflows/coverage.yml

@@ -0,0 +1,113 @@
+name: Coverage
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+  workflow_dispatch:
+    inputs:
+      debug_enabled:
+        description: Enable extra debug diagnostics
+        required: false
+        default: false
+        type: boolean
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  coverage:
+    name: Coverage (py${{ matrix.python-version }}-${{ matrix.target.arch }})
+    runs-on: ${{ matrix.target.runs-on }}
+    timeout-minutes: 45
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        target:
+          - runs-on: ubuntu-latest
+            arch: x64
+          - runs-on: ubuntu-24.04-arm
+            arch: arm64
+
+    env:
+      HTMLRENDER_TEST_PROFILE: ci
+      ARCH: ${{ matrix.target.arch }}
+      PYTHON_VERSION: ${{ matrix.python-version }}
+      COVERAGE_XML: coverage-py${{ matrix.python-version }}-${{ matrix.target.arch }}.xml
+      PYTEST_LOG: pytest-py${{ matrix.python-version }}-${{ matrix.target.arch }}.log
+
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          persist-credentials: false
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+          cache-suffix: coverage-py${{ matrix.python-version }}-${{ matrix.target.arch }}-${{ github.event_name }}
+
+      - name: Show Runner Context
+        run: |
+          echo "Event: ${{ github.event_name }}"
+          echo "Runner: $RUNNER_NAME ($RUNNER_OS/$RUNNER_ARCH)"
+          echo "Python: $PYTHON_VERSION, ARCH: $ARCH"
+          uname -a
+          df -h
+          python --version
+          uv --version
+          if command -v lscpu >/dev/null 2>&1; then lscpu; fi
+
+      - name: Sync deps
+        run: uv sync --locked --all-extras --all-groups
+
+      - name: Show Dependency Snapshot
+        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }}
+        run: |
+          uv pip list
+          uv tree
+
+      - name: Run tests with coverage
+        run: |
+          set -o pipefail
+          uv run pytest tests \
+            --cov=nonebot_plugin_htmlrender \
+            --cov-report=term-missing \
+            --cov-report=xml:${COVERAGE_XML} \
+            -ra 2>&1 | tee "${PYTEST_LOG}"
+
+      - name: Show Failure Diagnostics
+        if: ${{ failure() }}
+        run: |
+          echo "==== Last 200 lines of pytest log ===="
+          tail -n 200 "${PYTEST_LOG}" || true
+          echo "==== Environment ===="
+          env | sort
+          echo "==== Workspace files ===="
+          ls -la
+
+      - name: Upload Coverage + Pytest Logs
+        if: ${{ always() }}
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
+        with:
+          name: coverage-debug-py${{ matrix.python-version }}-${{ matrix.target.arch }}
+          path: |
+            ${{ env.COVERAGE_XML }}
+            ${{ env.PYTEST_LOG }}
+          if-no-files-found: warn
+          retention-days: 14
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@671740ac38dd9b0130fbe1cec585b89eea48d3de
+        with:
+          files: ./${{ env.COVERAGE_XML }}
+          flags: py${{ matrix.python-version }}-${{ matrix.target.arch }}
+          env_vars: ARCH,PYTHON_VERSION
+          verbose: true

nonebot_plugin_htmlrender-0.7.1/.github/workflows/docs-pr-preview.yml

@@ -0,0 +1,60 @@
+name: Docs PR Preview
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, closed]
+    paths:
+      - docs/**
+      - mkdocs.yml
+      - README.md
+      - .github/workflows/docs-pr-preview.yml
+
+concurrency:
+  group: docs-pr-preview-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  preview:
+    name: Deploy / cleanup PR docs preview
+    # Skip PRs from forks: GITHUB_TOKEN from forks lacks write access to gh-pages.
+    if: github.event.pull_request.head.repo.full_name == github.repository
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          persist-credentials: false
+
+      - name: Set up uv
+        if: github.event.action != 'closed'
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78
+        with:
+          python-version: "3.12"
+          enable-cache: true
+          cache-suffix: docs-${{ github.event_name }}
+
+      - name: Show Runner Context
+        if: github.event.action != 'closed'
+        run: |
+          echo "Runner: $RUNNER_NAME ($RUNNER_OS/$RUNNER_ARCH)"
+          python --version
+          uv --version
+
+      - name: Sync docs deps
+        if: github.event.action != 'closed'
+        run: uv sync --locked --group docs
+
+      - name: Build docs
+        if: github.event.action != 'closed'
+        run: uv run zensical build --strict
+
+      - name: Deploy / cleanup preview
+        uses: rossjrw/pr-preview-action@2fb559e4766555e23d07b73d313fe97c4f8c3cfe
+        with:
+          source-dir: site/
+          preview-branch: gh-pages
+          umbrella-dir: pr-preview
+          action: auto

nonebot_plugin_htmlrender-0.7.1/.github/workflows/docs.yml

@@ -0,0 +1,105 @@
+name: Docs
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - docs/**
+      - mkdocs.yml
+      - README.md
+      - .github/workflows/docs.yml
+  workflow_dispatch:
+    inputs:
+      debug_enabled:
+        description: Enable extra debug diagnostics
+        required: false
+        default: false
+        type: boolean
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    name: Build & Deploy Docs
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    env:
+      DOCS_LOG: docs-build.log
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78
+        with:
+          python-version: "3.12"
+          enable-cache: true
+          cache-suffix: docs-${{ github.event_name }}
+
+      - name: Show Runner Context
+        run: |
+          echo "Runner: $RUNNER_NAME ($RUNNER_OS/$RUNNER_ARCH)"
+          python --version
+          uv --version
+
+      - name: Sync docs deps
+        run: uv sync --locked --group docs
+
+      - name: Debug Dependency Snapshot
+        if: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.debug_enabled == 'true' }}
+        run: |
+          uv pip list
+          uv tree
+
+      - name: Build docs
+        run: |
+          set -o pipefail
+          uv run zensical build --strict 2>&1 | tee "${DOCS_LOG}"
+
+      - name: Upload docs build logs
+        if: ${{ always() }}
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
+        with:
+          name: docs-build-logs
+          path: ${{ env.DOCS_LOG }}
+          if-no-files-found: warn
+          retention-days: 14
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: Configure authenticated origin
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          git remote set-url origin "https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git"
+
+      - name: Get project version
+        id: version
+        run: |
+          VERSION=$(uv version --short)
+          echo "version=${VERSION}" >> "${GITHUB_OUTPUT}"
+
+      - name: Deploy versioned docs
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          uv run mike deploy --push --update-aliases "${VERSION}" latest
+
+      - name: Set default version
+        run: |
+          uv run mike set-default --push latest
+
+      - name: Show docs url
+        env:
+          DOCS_OWNER: ${{ github.repository_owner }}
+          DOCS_REPO: ${{ github.event.repository.name }}
+          VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          echo "Docs deployed: https://${DOCS_OWNER}.github.io/${DOCS_REPO}/${VERSION}/"

nonebot_plugin_htmlrender-0.7.1/.github/workflows/prek.yml

@@ -0,0 +1,28 @@
+name: Prek
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  prek:
+    name: Prek
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+        with:
+          persist-credentials: false
+
+      - name: Run pre-commit hooks via prek
+        uses: j178/prek-action@6ad80277337ad479fe43bd70701c3f7f8aa74db3