{ "info": { "author": "Sam Ireland", "author_email": "mail@samireland.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Internet" ], "description": "|travis| |coveralls| |pypi|\n\n.. |travis| image:: https://api.travis-ci.org/samirelanduk/kirjava.svg?branch=0.1.2\n :target: https://travis-ci.org/samirelanduk/kirjava/\n\n.. |coveralls| image:: https://coveralls.io/repos/github/samirelanduk/kirjava/badge.svg?branch=0.1.2\n :target: https://coveralls.io/github/samirelanduk/kirjava/\n\n.. |pypi| image:: https://img.shields.io/pypi/pyversions/kirjava.svg\n :target: https://pypi.org/project/kirjava/\n\nkirjava\n========\n\nkirjava is a Python GraphQL client.\n\nExample\n-------\n\n >>> import kirjava\n >>> client = kirjava.Client(\"https://api.coolsite.com/\")\n >>> client.execute(\"\"\"{ me { name email }}\"\"\")\n {'data': {'me': {'name': 'Jon Snow', 'email': 'jon@winterfell.gov.ws'}}}\n\n\n\nInstalling\n----------\n\npip\n~~~\n\nkirjava can be installed using pip:\n\n``$ pip3 install kirjava``\n\nkirjava is written for Python 3, and does not support Python 2.\n\nIf you get permission errors, try using ``sudo``:\n\n``$ sudo pip3 install kirjava``\n\n\nDevelopment\n~~~~~~~~~~~\n\nThe repository for kirjava, containing the most recent iteration, can be\nfound `here `_. To clone the\nkirjava repository directly from there, use:\n\n``$ git clone git://github.com/samirelanduk/kirjava.git``\n\n\nRequirements\n~~~~~~~~~~~~\n\nkirjava requires `requests `_.\n\n\nOverview\n--------\n\nkirjava is a lightweight Python GraphQL client.\n\n\nMaking Queries with a Client\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nGraphQL services are interacted with using a ``Client`` object:\n\n >>> import kirjava\n >>> client = kirjava.Client(\"https://api.coolsite.com/\")\n\nThe client is associated with a particular URL upon creation.\n\nQueries are then made using the ``execute`` method.\n\n >>> client.execute(\"{ me { name email }}\")\n {'data': {'me': {'name': 'Jon Snow', 'email': 'jon@winterfell.gov.ws'}}}\n\nIf authentication tokens need to be added, they can be inserted into the\nheaders:\n\n >>> client.headers[\"Authorization\"] = \"dani123\"\n\nVariables can be passed along with the query:\n\n >>> client.execute(\"{ me { name email }}\", variables={\"var1\": 123})\n\nYou can see all previous queries made by a client:\n\n >>> client.history\n (({'string': { me { name email }}, 'variables': {'var1': 123}, {'data': {'me\n ': {'name': 'Jon Snow', 'email': 'jon@winterfell.gov.ws'}}}), ({'string': {\n me { name email }}, 'variables': {}}, {'data': {'me': {'name': 'Jon Snow', '\n email': 'jon@winterfell.gov.ws'}}}))\n\nMaking Queries without a Client\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nAlternatively, if creating a dedicated ``Client`` object is somehow\nbeneath you, and you just want to fire off a quick request without any of that\noverhead, there is a module level ``execute`` function:\n\n >>> kirjava.execute(\"https://api.coolsite.com/\", \"{ me { name email }}\", headers={\"Authorization\": \"dani123\"}, variables={\"var1\": 123})\n\n\nChangelog\n---------\n\nRelease 0.1.2\n~~~~~~~~~~~~~\n\n`1 April 2019`\n\n* Added module-level execute function.\n\n\nRelease 0.1.1\n~~~~~~~~~~~~~\n\n`30 March 2019`\n\n* Added tests.\n* Clients now store history of their queries.\n\n\nRelease 0.1.0\n~~~~~~~~~~~~~\n\n`23 March 2019`\n\n* Created basic Client.\n\n\n", "description_content_type": "text/x-rst", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://kirjava.samireland.com", "keywords": "GraphQL", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "kirjava", "package_url": "https://pypi.org/project/kirjava/", "platform": "", "project_url": "https://pypi.org/project/kirjava/", "project_urls": { "Homepage": "https://kirjava.samireland.com" }, "release_url": "https://pypi.org/project/kirjava/0.1.2/", "requires_dist": [ "requests" ], "requires_python": "", "summary": "A Python GraphQL client.", "version": "0.1.2" }, "last_serial": 5041065, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "1403d992f231440be7f4894d4720bfe7", "sha256": "18223d4b1ec75c3aa3555c4a80e32894f97efbff9db4f0c40614614b95afcbb2" }, "downloads": -1, "filename": "kirjava-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "1403d992f231440be7f4894d4720bfe7", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 2771, "upload_time": "2019-03-23T23:59:00", "url": "https://files.pythonhosted.org/packages/d0/cd/46dce5b1604e1ebb27f42476ed2e44631a994242fb723897c53852fe6ee5/kirjava-0.1.0-py3-none-any.whl" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "c8e2af20dbdfefa41b6c114eb669cb38", "sha256": "6c4bf7fc6e5e2c7b17e9cf613ccdcf9c6117c77902ff266664f02a88fe4e0d73" }, "downloads": -1, "filename": "kirjava-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "c8e2af20dbdfefa41b6c114eb669cb38", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 2863, "upload_time": "2019-03-30T21:00:15", "url": "https://files.pythonhosted.org/packages/63/af/c1a10f1fb2235f3ab87415351e8620f2b66764e56d4c1f372d38e5796026/kirjava-0.1.1-py3-none-any.whl" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "52be96b3c28c39d1b812eae44a0a2245", "sha256": "830eaeef7ca3155d42754e241930ff49cb3503e9edfe083253e90da47c5fa0c9" }, "downloads": -1, "filename": "kirjava-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "52be96b3c28c39d1b812eae44a0a2245", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 4194, "upload_time": "2019-04-01T21:20:05", "url": "https://files.pythonhosted.org/packages/c2/3a/6b652ddc10ec1237949b490c1500b5c7ded2da9d97f051e988348834044e/kirjava-0.1.2-py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "52be96b3c28c39d1b812eae44a0a2245", "sha256": "830eaeef7ca3155d42754e241930ff49cb3503e9edfe083253e90da47c5fa0c9" }, "downloads": -1, "filename": "kirjava-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "52be96b3c28c39d1b812eae44a0a2245", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 4194, "upload_time": "2019-04-01T21:20:05", "url": "https://files.pythonhosted.org/packages/c2/3a/6b652ddc10ec1237949b490c1500b5c7ded2da9d97f051e988348834044e/kirjava-0.1.2-py3-none-any.whl" } ] }