Skip to main content

Strawberry GraphQL

Python GraphQL library based on dataclasses

CircleCI Discord PyPI

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.

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

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
poetry run pytest

This will install all the dependencies (including dev ones) and run the tests.

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

Metadata

Release files for strawberry-graphql 0.167.1

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.167.1
File Size Uploaded Provenance Actions
strawberry_graphql-0.167.1.tar.gz 158.0 kB Without provenance Details for strawberry_graphql-0.167.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for strawberry-graphql 0.167.1
File Interpreter ABI Platform Actions
strawberry_graphql-0.167.1-py3-none-any.whl Python 3 none any Details for strawberry_graphql-0.167.1-py3-none-any.whl

Total release size: 388.0 kB

Release files / strawberry_graphql-0.167.1.tar.gz

Download URL strawberry_graphql-0.167.1.tar.gz
Size 158.0 kB
Tags Source
SHA-256 checksum
How to use checksums
3f0922c8725424f7f96aca2703140e6cb29246164dab8a61781c350439c4f165
BLAKE2b-256 checksum
How to use checksums
6c49026660b78694c4e59b7a28036564df4b0446dbd92dc6b39c21612f9cf661
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.4.1 CPython/3.10.10 Linux/5.15.0-1034-azure

Release files / strawberry_graphql-0.167.1-py3-none-any.whl

Download URL strawberry_graphql-0.167.1-py3-none-any.whl
Size 230.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7072903fb7b68b37aa41d166ff96dcd6184842b203a647679c82cc398d61ce2f
BLAKE2b-256 checksum
How to use checksums
d5145a8acda0063254a30e88dab47a4d8e318f219f767701c5511ce744f57d4a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.4.1 CPython/3.10.10 Linux/5.15.0-1034-azure

Security for strawberry-graphql 0.167.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.167.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page