ebird-api-data 0.3.4__tar.gz → 0.3.6__tar.gz

{ebird_api_data-0.3.4 → ebird_api_data-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ebird-api-data
-Version: 0.3.4
+Version: 0.3.6
 Summary: eBird API Data is a reusable Django app for loading data from eBird into a database.
 Author-email: Stuart MacKay <smackay@flagstonesoftware.com>
 License-Expression: MIT

{ebird_api_data-0.3.4 → ebird_api_data-0.3.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ebird-api-data"
-version = "0.3.4"
+version = "0.3.6"
 description = "eBird API Data is a reusable Django app for loading data from eBird into a database."
 keywords = ["checklists", "observations", "species", "Django", "eBird", "models"]
 license = "MIT"
@@ -65,7 +65,7 @@ dev-dependencies = [
 ]
 
 [tool.bumpversion]
-current_version = "0.3.4"
+current_version = "0.3.6"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 ignore_missing_version = false

ebird_api_data-0.3.6/src/ebird/api/data/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.3.6"

{ebird_api_data-0.3.4 → ebird_api_data-0.3.6}/src/ebird/api/data/admin.py

@@ -49,7 +49,7 @@ class ProtocolListFilter(admin.SimpleListFilter):
     parameter_name = "protocol_code"
 
     def lookups(self, request, model_admin):
-        return Checklist.Protocol.choices
+        return [(key, value) for key, value in Checklist.Protocol.NAMES.items()]
 
     def queryset(self, request, queryset):
         if value := self.value():

{ebird_api_data-0.3.4 → ebird_api_data-0.3.6}/src/ebird/api/data/loaders.py

@@ -396,7 +396,7 @@ class APILoader:
             if area := data.get("effortAreaHa"):
                 values["area"] = round(Decimal(area), 3)
 
-            if data["protocolId"] not in Checklist.Protocol.values:
+            if data["protocolId"] not in Checklist.Protocol.NAMES.keys():
                 logger.info("New protocol: %s", data["protocolId"])
 
             if "comments" in data:

{ebird_api_data-0.3.4 → ebird_api_data-0.3.6}/src/ebird/api/data/locale/en/LC_MESSAGES/django.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-07-10 14:08+0000\n"
+"POT-Creation-Date: 2025-07-26 08:37+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -17,6 +17,7 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
 #: admin.py:26
 msgid "Observation"
 msgstr ""
@@ -29,216 +30,268 @@ msgstr ""
 msgid "Scientific name"
 msgstr ""
 
-#: admin.py:157 admin.py:280
-msgid "Name / Byname"
+#: admin.py:48
+msgid "protocol"
 msgstr ""
 
-#: admin.py:248 models/species.py:16
+#: admin.py:256 models/species.py:15
 msgid "Species"
 msgstr ""
 
-#: admin.py:297
+#: admin.py:301
 msgid "The eBird code for the species, e.g. cangoo, for Canada Goose."
 msgstr ""
 
-#: apps.py:8 models/checklist.py:168 models/location.py:143
-#: models/observation.py:167 models/observer.py:38 models/species.py:86
+#: apps.py:8 models/checklist.py:197 models/location.py:144
+#: models/observation.py:168 models/observer.py:40 models/species.py:90
 msgid "Data"
 msgstr ""
 
-#: models/checklist.py:7 models/observation.py:41
+#: models/checklist.py:19
+msgid "Incidental"
+msgstr ""
+
+#: models/checklist.py:20
+msgid "Stationary"
+msgstr ""
+
+#: models/checklist.py:21
+msgid "Traveling"
+msgstr ""
+
+#: models/checklist.py:22
+msgid "Area"
+msgstr ""
+
+#: models/checklist.py:23
+msgid "Banding"
+msgstr ""
+
+#: models/checklist.py:24
+msgid "Nocturnal Flight Call Count"
+msgstr ""
+
+#: models/checklist.py:25
+msgid "Pelagic"
+msgstr ""
+
+#: models/checklist.py:26
+msgid "Historical"
+msgstr ""
+
+#: models/checklist.py:27
+msgid "Common Bird Survey"
+msgstr ""
+
+#: models/checklist.py:28
+msgid "Stationary (directional)"
+msgstr ""
+
+#: models/checklist.py:32 models/observation.py:42
 msgid "checklist"
 msgstr ""
 
-#: models/checklist.py:8
+#: models/checklist.py:33
 msgid "checklists"
 msgstr ""
 
-#: models/checklist.py:13
+#: models/checklist.py:38
 msgid "The date and time the checklist was added to eBird."
 msgstr ""
 
-#: models/checklist.py:14
-msgid "created"
+#: models/checklist.py:39
+msgid "added"
 msgstr ""
 
-#: models/checklist.py:20 models/observation.py:22
+#: models/checklist.py:45 models/observation.py:22
 msgid "The date and time the eBird checklist was last edited."
 msgstr ""
 
-#: models/checklist.py:21 models/observation.py:23
+#: models/checklist.py:46 models/observation.py:23
 msgid "edited"
 msgstr ""
 
-#: models/checklist.py:25
+#: models/checklist.py:50
 msgid "Is the checklist published?"
 msgstr ""
 
-#: models/checklist.py:26 models/observation.py:28
+#: models/checklist.py:51 models/observation.py:28
 msgid "published"
 msgstr ""
 
-#: models/checklist.py:31 models/location.py:69 models/observation.py:33
-#: models/observer.py:11
+#: models/checklist.py:57 models/location.py:70 models/observation.py:34
+#: models/observer.py:13
 msgid "identifier"
 msgstr ""
 
-#: models/checklist.py:32
+#: models/checklist.py:58
 msgid "The unique identifier for the checklist."
 msgstr ""
 
-#: models/checklist.py:39 models/country.py:7 models/location.py:87
-#: models/observation.py:65
+#: models/checklist.py:65 models/country.py:7 models/location.py:88
+#: models/observation.py:66
 msgid "country"
 msgstr ""
 
-#: models/checklist.py:40
+#: models/checklist.py:66
 msgid "The country where the checklist was made."
 msgstr ""
 
-#: models/checklist.py:47 models/location.py:95 models/observation.py:73
+#: models/checklist.py:73 models/location.py:96 models/observation.py:74
 #: models/state.py:7
 msgid "state"
 msgstr ""
 
-#: models/checklist.py:48
+#: models/checklist.py:74
 msgid "The state where the checklist was made."
 msgstr ""
 
-#: models/checklist.py:57 models/county.py:7 models/location.py:105
-#: models/observation.py:83
+#: models/checklist.py:83 models/county.py:7 models/location.py:106
+#: models/observation.py:84
 msgid "county"
 msgstr ""
 
-#: models/checklist.py:58
+#: models/checklist.py:84
 msgid "The county where the checklist was made."
 msgstr ""
 
-#: models/checklist.py:65 models/filter.py:39 models/location.py:64
-#: models/observation.py:91
+#: models/checklist.py:91 models/filter.py:39 models/location.py:64
+#: models/observation.py:92
 msgid "location"
 msgstr ""
 
-#: models/checklist.py:66
+#: models/checklist.py:92
 msgid "The location where checklist was made."
 msgstr ""
 
-#: models/checklist.py:73 models/observation.py:57 models/observer.py:7
+#: models/checklist.py:99 models/observation.py:58 models/observer.py:7
 msgid "observer"
 msgstr ""
 
-#: models/checklist.py:74
+#: models/checklist.py:100
 msgid "The person who submitted the checklist."
 msgstr ""
 
-#: models/checklist.py:80
+#: models/checklist.py:106
 msgid "observer count"
 msgstr ""
 
-#: models/checklist.py:81
+#: models/checklist.py:107
 msgid "The total number of observers."
 msgstr ""
 
-#: models/checklist.py:87
+#: models/checklist.py:113
 msgid "species count"
 msgstr ""
 
-#: models/checklist.py:88
+#: models/checklist.py:114
 msgid "The number of species reported."
 msgstr ""
 
-#: models/checklist.py:93 models/observation.py:97
+#: models/checklist.py:119 models/observation.py:98
 msgid "date"
 msgstr ""
 
-#: models/checklist.py:94
+#: models/checklist.py:120
 msgid "The date the checklist was started."
 msgstr ""
 
-#: models/checklist.py:100 models/observation.py:104
+#: models/checklist.py:126 models/observation.py:105
 msgid "time"
 msgstr ""
 
-#: models/checklist.py:101
+#: models/checklist.py:127
 msgid "The time the checklist was started."
 msgstr ""
 
-#: models/checklist.py:108 models/observation.py:112
+#: models/checklist.py:134 models/observation.py:113
 msgid "date & time"
 msgstr ""
 
-#: models/checklist.py:109
+#: models/checklist.py:135
 msgid "The date and time the checklist was started."
 msgstr ""
 
-#: models/checklist.py:114
+#: models/checklist.py:140
 msgid "protocol code"
 msgstr ""
 
-#: models/checklist.py:115
+#: models/checklist.py:141
 msgid "The code used to identify the protocol."
 msgstr ""
 
-#: models/checklist.py:120
+#: models/checklist.py:149
 msgid "project code"
 msgstr ""
 
-#: models/checklist.py:121
+#: models/checklist.py:150
 msgid "The code used to identify the project (portal)."
 msgstr ""
 
-#: models/checklist.py:127
+#: models/checklist.py:156
 msgid "duration"
 msgstr ""
 
-#: models/checklist.py:128
+#: models/checklist.py:157
 msgid "The number of minutes spent counting."
 msgstr ""
 
-#: models/checklist.py:136
+#: models/checklist.py:165
 msgid "distance"
 msgstr ""
 
-#: models/checklist.py:137
-msgid "The distance, in metres, covered while travelling."
+#: models/checklist.py:166
+msgid "The distance, in kilometres, covered while travelling."
 msgstr ""
 
-#: models/checklist.py:145
+#: models/checklist.py:174
 msgid "area"
 msgstr ""
 
-#: models/checklist.py:146
+#: models/checklist.py:175
 msgid "The area covered, in hectares."
 msgstr ""
 
-#: models/checklist.py:151
+#: models/checklist.py:180
 msgid "complete"
 msgstr ""
 
-#: models/checklist.py:152
+#: models/checklist.py:181
 msgid "All species seen are reported."
 msgstr ""
 
-#: models/checklist.py:157 models/observation.py:156
+#: models/checklist.py:186 models/observation.py:157
 msgid "comments"
 msgstr ""
 
-#: models/checklist.py:158
+#: models/checklist.py:187
 msgid "Any comments about the checklist."
 msgstr ""
 
-#: models/checklist.py:163 models/location.py:131
+#: models/checklist.py:192 models/location.py:132
 msgid "url"
 msgstr ""
 
-#: models/checklist.py:164
+#: models/checklist.py:193
 msgid "URL where the original checklist can be viewed."
 msgstr ""
 
-#: models/checklist.py:169
+#: models/checklist.py:198
 msgid "Data describing a Checklist."
 msgstr ""
 
+#: models/checklist.py:204 models/country.py:26 models/county.py:26
+#: models/filter.py:52 models/location.py:151 models/observation.py:175
+#: models/observer.py:47 models/species.py:97 models/state.py:26
+msgid "When was the record created."
+msgstr ""
+
+#: models/checklist.py:208 models/country.py:30 models/county.py:30
+#: models/filter.py:56 models/location.py:155 models/observation.py:179
+#: models/observer.py:51 models/species.py:101 models/state.py:30
+msgid "When was the record updated."
+msgstr ""
+
 #: models/country.py:8
 msgid "countries"
 msgstr ""
@@ -252,7 +305,7 @@ msgid "The code used to identify the country."
 msgstr ""
 
 #: models/country.py:18 models/county.py:18 models/filter.py:22
-#: models/location.py:79 models/observer.py:16 models/state.py:18
+#: models/location.py:80 models/observer.py:18 models/state.py:18
 msgid "name"
 msgstr ""
 
@@ -304,8 +357,8 @@ msgstr ""
 msgid "The name of the filter."
 msgstr ""
 
-#: models/filter.py:29 models/observation.py:49 models/species.py:22
-#: models/species.py:23
+#: models/filter.py:29 models/observation.py:50 models/species.py:25
+#: models/species.py:26
 msgid "species"
 msgstr ""
 
@@ -329,63 +382,63 @@ msgstr ""
 msgid "locations"
 msgstr ""
 
-#: models/location.py:70
+#: models/location.py:71
 msgid "The unique identifier for the location."
 msgstr ""
 
-#: models/location.py:74 models/observer.py:21
+#: models/location.py:75 models/observer.py:23
 msgid "original name"
 msgstr ""
 
-#: models/location.py:75
+#: models/location.py:76
 msgid "The original name of the location from eBird."
 msgstr ""
 
-#: models/location.py:80
+#: models/location.py:81
 msgid "The display name of the location."
 msgstr ""
 
-#: models/location.py:88
+#: models/location.py:89
 msgid "The country for the location."
 msgstr ""
 
-#: models/location.py:96
+#: models/location.py:97
 msgid "The state for the location."
 msgstr ""
 
-#: models/location.py:106
+#: models/location.py:107
 msgid "The county for the location."
 msgstr ""
 
-#: models/location.py:114
+#: models/location.py:115
 msgid "latitude"
 msgstr ""
 
-#: models/location.py:115
+#: models/location.py:116
 msgid "The decimal latitude of the location, relative to the equator."
 msgstr ""
 
-#: models/location.py:123
+#: models/location.py:124
 msgid "longitude"
 msgstr ""
 
-#: models/location.py:125
+#: models/location.py:126
 msgid "The decimal longitude of the location, relative to the prime meridian."
 msgstr ""
 
-#: models/location.py:132
+#: models/location.py:133
 msgid "URL of the location page on eBird."
 msgstr ""
 
-#: models/location.py:138
+#: models/location.py:139
 msgid "is hotspot"
 msgstr ""
 
-#: models/location.py:139
+#: models/location.py:140
 msgid "Is the location a hotspot."
 msgstr ""
 
-#: models/location.py:144
+#: models/location.py:145
 msgid "Data describing a Location."
 msgstr ""
 
@@ -401,111 +454,111 @@ msgstr ""
 msgid "Is the observation published?"
 msgstr ""
 
-#: models/observation.py:34
+#: models/observation.py:35
 msgid "A global unique identifier for the observation."
 msgstr ""
 
-#: models/observation.py:42
+#: models/observation.py:43
 msgid "The checklist this observation belongs to."
 msgstr ""
 
-#: models/observation.py:50
+#: models/observation.py:51
 msgid "The identified species."
 msgstr ""
 
-#: models/observation.py:58
+#: models/observation.py:59
 msgid "The person who made the observation."
 msgstr ""
 
-#: models/observation.py:66
+#: models/observation.py:67
 msgid "The country where the observation was made."
 msgstr ""
 
-#: models/observation.py:74
+#: models/observation.py:75
 msgid "The state where the observation was made."
 msgstr ""
 
-#: models/observation.py:84
+#: models/observation.py:85
 msgid "The county where the observation was made."
 msgstr ""
 
-#: models/observation.py:92
+#: models/observation.py:93
 msgid "The location where the observation was made."
 msgstr ""
 
-#: models/observation.py:98
+#: models/observation.py:99
 msgid "The date the observation was made."
 msgstr ""
 
-#: models/observation.py:105
+#: models/observation.py:106
 msgid "The time the observation was made."
 msgstr ""
 
-#: models/observation.py:113
+#: models/observation.py:114
 msgid "The date and time the observation was made."
 msgstr ""
 
-#: models/observation.py:118
+#: models/observation.py:119
 msgid "count"
 msgstr ""
 
-#: models/observation.py:119
+#: models/observation.py:120
 msgid "The number of birds seen."
 msgstr ""
 
-#: models/observation.py:124
+#: models/observation.py:125
 msgid "has audio"
 msgstr ""
 
-#: models/observation.py:125
+#: models/observation.py:126
 msgid "Have audio recordings been uploaded to the Macaulay library."
 msgstr ""
 
-#: models/observation.py:130
+#: models/observation.py:131
 msgid "has photos"
 msgstr ""
 
-#: models/observation.py:131
+#: models/observation.py:132
 msgid "Have photos been uploaded to the Macaulay library."
 msgstr ""
 
-#: models/observation.py:136
+#: models/observation.py:137
 msgid "has video"
 msgstr ""
 
-#: models/observation.py:137
+#: models/observation.py:138
 msgid "Have video recordings been uploaded to the Macaulay library."
 msgstr ""
 
-#: models/observation.py:142
+#: models/observation.py:143
 msgid "Approved"
 msgstr ""
 
-#: models/observation.py:143
+#: models/observation.py:144
 msgid "Has the observation been accepted."
 msgstr ""
 
-#: models/observation.py:148
+#: models/observation.py:149
 msgid "Reason"
 msgstr ""
 
-#: models/observation.py:150
+#: models/observation.py:151
 msgid "The reason given for the observation to be marked as not approved."
 msgstr ""
 
-#: models/observation.py:157
+#: models/observation.py:158
 msgid "Any comments about the observation."
 msgstr ""
 
-#: models/observation.py:162
+#: models/observation.py:163
 msgid "URN"
 msgstr ""
 
-#: models/observation.py:163
+#: models/observation.py:164
 msgid "The globally unique identifier for the observation."
 msgstr ""
 
-#: models/observation.py:168
+#: models/observation.py:169
 msgid "Data describing an Observation."
 msgstr ""
 
@@ -513,40 +566,40 @@ msgstr ""
 msgid "observers"
 msgstr ""
 
-#: models/observer.py:12
+#: models/observer.py:14
 msgid "The code for the person submitted the checklist."
 msgstr ""
 
-#: models/observer.py:17
+#: models/observer.py:19
 msgid "The display name of the observer."
 msgstr ""
 
-#: models/observer.py:22
+#: models/observer.py:24
 msgid "The original name of the observer from eBird."
 msgstr ""
 
-#: models/observer.py:27
+#: models/observer.py:29
 msgid "Multiple accounts"
 msgstr ""
 
-#: models/observer.py:28
+#: models/observer.py:30
 msgid "Is the name used by more than one eBird account."
 msgstr ""
 
-#: models/observer.py:33
+#: models/observer.py:35
 msgid "Enabled"
 msgstr ""
 
-#: models/observer.py:34
+#: models/observer.py:36
 msgid "Load checklists from the eBird observer."
 msgstr ""
 
-#: models/observer.py:39
+#: models/observer.py:41
 msgid "Data describing an Observer."
 msgstr ""
 
-#: models/species.py:15
-msgid "All categories"
+#: models/species.py:16
+msgid "Species pairs"
 msgstr ""
 
 #: models/species.py:17
@@ -554,87 +607,99 @@ msgid "Subspecies"
 msgstr ""
 
 #: models/species.py:18
-msgid "Domestic"
+msgid "Domestic species"
 msgstr ""
 
 #: models/species.py:19
-msgid "Hybrid"
+msgid "Hybrids"
+msgstr ""
+
+#: models/species.py:20
+msgid "Species forms"
 msgstr ""
 
-#: models/species.py:28
+#: models/species.py:21
+msgid "Unidentified species"
+msgstr ""
+
+#: models/species.py:22
+msgid "Intergrades"
+msgstr ""
+
+#: models/species.py:31
 msgid "taxonomy order"
 msgstr ""
 
-#: models/species.py:29
+#: models/species.py:32
 msgid "The position in the eBird/Clements taxonomic order."
 msgstr ""
 
-#: models/species.py:34
+#: models/species.py:37
 msgid "order"
 msgstr ""
 
-#: models/species.py:36
+#: models/species.py:39
 msgid "The order, e.g. Struthioniformes, from the eBird/Clements taxonomy."
 msgstr ""
 
-#: models/species.py:43
+#: models/species.py:46
 msgid "category"
 msgstr ""
 
-#: models/species.py:44
+#: models/species.py:47
 msgid "The category from the eBird/Clements taxonomy."
 msgstr ""
 
-#: models/species.py:49
+#: models/species.py:53
 msgid "species code"
 msgstr ""
 
-#: models/species.py:50
+#: models/species.py:54
 msgid "The species code, e.g. ostric2, used in the eBird API."
 msgstr ""
 
-#: models/species.py:55
+#: models/species.py:59
 msgid "family code"
 msgstr ""
 
-#: models/species.py:56
+#: models/species.py:60
 msgid "The family code, e.g. struth1, used in the eBird API."
 msgstr ""
 
-#: models/species.py:60
+#: models/species.py:64
 msgid "common name"
 msgstr ""
 
-#: models/species.py:61
+#: models/species.py:65
 msgid "The species common name in the eBird/Clements taxonomy."
 msgstr ""
 
-#: models/species.py:65
+#: models/species.py:69
 msgid "scientific name"
 msgstr ""
 
-#: models/species.py:66
+#: models/species.py:70
 msgid "The species scientific name in the eBird/Clements taxonomy."
 msgstr ""
 
-#: models/species.py:71
+#: models/species.py:75
 msgid "family common name"
 msgstr ""
 
-#: models/species.py:73
+#: models/species.py:77
 msgid "The common name for the species family in the eBird/Clements taxonomy."
 msgstr ""
 
-#: models/species.py:79
+#: models/species.py:83
 msgid "family scientific name"
 msgstr ""
 
-#: models/species.py:81
+#: models/species.py:85
 msgid ""
 "The scientific name for the species family in the eBird/Clements taxonomy."
 msgstr ""
 
-#: models/species.py:87
+#: models/species.py:91
 msgid "Data describing a Species."
 msgstr ""
 

{ebird_api_data-0.3.4 → ebird_api_data-0.3.6}/src/ebird/api/data/models/checklist.py

@@ -1,20 +1,19 @@
+from enum import StrEnum
+
 from django.db import models
 from django.utils.translation import gettext_lazy as _
 
 
 class Checklist(models.Model):
-    class Protocol(models.TextChoices):
-        INCIDENTAL = "P20", _("Incidental")
-        STATIONARY = "P21", _("Stationary")
-        TRAVELLING = "P22", _("Travelling")
-        AREA = "P23", _("Area")
-        BANDING = "P33", _("Banding")
-        NOCTURNAL = "P54", _("Nocturnal Flight Call Count")
-        PELAGIC = "P60", _("Pelagic")
-        HISTORICAL = "P62", _("Historical")
-        BREEDING_BIRD_ATLAS = "P65", _("Breeding Bird Atlas")
-        COMMON_BIRD_SURVEY = "P67", _("Common Bird Survey")
-        RAM = "P68", _("RAM--Iberian Seawatch Network")
+    class Protocol(StrEnum):
+        INCIDENTAL = "P20"
+        STATIONARY = "P21"
+        TRAVELING = "P22"
+        AREA = "P23"
+        BANDING = "P33"
+        NOCTURNAL = "P54"
+        PELAGIC = "P60"
+        HISTORICAL = "P62"
 
     class Meta:
         verbose_name = _("checklist")
@@ -129,9 +128,6 @@ class Checklist(models.Model):
         help_text=_("The code used to identify the protocol."),
     )
 
-    # Protocol is not used to set the choices, as we still want to load
-    # the checklist when a protocol not defined in the class is used.
-
     project_code = models.TextField(
         blank=True,
         verbose_name=_("project code"),
@@ -201,8 +197,3 @@ class Checklist(models.Model):
 
     def __str__(self) -> str:
         return str(self.identifier)
-
-    def get_protocol(self):
-        if self.protocol_code:
-            return self.Protocol(self.protocol_code).label if self.protocol_code else ""
-        return ""

ebird_api_data-0.3.4/src/ebird/api/data/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.3.4"