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

graphql_http-2.0.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.0.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.0.0/graphql_http.egg-info → graphql_http-2.0.2}/PKG-INFO

@@ -1,39 +1,30 @@
 Metadata-Version: 2.4
 Name: graphql_http
-Version: 2.0.0
+Version: 2.0.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
 
@@ -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
 ```
@@ -251,6 +247,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-2.0.2}/README.md

@@ -15,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
 ```
@@ -214,6 +219,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.2/VERSION

@@ -0,0 +1 @@
+2.0.2

graphql_http-2.0.2/examples/README.md

@@ -0,0 +1,288 @@
+# GraphQL HTTP Server Examples
+
+This directory contains practical examples demonstrating different use cases and features of the GraphQL HTTP server.
+
+## Available Examples
+
+### 1. Basic Server (`basic_server.py`)
+
+**What it demonstrates:**
+- Simple GraphQL schema definition
+- Basic queries and mutations
+- GraphiQL integration
+- Sample data with resolvers
+
+**How to run:**
+```bash
+python examples/basic_server.py
+```
+
+**Features shown:**
+- Book catalog API with queries and mutations
+- Basic GraphQL types (String, Int, List)
+- Simple resolver functions
+- GraphiQL with default query
+
+**Try these queries:**
+```graphql
+# Get all books
+{
+  books {
+    id
+    title
+    author
+  }
+}
+
+# Get a specific book
+{
+  book(id: 1) {
+    title
+    author
+  }
+}
+
+# Add a new book
+mutation {
+  addBook(title: "New Book", author: "New Author") {
+    id
+    title
+    author
+  }
+}
+```
+
+### 2. Authentication Server (`auth_server.py`)
+
+**What it demonstrates:**
+- JWT authentication configuration
+- CORS setup
+- Protected and public endpoints
+- Environment-based configuration
+
+**How to run:**
+```bash
+# Without authentication (development mode)
+python examples/auth_server.py
+
+# With authentication enabled
+ENABLE_AUTH=true python examples/auth_server.py
+```
+
+**Environment variables:**
+```bash
+export ENABLE_AUTH=true
+export JWKS_URI=https://your-auth0-domain.auth0.com/.well-known/jwks.json
+export JWT_ISSUER=https://your-auth0-domain.auth0.com/
+export JWT_AUDIENCE=your-api-identifier
+```
+
+**Features shown:**
+- JWT token validation
+- JWKS integration
+- Public vs protected fields
+- Introspection without authentication
+- CORS configuration
+- Health check endpoint
+
+### 3. GraphQL-API Integration (`graphql_api_server.py`)
+
+**What it demonstrates:**
+- Integration with the `graphql-api` package
+- Automatic type inference
+- Dataclass integration
+- Advanced schema patterns
+
+**Prerequisites:**
+```bash
+pip install graphql-api
+```
+
+**How to run:**
+```bash
+python examples/graphql_api_server.py
+```
+
+**Features shown:**
+- Automatic Python type to GraphQL type conversion
+- Dataclass models
+- Relationship resolution
+- Context injection
+- Advanced querying patterns
+- Automatic resolver generation
+
+**Try these queries:**
+```graphql
+# Get authors with their posts and comments
+{
+  authors {
+    id
+    name
+    posts {
+      id
+      title
+      published
+      comments {
+        id
+        authorName
+        content
+      }
+    }
+  }
+}
+
+# Search functionality
+{
+  searchPosts(query: "GraphQL") {
+    id
+    title
+    content
+  }
+}
+```
+
+### 4. Advanced Server (`advanced_server.py`)
+
+**What it demonstrates:**
+- Custom middleware implementation
+- Performance monitoring
+- Error handling strategies
+- Custom execution context
+- Caching middleware
+
+**How to run:**
+```bash
+python examples/advanced_server.py
+```
+
+**Features shown:**
+- Performance monitoring middleware
+- Simple in-memory caching
+- Authentication middleware
+- Custom execution context for metrics
+- Custom request context
+- Slow field detection
+- Error handling and validation
+
+**Testing tips:**
+- Set `X-User-ID: admin123` header for admin access
+- Watch console for performance metrics
+- Try the `slowField` and `errorField` for testing
+- Run the same query twice to see caching in action
+
+## Running the Examples
+
+### Prerequisites
+
+1. Install the package:
+   ```bash
+   pip install graphql_http
+   ```
+
+2. For the GraphQL-API example:
+   ```bash
+   pip install graphql-api
+   ```
+
+### Quick Start
+
+1. Choose an example that matches your use case
+2. Run the Python file
+3. Open http://localhost:8000/graphql in your browser
+4. Explore the GraphiQL interface
+5. Try the sample queries provided
+
+### Common Patterns
+
+All examples include:
+- GraphiQL interface at `/graphql`
+- Health check endpoint at `/health` (where configured)
+- CORS support for web applications
+- Comprehensive error handling
+- Sample queries in GraphiQL
+
+## Example Use Cases
+
+### Development and Testing
+Start with `basic_server.py` to understand the fundamentals.
+
+### Production Applications
+Use `auth_server.py` as a template for applications requiring authentication.
+
+### Advanced Type Systems
+Use `graphql_api_server.py` for complex schemas with relationships.
+
+### Performance and Monitoring
+Use `advanced_server.py` for applications requiring performance monitoring and custom middleware.
+
+## Customization
+
+Each example is designed to be easily customizable:
+
+1. **Modify the data models** to match your domain
+2. **Update resolver functions** to connect to your data sources
+3. **Configure authentication** with your auth provider
+4. **Add custom middleware** for your specific requirements
+5. **Extend the schema** with additional fields and types
+
+## Common Configuration Options
+
+### CORS Configuration
+```python
+server = GraphQLHTTP(
+    schema=schema,
+    allow_cors=True,  # Enable CORS for web apps
+)
+```
+
+### GraphiQL Customization
+```python
+server = GraphQLHTTP(
+    schema=schema,
+    serve_graphiql=True,
+    graphiql_default_query="{ hello }",  # Default query
+)
+```
+
+### Health Checks
+```python
+server = GraphQLHTTP(
+    schema=schema,
+    health_path="/health",  # Enable health endpoint
+)
+```
+
+### Authentication
+```python
+server = GraphQLHTTP(
+    schema=schema,
+    auth_enabled=True,
+    auth_jwks_uri="https://your-domain/.well-known/jwks.json",
+    auth_issuer="https://your-domain/",
+    auth_audience="your-audience",
+)
+```
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Port already in use**: Change the port in `server.run(port=8001)`
+2. **Authentication errors**: Verify your JWT configuration
+3. **Import errors**: Install required dependencies
+4. **CORS issues**: Ensure `allow_cors=True` is set
+
+### Getting Help
+
+- Check the main README.md for detailed API documentation
+- Review the test files for more usage examples
+- Open issues on GitHub for bugs or feature requests
+
+## Contributing
+
+Feel free to contribute additional examples! Useful examples include:
+- Database integration (SQLAlchemy, MongoDB)
+- Real-time subscriptions
+- File upload handling
+- Integration with popular frameworks
+- Deployment configurations