ebird-api 3.4.2__tar.gz → 4.1.0__tar.gz

{ebird_api-3.4.2 → ebird_api-4.1.0}/CHANGELOG.md

@@ -8,6 +8,13 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/).
 This project adheres to [PEP440](https://www.python.org/dev/peps/pep-0440/)
 and by implication, [Semantic Versioning](http://semver.org/).
 
+## [4.1.0] - 2026-06-14
+- Retry requests, with exponentinal back-off, if an error occurs.
+
+## [4.0.0] - 2025-07-09
+- Moved the package to ebird.api.requests to make space for other projects.
+- Changed the minimum supported python version to 3.10
+
 ## [3.4.2] - 2025-04-05
 - Added a timeout so the client will raise an error if the connection
   to eBird freezes

{ebird_api-3.4.2/src/ebird_api.egg-info → ebird_api-4.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ebird-api
-Version: 3.4.2
+Version: 4.1.0
 Summary: Wrapper for accessing the eBird API
 Author-email: Project Babbler <projectbabbler@gmail.com>
 License: MIT License
@@ -15,28 +15,26 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Natural Language :: English
 Classifier: Topic :: Utilities
 Classifier: Topic :: Internet
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Dynamic: license-file
 
-[![Build Status](https://travis-ci.org/ProjectBabbler/ebird-api.svg?branch=master)](https://travis-ci.org/ProjectBabbler/ebird-api)
 [![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)
 
 # eBird API
 
-eBird API provides a set of wrapper functions for accessing the end-points
-in the eBird API 2.0.
+eBird API Requests provides a set of wrapper functions for accessing the
+end-points in the eBird API 2.0.
 
 ## Install
 
@@ -71,7 +69,7 @@ what you want to do - they will be interested to hear it.
 ```python
 import os
 
-from ebird.api import get_observations
+from ebird.api.requests import get_observations
 
 # Always store secrets outside the code, so you don't accidentally
 # commit them. Environment variables are ideal for this.
@@ -97,7 +95,7 @@ regions:
 ```python
 import os
 
-from ebird.api import get_observations
+from ebird.api.requests import get_observations
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -119,7 +117,7 @@ or taxonomy:
 ```python
 import os
 
-from ebird.api import get_observations
+from ebird.api.requests import get_observations
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -134,7 +132,7 @@ species:
 ```python
 import os
 
-from ebird.api import get_nearby_observations
+from ebird.api.requests import get_nearby_observations
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -151,7 +149,7 @@ a small number of species:
 ```python
 import os
 
-from ebird.api import (
+from ebird.api.requests import (
     get_notable_observations,
     get_nearby_notable,
     get_species_observations,
@@ -178,7 +176,7 @@ For the more travel-minded you can also find out the nearest place to see a give
 ```python
 import os
 
-from ebird.api import get_nearest_species
+from ebird.api.requests import get_nearest_species
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -199,7 +197,7 @@ checklist. You can then call get_checklist() to get the list of observations.
 ```python
 import os
 
-from ebird.api import get_visits, get_checklist
+from ebird.api.requests import get_visits, get_checklist
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -224,7 +222,7 @@ on the location of a given hotspot.
 ```python
 import os
 
-from ebird.api import get_hotspots, get_nearby_hotspots, get_hotspot
+from ebird.api.requests import get_hotspots, get_nearby_hotspots, get_hotspot
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -251,7 +249,7 @@ by a region use get_region().
 ```python
 import os
 
-from ebird.api import get_regions, get_adjacent_regions, get_region
+from ebird.api.requests import get_regions, get_adjacent_regions, get_region
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -282,7 +280,7 @@ that are used in the other API calls.
 ```python
 import os
 
-from ebird.api import get_taxonomy, get_taxonomy_forms, get_taxonomy_versions
+from ebird.api.requests import get_taxonomy, get_taxonomy_forms, get_taxonomy_versions
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -315,7 +313,7 @@ lots of people are out trying to get the greatest number of species.
 import os
 
 from datetime import date
-from ebird.api import get_top_100, get_totals
+from ebird.api.requests import get_top_100, get_totals
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -335,7 +333,7 @@ have to keep passing them as arguments.
 ```python
 import os
 
-from ebird.api import Client
+from ebird.api.requests import Client
 
 api_key = os.environ["EBIRD_API_KEY"]
 locale = 'es'
@@ -357,8 +355,8 @@ only returns JSON.
 
 ## Compatibility
 
-ebird-api works with currently supported versions of Python, 3.8+. However,
-it is known to work with earlier versions, at least 3.5 - 3.7, without any
+ebird-api works with currently supported versions of Python, 3.10+. However,
+it is known to work with earlier versions, at least 3.5 - 3.8, without any
 problems.
 
 ## Troubleshooting

{ebird_api-3.4.2 → ebird_api-4.1.0}/README.md

@@ -1,11 +1,10 @@
-[![Build Status](https://travis-ci.org/ProjectBabbler/ebird-api.svg?branch=master)](https://travis-ci.org/ProjectBabbler/ebird-api)
 [![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)
 
 # eBird API
 
-eBird API provides a set of wrapper functions for accessing the end-points
-in the eBird API 2.0.
+eBird API Requests provides a set of wrapper functions for accessing the
+end-points in the eBird API 2.0.
 
 ## Install
 
@@ -40,7 +39,7 @@ what you want to do - they will be interested to hear it.
 ```python
 import os
 
-from ebird.api import get_observations
+from ebird.api.requests import get_observations
 
 # Always store secrets outside the code, so you don't accidentally
 # commit them. Environment variables are ideal for this.
@@ -66,7 +65,7 @@ regions:
 ```python
 import os
 
-from ebird.api import get_observations
+from ebird.api.requests import get_observations
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -88,7 +87,7 @@ or taxonomy:
 ```python
 import os
 
-from ebird.api import get_observations
+from ebird.api.requests import get_observations
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -103,7 +102,7 @@ species:
 ```python
 import os
 
-from ebird.api import get_nearby_observations
+from ebird.api.requests import get_nearby_observations
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -120,7 +119,7 @@ a small number of species:
 ```python
 import os
 
-from ebird.api import (
+from ebird.api.requests import (
     get_notable_observations,
     get_nearby_notable,
     get_species_observations,
@@ -147,7 +146,7 @@ For the more travel-minded you can also find out the nearest place to see a give
 ```python
 import os
 
-from ebird.api import get_nearest_species
+from ebird.api.requests import get_nearest_species
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -168,7 +167,7 @@ checklist. You can then call get_checklist() to get the list of observations.
 ```python
 import os
 
-from ebird.api import get_visits, get_checklist
+from ebird.api.requests import get_visits, get_checklist
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -193,7 +192,7 @@ on the location of a given hotspot.
 ```python
 import os
 
-from ebird.api import get_hotspots, get_nearby_hotspots, get_hotspot
+from ebird.api.requests import get_hotspots, get_nearby_hotspots, get_hotspot
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -220,7 +219,7 @@ by a region use get_region().
 ```python
 import os
 
-from ebird.api import get_regions, get_adjacent_regions, get_region
+from ebird.api.requests import get_regions, get_adjacent_regions, get_region
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -251,7 +250,7 @@ that are used in the other API calls.
 ```python
 import os
 
-from ebird.api import get_taxonomy, get_taxonomy_forms, get_taxonomy_versions
+from ebird.api.requests import get_taxonomy, get_taxonomy_forms, get_taxonomy_versions
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -284,7 +283,7 @@ lots of people are out trying to get the greatest number of species.
 import os
 
 from datetime import date
-from ebird.api import get_top_100, get_totals
+from ebird.api.requests import get_top_100, get_totals
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -304,7 +303,7 @@ have to keep passing them as arguments.
 ```python
 import os
 
-from ebird.api import Client
+from ebird.api.requests import Client
 
 api_key = os.environ["EBIRD_API_KEY"]
 locale = 'es'
@@ -326,8 +325,8 @@ only returns JSON.
 
 ## Compatibility
 
-ebird-api works with currently supported versions of Python, 3.8+. However,
-it is known to work with earlier versions, at least 3.5 - 3.7, without any
+ebird-api works with currently supported versions of Python, 3.10+. However,
+it is known to work with earlier versions, at least 3.5 - 3.8, without any
 problems.
 
 ## Troubleshooting

{ebird_api-3.4.2 → ebird_api-4.1.0}/pyproject.toml

@@ -14,11 +14,10 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: Implementation :: CPython",
     "Natural Language :: English",
     "Topic :: Utilities",
@@ -29,8 +28,8 @@ keywords = ["eBird", "API", "client"]
 license = {text = "MIT License"}
 name = "ebird-api"
 readme = "README.md"
-requires-python = ">= 3.8"
-version = "3.4.2"
+requires-python = ">= 3.10"
+version = "4.1.0"
 
 [project.urls]
 Repository = "https://github.com/ProjectBabbler/ebird-api.git"
@@ -38,7 +37,7 @@ Issues = "https://github.com/ProjectBabbler/ebird-api/issues"
 Changelog = "https://github.com/ProjectBabbler/ebird-api/blob/master/CHANGELOG.md"
 
 [tool.bumpversion]
-current_version = "3.4.2"
+current_version = "4.1.0"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 ignore_missing_version = false
@@ -52,7 +51,7 @@ message = "New version: {current_version} → {new_version}"
 commit_args = ""
 
 [[tool.bumpversion.files]]
-filename = "src/ebird/api/__init__.py"
+filename = "src/ebird/api/requests/__init__.py"
 search = '__version__ = "{current_version}"'
 replace = '__version__ = "{new_version}"'
 
@@ -98,7 +97,7 @@ legacy_tox_ini = """
 requires =
     tox>=4.2
     tox-uv>=1.11.3
-envlist = py38, py39, py310, py311, py312
+envlist = py310, py311, py312, py313
 
 [testenv]
 commands = pytest

ebird_api-4.1.0/src/ebird/api/requests/__init__.py

@@ -0,0 +1,39 @@
+# flake8: noqa
+
+"""A set of wrapper functions for accessing the eBird API."""
+
+__version__ = "4.1.0"
+
+from ebird.api.requests.checklists import get_checklist, get_visits
+from ebird.api.requests.client import Client
+from ebird.api.requests.constants import LOCALES
+from ebird.api.requests.hotspots import (
+    get_hotspot,
+    get_hotspots,
+    get_location,
+    get_nearby_hotspots,
+)
+from ebird.api.requests.observations import (
+    get_historic_observations,
+    get_nearby_notable,
+    get_nearby_observations,
+    get_nearby_species,
+    get_nearest_species,
+    get_notable_observations,
+    get_observations,
+    get_species_observations,
+)
+from ebird.api.requests.regions import (
+    get_adjacent_regions,
+    get_region,
+    get_regions,
+)
+from ebird.api.requests.species import get_species_list
+from ebird.api.requests.statistics import get_top_100, get_totals
+from ebird.api.requests.taxonomy import (
+    get_taxonomy,
+    get_taxonomy_forms,
+    get_taxonomy_groups,
+    get_taxonomy_locales,
+    get_taxonomy_versions,
+)

{ebird_api-3.4.2/src/ebird/api → ebird_api-4.1.0/src/ebird/api/requests}/checklists.py

@@ -1,7 +1,7 @@
 """Functions for fetching checklists and information about visits."""
 
-from ebird.api.utils import call
-from ebird.api.validation import (
+from ebird.api.requests.utils import call
+from ebird.api.requests.validation import (
     clean_area,
     clean_code,
     clean_date,

{ebird_api-3.4.2/src/ebird/api → ebird_api-4.1.0/src/ebird/api/requests}/client.py

@@ -4,7 +4,7 @@
 
 import socket
 
-from ebird.api import (
+from ebird.api.requests import (
     checklists,
     constants,
     hotspots,
@@ -13,7 +13,7 @@ from ebird.api import (
     statistics,
     taxonomy,
 )
-from ebird.api.validation import clean_locale
+from ebird.api.requests.validation import clean_locale
 
 
 class Client:

{ebird_api-3.4.2/src/ebird/api → ebird_api-4.1.0/src/ebird/api/requests}/hotspots.py

@@ -2,8 +2,8 @@
 
 from urllib.error import HTTPError
 
-from ebird.api.utils import call
-from ebird.api.validation import (
+from ebird.api.requests.utils import call
+from ebird.api.requests.validation import (
     clean_back,
     clean_dist,
     clean_lat,

{ebird_api-3.4.2/src/ebird/api → ebird_api-4.1.0/src/ebird/api/requests}/observations.py

@@ -2,8 +2,8 @@
 
 """Functions for fetching information about what species have been seen."""
 
-from ebird.api.utils import call
-from ebird.api.validation import (
+from ebird.api.requests.utils import call
+from ebird.api.requests.validation import (
     clean_areas,
     clean_back,
     clean_categories,

{ebird_api-3.4.2/src/ebird/api → ebird_api-4.1.0/src/ebird/api/requests}/regions.py

@@ -1,7 +1,7 @@
 """Functions for fetching information about regions."""
 
-from ebird.api.utils import call
-from ebird.api.validation import clean_region, clean_region_type
+from ebird.api.requests.utils import call
+from ebird.api.requests.validation import clean_region, clean_region_type
 
 REGION_LIST_URL = "https://api.ebird.org/v2/ref/region/list/%s/%s"
 ADJACENT_REGIONS_URL = "https://api.ebird.org/v2/ref/adjacent/%s"

{ebird_api-3.4.2/src/ebird/api → ebird_api-4.1.0/src/ebird/api/requests}/species.py

@@ -1,7 +1,7 @@
 """Functions for fetching information about species."""
 
-from ebird.api.utils import call
-from ebird.api.validation import clean_area
+from ebird.api.requests.utils import call
+from ebird.api.requests.validation import clean_area
 
 SPECIES_LIST_URL = "https://api.ebird.org/v2/product/spplist/%s"
 

{ebird_api-3.4.2/src/ebird/api → ebird_api-4.1.0/src/ebird/api/requests}/statistics.py

@@ -1,7 +1,7 @@
 """Functions for fetching basic statistics about observers and observations."""
 
-from ebird.api.utils import call
-from ebird.api.validation import (
+from ebird.api.requests.utils import call
+from ebird.api.requests.validation import (
     clean_area,
     clean_date,
     clean_max_observers,

{ebird_api-3.4.2/src/ebird/api → ebird_api-4.1.0/src/ebird/api/requests}/taxonomy.py

@@ -1,7 +1,7 @@
 """Functions for fetching information about the taxonomy used by eBird."""
 
-from ebird.api.utils import call
-from ebird.api.validation import (
+from ebird.api.requests.utils import call
+from ebird.api.requests.validation import (
     clean_categories,
     clean_codes,
     clean_locale,

{ebird_api-3.4.2/src/ebird/api → ebird_api-4.1.0/src/ebird/api/requests}/utils.py

@@ -1,10 +1,12 @@
 """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
 
-from ebird.api import constants
+from ebird.api.requests import constants
 
 _parameter_defaults = {
     "back": constants.DEFAULT_BACK,
@@ -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 a 429 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 a 429 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
@@ -161,4 +185,8 @@ def call(url, params, headers):
     """
     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-3.4.2/src/ebird/api → ebird_api-4.1.0/src/ebird/api/requests}/validation.py

@@ -6,7 +6,7 @@ import re
 from datetime import date, datetime
 from enum import Enum
 
-from ebird.api import constants
+from ebird.api.requests import constants
 
 _locales = constants.LOCALES.values()
 _region_types = ", ".join(constants.REGION_TYPES)

{ebird_api-3.4.2 → ebird_api-4.1.0/src/ebird_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ebird-api
-Version: 3.4.2
+Version: 4.1.0
 Summary: Wrapper for accessing the eBird API
 Author-email: Project Babbler <projectbabbler@gmail.com>
 License: MIT License
@@ -15,28 +15,26 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Natural Language :: English
 Classifier: Topic :: Utilities
 Classifier: Topic :: Internet
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Dynamic: license-file
 
-[![Build Status](https://travis-ci.org/ProjectBabbler/ebird-api.svg?branch=master)](https://travis-ci.org/ProjectBabbler/ebird-api)
 [![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)
 
 # eBird API
 
-eBird API provides a set of wrapper functions for accessing the end-points
-in the eBird API 2.0.
+eBird API Requests provides a set of wrapper functions for accessing the
+end-points in the eBird API 2.0.
 
 ## Install
 
@@ -71,7 +69,7 @@ what you want to do - they will be interested to hear it.
 ```python
 import os
 
-from ebird.api import get_observations
+from ebird.api.requests import get_observations
 
 # Always store secrets outside the code, so you don't accidentally
 # commit them. Environment variables are ideal for this.
@@ -97,7 +95,7 @@ regions:
 ```python
 import os
 
-from ebird.api import get_observations
+from ebird.api.requests import get_observations
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -119,7 +117,7 @@ or taxonomy:
 ```python
 import os
 
-from ebird.api import get_observations
+from ebird.api.requests import get_observations
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -134,7 +132,7 @@ species:
 ```python
 import os
 
-from ebird.api import get_nearby_observations
+from ebird.api.requests import get_nearby_observations
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -151,7 +149,7 @@ a small number of species:
 ```python
 import os
 
-from ebird.api import (
+from ebird.api.requests import (
     get_notable_observations,
     get_nearby_notable,
     get_species_observations,
@@ -178,7 +176,7 @@ For the more travel-minded you can also find out the nearest place to see a give
 ```python
 import os
 
-from ebird.api import get_nearest_species
+from ebird.api.requests import get_nearest_species
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -199,7 +197,7 @@ checklist. You can then call get_checklist() to get the list of observations.
 ```python
 import os
 
-from ebird.api import get_visits, get_checklist
+from ebird.api.requests import get_visits, get_checklist
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -224,7 +222,7 @@ on the location of a given hotspot.
 ```python
 import os
 
-from ebird.api import get_hotspots, get_nearby_hotspots, get_hotspot
+from ebird.api.requests import get_hotspots, get_nearby_hotspots, get_hotspot
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -251,7 +249,7 @@ by a region use get_region().
 ```python
 import os
 
-from ebird.api import get_regions, get_adjacent_regions, get_region
+from ebird.api.requests import get_regions, get_adjacent_regions, get_region
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -282,7 +280,7 @@ that are used in the other API calls.
 ```python
 import os
 
-from ebird.api import get_taxonomy, get_taxonomy_forms, get_taxonomy_versions
+from ebird.api.requests import get_taxonomy, get_taxonomy_forms, get_taxonomy_versions
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -315,7 +313,7 @@ lots of people are out trying to get the greatest number of species.
 import os
 
 from datetime import date
-from ebird.api import get_top_100, get_totals
+from ebird.api.requests import get_top_100, get_totals
 
 api_key = os.environ["EBIRD_API_KEY"]
 
@@ -335,7 +333,7 @@ have to keep passing them as arguments.
 ```python
 import os
 
-from ebird.api import Client
+from ebird.api.requests import Client
 
 api_key = os.environ["EBIRD_API_KEY"]
 locale = 'es'
@@ -357,8 +355,8 @@ only returns JSON.
 
 ## Compatibility
 
-ebird-api works with currently supported versions of Python, 3.8+. However,
-it is known to work with earlier versions, at least 3.5 - 3.7, without any
+ebird-api works with currently supported versions of Python, 3.10+. However,
+it is known to work with earlier versions, at least 3.5 - 3.8, without any
 problems.
 
 ## Troubleshooting

ebird_api-4.1.0/src/ebird_api.egg-info/SOURCES.txt

@@ -0,0 +1,21 @@
+CHANGELOG.md
+LICENSE.txt
+README.md
+pyproject.toml
+setup.py
+src/ebird/api/requests/__init__.py
+src/ebird/api/requests/checklists.py
+src/ebird/api/requests/client.py
+src/ebird/api/requests/constants.py
+src/ebird/api/requests/hotspots.py
+src/ebird/api/requests/observations.py
+src/ebird/api/requests/regions.py
+src/ebird/api/requests/species.py
+src/ebird/api/requests/statistics.py
+src/ebird/api/requests/taxonomy.py
+src/ebird/api/requests/utils.py
+src/ebird/api/requests/validation.py
+src/ebird_api.egg-info/PKG-INFO
+src/ebird_api.egg-info/SOURCES.txt
+src/ebird_api.egg-info/dependency_links.txt
+src/ebird_api.egg-info/top_level.txt

ebird_api-3.4.2/src/ebird/api/__init__.py

@@ -1,35 +0,0 @@
-# flake8: noqa
-
-"""A set of wrapper functions for accessing the eBird API."""
-
-__version__ = "3.4.2"
-
-from ebird.api.checklists import get_checklist, get_visits
-from ebird.api.client import Client
-from ebird.api.constants import LOCALES
-from ebird.api.hotspots import (
-    get_hotspot,
-    get_hotspots,
-    get_location,
-    get_nearby_hotspots,
-)
-from ebird.api.observations import (
-    get_historic_observations,
-    get_nearby_notable,
-    get_nearby_observations,
-    get_nearby_species,
-    get_nearest_species,
-    get_notable_observations,
-    get_observations,
-    get_species_observations,
-)
-from ebird.api.regions import get_adjacent_regions, get_region, get_regions
-from ebird.api.species import get_species_list
-from ebird.api.statistics import get_top_100, get_totals
-from ebird.api.taxonomy import (
-    get_taxonomy,
-    get_taxonomy_forms,
-    get_taxonomy_groups,
-    get_taxonomy_locales,
-    get_taxonomy_versions,
-)

ebird_api-3.4.2/src/ebird_api.egg-info/SOURCES.txt

@@ -1,21 +0,0 @@
-CHANGELOG.md
-LICENSE.txt
-README.md
-pyproject.toml
-setup.py
-src/ebird/api/__init__.py
-src/ebird/api/checklists.py
-src/ebird/api/client.py
-src/ebird/api/constants.py
-src/ebird/api/hotspots.py
-src/ebird/api/observations.py
-src/ebird/api/regions.py
-src/ebird/api/species.py
-src/ebird/api/statistics.py
-src/ebird/api/taxonomy.py
-src/ebird/api/utils.py
-src/ebird/api/validation.py
-src/ebird_api.egg-info/PKG-INFO
-src/ebird_api.egg-info/SOURCES.txt
-src/ebird_api.egg-info/dependency_links.txt
-src/ebird_api.egg-info/top_level.txt