ezmi2d 0.1.0__tar.gz

ezmi2d-0.1.0/Cargo.lock

@@ -0,0 +1,229 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "adler2"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "320119579fcad9c21884f5c4861d16174d0e06250625266f50fe6898340abefa"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "crc32fast"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9481c1c90cbf2ac953f07c8d4a58aa3945c425b7185c9154d67a65e4230da511"
+dependencies = [
+ "cfg-if",
+]
+
+[[package]]
+name = "encoding_rs"
+version = "0.8.35"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "75030f3c4f45dafd7586dd6780965a8c7e8e285a5ecb86713e63a79c5b2766f3"
+dependencies = [
+ "cfg-if",
+]
+
+[[package]]
+name = "ezmi2d-core"
+version = "0.1.0"
+dependencies = [
+ "encoding_rs",
+ "flate2",
+ "thiserror",
+]
+
+[[package]]
+name = "ezmi2d-python"
+version = "0.1.0"
+dependencies = [
+ "ezmi2d-core",
+ "pyo3",
+]
+
+[[package]]
+name = "flate2"
+version = "1.1.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "843fba2746e448b37e26a819579957415c8cef339bf08564fe8b7ddbd959573c"
+dependencies = [
+ "crc32fast",
+ "miniz_oxide",
+]
+
+[[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 = "miniz_oxide"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fa76a2c86f704bdb222d66965fb3d63269ce38518b83cb0575fca855ebb6316"
+dependencies = [
+ "adler2",
+ "simd-adler32",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[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 2.0.119",
+]
+
+[[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 2.0.119",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "simd-adler32"
+version = "0.3.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3a219298ac11a56ea9a6d2120044824d6f01aeb034955e7af7bc16858527deea"
+
+[[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 = "syn"
+version = "3.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "53e9bae58849f64dfa4f5d5ae372c8341f7305f82a3868709269343628b659a3"
+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 = "thiserror"
+version = "2.0.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec86235f5fcc2a73650310756d2ac5b138a5780bbbdfae3eeccec992c435ba4f"
+dependencies = [
+ "thiserror-impl",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "2.0.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bc04cd3e1236dd4a98afca4569f2deb3f120e5422a4023be2cb683f8486292af"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 3.0.3",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"

ezmi2d-0.1.0/Cargo.toml

@@ -0,0 +1,16 @@
+[workspace]
+members = ["crates/ezmi2d-core", "crates/ezmi2d-python"]
+resolver = "2"
+
+[workspace.package]
+version = "0.1.0"
+edition = "2021"
+rust-version = "1.83"
+authors = ["neka-nat <nekanat.stock@gmail.com>"]
+description = "Lossless reader for PTC Creo Elements/Direct Drafting MI files"
+repository = "https://github.com/monozukuri-ai/ezmi2d"
+license = "MIT"
+
+[workspace.dependencies]
+pyo3 = { version = "0.29.0", features = ["abi3-py310"] }
+

ezmi2d-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 ezmi2d 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.
+

ezmi2d-0.1.0/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: ezmi2d
+Version: 0.1.0
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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 :: Python :: 3.14
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Libraries
+Requires-Dist: ezdxf>=1.4,<2.0 ; extra == 'corpus'
+Requires-Dist: matplotlib>=3.8,<4.0 ; extra == 'dev'
+Requires-Dist: maturin>=1.13,<2.0 ; extra == 'dev'
+Requires-Dist: pytest>=8.0 ; extra == 'dev'
+Requires-Dist: ruff>=0.12 ; extra == 'dev'
+Requires-Dist: matplotlib>=3.8,<4.0 ; extra == 'plot'
+Provides-Extra: corpus
+Provides-Extra: dev
+Provides-Extra: plot
+License-File: LICENSE
+Summary: Lossless reader for PTC Creo Elements/Direct Drafting MI files powered by Rust
+Keywords: mi,cad,me10,creo,parser,rust
+Author-email: neka-nat <nekanat.stock@gmail.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Documentation, https://github.com/monozukuri-ai/ezmi2d/blob/main/docs/api.md
+Project-URL: Homepage, https://github.com/monozukuri-ai/ezmi2d
+Project-URL: Issues, https://github.com/monozukuri-ai/ezmi2d/issues
+Project-URL: Repository, https://github.com/monozukuri-ai/ezmi2d
+
+# ezmi2d
+
+`ezmi2d` is an experimental reader for the line-oriented MI drawing format used
+by HP ME10 and PTC Creo Elements/Direct Drafting. Its parser and reference
+resolver are written in Rust and exposed to Python through PyO3.
+
+The public API provides typed geometry, annotations, and part structure while retaining the
+complete, byte-preserving raw scan:
+
+```python
+import ezmi2d
+
+drawing = ezmi2d.read("drawing.mi")
+modelspace = drawing.modelspace()
+
+print(drawing.version, drawing.units, drawing.extents)
+print(drawing.encoding, drawing.encoding_source)
+
+for entity in modelspace.query("LIN ARC CIR"):
+    print(entity.id, entity.mi_type, entity.property_id)
+
+line = drawing.entitydb[10]
+if isinstance(line, ezmi2d.Line):
+    print(line.start, line.end)
+
+for text in modelspace.query("TEXT"):
+    print(text.text, text.origin, text.height, text.font_name)
+
+for spline in drawing.query("FIL BSPL"):
+    print(spline.id, spline.mi_type)
+
+for sheet in drawing.sheets:
+    print(sheet.name, sheet.child_part_indices)
+```
+
+## Matplotlib preview
+
+Install the optional plotting dependency and render a decoded fixture to PNG:
+
+```console
+pip install "ezmi2d[plot]"
+python examples/plot_mi.py tests/data/geometry.mi -o geometry.png
+```
+
+The plotting helper can also be embedded directly:
+
+```python
+import matplotlib.pyplot as plt
+import ezmi2d
+
+drawing = ezmi2d.read("drawing.mi")
+fig, ax = plt.subplots()
+ezmi2d.draw(drawing, ax=ax)
+ax.legend()
+fig.savefig("drawing.png", dpi=160)
+```
+
+`ezmi2d.draw(Document)` renders every decoded part definition once; use
+`ezmi2d.draw(drawing.parts[index])` to inspect one part. This is a semantic
+diagnostic preview, not a style-faithful MI renderer: unknown display fields,
+typed-but-opaque annotations, and assembly instance transforms are not applied.
+The current sample corpus verifies `orientation=0` arcs as counter-clockwise;
+other orientation values are skipped with a warning rather than guessed.
+
+`read()` accepts a path or bytes-like object, including the verified
+gzip-compressed MI envelope. Point and property pointers are
+resolved after all records have been decoded, so forward references work and
+dangling or wrong-type references produce source-located diagnostics rather
+than aborting the whole drawing.
+
+Text is decoded strictly. The reader checks an explicit `encoding=` override,
+a UTF-8 BOM, MI 3.20-or-newer version metadata, and a `#~1` `ENCODING:`
+declaration before conservatively inspecting known text fields in older files.
+Supported canonical encodings are `utf-8`, `shift_jis` (including `cp932` and
+`windows-31j` aliases), and `hp-roman8`:
+
+```python
+drawing = ezmi2d.read("legacy-japanese.mi", encoding="cp932")
+text = drawing.query("TEX")[0]
+print(text.text, text.text_bytes, text.content_value.encoding)
+```
+
+Invalid or undecidable text is never decoded with replacement characters.
+`TextValue.text` remains `None`, `TextValue.raw_bytes` retains the source, and a
+source-located diagnostic identifies the bad byte.
+
+The lower-level lossless scanner remains available when inspecting unsupported
+records or developing new entity decoders:
+
+```python
+scan = ezmi2d.scan("drawing.mi")
+for record in scan.records:
+    print(record.section_number, record.record_type, record.raw_bytes)
+
+packed = ezmi2d.scan("drawing.bi")
+print(packed.format.compression, packed.container_size, packed.source_size)
+assert packed.container_bytes != packed.source_bytes
+```
+
+For compressed inputs, every source span addresses the decompressed logical MI
+stream exposed as `source_bytes`. The exact caller input remains available as
+`container_bytes`. Streaming decompression is bounded independently by
+`ScanLimits.max_file_size`, `max_decompressed_size`, and
+`max_compression_ratio`.
+
+The CLI emits a raw structural summary or JSON suitable for corpus inspection:
+
+```console
+ezmi2d inspect drawing.mi
+ezmi2d inspect drawing.mi --json --records
+```
+
+## Current scope
+
+- legacy MI 2.10 global metadata, drawing extents, units, and serialized transform values
+- `#~6` part ownership and an ezdxf-style `modelspace()`, `query()`, and `entitydb`
+- typed `P`, `LIN`, `ARC`, `FIL`, `BSPL`, `CIR`, and `TEX` entities; point references are resolved
+- De Boor evaluation for non-rational `BSPL`, including modern variable-prefix records
+- typed dimension (`DANG`, `DCHMF`, `DDIA`, `DRAD`, `DSGL`), `DTV`, `LED`, `HAT`, and `SYML`
+- nested/shared `ASSE` instances, serialized 3x3 transforms, root parts, and `DOCU_SHEET` links
+- strict UTF-8, Shift_JIS/CP932, and HP Roman-8 text decoding with explicit override support
+- minimally decoded `PSTAT`, `ASSP`, dimension/hatch properties, and `ASSE` records
+- stable diagnostics for duplicate IDs, bad records, dangling pointers, wrong pointer types,
+  table-of-contents mismatch, and Phase 1 structural problems
+- `UnsupportedEntity` fallback with its original `RawRecord`; no addressable record is silently
+  discarded merely because its semantic decoder is unavailable
+- bounded line, section, and `|~` scanning with read-only access to every logical MI byte range
+- streaming gzip decompression with container-size, expanded-size, ratio, truncation, checksum,
+  trailing-data, and concatenated-member guards
+
+The four common graphic display fields are exposed conservatively as
+`display_values`, and the ARC direction field is retained as `orientation`:
+their formal names and complete semantics have not yet been established.
+Modern variable-prefix B-splines expose `display_values=None` and retain that
+prefix as `prefix_values` instead of guessing a style layout.
+For `TEX`, only fields validated across the available MI/DXF pairs are named:
+the serialized 3x3 transform, its translation as `origin`, font name, two text
+size values, height, and content. Every post-ID field remains available through
+`values`. Annotation fields, B-spline prefix values, and assembly relationship fields whose
+formal names are not verified are likewise exposed as lossless serialized values. Writers are
+not implemented. gzip-wrapped product-generated compressed MI is supported
+by content signature. zlib-wrapper, ZIP, and historical UNIX-compress variants
+remain unsupported. The available genuine sample is a compressed 2D MI member
+inside a Creo bundle, not a separately exported standalone `.bi`; compatibility
+with every Drafting/ME10 `.bi` generation is therefore not claimed.
+
+See the [Python API reference](docs/api.md),
+[MI format research](docs/mi-format-research.md), and
+[sample corpus guide](samples/README.md). Third-party drawings are not distributed in Git,
+sdists, or wheels.
+
+The opt-in corpus suite currently exercises 19 MI 2.10 drawings containing
+10,166 points, 4,030 lines, 1,059 arcs, 353 fillets, 1,196 circles, 6 B-splines,
+and 57 text entities. The
+paired DXF tests compare line endpoints, arc center/start/end points, circle
+centers/radii, drawing extents, and text content/insertion/height to seven
+decimal places. Fillets exactly match the additional DXF arcs. Stored B-spline
+interpolation points and every vertex of the corresponding DXF polylines are
+evaluated against the decoded curves.
+
+It also verifies a product-generated MI 3.40 / UTF-8 compressed member from a
+public Creo bundle: 87,506 compressed bytes expand to 393,805 logical bytes.
+Its 88 B-splines, 88 typed annotations, 25-part hierarchy, and sheet association
+produce identical semantic models and diagnostics from compressed and expanded input.
+
+## Distribution
+
+Release automation builds `cp310-abi3` wheels for Linux x86-64 and ARM64, macOS universal2, and
+Windows x64. Artifact-only smoke tests cover Python 3.10 and 3.14, and the sdist is rebuilt and
+installed in a clean job. See [docs/releasing.md](docs/releasing.md) for the complete release gates
+and Trusted Publishing setup.
+
+## Development
+
+```console
+uv sync --locked --extra dev
+uv run maturin develop
+uv run pytest
+cargo test --workspace
+uv run python benchmarks/benchmark_pipeline.py tests/data --warmup 0 --repeat 1 \
+  --json-output /tmp/ezmi2d-benchmark.json --markdown-output /tmp/ezmi2d-benchmark.md
+```
+
+Parser fuzzing uses nightly Rust and `cargo-fuzz`:
+
+```console
+cargo +nightly fuzz run raw_scan
+cargo +nightly fuzz run semantic_read
+```
+
+To fetch and run the separately licensed corpus comparison:
+
+```console
+./scripts/fetch_external_samples.sh
+uv sync --locked --extra dev --extra corpus
+uv run --extra corpus pytest tests/python/test_external_corpus.py
+```
+