All setting the protocol to http (#47)

Author: mtmail

README.md

@@ -32,8 +32,6 @@ Load the module:
 from opencage.geocoder import OpenCageGeocode
 ```
 
-**Please note**: You will need the ability to make https requests, which is unfortunately not always the case with default installs of Python.
-
 Create an instance of the geocoder module, passing a valid OpenCage Data Geocoder API key
 as a parameter to the geocoder modules's constructor:
 
@@ -99,6 +97,17 @@ async with OpenCageGeocode(key) as geocoder:
 For a more complete example and links to futher tutorials on asyncronous IO see
 `batch.py` in the `examples` directory.
 
+### Non-SSL API use
+
+If you have trouble accesing the OpenCage API with https, e.g. issues with OpenSSL
+libraries in your enviroment, then you can set the 'http' protocol instead. Please
+understand that the connection to the OpenCage API will no longer be encrypted.
+
+```python
+geocoder = OpenCageGeocode('your-api-key', 'http')
+```
+
+
 ### Exceptions
 
 If anything goes wrong, then an exception will be raised:

opencage/geocoder.py

@@ -125,9 +125,11 @@ class OpenCageGeocode:
     key = ''
     session = None
 
-    def __init__(self, key):
+    def __init__(self, key, protocol='https'):
         """Constructor."""
         self.key = key
+        if protocol and protocol == 'http':
+            self.url = self.url.replace('https://', 'http://')
 
     def __enter__(self):
         self.session = requests.Session()

test/test_all.py

@@ -14,6 +14,11 @@
 
 geocoder = OpenCageGeocode('abcde')
 
+# Check if protocol can be set
+geocoder_http = OpenCageGeocode('abcde', 'http')
+assert geocoder_http.url == 'http://api.opencagedata.com/geocode/v1/json'
+
+
 def _any_result_around(results, lat=None, lon=None):
     for result in results:
         if (abs(result['geometry']['lat'] - lat) < 0.05 and