ebird-api 3.1.0__tar.gz → 3.2.0__tar.gz

{ebird_api-3.1.0 → ebird_api-3.2.0}/CHANGELOG.md

@@ -8,6 +8,14 @@ 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/).
 
+## [3.2.0] - 2024-12-30
+- Add get_species_list which returns the list of codes for species seen
+  in a country, subnational1 are, subnational2 area or hotspot.
+
+## [3.1.1] - 2024-12-30
+## Changed
+- URLs calling the api are now in the form, https://api.ebird.org/v2/...
+
 ## [3.1.0] - 2024-12-30
 ### Added
 - get_taxonomy_locales which returns a list of all the languages

{ebird_api-3.1.0/src/ebird_api.egg-info → ebird_api-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ebird-api
-Version: 3.1.0
+Version: 3.2.0
 Summary: Wrapper for accessing the eBird API
 Author-email: Project Babbler <projectbabbler@gmail.com>
 License: MIT License

{ebird_api-3.1.0 → ebird_api-3.2.0}/pyproject.toml

@@ -30,7 +30,7 @@ license = {text = "MIT License"}
 name = "ebird-api"
 readme = "README.md"
 requires-python = ">= 3.8"
-version = "3.1.0"
+version = "3.2.0"
 
 [project.urls]
 Repository = "https://github.com/ProjectBabbler/ebird-api.git"
@@ -38,7 +38,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.1.0"
+current_version = "3.2.0"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 ignore_missing_version = false

{ebird_api-3.1.0 → ebird_api-3.2.0}/src/ebird/api/__init__.py

@@ -2,7 +2,7 @@
 
 """A set of wrapper functions for accessing the eBird API."""
 
-__version__ = "3.1.0"
+__version__ = "3.2.0"
 
 from ebird.api.checklists import get_checklist, get_visits
 from ebird.api.client import Client
@@ -19,6 +19,7 @@ from ebird.api.observations import (
     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,

{ebird_api-3.1.0 → ebird_api-3.2.0}/src/ebird/api/checklists.py

@@ -8,9 +8,9 @@ from ebird.api.validation import (
     clean_max_checklists,
 )
 
-CHECKLISTS_DATE_URL = "https://ebird.org/ws2.0/product/lists/%s/%s"
-CHECKLISTS_RECENT_URL = "https://ebird.org/ws2.0/product/lists/%s"
-CHECKLIST_URL = "https://ebird.org/ws2.0/product/checklist/view/%s"
+CHECKLISTS_DATE_URL = "https://api.ebird.org/v2/product/lists/%s/%s"
+CHECKLISTS_RECENT_URL = "https://api.ebird.org/v2/product/lists/%s"
+CHECKLIST_URL = "https://api.ebird.org/v2/product/checklist/view/%s"
 
 
 def get_visits(token, area, date=None, max_results=10):

{ebird_api-3.1.0 → ebird_api-3.2.0}/src/ebird/api/hotspots.py

@@ -10,9 +10,9 @@ from ebird.api.validation import (
     clean_region,
 )
 
-REGION_HOTSPOTS_URL = "https://ebird.org/ws2.0/ref/hotspot/%s"
-NEARBY_HOTSPOTS_URL = "https://ebird.org/ws2.0/ref/hotspot/geo"
-HOTSPOT_INFO_URL = "https://ebird.org/ws2.0/ref/hotspot/info/%s"
+REGION_HOTSPOTS_URL = "https://api.ebird.org/v2/ref/hotspot/%s"
+NEARBY_HOTSPOTS_URL = "https://api.ebird.org/v2/ref/hotspot/geo"
+HOTSPOT_INFO_URL = "https://api.ebird.org/v2/ref/hotspot/info/%s"
 
 
 def get_hotspots(token, region, back=None):

{ebird_api-3.1.0 → ebird_api-3.2.0}/src/ebird/api/observations.py

@@ -18,18 +18,18 @@ from ebird.api.validation import (
     clean_sort,
 )
 
-OBSERVATIONS_URL = "https://ebird.org/ws2.0/data/obs/%s/recent"
-NOTABLE_OBSERVATIONS_URL = "https://ebird.org/ws2.0/data/obs/%s/recent/notable"
-SPECIES_OBSERVATIONS_URL = "https://ebird.org/ws2.0/data/obs/%s/recent/%s"
+OBSERVATIONS_URL = "https://api.ebird.org/v2/data/obs/%s/recent"
+NOTABLE_OBSERVATIONS_URL = "https://api.ebird.org/v2/data/obs/%s/recent/notable"
+SPECIES_OBSERVATIONS_URL = "https://api.ebird.org/v2/data/obs/%s/recent/%s"
 
-NEARBY_OBSERVATIONS_URL = "https://ebird.org/ws2.0/data/obs/geo/recent"
-NEARBY_NOTABLE_URL = "https://ebird.org/ws2.0/data/obs/geo/recent/notable"
-NEARBY_SPECIES_URL = "https://ebird.org/ws2.0/data/obs/geo/recent/%s"
+NEARBY_OBSERVATIONS_URL = "https://api.ebird.org/v2/data/obs/geo/recent"
+NEARBY_NOTABLE_URL = "https://api.ebird.org/v2/data/obs/geo/recent/notable"
+NEARBY_SPECIES_URL = "https://api.ebird.org/v2/data/obs/geo/recent/%s"
 
 
-NEAREST_SPECIES_URL = "https://ebird.org/ws2.0/data/nearest/geo/recent/%s"
+NEAREST_SPECIES_URL = "https://api.ebird.org/v2/data/nearest/geo/recent/%s"
 
-HISTORIC_OBSERVATIONS_URL = "https://ebird.org/ws2.0/data/obs/%s/historic/%s"
+HISTORIC_OBSERVATIONS_URL = "https://api.ebird.org/v2/data/obs/%s/historic/%s"
 
 
 def get_observations(

{ebird_api-3.1.0 → ebird_api-3.2.0}/src/ebird/api/regions.py

@@ -3,9 +3,9 @@
 from ebird.api.utils import call
 from ebird.api.validation import clean_region, clean_region_type
 
-REGION_LIST_URL = "https://ebird.org/ws2.0/ref/region/list/%s/%s.json"
-ADJACENT_REGIONS_URL = "https://ebird.org/ws2.0/ref/adjacent/%s"
-REGION_INFO_URL = "https://ebird.org/ws2.0/ref/region/info/%s"
+REGION_LIST_URL = "https://api.ebird.org/v2/ref/region/list/%s/%s.json"
+ADJACENT_REGIONS_URL = "https://api.ebird.org/v2/ref/adjacent/%s"
+REGION_INFO_URL = "https://api.ebird.org/v2/ref/region/info/%s"
 
 
 def get_regions(token, rtype, region):

ebird_api-3.2.0/src/ebird/api/species.py

@@ -0,0 +1,37 @@
+"""Functions for fetching information about species."""
+
+from ebird.api.utils import call
+from ebird.api.validation import clean_area
+
+SPECIES_LIST_URL = "https://api.ebird.org/v2/product/spplist/%s"
+
+
+def get_species_list(token, area):
+    """
+    Get the list of species for an area.
+
+    The maps to the two end points in the eBird API 2.0,
+    https://documenter.getpostman.com/view/664302/S1ENwy59?version=latest#55bd1b26-6951-4a88-943a-d3a8aa1157dd
+
+    :param token: the token needed to access the API.
+
+    :param area: the code for a country, subnational1 region, subnational2
+    region or location.
+
+    :return: codes, e.g. horlar1, for the list of species observed in the area.
+
+    :raises ValueError: if any of the arguments fail the validation checks.
+
+    :raises URLError if there is an error with the connection to the
+    eBird site.
+
+    :raises HTTPError if the eBird API returns an error.
+
+    """
+    url = SPECIES_LIST_URL % clean_area(area)
+
+    headers = {
+        "X-eBirdApiToken": token,
+    }
+
+    return call(url, {}, headers)

{ebird_api-3.1.0 → ebird_api-3.2.0}/src/ebird/api/statistics.py

@@ -9,8 +9,8 @@ from ebird.api.validation import (
     clean_region,
 )
 
-TOP_100_URL = "https://ebird.org/ws2.0/product/top100/%s/%s"
-TOTALS_URL = "https://ebird.org/ws2.0/product/stats/%s/%s"
+TOP_100_URL = "https://api.ebird.org/v2/product/top100/%s/%s"
+TOTALS_URL = "https://api.ebird.org/v2/product/stats/%s/%s"
 
 
 def get_top_100(token, region, date, rank="spp", max_results=100):

{ebird_api-3.1.0 → ebird_api-3.2.0}/src/ebird/api/taxonomy.py

@@ -9,10 +9,10 @@ from ebird.api.validation import (
     clean_species_code,
 )
 
-TAXONOMY_URL = "https://ebird.org/ws2.0/ref/taxonomy/ebird"
-TAXONOMY_FORMS_URL = "https://ebird.org/ws2.0/ref/taxon/forms/%s"
-TAXONOMY_GROUPS_URL = "https://ebird.org/ws2.0/ref/sppgroup/%s"
-TAXONOMY_VERSIONS_URL = "https://ebird.org/ws2.0/ref/taxonomy/versions"
+TAXONOMY_URL = "https://api.ebird.org/v2/ref/taxonomy/ebird"
+TAXONOMY_FORMS_URL = "https://api.ebird.org/v2/ref/taxon/forms/%s"
+TAXONOMY_GROUPS_URL = "https://api.ebird.org/v2/ref/sppgroup/%s"
+TAXONOMY_VERSIONS_URL = "https://api.ebird.org/v2/ref/taxonomy/versions"
 TAXONOMY_LOCALES_URL = "https://api.ebird.org/v2/ref/taxa-locales/ebird"
 
 

{ebird_api-3.1.0 → ebird_api-3.2.0/src/ebird_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ebird-api
-Version: 3.1.0
+Version: 3.2.0
 Summary: Wrapper for accessing the eBird API
 Author-email: Project Babbler <projectbabbler@gmail.com>
 License: MIT License

{ebird_api-3.1.0 → ebird_api-3.2.0}/src/ebird_api.egg-info/SOURCES.txt

@@ -10,6 +10,7 @@ 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