pycadkit 0.5.0__tar.gz → 0.5.2__tar.gz

{pycadkit-0.5.0 → pycadkit-0.5.2}/Cargo.lock

@@ -152,7 +152,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "cadkit-core",
  "cadkit-dgn",
@@ -164,7 +164,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit-capi"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "cadkit",
  "serde",
@@ -173,7 +173,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit-cli"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "cadkit",
  "clap",
@@ -182,7 +182,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit-core"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "schemars",
  "serde",
@@ -192,7 +192,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit-dgn"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "cadkit-core",
  "cfb",
@@ -203,7 +203,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit-dwg"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "cadkit-core",
  "cadkit-dxf",
@@ -213,7 +213,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit-dxf"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "cadkit-core",
  "encoding_rs",
@@ -222,7 +222,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit-geom"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "i_overlay",
  "robust",
@@ -234,7 +234,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit-gml"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "cadkit-core",
  "quick-xml",
@@ -244,7 +244,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit-gpu"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "cadkit",
  "cadkit-geom",
@@ -257,7 +257,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit-py"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "cadkit",
  "pyo3",
@@ -267,7 +267,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit-scene"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "cadkit-core",
  "cadkit-geom",
@@ -276,7 +276,7 @@ dependencies = [
 
 [[package]]
 name = "cadkit-wasm"
-version = "0.5.0"
+version = "0.5.2"
 dependencies = [
  "cadkit",
  "js-sys",

{pycadkit-0.5.0 → pycadkit-0.5.2}/Cargo.toml

@@ -4,7 +4,7 @@ members = ["crates/*"]
 exclude = ["fuzz"]
 
 [workspace.package]
-version = "0.5.0"
+version = "0.5.2"
 edition = "2024"
 rust-version = "1.88"
 license = "MIT OR Apache-2.0"
@@ -14,18 +14,18 @@ keywords = ["cad", "dwg", "dgn", "dxf", "citygml"]
 categories = ["parser-implementations", "graphics", "encoding", "science::geo"]
 
 [workspace.dependencies]
-cadkit-geom = { path = "crates/cadkit-geom", version = "0.5.0" }
-cadkit-scene = { path = "crates/cadkit-scene", version = "0.5.0" }
-cadkit-gpu = { path = "crates/cadkit-gpu", version = "0.5.0" }
+cadkit-geom = { path = "crates/cadkit-geom", version = "0.5.2" }
+cadkit-scene = { path = "crates/cadkit-scene", version = "0.5.2" }
+cadkit-gpu = { path = "crates/cadkit-gpu", version = "0.5.2" }
 i_overlay = "=9.0.0"
 robust = "=1.2.0"
 schemars = "1.2.2"
-cadkit-core = { path = "crates/cadkit-core", version = "0.5.0" }
-cadkit-dgn = { path = "crates/cadkit-dgn", version = "0.5.0", default-features = false }
-cadkit-dwg = { path = "crates/cadkit-dwg", version = "0.5.0" }
-cadkit-dxf = { path = "crates/cadkit-dxf", version = "0.5.0" }
-cadkit-gml = { path = "crates/cadkit-gml", version = "0.5.0" }
-cadkit = { path = "crates/cadkit", version = "0.5.0" }
+cadkit-core = { path = "crates/cadkit-core", version = "0.5.2" }
+cadkit-dgn = { path = "crates/cadkit-dgn", version = "0.5.2", default-features = false }
+cadkit-dwg = { path = "crates/cadkit-dwg", version = "0.5.2" }
+cadkit-dxf = { path = "crates/cadkit-dxf", version = "0.5.2" }
+cadkit-gml = { path = "crates/cadkit-gml", version = "0.5.2" }
+cadkit = { path = "crates/cadkit", version = "0.5.2" }
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 thiserror = "2"

{pycadkit-0.5.0 → pycadkit-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycadkit
-Version: 0.5.0
+Version: 0.5.2
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
@@ -21,7 +21,7 @@ Provides-Extra: test
 License-File: LICENSE-MIT
 License-File: LICENSE-APACHE
 License-File: NOTICE
-Summary: Read DWG, DGN, DXF and CityGML into one format-neutral model; write DXF, DGN V8 and CityGML (pure Rust, no vendor SDK).
+Summary: Python CAD file I/O and document operations: read DWG/DGN/DXF/CityGML; write DXF, seed-based DGN V8, CityGML, SVG and JSON.
 Keywords: cad,dwg,dgn,dxf,citygml
 Author: TNYCL
 License-Expression: MIT OR Apache-2.0
@@ -35,10 +35,12 @@ Project-URL: Issues, https://github.com/TNYCL/cadkit/issues
 
 # pycadkit
 
-Python bindings for [cadkit](https://github.com/TNYCL/cadkit): read DWG, DGN (V7 and V8),
-DXF and CityGML 2.0 into one format-neutral model, and write SVG, JSON, DXF, seed-based
-DGN V8 and CityGML 2.0. The parsers are written in Rust; there is no vendor SDK, and one
-wheel per platform serves Python 3.9 and newer.
+Python file I/O and document operations for [cadkit](https://github.com/TNYCL/cadkit),
+an open-source CAD engine for building CAD applications. Read DWG, DGN (V7 and V8), DXF
+and CityGML 2.0 into one format-neutral model; write SVG, JSON, DXF, seed-based DGN V8 and
+CityGML 2.0. DWG is read-only; DGN output requires a compatible seed and covers a V8 subset.
+The parsers are written in Rust; there is no vendor SDK, and one wheel per platform serves
+Python 3.9 and newer.
 
 ```sh
 pip install pycadkit
@@ -54,6 +56,15 @@ print(doc)                       # <cadkit.Document format=dxf version="AC1032"
 open("plan.svg", "w").write(doc.to_svg())
 ```
 
+Use `inspect` for header-only metadata, `Document.convert_units` and `explode_inserts`
+for new documents without changing the source, and `V8Seed` for reusable DGN output seeds.
+Native CityGML read/write and explicit generic export are also available. CityGML generic
+export requires a CRS; DGN and CityGML export limits are linked from the
+[format matrix](https://github.com/TNYCL/cadkit#format-support).
+
+This package exposes the file/document APIs in the Python guide. The standalone Rust
+geometry, scene and GPU rendering crates are separate modules, without Python bindings.
+
 The API reference is [docs/python.md](https://github.com/TNYCL/cadkit/blob/main/docs/python.md).
 
 "DWG", "DGN" and "DXF" name file formats only; cadkit is not affiliated with or certified by

pycadkit-0.5.2/README.md

@@ -0,0 +1,41 @@
+# pycadkit
+
+Python file I/O and document operations for [cadkit](https://github.com/TNYCL/cadkit),
+an open-source CAD engine for building CAD applications. Read DWG, DGN (V7 and V8), DXF
+and CityGML 2.0 into one format-neutral model; write SVG, JSON, DXF, seed-based DGN V8 and
+CityGML 2.0. DWG is read-only; DGN output requires a compatible seed and covers a V8 subset.
+The parsers are written in Rust; there is no vendor SDK, and one wheel per platform serves
+Python 3.9 and newer.
+
+```sh
+pip install pycadkit
+```
+
+The package installs as `pycadkit` and imports as `cadkit`:
+
+```python
+import cadkit
+
+doc = cadkit.read("plan.dxf")    # path, os.PathLike or bytes
+print(doc)                       # <cadkit.Document format=dxf version="AC1032" ...>
+open("plan.svg", "w").write(doc.to_svg())
+```
+
+Use `inspect` for header-only metadata, `Document.convert_units` and `explode_inserts`
+for new documents without changing the source, and `V8Seed` for reusable DGN output seeds.
+Native CityGML read/write and explicit generic export are also available. CityGML generic
+export requires a CRS; DGN and CityGML export limits are linked from the
+[format matrix](https://github.com/TNYCL/cadkit#format-support).
+
+This package exposes the file/document APIs in the Python guide. The standalone Rust
+geometry, scene and GPU rendering crates are separate modules, without Python bindings.
+
+The API reference is [docs/python.md](https://github.com/TNYCL/cadkit/blob/main/docs/python.md).
+
+"DWG", "DGN" and "DXF" name file formats only; cadkit is not affiliated with or certified by
+any CAD vendor.
+
+## License
+
+Copyright 2026 TNYCL ([tnycl.com](https://tnycl.com)). Licensed under either of the Apache
+License, Version 2.0 or the MIT license at your option (`LICENSE-APACHE`, `LICENSE-MIT`).

{pycadkit-0.5.0 → pycadkit-0.5.2}/crates/cadkit/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "cadkit"
-description = "Read DWG, DGN, DXF and CityGML into one format-neutral model; write DXF, DGN V8 and CityGML. Pure Rust, no vendor SDK."
+description = "CAD file I/O and document operations for cadkit: read DWG/DGN/DXF/CityGML; write DXF, seed-based DGN V8 and CityGML."
 version.workspace = true
 readme = "README.md"
 edition.workspace = true

pycadkit-0.5.2/crates/cadkit/README.md

@@ -0,0 +1,47 @@
+# cadkit
+
+The file I/O and document facade of [cadkit](https://github.com/TNYCL/cadkit), an open-source
+CAD engine for building CAD applications. Read DWG, DGN (V7 and V8), DXF and CityGML 2.0
+into one format-neutral model; write DXF, seed-based DGN V8, CityGML 2.0, SVG and JSON.
+DWG is read-only; DGN writing covers a documented V8 subset and requires a compatible seed.
+The parsers are pure Rust and use no vendor SDK.
+
+Use header-only inspection, bounded stream I/O and Cargo features to select the file
+handling your application needs. Documents support transforms, unit conversion, block
+expansion, layer filtering and unused-definition purging through `cadkit-core`, re-exported
+by this facade. Recoverable reader problems become document warnings; configurable limits
+bound input handling.
+
+```rust
+let doc = cadkit::open("plan.dxf")?;
+for model in &doc.models {
+    println!("{}: {} entities", model.name, model.entities.len());
+}
+std::fs::write("plan.svg", cadkit::to_svg(&doc, &cadkit::SvgOptions::default()))?;
+```
+
+Format support, limits and test evidence are in the [repository README](https://github.com/TNYCL/cadkit#format-support).
+The same core is available as a CLI ([`cadkit-cli`](https://crates.io/crates/cadkit-cli)),
+for Python ([`pycadkit`](https://pypi.org/project/pycadkit/)), for JavaScript
+([`cadkit-wasm`](https://www.npmjs.com/package/cadkit-wasm)) and as a C/C++ library
+([GitHub Releases](https://github.com/TNYCL/cadkit/releases)).
+
+## Modules and API migration
+
+Adopt [`cadkit-geom`](https://crates.io/crates/cadkit-geom) for standalone analytic geometry,
+[`cadkit-scene`](https://crates.io/crates/cadkit-scene) for GPU-independent plan/mesh data,
+and [`cadkit-gpu`](https://crates.io/crates/cadkit-gpu) for `wgpu` rendering separately.
+Reading a file through this facade does not bring in a GPU runtime.
+
+Version 0.5 introduces model/option constructors, non-exhaustive types, typed limit errors
+and versioned document JSON. See the
+[0.4 to 0.5 migration guide](https://github.com/TNYCL/cadkit/blob/main/CHANGELOG.md#migrating-from-04).
+
+"DWG", "DGN" and "DXF" name file formats only; cadkit is not affiliated with or certified by
+any CAD vendor. Sources of format knowledge are listed in
+[docs/PROVENANCE.md](https://github.com/TNYCL/cadkit/blob/main/docs/PROVENANCE.md).
+
+## License
+
+Copyright 2026 TNYCL ([tnycl.com](https://tnycl.com)). Licensed under either of
+[Apache License, Version 2.0](LICENSE-APACHE) or [MIT license](LICENSE-MIT) at your option.

{pycadkit-0.5.0 → pycadkit-0.5.2}/crates/cadkit/src/lib.rs

@@ -333,6 +333,20 @@ pub fn to_svg_all_layers(doc: &Document, options: &SvgOptions) -> String {
     cadkit_core::svg::render_all_layers(doc, options)
 }
 
+/// Renders a complete SVG within the output byte and work budgets in `options`.
+/// `include_hidden_layers` includes hidden and frozen layers when true.
+/// Returns [`Error::LimitExceeded`] rather than a truncated drawing. The byte
+/// cap includes all markup and bounds temporary SVG strings during generation;
+/// it does not bound the memory already owned by the parsed document.
+#[cfg(feature = "svg")]
+pub fn to_svg_bounded(
+    doc: &Document,
+    options: &SvgOptions,
+    include_hidden_layers: bool,
+) -> Result<String> {
+    cadkit_core::svg::render_bounded(doc, options, include_hidden_layers)
+}
+
 /// Writes an SVG rendering of `doc` into `writer`.
 #[cfg(feature = "svg")]
 pub fn write_svg_to(doc: &Document, options: &SvgOptions, mut writer: impl Write) -> Result<()> {

{pycadkit-0.5.0 → pycadkit-0.5.2}/crates/cadkit-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "cadkit-core"
-description = "Format-neutral CAD drawing model, bounded binary readers and SVG export for cadkit."
+description = "CAD document model and operations, bounded byte readers, versioned JSON and SVG export for cadkit."
 version.workspace = true
 readme = "README.md"
 edition.workspace = true

pycadkit-0.5.2/crates/cadkit-core/README.md

@@ -0,0 +1,29 @@
+# cadkit-core
+
+The format-neutral drawing model shared by the [cadkit](https://github.com/TNYCL/cadkit) readers and writers:
+documents, models, layers, blocks and entities, bounded byte readers, read limits, errors
+and warnings, polygon validation and SVG export. This is the document layer of the
+cadkit CAD engine; it has no GPU dependency.
+
+`Document` operations include affine transforms, unit conversion, block expansion, group
+flattening, layer filtering and unused-definition purging. Coordinates use drawing units;
+angles are radians. Version 0.5 adds constructors and setters for non-exhaustive model and
+option types, `LimitKind` on limit errors and `Document::schema_version` (currently 1).
+Enable `schemars` for JSON Schema; the repository also includes the
+[document schema](https://github.com/TNYCL/cadkit/blob/main/docs/schema/document-v1.schema.json).
+See the [migration guide](https://github.com/TNYCL/cadkit/blob/main/CHANGELOG.md#migrating-from-04)
+for source and JSON compatibility.
+
+Standalone analytic geometry lives in [`cadkit-geom`](https://crates.io/crates/cadkit-geom);
+scene preparation and GPU rendering live in separate crates.
+
+Most applications should depend on the [`cadkit`](https://crates.io/crates/cadkit) facade crate, which detects the format and re-exports this crate.
+
+"DWG", "DGN" and "DXF" name file formats only; cadkit is not affiliated with or certified by
+any CAD vendor. Sources of format knowledge are listed in
+[docs/PROVENANCE.md](https://github.com/TNYCL/cadkit/blob/main/docs/PROVENANCE.md).
+
+## License
+
+Copyright 2026 TNYCL ([tnycl.com](https://tnycl.com)). Licensed under either of
+[Apache License, Version 2.0](LICENSE-APACHE) or [MIT license](LICENSE-MIT) at your option.

pycadkit-0.5.2/crates/cadkit-core/src/svg/bounded_tests.rs

@@ -0,0 +1,219 @@
+use super::*;
+use crate::model::{Block, Layer, Model};
+
+fn line() -> Entity {
+    Entity::new(EntityKind::Line {
+        start: Point3::xy(0.0, 0.0),
+        end: Point3::xy(10.0, 5.0),
+    })
+}
+
+fn document(entities: Vec<Entity>) -> Document {
+    Document {
+        models: vec![Model {
+            entities,
+            ..Model::default()
+        }],
+        ..Document::default()
+    }
+}
+
+fn text(value: String) -> Entity {
+    Entity::new(EntityKind::Text {
+        position: Point3::default(),
+        end_point: None,
+        height: 1.0,
+        rotation: 0.0,
+        width_factor: 1.0,
+        oblique: 0.0,
+        value,
+        style: None,
+        halign: HAlign::Left,
+        valign: VAlign::Baseline,
+        normal: Vec3::Z,
+    })
+}
+
+fn assert_output_limit(result: crate::Result<String>) {
+    assert!(matches!(
+        result,
+        Err(crate::Error::LimitExceeded {
+            limit: crate::LimitKind::Output,
+            ..
+        })
+    ));
+}
+
+#[test]
+fn exact_utf8_budget_includes_markup_and_hidden_layer_names() {
+    let mut entity = text("測定<&>🙂".into());
+    entity.layer = Some("隠れた<&>🙂".into());
+    let mut doc = document(vec![entity]);
+    doc.layers.push(Layer {
+        name: "隠れた<&>🙂".into(),
+        visible: false,
+        ..Layer::default()
+    });
+    let options = SvgOptions::default();
+    for hidden in [false, true] {
+        let expected = if hidden {
+            render_all_layers(&doc, &options)
+        } else {
+            render(&doc, &options)
+        };
+        let exact = options.clone().with_max_output_bytes(expected.len());
+        assert_eq!(
+            render_bounded(&doc, &exact, hidden).expect("exact budget"),
+            expected
+        );
+        assert_output_limit(render_bounded(
+            &doc,
+            &exact.with_max_output_bytes(expected.len() - 1),
+            hidden,
+        ));
+    }
+}
+
+#[test]
+fn a_single_path_is_stopped_before_the_next_entity() {
+    let polyline = Entity::new(EntityKind::Polyline {
+        vertices: (0..20_000)
+            .map(|i| Vertex {
+                position: Point3::xy(f64::from(i), f64::from(i % 2)),
+                ..Vertex::default()
+            })
+            .collect(),
+        closed: false,
+        normal: Vec3::Z,
+    });
+    let options = SvgOptions::default().with_max_output_bytes(1024);
+    assert_output_limit(render_bounded(&document(vec![polyline]), &options, true));
+}
+
+#[test]
+fn escaping_and_background_do_not_allocate_an_oversized_result() {
+    let options = SvgOptions::default().with_max_output_bytes(1024);
+    // Input fits but XML escaping expands it beyond the cap within one entity.
+    assert_output_limit(render_bounded(
+        &document(vec![text("&".repeat(600))]),
+        &options,
+        true,
+    ));
+    let options = options.with_background(Some("&".repeat(600)));
+    assert_output_limit(render_bounded(&Document::default(), &options, true));
+    assert_output_limit(render_bounded(
+        &Document::default(),
+        &SvgOptions::default().with_max_output_bytes(1),
+        true,
+    ));
+}
+
+#[test]
+fn many_layers_and_entities_cannot_accumulate_unbounded_output() {
+    let doc = document(
+        (0..10_000)
+            .map(|i| {
+                let mut entity = line();
+                entity.layer = Some(format!("layer-{i}-{}", "&".repeat(32)));
+                entity
+            })
+            .collect(),
+    );
+    assert_output_limit(render_bounded(
+        &doc,
+        &SvgOptions::default().with_max_output_bytes(16_384),
+        true,
+    ));
+}
+
+#[test]
+fn work_exhaustion_is_an_error_instead_of_an_empty_or_partial_success() {
+    let doc = document(vec![line(); 100]);
+    for work in [0, 10] {
+        assert!(matches!(
+            render_bounded(&doc, &SvgOptions::default().with_max_work(work), true),
+            Err(crate::Error::LimitExceeded {
+                limit: crate::LimitKind::Work,
+                ..
+            })
+        ));
+    }
+}
+
+#[test]
+fn block_array_expansion_obeys_output_and_work_limits() {
+    let insert = Entity::new(EntityKind::Insert {
+        block: "lines".into(),
+        position: Point3::default(),
+        scale: Vec3::new(1.0, 1.0, 1.0),
+        rotation: 0.0,
+        normal: Vec3::Z,
+        columns: 100,
+        rows: 100,
+        column_spacing: 20.0,
+        row_spacing: 20.0,
+    });
+    let mut doc = document(vec![insert]);
+    doc.blocks.push(Block {
+        name: "lines".into(),
+        entities: vec![line()],
+        ..Block::default()
+    });
+    assert_output_limit(render_bounded(
+        &doc,
+        &SvgOptions::default().with_max_output_bytes(4096),
+        true,
+    ));
+    assert!(matches!(
+        render_bounded(&doc, &SvgOptions::default().with_max_work(10), true),
+        Err(crate::Error::LimitExceeded {
+            limit: crate::LimitKind::Work,
+            ..
+        })
+    ));
+    let small = document(vec![line()]);
+    assert_eq!(
+        render_bounded(&small, &SvgOptions::default(), true).expect("next document"),
+        render_all_layers(&small, &SvgOptions::default())
+    );
+}
+
+#[test]
+fn hatch_definitions_are_part_of_the_exact_output_budget() {
+    let hatch = Entity::new(EntityKind::Hatch {
+        loops: vec![crate::model::HatchLoop {
+            edges: vec![HatchEdge::Polyline {
+                vertices: vec![
+                    Vertex {
+                        position: Point3::xy(0.0, 0.0),
+                        ..Vertex::default()
+                    },
+                    Vertex {
+                        position: Point3::xy(5.0, 5.0),
+                        ..Vertex::default()
+                    },
+                ],
+                closed: true,
+            }],
+            external: true,
+        }],
+        solid: false,
+        pattern: Some("ANSI37".into()),
+        pattern_scale: 1.0,
+        pattern_angle: 0.0,
+        normal: Vec3::Z,
+    });
+    let doc = document(vec![hatch]);
+    let expected = render_all_layers(&doc, &SvgOptions::default());
+    assert!(expected.contains("<defs>"));
+    let options = SvgOptions::default().with_max_output_bytes(expected.len());
+    assert_eq!(
+        render_bounded(&doc, &options, true).expect("exact hatch budget"),
+        expected
+    );
+    assert_output_limit(render_bounded(
+        &doc,
+        &options.with_max_output_bytes(expected.len() - 1),
+        true,
+    ));
+}