<img src="https://raw.githubusercontent.com/graphql-python/graphql-server/master/docs/_static/graphql-server-logo.svg" height="128px">
[](https://badge.fury.io/py/graphql-server)
[](https://codecov.io/gh/graphql-python/graphql-server)
GraphQL-Server is a base library that serves as a helper
for building GraphQL servers or integrations into existing web frameworks using
[GraphQL-Core](https://github.com/graphql-python/graphql-core).
* ✅ It passes all the GraphQL spec tests
* Supports 💾 `Upload`s, 🔁 Sync, 🔀 Async views and 🔄 Subscriptions through WebSockets.
* 🚀 It integrates seamlessly with all HTTP/Websocket Python servers
## Integrations built with GraphQL-Server
| Server integration | Docs |
| --------------------------- | --------------------------------------------------------------------------------------- |
| aiohttp | [aiohttp](https://github.com/graphql-python/graphql-server/blob/master/docs/aiohttp.md) |
| asgi | [asgi](https://github.com/graphql-python/graphql-server/blob/master/docs/asgi.md) |
| Chalice | [chalice](https://github.com/graphql-python/graphql-server/blob/master/docs/chalice.md) |
| Channels (Django) | [channels](https://github.com/graphql-python/graphql-server/blob/master/docs/channels.md) |
| Django | [django](https://github.com/graphql-python/graphql-server/blob/master/docs/django.md) |
| FastAPI | [fastapi](https://github.com/graphql-python/graphql-server/blob/master/docs/fastapi.md) |
| Flask | [flask](https://github.com/graphql-python/graphql-server/blob/master/docs/flask.md) |
| Litestar | [litestar](https://github.com/graphql-python/graphql-server/blob/master/docs/litestar.md) |
| Quart | [quart](https://github.com/graphql-python/graphql-server/blob/master/docs/quart.md) |
| Sanic | [sanic](https://github.com/graphql-python/graphql-server/blob/master/docs/sanic.md) |
| WebOb | [webob](https://github.com/graphql-python/graphql-server/blob/master/docs/webob.md) |
## Documentation
The `graphql_server` package provides these public helper functions:
- `execute`
- `execute_sync`
- `subscribe`
All functions in the package are annotated with type hints and docstrings,
and you can build HTML documentation from these using `bin/build_docs`.
You can also use one of the existing integrations listed above as
blueprint to build your own integration or GraphQL server implementations.
Please let us know when you have built something new, so we can list it here.
## Contributing
See [CONTRIBUTING.md](https://github.com/graphql-python/graphql-server/blob/master/CONTRIBUTING.md)
## Licensing
The code in this project is licensed under MIT license. See [LICENSE](./LICENSE)
for more information.
Raw data
{
"_id": null,
"home_page": null,
"name": "graphql-server",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "graphql, api, rest, starlette, async, fastapi, django, flask, litestar, sanic, channels, aiohttp, chalice, webob, pyright, mypy, codeflash",
"author": "Syrus Akbary",
"author_email": "Syrus Akbary <me@syrusakbary.com>",
"download_url": "https://files.pythonhosted.org/packages/d1/c1/d33490424627c99a760059012b3f7524292f799db432757370a6a8071ce0/graphql_server-3.0.0.tar.gz",
"platform": null,
"description": "<img src=\"https://raw.githubusercontent.com/graphql-python/graphql-server/master/docs/_static/graphql-server-logo.svg\" height=\"128px\">\n\n[](https://badge.fury.io/py/graphql-server)\n[](https://codecov.io/gh/graphql-python/graphql-server)\n\nGraphQL-Server is a base library that serves as a helper\nfor building GraphQL servers or integrations into existing web frameworks using\n[GraphQL-Core](https://github.com/graphql-python/graphql-core).\n* \u2705 It passes all the GraphQL spec tests\n* Supports \ud83d\udcbe `Upload`s, \ud83d\udd01 Sync, \ud83d\udd00 Async views and \ud83d\udd04 Subscriptions through WebSockets.\n* \ud83d\ude80 It integrates seamlessly with all HTTP/Websocket Python servers\n\n## Integrations built with GraphQL-Server\n\n| Server integration | Docs |\n| --------------------------- | --------------------------------------------------------------------------------------- |\n| aiohttp | [aiohttp](https://github.com/graphql-python/graphql-server/blob/master/docs/aiohttp.md) |\n| asgi | [asgi](https://github.com/graphql-python/graphql-server/blob/master/docs/asgi.md) |\n| Chalice | [chalice](https://github.com/graphql-python/graphql-server/blob/master/docs/chalice.md) |\n| Channels (Django) | [channels](https://github.com/graphql-python/graphql-server/blob/master/docs/channels.md) |\n| Django | [django](https://github.com/graphql-python/graphql-server/blob/master/docs/django.md) |\n| FastAPI | [fastapi](https://github.com/graphql-python/graphql-server/blob/master/docs/fastapi.md) |\n| Flask | [flask](https://github.com/graphql-python/graphql-server/blob/master/docs/flask.md) |\n| Litestar | [litestar](https://github.com/graphql-python/graphql-server/blob/master/docs/litestar.md) |\n| Quart | [quart](https://github.com/graphql-python/graphql-server/blob/master/docs/quart.md) |\n| Sanic | [sanic](https://github.com/graphql-python/graphql-server/blob/master/docs/sanic.md) |\n| WebOb | [webob](https://github.com/graphql-python/graphql-server/blob/master/docs/webob.md) |\n\n## Documentation\n\nThe `graphql_server` package provides these public helper functions:\n\n- `execute`\n- `execute_sync`\n- `subscribe`\n\nAll functions in the package are annotated with type hints and docstrings,\nand you can build HTML documentation from these using `bin/build_docs`.\n\nYou can also use one of the existing integrations listed above as\nblueprint to build your own integration or GraphQL server implementations.\n\nPlease let us know when you have built something new, so we can list it here.\n\n## Contributing\n\nSee [CONTRIBUTING.md](https://github.com/graphql-python/graphql-server/blob/master/CONTRIBUTING.md)\n\n## Licensing\n\nThe code in this project is licensed under MIT license. See [LICENSE](./LICENSE)\nfor more information.\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A library setting up a GraphQL server in a variety of frameworks",
"version": "3.0.0",
"project_urls": {
"Changelog": "https://github.com/graphql-python/graphql-server/changelog",
"homepage": "https://graphql-server.org/",
"repository": "https://github.com/graphql-python/graphql-server"
},
"split_keywords": [
"graphql",
" api",
" rest",
" starlette",
" async",
" fastapi",
" django",
" flask",
" litestar",
" sanic",
" channels",
" aiohttp",
" chalice",
" webob",
" pyright",
" mypy",
" codeflash"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ecc839938512c54529107f194aa8fb671435470a23fd35f5833ec8935c951373",
"md5": "2d3e656c8077dd97e5909436a691a9e3",
"sha256": "98f2259003c404f972479df49b5e019497f44c7ba2f447170a1fb981b4f271d2"
},
"downloads": -1,
"filename": "graphql_server-3.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2d3e656c8077dd97e5909436a691a9e3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 89347,
"upload_time": "2025-08-17T12:34:17",
"upload_time_iso_8601": "2025-08-17T12:34:17.302866Z",
"url": "https://files.pythonhosted.org/packages/ec/c8/39938512c54529107f194aa8fb671435470a23fd35f5833ec8935c951373/graphql_server-3.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d1c1d33490424627c99a760059012b3f7524292f799db432757370a6a8071ce0",
"md5": "7b79278398cc5af458ace7bee16f3340",
"sha256": "a21156ae32448ec46989fcc6f65f4eb966a2f23c15936029b5c56b487b786039"
},
"downloads": -1,
"filename": "graphql_server-3.0.0.tar.gz",
"has_sig": false,
"md5_digest": "7b79278398cc5af458ace7bee16f3340",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 54379,
"upload_time": "2025-08-17T12:34:18",
"upload_time_iso_8601": "2025-08-17T12:34:18.809457Z",
"url": "https://files.pythonhosted.org/packages/d1/c1/d33490424627c99a760059012b3f7524292f799db432757370a6a8071ce0/graphql_server-3.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-17 12:34:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "graphql-python",
"github_project": "graphql-server",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "graphql-server"
}
JSON
