stbkit 0.1.0a9.dev1__tar.gz → 0.1.0b2__tar.gz

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stbkit
-Version: 0.1.0a9.dev1
+Version: 0.1.0b2
 Summary: ST-Bridgeを扱うライブラリSTB-KIT
 Author-email: "STB-KIT Development Team (TAISEI CORPORATION)" <oss-dev@pub.taisei.co.jp>
 License-Expression: MPL-2.0
@@ -9,7 +9,7 @@ Project-URL: Repository, https://github.com/taisei-oss/stb-kit
 Project-URL: Issues, https://github.com/taisei-oss/stb-kit/issues
 Project-URL: Changelog, https://github.com/taisei-oss/stb-kit/blob/main/CHANGELOG.md
 Keywords: ST-Bridge,BIM,IFC,structural-engineering,stbridge
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
@@ -27,7 +27,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: stbkit-core==0.1.0a9.dev1
+Requires-Dist: stbkit-core==0.1.0b2
 Provides-Extra: xsd
 Requires-Dist: xmlschema>=4.3.2; extra == "xsd"
 Provides-Extra: ifc
@@ -51,6 +51,8 @@ _ST-Bridge is a structural data exchange format widely used in Japan._
 
 詳細はリポジトリの[README](https://github.com/taisei-oss/stb-kit)および[DISCLAIMER](https://github.com/taisei-oss/stb-kit/blob/main/DISCLAIMER.md)をご確認ください。
 
+![PyPI License](https://img.shields.io/pypi/l/stbkit)
+
 ## 概要
 
 stbkitはST-Bridgeを扱うためのツールキットSTB-KITの統合パッケージです。  
@@ -66,7 +68,7 @@ stbkit-core（データモデル・バリデーション）をコアの依存と
 
 ## インストール(最小構成)
 
-STB-KITは現在アルファ版です。通常のインストールではアルファ版が選ばれない場合があるため、次の例では`--pre`を指定します。利用するアルファ版の番号が分かっている場合は、`stbkit==バージョン番号`のようにバージョンを直接指定することもできます。
+STB-KITは現在ベータ版です。通常のインストールではベータ版が選ばれない場合があるため、次の例では`--pre`を指定します。利用するベータ版の番号が分かっている場合は、`stbkit==バージョン番号`のようにバージョンを直接指定することもできます。
 
 ```bash
 python -m pip install --pre stbkit
@@ -101,7 +103,7 @@ python -m pip install --pre stbkit
 stbkit -h
 ```
 
-- ST-Bridgeをのバリデーションを行う
+- ST-Bridgeのバリデーションを行う
 
 ```bash
 stbkit validate model.stb
@@ -160,10 +162,7 @@ diffは入力が2つあるため対応していません。
 
 ## ドキュメント
 
-ドキュメントは現在準備中です。公開時にこちらへリンクを掲載します。
-
-- ユーザーガイド（準備中）
-- バージョンアップ、IFC変換の仕様（準備中）
+- [STB-KITドキュメント](https://taisei-oss.github.io/stb-kit/)
 
 ## 依存ライブラリ・再配布に関する注意
 

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/README.md

@@ -10,6 +10,8 @@ _ST-Bridge is a structural data exchange format widely used in Japan._
 
 詳細はリポジトリの[README](https://github.com/taisei-oss/stb-kit)および[DISCLAIMER](https://github.com/taisei-oss/stb-kit/blob/main/DISCLAIMER.md)をご確認ください。
 
+![PyPI License](https://img.shields.io/pypi/l/stbkit)
+
 ## 概要
 
 stbkitはST-Bridgeを扱うためのツールキットSTB-KITの統合パッケージです。  
@@ -25,7 +27,7 @@ stbkit-core（データモデル・バリデーション）をコアの依存と
 
 ## インストール(最小構成)
 
-STB-KITは現在アルファ版です。通常のインストールではアルファ版が選ばれない場合があるため、次の例では`--pre`を指定します。利用するアルファ版の番号が分かっている場合は、`stbkit==バージョン番号`のようにバージョンを直接指定することもできます。
+STB-KITは現在ベータ版です。通常のインストールではベータ版が選ばれない場合があるため、次の例では`--pre`を指定します。利用するベータ版の番号が分かっている場合は、`stbkit==バージョン番号`のようにバージョンを直接指定することもできます。
 
 ```bash
 python -m pip install --pre stbkit
@@ -60,7 +62,7 @@ python -m pip install --pre stbkit
 stbkit -h
 ```
 
-- ST-Bridgeをのバリデーションを行う
+- ST-Bridgeのバリデーションを行う
 
 ```bash
 stbkit validate model.stb
@@ -119,10 +121,7 @@ diffは入力が2つあるため対応していません。
 
 ## ドキュメント
 
-ドキュメントは現在準備中です。公開時にこちらへリンクを掲載します。
-
-- ユーザーガイド（準備中）
-- バージョンアップ、IFC変換の仕様（準備中）
+- [STB-KITドキュメント](https://taisei-oss.github.io/stb-kit/)
 
 ## 依存ライブラリ・再配布に関する注意
 

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/pyproject.toml

@@ -10,19 +10,19 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stbkit"
-version = "0.1.0a9.dev1"
+version = "0.1.0b2"
 description = "ST-Bridgeを扱うライブラリSTB-KIT"
 authors = [
     { name = "STB-KIT Development Team (TAISEI CORPORATION)", email = "oss-dev@pub.taisei.co.jp" },
 ]
-dependencies = ["stbkit-core==0.1.0a9.dev1"]
+dependencies = ["stbkit-core==0.1.0b2"]
 readme = "README.md"
 requires-python = ">=3.12"
 license = "MPL-2.0"
 license-files = ["LICENSE"]
 keywords = ["ST-Bridge", "BIM", "IFC", "structural-engineering", "stbridge"]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
     "Environment :: Console",
     "Intended Audience :: Developers",
     "Intended Audience :: Science/Research",
@@ -67,11 +67,10 @@ full = [
     "xmlschema>=4.3.2",
 ]
 
+[tool.ruff]
+extend = "../../pyproject.toml"
+
 [tool.ruff.lint.per-file-ignores]
-# 辞書形式の要素名が長いため1行になるのを許容
-"src/stbkit/tools/transform/versioning/_internal/upgrade_v202_to_v210/tables.py" = [
-    "E501",
-]
 # 社内用コードから公開用コードへ切り出す際に生じてしまうエラーの除外
 "src/stbkit/cli/_internal/diff.py" = ["F401", "I001"]
 

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/api/__init__.py

@@ -7,7 +7,7 @@
 """stbkitの基本機能をまとめたAPI
 
 ST-Bridgeファイルの読み書き、バージョンアップ、他形式への変換を提供します。
-バージョンごとのデータモデルはstb_latest、stb_v2_0、stb_v2_1から利用してください。
+バージョンごとのデータモデルはstb_latest、stb_v2_0_2、stb_v2_1_1から利用してください。
 
 読み込みは、ファイルのバージョンをそのまま扱うload・loadsと、
 読み込んでから最新版へ変換するload_latest・loads_latestがあります。
@@ -40,8 +40,8 @@ __all__ = [
     "loads",
     "loads_latest",
     "stb_latest",
-    "stb_v2_0",
-    "stb_v2_1",
+    "stb_v2_0_2",
+    "stb_v2_1_1",
     "to_ifc",
     "upgrade_to_latest",
     "validate_schema",

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/api/stb_latest.py

@@ -4,4 +4,4 @@
 # 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_1_1 import *
+from stbkit.core.data_model.stb_v2_1_1 import *  # noqa: F403

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/api/stb_v2_0_2.py

@@ -6,6 +6,7 @@
 
 """ST-Bridge v2.0.2のデータモデル
 
-WARNING: ST-Bridge 2.0.xは、2027年末でサポート終了となります。v2.1.xへの移行を推奨します。"""
+WARNING: ST-Bridge 2.0.xは、2027年末でサポート終了となります。
+v2.1.xへの移行を推奨します。"""
 
-from stbkit.core.data_model.stb_v2_0_2 import *
+from stbkit.core.data_model.stb_v2_0_2 import *  # noqa: F403

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/api/stb_v2_1_1.py

@@ -6,4 +6,4 @@
 
 """ST-Bridge v2.1.1のデータモデル"""
 
-from stbkit.core.data_model.stb_v2_1_1 import *
+from stbkit.core.data_model.stb_v2_1_1 import *  # noqa: F403

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/cli/_internal/cli_main.py

@@ -69,7 +69,8 @@ def _main() -> None:
             register(subparsers)
         except Exception as e:  # noqa: BLE001
             print(
-                f"不明なサブコマンドを登録しようとして失敗しました[{entry_point.name}]: {e}",
+                "不明なサブコマンドを登録しようとして失敗しました"
+                f"[{entry_point.name}]: {e}",
                 file=sys.stderr,
             )
 

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/cli/_internal/common.py

@@ -27,7 +27,8 @@ def use_input(parser: ArgumentParser) -> None:
 
 
 def read_stdin_xml(*, max_size: int, encoding: str | None = None) -> str:
-    # 端末のエンコーディング設定だとST-Bridgeに記載のencodingを読めないため、bytesとして受け取り、XML宣言から判定する。
+    # 端末のエンコーディング設定だとST-Bridgeに記載のencodingを読めないため、
+    # bytesとして受け取り、XML宣言から判定する。
     # encodingを明示した場合は判定より優先する。
     buffer: IO[bytes] | None = getattr(sys.stdin, "buffer", None)
     if buffer is None:

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/cli/_internal/converter.py

@@ -10,7 +10,7 @@ import os
 import sys
 from argparse import Namespace, _SubParsersAction
 from dataclasses import dataclass
-from logging import Logger
+from logging import INFO, Logger
 from pathlib import Path
 from typing import Any
 from xml.etree.ElementTree import ParseError
@@ -24,6 +24,7 @@ from stbkit.core.stb_reporting import (
     get_reporter,
 )
 
+from stbkit.tools._internal.data_model.summary import StbSummary, get_summary
 from stbkit.tools.converters._internal.pipeline.data import (
     _Data,
     _DataFormat,
@@ -77,40 +78,11 @@ class ConverterArgs:
     reporter: Reporter
 
     def print_stb_info(self, stb: StBridgeRoot) -> None:
-        logger = self.logger
-        logger.info("ST-Bridgeモデル情報:")
-        model = stb.stb_model_or_none  # type: ignore[attr-defined]
-        if model is None:
-            return
-        if model.stb_nodes_or_none:
-            logger.info(f" node数:{len(model.stb_nodes.stb_node)}")
-        members = model.stb_members_or_none
-        if members is None:
-            return
-        member_types = [
-            "column",
-            "girder",
-            "post",
-            "beam",
-            "brace",
-            "wall",
-            "slab",
-        ]
-        for member_type in member_types:
-            member_group = getattr(
-                members,
-                f"stb_{member_type}s_or_none",
-                None,
-            )
-            if member_group is None:
-                continue
-            member_list = getattr(
-                member_group,
-                f"stb_{member_type}",
-                None,
-            )
-            if member_list:
-                logger.info(f" {member_type}数:{len(member_list)}")
+        summary: StbSummary = get_summary(
+            stb, reporter=CollectingReporter(), validate=False
+        )
+        for line in summary.to_text().splitlines():
+            self.logger.info(line)
 
 
 @dataclass(frozen=True)
@@ -473,7 +445,7 @@ def _pipeline_convert(args: ConverterArgs) -> None:
             max_size=args.max_size,
         )
 
-    if isinstance(input_data, StbData):
+    if isinstance(input_data, StbData) and args.logger.isEnabledFor(INFO):
         args.print_stb_info(input_data.value)
 
     observed_data: dict[_DataFormat, _Data] = {
@@ -571,6 +543,42 @@ def register(subparsers: _SubParsersAction[Any]) -> None:
     parser.set_defaults(func=_run, _parser=parser)
 
 
+def register_upgrade(subparsers: _SubParsersAction[Any]) -> None:
+    parser = subparsers.add_parser(
+        "upgrade",
+        parents=[make_global_parent()],
+        help=("ST-Bridgeを最新版へ更新します。"),
+    )
+    parser.add_argument(
+        "input",
+        nargs="?",
+        help="入力ファイルのパス。-で標準入力を使用します。",
+    )
+    parser.add_argument(
+        "-o",
+        "--output",
+        default="-",
+        help="出力ファイルのパス。-で標準出力を使用します。",
+    )
+    parser.add_argument(
+        "-y", "--yes", action="store_true", help="確認なしで上書きします。"
+    )
+    parser.add_argument(
+        "--input-encoding",
+        help="入力ファイルのエンコーディングを指定します。"
+        "省略時は自動検出またはutf-8を使用します。",
+    )
+    parser.set_defaults(
+        func=_run,
+        _parser=parser,
+        from_format="stb",
+        to_format="stb",
+        list_formats=False,
+        via=None,
+        save_intermediate=None,
+    )
+
+
 def _print_list_formats() -> None:
     print("対応しているファイル形式")
     for spec in _CLI_FORMAT_SPECS:

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/cli/_internal/entry_points.py

@@ -14,6 +14,8 @@ COMMAND_GROUP: Final = "stbkit.commands"
 BUILTIN_COMMANDS: Final[dict[str, str]] = {
     "convert": "stbkit.cli.commands.convert:register",
     "diff": "stbkit.cli.commands.diff:register",
+    "summary": "stbkit.cli.commands.summary:register",
+    "upgrade": "stbkit.cli.commands.upgrade:register",
     "validate": "stbkit.cli.commands.validate:register",
 }
 

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/cli/_internal/global_parent.py

@@ -16,7 +16,8 @@ DEFAULT_MAX_SIZE_MB: int = DEFAULT_MAX_XML_SIZE // BYTES_PER_MB
 
 
 def make_global_parent() -> argparse.ArgumentParser:
-    # 共通引数に既定値を持たせるとサブコマンドより前で指定した値がサブコマンドで上書きされてしまうため、
+    # 共通引数に既定値を持たせるとサブコマンドより前で指定した値が
+    # サブコマンドで上書きされてしまうため、
     # 共通引数は既定値を持たせず、下のget_xxxを用いる。
     parent = argparse.ArgumentParser(add_help=False)
     parent.add_argument(

stbkit-0.1.0b2/src/stbkit/cli/_internal/summary.py

@@ -0,0 +1,73 @@
+# 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 __future__ import annotations
+
+import sys
+from argparse import Namespace, _SubParsersAction
+from pathlib import Path
+from typing import Any
+
+from stbkit.core.data_model.common import StBridgeRoot
+from stbkit.core.stb_io import load, loads
+from stbkit.core.stb_reporting import CollectingReporter
+
+from stbkit.tools._internal.data_model.summary import StbSummary, get_summary
+
+from . import common
+from .constants_exit_code import EXIT_EXECUTION_ERROR, EXIT_INVALID_ARGUMENT, EXIT_OK
+from .global_parent import get_max_size, make_global_parent
+
+
+def register(subparsers: _SubParsersAction[Any]) -> None:
+    parser = subparsers.add_parser(
+        "summary",
+        parents=[make_global_parent()],
+        help="ST-Bridgeの概要を出力します。",
+    )
+    common.use_input(parser)
+    parser.add_argument(
+        "--output-format",
+        choices=("text", "json"),
+        default="text",
+        help="出力フォーマット。textまたはjsonを指定します。",
+    )
+    parser.set_defaults(func=_run)
+
+
+def _run(args: Namespace) -> None:
+    input_path: str = common.get_input(args)
+    max_size: int = get_max_size(args)
+    output_format: str = str(args.output_format)
+    verbose: int = int(args.verbose) if hasattr(args, "verbose") else 0
+
+    try:
+        reporter: CollectingReporter = CollectingReporter()
+        if input_path == "-":
+            stb: StBridgeRoot = loads(
+                common.read_stdin_xml(max_size=max_size),
+                max_size=max_size,
+                reporter=reporter,
+            )
+        else:
+            path: Path = Path(input_path)
+            if not path.is_file():
+                raise FileNotFoundError(f"入力ファイルが見つかりません: {path}")
+            stb = load(path, max_size=max_size, reporter=reporter)
+        summary: StbSummary = get_summary(stb, reporter=reporter)
+        if output_format == "json":
+            output_str: str = summary.to_json(indent=2)
+        else:
+            output_str = summary.to_text(verbose=verbose)
+        sys.stdout.write(output_str)
+    except FileNotFoundError as error:
+        print(str(error), file=sys.stderr)
+        raise SystemExit(EXIT_INVALID_ARGUMENT) from None
+    except Exception as error:  # noqa: BLE001
+        print(f"summaryの作成に失敗しました: {error}", file=sys.stderr)
+        raise SystemExit(EXIT_EXECUTION_ERROR) from None
+
+    raise SystemExit(EXIT_OK)

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/cli/_internal/validate.py

@@ -48,7 +48,8 @@ def _try_validate_report(
     require_xsd: bool,
     exclude_legal_extensions: bool,
 ) -> tuple[CollectingReporter | None, str]:
-    # XMLとして読み込めなかった場合は、チェック結果ではなく実行の失敗なので(None, エラーメッセージ)を返す。
+    # XMLとして読み込めなかった場合は、チェック結果ではなく実行の失敗なので
+    # (None, エラーメッセージ)を返す。
     # ST-Bridgeとしての不正はチェック結果であるため、エラーとしない。
     try:
         reporter: CollectingReporter = _validate_report(

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/cli/commands/convert.py

@@ -9,8 +9,8 @@ from __future__ import annotations
 from argparse import _SubParsersAction
 from typing import Any
 
-from .._internal import converter
-
 
 def register(subparsers: _SubParsersAction[Any]) -> None:
+    from .._internal import converter
+
     converter.register(subparsers)

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/cli/commands/diff.py

@@ -9,8 +9,8 @@ from __future__ import annotations
 from argparse import _SubParsersAction
 from typing import Any
 
-from .._internal import diff
-
 
 def register(subparsers: _SubParsersAction[Any]) -> None:
+    from .._internal import diff
+
     diff.register(subparsers)

stbkit-0.1.0b2/src/stbkit/cli/commands/summary.py

@@ -0,0 +1,16 @@
+# 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 __future__ import annotations
+
+from argparse import _SubParsersAction
+from typing import Any
+
+from .._internal import summary
+
+
+def register(subparsers: _SubParsersAction[Any]) -> None:
+    summary.register(subparsers)

stbkit-0.1.0b2/src/stbkit/cli/commands/upgrade.py

@@ -0,0 +1,16 @@
+# 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 __future__ import annotations
+
+from argparse import _SubParsersAction
+from typing import Any
+
+
+def register(subparsers: _SubParsersAction[Any]) -> None:
+    from .._internal import converter
+
+    converter.register_upgrade(subparsers)

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/cli/commands/validate.py

@@ -9,8 +9,8 @@ from __future__ import annotations
 from argparse import _SubParsersAction
 from typing import Any
 
-from .._internal import validate
-
 
 def register(subparsers: _SubParsersAction[Any]) -> None:
+    from .._internal import validate
+
     validate.register(subparsers)

{stbkit-0.1.0a9.dev1 → stbkit-0.1.0b2}/src/stbkit/tools/_internal/data_model/building_geometry.py

@@ -42,7 +42,8 @@ def _new_u32_array() -> array[int]:
 
 
 def _new_offsets_array() -> array[int]:
-    # データの範囲をoffsets[i]:offsets[i + 1] で求めるため、要素が0個でも先頭の0を作っておく。
+    # データの範囲をoffsets[i]:offsets[i + 1] で求めるため、
+    # 要素が0個でも先頭の0を作っておく。
     return array("I", [0])
 
 
@@ -169,7 +170,7 @@ class PolygonMesh:
         repr=False,
     )
     """面の頂点。
-    
+
     例えば面が(0, 1, 2, 3),(4, 5, 6)なら、 [0, 1, 2, 3, 4, 5, 6]のように格納する"""
 
     face_offsets: array[int] = field(
@@ -325,7 +326,8 @@ class PlaneShape:
 @dataclass(slots=True)
 class PlaneShapeTable:
     points_xyz: array[float] = field(default_factory=_new_f64_array, repr=False)
-    """全ループの頂点。x, y, z の順で1点につき3値。ループの順序はplane_loop_offsetsで表す。"""
+    """全ループの頂点。x, y, z の順で1点につき3値。
+    ループの順序はplane_loop_offsetsで表す。"""
     loop_point_offsets: array[int] = field(
         default_factory=_new_offsets_array,
         repr=False,
@@ -1135,7 +1137,8 @@ class BuildingGeometry:
             else:
                 if not flags & ElementFlags.HAS_MESH:
                     raise ValueError(
-                        f"element {element_index} はmesh spanがありますがHAS_MESHではありません"
+                        f"element {element_index} はmesh spanがありますが"
+                        "HAS_MESHではありません"
                     )
                 if span.vertex_start + span.vertex_count > vertex_count:
                     raise ValueError(