version 2.0

Author: mtmail

Changes.txt

@@ -1,3 +1,11 @@
+v2.0.0 Thu 15 Jul 2021
+  Python 2 no longer supported
+  New geocode_async and reverse_geocode_async methods
+  You can now reuse HTTP connections for multiple requests by using a `with` block
+  Updated examples/batch.py using asyncronous/parallel requests, much faster
+  Mayor refactor of test suite
+  Some tests now run against the live API endpoint using test API keys
+
 v1.2.2 Tue 3 Nov 2020
   Test on Python 3.9
 

README.md

@@ -5,7 +5,6 @@ A Python module to access the [OpenCage Geocoder](https://opencagedata.com/).
 
 ## Build Status / Code Quality / etc
 
-[![PyPI version](https://badge.fury.io/py/opencage.svg)](https://badge.fury.io/py/opencage)
 [![Downloads](https://pepy.tech/badge/opencage/month)](https://pepy.tech/project/opencage)
 [![Versions](https://img.shields.io/pypi/pyversions/opencage)](https://pypi.org/project/opencage/)
 ![GitHub contributors](https://img.shields.io/github/contributors/opencagedata/python-opencage-geocoder)
@@ -79,6 +78,20 @@ with OpenCageGeocode(key) as geocoder:
     results = [geocoder.geocode(query) for query in queries]
 ```
 
+### Asycronous requests
+
+You can run requests in parallel with the `geocode_async` and `reverse_geocode_async`
+method which have the same parameters and response as their synronous counterparts.
+You will need at least Python 3.7 and the `asyncio` and `aiohttp` packages installed.
+
+```python
+async with OpenCageGeocode(key) as geocoder:
+    results = await geocoder.geocode_async(address)
+```
+
+For a more complete example and links to futher tutorials on asycronous IO see
+`batch.py` in the `examples` directory.
+
 ### Exceptions
 
 If anything goes wrong, then an exception will be raised:

setup.py

@@ -16,7 +16,7 @@
 if sys.version_info < (3, 5):
     raise RuntimeError(
         "openage requires Python 3.6 or newer"
-        "Use older operncage 1.x for Python 2.7 or 3.5"
+        "Use older opencage 1.x for Python 2.7 or 3.5"
     )
 
 # try for travis
@@ -28,14 +28,14 @@
 
 setup(
     name="opencage",
-    version="1.2.2",
+    version="2.0.0",
     description="Wrapper module for the OpenCage Geocoder API",
     long_description=long_description,
     long_description_content_type='text/markdown',
     author="OpenCage GmbH",
     author_email="info@opencagedata.com",
     url="https://github.com/OpenCageData/python-opencage-geocoder/",
-    download_url="https://github.com/OpenCageData/python-opencage-geocoder/tarball/1.2.2",
+    download_url="https://github.com/OpenCageData/python-opencage-geocoder/tarball/2.0.0",
     license="BSD",
     packages=find_packages(),
     include_package_data=True,

tox.ini

@@ -1,5 +1,5 @@
 [tox]
-envlist = py3613, py3710, py38, py39, lint
+envlist = py3613, py3710, py38, py3920, lint
 
 [testenv]
 deps =

vagrant-provision.sh

@@ -13,12 +13,14 @@ eval "$(pyenv init -)"
 eval "$(pyenv virtualenv-init -)"
 ' >> ~/.bashrc
 source ~/.bashrc
+exec $SHELL
 
 for VERSION in 3.6.13  3.7.10  3.8.8  3.9.2; do
   pyenv install --skip-existing $VERSION
   pyenv global $VERSION
 done
 
+sudo apt-get install -y python3-pip
 # Python 3.8 has conflicts with upstream Ubuntu and removed distutils from base
 # installation, now add a global one back
 sudo apt-get install --no-install-recommends -q -y python3-distutils