python-samples.yml

# 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.
#
# SPDX-License-Identifier: Apache-2.0

name: Python Samples

on:
  workflow_dispatch: {}

permissions:
  contents: read

concurrency:
  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

jobs:
  build-samples:
    name: Build (${{ matrix.sample }})
    runs-on: ubuntu-latest
    permissions:
      contents: read
    strategy:
      fail-fast: false
      matrix:
        sample:
          - provider-google-genai-hello
          - provider-google-genai-code-execution
          - provider-google-genai-context-caching
          - provider-google-genai-media-models-demo
          - provider-google-genai-vertexai-hello
          - provider-google-genai-vertexai-image
          - provider-anthropic-hello
          - provider-compat-oai-hello
          - provider-vertex-ai-model-garden
          - framework-prompt-demo
          - framework-format-demo
          - framework-context-demo
          - framework-middleware-demo
          - framework-dynamic-tools-demo
          - framework-tool-interrupts
          - framework-restaurant-demo
          - web-fastapi-bugbot
          - web-flask-hello
    steps:
      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5

      - name: Install uv and setup Python
        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5
        with:
          enable-cache: true
          python-version: "3.12"

      - name: Install sample dependencies
        env:
          SAMPLE_NAME: ${{ matrix.sample }}
        run: |
          cd .
          uv sync --package "$SAMPLE_NAME"

      - name: Verify sample imports
        env:
          SAMPLE_NAME: ${{ matrix.sample }}
        run: |
          cd "samples/$SAMPLE_NAME"
          uv run python -c "
          import importlib, pathlib, sys
          src = pathlib.Path('src')
          if src.is_dir():
              for pkg in src.iterdir():
                  if pkg.is_dir() and (pkg / '__init__.py').exists():
                      mod = pkg.name
                      print(f'Importing {mod}...')
                      importlib.import_module(mod)
                      print(f'  OK')
          else:
              print('No src/ directory, skipping import check')
          "

  ollama-samples:
    name: Ollama (${{ matrix.sample }})
    runs-on: ubuntu-latest
    permissions:
      contents: read
    strategy:
      fail-fast: false
      matrix:
        include:
          - sample: provider-ollama-hello
            models: "gemma3:1b"
    steps:
      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5

      - name: Install uv and setup Python
        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5
        with:
          enable-cache: true
          python-version: "3.12"

      - name: Setup Ollama with model caching
        uses: ./.github/actions/setup-ollama
        with:
          models: ${{ matrix.models }}

      - name: Install sample dependencies
        env:
          SAMPLE_NAME: ${{ matrix.sample }}
        run: |
          cd .
          uv sync --package "$SAMPLE_NAME"

      - name: Verify sample imports
        env:
          SAMPLE_NAME: ${{ matrix.sample }}
        run: |
          cd "samples/$SAMPLE_NAME"
          uv run python -c "
          import importlib, pathlib
          src = pathlib.Path('src')
          if src.is_dir():
              for pkg in src.iterdir():
                  if pkg.is_dir() and (pkg / '__init__.py').exists():
                      mod = pkg.name
                      print(f'Importing {mod}...')
                      importlib.import_module(mod)
                      print(f'  OK')
          else:
              print('No src/ directory, skipping import check')
          "