First commit

Author: brunneis

README.md

@@ -0,0 +1,121 @@
+# easygraphql
+A minimal library to interact with GraphQL from Python
+
+## Installation
+```bash
+pip install easygraphql
+```
+
+## Usage
+
+### Instantiation
+```python
+from easygraphql import GraphQL
+
+graphql = GraphQL('https://example.org/graphql')
+query = '''
+    query {
+        hello
+    }
+'''
+result = graphql.execute(query)
+```
+
+### Authentication
+You can set global headers that will be added to all your GraphQL operations: 
+```python
+graphql.set_headers({'Authorization': 'Bearer xxxxx'})
+```
+
+You can also unset them:
+```python
+graphql.unset_headers()
+```
+
+Or directly provide them on every execution:
+```python
+result = graphql.execute(query, headers={'Authorization': 'Bearer xxxxx'})
+```
+
+## Examples
+
+### Query without variables
+```python
+from easygraphql import GraphQL
+
+graphql = GraphQL('https://swapi-graphql.netlify.com/.netlify/functions/index')
+query = '''
+    query {
+        allFilms {
+            films {
+                title
+                director
+            }
+        }
+    }
+'''
+result = graphql.execute(query)
+```
+
+```json
+{
+    "allFilms": {
+        "films": [
+            {
+                "title": "A New Hope",
+                "director": "George Lucas"
+            },
+            {
+                "title": "The Empire Strikes Back",
+                "director": "Irvin Kershner"
+            },
+            {
+                "title": "Return of the Jedi",
+                "director": "Richard Marquand"
+            },
+            {
+                "title": "The Phantom Menace",
+                "director": "George Lucas"
+            },
+            {
+                "title": "Attack of the Clones",
+                "director": "George Lucas"
+            },
+            {
+                "title": "Revenge of the Sith",
+                "director": "George Lucas"
+            },
+            {
+                "title": "The Force Awakens",
+                "director": "J. J. Abrams"
+            }
+        ]
+    }
+}
+```
+
+### Query with variables
+```python
+from easygraphql import GraphQL
+
+graphql = GraphQL('https://swapi-graphql.netlify.com/.netlify/functions/index')
+query = '''
+    query GetFilm($id: ID!){
+        film(id: $id) {
+            title
+            director
+        }
+    }
+'''
+variables = {"id": "ZmlsbXM6MQ=="}
+result = graphql.execute(query, variables)
+```
+
+```json
+{
+    "film": {
+        "title": "A New Hope",
+        "director": "George Lucas"
+    }
+}
+```

easygraphql/__init__.py

@@ -0,0 +1,6 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from .easygraphql import *
+
+__version__ = '0.0.1b0'

easygraphql/easygraphql.py

@@ -0,0 +1,32 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+import requests
+
+
+class GraphQL:
+    def __init__(self, endpoint, headers=None):
+        self.endpoint = endpoint
+        self.headers = headers
+
+    def set_headers(self, headers):
+        self.headers = headers
+
+    def unset_headers(self):
+        self.headers = None
+
+    def execute(self, operation, variables=None, headers=None):
+        payload = {'query': operation}
+
+        if variables is not None:
+            payload['variables'] = variables
+
+        if headers is None:
+            headers = self.headers
+
+        response = requests.post(self.endpoint, json=payload, headers=headers)
+
+        try:
+            return response.json()['data']
+        except KeyError:
+            return response.json()['errors']

examples/query_film_variables.py

@@ -0,0 +1,18 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from easygraphql import GraphQL
+import json
+
+graphql = GraphQL('https://swapi-graphql.netlify.com/.netlify/functions/index')
+query = '''
+    query GetFilm($id: ID!){
+        film(id: $id) {
+            title
+            director
+        }
+    }
+'''
+variables = {"id": "ZmlsbXM6MQ=="}
+result = graphql.execute(query, variables)
+print(json.dumps(result, indent=4))

examples/query_films.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from easygraphql import GraphQL
+import json
+
+graphql = GraphQL('https://swapi-graphql.netlify.com/.netlify/functions/index')
+query = '''
+    query {
+        allFilms {
+            films {
+                title
+                director
+            }
+        }
+    }
+'''
+result = graphql.execute(query)
+print(json.dumps(result, indent=4))

install.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+rm dist/*
+python3 setup.py install

requirements.txt

@@ -0,0 +1,2 @@
+twine
+requests

setup.py

@@ -0,0 +1,28 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from setuptools import setup
+from setuptools import find_packages
+import easygraphql
+
+setup(
+    name='easygraphql',
+    version=easygraphql.__version__,
+    description='A minimal library to interact with GraphQL from Python',
+    url='https://github.com/brunneis/easygraphql',
+    author='Rodrigo Martínez Castaño',
+    author_email='[email protected]',
+    license='GNU General Public License v3 (GPLv3)',
+    packages=find_packages(),
+    zip_safe=False,
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Environment :: Console",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
+        "Operating System :: POSIX :: Linux",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: Implementation :: PyPy",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+    install_requires=[''])  # Dependencies

upload.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+python3 setup.py bdist_wheel
+twine upload dist/*.whl
+