# Undine - GraphQL for Django
[![Coverage Status][coverage-badge]][coverage]
[![GitHub Workflow Status][status-badge]][status]
[![PyPI][pypi-badge]][pypi]
[![GitHub][licence-badge]][licence]
[![GitHub Last Commit][repo-badge]][repo]
[![GitHub Issues][issues-badge]][issues]
[![Downloads][downloads-badge]][pypi]
[![Python Version][version-badge]][pypi]
[![Django Version][django-badge]][pypi]
[coverage-badge]: https://coveralls.io/repos/github/MrThearMan/undine/badge.svg?branch=main
[status-badge]: https://img.shields.io/github/actions/workflow/status/MrThearMan/undine/test.yml?branch=main
[pypi-badge]: https://img.shields.io/pypi/v/undine
[licence-badge]: https://img.shields.io/github/license/MrThearMan/undine
[repo-badge]: https://img.shields.io/github/last-commit/MrThearMan/undine
[issues-badge]: https://img.shields.io/github/issues-raw/MrThearMan/undine
[version-badge]: https://img.shields.io/pypi/pyversions/undine
[downloads-badge]: https://img.shields.io/pypi/dm/undine
[django-badge]: https://img.shields.io/pypi/djversions/undine
[coverage]: https://coveralls.io/github/MrThearMan/undine?branch=main
[status]: https://github.com/MrThearMan/undine/actions/workflows/test.yml
[pypi]: https://pypi.org/project/undine
[licence]: https://github.com/MrThearMan/undine/blob/main/LICENSE
[repo]: https://github.com/MrThearMan/undine/commits/main
[issues]: https://github.com/MrThearMan/undine/issues
```shell
pip install undine
```
---
**Documentation**: [https://mrthearman.github.io/undine/](https://mrthearman.github.io/undine/)
**Source Code**: [https://github.com/MrThearMan/undine/](https://github.com/MrThearMan/undine/)
**Contributing**: [https://github.com/MrThearMan/undine/blob/main/CONTRIBUTING.md](https://github.com/MrThearMan/undine/blob/main/CONTRIBUTING.md)
---
Undine is a GraphQL library for Django. It's designed to be easy to use and extend
while providing out-of-the-box solutions for many common issues GraphQL developers face.
> **NOTE**: Undine's API is not yet stable and may change in the future.
**Feature highlights:**
- Automatic generation of GraphQL types from Django models
- Automatic query optimization
- Logically composable filtering
- Ordering based on enums
- Single and bulk mutations, including relations
- Hidden and input-only mutation inputs
- Built-in permission and validation hooks
- Support for Relay Global object IDs and Connection pagination
- File uploads based on GraphQL multipart request specification
- Support for asynchronous execution
- Subscriptions with websockets
- Optional persisted documents support
- Lifecycle hooks for customizing the GraphQL request cycle
- Built-in testing tools
Check out the [Tutorial] to get started.
[Tutorial]: https://mrthearman.github.io/undine/tutorial/
Raw data
{
"_id": null,
"home_page": "https://mrthearman.github.io/undine",
"name": "undine",
"maintainer": null,
"docs_url": null,
"requires_python": "<4,>=3.11",
"maintainer_email": null,
"keywords": "Django, GraphQL",
"author": "Matti Lamppu",
"author_email": "lamppu.matti.akseli@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/35/dd/33c83ea625efcae73669d6d6d68aa47fa021c5437fc059a55855d01816c0/undine-0.0.35.tar.gz",
"platform": null,
"description": "# Undine - GraphQL for Django\n\n[![Coverage Status][coverage-badge]][coverage]\n[![GitHub Workflow Status][status-badge]][status]\n[![PyPI][pypi-badge]][pypi]\n[![GitHub][licence-badge]][licence]\n[![GitHub Last Commit][repo-badge]][repo]\n[![GitHub Issues][issues-badge]][issues]\n[![Downloads][downloads-badge]][pypi]\n[![Python Version][version-badge]][pypi]\n[![Django Version][django-badge]][pypi]\n\n[coverage-badge]: https://coveralls.io/repos/github/MrThearMan/undine/badge.svg?branch=main\n[status-badge]: https://img.shields.io/github/actions/workflow/status/MrThearMan/undine/test.yml?branch=main\n[pypi-badge]: https://img.shields.io/pypi/v/undine\n[licence-badge]: https://img.shields.io/github/license/MrThearMan/undine\n[repo-badge]: https://img.shields.io/github/last-commit/MrThearMan/undine\n[issues-badge]: https://img.shields.io/github/issues-raw/MrThearMan/undine\n[version-badge]: https://img.shields.io/pypi/pyversions/undine\n[downloads-badge]: https://img.shields.io/pypi/dm/undine\n[django-badge]: https://img.shields.io/pypi/djversions/undine\n\n[coverage]: https://coveralls.io/github/MrThearMan/undine?branch=main\n[status]: https://github.com/MrThearMan/undine/actions/workflows/test.yml\n[pypi]: https://pypi.org/project/undine\n[licence]: https://github.com/MrThearMan/undine/blob/main/LICENSE\n[repo]: https://github.com/MrThearMan/undine/commits/main\n[issues]: https://github.com/MrThearMan/undine/issues\n\n```shell\npip install undine\n```\n\n---\n\n**Documentation**: [https://mrthearman.github.io/undine/](https://mrthearman.github.io/undine/)\n\n**Source Code**: [https://github.com/MrThearMan/undine/](https://github.com/MrThearMan/undine/)\n\n**Contributing**: [https://github.com/MrThearMan/undine/blob/main/CONTRIBUTING.md](https://github.com/MrThearMan/undine/blob/main/CONTRIBUTING.md)\n\n---\n\nUndine is a GraphQL library for Django. It's designed to be easy to use and extend\nwhile providing out-of-the-box solutions for many common issues GraphQL developers face.\n\n> **NOTE**: Undine's API is not yet stable and may change in the future.\n\n**Feature highlights:**\n\n- Automatic generation of GraphQL types from Django models\n- Automatic query optimization\n- Logically composable filtering\n- Ordering based on enums\n- Single and bulk mutations, including relations\n- Hidden and input-only mutation inputs\n- Built-in permission and validation hooks\n- Support for Relay Global object IDs and Connection pagination\n- File uploads based on GraphQL multipart request specification\n- Support for asynchronous execution\n- Subscriptions with websockets\n- Optional persisted documents support\n- Lifecycle hooks for customizing the GraphQL request cycle\n- Built-in testing tools\n\nCheck out the [Tutorial] to get started.\n\n[Tutorial]: https://mrthearman.github.io/undine/tutorial/\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A GraphQL library for Django",
"version": "0.0.35",
"project_urls": {
"Bug Tracker": "https://github.com/MrThearMan/undine/issues",
"Documentation": "https://mrthearman.github.io/undine",
"Homepage": "https://mrthearman.github.io/undine",
"Repository": "https://github.com/MrThearMan/undine"
},
"split_keywords": [
"django",
" graphql"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f5edd61807b0560233d63ae940529d57acf2f3daf89e8d1242531dc4a967d65d",
"md5": "79b2d74952908899cc839ba8b046a2d6",
"sha256": "eeabbe4214dfddd69c419b551b0b48722ed310ade4553ed7e760e16105658e7b"
},
"downloads": -1,
"filename": "undine-0.0.35-py3-none-any.whl",
"has_sig": false,
"md5_digest": "79b2d74952908899cc839ba8b046a2d6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.11",
"size": 218350,
"upload_time": "2025-08-30T15:57:54",
"upload_time_iso_8601": "2025-08-30T15:57:54.248671Z",
"url": "https://files.pythonhosted.org/packages/f5/ed/d61807b0560233d63ae940529d57acf2f3daf89e8d1242531dc4a967d65d/undine-0.0.35-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "35dd33c83ea625efcae73669d6d6d68aa47fa021c5437fc059a55855d01816c0",
"md5": "d24cd09c4858869b678d9c928700fb20",
"sha256": "3ca1c9329f55227febbbce5e8da21179da2e63aee40659d5c26e60799b7def36"
},
"downloads": -1,
"filename": "undine-0.0.35.tar.gz",
"has_sig": false,
"md5_digest": "d24cd09c4858869b678d9c928700fb20",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.11",
"size": 162637,
"upload_time": "2025-08-30T15:57:55",
"upload_time_iso_8601": "2025-08-30T15:57:55.680774Z",
"url": "https://files.pythonhosted.org/packages/35/dd/33c83ea625efcae73669d6d6d68aa47fa021c5437fc059a55855d01816c0/undine-0.0.35.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-30 15:57:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MrThearMan",
"github_project": "undine",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "undine"
}
JSON
