Strawberry GraphQL Django Integration
Strawberry GraphQL Django integration provides powerful tools to build GraphQL APIs with Django. Automatically generate GraphQL types, queries, mutations, and resolvers from your Django models with full type safety.
Installation
pip install strawberry-graphql-django
Features
- 🍓 Automatic Type Generation - Generate GraphQL types from Django models with full type safety
- 🔍 Advanced Filtering - Powerful filtering system with lookups (contains, exact, in, etc.)
- 📄 Pagination - Built-in offset and cursor-based (Relay) pagination
- 📊 Ordering - Sort results by any field with automatic ordering support
- 🔐 Authentication & Permissions - Django auth integration with flexible permission system
- ✨ CRUD Mutations - Auto-generated create, update, and delete mutations with validation
- ⚡ Query Optimizer - Automatic
select_relatedandprefetch_relatedto prevent N+1 queries - 🐍 Django Integration - Works with Django views (sync and async), forms, and validation
- 🐛 Debug Toolbar - GraphiQL integration with Django Debug Toolbar for query inspection
Quick Start
# models.py
from django.db import models
class Fruit(models.Model):
name = models.CharField(max_length=20)
color = models.ForeignKey("Color", on_delete=models.CASCADE, related_name="fruits")
class Color(models.Model):
name = models.CharField(max_length=20)
# types.py
import strawberry_django
from strawberry import auto
from . import models
@strawberry_django.type(models.Fruit)
class Fruit:
id: auto
name: auto
color: "Color"
@strawberry_django.type(models.Color)
class Color:
id: auto
name: auto
fruits: list[Fruit]
# schema.py
import strawberry
import strawberry_django
from strawberry_django.optimizer import DjangoOptimizerExtension
from .types import Fruit
@strawberry.type
class Query:
fruits: list[Fruit] = strawberry_django.field()
schema = strawberry.Schema(
query=Query,
extensions=[DjangoOptimizerExtension],
)
# urls.py
from django.urls import path
from strawberry.django.views import AsyncGraphQLView
from .schema import schema
urlpatterns = [
path("graphql/", AsyncGraphQLView.as_view(schema=schema)),
]
That's it! You now have a fully functional GraphQL API with:
- Automatic type inference from Django models
- Optimized database queries (no N+1 problems)
- Interactive GraphiQL interface at
/graphql/
Visit http://localhost:8000/graphql/ and try this query:
query {
fruits {
id
name
color {
name
}
}
}
Next Steps
Check out our comprehensive documentation:
- 📚 Getting Started Guide - Complete tutorial with examples
- 🎓 Example App - Full-featured e-commerce application
- 📖 Documentation - In-depth guides and API reference
- 💬 Discord Community - Get help and share your projects
Contributing
We welcome contributions! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated 😊
Quick Start:
git clone https://github.com/strawberry-graphql/strawberry-django
cd strawberry-django
pre-commit install
Then run tests with make test or make test-dist for parallel execution.
Community
- 💬 Discord - Join our community for help and discussions
- 🐛 GitHub Issues - Report bugs or request features
- 💡 GitHub Discussions - Ask questions and share ideas
License
This project is licensed under the MIT License.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file strawberry_graphql_django-0.87.1.tar.gz.
File metadata
- Download URL: strawberry_graphql_django-0.87.1.tar.gz
- Upload date:
- Size: 96.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
56ff0d101af6097ad7a2180a3f5128dc368d8b9cc9d18bbb25c447f888686804
|
|
| MD5 |
12fe624367e5b168d1d6281048be668d
|
|
| BLAKE2b-256 |
7933e7b82519e4e7c3d5da3424f25fccc806e540fae9032e614dfefaa7539cad
|
File details
Details for the file strawberry_graphql_django-0.87.1-py3-none-any.whl.
File metadata
- Download URL: strawberry_graphql_django-0.87.1-py3-none-any.whl
- Upload date:
- Size: 120.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0c9427653b6ad97fa5a083dc0b560f046e6ca9077eb71e45247f55f8014cfc00
|
|
| MD5 |
01cc5840bd08db87a2175d10d0a75c3e
|
|
| BLAKE2b-256 |
29267b5b6ce7aa7886a0752c01043f6b60a72da294f766e5fb61c6d737e4ed7b
|
