parasolid-kit 0.1.0.dev0__tar.gz

parasolid_kit-0.1.0.dev0/Cargo.lock

@@ -0,0 +1,137 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "libc"
+version = "0.2.189"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "parasolid-core"
+version = "0.1.0-dev0"
+
+[[package]]
+name = "parasolid-python"
+version = "0.1.0-dev0"
+dependencies = [
+ "parasolid-core",
+ "pyo3",
+]
+
+[[package]]
+name = "portable-atomic"
+version = "1.15.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05c8b63e8d9609db387f0324918f81d68fe27748f084ef092fb35954d0539a85"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.29.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4688ddedf473e32662b9b067670129a8afb8c18e351482c70d62ba4a88171e8b"
+dependencies = [
+ "libc",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.29.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f41027e41b4bd03f6e60f9f417fe24a6341a6bb744edd62b6f709f2a52ea30e9"
+dependencies = [
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.29.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e591a95526fead067432c3b3a33fc74770b87b1e04e73671090d9c2055a2b327"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.29.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "73225868fc1cd84eef2c3c230ddb91273bf1de46aeb8a4248da76d32a0924a1c"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.29.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "571575aa3749fa6216757dd47d2a3e7ef360f329a40f0666a9fbd14889024952"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.13.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "adb6935a6f5c20170eeceb1a3835a49e12e19d792f6dd344ccc76a985ca5a6ca"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"

parasolid_kit-0.1.0.dev0/Cargo.toml

@@ -0,0 +1,25 @@
+[workspace]
+members = ["crates/parasolid-core", "crates/parasolid-python"]
+exclude = ["fuzz"]
+resolver = "3"
+
+[workspace.package]
+version = "0.1.0-dev0"
+edition = "2024"
+rust-version = "1.88"
+description = "Schema-aware parser core for Parasolid X_T and X_B data"
+license = "MIT"
+repository = "https://github.com/monozukuri-ai/parasolid-kit"
+
+[workspace.dependencies]
+pyo3 = { version = "=0.29.2", features = ["abi3-py310", "extension-module"] }
+
+[workspace.lints.rust]
+unsafe_code = "forbid"
+
+[workspace.lints.clippy]
+all = { level = "warn", priority = -1 }
+pedantic = { level = "warn", priority = -1 }
+expect_used = "deny"
+panic = "deny"
+unwrap_used = "deny"

parasolid_kit-0.1.0.dev0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 parasolid-kit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

parasolid_kit-0.1.0.dev0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: parasolid-kit
+Version: 0.1.0.dev0
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Rust
+Classifier: Typing :: Typed
+License-File: LICENSE
+Summary: Schema-aware Python parser for Parasolid X_T and X_B data
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Repository, https://github.com/monozukuri-ai/parasolid-kit
+
+# parasolid-kit
+
+`parasolid-kit` is an experimental, schema-aware parser for Parasolid X_T and
+X_B transmit files. Parsing and geometry mapping run in a safe Rust core, while
+Python users work with immutable typed models.
+
+The project is read-focused and currently pre-alpha. It is intended for file
+inspection, validation, research, and conversion pipelines where preserving
+the transmitted structure matters more than silently approximating unsupported
+data.
+
+## Features
+
+- Inspect X_T and X_B headers without a schema catalog.
+- Parse complete X_T and X_B node streams with the exact caller-provided schema.
+- Reconstruct an unmodified parsed X_B document byte-for-byte.
+- Compare X_T and X_B documents after pointer-index remapping.
+- Map supported topology, analytic geometry, and NURBS records to a typed B-Rep
+  source model.
+- Return structured diagnostics and enforce configurable resource limits.
+- Use the same functionality from Python or a JSON command-line interface.
+
+See [format support and limitations](docs/format-support.md) before relying on
+the parser for production data.
+
+## Installation
+
+Python 3.10 or newer is required. Install a downloaded wheel with `pip`:
+
+```bash
+python -m pip install /path/to/parasolid_kit-0.1.0.dev0-cp310-abi3-PLATFORM.whl
+```
+
+To install from a source checkout, Rust 1.88 or newer is also required:
+
+```bash
+git clone https://github.com/monozukuri-ai/parasolid-kit.git
+cd parasolid-kit
+python -m pip install .
+```
+
+The project is not yet claiming a published PyPI release. Once a release is
+available there, the installation command will be `python -m pip install
+parasolid-kit`.
+
+## Schema catalogs
+
+Header inspection works without external data. Complete parsing requires the
+exact `sch_*.sch_txt` catalog identified by the file's internal schema key.
+There is no fallback to a nearby version and no inferred replacement for a
+missing catalog.
+
+Siemens schema catalogs are not included in this repository or its packages.
+You must provide a catalog from software or an SDK that you are licensed to use
+and comply with its storage and redistribution terms. The parser reads the
+catalog in place and does not copy it into the package.
+
+## Python example
+
+```python
+from pathlib import Path
+
+from parasolid_kit import (
+    InMemorySchemaProvider,
+    SchemaKey,
+    inspect_xb,
+    load_schema_catalog,
+    map_brep,
+    parse_xb,
+    write_xb,
+)
+
+source = Path("model.x_b")
+header = inspect_xb(source)
+schema_id = SchemaKey.parse(header.schema_key).provider_schema
+
+catalog = load_schema_catalog(
+    Path("/path/to/schema") / f"sch_{schema_id}.sch_txt",
+    expected_schema_id=schema_id,
+)
+provider = InMemorySchemaProvider((catalog,))
+
+document = parse_xb(source, schema_provider=provider)
+brep = map_brep(document)
+
+print(header.modeller_version)
+print(len(document.nodes), len(brep.bodies), brep.complete)
+assert write_xb(document) == document.raw_bytes
+```
+
+`map_brep()` can return a valid but incomplete model when a well-formed geometry
+record has no typed mapping yet. Inspect `brep.complete` and `brep.diagnostics`
+instead of assuming that every parsed record has been interpreted.
+
+## Command line
+
+```bash
+# Header inspection does not need a schema catalog.
+parasolid-kit inspect model.x_b
+
+# Complete parsing and comparison require the exact catalog in --schema-dir.
+parasolid-kit parse model.x_t --schema-dir /path/to/schema
+parasolid-kit parse model.x_b --schema-dir /path/to/schema --brep
+parasolid-kit compare model.x_t model.x_b --schema-dir /path/to/schema
+```
+
+Reports are JSON. Exit status is `0` for success or equivalent documents, `1`
+for a valid comparison that found differences, and `2` for input, schema, or
+parse errors. `python -m parasolid_kit` provides the same interface.
+
+## Documentation
+
+- [Python API](docs/api.md)
+- [Format support and limitations](docs/format-support.md)
+- [Corpus provenance and redistribution policy](corpus/README.md)
+
+## Project boundaries
+
+`parasolid-kit` does not parse native CAD containers such as iCAD `.icd`, CAD
+assembly structures, occurrence transforms, visibility, or appearance. A
+format-specific adapter can extract a bounded X_T/X_B payload and pass it to
+this package without making the parser depend on that CAD product.
+
+The package has no runtime dependency on a CAD product, geometry kernel, or
+OpenCascade binding. It does not bundle Siemens schema data or proprietary CAD
+files.
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).
+

parasolid_kit-0.1.0.dev0/README.md

@@ -0,0 +1,130 @@
+# parasolid-kit
+
+`parasolid-kit` is an experimental, schema-aware parser for Parasolid X_T and
+X_B transmit files. Parsing and geometry mapping run in a safe Rust core, while
+Python users work with immutable typed models.
+
+The project is read-focused and currently pre-alpha. It is intended for file
+inspection, validation, research, and conversion pipelines where preserving
+the transmitted structure matters more than silently approximating unsupported
+data.
+
+## Features
+
+- Inspect X_T and X_B headers without a schema catalog.
+- Parse complete X_T and X_B node streams with the exact caller-provided schema.
+- Reconstruct an unmodified parsed X_B document byte-for-byte.
+- Compare X_T and X_B documents after pointer-index remapping.
+- Map supported topology, analytic geometry, and NURBS records to a typed B-Rep
+  source model.
+- Return structured diagnostics and enforce configurable resource limits.
+- Use the same functionality from Python or a JSON command-line interface.
+
+See [format support and limitations](docs/format-support.md) before relying on
+the parser for production data.
+
+## Installation
+
+Python 3.10 or newer is required. Install a downloaded wheel with `pip`:
+
+```bash
+python -m pip install /path/to/parasolid_kit-0.1.0.dev0-cp310-abi3-PLATFORM.whl
+```
+
+To install from a source checkout, Rust 1.88 or newer is also required:
+
+```bash
+git clone https://github.com/monozukuri-ai/parasolid-kit.git
+cd parasolid-kit
+python -m pip install .
+```
+
+The project is not yet claiming a published PyPI release. Once a release is
+available there, the installation command will be `python -m pip install
+parasolid-kit`.
+
+## Schema catalogs
+
+Header inspection works without external data. Complete parsing requires the
+exact `sch_*.sch_txt` catalog identified by the file's internal schema key.
+There is no fallback to a nearby version and no inferred replacement for a
+missing catalog.
+
+Siemens schema catalogs are not included in this repository or its packages.
+You must provide a catalog from software or an SDK that you are licensed to use
+and comply with its storage and redistribution terms. The parser reads the
+catalog in place and does not copy it into the package.
+
+## Python example
+
+```python
+from pathlib import Path
+
+from parasolid_kit import (
+    InMemorySchemaProvider,
+    SchemaKey,
+    inspect_xb,
+    load_schema_catalog,
+    map_brep,
+    parse_xb,
+    write_xb,
+)
+
+source = Path("model.x_b")
+header = inspect_xb(source)
+schema_id = SchemaKey.parse(header.schema_key).provider_schema
+
+catalog = load_schema_catalog(
+    Path("/path/to/schema") / f"sch_{schema_id}.sch_txt",
+    expected_schema_id=schema_id,
+)
+provider = InMemorySchemaProvider((catalog,))
+
+document = parse_xb(source, schema_provider=provider)
+brep = map_brep(document)
+
+print(header.modeller_version)
+print(len(document.nodes), len(brep.bodies), brep.complete)
+assert write_xb(document) == document.raw_bytes
+```
+
+`map_brep()` can return a valid but incomplete model when a well-formed geometry
+record has no typed mapping yet. Inspect `brep.complete` and `brep.diagnostics`
+instead of assuming that every parsed record has been interpreted.
+
+## Command line
+
+```bash
+# Header inspection does not need a schema catalog.
+parasolid-kit inspect model.x_b
+
+# Complete parsing and comparison require the exact catalog in --schema-dir.
+parasolid-kit parse model.x_t --schema-dir /path/to/schema
+parasolid-kit parse model.x_b --schema-dir /path/to/schema --brep
+parasolid-kit compare model.x_t model.x_b --schema-dir /path/to/schema
+```
+
+Reports are JSON. Exit status is `0` for success or equivalent documents, `1`
+for a valid comparison that found differences, and `2` for input, schema, or
+parse errors. `python -m parasolid_kit` provides the same interface.
+
+## Documentation
+
+- [Python API](docs/api.md)
+- [Format support and limitations](docs/format-support.md)
+- [Corpus provenance and redistribution policy](corpus/README.md)
+
+## Project boundaries
+
+`parasolid-kit` does not parse native CAD containers such as iCAD `.icd`, CAD
+assembly structures, occurrence transforms, visibility, or appearance. A
+format-specific adapter can extract a bounded X_T/X_B payload and pass it to
+this package without making the parser depend on that CAD product.
+
+The package has no runtime dependency on a CAD product, geometry kernel, or
+OpenCascade binding. It does not bundle Siemens schema data or proprietary CAD
+files.
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

parasolid_kit-0.1.0.dev0/corpus/README.md

@@ -0,0 +1,55 @@
+# Corpus policy
+
+The distributable corpus contains only Parasolid X_T/X_B files whose origin,
+generator, export settings, checksums, and redistribution status are recorded
+in `manifest.jsonl` and validated by `manifest.schema.json`.
+
+The distributable corpus is currently empty. Files are added only after their
+manifest entry, reproducible generation or acquisition record, checksums, and
+redistribution status have been reviewed. A locally captured fixture remains
+under `corpus/local/` until that review is complete.
+
+## Scope
+
+- Prefer small, self-generated X_T/X_B pairs with a reproducible construction
+  recipe.
+- Export STEP from the same immutable model state when it is used as a geometry
+  oracle.
+- Record exact product/build information and the explicitly selected Parasolid
+  target version.
+- Keep credentials, private cloud document identifiers, and confidential CAD
+  data out of the repository.
+- Keep native containers such as iCAD `.icd` outside this corpus. They belong to
+  an adapter-specific, local-only corpus unless redistribution is explicitly
+  allowed.
+
+## Redistribution states
+
+- `allowed`: reviewed and permitted to ship with this repository.
+- `local_only`: may be used by a developer but must not be committed or packed.
+- `unknown`: provenance is recorded but redistribution has not been cleared.
+- `prohibited`: retained only as an external reference; do not copy it here.
+
+An entry marked `unknown` or `prohibited` must never be included in a wheel,
+sdist, source archive, or public test fixture.
+
+## Layout
+
+```text
+corpus/
+  manifest.schema.json
+  manifest.jsonl
+  generated/
+    <generator>/<lineage>/<parasolid-version>/<file>
+  local/       # ignored, local-only inputs
+  downloads/   # ignored, unreviewed third-party inputs
+```
+
+`manifest.jsonl` is created with the first accepted file. Each non-empty line
+must be one independent JSON object conforming to `manifest.schema.json`.
+Paths are POSIX-style paths relative to this `corpus/` directory and public
+entries must live under `generated/`. Every public entry must be marked
+`allowed`, state its license or permission basis, and match the recorded
+SHA-256 checksum. Run `uv run python scripts/verify_corpus.py` before building
+distribution artifacts; the gate also rejects undeclared files under
+`generated/`.

parasolid_kit-0.1.0.dev0/corpus/manifest.schema.json

@@ -0,0 +1,166 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "parasolid-kit corpus manifest entry",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "lineage_id",
+    "source_kind",
+    "generator",
+    "recipe",
+    "parasolid_version",
+    "encoding",
+    "path",
+    "sha256",
+    "redistribution",
+    "expected"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*$"
+    },
+    "lineage_id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*$"
+    },
+    "source_kind": {
+      "enum": [
+        "self_generated",
+        "synthetic",
+        "third_party",
+        "local_reference"
+      ]
+    },
+    "generator": {
+      "$ref": "#/$defs/generator"
+    },
+    "recipe": {
+      "type": "string",
+      "minLength": 1
+    },
+    "parasolid_version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "encoding": {
+      "enum": ["text", "binary"]
+    },
+    "path": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Repository-relative path to an X_T/X_B family file"
+    },
+    "sha256": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "related": {
+      "$ref": "#/$defs/related"
+    },
+    "redistribution": {
+      "enum": ["allowed", "local_only", "unknown", "prohibited"]
+    },
+    "source_url": {
+      "type": "string",
+      "format": "uri"
+    },
+    "acquired_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "license": {
+      "type": "string",
+      "minLength": 1
+    },
+    "expected": {
+      "$ref": "#/$defs/expected"
+    },
+    "notes": {
+      "type": "string"
+    }
+  },
+  "$defs": {
+    "generator": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["product", "product_version", "document_version"],
+      "properties": {
+        "product": {
+          "type": "string",
+          "minLength": 1
+        },
+        "product_version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "document_version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "exporter_version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "export_settings": {
+          "type": "object",
+          "additionalProperties": {
+            "type": ["string", "number", "integer", "boolean", "null"]
+          }
+        }
+      }
+    },
+    "related": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "text": {
+          "type": "string",
+          "minLength": 1
+        },
+        "binary": {
+          "type": "string",
+          "minLength": 1
+        },
+        "step": {
+          "type": "string",
+          "minLength": 1
+        },
+        "native": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "expected": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema", "required_node_types"],
+      "properties": {
+        "schema": {
+          "type": ["string", "null"]
+        },
+        "required_node_types": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "uniqueItems": true
+        },
+        "node_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "body_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "notes": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}