| Name | wagtail-grapple JSON |
| Version |
0.25.1
JSON |
| download |
| home_page | None |
| Summary | A Wagtail package that speeds up and simplifies implementing a GraphQL endpoint! |
| upload_time | 2024-04-22 08:28:49 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | None |
| keywords |
wagtail
django
graphql
graphene
api
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
|
<p align="center">
<a href="https://github.com/torchbox/wagtail-grapple">
<img src="https://github.com/torchbox/wagtail-grapple/raw/main/.github/wagtail-grapple.svg?sanitize=true" alt="A red g with a grapple hook" width="80" height="80">
</a>
</p>
# Wagtail Grapple
[](https://github.com/torchbox/wagtail-grapple/actions)
[](https://github.com/astral-sh/ruff)
[](https://pypi.org/project/wagtail-grapple/)
[](https://results.pre-commit.ci/latest/github/torchbox/wagtail-grapple/main)
A library to build GraphQL endpoints easily so you can grapple your Wagtail data from anywhere!
[Explore the docs »](https://wagtail-grapple.readthedocs.io/en/latest/) ·
[Report Bug](https://github.com/torchbox/wagtail-grapple/issues) ·
[Request Feature](https://github.com/torchbox/wagtail-grapple/issues)
## About The Project
There is a range of GraphQL packages for Python and specifically Django.
However, getting these packages to work out of the box with an existing infrastructure
without errors isn't as easy to come by.
The purpose of Grapple is to be able to build GraphQL endpoints on a model by model
basis as quickly as possible. The setup and configuration have been designed
to be as simple but also provide the best features;
No complex serializers need to be written - just add a `graphql_fields` list
to your model and away you go (although if you want to go deeper you can!).
### Features
- Easily create GraphQL types by adding a small annotation in your models.
- Supports traditional Wagtail models:
- Pages (including StreamField & Orderables)
- Snippets
- Images
- Documents
- Media (via [wagtailmedia](https://pypi.org/project/wagtailmedia/))
- Settings
- Redirects
- Search (on all models)
- Custom Image & Document model support
- Pagination support
- Middleware support
### Built With
This library is an abstraction upon and relies heavily on Graphene & Graphene Django.
- [Graphene](https://github.com/graphql-python/graphene)
- [Graphene Django](https://github.com/graphql-python/graphene)
## Getting Started
Getting Grapple installed is designed to be as simple as possible!
### Prerequisites
```
Python >= 3.8
Wagtail >= 5.2
Django >= 4.2
```
### Installation
Install using pip
```bash
python -m pip install wagtail_grapple
```
Add the following to the `INSTALLED_APPS` list in your Wagtail settings file:
```python
INSTALLED_APPS = [
# ...
"grapple",
"graphene_django",
# ...
]
```
Add the following to the bottom of the same settings file, where each key is the app you want to this library to scan and the value is the prefix you want to give to GraphQL types (you can usually leave this blank):
```python
# Grapple config:
GRAPHENE = {"SCHEMA": "grapple.schema.schema"}
GRAPPLE = {
"APPS": ["home"],
}
```
Add the GraphQL URLs to your `urls.py`:
```python
from django.urls import include, path
from grapple import urls as grapple_urls
# ...
urlpatterns = [
# ...
path("api/", include(grapple_urls)),
# ...
]
```
Done! Now you can proceed onto configuring your models to generate GraphQL types that adopt their structure :tada:
_Your GraphQL endpoint is available at [http://localhost:8000/api/graphql/](http://localhost:8000/api/graphql/)_
## Usage
Here is a GraphQL model configuration for the default page from the Wagtail docs:
```python
# ...
from grapple.models import GraphQLString, GraphQLStreamfield
class BlogPage(Page):
author = models.CharField(max_length=255)
date = models.DateField("Post date")
body = StreamField(
[
("heading", blocks.CharBlock(classname="full title")),
("paragraph", blocks.RichTextBlock()),
("image", ImageChooserBlock()),
]
)
content_panels = Page.content_panels + [
FieldPanel("author"),
FieldPanel("date"),
StreamFieldPanel("body"),
]
# Note these fields below:
graphql_fields = [
GraphQLString("heading"),
GraphQLString("date"),
GraphQLString("author"),
GraphQLStreamfield("body"),
]
```
_For more examples, please refer to the [Documentation](https://wagtail-grapple.readthedocs.io/en/latest/)_
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create.
Any contributions [you make](https://github.com/torchbox/wagtail-grapple/graphs/contributors) are **greatly appreciated**.
1. Fork the project
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
### Local development
- In the Python environment of your choice, navigate to `tests/`
- Run `python -m pip install -r requirements.txt`
- Run `python manage.py migrate`
- Run server `python manage.py runserver`
- Run tests `python manage.py test`
#### With Postgres
- Ensure you have docker and docker compose
- Run `docker compose up`
- Run `export DATABASE_URL="postgres://postgres:postgres@localhost/postgres"`
- In the Python environment of your choice, navigate to `tests/`
- Run `python -m pip install -r requirements.txt`
- Run `python manage.py migrate`
- Run server `python manage.py runserver`
- Run tests `python manage.py test`
## Compatibility
Wagtail Grapple supports:
- Python 3.8, 3.9, 3.10 3.11 and 3.12
- Wagtail >= 5.2
## License
Distributed under the MIT License. See `LICENSE` for more information.
<!-- ACKNOWLEDGEMENTS -->
## Inspired by
- [@tr11](https://github.com/tr11)
- [@tmkn](https://github.com/tmkn)
Raw data
{
"_id": null,
"home_page": null,
"name": "wagtail-grapple",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Dan Braghis <dan.braghis@torchbox.com>",
"keywords": "wagtail, django, graphql, graphene, api",
"author": null,
"author_email": "Nathan Horrigan <hello@torchbox.com>",
"download_url": "https://files.pythonhosted.org/packages/e7/3c/1bb184578f87df386bf3e5cf7bfbb36f333ab06fcffb06cbe59b770e8a6f/wagtail_grapple-0.25.1.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <a href=\"https://github.com/torchbox/wagtail-grapple\">\n <img src=\"https://github.com/torchbox/wagtail-grapple/raw/main/.github/wagtail-grapple.svg?sanitize=true\" alt=\"A red g with a grapple hook\" width=\"80\" height=\"80\">\n </a>\n</p>\n\n# Wagtail Grapple\n\n[](https://github.com/torchbox/wagtail-grapple/actions)\n[](https://github.com/astral-sh/ruff)\n[](https://pypi.org/project/wagtail-grapple/)\n[](https://results.pre-commit.ci/latest/github/torchbox/wagtail-grapple/main)\n\nA library to build GraphQL endpoints easily so you can grapple your Wagtail data from anywhere!\n\n[Explore the docs \u00bb](https://wagtail-grapple.readthedocs.io/en/latest/) \u00b7\n[Report Bug](https://github.com/torchbox/wagtail-grapple/issues) \u00b7\n[Request Feature](https://github.com/torchbox/wagtail-grapple/issues)\n\n## About The Project\n\nThere is a range of GraphQL packages for Python and specifically Django.\nHowever, getting these packages to work out of the box with an existing infrastructure\nwithout errors isn't as easy to come by.\n\nThe purpose of Grapple is to be able to build GraphQL endpoints on a model by model\nbasis as quickly as possible. The setup and configuration have been designed\nto be as simple but also provide the best features;\nNo complex serializers need to be written - just add a `graphql_fields` list\nto your model and away you go (although if you want to go deeper you can!).\n\n### Features\n\n- Easily create GraphQL types by adding a small annotation in your models.\n- Supports traditional Wagtail models:\n - Pages (including StreamField & Orderables)\n - Snippets\n - Images\n - Documents\n - Media (via [wagtailmedia](https://pypi.org/project/wagtailmedia/))\n - Settings\n - Redirects\n - Search (on all models)\n- Custom Image & Document model support\n- Pagination support\n- Middleware support\n\n### Built With\n\nThis library is an abstraction upon and relies heavily on Graphene & Graphene Django.\n\n- [Graphene](https://github.com/graphql-python/graphene)\n- [Graphene Django](https://github.com/graphql-python/graphene)\n\n## Getting Started\n\nGetting Grapple installed is designed to be as simple as possible!\n\n### Prerequisites\n\n```\nPython >= 3.8\nWagtail >= 5.2\nDjango >= 4.2\n```\n\n### Installation\n\nInstall using pip\n\n```bash\npython -m pip install wagtail_grapple\n```\n\nAdd the following to the `INSTALLED_APPS` list in your Wagtail settings file:\n\n```python\nINSTALLED_APPS = [\n # ...\n \"grapple\",\n \"graphene_django\",\n # ...\n]\n```\n\nAdd the following to the bottom of the same settings file, where each key is the app you want to this library to scan and the value is the prefix you want to give to GraphQL types (you can usually leave this blank):\n\n```python\n# Grapple config:\nGRAPHENE = {\"SCHEMA\": \"grapple.schema.schema\"}\nGRAPPLE = {\n \"APPS\": [\"home\"],\n}\n```\n\nAdd the GraphQL URLs to your `urls.py`:\n\n```python\nfrom django.urls import include, path\nfrom grapple import urls as grapple_urls\n\n# ...\nurlpatterns = [\n # ...\n path(\"api/\", include(grapple_urls)),\n # ...\n]\n```\n\nDone! Now you can proceed onto configuring your models to generate GraphQL types that adopt their structure :tada:\n_Your GraphQL endpoint is available at [http://localhost:8000/api/graphql/](http://localhost:8000/api/graphql/)_\n\n## Usage\n\nHere is a GraphQL model configuration for the default page from the Wagtail docs:\n\n```python\n# ...\nfrom grapple.models import GraphQLString, GraphQLStreamfield\n\n\nclass BlogPage(Page):\n author = models.CharField(max_length=255)\n date = models.DateField(\"Post date\")\n body = StreamField(\n [\n (\"heading\", blocks.CharBlock(classname=\"full title\")),\n (\"paragraph\", blocks.RichTextBlock()),\n (\"image\", ImageChooserBlock()),\n ]\n )\n\n content_panels = Page.content_panels + [\n FieldPanel(\"author\"),\n FieldPanel(\"date\"),\n StreamFieldPanel(\"body\"),\n ]\n\n # Note these fields below:\n graphql_fields = [\n GraphQLString(\"heading\"),\n GraphQLString(\"date\"),\n GraphQLString(\"author\"),\n GraphQLStreamfield(\"body\"),\n ]\n```\n\n_For more examples, please refer to the [Documentation](https://wagtail-grapple.readthedocs.io/en/latest/)_\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create.\nAny contributions [you make](https://github.com/torchbox/wagtail-grapple/graphs/contributors) are **greatly appreciated**.\n\n1. Fork the project\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n### Local development\n\n- In the Python environment of your choice, navigate to `tests/`\n- Run `python -m pip install -r requirements.txt`\n- Run `python manage.py migrate`\n- Run server `python manage.py runserver`\n- Run tests `python manage.py test`\n\n#### With Postgres\n\n- Ensure you have docker and docker compose\n- Run `docker compose up`\n- Run `export DATABASE_URL=\"postgres://postgres:postgres@localhost/postgres\"`\n- In the Python environment of your choice, navigate to `tests/`\n- Run `python -m pip install -r requirements.txt`\n- Run `python manage.py migrate`\n- Run server `python manage.py runserver`\n- Run tests `python manage.py test`\n\n## Compatibility\n\nWagtail Grapple supports:\n\n- Python 3.8, 3.9, 3.10 3.11 and 3.12\n- Wagtail >= 5.2\n\n## License\n\nDistributed under the MIT License. See `LICENSE` for more information.\n\n<!-- ACKNOWLEDGEMENTS -->\n\n## Inspired by\n\n- [@tr11](https://github.com/tr11)\n- [@tmkn](https://github.com/tmkn)\n\n",
"bugtrack_url": null,
"license": null,
"summary": "A Wagtail package that speeds up and simplifies implementing a GraphQL endpoint!",
"version": "0.25.1",
"project_urls": {
"Changelog": "https://github.com/torchbox/wagtail-grapple/blob/main/CHANGELOG.md",
"Documentation": "https://wagtail-grapple.readthedocs.io/en/latest/"
},
"split_keywords": [
"wagtail",
" django",
" graphql",
" graphene",
" api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1dc6ce38a41f1861c80bfb390ac7395c9c96386b6bd07c5c540e435a6ef503d6",
"md5": "3043bde7ea5236882c95e9becfcc98db",
"sha256": "81e7f568c6dbd8bb0f607c736c677843bd4f6601ee852c8dde4dce2c9279ab29"
},
"downloads": -1,
"filename": "wagtail_grapple-0.25.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3043bde7ea5236882c95e9becfcc98db",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 47751,
"upload_time": "2024-04-22T08:28:47",
"upload_time_iso_8601": "2024-04-22T08:28:47.049517Z",
"url": "https://files.pythonhosted.org/packages/1d/c6/ce38a41f1861c80bfb390ac7395c9c96386b6bd07c5c540e435a6ef503d6/wagtail_grapple-0.25.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e73c1bb184578f87df386bf3e5cf7bfbb36f333ab06fcffb06cbe59b770e8a6f",
"md5": "8e6c533c7bb0e4300f97f50863a3135e",
"sha256": "cd2956d8bbd4e2b60a482829b00dbfbd782c6ca28ec5b0e50cd442b66a5e6898"
},
"downloads": -1,
"filename": "wagtail_grapple-0.25.1.tar.gz",
"has_sig": false,
"md5_digest": "8e6c533c7bb0e4300f97f50863a3135e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 38350,
"upload_time": "2024-04-22T08:28:49",
"upload_time_iso_8601": "2024-04-22T08:28:49.291099Z",
"url": "https://files.pythonhosted.org/packages/e7/3c/1bb184578f87df386bf3e5cf7bfbb36f333ab06fcffb06cbe59b770e8a6f/wagtail_grapple-0.25.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-22 08:28:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "torchbox",
"github_project": "wagtail-grapple",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "wagtail-grapple"
}
