graphql-http 2.1.4__tar.gz → 2.2.0__tar.gz

graphql_http-2.2.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: graphql-http
+Version: 2.2.0
+Summary: HTTP Server for GraphQL.
+Author-email: Robert Parker <rob@parob.com>
+License: MIT
+Project-URL: Homepage, https://gitlab.com/parob/graphql-http
+Project-URL: Repository, https://gitlab.com/parob/graphql-http
+Keywords: GraphQL,HTTP,Server,starlette
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: <3.13,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: graphql-core
+Requires-Dist: graphql-api
+Requires-Dist: packaging
+Requires-Dist: graphql-schema-diff
+Requires-Dist: pyjwt[crypto]
+Requires-Dist: starlette
+Requires-Dist: uvicorn
+Requires-Dist: python-multipart
+Requires-Dist: httpx
+Dynamic: license-file
+
+# GraphQL HTTP
+
+[![PyPI version](https://badge.fury.io/py/graphql-http.svg)](https://badge.fury.io/py/graphql-http)
+[![Python versions](https://img.shields.io/pypi/pyversions/graphql-http.svg)](https://pypi.org/project/graphql-http/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**[📚 Documentation](https://graphql-http.parob.com/)** | **[📦 PyPI](https://pypi.org/project/graphql-http/)** | **[🔧 GitHub](https://github.com/parob/graphql-http)**
+
+---
+
+A lightweight, production-ready HTTP server for GraphQL APIs built on top of Starlette/FastAPI. This server provides a simple yet powerful way to serve GraphQL schemas over HTTP with built-in support for authentication, CORS, GraphiQL integration, and more.
+
+## Features
+
+- 🚀 **High Performance**: Built on Starlette/ASGI for excellent async performance
+- 🔐 **JWT Authentication**: Built-in JWT authentication with JWKS support
+- 🌐 **CORS Support**: Configurable CORS middleware for cross-origin requests
+- 🎨 **GraphiQL Integration**: Interactive GraphQL IDE for development
+- 📊 **Health Checks**: Built-in health check endpoints
+- 🔄 **Batch Queries**: Support for batched GraphQL operations
+
+## Installation
+
+```bash
+uv add graphql_http
+```
+
+Or with pip:
+```bash
+pip install graphql_http
+```
+
+## Quick Start
+
+### Basic Usage
+
+```python
+from graphql import GraphQLSchema, GraphQLObjectType, GraphQLField, GraphQLString
+from graphql_http import GraphQLHTTP
+
+# Define your GraphQL schema
+schema = GraphQLSchema(
+    query=GraphQLObjectType(
+        name="Query",
+        fields={
+            "hello": GraphQLField(
+                GraphQLString,
+                resolve=lambda obj, info: "Hello, World!"
+            )
+        }
+    )
+)
+
+# Create the HTTP server
+app = GraphQLHTTP(schema=schema)
+
+# Run the server
+if __name__ == "__main__":
+    app.run(host="0.0.0.0", port=8000)
+```
+
+### Using with graphql-api
+
+For building GraphQL schemas, use [graphql-api](https://graphql-api.parob.com/):
+
+```python
+from graphql_api import GraphQLAPI
+from graphql_http import GraphQLHTTP
+
+api = GraphQLAPI()
+
+@api.type(is_root_type=True)
+class Query:
+    @api.field
+    def hello(self, name: str = "World") -> str:
+        return f"Hello, {name}!"
+
+server = GraphQLHTTP.from_api(api)
+server.run()
+```
+
+## Related Projects
+
+- **[graphql-api](https://graphql-api.parob.com/)** - Build GraphQL schemas with decorators
+- **[graphql-db](https://graphql-db.parob.com/)** - SQLAlchemy integration for database-backed APIs
+- **[graphql-mcp](https://graphql-mcp.parob.com/)** - Expose GraphQL as MCP tools
+
+See the [documentation](https://graphql-http.parob.com/) for configuration, authentication, and advanced features.
+
+
+## Documentation
+
+**Visit the [official documentation](https://graphql-http.parob.com/)** for comprehensive guides, examples, and API reference.
+
+### Key Topics
+
+- **[Getting Started](https://graphql-http.parob.com/docs/getting-started/)** - Quick introduction and basic usage
+- **[Configuration](https://graphql-http.parob.com/docs/configuration/)** - Configure your HTTP server
+- **[Authentication](https://graphql-http.parob.com/docs/authentication/)** - JWT and auth setup
+- **[Testing](https://graphql-http.parob.com/docs/testing/)** - Test your GraphQL endpoints
+- **[Examples](https://graphql-http.parob.com/docs/examples/)** - Real-world usage examples
+- **[API Reference](https://graphql-http.parob.com/docs/api-reference/)** - Complete API documentation
+
+## License
+
+MIT License - see LICENSE file for details.

graphql_http-2.2.0/README.md

@@ -0,0 +1,106 @@
+# GraphQL HTTP
+
+[![PyPI version](https://badge.fury.io/py/graphql-http.svg)](https://badge.fury.io/py/graphql-http)
+[![Python versions](https://img.shields.io/pypi/pyversions/graphql-http.svg)](https://pypi.org/project/graphql-http/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**[📚 Documentation](https://graphql-http.parob.com/)** | **[📦 PyPI](https://pypi.org/project/graphql-http/)** | **[🔧 GitHub](https://github.com/parob/graphql-http)**
+
+---
+
+A lightweight, production-ready HTTP server for GraphQL APIs built on top of Starlette/FastAPI. This server provides a simple yet powerful way to serve GraphQL schemas over HTTP with built-in support for authentication, CORS, GraphiQL integration, and more.
+
+## Features
+
+- 🚀 **High Performance**: Built on Starlette/ASGI for excellent async performance
+- 🔐 **JWT Authentication**: Built-in JWT authentication with JWKS support
+- 🌐 **CORS Support**: Configurable CORS middleware for cross-origin requests
+- 🎨 **GraphiQL Integration**: Interactive GraphQL IDE for development
+- 📊 **Health Checks**: Built-in health check endpoints
+- 🔄 **Batch Queries**: Support for batched GraphQL operations
+
+## Installation
+
+```bash
+uv add graphql_http
+```
+
+Or with pip:
+```bash
+pip install graphql_http
+```
+
+## Quick Start
+
+### Basic Usage
+
+```python
+from graphql import GraphQLSchema, GraphQLObjectType, GraphQLField, GraphQLString
+from graphql_http import GraphQLHTTP
+
+# Define your GraphQL schema
+schema = GraphQLSchema(
+    query=GraphQLObjectType(
+        name="Query",
+        fields={
+            "hello": GraphQLField(
+                GraphQLString,
+                resolve=lambda obj, info: "Hello, World!"
+            )
+        }
+    )
+)
+
+# Create the HTTP server
+app = GraphQLHTTP(schema=schema)
+
+# Run the server
+if __name__ == "__main__":
+    app.run(host="0.0.0.0", port=8000)
+```
+
+### Using with graphql-api
+
+For building GraphQL schemas, use [graphql-api](https://graphql-api.parob.com/):
+
+```python
+from graphql_api import GraphQLAPI
+from graphql_http import GraphQLHTTP
+
+api = GraphQLAPI()
+
+@api.type(is_root_type=True)
+class Query:
+    @api.field
+    def hello(self, name: str = "World") -> str:
+        return f"Hello, {name}!"
+
+server = GraphQLHTTP.from_api(api)
+server.run()
+```
+
+## Related Projects
+
+- **[graphql-api](https://graphql-api.parob.com/)** - Build GraphQL schemas with decorators
+- **[graphql-db](https://graphql-db.parob.com/)** - SQLAlchemy integration for database-backed APIs
+- **[graphql-mcp](https://graphql-mcp.parob.com/)** - Expose GraphQL as MCP tools
+
+See the [documentation](https://graphql-http.parob.com/) for configuration, authentication, and advanced features.
+
+
+## Documentation
+
+**Visit the [official documentation](https://graphql-http.parob.com/)** for comprehensive guides, examples, and API reference.
+
+### Key Topics
+
+- **[Getting Started](https://graphql-http.parob.com/docs/getting-started/)** - Quick introduction and basic usage
+- **[Configuration](https://graphql-http.parob.com/docs/configuration/)** - Configure your HTTP server
+- **[Authentication](https://graphql-http.parob.com/docs/authentication/)** - JWT and auth setup
+- **[Testing](https://graphql-http.parob.com/docs/testing/)** - Test your GraphQL endpoints
+- **[Examples](https://graphql-http.parob.com/docs/examples/)** - Real-world usage examples
+- **[API Reference](https://graphql-http.parob.com/docs/api-reference/)** - Complete API documentation
+
+## License
+
+MIT License - see LICENSE file for details.

graphql_http-2.2.0/VERSION

@@ -0,0 +1 @@
+2.2.0

{graphql_http-2.1.4 → graphql_http-2.2.0}/docs/content/_index.md

@@ -63,9 +63,13 @@ if __name__ == "__main__":
 
 Visit [http://localhost:8000/graphql](http://localhost:8000/graphql) to access the GraphiQL interface.
 
-## Integration with GraphQL-API
+## Related Projects
 
-For advanced schema definition with automatic type inference:
+`graphql-http` provides HTTP serving for GraphQL APIs. For additional functionality:
+
+### Schema Building: graphql-api
+
+Build GraphQL schemas with a decorator-based approach using [graphql-api](https://graphql-api.parob.com/):
 
 ```python
 from graphql_api import GraphQLAPI
@@ -79,11 +83,50 @@ class Query:
     def hello(self, name: str = "World") -> str:
         return f"Hello, {name}!"
 
-# Create server from API
+# Create HTTP server from API
+server = GraphQLHTTP.from_api(api)
+server.run()
+```
+
+**Learn more**: [graphql-api documentation](https://graphql-api.parob.com/)
+
+### Database Integration: graphql-db
+
+For database-backed APIs, use [graphql-db](https://graphql-db.parob.com/) with graphql-http:
+
+```python
+from graphql_api import GraphQLAPI
+from graphql_http import GraphQLHTTP
+from graphql_db.orm_base import DatabaseManager
+
+db_manager = DatabaseManager(url="sqlite:///myapp.db")
+api = GraphQLAPI()
+# ... define your schema with database models ...
+
 server = GraphQLHTTP.from_api(api)
 server.run()
 ```
 
+**Learn more**: [graphql-db documentation](https://graphql-db.parob.com/)
+
+### MCP Tools: graphql-mcp
+
+Expose your GraphQL API as MCP tools alongside HTTP with [graphql-mcp](https://graphql-mcp.parob.com/):
+
+```python
+from graphql_api import GraphQLAPI
+from graphql_mcp.server import GraphQLMCP
+
+api = GraphQLAPI()
+# ... define your schema ...
+
+# Serve both MCP and GraphQL HTTP
+server = GraphQLMCP.from_api(api, graphql_http=True)
+app = server.http_app()
+```
+
+**Learn more**: [graphql-mcp documentation](https://graphql-mcp.parob.com/)
+
 ## What's Next?
 
 - 📚 **[Getting Started](docs/getting-started/)** - Learn the basics with our comprehensive guide

graphql_http-2.2.0/example_advanced_server.py

@@ -0,0 +1,128 @@
+import enum
+import os
+from dataclasses import dataclass
+
+from typing import List
+
+from context_helper import ctx, Context
+from graphql_api import GraphQLAPI, field
+
+from typing import Optional
+
+from sqlalchemy import create_engine
+from sqlalchemy_gql import GraphQLSQLAlchemyMixin
+from sqlmodel import Field, SQLModel, Session, select, col
+
+from graphql_http_server import GraphQLHTTPServer
+
+
+class Note(GraphQLSQLAlchemyMixin, SQLModel, table=True):
+    id: int = Field(primary_key=True)
+    title: str = ""
+    note: str = ""
+
+    @field(mutable=True)
+    def update(self, title: str = None, note: str = None) -> 'Note':
+        if title is not None:
+            self.title = title
+
+        if note is not None:
+            self.note = note
+
+        return self
+
+    @field(mutable=True)
+    def delete(self) -> bool:
+        ctx.session.delete(self)
+        return True
+
+
+class OrderByDirection(enum.Enum):
+    asc = "asc"
+    desc = "desc"
+
+@dataclass
+class OrderBy:
+    key: str
+    direction: OrderByDirection = OrderByDirection.asc
+
+@dataclass
+class NoteFilter:
+    ids: List[int] = None
+    title: str = ""
+
+class Notes:
+
+    @field(mutable=True)
+    def create_note(self, title: str, note: str) -> Note:
+        note = Note(title=title, note=note)
+        ctx.session.add(note)
+
+        return note
+
+    @field
+    def all_notes(
+        self,
+        order_by: List[OrderBy] = None,
+        filter: NoteFilter = None,
+        limit: int = 50,
+        offset: int = 0
+    ) -> List[Note]:
+        """
+        Find `Notes`
+        """
+        query = select(Note)
+
+        if filter and filter.ids:
+            query = query.where(col(Note.id).in_(filter.ids))
+
+        if filter and filter.title:
+            query = query.where(col(Note.title).contains(filter.title))
+
+        if order_by:
+            for _order_by in order_by:
+                c = getattr(Note,_order_by.key)
+                if _order_by.direction == OrderByDirection.asc:
+                    c = c.asc()
+                else:
+                    c = c.desc()
+                query = query.order_by(c)
+
+        return ctx.session.exec(query.limit(limit).offset(offset)).all()
+
+    @field
+    def note(self, id: int = None, title: str = None) -> Optional[Note]:
+        """
+        Title or id must be an exact match.
+        """
+        if id:
+            return ctx.session.exec(select(Note).where(Note.id==id)).one()
+        if title:
+            return ctx.session.exec(select(Note).where(Note.title==title)).one()
+
+
+path = os.path.join(os.path.dirname(__file__), './example.graphql')
+with open(path, mode='r') as file:
+    default_query = file.read()
+
+engine = create_engine("sqlite://")
+
+SQLModel.metadata.create_all(engine)
+
+server = GraphQLHTTPServer.from_api(
+    api=GraphQLAPI(root_type=Notes),
+    graphiql_default_query=default_query
+)
+
+
+def main(request):
+    with Session(engine) as session:
+        with Context(session=session):
+            response = server.dispatch(request=request)
+        session.commit()
+
+    return response
+
+
+if __name__ == "__main__":
+    server.run(main=main, port=3500)