Tarifzeiten Modul3

src/bo4e/__init__.py

@@ -42,6 +42,7 @@
     "Tarifinfo",
     "Tarifkosten",
     "Tarifpreisblatt",
+    "Tarifzeiten",
     "TechnischeRessource",
     "Vertrag",
     "Zaehler",
@@ -97,6 +98,8 @@
     "Tarifpreisposition",
     "TarifpreispositionProOrt",
     "TarifpreisstaffelProOrt",
+    "TarifzeitenZeitscheibe",
+    "Tarifzeitstufe",
     "Unterschrift",
     "Vertragskonditionen",
     "Vertragsteil",
@@ -241,6 +244,7 @@
 from .bo.tarifinfo import Tarifinfo
 from .bo.tarifkosten import Tarifkosten
 from .bo.tarifpreisblatt import Tarifpreisblatt
+from .bo.tarifzeiten import Tarifzeiten
 from .bo.technischeressource import TechnischeRessource
 from .bo.vertrag import Vertrag
 from .bo.zaehler import Zaehler
@@ -299,6 +303,8 @@
 from .com.tarifpreisposition import Tarifpreisposition
 from .com.tarifpreispositionproort import TarifpreispositionProOrt
 from .com.tarifpreisstaffelproort import TarifpreisstaffelProOrt
+from .com.tarifzeitenzeitscheibe import TarifzeitenZeitscheibe
+from .com.tarifzeitstufe import Tarifzeitstufe
 from .com.unterschrift import Unterschrift
 from .com.vertragskonditionen import Vertragskonditionen
 from .com.vertragsteil import Vertragsteil

src/bo4e/bo/tarifzeiten.py

@@ -0,0 +1,38 @@
+"""
+Contains Tarifzeiten class
+"""
+
+from typing import TYPE_CHECKING, Annotated, Literal, Optional
+
+from pydantic import Field
+
+from ..enum.botyp import BoTyp
+from ..utils import postprocess_docstring
+from .geschaeftsobjekt import Geschaeftsobjekt
+
+if TYPE_CHECKING:
+    from ..bo.marktteilnehmer import Marktteilnehmer
+    from ..com.tarifzeitenzeitscheibe import TarifzeitenZeitscheibe
+
+
+@postprocess_docstring
+class Tarifzeiten(Geschaeftsobjekt):
+    """
+    Abbildung von Tarifzeiten, wann welche Preise gelten oder unter welchen Bedingungen.
+
+    .. raw:: html
+
+        <object data="../_static/images/bo4e/bo/Tarifzeiten.svg" type="image/svg+xml"></object>
+
+    .. HINT::
+        `Tarifzeiten JSON Schema <https://json-schema.app/view/%23?url=https://raw.githubusercontent.com/BO4E/BO4E-Schemas/{__gh_version__}/src/bo4e_schemas/bo/Tarifzeiten.json>`_
+
+    """
+
+    typ: Annotated[Optional[Literal[BoTyp.TARIFZEITEN]], Field(alias="_typ")] = BoTyp.TARIFZEITEN
+
+    marktteilnehmer: Optional["Marktteilnehmer"] = None
+    """Optionaler Verweis auf den Anbieter / Marktpartner"""
+
+    zeitscheiben: Optional[list["TarifzeitenZeitscheibe"]] = None
+    """Liste von Zeitabschnitten, die tarifliche Regelungen enthalten"""

src/bo4e/com/tarifzeitenzeitscheibe.py

@@ -0,0 +1,40 @@
+"""
+Contains TarifzeitenZeitscheibe class
+"""
+
+from typing import TYPE_CHECKING, Annotated, Literal, Optional
+
+from pydantic import Field
+
+from ..enum.comtyp import ComTyp
+from ..utils import postprocess_docstring
+from .com import COM
+
+if TYPE_CHECKING:
+    from ..com.tarifzeitstufe import Tarifzeitstufe
+    from ..com.zeitraum import Zeitraum
+
+
+@postprocess_docstring
+class TarifzeitenZeitscheibe(COM):
+    """
+    Eine Zeitscheibe innerhalb der Tarifzeiten mit zugehöriger Gültigkeit und Tarifzeitabschnitten.
+
+    .. raw:: html
+
+        <object data="../_static/images/bo4e/com/TarifzeitenZeitscheibe.svg" type="image/svg+xml"></object>
+
+    .. HINT::
+        `TarifzeitenZeitscheibe JSON Schema <https://json-schema.app/view/%23?url=https://raw.githubusercontent.com/BO4E/BO4E-Schemas/{__gh_version__}/src/bo4e_schemas/com/TarifzeitenZeitscheibe.json>`_
+
+    """
+
+    typ: Annotated[Optional[Literal[ComTyp.TARIFZEITENZEITSCHEIBE]], Field(alias="_typ")] = (
+        ComTyp.TARIFZEITENZEITSCHEIBE
+    )
+
+    gueltigkeit: Optional["Zeitraum"] = None
+    """Zeitraum, in dem diese Zeitscheibe gültig ist"""
+
+    tarifzeiten: Optional[list["Tarifzeitstufe"]] = None
+    """Liste von Tarifzeitenstufen, z. B. NT, HT oder weitere Zeitmodelle"""

src/bo4e/com/tarifzeitstufe.py

@@ -0,0 +1,37 @@
+"""
+Contains Tarifzeitstufe class
+"""
+
+from typing import TYPE_CHECKING, Annotated, Literal, Optional
+
+from pydantic import Field
+
+from ..enum.comtyp import ComTyp
+from ..utils import postprocess_docstring
+from .com import COM
+
+if TYPE_CHECKING:
+    from ..com.zeitraum import Zeitraum
+
+
+@postprocess_docstring
+class Tarifzeitstufe(COM):
+    """
+    Tarifzeitstufe mit Zuordnung zu einem Zeitraum und einer optionalen Tarifstufe.
+
+    .. raw:: html
+
+        <object data="../_static/images/bo4e/com/Tarifzeitstufe.svg" type="image/svg+xml"></object>
+
+    .. HINT::
+        `Tarifzeitstufe JSON Schema <https://json-schema.app/view/%23?url=https://raw.githubusercontent.com/BO4E/BO4E-Schemas/{__gh_version__}/src/bo4e_schemas/com/Tarifzeitstufe.json>`_
+
+    """
+
+    typ: Annotated[Optional[Literal[ComTyp.TARIFZEITSTUFE]], Field(alias="_typ")] = ComTyp.TARIFZEITSTUFE
+
+    zeitraum: Optional["Zeitraum"] = None
+    """Gültigkeitszeitraum der Tarifzeitstufe"""
+
+    tarifstufe: Optional[str] = None
+    """Optional: Angabe der Tarifstufe, z. B. HT, NT, ST"""

src/bo4e/enum/botyp.py

@@ -48,6 +48,7 @@ class BoTyp(StrEnum):
     TARIFINFO = "TARIFINFO"
     TARIFKOSTEN = "TARIFKOSTEN"
     TARIFPREISBLATT = "TARIFPREISBLATT"
+    TARIFZEITEN = "TARIFZEITEN"
     VERTRAG = "VERTRAG"
     ZAEHLER = "ZAEHLER"
     ZEITREIHE = "ZEITREIHE"

src/bo4e/enum/comtyp.py

@@ -62,6 +62,8 @@ class ComTyp(StrEnum):
     TARIFPREISPOSITION = "TARIFPREISPOSITION"
     TARIFPREISPOSITIONPROORT = "TARIFPREISPOSITIONPROORT"
     TARIFPREISSTAFFELPROORT = "TARIFPREISSTAFFELPROORT"
+    TARIFZEITENZEITSCHEIBE = "TARIFZEITENZEITSCHEIBE"
+    TARIFZEITSTUFE = "TARIFZEITSTUFE"
     UNTERSCHRIFT = "UNTERSCHRIFT"
     VERTRAGSKONDITIONEN = "VERTRAGSKONDITIONEN"
     VERTRAGSTEIL = "VERTRAGSTEIL"

tests/test_tarifzeiten.py

@@ -0,0 +1,26 @@
+from datetime import date
+
+import pytest
+
+from bo4e import Marktteilnehmer, Tarifzeiten, TarifzeitenZeitscheibe
+from tests.serialization_helper import assert_serialization_roundtrip
+
+
+class TestTarifzeiten:
+    @pytest.mark.parametrize(
+        "tarifzeiten",
+        [
+            pytest.param(
+                Tarifzeiten(
+                    marktteilnehmer=Marktteilnehmer(),
+                    zeitscheiben=[TarifzeitenZeitscheibe()],
+                ),
+                id="all attributes at first level",
+            ),
+        ],
+    )
+    def test_serialization_roundtrip(self, tarifzeiten: Tarifzeiten) -> None:
+        """
+        Test de-/serialisation of Tarifzeit.
+        """
+        assert_serialization_roundtrip(tarifzeiten)

tests/test_tarifzeitenzeitscheibe.py

@@ -0,0 +1,26 @@
+from datetime import date
+
+import pytest
+
+from bo4e import TarifzeitenZeitscheibe, Tarifzeitstufe, Zeitraum
+from tests.serialization_helper import assert_serialization_roundtrip
+
+
+class TestTarifzeitenZeitscheibe:
+    @pytest.mark.parametrize(
+        "tarifzeitenzeitscheibe",
+        [
+            pytest.param(
+                TarifzeitenZeitscheibe(
+                    gueltigkeit=Zeitraum(),
+                    tarifzeiten=[Tarifzeitstufe()],
+                ),
+                id="all attributes at first level",
+            ),
+        ],
+    )
+    def test_serialization_roundtrip(self, tarifzeitenzeitscheibe: TarifzeitenZeitscheibe) -> None:
+        """
+        Test de-/serialisation of TarifzeitenZeitscheibe.
+        """
+        assert_serialization_roundtrip(tarifzeitenzeitscheibe)

tests/test_tarifzeitstufe.py

@@ -0,0 +1,26 @@
+from datetime import date
+
+import pytest
+
+from bo4e import Tarifzeitstufe, Zeitraum
+from tests.serialization_helper import assert_serialization_roundtrip
+
+
+class TestTarifzeitstufe:
+    @pytest.mark.parametrize(
+        "tarifzeitstufe",
+        [
+            pytest.param(
+                Tarifzeitstufe(
+                    zeitraum=Zeitraum(),
+                    tarifstufe="HT",
+                ),
+                id="all attributes at first level",
+            )
+        ],
+    )
+    def test_serialization_roundtrip(self, tarifzeitstufe: Tarifzeitstufe) -> None:
+        """
+        Test de-/serialisation of Tarifzeitstufe.
+        """
+        assert_serialization_roundtrip(tarifzeitstufe)