Strawberry GraphQL

Python GraphQL library based on dataclasses

pip install "strawberry-graphql[cli]"

import strawberry
@strawberry.type
class User:
    name: str
    age: int
@strawberry.type
class Query:
    @strawberry.field
    def user(self) -> User:
        return User(name="Patrick", age=100)
schema = strawberry.Schema(query=Query)

strawberry dev app

Open the dev server by clicking on the following link: http://0.0.0.0:8000/graphql

This will open GraphiQL where you can test the API.

Type-checking

Strawberry comes with a [mypy] plugin that enables statically type-checking your GraphQL schema. To enable it, add the following lines to your mypy.ini configuration:

[mypy]
plugins = strawberry.ext.mypy_plugin

[mypy]: http://www.mypy-lang.org/

Django Integration

A Django view is provided for adding a GraphQL endpoint to your application.

1. Add the app to your INSTALLED_APPS.

INSTALLED_APPS = [
    ...,  # your other apps
    "strawberry.django",
]

1. Add the view to your urls.py file.

from strawberry.django.views import GraphQLView
from .schema import schema
urlpatterns = [
    ...,
    path("graphql", GraphQLView.as_view(schema=schema)),
]

Examples

• Various examples on how to use Strawberry
• Full stack example using Starlette, SQLAlchemy, Typescript codegen and Next.js
• Quart + Strawberry tutorial

Contributing

We use uv to manage dependencies, to get started follow these steps:

git clone https://github.com/strawberry-graphql/strawberry
cd strawberry
uv sync
uv run pytest

For all further detail, check out the Contributing Page

Pre commit

We have a configuration for pre-commit, to add the hook run the following command:

pre-commit install

Links

• Project homepage: https://strawberry.rocks
• Repository: https://github.com/strawberry-graphql/strawberry
• Issue tracker: https://github.com/strawberry-graphql/strawberry/issues

Licensing

The code in this project is licensed under MIT license. See LICENSE for more information.

!Recent Activity