openepd 6.13.2__tar.gz → 7.0.1__tar.gz

{openepd-6.13.2 → openepd-7.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: openepd
-Version: 6.13.2
+Version: 7.0.1
 Summary: Python library to work with OpenEPD format
 Home-page: https://github.com/cchangelabs/openepd
 License: Apache-2.0
@@ -21,7 +21,7 @@ Requires-Dist: email-validator (>=1.3.1)
 Requires-Dist: idna (>=3.7)
 Requires-Dist: open-xpd-uuid (>=0.2.1,<0.3.0)
 Requires-Dist: openlocationcode (>=1.0.1)
-Requires-Dist: pydantic (>=1.10,<3.0)
+Requires-Dist: pydantic (>=2.0,<3)
 Requires-Dist: requests (>=2.0) ; extra == "api-client"
 Project-URL: Repository, https://github.com/cchangelabs/openepd
 Description-Content-Type: text/markdown

{openepd-6.13.2 → openepd-7.0.1}/pyproject.toml

@@ -1,6 +1,11 @@
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+exclude = [".*pyi"]
+
 [tool.poetry]
 name = "openepd"
-version = "6.13.2"
+version = "7.0.1"
 license = "Apache-2.0"
 description = "Python library to work with OpenEPD format"
 authors = ["C-Change Labs <support@c-change-labs.com>"]
@@ -21,7 +26,7 @@ exclude = ["**/test_*.py", "**/tests/**"]
 
 [tool.poetry.dependencies]
 python = "^3.11"
-pydantic = ">=1.10,<3.0"
+pydantic = ">=2.0,<3"
 email-validator = ">=1.3.1"
 requests = { version = ">=2.0", optional = true }
 idna = ">=3.7"

openepd-7.0.1/src/openepd/__version__.py

@@ -0,0 +1,16 @@
+#
+#  Copyright 2025 by C Change Labs Inc. www.c-change-labs.com
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+#
+VERSION = "7.0.1"

{openepd-6.13.2 → openepd-7.0.1}/src/openepd/api/average_dataset/generic_estimate_sync_api.py

@@ -52,8 +52,8 @@ class GenericEstimateApi(BaseApiMethodGroup):
         """
         response = self._client.do_request("get", f"/generic_estimates/{uuid}")
         if with_response:
-            return GenericEstimate.parse_obj(response.json()), response
-        return GenericEstimate.parse_obj(response.json())
+            return GenericEstimate.model_validate(response.json()), response
+        return GenericEstimate.model_validate(response.json())
 
     @overload
     def post_with_refs(
@@ -88,8 +88,8 @@ class GenericEstimateApi(BaseApiMethodGroup):
         )
         content = response.json()
         if with_response:
-            return GenericEstimate.parse_obj(content), response
-        return GenericEstimate.parse_obj(content)
+            return GenericEstimate.model_validate(content), response
+        return GenericEstimate.model_validate(content)
 
     @overload
     def create(self, ge: GenericEstimate, with_response: Literal[True]) -> tuple[GenericEstimateRef, Response]: ...
@@ -114,8 +114,8 @@ class GenericEstimateApi(BaseApiMethodGroup):
         )
         content = response.json()
         if with_response:
-            return GenericEstimateRef.parse_obj(content), response
-        return GenericEstimateRef.parse_obj(content)
+            return GenericEstimateRef.model_validate(content), response
+        return GenericEstimateRef.model_validate(content)
 
     @overload
     def edit(self, ge: GenericEstimate, with_response: Literal[True]) -> tuple[GenericEstimateRef, Response]: ...
@@ -144,8 +144,8 @@ class GenericEstimateApi(BaseApiMethodGroup):
         )
         content = response.json()
         if with_response:
-            return GenericEstimateRef.parse_obj(content), response
-        return GenericEstimateRef.parse_obj(content)
+            return GenericEstimateRef.model_validate(content), response
+        return GenericEstimateRef.model_validate(content)
 
     @overload
     def list_raw(
@@ -177,7 +177,7 @@ class GenericEstimateApi(BaseApiMethodGroup):
                 page_size=page_size,
             ),
         )
-        data = [GenericEstimatePreview.parse_obj(o) for o in response.json()]
+        data = [GenericEstimatePreview.model_validate(o) for o in response.json()]
         if with_response:
             return data, response
         return data
@@ -193,7 +193,8 @@ class GenericEstimateApi(BaseApiMethodGroup):
         def _get_page(p_num: int, p_size: int) -> GenericEstimateListResponse:
             data_list, response = self.list_raw(page_num=p_num, page_size=p_size, with_response=True)
             return GenericEstimateListResponse(
-                payload=data_list, meta=GenericEstimateSearchMeta(paging=paging_meta_from_v1_api(response))
+                payload=data_list,
+                meta=GenericEstimateSearchMeta(paging=paging_meta_from_v1_api(response)),
             )
 
         return StreamingListResponse[GenericEstimatePreview](_get_page, page_size=page_size)

{openepd-6.13.2 → openepd-7.0.1}/src/openepd/api/average_dataset/industry_epd_sync_api.py

@@ -45,8 +45,8 @@ class IndustryEpdApi(BaseApiMethodGroup):
         """
         response = self._client.do_request("get", f"/industry_epds/{uuid}")
         if with_response:
-            return IndustryEpd.parse_obj(response.json()), response
-        return IndustryEpd.parse_obj(response.json())
+            return IndustryEpd.model_validate(response.json()), response
+        return IndustryEpd.model_validate(response.json())
 
     @overload
     def create(self, iepd: IndustryEpd, with_response: Literal[True]) -> tuple[IndustryEpdRef, Response]: ...
@@ -71,8 +71,8 @@ class IndustryEpdApi(BaseApiMethodGroup):
         )
         content = response.json()
         if with_response:
-            return IndustryEpdRef.parse_obj(content), response
-        return IndustryEpdRef.parse_obj(content)
+            return IndustryEpdRef.model_validate(content), response
+        return IndustryEpdRef.model_validate(content)
 
     @overload
     def edit(self, iepd: IndustryEpd, with_response: Literal[True]) -> tuple[IndustryEpdRef, Response]: ...
@@ -99,8 +99,8 @@ class IndustryEpdApi(BaseApiMethodGroup):
         )
         content = response.json()
         if with_response:
-            return IndustryEpdRef.parse_obj(content), response
-        return IndustryEpdRef.parse_obj(content)
+            return IndustryEpdRef.model_validate(content), response
+        return IndustryEpdRef.model_validate(content)
 
     @overload
     def list_raw(
@@ -131,7 +131,7 @@ class IndustryEpdApi(BaseApiMethodGroup):
                 page_size=page_size,
             ),
         )
-        data = [IndustryEpdPreview.parse_obj(o) for o in response.json()]
+        data = [IndustryEpdPreview.model_validate(o) for o in response.json()]
         if with_response:
             return data, response
         return data
@@ -147,7 +147,8 @@ class IndustryEpdApi(BaseApiMethodGroup):
         def _get_page(p_num: int, p_size: int) -> IndustryEpdListResponse:
             data_list, response = self.list_raw(page_num=p_num, page_size=p_size, with_response=True)
             return IndustryEpdListResponse(
-                payload=data_list, meta=IndustryEpdSearchMeta(paging=paging_meta_from_v1_api(response))
+                payload=data_list,
+                meta=IndustryEpdSearchMeta(paging=paging_meta_from_v1_api(response)),
             )
 
         return StreamingListResponse[IndustryEpdPreview](_get_page, page_size=page_size)

{openepd-6.13.2 → openepd-7.0.1}/src/openepd/api/base_sync_client.py

@@ -238,7 +238,12 @@ class SyncHttpClient:
         return content
 
     def read_url_write_to_stream(
-        self, url: str, target_stream: IO[bytes], method: str = "get", chunk_size: int = 1024, **kwargs
+        self,
+        url: str,
+        target_stream: IO[bytes],
+        method: str = "get",
+        chunk_size: int = 1024,
+        **kwargs,
     ) -> int:
         """
         Perform query to the given endpoint and writes response body to the given stream.
@@ -327,7 +332,12 @@ class SyncHttpClient:
                     )
                     if timeout > left_time:
                         return resp
-                    logger.info("`%s %s` has been throttled for %s second(s)", method, url, timeout)
+                    logger.info(
+                        "`%s %s` has been throttled for %s second(s)",
+                        method,
+                        url,
+                        timeout,
+                    )
                     time.sleep(timeout)
                     left_time -= timeout
                     if left_time > 0:
@@ -374,7 +384,13 @@ class SyncHttpClient:
             method,
             url,
             self._retry_count,
-            partial(self._run_throttled_request, method, url, request_kwargs, session=session),
+            partial(
+                self._run_throttled_request,
+                method,
+                url,
+                request_kwargs,
+                session=session,
+            ),
         )
 
         response = do_request()
@@ -447,13 +463,21 @@ class SyncHttpClient:
                 exception = None
                 try:
                     response = func(*args, **kwargs)
-                except (requests.exceptions.ConnectionError, ConnectionError, Timeout) as e:
+                except (
+                    requests.exceptions.ConnectionError,
+                    ConnectionError,
+                    Timeout,
+                ) as e:
                     exception = e
 
                 if exception or response.status_code == requests_codes.service_unavailable:
                     secs = random.randint(60, 60 * 5)
                     logger.warning(
-                        "%s %s is unavailable. Attempts left: %s. Waiting %s seconds...", method, url, attempts, secs
+                        "%s %s is unavailable. Attempts left: %s. Waiting %s seconds...",
+                        method,
+                        url,
+                        attempts,
+                        secs,
                     )
 
                     # wait random number of seconds and request again
@@ -509,28 +533,48 @@ class DefaultOpenApiErrorHandlers:
     def handle_not_found(response: Response, raise_for_status: bool) -> Response | None:
         if raise_for_status:
             error = DefaultOpenApiErrorHandlers._parse_error_response(response)
-            raise errors.ObjectNotFound(response.status_code, error.summary, response, error_code=error.error_code)
+            raise errors.ObjectNotFound(
+                response.status_code,
+                error.summary,
+                response,
+                error_code=error.error_code,
+            )
         return response
 
     @staticmethod
     def handle_unauthorized(response: Response, raise_for_status: bool) -> Response | None:
         if raise_for_status:
             error = DefaultOpenApiErrorHandlers._parse_error_response(response)
-            raise errors.NotAuthorizedError(response.status_code, error.summary, response, error_code=error.error_code)
+            raise errors.NotAuthorizedError(
+                response.status_code,
+                error.summary,
+                response,
+                error_code=error.error_code,
+            )
         return response
 
     @staticmethod
     def handle_access_denied(response: Response, raise_for_status: bool) -> Response | None:
         if raise_for_status:
             error = DefaultOpenApiErrorHandlers._parse_error_response(response)
-            raise errors.AccessDeniedError(response.status_code, error.summary, response, error_code=error.error_code)
+            raise errors.AccessDeniedError(
+                response.status_code,
+                error.summary,
+                response,
+                error_code=error.error_code,
+            )
         return response
 
     @staticmethod
     def handle_server_error(response: Response, raise_for_status: bool) -> Response | None:
         if raise_for_status:
             error = DefaultOpenApiErrorHandlers._parse_error_response(response)
-            raise errors.ServerError(response.status_code, error.summary, response, error_code=error.error_code)
+            raise errors.ServerError(
+                response.status_code,
+                error.summary,
+                response,
+                error_code=error.error_code,
+            )
         return response
 
 

{openepd-6.13.2 → openepd-7.0.1}/src/openepd/api/category/sync_api.py

@@ -28,7 +28,7 @@ class CategoryApi(BaseApiMethodGroup):
         :return: categories tree wrapped in OpenEpdApiResponse
         """
         response = self._client.do_request("get", "/v2/categories/tree")
-        return CategoryTreeResponse.parse_raw(response.content)
+        return CategoryTreeResponse.model_validate_json(response.content)
 
     def get_tree(self) -> Category:
         """

{openepd-6.13.2 → openepd-7.0.1}/src/openepd/api/dto/base.py

@@ -15,14 +15,14 @@
 #
 import abc
 
-from openepd.compat.pydantic import pyd
+import pydantic
+from pydantic import ConfigDict
 
 
-class BaseOpenEpdApiModel(pyd.BaseModel):
+class BaseOpenEpdApiModel(pydantic.BaseModel):
     """Base class for OpenEPD API DTOs."""
 
-    class Config:
-        extra = pyd.Extra.ignore
+    model_config = ConfigDict(extra="ignore")
 
 
 class BaseMetaDto(BaseOpenEpdApiModel, metaclass=abc.ABCMeta):

{openepd-6.13.2 → openepd-7.0.1}/src/openepd/api/dto/common.py

@@ -15,12 +15,14 @@
 #
 import abc
 import datetime
-from typing import Final, Generic, TypeAlias, TypeVar
+from typing import ClassVar, Final, Generic, TypeAlias, TypeVar
+
+import pydantic
+from pydantic import ConfigDict
 
 from openepd.api.dto.base import BaseMetaDto, BaseOpenEpdApiModel, MetaExtensionBase
 from openepd.api.dto.meta import PerformanceMetaMixin
-from openepd.compat.pydantic import pyd, pyd_generics
-from openepd.model.base import AnySerializable, BaseOpenEpdSchema
+from openepd.model.base import AnySerializable
 
 DEFAULT_PAGE_SIZE: Final[int] = 100
 MAX_PAGE_SIZE: Final[int] = 250
@@ -29,25 +31,25 @@ MAX_PAGE_SIZE: Final[int] = 250
 class AuditableDto(BaseOpenEpdApiModel, metaclass=abc.ABCMeta):
     """Base class for all DTOs that hold audit information."""
 
-    created_by: str = pyd.Field(
+    created_by: str = pydantic.Field(
         title="Created By",
-        example="johnsmith@cqd.io",
+        examples=["johnsmith@cqd.io"],
         description="User's email or script name that created this list.",
     )
-    updated_by: str = pyd.Field(
+    updated_by: str = pydantic.Field(
         title="Updated By",
-        example="bobbuilder@buildingtransparency.org",
+        examples=["bobbuilder@buildingtransparency.org"],
         description="User's email or script name that updated this list last time.",
     )
-    created_on: datetime.datetime = pyd.Field(
+    created_on: datetime.datetime = pydantic.Field(
         title="Created On",
-        example="2019-06-13T13:17:09+00:00",
+        examples=["2019-06-13T13:17:09+00:00"],
         description="A timestamp when this object has been created "
         "in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.",
     )
-    updated_on: datetime.datetime = pyd.Field(
+    updated_on: datetime.datetime = pydantic.Field(
         title="Updated On",
-        example="2020-07-13T13:17:09+00:00",
+        examples=["2020-07-13T13:17:09+00:00"],
         description="A timestamp when this object has been updated last time "
         "in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.",
     )
@@ -59,7 +61,7 @@ TMetaDto = TypeVar("TMetaDto", bound=BaseMetaDto)
 TMetaExtension = TypeVar("TMetaExtension", bound=MetaExtensionBase)
 
 
-class MetaCollectionDto(BaseOpenEpdApiModel, pyd_generics.GenericModel, Generic[TMetaExtension]):
+class MetaCollectionDto(BaseOpenEpdApiModel, Generic[TMetaExtension]):
     """
     This class is intended to be used as a container for different meta objects.
 
@@ -86,13 +88,19 @@ class MetaCollectionDto(BaseOpenEpdApiModel, pyd_generics.GenericModel, Generic[
 
     ext: TMetaExtension | None = None
 
-    class Config(BaseOpenEpdSchema.Config):
-        schema_extra = {
+    model_config: ClassVar[ConfigDict] = ConfigDict(
+        json_schema_extra={
             "description": "Base structure of the response meta section",
         }
+    )
 
 
-class BaseMeta(PerformanceMetaMixin, MetaCollectionDto[TMetaExtension], Generic[TMetaExtension], metaclass=abc.ABCMeta):
+class BaseMeta(
+    PerformanceMetaMixin,
+    MetaCollectionDto[TMetaExtension],
+    Generic[TMetaExtension],
+    metaclass=abc.ABCMeta,
+):
     """Base class for creating meta objects specific to a controller."""
 
     pass
@@ -101,7 +109,7 @@ class BaseMeta(PerformanceMetaMixin, MetaCollectionDto[TMetaExtension], Generic[
 TMeta = TypeVar("TMeta", bound=MetaCollectionDto, covariant=True)
 
 
-class OpenEpdApiResponse(pyd_generics.GenericModel, BaseOpenEpdApiModel, Generic[TPayload, TMeta]):
+class OpenEpdApiResponse(BaseOpenEpdApiModel, Generic[TPayload, TMeta]):
     """Standard DTO representing response from OpenEPD API server."""
 
     payload: TPayload

{openepd-6.13.2 → openepd-7.0.1}/src/openepd/api/dto/meta.py

@@ -13,8 +13,9 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 #
+import pydantic
+
 from openepd.api.dto.base import BaseMetaDto, BaseOpenEpdApiModel
-from openepd.compat.pydantic import pyd
 
 
 class PerformanceMeta(BaseMetaDto):
@@ -32,30 +33,33 @@ class PerformanceMetaMixin(BaseMetaDto):
 class PagingMeta(BaseMetaDto):
     """Meta for paging information."""
 
-    total_count: int = pyd.Field(
-        title="Total results", example=1233, description="Total number of records for the search"
+    total_count: int = pydantic.Field(
+        title="Total results",
+        examples=[1233],
+        description="Total number of records for the search",
     )
-    total_pages: int = pyd.Field(title="Total pages", example=20, description="Total pages available")
-    page_size: int = pyd.Field(title="Page size", example=150, description="Number of records in page")
+    total_pages: int = pydantic.Field(title="Total pages", examples=[20], description="Total pages available")
+    page_size: int = pydantic.Field(title="Page size", examples=[150], description="Number of records in page")
 
 
 class PagingMetaMixin(BaseOpenEpdApiModel):
     """Mixin for adding paging meta to MetaCollection."""
 
-    paging: PagingMeta | None
+    paging: PagingMeta | None = pydantic.Field(default=None, description="Paging information")
 
 
 class WarningMessageDto(BaseOpenEpdApiModel):
     """DTO for warning messages."""
 
-    message: str = pyd.Field(
-        title="Warning message", example="Categories limited during search, see effective_omf in meta"
+    message: str = pydantic.Field(
+        title="Warning message",
+        examples=["Categories limited during search, see effective_omf in meta"],
     )
-    code: str = pyd.Field(title="Warning code", example="CATEGORIES_LIMITED")
-    field: str | None = pyd.Field(
+    code: str = pydantic.Field(title="Warning code", examples=["CATEGORIES_LIMITED"])
+    field: str | None = pydantic.Field(
         title="Field",
         description="Field to which the warning relates",
-        example="subcategories",
+        examples=["subcategories"],
     )
 
 

{openepd-6.13.2 → openepd-7.0.1}/src/openepd/api/dto/mf.py

@@ -13,8 +13,9 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 #
+import pydantic
+
 from openepd.api.dto.base import BaseOpenEpdApiModel
-from openepd.compat.pydantic import pyd
 
 
 class MaterialFilterDefinition(BaseOpenEpdApiModel):
@@ -24,14 +25,14 @@ class MaterialFilterDefinition(BaseOpenEpdApiModel):
     This object includes material filter itself as well as its hash.
     """
 
-    mf: str = pyd.Field(
+    mf: str = pydantic.Field(
         title="MaterialFilter",
-        example='!EC3 search("AluminiumBillets") !pragma oMF("1.0/1")',
+        examples=['!EC3 search("AluminiumBillets") !pragma oMF("1.0/1")'],
         description="MaterialFilter in string format",
     )
-    mf_hash: str = pyd.Field(
+    mf_hash: str = pydantic.Field(
         title="MaterialFilter hash",
-        example="22bf5b78cee5b79e1c76e818873d521c3972688b",
+        examples=["22bf5b78cee5b79e1c76e818873d521c3972688b"],
         description="MaterialFilter hash. Can be used to compare filters for equality, put to cache etc.",
     )
 
@@ -39,12 +40,12 @@ class MaterialFilterDefinition(BaseOpenEpdApiModel):
 class MaterialFilterMeta(BaseOpenEpdApiModel):
     """Meta holding supplementary information about OMF query execution."""
 
-    excluded_fields: list[str] | None = pyd.Field(
-        example=["building_jurisdiction", "jurisdiction"],
+    excluded_fields: list[str] | None = pydantic.Field(
+        examples=[["building_jurisdiction", "jurisdiction"]],
         description="list of fields excluded by server process for any reason",
         default=None,
     )
-    effective_omf: MaterialFilterDefinition = pyd.Field(
+    effective_omf: MaterialFilterDefinition = pydantic.Field(
         description="Effective OpenMaterialFilter as applied to search, after transformations if any"
     )
 

{openepd-6.13.2 → openepd-7.0.1}/src/openepd/api/epd/dto.py

@@ -15,11 +15,12 @@
 #
 from typing import TypeAlias
 
+import pydantic
+
 from openepd.api.dto.base import BaseOpenEpdApiModel
 from openepd.api.dto.common import BaseMeta, OpenEpdApiResponse
 from openepd.api.dto.meta import PagingMetaMixin, WarningMetaMixin
 from openepd.api.dto.mf import MaterialFilterMetaMixin
-from openepd.compat.pydantic import pyd
 from openepd.model.common import Amount
 from openepd.model.epd import Epd
 
@@ -32,70 +33,79 @@ class StatisticsDto(BaseOpenEpdApiModel):
     """
 
     # percentiles
-    pct10_gwp: float = pyd.Field(
+    pct10_gwp: float = pydantic.Field(
         description="10th percentile GWP for this statistics measured in kgCO2e per declared unit"
     )
-    achievable_target: float = pyd.Field(
-        description="Achievable target. 20th percentile of GWP measured in kgCO2e per declared unit", example=445.65
+    achievable_target: float = pydantic.Field(
+        description="Achievable target. 20th percentile of GWP measured in kgCO2e per declared unit",
+        examples=[445.65],
     )
-    pct30_gwp: float = pyd.Field(
+    pct30_gwp: float = pydantic.Field(
         description="30th percentile GWP for this statistics measured in kgCO2e per declared unit"
     )
-    pct40_gwp: float = pyd.Field(
+    pct40_gwp: float = pydantic.Field(
         description="40th percentile GWP for this statistics measured in kgCO2e per declared unit"
     )
-    pct50_gwp: float = pyd.Field(
+    pct50_gwp: float = pydantic.Field(
         description="50th percentile GWP for this statistics measured in kgCO2e per declared unit"
     )
-    pct60_gwp: float = pyd.Field(
+    pct60_gwp: float = pydantic.Field(
         description="60th percentile GWP for this statistics measured in kgCO2e per declared unit"
     )
-    pct70_gwp: float = pyd.Field(
+    pct70_gwp: float = pydantic.Field(
         description="70th percentile GWP for this statistics measured in kgCO2e per declared unit"
     )
-    conservative_estimate: float = pyd.Field(
+    conservative_estimate: float = pydantic.Field(
         description="Conservative estimate. 80th percentile of GWP per declared unit measured in kgCO2e",
-        example=640.778,
+        examples=[640.778],
     )
-    pct90_gwp: float = pyd.Field(
+    pct90_gwp: float = pydantic.Field(
         description="70th percentile GWP for this statistics measured in kgCO2e per declared unit"
     )
 
     # stats
-    average: float = pyd.Field(description="Average GWP in kgCO2e per declared unit", example=554.2)
-    min: float | None = pyd.Field(
-        description="Min GWP of returned results measured in kgCO2e per declared unit", example=998.3
+    average: float = pydantic.Field(description="Average GWP in kgCO2e per declared unit", examples=[554.2])
+    min: float | None = pydantic.Field(
+        description="Min GWP of returned results measured in kgCO2e per declared unit",
+        examples=[998.3],
     )
-    max: float | None = pyd.Field(
-        description="Max GWP of returned results measured in kgCO2e per declared unit", example=120.0
+    max: float | None = pydantic.Field(
+        description="Max GWP of returned results measured in kgCO2e per declared unit",
+        examples=[120.0],
     )
 
     # percentiles w/out burden of doubt
-    pct20_gwp_no_bod: float | None = pyd.Field(
-        description="20th percentile of GWP (kgCO2e per declared unit), no burden of doubt", example=120
+    pct20_gwp_no_bod: float | None = pydantic.Field(
+        description="20th percentile of GWP (kgCO2e per declared unit), no burden of doubt",
+        examples=[120],
     )
-    pct40_gwp_no_bod: float | None = pyd.Field(
-        description="40th percentile of GWP (kgCO2e per declared unit), no burden of doubt", example=120
+    pct40_gwp_no_bod: float | None = pydantic.Field(
+        description="40th percentile of GWP (kgCO2e per declared unit), no burden of doubt",
+        examples=[120],
     )
-    pct60_gwp_no_bod: float | None = pyd.Field(
-        description="60th percentile of GWP (kgCO2e per declared unit), no burden of doubt", example=120
+    pct60_gwp_no_bod: float | None = pydantic.Field(
+        description="60th percentile of GWP (kgCO2e per declared unit), no burden of doubt",
+        examples=[120],
     )
-    pct80_gwp_no_bod: float | None = pyd.Field(
-        description="80th percentile of GWP (kgCO2e per declared unit), no burden of doubt", example=120
+    pct80_gwp_no_bod: float | None = pydantic.Field(
+        description="80th percentile of GWP (kgCO2e per declared unit), no burden of doubt",
+        examples=[120],
     )
-    average_gwp_no_bod: float | None = pyd.Field(description="Average GWP, no burden of doubt", example=120)
+    average_gwp_no_bod: float | None = pydantic.Field(description="Average GWP, no burden of doubt", examples=[120])
 
     # set parameters
-    standard_deviation: float = pyd.Field(description="Standard deviation", example=87.62)
-    epds_count: int = pyd.Field(description="Number of EPDs participated in statistics", example=55)
-    industry_epds_count: int = pyd.Field(
-        description="Number of Industry-wide EPDs participated in statistics", example=4
+    standard_deviation: float = pydantic.Field(description="Standard deviation", examples=[87.62])
+    epds_count: int = pydantic.Field(description="Number of EPDs participated in statistics", examples=[55])
+    industry_epds_count: int = pydantic.Field(
+        description="Number of Industry-wide EPDs participated in statistics",
+        examples=[4],
     )
-    generic_estimates_count: int = pyd.Field(
-        description="Number of Generic Estimates participated in statistics", example=0
+    generic_estimates_count: int = pydantic.Field(
+        description="Number of Generic Estimates participated in statistics",
+        examples=[0],
     )
 
-    declared_unit: Amount = pyd.Field(
+    declared_unit: Amount = pydantic.Field(
         description="Declared unit for the statistics. "
         "Statistical values - percentiles, averages etc - are based on this unit of product"
     )