ezsxf 0.1.0__tar.gz

ezsxf-0.1.0/Cargo.lock

@@ -0,0 +1,190 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "autocfg"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[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 = "ezsxf"
+version = "0.1.0"
+dependencies = [
+ "encoding_rs",
+ "pyo3",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.182"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6800badb6cb2082ffd7b6a67e6125bb39f18782f793520caee8cb8846be06112"
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d"
+
+[[package]]
+name = "portable-atomic"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f402062616ab18202ae8319da13fa4279883a2b8a9d9f83f20dbade813ce1884"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b14b5775b5ff446dd1056212d778012cbe8a0fbffd368029fd9e25b514479c38"
+dependencies = [
+ "once_cell",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ab5bcf04a2cdcbb50c7d6105de943f543f9ed92af55818fd17b660390fc8636"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fd24d897903a9e6d80b968368a34e1525aeb719d568dba8b3d4bfa5dc67d453"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "36c011a03ba1e50152b4b394b479826cad97e7a21eb52df179cd91ac411cbfbe"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.44"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "21b2ebcf727b7760c461f091f9f0f539b77b8e87f2fd88131e7f1b433b3cece4"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+
+[[package]]
+name = "syn"
+version = "2.0.115"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6e614ed320ac28113fa64972c4262d5dbc89deacdfd00c34a3e4cea073243c12"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "537dd038a89878be9b64dd4bd1b260315c1bb94f4d784956b81e27a088d9a09e"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"

ezsxf-0.1.0/Cargo.toml

@@ -0,0 +1,46 @@
+[package]
+name = "ezsxf"
+version = "0.1.0"
+edition = "2021"
+description = "Fast SXF parser and drawing converter for Python powered by Rust"
+license = "MIT"
+readme = "README.md"
+repository = "https://github.com/nekanat/ezsxf"
+homepage = "https://github.com/nekanat/ezsxf"
+keywords = ["sxf", "p21", "sfc", "cad", "parser"]
+categories = ["parser-implementations", "encoding"]
+include = [
+    "/Cargo.toml",
+    "/Cargo.lock",
+    "/pyproject.toml",
+    "/README.md",
+    "/LICENSE",
+    "/CHANGELOG.md",
+    "/src/*.rs",
+    "/src/ezsxf/__init__.py",
+    "/src/ezsxf/__main__.py",
+    "/src/ezsxf/_drawing.py",
+    "/src/ezsxf/_drawing_annotations.py",
+    "/src/ezsxf/_drawing_builder.py",
+    "/src/ezsxf/_drawing_geometry.py",
+    "/src/ezsxf/_drawing_hatches.py",
+    "/src/ezsxf/_drawing_style.py",
+    "/src/ezsxf/_dxf.py",
+    "/src/ezsxf/_plot.py",
+    "/src/ezsxf/_p21_drawing.py",
+    "/src/ezsxf/_core.pyi",
+    "/src/ezsxf/py.typed",
+    "/tests/test_python_api.py",
+    "/tests/test_conversion.py",
+]
+
+[lib]
+name = "_core"
+# "cdylib" is necessary to produce a shared library for Python to import from.
+crate-type = ["cdylib"]
+
+[dependencies]
+# "extension-module" tells pyo3 we want to build an extension module (skips linking against libpython.so)
+# "abi3-py39" tells pyo3 (and maturin) to build using the stable ABI with minimum Python version 3.9
+encoding_rs = "0.8"
+pyo3 = { version = "0.22.4", features = ["extension-module", "abi3-py39"] }

ezsxf-0.1.0/LICENSE

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

ezsxf-0.1.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: ezsxf
+Version: 0.1.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+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: Topic :: Software Development :: Libraries
+Requires-Dist: maturin>=1.0,<2.0 ; extra == 'dev'
+Requires-Dist: pytest>=8.0 ; extra == 'dev'
+Requires-Dist: matplotlib>=3.8 ; extra == 'plot'
+Provides-Extra: dev
+Provides-Extra: plot
+License-File: LICENSE
+Summary: Fast SXF parser and drawing converter for Python powered by Rust
+Keywords: sxf,p21,sfc,cad,parser
+Home-Page: https://github.com/nekanat/ezsxf
+Author-email: neka-nat <nekanat.stock@gmail.com>
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/nekanat/ezsxf
+Project-URL: Issues, https://github.com/nekanat/ezsxf/issues
+Project-URL: Repository, https://github.com/nekanat/ezsxf
+
+# ezsxf
+
+A fast SXF parser and drawing converter for Python, implemented in Rust with
+PyO3.
+
+`ezsxf` supports both SXF formats:
+- `P21` (ISO-10303-21 based)
+- `SFC` (SXF feature blocks)
+
+## Status
+
+The SFC parser covers all 34 feature types in the SXF Ver.3.1 SFC specification,
+including resolved drawing/compound-figure/composite-curve structure. The P21
+reader currently exposes the generic Part 21 entity representation.
+
+## Features
+
+- Parse `P21` and `SFC` from file path, text, or bytes
+- Decode SFC files as UTF-8 or Windows Shift-JIS/CP932 without lossy replacement
+- Strict and lenient parsing modes
+- Structured parse output (`header`, `entities`, `typed_features`, `model`, `warnings`)
+- Resolve layer/style code tables, compound-figure placements, and hatch boundaries
+- Decode `ATRF`/`ATRU`/`ATRS` attribute attachments separately from drawing groups
+- Validate compound-figure placement counts, hierarchy, and drawing-group transforms
+- Convert SFC drawings to AutoCAD 2007 ASCII DXF without another runtime dependency
+- Draw SFC drawings with the optional `matplotlib` backend
+- Python API + CLI (`ezsxf` / `python -m ezsxf`)
+
+## Installation
+
+### From source (recommended currently)
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install maturin
+maturin develop
+```
+
+Install the plotting extra when using the matplotlib backend:
+
+```bash
+pip install ".[plot]"
+```
+
+## Quick Start
+
+```python
+import ezsxf
+
+result = ezsxf.parse_sfc("./data/D0LS004ZSFC/D0LS004Z.SFC", strict=True)
+print(result["format"])          # "sfc"
+print(len(result["typed_features"]))
+print(result["model"]["sheet"]["component_ids"])
+```
+
+Convert the original input or an already parsed result to DXF:
+
+```python
+ezsxf.to_dxf("./data/D0LS004ZSFC/D0LS004Z.SFC", "drawing.dxf")
+
+parsed = ezsxf.parse_sfc("./data/D0LS004ZSFC/D0LS004Z.SFC")
+dxf_text = ezsxf.to_dxf(parsed)
+```
+
+Draw with matplotlib and save through the returned `Axes`:
+
+```python
+ax = ezsxf.plot("./data/D0LS004ZSFC/D0LS004Z.SFC")
+ax.figure.savefig("drawing.png", dpi=200, bbox_inches="tight")
+```
+
+Both backends share the same hierarchy, placement, layer, color, line type,
+line width, text, dimension, and hatch conversion. Curves are converted to
+polylines; use `curve_segments` to control the approximation resolution.
+
+Drawing conversion currently targets SFC input. Externally defined symbols are
+shown as insertion markers, while externally defined and tiled hatch patterns
+retain only boundaries marked visible by the SXF data.
+
+## CLI
+
+```bash
+# smoke test
+python -m ezsxf
+
+# parse to JSON
+python -m ezsxf parse sfc ./data/D0LS004ZSFC/D0LS004Z.SFC --pretty
+python -m ezsxf parse p21 ./data/D0LS004ZP21/D0LS004Z.P21 --lenient
+
+# convert SFC to DXF
+python -m ezsxf to-dxf ./data/D0LS004ZSFC/D0LS004Z.SFC drawing.dxf
+
+# save or interactively display a matplotlib drawing
+python -m ezsxf plot ./data/D0LS004ZSFC/D0LS004Z.SFC drawing.png --dpi 200
+python -m ezsxf plot ./data/D0LS004ZSFC/D0LS004Z.SFC
+```
+
+## Development
+
+```bash
+cargo fmt --check
+cargo clippy --all-targets --all-features -- -D warnings
+cargo test
+
+# Python-level tests
+python -m unittest discover -s tests -p 'test_*.py' -v
+```
+
+## Repository Layout
+
+- `src/*.rs`: Rust parser, resolved model, and PyO3 bindings
+- `src/ezsxf/`: Python API, CLI, DXF writer, matplotlib backend, and stubs
+- `data/`: SXF sample datasets used for validation
+- `resources/`: SXF specification PDFs (reference only)
+
+## License
+
+MIT License. See [LICENSE](./LICENSE).
+

ezsxf-0.1.0/README.md

@@ -0,0 +1,119 @@
+# ezsxf
+
+A fast SXF parser and drawing converter for Python, implemented in Rust with
+PyO3.
+
+`ezsxf` supports both SXF formats:
+- `P21` (ISO-10303-21 based)
+- `SFC` (SXF feature blocks)
+
+## Status
+
+The SFC parser covers all 34 feature types in the SXF Ver.3.1 SFC specification,
+including resolved drawing/compound-figure/composite-curve structure. The P21
+reader currently exposes the generic Part 21 entity representation.
+
+## Features
+
+- Parse `P21` and `SFC` from file path, text, or bytes
+- Decode SFC files as UTF-8 or Windows Shift-JIS/CP932 without lossy replacement
+- Strict and lenient parsing modes
+- Structured parse output (`header`, `entities`, `typed_features`, `model`, `warnings`)
+- Resolve layer/style code tables, compound-figure placements, and hatch boundaries
+- Decode `ATRF`/`ATRU`/`ATRS` attribute attachments separately from drawing groups
+- Validate compound-figure placement counts, hierarchy, and drawing-group transforms
+- Convert SFC drawings to AutoCAD 2007 ASCII DXF without another runtime dependency
+- Draw SFC drawings with the optional `matplotlib` backend
+- Python API + CLI (`ezsxf` / `python -m ezsxf`)
+
+## Installation
+
+### From source (recommended currently)
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install maturin
+maturin develop
+```
+
+Install the plotting extra when using the matplotlib backend:
+
+```bash
+pip install ".[plot]"
+```
+
+## Quick Start
+
+```python
+import ezsxf
+
+result = ezsxf.parse_sfc("./data/D0LS004ZSFC/D0LS004Z.SFC", strict=True)
+print(result["format"])          # "sfc"
+print(len(result["typed_features"]))
+print(result["model"]["sheet"]["component_ids"])
+```
+
+Convert the original input or an already parsed result to DXF:
+
+```python
+ezsxf.to_dxf("./data/D0LS004ZSFC/D0LS004Z.SFC", "drawing.dxf")
+
+parsed = ezsxf.parse_sfc("./data/D0LS004ZSFC/D0LS004Z.SFC")
+dxf_text = ezsxf.to_dxf(parsed)
+```
+
+Draw with matplotlib and save through the returned `Axes`:
+
+```python
+ax = ezsxf.plot("./data/D0LS004ZSFC/D0LS004Z.SFC")
+ax.figure.savefig("drawing.png", dpi=200, bbox_inches="tight")
+```
+
+Both backends share the same hierarchy, placement, layer, color, line type,
+line width, text, dimension, and hatch conversion. Curves are converted to
+polylines; use `curve_segments` to control the approximation resolution.
+
+Drawing conversion currently targets SFC input. Externally defined symbols are
+shown as insertion markers, while externally defined and tiled hatch patterns
+retain only boundaries marked visible by the SXF data.
+
+## CLI
+
+```bash
+# smoke test
+python -m ezsxf
+
+# parse to JSON
+python -m ezsxf parse sfc ./data/D0LS004ZSFC/D0LS004Z.SFC --pretty
+python -m ezsxf parse p21 ./data/D0LS004ZP21/D0LS004Z.P21 --lenient
+
+# convert SFC to DXF
+python -m ezsxf to-dxf ./data/D0LS004ZSFC/D0LS004Z.SFC drawing.dxf
+
+# save or interactively display a matplotlib drawing
+python -m ezsxf plot ./data/D0LS004ZSFC/D0LS004Z.SFC drawing.png --dpi 200
+python -m ezsxf plot ./data/D0LS004ZSFC/D0LS004Z.SFC
+```
+
+## Development
+
+```bash
+cargo fmt --check
+cargo clippy --all-targets --all-features -- -D warnings
+cargo test
+
+# Python-level tests
+python -m unittest discover -s tests -p 'test_*.py' -v
+```
+
+## Repository Layout
+
+- `src/*.rs`: Rust parser, resolved model, and PyO3 bindings
+- `src/ezsxf/`: Python API, CLI, DXF writer, matplotlib backend, and stubs
+- `data/`: SXF sample datasets used for validation
+- `resources/`: SXF specification PDFs (reference only)
+
+## License
+
+MIT License. See [LICENSE](./LICENSE).

ezsxf-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[project]
+name = "ezsxf"
+version = "0.1.0"
+description = "Fast SXF parser and drawing converter for Python powered by Rust"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [
+    { name = "neka-nat", email = "nekanat.stock@gmail.com" }
+]
+requires-python = ">=3.9"
+dependencies = []
+keywords = ["sxf", "p21", "sfc", "cad", "parser"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Rust",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+]
+
+[project.optional-dependencies]
+dev = ["maturin>=1.0,<2.0", "pytest>=8.0"]
+plot = ["matplotlib>=3.8"]
+
+[project.urls]
+Homepage = "https://github.com/nekanat/ezsxf"
+Repository = "https://github.com/nekanat/ezsxf"
+Issues = "https://github.com/nekanat/ezsxf/issues"
+
+[project.scripts]
+ezsxf = "ezsxf:main"
+
+[tool.maturin]
+module-name = "ezsxf._core"
+python-packages = ["ezsxf"]
+python-source = "src"
+
+[build-system]
+requires = ["maturin>=1.0,<2.0"]
+build-backend = "maturin"