bigquery-agent-analytics 0.5.0__tar.gz → 0.5.2__tar.gz

bigquery_agent_analytics-0.5.2/.github/workflows/ci.yml

@@ -0,0 +1,127 @@
+# Copyright 2026 Google LLC
+#
+# 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.
+
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+# Least privilege: no job here needs write access to repo contents.
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  format:
+    name: Format check
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4.4.0
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+        with:
+          python-version: "3.12"
+
+      - name: Install formatting tools
+        run: pip install "pyink>=24.3.0,<26" "isort>=5.0"
+
+      - name: Run autoformat and check for changes
+        run: |
+          bash autoformat.sh
+          if ! git diff --exit-code src/ tests/ examples/ scripts/; then
+            echo ""
+            echo "::error::Code is not formatted. Run 'bash autoformat.sh' and commit the changes."
+            exit 1
+          fi
+
+      - name: Check codelab notebook is in sync with markdown source
+        run: |
+          python scripts/generate_colab_from_codelab.py --check \
+            docs/codelabs/periodic_materialization.md \
+            examples/context_graph/codelab/colab_notebook.ipynb
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-22.04
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4.4.0
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package with dev dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest --tb=short -q
+
+  configurator-browser-smoke:
+    name: Configurator browser smoke
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4.4.0
+        with:
+          persist-credentials: false
+
+      - name: Run the smoke check's own negative fixtures
+        run: bash dashboard/looker_studio/tools/browser_smoke.sh --self-test
+
+      - name: Load the configurator in headless Chrome
+        run: bash dashboard/looker_studio/tools/browser_smoke.sh
+
+  build:
+    name: Build package
+    runs-on: ubuntu-22.04
+    needs: [format, test]
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4.4.0
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build sdist and wheel
+        run: python -m build
+
+      - name: Verify package version
+        run: |
+          VERSION=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          echo "Package version: ${VERSION}"
+          ls -la dist/
+          ls dist/ | grep "${VERSION}" || (echo "Version mismatch in built artifacts" && exit 1)
+
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02  # v4
+        with:
+          name: dist
+          path: dist/

bigquery_agent_analytics-0.5.2/.github/workflows/external-access-staleness.yml

@@ -0,0 +1,88 @@
+# Copyright 2026 Google LLC
+#
+# 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.
+
+# Wall-clock half of the external-access attestation contract (#445): the
+# unit tests enforce the attestation's internal consistency but never compare
+# its dates to today, so this scheduled run is what makes the monthly manual
+# canary recur. When next_due_date has passed it opens (or bumps) a tracking
+# issue and fails, making the staleness visible without touching any
+# credentialed API.
+#
+# Split into a read job and a write job on purpose: the check job holds only
+# contents: read and installs nothing (the script is stdlib-only), and the
+# issue-writing job that receives a token downloads no packages and performs
+# no checkout — so no freshly resolved dependency ever executes in a job
+# that holds write authority.
+
+name: External access attestation staleness
+
+on:
+  schedule:
+    - cron: "0 6 * * 1"
+  workflow_dispatch:
+
+permissions: {}
+
+jobs:
+  check:
+    name: next_due_date has not passed
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: read
+    outputs:
+      overdue: ${{ steps.staleness.outputs.overdue }}
+      message: ${{ steps.staleness.outputs.message }}
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+        with:
+          persist-credentials: false
+
+      - name: Check attestation staleness
+        id: staleness
+        run: |
+          if message=$(python3 scripts/check_external_access_staleness.py 2>&1); then
+            echo "$message"
+            echo "overdue=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "$message"
+            printf 'message<<EOF\n%s\nEOF\n' "$message" >> "$GITHUB_OUTPUT"
+            echo "overdue=true" >> "$GITHUB_OUTPUT"
+          fi
+
+  report:
+    name: Open or bump the tracking issue
+    needs: check
+    if: needs.check.outputs.overdue == 'true'
+    runs-on: ubuntu-22.04
+    permissions:
+      issues: write
+    steps:
+      - name: Open or bump the tracking issue
+        env:
+          GH_TOKEN: ${{ github.token }}
+          MESSAGE: ${{ needs.check.outputs.message }}
+        run: |
+          title="External access attestation overdue (report_template.yaml)"
+          body="$MESSAGE
+
+          Protocol: dashboard/looker_studio/bindings/report_template.yaml -> external_access_verification. Context: #445."
+          existing=$(gh issue list --repo "$GITHUB_REPOSITORY" --state open \
+            --search "\"$title\" in:title" --json number --jq '.[0].number // empty')
+          if [ -n "$existing" ]; then
+            gh issue comment "$existing" --repo "$GITHUB_REPOSITORY" --body "$body"
+          else
+            gh issue create --repo "$GITHUB_REPOSITORY" --title "$title" \
+              --body "$body" --label bug
+          fi
+          exit 1

bigquery_agent_analytics-0.5.2/.gitignore

@@ -0,0 +1,42 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+*.so
+.pytest_cache/
+.venv/
+venv/
+env/
+.adk/
+uv.lock
+.env
+/.idea/
+
+# Script outputs
+scripts/reports/
+
+# Example run artifacts
+examples/*/reports/
+examples/*/trials_*/
+scripts/**/*.log
+examples/**/*.log
+# ...but keep the curated console log committed with the recorded sample run.
+!examples/skill_evolution_lab/sample_run/run.log
+
+# Local workspace metadata
+.code*/
+deploy/streaming_evaluation/.streaming_evaluation_state.json
+
+# macOS Finder metadata
+.DS_Store
+.DS_Store?
+._*
+grafana/datasource.yaml
+grafana/.local/
+
+# Service-account credentials (never commit downloaded JSON keys).
+grafana/*.json