openepd 7.1.0__py3-none-any.whl → 7.3.0__py3-none-any.whl

openepd/model/specs/range/mixins/access_flooring_mixin.py

@@ -0,0 +1,43 @@
+#
+#  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.
+#
+import pydantic as pyd
+
+from openepd.model.specs.base import BaseOpenEpdSpec
+from openepd.model.specs.enums import (
+    AccessFlooringCoreMaterial,
+    AccessFlooringFinishMaterial,
+    AccessFlooringSeismicRating,
+    AccessFlooringStringers,
+)
+from openepd.model.validation.quantity import AmountRangeForce, AmountRangeLengthMm, AmountRangePressureMpa
+
+
+class AccessFlooringRangeMixin(BaseOpenEpdSpec):
+    core_material: list[AccessFlooringCoreMaterial] | None = pyd.Field(default=None, description="")
+    finish_material: list[AccessFlooringFinishMaterial] | None = pyd.Field(default=None, description="")
+    stringers: list[AccessFlooringStringers] | None = pyd.Field(default=None, description="")
+    seismic_rating: list[AccessFlooringSeismicRating] | None = pyd.Field(default=None, description="")
+    magnetically_attached_finish: bool | None = pyd.Field(default=None, description="")
+    permanent_finish: bool | None = pyd.Field(default=None, description="")
+    drylay: bool | None = pyd.Field(default=None, description="")
+    adjustable_height: bool | None = pyd.Field(default=None, description="")
+    fixed_height: bool | None = pyd.Field(default=None, description="")
+    finished_floor_height: AmountRangeLengthMm | None = pyd.Field(default=None, description="")
+    panel_thickness: AmountRangeLengthMm | None = pyd.Field(default=None, description="")
+    concentrated_load: AmountRangePressureMpa | None = pyd.Field(default=None, description="")
+    uniform_load: AmountRangePressureMpa | None = pyd.Field(default=None, description="")
+    rolling_load_10_pass: AmountRangeForce | None = pyd.Field(default=None, description="")
+    rolling_load_10000_pass: AmountRangeForce | None = pyd.Field(default=None, description="")

openepd/model/specs/range/network_infrastructure.py

@@ -14,14 +14,14 @@
 #  limitations under the License.
 #
 __all__ = (
-    "PDURangeV1",
     "CabinetsRacksAndEnclosuresRangeV1",
+    "CommunicationsConduitRangeV1",
     "DataCablingRangeV1",
     "FloorBoxesAndAccessoriesRangeV1",
+    "NetworkInfrastructureRangeV1",
     "NetworkingCableTraysRangeV1",
     "NetworkingRacewaysRangeV1",
-    "CommunicationsConduitRangeV1",
-    "NetworkInfrastructureRangeV1",
+    "PDURangeV1",
 )
 
 import pydantic

openepd/model/specs/range/openings.py

@@ -14,34 +14,34 @@
 #  limitations under the License.
 #
 __all__ = (
-    "PanelDoorsRangeV1",
-    "PressureResistantDoorsRangeV1",
-    "SpecialFunctionDoorsRangeV1",
-    "SlidingGlassDoorsRangeV1",
+    "CurtainWallsRangeV1",
+    "DoorsAndFramesRangeV1",
+    "EntrancesRangeV1",
     "FenestrationAccessoriesRangeV1",
     "FenestrationFramingRangeV1",
     "FenestrationHardwareRangeV1",
+    "FenestrationPartsRangeV1",
     "FlatGlassPanesRangeV1",
-    "ProcessedNonInsulatingGlassPanesRangeV1",
+    "GlassPanesRangeV1",
     "GlazedDoorsRangeV1",
-    "UnitSkylightsRangeV1",
-    "WindowsRangeV1",
+    "GlazingRangeV1",
+    "InsulatingGlazingUnitsRangeV1",
     "IntegratedDoorsOpeningAssembliesRangeV1",
     "MetalDoorAndFramesRangeV1",
-    "SpecialtyDoorsAndFramesRangeV1",
-    "WoodDoorsRangeV1",
-    "FenestrationPartsRangeV1",
-    "GlassPanesRangeV1",
     "NAFSFenestrationRangeV1",
-    "InsulatingGlazingUnitsRangeV1",
-    "CurtainWallsRangeV1",
-    "DoorsAndFramesRangeV1",
-    "EntrancesRangeV1",
-    "GlazingRangeV1",
+    "OpeningsRangeV1",
+    "PanelDoorsRangeV1",
+    "PressureResistantDoorsRangeV1",
+    "ProcessedNonInsulatingGlassPanesRangeV1",
+    "SlidingGlassDoorsRangeV1",
+    "SpecialFunctionDoorsRangeV1",
+    "SpecialtyDoorsAndFramesRangeV1",
     "StorefrontsRangeV1",
     "TranslucentWallAndRoofAssembliesRangeV1",
+    "UnitSkylightsRangeV1",
     "WindowWallAssembliesRangeV1",
-    "OpeningsRangeV1",
+    "WindowsRangeV1",
+    "WoodDoorsRangeV1",
 )
 
 import pydantic

openepd/model/specs/range/other_materials.py

@@ -17,17 +17,17 @@ __all__ = (
     "AuxiliariesRangeV1",
     "CleaningProductsRangeV1",
     "ClothingRangeV1",
-    "FoodBeverageRangeV1",
-    "TransportationInfrastructureRangeV1",
-    "UnsupportedRangeV1",
     "CopperRangeV1",
     "EarthworkRangeV1",
     "ExteriorSunControlDevicesRangeV1",
+    "FoodBeverageRangeV1",
     "GypsumFinishingCompoundsRangeV1",
+    "OtherMaterialsRangeV1",
     "ProfilesRangeV1",
+    "TransportationInfrastructureRangeV1",
     "UnknownRangeV1",
+    "UnsupportedRangeV1",
     "ZincRangeV1",
-    "OtherMaterialsRangeV1",
 )
 
 # NB! This is a generated code. Do not edit it manually. Please see src/openepd/model/specs/README.md

openepd/model/specs/range/plumbing.py

@@ -16,17 +16,17 @@
 __all__ = (
     "BathtubsRangeV1",
     "FaucetsRangeV1",
-    "OtherPlumbingFixturesRangeV1",
-    "WaterClosetsRangeV1",
     "FireProtectionPipingRangeV1",
     "FireSprinklersRangeV1",
-    "StorageTanksRangeV1",
-    "WaterHeatersRangeV1",
-    "PlumbingFixturesRangeV1",
     "FireSuppressionRangeV1",
+    "OtherPlumbingFixturesRangeV1",
     "PipingRangeV1",
     "PlumbingEquipmentRangeV1",
+    "PlumbingFixturesRangeV1",
     "PlumbingRangeV1",
+    "StorageTanksRangeV1",
+    "WaterClosetsRangeV1",
+    "WaterHeatersRangeV1",
 )
 
 import pydantic

openepd/model/specs/range/precast_concrete.py

@@ -15,10 +15,10 @@
 #
 __all__ = (
     "ArchitecturalPrecastRangeV1",
-    "StructuralPrecastRangeV1",
-    "UtilityUndergroundPrecastRangeV1",
     "CivilPrecastRangeV1",
     "PrecastConcreteRangeV1",
+    "StructuralPrecastRangeV1",
+    "UtilityUndergroundPrecastRangeV1",
 )
 
 import pydantic

openepd/model/specs/range/steel.py

@@ -14,25 +14,27 @@
 #  limitations under the License.
 #
 __all__ = (
+    "CoilSteelRangeV1",
     "ColdFormedFramingRangeV1",
+    "ColdFormedSteelRangeV1",
+    "CrudeSteelRangeV1",
     "DeckingSteelRangeV1",
-    "SteelSuspensionAssemblyRangeV1",
     "HollowSectionsRangeV1",
     "HotRolledSectionsRangeV1",
-    "PlateSteelRangeV1",
+    "MBQSteelRangeV1",
     "MetalRailingsRangeV1",
     "MetalStairsRangeV1",
     "MiscMetalFabricationRangeV1",
     "OpenWebMembranesRangeV1",
-    "MBQSteelRangeV1",
-    "CoilSteelRangeV1",
-    "ColdFormedSteelRangeV1",
-    "StructuralSteelRangeV1",
-    "PrefabricatedSteelAssembliesRangeV1",
+    "OtherSteelRangeV1",
+    "PlateSteelRangeV1",
     "PostTensioningSteelRangeV1",
+    "PrefabricatedSteelAssembliesRangeV1",
     "RebarSteelRangeV1",
-    "WireMeshSteelRangeV1",
     "SteelRangeV1",
+    "SteelSuspensionAssemblyRangeV1",
+    "StructuralSteelRangeV1",
+    "WireMeshSteelRangeV1",
 )
 
 from typing import ClassVar
@@ -308,6 +310,12 @@ class OtherSteelRangeV1(BaseOpenEpdHierarchicalSpec):
     _EXT_VERSION = "1.0"
 
 
+class CrudeSteelRangeV1(BaseOpenEpdHierarchicalSpec):
+    """Crude steel products."""
+
+    _EXT_VERSION = "1.0"
+
+
 class SteelRangeV1(BaseOpenEpdHierarchicalSpec):
     """
     Broad category for construction materials made from steel and its alloys.
@@ -315,7 +323,7 @@ class SteelRangeV1(BaseOpenEpdHierarchicalSpec):
     Range version.
     """
 
-    _EXT_VERSION: ClassVar[str] = "1.1"
+    _EXT_VERSION: ClassVar[str] = "1.2"
 
     yield_tensile_str: AmountRangePressureMpa | None = pydantic.Field(
         default=None,
@@ -349,3 +357,4 @@ class SteelRangeV1(BaseOpenEpdHierarchicalSpec):
     RebarSteel: RebarSteelRangeV1 | None = None
     WireMeshSteel: WireMeshSteelRangeV1 | None = None
     OtherSteel: OtherSteelRangeV1 | None = None
+    CrudeSteel: CrudeSteelRangeV1 | None = None

openepd/model/specs/range/thermal_moisture_protection.py

@@ -14,28 +14,28 @@
 #  limitations under the License.
 #
 __all__ = (
+    "AirBarriersRangeV1",
     "BituminousRoofingRangeV1",
-    "SinglePlyEPDMRangeV1",
-    "SinglePlyKEERangeV1",
-    "SinglePlyOtherRangeV1",
-    "SinglePlyPolyurethaneRangeV1",
-    "SinglePlyPVCRangeV1",
-    "SinglePlyTPORangeV1",
     "BlanketInsulationRangeV1",
     "BlownInsulationRangeV1",
     "BoardInsulationRangeV1",
-    "FoamedInPlaceRangeV1",
-    "SprayedInsulationRangeV1",
-    "AirBarriersRangeV1",
-    "MembraneRoofingRangeV1",
-    "InsulationRangeV1",
     "DampproofingAndWaterproofingRangeV1",
     "FlashingAndSheetMetalRangeV1",
+    "FoamedInPlaceRangeV1",
+    "InsulationRangeV1",
     "JointProtectionRangeV1",
+    "MembraneRoofingRangeV1",
     "RoofCoverBoardsRangeV1",
+    "SinglePlyEPDMRangeV1",
+    "SinglePlyKEERangeV1",
+    "SinglePlyOtherRangeV1",
+    "SinglePlyPVCRangeV1",
+    "SinglePlyPolyurethaneRangeV1",
+    "SinglePlyTPORangeV1",
+    "SprayedInsulationRangeV1",
     "SteepSlopeRoofingRangeV1",
-    "WeatherBarriersRangeV1",
     "ThermalMoistureProtectionRangeV1",
+    "WeatherBarriersRangeV1",
 )
 
 import pydantic

openepd/model/specs/range/wood.py

@@ -14,26 +14,24 @@
 #  limitations under the License.
 #
 __all__ = (
-    "WoodDeckingRangeV1",
-    "WoodFramingRangeV1",
-    "PrefabricatedWoodInsulatedPanelsRangeV1",
-    "PrefabricatedWoodTrussRangeV1",
     "CompositeLumberRangeV1",
     "DimensionLumberRangeV1",
     "HeavyTimberRangeV1",
     "MassTimberRangeV1",
     "NonStructuralWoodRangeV1",
+    "PrefabricatedWoodInsulatedPanelsRangeV1",
     "PrefabricatedWoodRangeV1",
+    "PrefabricatedWoodTrussRangeV1",
     "SheathingPanelsRangeV1",
     "UnfinishedWoodRangeV1",
+    "WoodDeckingRangeV1",
+    "WoodFramingRangeV1",
     "WoodRangeV1",
 )
 
 # NB! This is a generated code. Do not edit it manually. Please see src/openepd/model/specs/README.md
 
 
-from builtins import float
-
 import pydantic
 
 from openepd.model.org import OrgRef

openepd/model/specs/singular/__init__.py

@@ -13,9 +13,18 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 #
-from typing import Any, ClassVar
+__all__ = [
+    "BaseCompatibilitySpec",
+    "Specs",
+]
+
+
+from collections.abc import Sequence
+import types
+from typing import Any, ClassVar, TypeVar
 
 import pydantic
+from pydantic.fields import FieldInfo
 
 from openepd.model.specs.base import BaseOpenEpdHierarchicalSpec
 from openepd.model.specs.singular.accessories import AccessoriesV1
@@ -36,6 +45,7 @@ from openepd.model.specs.singular.electrical_transmission_and_distribution_equip
     ElectricalTransmissionAndDistributionEquipmentV1,
 )
 from openepd.model.specs.singular.electricity import ElectricityV1
+from openepd.model.specs.singular.exterior_improvements import ExteriorImprovementsV1
 from openepd.model.specs.singular.finishes import FinishesV1
 from openepd.model.specs.singular.fire_and_smoke_protection import FireAndSmokeProtectionV1
 from openepd.model.specs.singular.furnishings import FurnishingsV1
@@ -58,7 +68,7 @@ from openepd.model.specs.singular.utility_piping import UtilityPipingV1
 from openepd.model.specs.singular.wood import WoodV1
 from openepd.model.specs.singular.wood_joists import WoodJoistsV1
 
-__all__ = ("Specs", "BaseCompatibilitySpec")
+TValue = TypeVar("TValue")
 
 
 class Specs(BaseOpenEpdHierarchicalSpec):
@@ -106,6 +116,7 @@ class Specs(BaseOpenEpdHierarchicalSpec):
     MechanicalInsulation: MechanicalInsulationV1 | None = None
     OtherElectricalEquipment: OtherElectricalEquipmentV1 | None = None
     WoodJoists: WoodJoistsV1 | None = None
+    ExteriorImprovements: ExteriorImprovementsV1 | None = None
 
     # historical backward-compatible specs
     concrete: ConcreteOldSpec | None = None
@@ -141,3 +152,109 @@ class Specs(BaseOpenEpdHierarchicalSpec):
                     continue
                 set_safely(values, new_key_spec, old_value)
         return values
+
+    def get_by_spec_path(
+        self,
+        path: str | Sequence[str],
+        *,
+        delimiter: str = ".",
+        asserted_type: type[TValue] | None = None,
+        ensure_path: bool = True,
+    ) -> TValue | None:
+        """
+        Access specific property of the spec by a path, which can be string-separated or sequence of keys.
+
+        :param path: The path to access, either as a string with delimiters (e.g. "Concrete.strength_28d")
+                    or sequence of keys (e.g. ["Concrete", "strength_28d"])
+        :param delimiter: String separator used when path is provided as a string (default ".")
+        :param asserted_type: Type to validate the returned value against (optional)
+        :param ensure_path: If True, validates that path exists in the spec schema before accessing (default True)
+        :return: Value at the specified path if found, None if path resolves to None
+        :raises KeyError: If ensure_path=True and path does not exist in schema
+        :raises TypeError: If asserted_type is provided and value type doesn't match
+        :raises ValueError: If path is not string or sequence
+
+        Example usage:
+            >>> specs.get_by_spec_path("Concrete.strength_28d")
+            >>> specs.get_by_spec_path(["Concrete", "strength_28d"])
+            >>> specs.get_by_spec_path("Concrete.strength_28d", asserted_type=str)
+        """
+        keys = self._path_to_keys(path, delimiter)
+
+        if ensure_path:
+            self._ensure_path(keys)
+
+        result: Any = self
+        for key in self._path_to_keys(path, delimiter):
+            result = getattr(result, key, None)
+            if result is None:
+                return None
+
+        if not asserted_type:
+            return result
+
+        if isinstance(result, asserted_type):
+            return result
+
+        msg = f"Expected {asserted_type} but got {type(result)}"
+        raise TypeError(msg)
+
+    def _ensure_path(self, keys: Sequence[str]) -> None:
+        """
+        Validate if a sequence of keys exists in the spec schema structure.
+
+        :param keys: Sequence of string keys representing path in spec schema
+        :raises KeyError: If path specified by keys does not exist in schema
+
+        This internal method walks through the schema structure following the provided keys
+        sequence, checking if each key exists at the corresponding level. For UnionType fields,
+        it extracts the non-None type and continues validation if it's a BaseModel.
+        """
+        klass = self.__class__
+
+        fields: dict[str, FieldInfo] = klass.model_fields
+
+        field: FieldInfo | None
+        for i, key in enumerate(keys, start=1):
+            field = fields.get(key)
+            if field is None:
+                msg = f"Path {'.'.join(keys)} does not exist in {klass.__name__} spec"
+                raise KeyError(msg)
+
+            assert hasattr(field, "annotation"), "Annotation field is required"
+            if isinstance(field.annotation, types.UnionType):
+                target_type = next(item for item in field.annotation.__args__ if item is not None)
+            else:
+                target_type = field.annotation
+
+            if target_type is None:
+                msg = f"Path {'.'.join(keys)} does not exist in {klass.__name__} spec"
+                raise KeyError(msg)
+
+            if issubclass(target_type, pydantic.BaseModel):
+                fields = target_type.model_fields
+            elif i == len(keys):
+                return None
+            else:
+                msg = f"Path {'.'.join(keys)} does not exist in {klass.__name__} spec"
+                raise KeyError(msg)
+
+        return None
+
+    def _path_to_keys(self, path: str | Sequence[str], delimiter: str) -> Sequence[str]:
+        """
+        Convert path parameter to sequence of keys.
+
+        :param path: Path to convert, either string to split by delimiter or sequence of keys
+        :param delimiter: String separator used to split path if string is provided
+        :return: Sequence of string keys
+        :raises ValueError: If a path is not string or sequence
+        """
+        match path:
+            case str():
+                return path.split(delimiter)
+            case Sequence():
+                return path
+            case _:
+                msg = f"Unsupported path type: {type(path)}"
+                raise ValueError(msg)

openepd/model/specs/singular/aluminium.py

@@ -26,7 +26,8 @@ class AluminiumBilletsV1(BaseOpenEpdHierarchicalSpec):
 
 
 class AluminiumExtrusionsV1(BaseOpenEpdHierarchicalSpec):
-    """Extruded aluminum products used in construction.
+    """
+    Extruded aluminum products used in construction.
 
     Includes range of finish options including mill finish, painted, and anodized.
     """

openepd/model/specs/singular/concrete.py

@@ -99,6 +99,28 @@ class ShotcreteV1(BaseOpenEpdHierarchicalSpec):
     _EXT_VERSION = "1.0"
 
 
+class CellularConcreteV1(BaseOpenEpdHierarchicalSpec):
+    """
+    Cellular concrete is typically composed of cementitious material, water, and pre-formed foam with air entrainment.
+
+    Such a product is a homogeneous void or cell structure.
+    It is self-compacting and can be pumped over extensive heights and distances.
+    """
+
+    _EXT_VERSION = "1.0"
+
+
+class OtherConcreteV1(BaseOpenEpdHierarchicalSpec):
+    """
+    Other Concrete Products.
+
+    Other types of concrete products that are not captured by existing concrete categories.
+    Could include products such as patching concrete or additives
+    """
+
+    _EXT_VERSION = "1.0"
+
+
 class ConcreteV1(BaseOpenEpdHierarchicalSpec):
     """
     Concrete.
@@ -107,7 +129,7 @@ class ConcreteV1(BaseOpenEpdHierarchicalSpec):
     hardens over time.
     """
 
-    _EXT_VERSION = "1.0"
+    _EXT_VERSION = "1.1"
 
     # Own fields:
     lightweight: bool | None = pydantic.Field(
@@ -208,6 +230,8 @@ class ConcreteV1(BaseOpenEpdHierarchicalSpec):
     OilPatch: OilPatchV1 | None = None
     ReadyMix: ReadyMixV1 | None = None
     Shotcrete: ShotcreteV1 | None = None
+    OtherConcrete: OtherConcreteV1 | None = None
+    CellularConcrete: CellularConcreteV1 | None = None
 
     @pydantic.field_validator("aci_exposure_classes", mode="before", check_fields=False)
     def _validate_aci_exposure_classes(cls, value):

openepd/model/specs/singular/deprecated/__init__.py

@@ -50,7 +50,7 @@ def get_safely(d: dict, path: str) -> tuple[bool, Any]:
                     return False, None
                 current = current.get(p)
             case pydantic.BaseModel() as model:
-                if not hasattr(current, p) or p not in model.__fields_set__:
+                if not hasattr(current, p) or p not in model.model_fields_set:
                     return False, None
                 current = getattr(current, p)
             case _:

openepd/model/specs/singular/exterior_improvements.py

@@ -0,0 +1,47 @@
+#
+#  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.
+#
+import pydantic as pyd
+
+from openepd.model.specs.base import BaseOpenEpdHierarchicalSpec
+from openepd.model.validation.quantity import AmountPressureMpa
+
+
+class ConcretePaversV1(BaseOpenEpdHierarchicalSpec):
+    """
+    Segmental units of concrete of standardized sizes and shapes for use in paving applications.
+
+    Includes pavers and paving slabs.
+    """
+
+    _EXT_VERSION = "1.0"
+
+    compressive_strength: AmountPressureMpa | None = pyd.Field(
+        default=None,
+        description=(
+            "Unit strength in MPa, ksi, or psi. "
+            "This is the net compressive strength, also known as unit strength, as opposed to f′ₘ (f prime m) which is "
+            "the strength of the completed wall module."
+        ),
+    )
+    white_cement: bool | None = pyd.Field(default=None, description="CMU using some portion of white cement")
+
+
+class ExteriorImprovementsV1(BaseOpenEpdHierarchicalSpec):
+    """Products that alter the exterior appearance of a lot or its structures."""
+
+    _EXT_VERSION = "1.0"
+
+    ConcretePavers: ConcretePaversV1 | None = None