graphql-http 2.0.0__tar.gz → 2.1.2__tar.gz

graphql_http-2.1.2/.github/workflows/pages.yml

@@ -0,0 +1,77 @@
+name: Deploy Hugo site to GitHub Pages
+
+on:
+  push:
+    branches: [ main ]
+    paths: [ 'docs/**' ]
+  pull_request:
+    branches: [ main ]
+    paths: [ 'docs/**' ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      HUGO_VERSION: 0.146.0
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          fetch-depth: 0
+      - name: Install Hugo CLI
+        run: |
+          wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
+          && sudo dpkg -i ${{ runner.temp }}/hugo.deb
+      - name: Install Dart Sass
+        run: sudo snap install dart-sass
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v4
+        with:
+          enablement: true
+      - name: Install Node.js dependencies
+        working-directory: ./docs
+        run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
+      - name: Setup Hugo Book theme
+        working-directory: ./docs
+        run: |
+          if [ ! -d "themes/hugo-book" ]; then
+            git clone --depth 1 https://github.com/alex-shpak/hugo-book.git themes/hugo-book
+          fi
+      - name: Build with Hugo
+        env:
+          HUGO_ENVIRONMENT: production
+          HUGO_ENV: production
+        working-directory: ./docs
+        run: |
+          hugo \
+            --gc \
+            --minify \
+            --baseURL "${{ steps.pages.outputs.base_url }}/"
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./docs/public
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.ref == 'refs/heads/main'
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

graphql_http-2.1.2/.github/workflows/python-package.yml

@@ -0,0 +1,78 @@
+name: Python Package CI/CD
+
+on:
+  push:
+    branches:
+      - main # Or your default branch
+    tags:
+      - '*.*.*' # For publishing to PyPI
+  pull_request:
+    branches:
+      - main # Or your default branch
+
+jobs:
+  build_and_test:
+    name: Build and Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"] # graphql-api requires Python 3.11+
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install UV
+      uses: astral-sh/setup-uv@v3
+
+    - name: Install dependencies
+      run: uv sync --dev
+
+    - name: Lint with Flake8
+      run: uv run flake8 graphql_http tests
+
+    - name: Test with Pytest
+      run: uv run pytest
+
+  publish:
+    name: Publish to PyPI
+    needs: build_and_test # Ensure tests pass before publishing
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
+    permissions:
+      id-token: write
+
+    steps:
+    - name: Validate tag format (e.g., 1.0.0)
+      run: |
+        TAG_NAME="${{ github.ref_name }}"
+        if ! [[ "$TAG_NAME" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+          echo "Error: Tag '$TAG_NAME' is not in the required X.Y.Z numeric format (e.g., 1.0.0)."
+          exit 1
+        fi
+        echo "Tag '$TAG_NAME' is valid."
+      shell: bash
+
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12' # Use compatible Python version for publishing
+
+    - name: Install UV
+      uses: astral-sh/setup-uv@v3
+
+    - name: Update VERSION file
+      run: echo "${{ github.ref_name }}" > VERSION
+      shell: bash
+
+    - name: Build and publish package to PyPI
+      run: uv build && uv publish

graphql_http-2.1.2/.gitignore

@@ -0,0 +1,24 @@
+*.pyc
+.DS_Store
+Pipfile.lock
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/

graphql_http-2.1.2/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "docs/themes/hugo-book"]
+	path = docs/themes/hugo-book
+	url = https://github.com/alex-shpak/hugo-book

{graphql_http-2.0.0 → graphql_http-2.1.2}/PKG-INFO

@@ -1,41 +1,32 @@
 Metadata-Version: 2.4
-Name: graphql_http
-Version: 2.0.0
+Name: graphql-http
+Version: 2.1.2
 Summary: HTTP Server for GraphQL.
-Home-page: https://gitlab.com/parob/graphql-http
-Download-URL: https://gitlab.com/parob/graphql-http/-/archive/master/graphql-http-v2.0.0.zip
-Author: Robert Parker
-Author-email: rob@parob.com
+Author-email: Robert Parker <rob@parob.com>
 License: MIT
-Keywords: GraphQL,HTTP,Server,werkzeug
+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>=3.2.0
-Requires-Dist: graphql-api>=1.3.0
-Requires-Dist: werkzeug>=2.2.2
-Requires-Dist: context-helper>=1.0.2
-Requires-Dist: packaging>=21.3
-Requires-Dist: graphql-schema-diff>=1.2.4
-Requires-Dist: pyjwt[crypto]==2.7.0
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: download-url
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: 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
-Dynamic: requires-dist
-Dynamic: summary
 
-# GraphQL HTTP Server
+# 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.
 
@@ -52,6 +43,11 @@ A lightweight, production-ready HTTP server for GraphQL APIs built on top of Sta
 
 ## Installation
 
+```bash
+uv add graphql_http
+```
+
+Or with pip:
 ```bash
 pip install graphql_http
 ```
@@ -114,7 +110,7 @@ server.run()
 app = GraphQLHTTP(
     schema=schema,
     serve_graphiql=True,              # Enable GraphiQL interface
-    graphiql_default_query="{ hello }", # Default query in GraphiQL
+    graphiql_example_query="{ hello }", # Example query in GraphiQL
     allow_cors=True,                  # Enable CORS
     health_path="/health"             # Health check endpoint
 )
@@ -151,6 +147,47 @@ app = GraphQLHTTP(
 )
 ```
 
+## GraphiQL Example Queries
+
+You can provide an example query for GraphiQL to show users how your API works. There are 3 ways to do this:
+
+**1. Pass a string directly:**
+```python
+app = GraphQLHTTP(
+    schema=schema,
+    graphiql_example_query="{ users { id name } }"
+)
+```
+
+**2. Load from a file:**
+```python
+app = GraphQLHTTP(
+    schema=schema,
+    graphiql_example_query_path="./queries/example.graphql"
+)
+```
+
+**3. Auto-discovery (no config needed):**
+
+Just create a `graphiql_example.graphql` or `example.graphql` file in the directory where you run your application and the server will automatically find and use it.
+
+```bash
+# Create the file in your project directory
+echo "query Example { hello }" > example.graphql
+
+# Run your app from the same directory
+python my_server.py
+```
+
+**Note:** The file must be in your current working directory when the server starts, not necessarily where your Python script is located. If auto-discovery isn't working, enable debug logging to see where it's looking:
+
+```python
+import logging
+logging.basicConfig(level=logging.DEBUG)
+```
+
+If you provide multiple sources, the string parameter takes priority, then the file path, then auto-discovery.
+
 ## API Reference
 
 ### GraphQLHTTP Class
@@ -162,7 +199,8 @@ app = GraphQLHTTP(
 - `middleware` (List[Callable], optional): List of middleware functions
 - `context_value` (Any, optional): Context passed to resolvers
 - `serve_graphiql` (bool, default: True): Whether to serve GraphiQL interface
-- `graphiql_default_query` (str, optional): Default query for GraphiQL
+- `graphiql_example_query` (str, optional): Example query for GraphiQL interface
+- `graphiql_example_query_path` (str, optional): Path to file containing example query for GraphiQL
 - `allow_cors` (bool, default: False): Enable CORS middleware
 - `health_path` (str, optional): Path for health check endpoint
 - `execution_context_class` (Type[ExecutionContext], optional): Custom execution context
@@ -251,6 +289,12 @@ The server provides comprehensive error handling:
 
 ### Running Tests
 
+With UV:
+```bash
+uv run pytest tests/ -v
+```
+
+Or with Python directly:
 ```bash
 python -m pytest tests/ -v
 ```

graphql_http-2.0.0/graphql_http.egg-info/PKG-INFO → graphql_http-2.1.2/README.md

@@ -1,41 +1,4 @@
-Metadata-Version: 2.4
-Name: graphql_http
-Version: 2.0.0
-Summary: HTTP Server for GraphQL.
-Home-page: https://gitlab.com/parob/graphql-http
-Download-URL: https://gitlab.com/parob/graphql-http/-/archive/master/graphql-http-v2.0.0.zip
-Author: Robert Parker
-Author-email: rob@parob.com
-License: MIT
-Keywords: GraphQL,HTTP,Server,werkzeug
-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
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: graphql-core>=3.2.0
-Requires-Dist: graphql-api>=1.3.0
-Requires-Dist: werkzeug>=2.2.2
-Requires-Dist: context-helper>=1.0.2
-Requires-Dist: packaging>=21.3
-Requires-Dist: graphql-schema-diff>=1.2.4
-Requires-Dist: pyjwt[crypto]==2.7.0
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: download-url
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: summary
-
-# GraphQL HTTP Server
+# 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.
 
@@ -52,6 +15,11 @@ A lightweight, production-ready HTTP server for GraphQL APIs built on top of Sta
 
 ## Installation
 
+```bash
+uv add graphql_http
+```
+
+Or with pip:
 ```bash
 pip install graphql_http
 ```
@@ -114,7 +82,7 @@ server.run()
 app = GraphQLHTTP(
     schema=schema,
     serve_graphiql=True,              # Enable GraphiQL interface
-    graphiql_default_query="{ hello }", # Default query in GraphiQL
+    graphiql_example_query="{ hello }", # Example query in GraphiQL
     allow_cors=True,                  # Enable CORS
     health_path="/health"             # Health check endpoint
 )
@@ -151,6 +119,47 @@ app = GraphQLHTTP(
 )
 ```
 
+## GraphiQL Example Queries
+
+You can provide an example query for GraphiQL to show users how your API works. There are 3 ways to do this:
+
+**1. Pass a string directly:**
+```python
+app = GraphQLHTTP(
+    schema=schema,
+    graphiql_example_query="{ users { id name } }"
+)
+```
+
+**2. Load from a file:**
+```python
+app = GraphQLHTTP(
+    schema=schema,
+    graphiql_example_query_path="./queries/example.graphql"
+)
+```
+
+**3. Auto-discovery (no config needed):**
+
+Just create a `graphiql_example.graphql` or `example.graphql` file in the directory where you run your application and the server will automatically find and use it.
+
+```bash
+# Create the file in your project directory
+echo "query Example { hello }" > example.graphql
+
+# Run your app from the same directory
+python my_server.py
+```
+
+**Note:** The file must be in your current working directory when the server starts, not necessarily where your Python script is located. If auto-discovery isn't working, enable debug logging to see where it's looking:
+
+```python
+import logging
+logging.basicConfig(level=logging.DEBUG)
+```
+
+If you provide multiple sources, the string parameter takes priority, then the file path, then auto-discovery.
+
 ## API Reference
 
 ### GraphQLHTTP Class
@@ -162,7 +171,8 @@ app = GraphQLHTTP(
 - `middleware` (List[Callable], optional): List of middleware functions
 - `context_value` (Any, optional): Context passed to resolvers
 - `serve_graphiql` (bool, default: True): Whether to serve GraphiQL interface
-- `graphiql_default_query` (str, optional): Default query for GraphiQL
+- `graphiql_example_query` (str, optional): Example query for GraphiQL interface
+- `graphiql_example_query_path` (str, optional): Path to file containing example query for GraphiQL
 - `allow_cors` (bool, default: False): Enable CORS middleware
 - `health_path` (str, optional): Path for health check endpoint
 - `execution_context_class` (Type[ExecutionContext], optional): Custom execution context
@@ -251,6 +261,12 @@ The server provides comprehensive error handling:
 
 ### Running Tests
 
+With UV:
+```bash
+uv run pytest tests/ -v
+```
+
+Or with Python directly:
 ```bash
 python -m pytest tests/ -v
 ```

graphql_http-2.1.2/VERSION

@@ -0,0 +1 @@
+2.1.2

graphql_http-2.1.2/docs/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "themes/hugo-book"]
+	path = themes/hugo-book
+	url = https://github.com/alex-shpak/hugo-book

graphql_http-2.1.2/docs/content/_index.md

@@ -0,0 +1,91 @@
+---
+title: "GraphQL HTTP for Python"
+type: docs
+---
+
+> **A high-performance Python HTTP server for GraphQL APIs with built-in authentication, CORS, and GraphiQL integration.**
+
+# GraphQL HTTP for Python
+
+[![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)
+
+## Why GraphQL HTTP?
+
+`graphql-http` provides a production-ready HTTP server for your GraphQL APIs, built on Starlette/ASGI for excellent async performance. It handles authentication, CORS, health checks, and includes an integrated GraphiQL interface for development.
+
+## Key Features
+
+| Feature | Description |
+|---------|-------------|
+| 🚀 **High Performance** | Built on Starlette/ASGI for excellent async performance, handling thousands of concurrent requests. |
+| 🔐 **JWT Authentication** | Built-in JWT authentication with JWKS support for secure GraphQL APIs in production. |
+| 🌐 **CORS Support** | Configurable CORS middleware for seamless cross-origin requests. |
+| 🎨 **GraphiQL Integration** | Interactive GraphQL IDE included for easy development and testing. |
+| 📊 **Health Checks** | Built-in health check endpoints for monitoring and orchestration. |
+| 🔄 **Batch Queries** | Support for batched GraphQL operations to optimize network usage. |
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install graphql-http
+```
+
+### 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)
+```
+
+Visit [http://localhost:8000/graphql](http://localhost:8000/graphql) to access the GraphiQL interface.
+
+## Integration with GraphQL-API
+
+For advanced schema definition with automatic type inference:
+
+```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}!"
+
+# Create server from API
+server = GraphQLHTTP.from_api(api)
+server.run()
+```
+
+## What's Next?
+
+- 📚 **[Getting Started](docs/getting-started/)** - Learn the basics with our comprehensive guide
+- 💡 **[Examples](docs/examples/)** - Explore practical examples and tutorials for real-world scenarios
+- 📖 **[API Reference](docs/api-reference/)** - Check out the complete API documentation

graphql_http-2.1.2/docs/content/docs/_index.md

@@ -0,0 +1,30 @@
+---
+title: Documentation
+type: docs
+bookCollapseSection: true
+weight: 1
+---
+
+# GraphQL HTTP Documentation
+
+Welcome to the GraphQL HTTP documentation. This server provides a production-ready solution for serving GraphQL APIs over HTTP with extensive features for authentication, CORS, and development tools.
+
+## Core Concepts
+
+- **HTTP Server**: ASGI-based server built on Starlette for high performance
+- **GraphQL Integration**: Seamless integration with any GraphQL schema
+- **Authentication**: Built-in JWT authentication with JWKS support
+- **Development Tools**: Integrated GraphiQL interface and testing utilities
+
+## Getting Started
+
+New to GraphQL HTTP? Start with our [Getting Started](./getting-started) guide.
+
+## Documentation Structure
+
+- **[Getting Started](./getting-started)**: Installation and basic setup
+- **[Configuration](./configuration)**: Server configuration options
+- **[Authentication](./authentication)**: JWT authentication setup
+- **[Examples](./examples)**: Practical usage examples
+- **[API Reference](./api-reference)**: Complete API documentation
+- **[Testing](./testing)**: Testing your GraphQL server