{ "info": { "author": "Geographica", "author_email": "hello@geographica.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.7" ], "description": "# GeoLibs-CARTOasync\nAsynchronous Python client for CARTO.\n\n## Features\n\n- [x] SQL API\n- [ ] Batch API\n- [ ] COPY queries\n- [ ] Import API\n- [ ] Read and write Panda's DataFrames\n- [ ] Maps API?\n- [ ] Tests\n\n\n## Installation\n\n```bash\npip install cartoasync\n```\n\n## Usage\n\n### SQL API example\n\n```python\nfrom cartoasync import Auth, SQLClient\n\nauth = Auth(username='username', api_key='api_key')\nsql_client = SQLClient(auth)\nresult = await sql_client.send('SELECT 1 AS one;')\n\nprint(result)\n>>> {\n>>> \"rows\": [\n>>> {\n>>> \"one\": 1\n>>> }\n>>> ],\n>>> \"time\": 0.002,\n>>> \"fields\": {\n>>> \"one\": {\n>>> \"type\": \"number\"\n>>> }\n>>> },\n>>> \"total_rows\": 1\n>>> }\n```\n\n#### SQL API example, step by step\n\n##### 1. Instantiate an `Auth` object:\n\n###### 1.1. CARTO cloud:\n\n```python\nauth = Auth(username='username', api_key='api_key')\n```\n\n###### 1.2. CARTO OnPremises or cloud organization with an implict user:\n\n```python\nauth = Auth(base_url='https://myapp.com/user/username/', api_key='api_key')\n```\n\n###### 1.3. CARTO OnPremises or cloud organization without an implicit user:\n\n```python\nauth = Auth(base_url='https://myapp.com/', username='username', api_key='api_key')\n```\n\n###### 1.4. SSL:\n\nThe `Auth` constructor has and `ssl` attribute. You can use it for handle to the library a [Python's SSL context](https://docs.python.org/3/library/ssl.html#ssl-contexts), or set it to `False` for relaxing certification checks. More info on [AIOHTTP doc](https://docs.aiohttp.org/en/stable/client_advanced.html#ssl-control-for-tcp-sockets).\n\n##### 2. Instantiate the SQLClient and send queries:\n\n###### 2.1. SQLClient's own AIOHTTP session:\n\n```python\nsql_client = SQLClient(auth)\nresult = await sql_client.send('SELECT 1 AS one;')\n```\n\n###### 2.2. External AIOHTTP session you need to care until the end of its days:\n\n```python\nimport aiohttp\n\nsql_client = SQLClient(auth)\nresult = await sql_client.send('SELECT 1 AS one;', aiohttp.ClientSession())\n```\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/GeographicaGS/GeoLibs-CARTOasync", "keywords": "", "license": "MIT", "maintainer": "Geographica", "maintainer_email": "hello@geographica.com", "name": "geolibs-cartoasync", "package_url": "https://pypi.org/project/geolibs-cartoasync/", "platform": "", "project_url": "https://pypi.org/project/geolibs-cartoasync/", "project_urls": { "Homepage": "https://github.com/GeographicaGS/GeoLibs-CARTOasync" }, "release_url": "https://pypi.org/project/geolibs-cartoasync/0.0.4/", "requires_dist": [ "aiohttp (>=3.5,<4.0)" ], "requires_python": ">=3.7,<4.0", "summary": "GeoLibs CARTOasync", "version": "0.0.4" }, "last_serial": 5174539, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "cf549819997c9c6dc8bb7ac617693acd", "sha256": "de138bda52d2a180384eb2e426861dae8373791e7ebd25df4c0a6049c608004c" }, "downloads": -1, "filename": "geolibs_cartoasync-0.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "cf549819997c9c6dc8bb7ac617693acd", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.7,<4.0", "size": 4043, "upload_time": "2019-04-22T09:19:13", "url": "https://files.pythonhosted.org/packages/49/74/7ee673f839889765a00d234a0abd9c30ff4aeb2873112d2bebf4e4cade3d/geolibs_cartoasync-0.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3cc01284946016a2362570c3d2433b6d", "sha256": "deca456162c1fce040f74edb11553a6e74914de79ac18a57f00a17bdb2306f0d" }, "downloads": -1, "filename": "geolibs-cartoasync-0.0.1.tar.gz", "has_sig": false, "md5_digest": "3cc01284946016a2362570c3d2433b6d", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.7,<4.0", "size": 3797, "upload_time": "2019-04-22T09:19:11", "url": "https://files.pythonhosted.org/packages/58/51/a1d1b53e3dea6627778126bfbf81d803eee585d0db833e414cc28e3c07b8/geolibs-cartoasync-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "c850e3b7f68bda3daf2fd27648698146", "sha256": "6397a8206e706d5289786bfbc29a32446ceb48a2e53c84a19fe57be5513ef919" }, "downloads": -1, "filename": "geolibs_cartoasync-0.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "c850e3b7f68bda3daf2fd27648698146", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.7,<4.0", "size": 4042, "upload_time": "2019-04-22T11:20:40", "url": "https://files.pythonhosted.org/packages/52/4a/d7062f7e870fa6e2e6c6b82db1bc8b8d5b04a94840c7e9d65d95e3b784e2/geolibs_cartoasync-0.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "210c42f5400da9a1081729fd72879728", "sha256": "c8dfea3e7ae5e41f8e101a08ce8fdd51caaeb550ab251fb5259b339cf51b1d10" }, "downloads": -1, "filename": "geolibs-cartoasync-0.0.2.tar.gz", "has_sig": false, "md5_digest": "210c42f5400da9a1081729fd72879728", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.7,<4.0", "size": 3797, "upload_time": "2019-04-22T11:20:39", "url": "https://files.pythonhosted.org/packages/13/87/7793e47eb6e6400175f2065678523176ffbebb0867dc0269905b563e39d4/geolibs-cartoasync-0.0.2.tar.gz" } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "1613558a6e1a8c9fd808e13916e10067", "sha256": "0fe3b696c57063af95a278a223fc0cf4aa55ad5b764f9a9ba057aba395f0a31a" }, "downloads": -1, "filename": "geolibs_cartoasync-0.0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "1613558a6e1a8c9fd808e13916e10067", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.7,<4.0", "size": 4563, "upload_time": "2019-04-22T17:47:54", "url": "https://files.pythonhosted.org/packages/db/48/84b6234d00282f99e5f64b448f7b72c018377d10fb2c76e3863f616eabbc/geolibs_cartoasync-0.0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "946af381689c264363d76c690d8f7f39", "sha256": "3dc79ab3f469abf54bbd8de697d8af03c4a594f7dffc03d84111d556c7fc8e83" }, "downloads": -1, "filename": "geolibs-cartoasync-0.0.3.tar.gz", "has_sig": false, "md5_digest": "946af381689c264363d76c690d8f7f39", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.7,<4.0", "size": 3891, "upload_time": "2019-04-22T17:47:53", "url": "https://files.pythonhosted.org/packages/c8/30/a80015f23f683fa198039aa82c77ea3d3aa7b94e8075f37a044d8f79a899/geolibs-cartoasync-0.0.3.tar.gz" } ], "0.0.4": [ { "comment_text": "", "digests": { "md5": "ac30cfffb40460af0af45564b5684a90", "sha256": "cc6d09f21a9d104ca3cf51e5e77839a31f414f16999566c951fbaa816960933e" }, "downloads": -1, "filename": "geolibs_cartoasync-0.0.4-py3-none-any.whl", "has_sig": false, "md5_digest": "ac30cfffb40460af0af45564b5684a90", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.7,<4.0", "size": 4645, "upload_time": "2019-04-22T20:57:12", "url": "https://files.pythonhosted.org/packages/fa/11/b9f14625e1b825c8c2b32465b90ba7fc2270e8b898e5f855815eb61df624/geolibs_cartoasync-0.0.4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "655bec649b54226f39f81b8969abdcc7", "sha256": "1637b056582c135468551ca674ab67154664d87af98808e338c91df127db5145" }, "downloads": -1, "filename": "geolibs-cartoasync-0.0.4.tar.gz", "has_sig": false, "md5_digest": "655bec649b54226f39f81b8969abdcc7", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.7,<4.0", "size": 3956, "upload_time": "2019-04-22T20:57:11", "url": "https://files.pythonhosted.org/packages/a6/dd/0ca70a7127c5ed627e8c9ceb09af1fa0a0853d459636428c2c72d6fa0485/geolibs-cartoasync-0.0.4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "ac30cfffb40460af0af45564b5684a90", "sha256": "cc6d09f21a9d104ca3cf51e5e77839a31f414f16999566c951fbaa816960933e" }, "downloads": -1, "filename": "geolibs_cartoasync-0.0.4-py3-none-any.whl", "has_sig": false, "md5_digest": "ac30cfffb40460af0af45564b5684a90", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.7,<4.0", "size": 4645, "upload_time": "2019-04-22T20:57:12", "url": "https://files.pythonhosted.org/packages/fa/11/b9f14625e1b825c8c2b32465b90ba7fc2270e8b898e5f855815eb61df624/geolibs_cartoasync-0.0.4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "655bec649b54226f39f81b8969abdcc7", "sha256": "1637b056582c135468551ca674ab67154664d87af98808e338c91df127db5145" }, "downloads": -1, "filename": "geolibs-cartoasync-0.0.4.tar.gz", "has_sig": false, "md5_digest": "655bec649b54226f39f81b8969abdcc7", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.7,<4.0", "size": 3956, "upload_time": "2019-04-22T20:57:11", "url": "https://files.pythonhosted.org/packages/a6/dd/0ca70a7127c5ed627e8c9ceb09af1fa0a0853d459636428c2c72d6fa0485/geolibs-cartoasync-0.0.4.tar.gz" } ] }