stbkit 0.1.0a9.dev1__py3-none-any.whl

stbkit/tools/_internal/stb_io.py

@@ -0,0 +1,116 @@
+# Copyright 2026 TAISEI CORPORATION
+# SPDX-License-Identifier: MPL-2.0
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+from logging import Logger
+
+from stbkit.core._internal.constants import (
+    DEFAULT_MAX_XML_DEPTH,
+    DEFAULT_MAX_XML_SIZE,
+)
+from stbkit.core.data_model.common import StBridgeRoot
+from stbkit.core.stb_io import load, loads
+from stbkit.core.stb_reporting import Reporter
+from stbkit.core.stb_typing import TextSource
+
+from stbkit.api import stb_latest
+
+from ..upgrade import upgrade_to_latest
+
+
+def load_latest(
+    fp: TextSource,
+    *,
+    encoding: str | None = None,
+    max_size: int = DEFAULT_MAX_XML_SIZE,
+    max_depth: int = DEFAULT_MAX_XML_DEPTH,
+    logger: Logger | None = None,
+    reporter: Reporter | None = None,
+) -> stb_latest.StBridge:
+    """ST-Bridgeファイルを読み込み、最新版のデータモデルへ変換して返します。
+
+    Args:
+        fp: 読み込むファイルのパス、または開いたテキストストリーム。
+        encoding: ファイルのエンコーディング。
+            Noneの場合は自動判定し、判定できない場合はUTF-8を使用します。
+            fpがストリームの場合は無視します。
+        max_size: 読み込むサイズの上限。超えた場合は読み込みを中止します。
+        max_depth: 要素の階層の上限。超えた場合は読み込みを中止します。
+        logger: 出力先Logger。
+        reporter: 出力先Reporter。
+
+    Returns:
+        StBridge: 最新版のST-Bridgeのルート要素。
+
+    Raises:
+        OSError: ファイルを開けない場合。存在しない場合はサブクラスのFileNotFoundErrorを投げます。
+        LookupError: encodingに未知のエンコーディング名を指定した場合。
+        UnicodeDecodeError: デコードできない場合。
+        UnsafeXmlError: DOCTYPE宣言が含まれる場合。
+        XmlLimitExceededError: max_sizeまたはmax_depthを超えた場合。
+        SchemaError: versionを省略したときにversionが取得できなかった場合。
+        UnsupportedStbVersionError: 対応していないバージョンの場合。
+        xml.etree.ElementTree.ParseError: XMLとして解析できない場合。
+
+    Examples:
+        >>> import stbkit.api
+        >>> stb = stbkit.api.load_latest("model.stb")
+    """
+    stb: StBridgeRoot = load(
+        fp,
+        encoding=encoding,
+        max_size=max_size,
+        max_depth=max_depth,
+        logger=logger,
+        reporter=reporter,
+    )
+    latest: stb_latest.StBridge = upgrade_to_latest(
+        stb, logger=logger, reporter=reporter
+    )
+    return latest
+
+
+def loads_latest(
+    s: str,
+    *,
+    max_size: int = DEFAULT_MAX_XML_SIZE,
+    max_depth: int = DEFAULT_MAX_XML_DEPTH,
+    logger: Logger | None = None,
+    reporter: Reporter | None = None,
+) -> stb_latest.StBridge:
+    """XML文字列をST-Bridgeのデータモデルへ読み込み、最新版のデータモデルへ変換して返します。
+
+    Args:
+        s: 読み込むST-BridgeのXML文字列。
+        max_size: 読み込む文字数の上限。超えた場合は読み込みを中止します。
+        max_depth: 要素の階層の上限。超えた場合は読み込みを中止します。
+        logger: 出力先Logger。
+        reporter: 出力先Reporter。
+
+    Returns:
+        StBridgeRoot: 最新版のST-Bridgeのルート要素。
+
+    Raises:
+        UnsafeXmlError: DOCTYPE宣言が含まれる場合。
+        XmlLimitExceededError: max_sizeまたはmax_depthを超えた場合。
+        SchemaError: versionを省略したときにversionが取得できなかった場合。
+        UnsupportedStbVersionError: 対応していないバージョンの場合。
+        xml.etree.ElementTree.ParseError: XMLとして解析できない場合。
+
+    Examples:
+        >>> import stbkit.api
+        >>> stb = stbkit.api.loads_latest(xml_text)
+    """
+    stb: StBridgeRoot = loads(
+        s,
+        max_size=max_size,
+        max_depth=max_depth,
+        logger=logger,
+        reporter=reporter,
+    )
+    latest: stb_latest.StBridge = upgrade_to_latest(
+        stb, logger=logger, reporter=reporter
+    )
+    return latest

stbkit/tools/_internal/stb_repair/_common.py

@@ -0,0 +1,24 @@
+# Copyright 2026 TAISEI CORPORATION
+# SPDX-License-Identifier: MPL-2.0
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+from dataclasses import dataclass
+
+from stbkit.core.stb_reporting import Reporter
+
+
+@dataclass
+class Defaults:
+    steel_strength: str
+    default_length: float
+    default_float: float = 0.0
+    default_string: str = "repair"
+
+
+@dataclass
+class RepairContext:
+    defaults: Defaults
+    reporter: Reporter
+    unknown_section_id: int | None = None

stbkit/tools/_internal/stb_repair/_stb_repair.py

@@ -0,0 +1,197 @@
+# Copyright 2026 TAISEI CORPORATION
+# SPDX-License-Identifier: MPL-2.0
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+from typing import Any, get_args
+
+from stbkit.core._internal.name_converter import private_field_name
+from stbkit.core.data_model import stb_v2_0_2, stb_v2_1_0, stb_v2_1_1
+from stbkit.core.data_model._internal.stb_types import DataType
+from stbkit.core.data_model.common import (
+    StBridgeElement,
+    StBridgeRoot,
+    _FieldInfo,
+    _FieldKind,
+)
+from stbkit.core.stb_reporting import Code, Phase, Reporter, get_reporter
+
+from ..constants import REPAIR_DEFAULT_LENGTH_MM
+from . import _stb_v2_0_2_repair, _stb_v2_1_0_repair, _stb_v2_1_1_repair
+from ._common import Defaults, RepairContext
+
+
+def _repair_required_length(
+    element: StBridgeElement, *, context: RepairContext
+) -> None:
+    for key, field_info in element._fields.items():
+        p_name: str = private_field_name(key)
+        if field_info.required and field_info.data_type == DataType.LENGTH:
+            value = getattr(element, p_name)
+            if value is None or value <= 0:
+                context.reporter.warning(
+                    message=(
+                        f"属性[{key}]の値[{value}]は不正な長さであるため、デフォルト値[{context.defaults.default_length}]に修復します"
+                    ),
+                    code=Code.REPAIR_LOG,
+                    phase=Phase.REPAIR,
+                    stb_element=element,
+                    attr_name=key,
+                )
+                setattr(element, p_name, context.defaults.default_length)
+        elif field_info.required and field_info.data_type == DataType.FLOAT:
+            value = getattr(element, p_name)
+            if value is None:
+                context.reporter.warning(
+                    message=(
+                        f"属性[{key}]の値がNoneであるため、デフォルト値[{context.defaults.default_float}]に修復します"
+                    ),
+                    code=Code.REPAIR_LOG,
+                    phase=Phase.REPAIR,
+                    stb_element=element,
+                    attr_name=key,
+                )
+                setattr(element, p_name, context.defaults.default_float)
+        if field_info.kind == _FieldKind.ELEMENT:
+            child = getattr(element, p_name)
+            if isinstance(child, StBridgeElement):
+                _repair_required_length(child, context=context)
+            elif isinstance(child, list):
+                for c in child:
+                    if isinstance(c, StBridgeElement):
+                        _repair_required_length(c, context=context)
+
+
+def _default_value_for_field(
+    field_info: _FieldInfo, *, defaults: Defaults
+) -> Any | None:
+    match field_info.data_type:
+        case DataType.FLOAT:
+            return defaults.default_float
+        case DataType.LENGTH | DataType.NON_NEGATIVE_LENGTH:
+            return defaults.default_length
+        case DataType.STR:
+            return defaults.default_string
+        case _:
+            return None
+
+
+def _fill_required_attributes(
+    element: StBridgeElement, *, context: RepairContext
+) -> None:
+    for key, field_info in element._fields.items():
+        if field_info.kind not in (_FieldKind.ATTRIBUTE, _FieldKind.CONTENT):
+            continue
+        if not field_info.required:
+            continue
+        p_name: str = private_field_name(key)
+        if getattr(element, p_name) is not None:
+            continue
+        default_value = _default_value_for_field(field_info, defaults=context.defaults)
+        if default_value is None:
+            continue
+        context.reporter.warning(
+            message=(
+                f"属性[{key}]が存在しないため、デフォルト値[{default_value}]に修復します"
+            ),
+            code=Code.REPAIR_LOG,
+            phase=Phase.REPAIR,
+            stb_element=element,
+            attr_name=key,
+        )
+        setattr(element, p_name, default_value)
+
+
+def _instantiate_child(
+    field_info: _FieldInfo, *, context: RepairContext
+) -> StBridgeElement | None:
+    element_cls = field_info.py_type
+    if not isinstance(element_cls, type):
+        args = get_args(element_cls)
+        if not args or not isinstance(args[0], type):
+            return None
+        element_cls = args[0]
+    if not issubclass(element_cls, StBridgeElement):
+        return None
+    instance: StBridgeElement = element_cls()
+    _fill_required_attributes(instance, context=context)
+    return instance
+
+
+def _repair_occurs(element: StBridgeElement, *, context: RepairContext) -> None:
+    for key, field_info in element._fields.items():
+        if field_info.kind != _FieldKind.ELEMENT:
+            continue
+        p_name: str = private_field_name(key)
+        value = getattr(element, p_name)
+        if field_info.max_occurs == 1:
+            if value is None and (field_info.min_occurs or 0) >= 1:
+                new_child = _instantiate_child(field_info, context=context)
+                if new_child is not None:
+                    context.reporter.warning(
+                        message=f"必須要素[{key}]が存在しないため追加しました",
+                        code=Code.REPAIR_LOG,
+                        phase=Phase.REPAIR,
+                        stb_element=element,
+                    )
+                    setattr(element, key, new_child)
+                    value = new_child
+            if isinstance(value, StBridgeElement):
+                _repair_occurs(value, context=context)
+        elif isinstance(value, list):
+            if field_info.max_occurs is not None and len(value) > field_info.max_occurs:
+                del value[field_info.max_occurs :]
+                context.reporter.warning(
+                    message=(
+                        f"要素[{key}]が最大回数[{field_info.max_occurs}]を"
+                        "超過しているため削除しました"
+                    ),
+                    code=Code.REPAIR_LOG,
+                    phase=Phase.REPAIR,
+                    stb_element=element,
+                )
+            if field_info.min_occurs is not None and len(value) < field_info.min_occurs:
+                while len(value) < field_info.min_occurs:
+                    new_child = _instantiate_child(field_info, context=context)
+                    if new_child is None:
+                        break
+                    value.append(new_child)
+                context.reporter.warning(
+                    message=(
+                        f"要素[{key}]が最小回数[{field_info.min_occurs}]に"
+                        "満たないため追加しました"
+                    ),
+                    code=Code.REPAIR_LOG,
+                    phase=Phase.REPAIR,
+                    stb_element=element,
+                )
+            for item in value:
+                if isinstance(item, StBridgeElement):
+                    _repair_occurs(item, context=context)
+
+
+def repair_stb(
+    stb: StBridgeRoot,
+    *,
+    reporter: Reporter | None = None,
+    default_steel_strength: str = "SS400",
+    default_length: float = REPAIR_DEFAULT_LENGTH_MM,
+) -> None:
+    if reporter is None:
+        reporter = get_reporter()
+    defaults: Defaults = Defaults(
+        steel_strength=default_steel_strength, default_length=default_length
+    )
+    context: RepairContext = RepairContext(defaults=defaults, reporter=reporter)
+    _repair_occurs(stb, context=context)
+    _repair_required_length(stb, context=context)
+    match stb:
+        case stb_v2_1_1.StBridge():
+            _stb_v2_1_1_repair.repair_stb(stb, context=context)
+        case stb_v2_1_0.StBridge():
+            _stb_v2_1_0_repair.repair_stb(stb, context=context)
+        case stb_v2_0_2.StBridge():
+            _stb_v2_0_2_repair.repair_stb(stb, context=context)
+        case _:
+            pass

stbkit/tools/_internal/stb_repair/_stb_v2_0_2_repair.py

@@ -0,0 +1,53 @@
+# Copyright 2026 TAISEI CORPORATION
+# SPDX-License-Identifier: MPL-2.0
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+from stbkit.core.data_model.stb_v2_0_2 import StbGirder, StBridge
+from stbkit.core.stb_exceptions import NoneAccessError
+from stbkit.core.stb_reporting import Code, Phase
+
+from ._common import RepairContext
+
+
+def _repair_stb_girder(stb: StBridge, *, context: RepairContext) -> None:
+    # isfoundationが無い場合falseを入れる
+    try:
+        girders: list[StbGirder] = stb.stb_model.stb_members.stb_girders.stb_girder
+    except NoneAccessError:
+        return
+    for girder in girders:
+        if girder.is_foundation_or_none is None:
+            girder.is_foundation = False
+            context.reporter.warning(
+                "StbGirderのisfoundationがNoneなのでFalseに設定しました",
+                code=Code.REPAIR_LOG,
+                phase=Phase.REPAIR,
+                stb_element=girder,
+            )
+
+
+def _repair_stb_joint_beam_shape_h(stb: StBridge, *, context: RepairContext) -> None:
+    try:
+        joints = stb.stb_model.stb_joints.stb_joint_beam_shape_h
+    except NoneAccessError:
+        return
+    for joint in joints:
+        if (
+            joint.stb_joint_shape_h_or_none is not None
+            and joint.stb_joint_shape_h.strength_plate_or_none is None
+        ):
+            joint.stb_joint_shape_h.strength_plate = context.defaults.steel_strength
+            context.reporter.warning(
+                "StbJointShapeHのstrength_plateがNoneなので、デフォルト値を設定しました",
+                code=Code.REPAIR_LOG,
+                phase=Phase.REPAIR,
+                stb_element=joint.stb_joint_shape_h,
+                attr_name="strength_plate",
+            )
+
+
+def repair_stb(stb: StBridge, *, context: RepairContext) -> None:
+    _repair_stb_girder(stb, context=context)
+    _repair_stb_joint_beam_shape_h(stb, context=context)

stbkit/tools/_internal/stb_repair/_stb_v2_1_0_repair.py

@@ -0,0 +1,109 @@
+# Copyright 2026 TAISEI CORPORATION
+# SPDX-License-Identifier: MPL-2.0
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+import uuid
+
+from stbkit.core.data_model.stb_v2_1_0 import (
+    StbGirder,
+    StBridge,
+    StbSections,
+    StbSecUndefined,
+)
+from stbkit.core.repository import RepositoryV2_1_0
+from stbkit.core.stb_exceptions import NoneAccessError
+from stbkit.core.stb_reporting import Code, Phase
+
+from ._common import RepairContext
+
+
+def _get_unknown_section_id(stb: StBridge, *, context: RepairContext) -> int:
+    if context.unknown_section_id is not None:
+        return context.unknown_section_id
+    sections: StbSections = stb.ensure.stb_model().ensure.stb_sections()
+    max_id: int = 1
+    for sec in sections.stb_sec_undefined:
+        max_id = max(max_id, sec.id)
+    unknown_id: int = max_id + 1
+    context.unknown_section_id = unknown_id
+    undefined: StbSecUndefined = StbSecUndefined(
+        id=unknown_id,
+        name="不明断面(stbkitにより自動生成)",
+        guid=uuid.uuid4(),
+    )
+    sections.stb_sec_undefined.append(undefined)
+    context.reporter.warning(
+        f"構造不明断面(id={unknown_id})を新規に作成しました",
+        code=Code.REPAIR_LOG,
+        phase=Phase.REPAIR,
+        stb_element=undefined,
+    )
+    return unknown_id
+
+
+def _repair_stb_girder(
+    stb: StBridge, *, context: RepairContext, repo: RepositoryV2_1_0
+) -> None:
+    # isfoundationが無い場合falseを入れる
+    try:
+        girders: list[StbGirder] = stb.stb_model.stb_members.stb_girders.stb_girder
+    except NoneAccessError:
+        return
+    for girder in girders:
+        if girder.is_foundation_or_none is None:
+            girder.is_foundation = False
+            context.reporter.warning(
+                "StbGirderのisfoundationがNoneなのでFalseに設定しました",
+                code=Code.REPAIR_LOG,
+                phase=Phase.REPAIR,
+                stb_element=girder,
+            )
+        if repo.deref(girder).id_section_or_none is None:
+            unknown_id = _get_unknown_section_id(stb, context=context)
+            girder.id_section = unknown_id
+            context.reporter.warning(
+                f"StbGirderのid_sectionが不正な参照なので、構造不明断面(id={unknown_id})を設定しました",
+                code=Code.REPAIR_LOG,
+                phase=Phase.REPAIR,
+                stb_element=girder,
+                attr_name="id_section",
+            )
+            if girder.kind_structure_or_none != "UNDEFINED":
+                girder.kind_structure = "UNDEFINED"
+                context.reporter.warning(
+                    "StbGirderのid_sectionが不正な参照なので、構造種別をUNDEFINEDに設定しました",
+                    code=Code.REPAIR_LOG,
+                    phase=Phase.REPAIR,
+                    stb_element=girder,
+                    attr_name="kind_structure",
+                )
+
+
+def _repair_stb_joint_beam_shape_h(stb: StBridge, *, context: RepairContext) -> None:
+    try:
+        joints = stb.stb_model.stb_joints.stb_joint_beam_shape_h
+    except NoneAccessError:
+        return
+    for joint in joints:
+        if (
+            joint.stb_joint_shape_h_or_none is not None
+            and joint.stb_joint_shape_h.strength_plate_flange_or_none is None
+        ):
+            joint.stb_joint_shape_h.strength_plate_flange_or_none = (
+                context.defaults.steel_strength
+            )
+            context.reporter.warning(
+                "StbJointShapeHのstrength_plate_flangeがNoneなので、デフォルト値を設定しました",
+                code=Code.REPAIR_LOG,
+                phase=Phase.REPAIR,
+                stb_element=joint.stb_joint_shape_h,
+                attr_name="strength_plate_flange",
+            )
+
+
+def repair_stb(stb: StBridge, *, context: RepairContext) -> None:
+    repo: RepositoryV2_1_0 = RepositoryV2_1_0(stb)
+    _repair_stb_girder(stb, context=context, repo=repo)
+    _repair_stb_joint_beam_shape_h(stb, context=context)

stbkit/tools/_internal/stb_repair/_stb_v2_1_1_repair.py

@@ -0,0 +1,109 @@
+# Copyright 2026 TAISEI CORPORATION
+# SPDX-License-Identifier: MPL-2.0
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+import uuid
+
+from stbkit.core.data_model.stb_v2_1_1 import (
+    StbGirder,
+    StBridge,
+    StbSections,
+    StbSecUndefined,
+)
+from stbkit.core.repository import RepositoryV2_1_1
+from stbkit.core.stb_exceptions import NoneAccessError
+from stbkit.core.stb_reporting import Code, Phase
+
+from ._common import RepairContext
+
+
+def _get_unknown_section_id(stb: StBridge, *, context: RepairContext) -> int:
+    if context.unknown_section_id is not None:
+        return context.unknown_section_id
+    sections: StbSections = stb.ensure.stb_model().ensure.stb_sections()
+    max_id: int = 1
+    for sec in sections.stb_sec_undefined:
+        max_id = max(max_id, sec.id)
+    unknown_id: int = max_id + 1
+    context.unknown_section_id = unknown_id
+    undefined: StbSecUndefined = StbSecUndefined(
+        id=unknown_id,
+        name="不明断面(stbkitにより自動生成)",
+        guid=uuid.uuid4(),
+    )
+    sections.stb_sec_undefined.append(undefined)
+    context.reporter.warning(
+        f"構造不明断面(id={unknown_id})を新規に作成しました",
+        code=Code.REPAIR_LOG,
+        phase=Phase.REPAIR,
+        stb_element=undefined,
+    )
+    return unknown_id
+
+
+def _repair_stb_girder(
+    stb: StBridge, *, context: RepairContext, repo: RepositoryV2_1_1
+) -> None:
+    # isfoundationが無い場合falseを入れる
+    try:
+        girders: list[StbGirder] = stb.stb_model.stb_members.stb_girders.stb_girder
+    except NoneAccessError:
+        return
+    for girder in girders:
+        if girder.is_foundation_or_none is None:
+            girder.is_foundation = False
+            context.reporter.warning(
+                "StbGirderのisfoundationがNoneなのでFalseに設定しました",
+                code=Code.REPAIR_LOG,
+                phase=Phase.REPAIR,
+                stb_element=girder,
+            )
+        if repo.deref(girder).id_section_or_none is None:
+            unknown_id = _get_unknown_section_id(stb, context=context)
+            girder.id_section = unknown_id
+            context.reporter.warning(
+                f"StbGirderのid_sectionが不正な参照なので、構造不明断面(id={unknown_id})を設定しました",
+                code=Code.REPAIR_LOG,
+                phase=Phase.REPAIR,
+                stb_element=girder,
+                attr_name="id_section",
+            )
+            if girder.kind_structure_or_none != "UNDEFINED":
+                girder.kind_structure = "UNDEFINED"
+                context.reporter.warning(
+                    "StbGirderのid_sectionが不正な参照なので、構造種別をUNDEFINEDに設定しました",
+                    code=Code.REPAIR_LOG,
+                    phase=Phase.REPAIR,
+                    stb_element=girder,
+                    attr_name="kind_structure",
+                )
+
+
+def _repair_stb_joint_beam_shape_h(stb: StBridge, *, context: RepairContext) -> None:
+    try:
+        joints = stb.stb_model.stb_joints.stb_joint_beam_shape_h
+    except NoneAccessError:
+        return
+    for joint in joints:
+        if (
+            joint.stb_joint_shape_h_or_none is not None
+            and joint.stb_joint_shape_h.strength_plate_flange_or_none is None
+        ):
+            joint.stb_joint_shape_h.strength_plate_flange_or_none = (
+                context.defaults.steel_strength
+            )
+            context.reporter.warning(
+                "StbJointShapeHのstrength_plate_flangeがNoneなので、デフォルト値を設定しました",
+                code=Code.REPAIR_LOG,
+                phase=Phase.REPAIR,
+                stb_element=joint.stb_joint_shape_h,
+                attr_name="strength_plate_flange",
+            )
+
+
+def repair_stb(stb: StBridge, *, context: RepairContext) -> None:
+    repo: RepositoryV2_1_1 = RepositoryV2_1_1(stb)
+    _repair_stb_girder(stb, context=context, repo=repo)
+    _repair_stb_joint_beam_shape_h(stb, context=context)

stbkit/tools/_internal/studio_report.py

@@ -0,0 +1,49 @@
+# Copyright 2026 TAISEI CORPORATION
+# SPDX-License-Identifier: MPL-2.0
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
+"""StudioAppへ渡すReporter結果文字列を生成するモジュール"""
+
+import json
+from dataclasses import asdict
+from pathlib import Path
+
+from stbkit.core.data_model.common import StBridgeRoot
+from stbkit.core.stb_io import load, loads
+from stbkit.core.stb_reporting import (
+    CollectingReporter,
+    NullReporter,
+    Reporter,
+    ReportingResult,
+)
+from stbkit.core.validation import validate_schema
+
+
+def _read_source(source: str, is_path: bool, *, reporter: Reporter) -> StBridgeRoot:
+    """Rustから渡されたST-Bridgeデータを読み込む
+
+    Rust側の読み込みの都合でpathで渡される場合と文字列で渡される場合がある。
+    """
+    if is_path:
+        return load(Path(source), reporter=reporter)
+    return loads(source, reporter=reporter)
+
+
+def load_report_json(source: str, is_path: bool) -> str:
+    reporter: CollectingReporter = CollectingReporter()
+    _read_source(source, is_path, reporter=reporter)
+    return _report_to_json(reporter.report)
+
+
+def validation_report_json(source: str, is_path: bool) -> str:
+    stb: StBridgeRoot = _read_source(source, is_path, reporter=NullReporter())
+    reporter: CollectingReporter = CollectingReporter()
+    validate_schema(stb, reporter=reporter, require_xsd=False)
+    return _report_to_json(reporter.report)
+
+
+def _report_to_json(report: ReportingResult) -> str:
+    payload = [asdict(item) for item in report]
+    return json.dumps(payload, ensure_ascii=False)