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
Release files for strawberry-graphql-django 0.90.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| strawberry_graphql_django-0.90.0.tar.gz | 97.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| strawberry_graphql_django-0.90.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 218.9 kB
Release files / strawberry_graphql_django-0.90.0.tar.gz
| Download URL | strawberry_graphql_django-0.90.0.tar.gz |
|---|---|
| Size | 97.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c77ae586dbc04c95b9964fa8f431d08952e5efdab0b3ad2076d9f086331f8f58
|
|
BLAKE2b-256 checksum How to use checksums |
0e8138735b1f8de32f90193b744890d2fe1da0358ce52459cd23cac54c1d3cee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","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}
|
Release files / strawberry_graphql_django-0.90.0-py3-none-any.whl
| Download URL | strawberry_graphql_django-0.90.0-py3-none-any.whl |
|---|---|
| Size | 121.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4a80ff7b8b3ea0f37bd9e24f283b4cf225f4088c26a60e023a7492c2e0a23d3f
|
|
BLAKE2b-256 checksum How to use checksums |
26f3fe7d1682aabea752d97ebd7219ace9267f201d3911a64b6165169ea564e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","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}
|
