pysdmx 1.8.0__tar.gz → 1.9.0__tar.gz

{pysdmx-1.8.0 → pysdmx-1.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pysdmx
-Version: 1.8.0
+Version: 1.9.0
 Summary: Your opinionated Python SDMX library
 License: Apache-2.0
 License-File: LICENSE
@@ -16,9 +16,11 @@ Classifier: Typing :: Typed
 Provides-Extra: all
 Provides-Extra: data
 Provides-Extra: dc
+Provides-Extra: json
 Provides-Extra: vtl
 Provides-Extra: xml
 Requires-Dist: httpx[http2] (>=0)
+Requires-Dist: jsonschema (>=4.10) ; extra == "json"
 Requires-Dist: lxml (>=5.2) ; extra == "all"
 Requires-Dist: lxml (>=5.2) ; extra == "xml"
 Requires-Dist: msgspec (>=0)
@@ -28,6 +30,7 @@ Requires-Dist: parsy (>=2.1)
 Requires-Dist: python-dateutil (>=2.8.2) ; extra == "all"
 Requires-Dist: python-dateutil (>=2.8.2) ; extra == "dc"
 Requires-Dist: sdmxschemas (>=1.0.0) ; extra == "all"
+Requires-Dist: sdmxschemas (>=1.0.0) ; extra == "json"
 Requires-Dist: sdmxschemas (>=1.0.0) ; extra == "xml"
 Requires-Dist: vtlengine (>=1.1,<2.0) ; extra == "all"
 Requires-Dist: vtlengine (>=1.1,<2.0) ; extra == "vtl"

{pysdmx-1.8.0 → pysdmx-1.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pysdmx"
-version = "1.8.0"
+version = "1.9.0"
 description = "Your opinionated Python SDMX library"
 license = { text = "Apache-2.0" }
 readme = "README.rst"
@@ -23,7 +23,7 @@ classifiers = [
 dependencies = [
     "httpx[http2]>=0.*",
     "msgspec>=0.*",
-    "parsy>=2.1",
+    "parsy>=2.1"
 ]
 
 [project.urls]
@@ -36,6 +36,7 @@ documentation = "https://bis-med-it.github.io/pysdmx"
 data = ["pandas>=2.1.4"]
 dc = ["python-dateutil>=2.8.2"]
 vtl = ["vtlengine>=1.1,<2.0"]
+json = ["sdmxschemas>=1.0.0", "jsonschema>=4.10"]
 xml = ["lxml>=5.2", "xmltodict>=0.13", "sdmxschemas>=1.0.0"]
 all = ["lxml>=5.2", "xmltodict>=0.13", "sdmxschemas>=1.0.0", "pandas>=2.1.4", "python-dateutil>=2.8.2", "vtlengine>=1.1,<2.0"]
 
@@ -57,6 +58,7 @@ lxml-stubs = "^0.5.1"
 types-xmltodict = "^0.13.0.3"
 types-python-dateutil = "^2.9.0.20240316"
 pandas-stubs = "^2.1.4.231227"
+types-jsonschema = "^4.25.1.20251009"
 
 [tool.poetry.group.docs.dependencies]
 sphinx = "^7.2.6"
@@ -93,7 +95,7 @@ lint.mccabe.max-complexity = 10
 lint.pydocstyle.convention = "google"
 
 [tool.ruff.lint.per-file-ignores]
-"tests/*" = ["DTZ", "D100", "D103", "D104", "PERF", "S101", "S311"]
+"tests/*" = ["C901", "DTZ", "D100", "D103", "D104", "PERF", "S101", "S311"]
 
 [tool.mypy]
 files = "src"

{pysdmx-1.8.0 → pysdmx-1.9.0}/src/pysdmx/__extras_check.py

@@ -55,3 +55,17 @@ def __check_vtl_extra() -> None:
                 " and prettify",
             )
         ) from None
+
+
+def __check_json_extra() -> None:
+    try:
+        import jsonschema  # noqa: F401
+        import sdmxschemas  # noqa: F401
+    except ImportError:
+        raise ImportError(
+            ERROR_MESSAGE.format(
+                extra_name="json",
+                extra_desc="the validation of SDMX-JSON Structure Messages "
+                "(hint, use validate=False if you don't need validation)",
+            )
+        ) from None

{pysdmx-1.8.0 → pysdmx-1.9.0}/src/pysdmx/__init__.py

@@ -1,3 +1,3 @@
 """Your opinionated Python SDMX library."""
 
-__version__ = "1.8.0"
+__version__ = "1.9.0"

{pysdmx-1.8.0 → pysdmx-1.9.0}/src/pysdmx/io/json/fusion/messages/category.py

@@ -1,7 +1,7 @@
 """Collection of Fusion-JSON schemas for categories and category schemes."""
 
 from collections import defaultdict
-from typing import Dict, Optional, Sequence
+from typing import Dict, Optional, Sequence, Tuple, Union
 
 from msgspec import Struct
 
@@ -11,6 +11,8 @@ from pysdmx.model import (
     Agency,
     Category,
     DataflowRef,
+    ItemReference,
+    Reference,
 )
 from pysdmx.model import (
     Categorisation as CT,
@@ -21,7 +23,7 @@ from pysdmx.model import (
 from pysdmx.model import (
     Dataflow as DF,
 )
-from pysdmx.util import find_by_urn
+from pysdmx.util import find_by_urn, parse_urn
 
 
 class FusionCategorisation(Struct, frozen=True, rename={"agency": "agencyId"}):
@@ -57,14 +59,46 @@ class FusionCategory(Struct, frozen=True):
     descriptions: Optional[Sequence[FusionString]] = None
     items: Sequence["FusionCategory"] = ()
 
-    def to_model(self) -> Category:
+    def __add_flows(
+        self, cni: str, cf: Dict[str, list[DF]]
+    ) -> Sequence[DataflowRef]:
+        if cni in cf:
+            return [
+                DataflowRef(
+                    (
+                        df.agency.id
+                        if isinstance(df.agency, Agency)
+                        else df.agency
+                    ),
+                    df.id,
+                    df.version,
+                    df.name,
+                )
+                for df in cf[cni]
+            ]
+        else:
+            return ()
+
+    def to_model(
+        self,
+        cat_flows: dict[str, list[DF]],
+        cat_other: dict[str, list[Union[ItemReference, Reference]]],
+        parent_id: Optional[str] = None,
+    ) -> Category:
         """Converts a FusionCode to a standard code."""
         description = self.descriptions[0].value if self.descriptions else None
+        cni = f"{parent_id}.{self.id}" if parent_id else self.id
+        dataflows = self.__add_flows(cni, cat_flows)
+        others = cat_other.get(cni, ())
         return Category(
             id=self.id,
             name=self.names[0].value,
             description=description,
-            categories=[c.to_model() for c in self.items],
+            categories=[
+                c.to_model(cat_flows, cat_other, cni) for c in self.items
+            ],
+            dataflows=dataflows,
+            other_references=others,
         )
 
 
@@ -78,16 +112,42 @@ class FusionCategoryScheme(Struct, frozen=True, rename={"agency": "agencyId"}):
     version: str = "1.0"
     items: Sequence[FusionCategory] = ()
 
-    def to_model(self) -> CS:
+    def __group_refs(
+        self,
+        categorisations: Sequence[FusionCategorisation],
+        dataflows: Sequence[FusionDataflow],
+    ) -> Tuple[
+        dict[str, list[DF]], dict[str, list[Union[ItemReference, Reference]]]
+    ]:
+        flows: defaultdict[str, list[DF]] = defaultdict(list)
+        other: defaultdict[str, list[Union[ItemReference, Reference]]] = (
+            defaultdict(list)
+        )
+        for c in categorisations:
+            ref = parse_urn(c.structureReference)
+            src = c.categoryReference[c.categoryReference.find(")") + 2 :]
+            if ref.sdmx_type == "Dataflow":
+                d = find_by_urn(dataflows, c.structureReference)
+                flows[src].append(d.to_model())
+            else:
+                other[src].append(ref)
+        return (flows, other)
+
+    def to_model(
+        self,
+        categorisations: Sequence[FusionCategorisation] = (),
+        dataflows: Sequence[FusionDataflow] = (),
+    ) -> CS:
         """Converts a JsonCodelist to a standard codelist."""
         description = self.descriptions[0].value if self.descriptions else None
+        cat_flows, cat_others = self.__group_refs(categorisations, dataflows)
         return CS(
             id=self.id,
             name=self.names[0].value,
             agency=self.agency,
             description=description,
             version=self.version,
-            items=[c.to_model() for c in self.items],
+            items=[c.to_model(cat_flows, cat_others) for c in self.items],
         )
 
 
@@ -98,43 +158,11 @@ class FusionCategorySchemeMessage(Struct, frozen=True):
     Categorisation: Sequence[FusionCategorisation] = ()
     Dataflow: Sequence[FusionDataflow] = ()
 
-    def __group_flows(self) -> defaultdict[str, list[DF]]:
-        out: defaultdict[str, list[DF]] = defaultdict(list)
-        for c in self.Categorisation:
-            d = find_by_urn(self.Dataflow, c.structureReference)
-            src = c.categoryReference[c.categoryReference.find(")") + 2 :]
-            out[src].append(d.to_model())
-        return out
-
-    def __add_flows(
-        self, cat: Category, cni: str, cf: Dict[str, list[DF]]
-    ) -> None:
-        if cat.categories:
-            for c in cat.categories:
-                self.__add_flows(c, f"{cni}.{c.id}", cf)
-        if cni in cf:
-            dfrefs = [
-                DataflowRef(
-                    (
-                        df.agency.id
-                        if isinstance(df.agency, Agency)
-                        else df.agency
-                    ),
-                    df.id,
-                    df.version,
-                    df.name,
-                )
-                for df in cf[cni]
-            ]
-            cat.dataflows = dfrefs
-
     def to_model(self) -> CS:
         """Returns the requested category scheme."""
-        cf = self.__group_flows()
-        cs = self.CategoryScheme[0].to_model()
-        for c in cs:
-            self.__add_flows(c, c.id, cf)
-        return cs
+        return self.CategoryScheme[0].to_model(
+            self.Categorisation, self.Dataflow
+        )
 
 
 class FusionCategorisationMessage(Struct, frozen=True):

{pysdmx-1.8.0 → pysdmx-1.9.0}/src/pysdmx/io/json/fusion/messages/msd.py

@@ -29,7 +29,7 @@ class FusionMetadataAttribute(Struct, frozen=True):
     id: str
     concept: str
     minOccurs: int
-    maxOccurs: Union[int, Literal["unbounded"]]
+    maxOccurs: Union[int, Literal["unbounded"]] = "unbounded"
     presentational: Optional[bool] = False
     representation: Optional[FusionRepresentation] = None
     metadataAttributes: Sequence["FusionMetadataAttribute"] = ()

{pysdmx-1.8.0 → pysdmx-1.9.0}/src/pysdmx/io/json/sdmxjson2/messages/category.py

@@ -1,7 +1,7 @@
 """Collection of SDMX-JSON schemas for categories and category schemes."""
 
 from collections import defaultdict
-from typing import Dict, Sequence
+from typing import Dict, Optional, Sequence, Tuple, Union
 
 from msgspec import Struct
 
@@ -20,8 +20,10 @@ from pysdmx.model import (
     CategoryScheme,
     Dataflow,
     DataflowRef,
+    ItemReference,
+    Reference,
 )
-from pysdmx.util import find_by_urn
+from pysdmx.util import find_by_urn, parse_urn
 
 
 class JsonCategorisation(
@@ -84,14 +86,46 @@ class JsonCategory(NameableType, frozen=True, omit_defaults=True):
 
     categories: Sequence["JsonCategory"] = ()
 
-    def to_model(self) -> Category:
+    def __add_flows(
+        self, cni: str, cf: Dict[str, list[Dataflow]]
+    ) -> Sequence[DataflowRef]:
+        if cni in cf:
+            return [
+                DataflowRef(
+                    (
+                        df.agency.id
+                        if isinstance(df.agency, Agency)
+                        else df.agency
+                    ),
+                    df.id,
+                    df.version,
+                    df.name,
+                )
+                for df in cf[cni]
+            ]
+        else:
+            return ()
+
+    def to_model(
+        self,
+        cat_flows: dict[str, list[Dataflow]],
+        cat_other: dict[str, list[Union[ItemReference, Reference]]],
+        parent_id: Optional[str] = None,
+    ) -> Category:
         """Converts a FusionCode to a standard code."""
+        cni = f"{parent_id}.{self.id}" if parent_id else self.id
+        dataflows = self.__add_flows(cni, cat_flows)
+        others = cat_other.get(cni, ())
         return Category(
             id=self.id,
             name=self.name,
             description=self.description,
-            categories=[c.to_model() for c in self.categories],
+            categories=[
+                c.to_model(cat_flows, cat_other, cni) for c in self.categories
+            ],
             annotations=[a.to_model() for a in self.annotations],
+            dataflows=dataflows,
+            other_references=others,
         )
 
     @classmethod
@@ -126,15 +160,42 @@ class JsonCategoryScheme(
 
     categories: Sequence[JsonCategory] = ()
 
-    def to_model(self) -> CategoryScheme:
-        """Converts a JsonCodelist to a standard codelist."""
+    def __group_refs(
+        self,
+        categorisations: Sequence[JsonCategorisation] = (),
+        dataflows: Sequence[JsonDataflow] = (),
+    ) -> Tuple[
+        dict[str, list[Dataflow]],
+        dict[str, list[Union[ItemReference, Reference]]],
+    ]:
+        flows: defaultdict[str, list[Dataflow]] = defaultdict(list)
+        other: defaultdict[str, list[Union[ItemReference, Reference]]] = (
+            defaultdict(list)
+        )
+        for c in categorisations:
+            ref = parse_urn(c.source)
+            src = c.target[c.target.find(")") + 2 :]
+            if ref.sdmx_type == "Dataflow":
+                d = find_by_urn(dataflows, c.source)
+                flows[src].append(d.to_model())
+            else:
+                other[src].append(ref)
+        return (flows, other)
+
+    def to_model(
+        self,
+        categorisations: Sequence[JsonCategorisation] = (),
+        dataflows: Sequence[JsonDataflow] = (),
+    ) -> CategoryScheme:
+        """Converts a JsonCategoryScheme to a standard one."""
+        cat_flows, cat_other = self.__group_refs(categorisations, dataflows)
         return CategoryScheme(
             id=self.id,
             name=self.name,
             agency=self.agency,
             description=self.description,
             version=self.version,
-            items=[c.to_model() for c in self.categories],
+            items=[c.to_model(cat_flows, cat_other) for c in self.categories],
             is_external_reference=self.isExternalReference,
             is_partial=self.isPartial,
             valid_from=self.validFrom,
@@ -179,49 +240,21 @@ class JsonCategorySchemes(Struct, frozen=True, omit_defaults=True):
     categorisations: Sequence[JsonCategorisation] = ()
     dataflows: Sequence[JsonDataflow] = ()
 
+    def to_model(self) -> CategoryScheme:
+        """Returns the requested codelist."""
+        return self.categorySchemes[0].to_model(
+            self.categorisations, self.dataflows
+        )
+
 
 class JsonCategorySchemeMessage(Struct, frozen=True, omit_defaults=True):
     """SDMX-JSON payload for /categoryscheme queries."""
 
     data: JsonCategorySchemes
 
-    def __group_flows(self) -> defaultdict[str, list[Dataflow]]:
-        out: defaultdict[str, list[Dataflow]] = defaultdict(list)
-        for c in self.data.categorisations:
-            d = find_by_urn(self.data.dataflows, c.source)
-            src = c.target[c.target.find(")") + 2 :]
-            out[src].append(d.to_model())
-        return out
-
-    def __add_flows(
-        self, cat: Category, cni: str, cf: Dict[str, list[Dataflow]]
-    ) -> None:
-        if cat.categories:
-            for c in cat.categories:
-                self.__add_flows(c, f"{cni}.{c.id}", cf)
-        if cni in cf:
-            dfrefs = [
-                DataflowRef(
-                    (
-                        df.agency.id
-                        if isinstance(df.agency, Agency)
-                        else df.agency
-                    ),
-                    df.id,
-                    df.version,
-                    df.name,
-                )
-                for df in cf[cni]
-            ]
-            cat.dataflows = dfrefs
-
     def to_model(self) -> CategoryScheme:
-        """Returns the requested codelist."""
-        cf = self.__group_flows()
-        cs = self.data.categorySchemes[0].to_model()
-        for c in cs:
-            self.__add_flows(c, c.id, cf)
-        return cs
+        """Returns the requested category scheme."""
+        return self.data.to_model()
 
 
 class JsonCategorisations(Struct, frozen=True, omit_defaults=True):

{pysdmx-1.8.0 → pysdmx-1.9.0}/src/pysdmx/io/json/sdmxjson2/messages/core.py

@@ -299,6 +299,7 @@ class JsonHeader(msgspec.Struct, frozen=True, omit_defaults=True):
             test=self.test,
             prepared=self.prepared,
             sender=self.sender,
+            receiver=self.receivers if self.receivers else (),
         )
 
     @classmethod
@@ -313,7 +314,7 @@ class JsonHeader(msgspec.Struct, frozen=True, omit_defaults=True):
             header.prepared,
             header.sender,
             header.test,
-            receivers=(header.receiver,) if header.receiver else None,
+            receivers=header.receiver if header.receiver else None,
             schema=(
                 "https://raw.githubusercontent.com/sdmx-twg/sdmx-json/"
                 "develop/structure-message/tools/schemas/2.0.0/"

{pysdmx-1.8.0 → pysdmx-1.9.0}/src/pysdmx/io/json/sdmxjson2/messages/msd.py

@@ -37,6 +37,7 @@ class JsonMetadataAttribute(Struct, frozen=True, omit_defaults=True):
     maxOccurs: Union[int, Literal["unbounded"]]
     isPresentational: bool
     localRepresentation: Optional[JsonRepresentation] = None
+    metadataAttributes: Sequence["JsonMetadataAttribute"] = ()
 
     def to_model(
         self, cs: Sequence[JsonConceptScheme], cls: Sequence[Codelist]
@@ -72,7 +73,7 @@ class JsonMetadataAttribute(Struct, frozen=True, omit_defaults=True):
             local_codes=codes,
             array_def=ab,
             local_enum_ref=local_enum_ref,
-            components=(),
+            components=[a.to_model(cs, cls) for a in self.metadataAttributes],
         )
 
     @classmethod
@@ -94,6 +95,9 @@ class JsonMetadataAttribute(Struct, frozen=True, omit_defaults=True):
             minOccurs=min_occurs,
             maxOccurs=max_occurs,
             isPresentational=cmp.is_presentational,
+            metadataAttributes=[
+                JsonMetadataAttribute.from_model(c) for c in cmp.components
+            ],
         )
 
 

pysdmx-1.9.0/src/pysdmx/io/json/sdmxjson2/reader/doc_validation.py

@@ -0,0 +1,108 @@
+"""SDMX-JSON document validation against JSON schemas."""
+
+import json
+import re
+from pathlib import Path
+from typing import Any, Callable, Mapping, Match, Optional
+
+from jsonschema import Draft202012Validator
+from jsonschema.exceptions import ValidationError
+from sdmxschemas import SDMX_JSON_20_DATA_PATH as SCHEMA_PATH_JSON20_DATA
+from sdmxschemas import (
+    SDMX_JSON_20_METADATA_PATH as SCHEMA_PATH_JSON20_METADATA,
+)
+from sdmxschemas import (
+    SDMX_JSON_20_STRUCTURE_PATH as SCHEMA_PATH_JSON20_STRUCTURE,
+)
+
+from pysdmx import errors
+
+_SCHEMA_FILES: Mapping[str, Path] = {
+    "structure": SCHEMA_PATH_JSON20_STRUCTURE,
+    "metadata": SCHEMA_PATH_JSON20_METADATA,
+    "data": SCHEMA_PATH_JSON20_DATA,
+}
+
+
+def _schema_for(instance: Mapping[str, Any]) -> dict[str, Any]:
+    schema_url = instance.get("meta", {}).get("schema")
+    p = next(p for p in _SCHEMA_FILES.values() if p.name in schema_url)
+    with p.open("r", encoding="utf-8") as f:
+        schema = json.load(f)
+    return schema
+
+
+def validate_sdmx_json(input_str: str) -> None:
+    """Validates an SDMX-JSON message against the appropriate JSON schema.
+
+    Args: input_str: The SDMX-JSON message to validate.
+    Raises:
+        invalid: If the SDMX-JSON message does not validate against the schema.
+
+    """
+    instance = json.loads(input_str)
+    schema = _schema_for(instance)
+    validator = Draft202012Validator(schema)
+
+    failures = sorted(
+        validator.iter_errors(instance),
+        key=lambda e: (list(e.path), e.message),
+    )
+    if failures:
+
+        def compact(e: ValidationError) -> str:
+            path = "$" if not e.path else "$." + ".".join(map(str, e.path))
+            sub = " | ".join(
+                getattr(e, "context", [])
+                and [c.message for c in e.context]
+                or []
+            )
+            raw = f"{e.message} | {sub}"
+
+            patterns: list[tuple[str, Callable[[Match[str]], str]]] = [
+                (
+                    r"Additional properties are not allowed.*'([^']+)'",
+                    lambda m: f"unexpected property '{m.group(1)}'",
+                ),
+                (
+                    r"is not of type '([^']+)'",
+                    lambda m: f"invalid type (expected {m.group(1)})",
+                ),
+                (
+                    r"""['"]?([^'"\n]+)['"]?\s+is not one of\s+\[([^\]]+)\]""",
+                    lambda m: "invalid value {!r}"
+                    " (expected one of: {})".format(
+                        m.group(1),
+                        ", ".join(
+                            s.strip().strip("'\"")
+                            for s in m.group(2).split(",")
+                        ),
+                    ),
+                ),
+                (
+                    r"'([^']+)' is a required property",
+                    lambda m: f"missing property '{m.group(1)}'",
+                ),
+                (
+                    r"""does not match ['"]([^'"]+)['"]""",
+                    lambda m: f"does not match required"
+                    f" pattern {m.group(1)!r}",
+                ),
+            ]
+
+            msg: Optional[str] = next(
+                (
+                    fmt(re.search(rx, raw))  # type: ignore[arg-type]
+                    for rx, fmt in patterns
+                    if re.search(rx, raw)
+                ),
+                None,
+            )
+            msg = msg or e.message
+            return f"{path}: {msg}"
+
+        summary = "; ".join(compact(e) for e in failures[:3])
+        more = (
+            f" (+{len(failures) - 3} more errors)" if len(failures) > 3 else ""
+        )
+        raise errors.Invalid("Validation Error", f"{summary}{more}")

{pysdmx-1.8.0 → pysdmx-1.9.0}/src/pysdmx/io/json/sdmxjson2/reader/metadata.py

@@ -3,20 +3,27 @@
 import msgspec
 
 from pysdmx import errors
+from pysdmx.__extras_check import __check_json_extra
 from pysdmx.io.json.sdmxjson2.messages import JsonMetadataMessage
+from pysdmx.io.json.sdmxjson2.reader.doc_validation import validate_sdmx_json
 from pysdmx.model import decoders
 from pysdmx.model.message import MetadataMessage
 
 
-def read(input_str: str) -> MetadataMessage:
+def read(input_str: str, validate: bool = True) -> MetadataMessage:
     """Read an SDMX-JSON 2.0.0 Metadata Message.
 
     Args:
         input_str: SDMX-JSON reference metadata message to read.
+        validate: If True, the JSON data will be validated against the schemas.
 
     Returns:
         A pysdmx MetadataMessage
     """
+    if validate:
+        __check_json_extra()
+        validate_sdmx_json(input_str)
+
     try:
         msg = msgspec.json.Decoder(
             JsonMetadataMessage, dec_hook=decoders

{pysdmx-1.8.0 → pysdmx-1.9.0}/src/pysdmx/io/json/sdmxjson2/reader/structure.py

@@ -3,20 +3,27 @@
 import msgspec
 
 from pysdmx import errors
+from pysdmx.__extras_check import __check_json_extra
 from pysdmx.io.json.sdmxjson2.messages import JsonStructureMessage
+from pysdmx.io.json.sdmxjson2.reader.doc_validation import validate_sdmx_json
 from pysdmx.model import decoders
 from pysdmx.model.message import StructureMessage
 
 
-def read(input_str: str) -> StructureMessage:
-    """Read an SDMX-JSON 2.0.0 Stucture Message.
+def read(input_str: str, validate: bool = True) -> StructureMessage:
+    """Read an SDMX-JSON 2.0.0 Structure Message.
 
     Args:
         input_str: SDMX-JSON structure message to read.
+        validate: If True, the JSON data will be validated against the schemas.
 
     Returns:
         A pysdmx StructureMessage
     """
+    if validate:
+        __check_json_extra()
+        validate_sdmx_json(input_str)
+
     try:
         msg = msgspec.json.Decoder(
             JsonStructureMessage, dec_hook=decoders