Strawberry GraphQL

Python GraphQL library based on dataclasses

Installation ( Quick Start )

The quick start method provides a server and CLI to get going quickly. Install with:

pip install "strawberry-graphql[debug-server]"

Getting Started

Create a file called app.py with the following code:

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)

This will create a GraphQL schema defining a User type and a single query field user that will return a hardcoded user.

To run the debug server run the following command:

strawberry server app

Open the debug 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

Django Integration

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

Add the app to your INSTALLED_APPS.

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

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)),
]

WebSockets

To support graphql Subscriptions over WebSockets you need to provide a WebSocket enabled server. The debug server can be made to support WebSockets with these commands:

pip install 'strawberry-graphql[debug-server]'
pip install 'uvicorn[standard]'

Examples

Contributing

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

git clone https://github.com/strawberry-graphql/strawberry
cd strawberry
poetry install --with integrations
poetry 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

Licensing

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

Recent Activity

Release files for strawberry-graphql 0.224.0.dev1711748192

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for strawberry-graphql 0.224.0.dev1711748192
File	Size	Uploaded
strawberry_graphql-0.224.0.dev1711748192.tar.gz	198.0 kB	Mar 29, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for strawberry-graphql 0.224.0.dev1711748192
File	Interpreter	ABI	Platform	Reset
strawberry_graphql-0.224.0.dev1711748192-py3-none-any.whl 288.7 kB Mar 29, 2024	Python 3	none	any	Details

Total release size:486.7 kB

Release files / strawberry_graphql-0.224.0.dev1711748192.tar.gz

Download URL	strawberry_graphql-0.224.0.dev1711748192.tar.gz
Size	198.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`4ad5467b99317ef90a58f5e45d57a7672e0686790c62afee51126193eceeb979`
BLAKE2b-256 checksum How to use checksums	`8f8ffcdd117207c6761832636f75e50849d06f8775708850620ff27a6c6842a7`
Upload date	Mar 29, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.8.2 CPython/3.10.14 Linux/6.5.0-1016-azure`

Release files / strawberry_graphql-0.224.0.dev1711748192-py3-none-any.whl

Download URL	strawberry_graphql-0.224.0.dev1711748192-py3-none-any.whl
Size	288.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`883b8a0455c97a7ae8cc140d2f2bddd06a28a3f8b97271a1f4f8677e5eac84e5`
BLAKE2b-256 checksum How to use checksums	`273f3201da0028c278da59623cca3b6f242ced32b374135c739cdc6acc66d434`
Upload date	Mar 29, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.8.2 CPython/3.10.14 Linux/6.5.0-1016-azure`