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 = [
    ...
    '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]

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

Links

Licensing

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

Metadata

Release files for strawberry-graphql 0.80.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.80.1
File Size Uploaded Provenance Actions
strawberry-graphql-0.80.1.tar.gz 76.7 kB Without provenance Details for strawberry-graphql-0.80.1.tar.gz

Built distribution (wheel)

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

Total release size: 187.1 kB

Release files / strawberry-graphql-0.80.1.tar.gz

Download URL strawberry-graphql-0.80.1.tar.gz
Size 76.7 kB
Tags Source
SHA-256 checksum
How to use checksums
45c7190a78c70b46a7cecdabd721a668e51fd1a6044d4ae2b84a6b30e5e089a9
BLAKE2b-256 checksum
How to use checksums
f36a43c2a30772610f704c1f48f07106d83d3d44e0e6419af932d47a4d488050
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.10 CPython/3.7.12 Linux/5.8.0-1042-azure

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

Download URL strawberry_graphql-0.80.1-py3-none-any.whl
Size 110.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fa78d2b50ea731c7b5e6fda7bcbabb2fb5a166b5353d8420b0cf4440d85f5e0e
BLAKE2b-256 checksum
How to use checksums
3ec699d2c885c3be9073570bd15887fb4ad6496dc9781520fcb822f8c9ec629f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.10 CPython/3.7.12 Linux/5.8.0-1042-azure

Security for strawberry-graphql 0.80.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.80.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