graphql-http 2.3.1__tar.gz → 2.3.3__tar.gz

graphql_http-2.3.3/AGENTS.md

@@ -0,0 +1,47 @@
+# GraphQL-HTTP
+
+> Compatibility note: `AGENTS.md` and `CLAUDE.md` are both supported in this repo.
+> Keep these files identical. Any change in one must be mirrored in the other.
+
+HTTP transport layer for serving GraphQL schemas over Starlette/ASGI. Published on [PyPI](https://pypi.org/project/graphql-http/).
+
+## Project Structure
+
+| Directory | Description |
+|-----------|-------------|
+| `graphql_http/` | Main package source |
+| `tests/` | Test suite (11 files, pytest) |
+| `docs/` | Documentation |
+| `examples/` | Example server implementations |
+
+## Development
+
+```bash
+# Install dependencies
+uv sync
+
+# Run tests
+uv run pytest
+
+# Run linter
+uv run flake8 graphql_http tests
+```
+
+## Key Patterns
+
+- Primary entry: `GraphQLHTTP.from_api(api)` — auto-wires schema + context from a `graphql-api` instance
+- Serves GraphiQL IDE, supports GET (queries only) and POST (queries + mutations)
+- Built-in JWT auth via JWKS (`auth_enabled`, `auth_jwks_uri`, `auth_issuer`, `auth_audience`); introspection bypasses auth by default
+- Context injection: resolvers access HTTP request via `self.context.meta["http_request"]`
+
+## Releasing
+
+See the ecosystem-level `CLAUDE.md` in the parent workspace for the full release process. In short:
+
+```bash
+# Ensure CI is green on main, then:
+git tag X.Y.Z
+git push origin X.Y.Z
+```
+
+CI publishes to PyPI and creates a GitHub Release automatically.

graphql_http-2.3.3/CLAUDE.md

@@ -0,0 +1,47 @@
+# GraphQL-HTTP
+
+> Compatibility note: `AGENTS.md` and `CLAUDE.md` are both supported in this repo.
+> Keep these files identical. Any change in one must be mirrored in the other.
+
+HTTP transport layer for serving GraphQL schemas over Starlette/ASGI. Published on [PyPI](https://pypi.org/project/graphql-http/).
+
+## Project Structure
+
+| Directory | Description |
+|-----------|-------------|
+| `graphql_http/` | Main package source |
+| `tests/` | Test suite (11 files, pytest) |
+| `docs/` | Documentation |
+| `examples/` | Example server implementations |
+
+## Development
+
+```bash
+# Install dependencies
+uv sync
+
+# Run tests
+uv run pytest
+
+# Run linter
+uv run flake8 graphql_http tests
+```
+
+## Key Patterns
+
+- Primary entry: `GraphQLHTTP.from_api(api)` — auto-wires schema + context from a `graphql-api` instance
+- Serves GraphiQL IDE, supports GET (queries only) and POST (queries + mutations)
+- Built-in JWT auth via JWKS (`auth_enabled`, `auth_jwks_uri`, `auth_issuer`, `auth_audience`); introspection bypasses auth by default
+- Context injection: resolvers access HTTP request via `self.context.meta["http_request"]`
+
+## Releasing
+
+See the ecosystem-level `CLAUDE.md` in the parent workspace for the full release process. In short:
+
+```bash
+# Ensure CI is green on main, then:
+git tag X.Y.Z
+git push origin X.Y.Z
+```
+
+CI publishes to PyPI and creates a GitHub Release automatically.

{graphql_http-2.3.1 → graphql_http-2.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphql-http
-Version: 2.3.1
+Version: 2.3.3
 Summary: HTTP Server for GraphQL.
 Author-email: Robert Parker <rob@parob.com>
 License: MIT

graphql_http-2.3.3/VERSION

@@ -0,0 +1 @@
+2.3.3

{graphql_http-2.3.1 → graphql_http-2.3.3}/graphql_http/graphiql/index.html

@@ -4692,7 +4692,7 @@ ${jsonInstruction}`;
         const requestBody = {
           systemInstruction: { parts: [{ text: systemPrompt }] },
           contents: contents,
-          generationConfig: { responseMimeType: 'application/json' }
+          generationConfig: {}
         };
 
         if (toolsEnabled) {

{graphql_http-2.3.1 → graphql_http-2.3.3}/graphql_http/helpers.py

@@ -1,6 +1,7 @@
 import json
 from collections import namedtuple
 from collections.abc import MutableMapping
+from functools import lru_cache
 from typing import Any, Callable, Dict, List, Optional, Tuple, Type, Union
 
 from graphql import (
@@ -13,6 +14,7 @@ from graphql import (
     validate,
 )
 from graphql.execution import ExecutionResult
+from graphql.language import DocumentNode
 from graphql.pyutils.awaitable_or_value import AwaitableOrValue
 
 from .error import HttpQueryError
@@ -182,6 +184,20 @@ def format_execution_result(
     return GraphQLResponse(response, status_code)
 
 
+@lru_cache(maxsize=512)
+def _parse_and_validate(
+    schema: GraphQLSchema, query: str
+) -> Tuple[DocumentNode, Tuple[GraphQLError, ...]]:
+    """Parse and validate a query, cached per (schema, query string).
+
+    Both depend only on the schema (fixed per server) and the query text, so
+    repeated queries skip the parse and validation passes entirely. Raised
+    parse errors are not cached by lru_cache, which is what we want.
+    """
+    document = parse(query)
+    return document, tuple(validate(schema, document))
+
+
 def execute_graphql_request(
     schema: GraphQLSchema,
     params: GraphQLParams,
@@ -193,7 +209,7 @@ def execute_graphql_request(
         raise HttpQueryError(400, "Must provide query string.")
 
     try:
-        document = parse(params.query)
+        document, validation_errors = _parse_and_validate(schema, params.query)
     except GraphQLError as e:
         return ExecutionResult(data=None, errors=[e])
     except Exception as e:
@@ -232,9 +248,8 @@ def execute_graphql_request(
     # Note: the schema is not validated here for performance reasons.
     # This should be done only once when starting the server.
 
-    validation_errors = validate(schema, document)
     if validation_errors:
-        return ExecutionResult(data=None, errors=validation_errors)
+        return ExecutionResult(data=None, errors=list(validation_errors))
 
     return execute(
         schema,

{graphql_http-2.3.1 → graphql_http-2.3.3}/graphql_http/server.py

@@ -10,6 +10,7 @@ import uvicorn
 
 from graphql import GraphQLError, ExecutionResult
 from graphql.execution.execute import ExecutionContext
+from graphql.execution.middleware import MiddlewareManager
 from graphql.type.schema import GraphQLSchema
 from jwt import InvalidTokenError, PyJWKClient
 from starlette.applications import Starlette
@@ -136,6 +137,12 @@ class GraphQLHTTP:
         self.schema = schema
         self.root_value = root_value
         self.middleware = middleware
+        # Build the middleware chain once: graphql-core constructs a fresh
+        # MiddlewareManager per execution when handed a raw list, discarding
+        # its per-resolver wrapped-chain cache on every request.
+        self._middleware_manager = (
+            MiddlewareManager(*middleware) if middleware else None
+        )
         self.context_value = context_value
         self.serve_graphiql = serve_graphiql
         self.graphiql_example_query = self._resolve_graphiql_example_query(
@@ -369,10 +376,6 @@ class GraphQLHTTP:
             html_content = f.read()
         html_content = html_content.replace("DEFAULT_QUERY", default_query)
 
-        # Inject Gemini API key from environment if set
-        gemini_api_key = os.environ.get("GRAPHIQL_GEMINI_API_KEY", "")
-        html_content = html_content.replace("__GEMINI_API_KEY__", gemini_api_key)
-
         return HTMLResponse(html_content)
 
     def _handle_options(self, request: Request) -> Optional[Response]:
@@ -539,7 +542,7 @@ class GraphQLHTTP:
                 allow_only_introspection=allow_only_introspection,
                 query_data=query_data,
                 root_value=self.root_value,
-                middleware=self.middleware,
+                middleware=self._middleware_manager,
                 context_value=context_value,
                 execution_context_class=self.execution_context_class,
             )

{graphql_http-2.3.1 → graphql_http-2.3.3}/graphql_http.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphql-http
-Version: 2.3.1
+Version: 2.3.3
 Summary: HTTP Server for GraphQL.
 Author-email: Robert Parker <rob@parob.com>
 License: MIT

{graphql_http-2.3.1 → graphql_http-2.3.3}/graphql_http.egg-info/SOURCES.txt

@@ -1,6 +1,8 @@
 .coverage
 .gitignore
 .gitmodules
+AGENTS.md
+CLAUDE.md
 LICENSE
 README.md
 VERSION

graphql_http-2.3.1/VERSION

@@ -1 +0,0 @@
-2.3.1