Skip to content

phalt/gql_py

Repository files navigation

🌐🐍 gql_py

GraphQL Client for Pythonistas

gql_py is a Pythonic interface around graphQL APIs.

You've got a graphQL API, and you want to talk to it, right? For those of us who love HTTP standards, GraphQL's use of HTTP is questionable at best. The goal of this library is to remove the fuss of HTTP so you can deal with graphQL directly. Just how graphQL's developers intended.

https://circleci.com/gh/phalt/gql_py/tree/master.svg?style=svg

Installing the project is easy:

pip install gql_py

Full blown example:

from gql_py import Gql

gql = Gql(api='https://example.com/graphql')

query = '''
query ($bookId: ID!) {
    book(id: $bookId) {
      id
      title
      author
    }
  }
'''

variables = {
  'book_id': '654'
}

response = qgl.send(query=query, variables=variables)

response.ok
>>> True

response.errors
>>> None

response.data
>>> {'book': {'id': '654', 'title': 'Ursula K. Le Guin', 'title': 'A Wizard of Earthsea'}}

You can validate your graphql query string by passing the __validate__ flag in the __send__ method:

gpl.send(query=query, validate=True)
>>> Traceback (most recent call last):
>>>     graphql.error.syntax_error.GraphQLSyntaxError: Syntax Error: Expected Name, found }

📖 Features

  • No need to handle the HTTP layer. (You can still set HTTP headers, though!)
  • Responses come back as named tuples - even errors!
  • Validate your query strings easily.
  • Python 3.6+

✨ Future goals

  • Hydrate API responses into custom Python objects.

🏗 Status

gql.py is currently under development.

🎥 Credits

This package was created with Cookiecutter.

We use Python Requests for talking HTTP.