prepare version 3.3.1

Author: mtmail

Changes.txt

@@ -1,3 +1,7 @@
+v3.3.1 Sun Mar 29 2026
+  Validate the host domain parameter. Should be opencagedata.com subdomain or localhost
+  Set explicit timeout for HTTP requests
+
 v3.3.0 Tue Feb 17 2026
   Requires python 3.9
   Documentation: overhaul, add missing docstrings, use Google-style (a bit more verbose)

opencage/geocoder.py

@@ -341,9 +341,9 @@ def _opencage_request(self, params):
             UnknownError: If the server returns an error or invalid JSON.
         """
         if self.session:
-            response = self.session.get(self.url, params=params, headers=self._opencage_headers('aiohttp'))
+            response = self.session.get(self.url, params=params, headers=self._opencage_headers('aiohttp'), timeout=30)
         else:
-            response = requests.get(self.url, params=params, headers=self._opencage_headers('requests'))
+            response = requests.get(self.url, params=params, headers=self._opencage_headers('requests'), timeout=30)
 
         try:
             response_json = response.json()
@@ -408,7 +408,8 @@ async def _opencage_async_request(self, params):
             SSLError: If the SSL connection fails.
         """
         try:
-            async with self.session.get(self.url, params=params, ssl=self.sslcontext) as response:
+            timeout = aiohttp.ClientTimeout(total=30)
+            async with self.session.get(self.url, params=params, ssl=self.sslcontext, timeout=timeout) as response:
                 try:
                     response_json = await response.json()
                 except ValueError as excinfo:

opencage/version.py

@@ -1 +1 @@
-__version__ = '3.3.0'
+__version__ = '3.3.1'