Add some workflow/actions

with a very simple python test

Author: angaither

.github/actions/python-build-env-setup/action.yml

@@ -0,0 +1,50 @@
+name: 'Common Python job setup'
+description: 'Perform build environment setup steps common to all Python jobs.'
+
+inputs:
+  python-version:
+    description: 'Python version to use'
+    required: true
+    default: "3.13"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Fetch git tags
+      shell: bash
+      run: |
+        git fetch --tags origin
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ inputs.python-version }}
+        allow-prereleases: true
+
+    - name: Install uv and set the python version
+      uses: astral-sh/setup-uv@v6
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Install the project
+      shell: bash
+      run: |
+       uv sync --locked --all-extras --dev
+
+    - name: Pip cache
+      uses: actions/cache@v4
+      with:
+        path: ~/.cache/pip
+        key: ${{ runner.os }}-pip
+        restore-keys: |
+          ${{ runner.os }}-pip
+
+    - name: "Install tools : nox"
+      shell: bash
+      run: |
+        pip install --upgrade nox
+
+    - name: "Build Environment"
+      shell: bash
+      run: |
+        printenv | sort

.github/workflows/tests.yml

@@ -0,0 +1,47 @@
+name: Tests
+
+on:
+  pull_request:
+  push:
+  workflow_dispatch:
+  workflow_call:
+
+jobs:
+  lint:
+    name: Linting
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Prepare common Python build environment
+        uses: ./.github/actions/python-build-env-setup
+      - name: 'Nox: Python Black'
+        run: |
+          nox -s lint
+
+  test:
+    name: Test Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12', '3.13']
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+        allow-prereleases: true
+    - name: Pip cache
+      uses: actions/cache@v4
+      with:
+        path: ~/.cache/pip
+        key: ${{ runner.os }}-pip
+        restore-keys: |
+          ${{ runner.os }}-pip
+    - name: Test
+      run: |
+        pip install --upgrade nox
+        nox -s test-${{ matrix.python-version }}

noxfile.py

@@ -0,0 +1,29 @@
+import nox
+
+nox.options.stop_on_first_error = True
+nox.options.reuse_existing_virtualenvs = False
+
+# Default sessions - all tests, but not packaging
+nox.options.sessions = [
+    "lint",
+    "test",
+]
+
+_DEFAULT_PYTHON = "3.13"
+_ALL_PYTHON = ["3.11", "3.12", "3.13"]
+
+
+@nox.session(python=_ALL_PYTHON)
+def test(session):
+    """Run Pytest test suites"""
+    session.run("python", "-m", "ensurepip", "--upgrade")
+    session.install("-e", ".[test]")
+    session.run("uv", "run", "pytest", "-vv", "tests")
+
+
+@nox.session(python=_DEFAULT_PYTHON)
+def lint(session):
+    """Check code formatting with Black"""
+    session.install("-e", ".[dev]")
+    session.run("black", "--verbose", "--check", "--diff", "--color", ".")
+    session.run("ruff", "--verbose", "check", ".")

tests/__init__.py

@@ -0,0 +1,22 @@
+import pytest
+from fastmcp import FastMCP, Client
+
+
+@pytest.fixture
+def test_server():
+    mcp = FastMCP("Planet MCP Test Server")
+
+    ## a very simple "search" test
+    @mcp.tool
+    def search(item_type: str) -> dict:
+        items = {"PSScene": 123, "SkySat": 456, "Tanager": 789}
+        return {"item_type": item_type, "temp": items.get(item_type)}
+
+    return mcp
+
+
+@pytest.mark.asyncio
+async def test_search_tool(test_server):
+    async with Client(test_server) as client:
+        result = await client.call_tool("search", {"item_type": "SkySat"})
+        assert result.data == {"item_type": "SkySat", "temp": 456}