destiny_sdk 0.7.2__tar.gz → 0.7.3__tar.gz

{destiny_sdk-0.7.2 → destiny_sdk-0.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: destiny_sdk
-Version: 0.7.2
+Version: 0.7.3
 Summary: A software development kit (sdk) to support interaction with the DESTINY repository
 Author-email: Adam Hamilton <adam@futureevidence.org>, Andrew Harvey <andrew@futureevidence.org>, Daniel Breves <daniel@futureevidence.org>, Jack Walmisley <jack@futureevidence.org>, Tim Repke <tim.repke@pik-potsdam.de>
 License-Expression: Apache-2.0

{destiny_sdk-0.7.2 → destiny_sdk-0.7.3}/pyproject.toml

@@ -35,7 +35,7 @@ license = "Apache-2.0"
 name = "destiny_sdk"
 readme = "README.md"
 requires-python = "~=3.12"
-version = "0.7.2"
+version = "0.7.3"
 
 [project.optional-dependencies]
 labs = []

{destiny_sdk-0.7.2 → destiny_sdk-0.7.3}/src/destiny_sdk/enhancements.py

@@ -1,6 +1,7 @@
 """Enhancement classes for the Destiny Repository."""
 
 import datetime
+import json
 from enum import StrEnum, auto
 from typing import Annotated, Any, Literal, Self
 
@@ -87,6 +88,10 @@ other works have cited this work
     created_date: datetime.date | None = Field(
         default=None, description="The ISO8601 date this metadata record was created"
     )
+    updated_date: datetime.date | None = Field(
+        default=None,
+        description="The ISO8601 date of the last OpenAlex update to this metadata",
+    )
     publication_date: datetime.date | None = Field(
         default=None, description="The date which the version of record was published."
     )
@@ -100,6 +105,20 @@ other works have cited this work
     )
     title: str | None = Field(default=None, description="The title of the reference.")
 
+    @property
+    def fingerprint(self) -> str:
+        """
+        The fingerprint of this bibliographic metadata enhancement.
+
+        Excludes updated_at from the fingerprint calculation, meaning
+        that two raw enhancements with identical data but different export dates
+        will be considered the same.
+        """
+        return json.dumps(
+            self.model_dump(mode="json", exclude={"updated_date"}, exclude_none=True),
+            sort_keys=True,
+        )
+
 
 class AbstractProcessType(StrEnum):
     """The process used to acquire the abstract."""
@@ -332,6 +351,25 @@ class RawEnhancement(BaseModel):
             raise ValueError(msg)
         return self
 
+    @property
+    def fingerprint(self) -> str:
+        """
+        The unique fingerprint of this raw enhancement.
+
+        Excludes the source_export_date from the fingerprint calculation, meaning
+        that two raw enhancements with identical data but different export dates
+        will be considered the same.
+
+        Unstructured data in `data` and `metadata` is included in the fingerprint,
+        sorted by key.
+        """
+        return json.dumps(
+            self.model_dump(
+                mode="json", exclude={"source_export_date"}, exclude_none=True
+            ),
+            sort_keys=True,
+        )
+
 
 #: Union type for all enhancement content types.
 EnhancementContent = Annotated[