ebird-api-requests 4.0.2__tar.gz → 4.1.1__tar.gz

{ebird_api_requests-4.0.2/src/ebird_api_requests.egg-info → ebird_api_requests-4.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ebird-api-requests
-Version: 4.0.2
+Version: 4.1.1
 Summary: A python library for accessing the eBird API, version 2.0
 Author-email: Stuart MacKay <smackay@flagstonesoftware.com>
 License: MIT License
@@ -28,10 +28,10 @@ Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Dynamic: license-file
 
-[![PyPI version](https://badge.fury.io/py/ebird-api.svg)](https://badge.fury.io/py/ebird-api)
-[![Supported Python Versions](https://img.shields.io/pypi/pyversions/ebird-api.svg)](https://img.shields.io/pypi/pyversions/ebird-api)
+[![PyPI version](https://badge.fury.io/py/ebird-api-requests.svg)](https://badge.fury.io/py/ebird-api-requests)
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/ebird-api-requests.svg)](https://img.shields.io/pypi/pyversions/ebird-api-requests)
 
-# eBird API
+# eBird API Requests
 
 eBird API Requests provides a set of wrapper functions for accessing the
 end-points in the eBird API 2.0.
@@ -375,6 +375,11 @@ socket.setdefaulttimeout(30)
 Thirty seconds is a reasonable figure, however you might change it if your
 internet connection is slow or the eBird servers are busy.
 
+## Project Information
+
+* Issues: https://github.com/ebirders/ebird-api-requests
+* Repository: https://github.com/ebirders/ebird-api-requests
+
 ## Links
 
 Documentation for the eBird API: https://documenter.getpostman.com/view/664302/S1ENwy59?version=latest#intro

{ebird_api_requests-4.0.2 → ebird_api_requests-4.1.1}/README.md

@@ -1,7 +1,7 @@
-[![PyPI version](https://badge.fury.io/py/ebird-api.svg)](https://badge.fury.io/py/ebird-api)
-[![Supported Python Versions](https://img.shields.io/pypi/pyversions/ebird-api.svg)](https://img.shields.io/pypi/pyversions/ebird-api)
+[![PyPI version](https://badge.fury.io/py/ebird-api-requests.svg)](https://badge.fury.io/py/ebird-api-requests)
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/ebird-api-requests.svg)](https://img.shields.io/pypi/pyversions/ebird-api-requests)
 
-# eBird API
+# eBird API Requests
 
 eBird API Requests provides a set of wrapper functions for accessing the
 end-points in the eBird API 2.0.
@@ -345,6 +345,11 @@ socket.setdefaulttimeout(30)
 Thirty seconds is a reasonable figure, however you might change it if your
 internet connection is slow or the eBird servers are busy.
 
+## Project Information
+
+* Issues: https://github.com/ebirders/ebird-api-requests
+* Repository: https://github.com/ebirders/ebird-api-requests
+
 ## Links
 
 Documentation for the eBird API: https://documenter.getpostman.com/view/664302/S1ENwy59?version=latest#intro

{ebird_api_requests-4.0.2 → ebird_api_requests-4.1.1}/pyproject.toml

@@ -29,7 +29,7 @@ license = {text = "MIT License"}
 name = "ebird-api-requests"
 readme = "README.md"
 requires-python = ">= 3.10"
-version = "4.0.2"
+version = "4.1.1"
 
 [project.urls]
 Repository = "https://github.com/StuartMacKay/ebird-api-requests.git"
@@ -37,7 +37,7 @@ Issues = "https://github.com/StuartMacKay/ebird-api-requests/issues"
 Changelog = "https://github.com/StuartMacKay/ebird-api-requests/blob/master/CHANGELOG.md"
 
 [tool.bumpversion]
-current_version = "4.0.2"
+current_version = "4.1.1"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 ignore_missing_version = false

{ebird_api_requests-4.0.2 → ebird_api_requests-4.1.1}/src/ebird/api/requests/__init__.py

@@ -2,7 +2,7 @@
 
 """A set of wrapper functions for accessing the eBird API."""
 
-__version__ = "4.0.2"
+__version__ = "4.1.1"
 
 from ebird.api.requests.checklists import get_checklist, get_visits
 from ebird.api.requests.client import Client

{ebird_api_requests-4.0.2 → ebird_api_requests-4.1.1}/src/ebird/api/requests/hotspots.py

@@ -1,5 +1,6 @@
 """Functions for fetching information about hotspots."""
 
+from json import JSONDecodeError
 from urllib.error import HTTPError
 
 from ebird.api.requests.utils import call
@@ -124,8 +125,8 @@ def get_hotspot(token, loc_id):
     """Get the geographical details of a hotspot.
 
     The call only work for hotspots. If you use the identifier for a private
-    location the eBird API will return HTTP 410 Gone and an HttpError will be
-    raised.
+    location the eBird API will return an empty response (as of Oct 2026) and
+    a JSONDecodeError will be raised.
 
     This maps to the end point in the eBird API 2.0,
     https://documenter.getpostman.com/view/664302/S1ENwy59?version=latest#e25218db-566b-4d8b-81ca-e79a8f68c599
@@ -143,6 +144,8 @@ def get_hotspot(token, loc_id):
 
     :raises HTTPError if the eBird API returns an error.
 
+    :raises JSONDecodeError if the JSON data returned by the API is invalid.
+
     """
     url = HOTSPOT_INFO_URL % clean_location(loc_id)
 
@@ -185,11 +188,13 @@ def get_location(token, loc_id):
 
     # get_region() does not return "isHotspot" in the results, so we
     # try get_hotspot() first and if the call fails with HTTP 410 Gone,
-    # indicating it's a private location, we call get_region and
-    # massage the result.
+    # or as of Oct 2026, HTTP 200 and an empty response, indicating
+    # it's a private location, we call get_region and massage the result.
 
     try:
         return get_hotspot(token, loc_id)
+    except JSONDecodeError:
+        pass
     except HTTPError as err:
         if err.code != 410:
             raise

{ebird_api_requests-4.0.2 → ebird_api_requests-4.1.1}/src/ebird/api/requests/utils.py

@@ -1,6 +1,8 @@
 """Various functions used in the API."""
 
 import json
+import time
+from urllib.error import HTTPError
 from urllib.parse import urlencode
 from urllib.request import Request, urlopen
 
@@ -74,7 +76,7 @@ def filter_parameters(params):
     return filtered
 
 
-def get_response(url, params=None, headers=None):
+def get_response(url, params=None, headers=None, max_retries=3, backoff_factor=1.0):
     """Get the content from the eBird API.
 
     :param url: the URL for the API call.
@@ -84,7 +86,14 @@ def get_response(url, params=None, headers=None):
     :type params: dict
 
     :param headers: the headers to add to the request.
-    :type params: dict
+    :type headers: dict
+
+    :param max_retries: number of times to retry after an error response.
+    :type max_retries: int
+
+    :param backoff_factor: seconds to wait before the first retry; doubles
+    on each subsequent attempt.
+    :type backoff_factor: float
 
     :return: the content returned by the API
     :rtype: str
@@ -104,7 +113,15 @@ def get_response(url, params=None, headers=None):
         for name, value in headers.items():
             request.add_header(name, value)
 
-    return urlopen(request).read()
+    for attempt in range(max_retries + 1):
+        try:
+            return urlopen(request).read()
+        except HTTPError as exc:
+            if attempt == max_retries:
+                raise
+            retry_after = exc.headers.get("Retry-After") if exc.code == 429 else None
+            delay = float(retry_after) if retry_after else backoff_factor * (2**attempt)
+            time.sleep(delay)
 
 
 def get_json(content):
@@ -138,7 +155,7 @@ def save_json(filename, data, indent=None):
         json.dump(data, outfile, indent=indent)
 
 
-def call(url, params, headers):
+def call(url, params, headers, max_retries=3, backoff_factor=1.0):
     """Call the eBird API.
 
     :param url: the URL for the API call.
@@ -148,7 +165,14 @@ def call(url, params, headers):
     :type params: dict
 
     :param headers: the headers to add to the request.
-    :type params: dict
+    :type headers: dict
+
+    :param max_retries: number of times to retry after an error response.
+    :type max_retries: int
+
+    :param backoff_factor: seconds to wait before the first retry; doubles
+    on each subsequent attempt.
+    :type backoff_factor: float
 
     :return: the content returned by the API
     :rtype: dict | list
@@ -158,7 +182,13 @@ def call(url, params, headers):
 
     :raises HTTPError if the eBird API returns an error.
 
+    :raises JSONDecodeError if the JSON data returned by the API is invalid.
+
     """
     filtered = filter_parameters(params)
     mapped = map_parameters(filtered)
-    return get_json(get_response(url, mapped, headers))
+    return get_json(
+        get_response(
+            url, mapped, headers, max_retries=max_retries, backoff_factor=backoff_factor
+        )
+    )

{ebird_api_requests-4.0.2 → ebird_api_requests-4.1.1/src/ebird_api_requests.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ebird-api-requests
-Version: 4.0.2
+Version: 4.1.1
 Summary: A python library for accessing the eBird API, version 2.0
 Author-email: Stuart MacKay <smackay@flagstonesoftware.com>
 License: MIT License
@@ -28,10 +28,10 @@ Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Dynamic: license-file
 
-[![PyPI version](https://badge.fury.io/py/ebird-api.svg)](https://badge.fury.io/py/ebird-api)
-[![Supported Python Versions](https://img.shields.io/pypi/pyversions/ebird-api.svg)](https://img.shields.io/pypi/pyversions/ebird-api)
+[![PyPI version](https://badge.fury.io/py/ebird-api-requests.svg)](https://badge.fury.io/py/ebird-api-requests)
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/ebird-api-requests.svg)](https://img.shields.io/pypi/pyversions/ebird-api-requests)
 
-# eBird API
+# eBird API Requests
 
 eBird API Requests provides a set of wrapper functions for accessing the
 end-points in the eBird API 2.0.
@@ -375,6 +375,11 @@ socket.setdefaulttimeout(30)
 Thirty seconds is a reasonable figure, however you might change it if your
 internet connection is slow or the eBird servers are busy.
 
+## Project Information
+
+* Issues: https://github.com/ebirders/ebird-api-requests
+* Repository: https://github.com/ebirders/ebird-api-requests
+
 ## Links
 
 Documentation for the eBird API: https://documenter.getpostman.com/view/664302/S1ENwy59?version=latest#intro