Merge branch 'main' into make-fastapi-package-optional

Author: holtskinner

.github/actions/spelling/excludes.txt

@@ -88,3 +88,4 @@
 CHANGELOG.md
 noxfile.py
 ^src/a2a/grpc/
+.pre-commit-config.yaml

.pre-commit-config.yaml

@@ -0,0 +1,62 @@
+---
+repos:
+  # ===============================================
+  # Pre-commit standard hooks (general file cleanup)
+  # ===============================================
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace  # Removes extra whitespace at the end of lines
+      - id: end-of-file-fixer  # Ensures files end with a newline
+      - id: check-yaml  # Checks YAML file syntax (before formatting)
+      - id: check-toml  # Checks TOML file syntax (before formatting)
+      - id: check-added-large-files  # Prevents committing large files
+        args: [--maxkb=500]  # Example: Limit to 500KB
+      - id: check-merge-conflict  # Checks for merge conflict strings
+      - id: detect-private-key  # Detects accidental private key commits
+
+  # Formatter and linter for TOML files
+  - repo: https://github.com/ComPWA/taplo-pre-commit
+    rev: v0.9.3
+    hooks:
+      - id: taplo-format
+      - id: taplo-lint
+
+  # YAML files
+  - repo: https://github.com/lyz-code/yamlfix
+    rev: 1.16.1
+    hooks:
+      - id: yamlfix
+
+  # ===============================================
+  # Python Hooks
+  # ===============================================
+  # no_implicit_optional for ensuring explicit Optional types
+  - repo: https://github.com/hauntsaninja/no_implicit_optional
+    rev: '1.4'
+    hooks:
+      - id: no_implicit_optional
+        args: [--use-union-or]
+
+  # Pyupgrade for upgrading Python syntax to newer versions
+  - repo: https://github.com/asottile/pyupgrade
+    rev: v3.20.0
+    hooks:
+      - id: pyupgrade
+        args: [--py310-plus]  # Target Python 3.10+ syntax, matching project's target
+
+  # Autoflake for removing unused imports and variables
+  - repo: https://github.com/pycqa/autoflake
+    rev: v2.3.1
+    hooks:
+      - id: autoflake
+        args: [--in-place, --remove-all-unused-imports]
+
+  # Ruff for linting and formatting
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.0
+    hooks:
+      - id: ruff  # Linter: applies auto-fixable linting rules
+        args: [--fix, --exit-zero]  # Apply fixes, and exit with 0 even if files were modified
+      - id: ruff-format  # Formatter: similar to Black, handles consistent code style
+        args: []  # Check formatting, but do not auto-fix during commit; fail if not formatted

.ruff.toml

@@ -4,7 +4,7 @@
 #
 # This file follows the standards in Google Python Style Guide
 # https://google.github.io/styleguide/pyguide.html
-#  
+#
 
 line-length = 80 # Google Style Guide §3.2: 80 columns
 indent-width = 4 # Google Style Guide §3.4: 4 spaces
@@ -102,7 +102,6 @@ lines-between-types = 1
 [lint.pydocstyle]
 convention = "google"
 ignore-decorators = ["typing.overload", "abc.abstractmethod"]
-ignore-var-parameters = true
 
 [lint.flake8-annotations]
 mypy-init-return = true

buf.gen.yaml

@@ -19,7 +19,7 @@ managed:
 plugins:
   # Generate python protobuf related code
   # Generates *_pb2.py files, one for each .proto
-  - remote: buf.build/protocolbuffers/python
+  - remote: buf.build/protocolbuffers/python:v29.3
     out: src/a2a/grpc
   # Generate python service code.
   # Generates *_pb2_grpc.py

pyproject.toml

@@ -8,18 +8,18 @@ authors = [{ name = "Google LLC", email = "googleapis-packages@google.com" }]
 requires-python = ">=3.10"
 keywords = ["A2A", "A2A SDK", "A2A Protocol", "Agent2Agent"]
 dependencies = [
-    "httpx>=0.28.1",
-    "httpx-sse>=0.4.0",
-    "google-api-core>=1.26.0",
-    "opentelemetry-api>=1.33.0",
-    "opentelemetry-sdk>=1.33.0",
-    "pydantic>=2.11.3",
-    "sse-starlette",
-    "starlette",
-    "grpcio>=1.60",
-    "grpcio-tools>=1.60",
-    "grpcio_reflection>=1.7.0",
-    "protobuf==6.31.1",
+  "httpx>=0.28.1",
+  "httpx-sse>=0.4.0",
+  "google-api-core>=1.26.0",
+  "opentelemetry-api>=1.33.0",
+  "opentelemetry-sdk>=1.33.0",
+  "pydantic>=2.11.3",
+  "sse-starlette",
+  "starlette",
+  "grpcio>=1.60",
+  "grpcio-tools>=1.60",
+  "grpcio_reflection>=1.7.0",
+  "protobuf==5.29.5",
 ]
 
 classifiers = [
@@ -48,8 +48,11 @@ packages = ["src/a2a"]
 testpaths = ["tests"]
 python_files = "test_*.py"
 python_functions = "test_*"
-addopts = "--cov=src --cov-config=.coveragerc --cov-report term --cov-report xml:coverage.xml --cov-branch"
+addopts = "-ra --strict-markers"
 asyncio_mode = "strict"
+markers = [
+    "asyncio: mark a test as a coroutine that should be run by pytest-asyncio",
+]
 
 [build-system]
 requires = ["hatchling", "uv-dynamic-versioning"]
@@ -59,31 +62,30 @@ build-backend = "hatchling.build"
 source = "uv-dynamic-versioning"
 
 [tool.hatch.build.targets.sdist]
-exclude = [
-  "tests/",
-]
+exclude = ["tests/"]
 
 [tool.uv-dynamic-versioning]
 vcs = "git"
 style = "pep440"
 
 [dependency-groups]
 dev = [
-    "datamodel-code-generator>=0.30.0",
-    "mypy>=1.15.0",
-    "pytest>=8.3.5",
-    "pytest-asyncio>=0.26.0",
-    "pytest-cov>=6.1.1",
-    "pytest-mock>=3.14.0",
-    "respx>=0.20.2",
-    "ruff>=0.11.6",
-    "uv-dynamic-versioning>=0.8.2",
-    "types-protobuf",
-    "types-requests",
-    "fastapi>=0.115.2",
+  "datamodel-code-generator>=0.30.0",
+  "mypy>=1.15.0",
+  "pytest>=8.3.5",
+  "pytest-asyncio>=0.26.0",
+  "pytest-cov>=6.1.1",
+  "pytest-mock>=3.14.0",
+  "respx>=0.20.2",
+  "ruff>=0.11.6",
+  "uv-dynamic-versioning>=0.8.2",
+  "types-protobuf",
+  "types-requests",
+  "pre-commit",
+  "fastapi>=0.115.2",
 ]
 fastapi = [
-    "fastapi>=0.115.2",
+  "fastapi>=0.115.2",
 ]
 
 [[tool.uv.index]]