openepd 7.13.5__tar.gz → 7.14.0__tar.gz

{openepd-7.13.5 → openepd-7.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: openepd
-Version: 7.13.5
+Version: 7.14.0
 Summary: Python library to work with OpenEPD format
 License: Apache-2.0
 Author: C-Change Labs

{openepd-7.13.5 → openepd-7.14.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "openepd"
-version = "7.13.5"
+version = "7.14.0"
 license = "Apache-2.0"
 description = "Python library to work with OpenEPD format"
 authors = ["C-Change Labs <support@c-change-labs.com>"]

{openepd-7.13.5 → openepd-7.14.0}/src/openepd/__version__.py

@@ -13,4 +13,4 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 #
-VERSION = "7.13.5"
+VERSION = "7.14.0"

{openepd-7.13.5 → openepd-7.14.0}/src/openepd/model/common.py

@@ -14,7 +14,9 @@
 #  limitations under the License.
 #
 from enum import StrEnum
-from typing import Annotated, Any, Self
+import math
+import re
+from typing import Annotated, Any, Final, Self
 
 import pydantic
 import pydantic_core
@@ -30,6 +32,14 @@ in web pages as if they were external resources.
 The pattern matches the following format: data:[<media-type>][;base64],<data>
 """
 
+DATA_URL_IMAGE_MAX_LENGTH: Final[int] = math.ceil(32 * 1024 * 4 / 3)
+"""
+Maximum allowed length of a data URL image string to ensure the decoded image is less than 32KB.
+
+Base64 encoding overhead (approximately 33%) requires 
+limiting the encoded string length to 4/3 of the file size limit.
+"""
+
 
 class Amount(BaseOpenEpdSchema):
     """A value-and-unit pairing for amounts that do not have an uncertainty."""
@@ -372,3 +382,20 @@ class EnumGroupingAware:
     def get_groupings(cls) -> list[list]:
         """Return logical groupings of the values."""
         return []
+
+
+def validate_data_url(v: pydantic.AnyUrl | None, max_length: int) -> None:
+    """
+    Validate data URL.
+
+    :param v: data URL string.
+    :param max_length: maximum allowed length.
+    :raises ValueError: if the data URL exceeds the maximum length or has invalid format.
+    :return: None
+    """
+    if v and len(v) > max_length:
+        msg = f"URL must not exceed {max_length} characters"
+        raise ValueError(msg)
+    if v and v.scheme == "data" and not re.compile(DATA_URL_REGEX).match(str(v)):
+        msg = "Invalid data URL format"
+        raise ValueError(msg)

{openepd-7.13.5 → openepd-7.14.0}/src/openepd/model/declaration.py

@@ -16,14 +16,11 @@
 import abc
 import datetime
 from enum import StrEnum
-import math
-import re
-from typing import Final
 
 import pydantic
 
 from openepd.model.base import BaseOpenEpdSchema, OpenXpdUUID, RootDocument
-from openepd.model.common import DATA_URL_REGEX, Amount
+from openepd.model.common import DATA_URL_IMAGE_MAX_LENGTH, Amount, validate_data_url
 from openepd.model.geography import Geography
 from openepd.model.org import Org
 from openepd.model.pcr import Pcr
@@ -36,14 +33,6 @@ DEVELOPER_DESCRIPTION = "The organization responsible for the underlying LCA (an
 PROGRAM_OPERATOR_DESCRIPTION = "JSON object for program operator Org"
 THIRD_PARTY_VERIFIER_DESCRIPTION = "JSON object for Org that performed a critical review of the EPD data"
 
-PRODUCT_IMAGE_MAX_LENGTH: Final[int] = math.ceil(32 * 1024 * 4 / 3)
-"""
-Maximum length for product_image, product_image_small fields.
-
-Image file size must be less than 32KB. Base64 encoding overhead (approximately 33%) requires 
-limiting the encoded string length to 4/3 of the file size limit.
-"""
-
 
 class BaseDeclaration(RootDocument, abc.ABC):
     """Base class for declaration-related documents (EPDs, Industry-wide EPDs, Generic Estimates)."""
@@ -194,12 +183,7 @@ class BaseDeclaration(RootDocument, abc.ABC):
 
     @pydantic.field_validator("product_image", "product_image_small")
     def validate_product_image(cls, v: pydantic.AnyUrl | None) -> pydantic.AnyUrl | None:
-        if v and len(v) > PRODUCT_IMAGE_MAX_LENGTH:
-            msg = f"URL must not exceed {PRODUCT_IMAGE_MAX_LENGTH} characters"
-            raise ValueError(msg)
-        if v and v.scheme == "data" and not re.compile(DATA_URL_REGEX).match(str(v)):
-            msg = "Invalid data URL format"
-            raise ValueError(msg)
+        validate_data_url(v, DATA_URL_IMAGE_MAX_LENGTH)
         return v
 
 

{openepd-7.13.5 → openepd-7.14.0}/src/openepd/model/epd.py

@@ -16,7 +16,13 @@
 import pydantic
 
 from openepd.model.base import BaseDocumentFactory, OpenEpdDoctypes, OpenEpdExtension
-from openepd.model.common import Ingredient, WithAltIdsMixin, WithAttachmentsMixin
+from openepd.model.common import (
+    DATA_URL_IMAGE_MAX_LENGTH,
+    Ingredient,
+    WithAltIdsMixin,
+    WithAttachmentsMixin,
+    validate_data_url,
+)
 from openepd.model.declaration import (
     DEVELOPER_DESCRIPTION,
     PROGRAM_OPERATOR_DESCRIPTION,
@@ -243,6 +249,11 @@ class EpdPreviewV0(
         msg = "Invalid doctype"
         raise ValueError(msg)
 
+    @pydantic.field_validator("product_usage_image", "manufacturing_image")
+    def validate_product_usage_image(cls, v: pydantic.AnyUrl | None) -> pydantic.AnyUrl | None:
+        validate_data_url(v, DATA_URL_IMAGE_MAX_LENGTH)
+        return v
+
 
 EpdPreview = EpdPreviewV0
 

{openepd-7.13.5 → openepd-7.14.0}/src/openepd/model/org.py

@@ -13,26 +13,22 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 #
-import math
-import re
-from typing import Any, Final, Optional
+from typing import Any, Optional
 
 from openlocationcode import openlocationcode
 import pydantic
 from pydantic import ConfigDict
 
 from openepd.model.base import BaseOpenEpdSchema
-from openepd.model.common import DATA_URL_REGEX, Location, WithAltIdsMixin, WithAttachmentsMixin
+from openepd.model.common import (
+    DATA_URL_IMAGE_MAX_LENGTH,
+    Location,
+    WithAltIdsMixin,
+    WithAttachmentsMixin,
+    validate_data_url,
+)
 from openepd.model.validation.common import ReferenceStr
 
-ORG_LOGO_MAX_LENGTH: Final[int] = math.ceil(32 * 1024 * 4 / 3)
-"""
-Maximum length of Org.logo field.
-
-Logo file size must be less than 32KB. Base64 encoding overhead (approximately 33%) requires 
-limiting the encoded string length to 4/3 of the file size limit.
-"""
-
 
 class OrgRef(BaseOpenEpdSchema):
     """Represents Organisation with minimal data."""
@@ -142,12 +138,7 @@ class Org(WithAttachmentsMixin, WithAltIdsMixin, OrgRef):
 
     @pydantic.field_validator("logo")
     def _validate_logo(cls, v: pydantic.AnyUrl | None) -> pydantic.AnyUrl | None:
-        if v and len(v) > ORG_LOGO_MAX_LENGTH:
-            msg = f"Logo URL must not exceed {ORG_LOGO_MAX_LENGTH} characters"
-            raise ValueError(msg)
-        if v and v.scheme == "data" and not re.compile(DATA_URL_REGEX).match(str(v)):
-            msg = "Invalid data URL format"
-            raise ValueError(msg)
+        validate_data_url(v, DATA_URL_IMAGE_MAX_LENGTH)
         return v