Skip to main content

A Python implementation of GraphQL designed for use with Django

Project description

This is an implementation of GraphQL in Python, designed to work with the Django web framework. The project began at DjangoCon US 2017.

Why Django Graph API?

We see GraphQL as a promising alternative to REST.

In order to increase its usage amongst Python developers, we are trying to create a library that stays up to date with the GraphQL specs and that embraces all of the things we love about Python:

  • simple, readable, and elegant

  • great documentation

  • supportive open-source community

Contributing

We welcome contributions! We use Github projects to organize our ticket workflow. If there’s a particular issue you would like to work on and it isn’t already assigned, feel free to assign it to yourself and start work! If you just want to lend a hand, check out the current project and choose one of the tickets from the backlog!

Once you’re done writing code, you will need to open a pull request with your changes. In order to be merged, pull requests must fulfill the following requirements:

  • All new code must have tests.

  • All tests must be passing.

  • Any relevant documentation has been updated.

If you need help with something, that’s totally fine. Do what you can and then ask for what you need! Just be aware that there may be a delay before someone comes along who has time to provide it.

Once your pull request is complete, one of the core contributors will review it and give feedback or merge as appropriate.

To run the tests, run pytest.

If you have any questions or want to start contributing, chat with us on gitter.

Code of conduct

This project adheres to and supports the Django Code of Conduct.

Style guide

This project uses the Django coding style guide.

Documentation

You can find the full documentation for Django Graph API on ReadTheDocs.

To create the docs locally, navigate to the docs directory, install the docs requirements, then build the docs files as html:

cd docs
pip install -r requirements.txt
make html

The resulting index.html file will be in _build/html/.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-graph-api-0.1.1.tar.gz (9.4 kB view details)

Uploaded Source

Built Distribution

django_graph_api-0.1.1-py2.py3-none-any.whl (13.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-graph-api-0.1.1.tar.gz.

File metadata

File hashes

Hashes for django-graph-api-0.1.1.tar.gz
Algorithm Hash digest
SHA256 4e49c6c07b3a225df67d5dfceb23453b8103819fb739c0f40a8b740bcc4919a4
MD5 3be0977fb1bb8a5a16998ede99b7e46e
BLAKE2b-256 be599769d27df542ee7a7eafaa1dc62a4ab2bd85c4353502df2039b1f62b19fd

See more details on using hashes here.

File details

Details for the file django_graph_api-0.1.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_graph_api-0.1.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 73587dccb6c4dfabe9727d7f75343e36efcf57458aabfd1db3262bcafc03a845
MD5 80f3cab78b1619b02f69d91526b54484
BLAKE2b-256 7176227f26dadd75f12484277cd3eeee5dd544b5627e3c2f91781a9e818636e0

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page