simplecadapi 2.0.6__tar.gz → 2.0.8__tar.gz

{simplecadapi-2.0.6 → simplecadapi-2.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplecadapi
-Version: 2.0.6
+Version: 2.0.8
 Summary: A simplified CAD modeling Python API based on CADQuery
 Project-URL: Homepage, https://github.com/NiJingzhe/SimpleCADAPI
 Project-URL: Repository, https://github.com/NiJingzhe/SimpleCADAPI
@@ -385,7 +385,7 @@ Experimental scripts and temporary modeling examples are not included as formal
 
 ## Package Installation (Python Package Managers)
 
-Current package name: `simplecadapi`, version: `2.0.6` (see `pyproject.toml`).
+Current package name: `simplecadapi`, version: `2.0.8` (see `pyproject.toml`).
 
 ### Method A: Install from package repository with pip
 
@@ -418,7 +418,7 @@ uv add simplecadapi
 The repository already contains example build artifacts (`dist/`):
 
 ```bash
-pip install dist/simplecadapi-2.0.6-py3-none-any.whl
+pip install dist/simplecadapi-2.0.8-py3-none-any.whl
 ```
 
 If you need to rebuild:

{simplecadapi-2.0.6 → simplecadapi-2.0.8}/README.md

@@ -9,7 +9,7 @@ Experimental scripts and temporary modeling examples are not included as formal
 
 ## Package Installation (Python Package Managers)
 
-Current package name: `simplecadapi`, version: `2.0.6` (see `pyproject.toml`).
+Current package name: `simplecadapi`, version: `2.0.8` (see `pyproject.toml`).
 
 ### Method A: Install from package repository with pip
 
@@ -42,7 +42,7 @@ uv add simplecadapi
 The repository already contains example build artifacts (`dist/`):
 
 ```bash
-pip install dist/simplecadapi-2.0.6-py3-none-any.whl
+pip install dist/simplecadapi-2.0.8-py3-none-any.whl
 ```
 
 If you need to rebuild:

simplecadapi-2.0.8/docs/api/export_step.md

@@ -0,0 +1,47 @@
+# export_step
+
+## API Definition
+
+```python
+def export_step(shapes: Union[AnyShape, Sequence[AnyShape]], filename: str) -> None
+```
+
+*Source: operations.py*
+
+## Description
+
+Export shapes to STEP.
+
+Use this function when you want to export one shape or many shapes into the
+same STEP file. Passing `List[Solid]` is valid and often preferred when a
+previous boolean operation returned multiple solids.
+
+## Parameters
+
+### shapes
+
+- **Description**: A single exportable shape or any nested sequence of exportable shapes. Lists of Solid are supported directly, including list results returned by boolean operations.
+
+### filename
+
+- **Description**: Output STEP file path.
+
+## Returns
+
+None: Writes the provided shapes into one STEP file.
+
+## Examples
+
+### Example 1
+```python
+main_body = make_box_rsolid(10, 4, 4, bottom_face_center=(0, 0, 0))
+left_cap = make_sphere_rsolid(2.0, center=(-2.0, 2.0, 2.0))
+right_cap = make_sphere_rsolid(2.0, center=(12.0, 2.0, 2.0))
+body_parts = union_rsolidlist(main_body, [left_cap, right_cap])
+```
+
+### Example 2
+```python
+# Export the full list directly; no need to collapse to body_parts[0].
+export_step(body_parts, "rounded_bar.step")
+```

simplecadapi-2.0.8/docs/api/export_stl.md

@@ -0,0 +1,47 @@
+# export_stl
+
+## API Definition
+
+```python
+def export_stl(shapes: Union[AnyShape, Sequence[AnyShape]], filename: str) -> None
+```
+
+*Source: operations.py*
+
+## Description
+
+Export shapes to STL.
+
+Use this function when you want to export one solid or many solids/faces into
+the same STL file. Passing `List[Solid]` is valid and often preferred when a
+previous boolean operation returned multiple solids.
+
+## Parameters
+
+### shapes
+
+- **Description**: A single Solid or Face, or any nested sequence of Solid/Face. Lists of Solid are supported directly, including list results returned by boolean operations.
+
+### filename
+
+- **Description**: Output STL file path.
+
+## Returns
+
+None: Writes the provided shapes into one STL file.
+
+## Examples
+
+### Example 1
+```python
+main_body = make_box_rsolid(10, 4, 4, bottom_face_center=(0, 0, 0))
+left_cap = make_sphere_rsolid(2.0, center=(-2.0, 2.0, 2.0))
+right_cap = make_sphere_rsolid(2.0, center=(12.0, 2.0, 2.0))
+body_parts = union_rsolidlist(main_body, [left_cap, right_cap])
+```
+
+### Example 2
+```python
+# Export the list result directly.
+export_stl(body_parts, "rounded_bar.stl")
+```

{simplecadapi-2.0.6 → simplecadapi-2.0.8}/docs/api/union_rsolidlist.md

@@ -3,7 +3,12 @@
 ## API Definition
 
 ```python
-def union_rsolidlist(*solids: Union[Solid, Sequence[Solid]]) -> List[Solid]
+def union_rsolidlist(
+    *solids: Union[Solid, Sequence[Solid]],
+    clean: bool = True,
+    glue: bool = True,
+    tol: Optional[float] = None,
+) -> List[Solid]
 ```
 
 *Source: operations.py*
@@ -15,13 +20,18 @@ Compute the boolean union of one or more solids.
 All boolean operations (union/cut/intersect) accept a mix of Solid and
 sequences; results are always returned as a list of Solid.
 Keep the list result unless you have explicitly verified `len(result) == 1`.
+SimpleCAD enables glue mode by default and applies a conservative internal fuzzy
+tolerance, so normal modeling code does not need to tune boolean parameters.
+By default this follows CadQuery's union flow: perform one OCC fuse across the
+input solids, then call `clean()` to unify same-domain faces when possible.
 Touching-but-not-intersecting inputs can legitimately return multiple solids.
 If that happens, keep using the list: pass it directly into later union calls,
 or iterate over the solids for later cut/intersect steps.
+When the returned solids are still separated by more than the active tolerance,
+SimpleCAD prints a stdout warning explaining that the objects do not touch and
+that their gap exceeds `tol`.
 If you truly need exactly one merged solid, you must check the list length
-before using `result[0]`. When the length is not 1, do not pick an element
-arbitrarily; instead, adjust part placement so the solids overlap slightly,
-then run the union again.
+before using `result[0]`.
 
 ## Parameters
 
@@ -29,6 +39,18 @@ then run the union again.
 
 - **Description**: One or more Solid objects or sequences of Solid. Nested sequences are flattened before processing.
 
+### clean
+
+- **Description**: Call CadQuery's `clean()` after the union to remove splitter edges and unify same-domain faces when possible.
+
+### glue
+
+- **Description**: Enable OCC glue mode for touching or partially overlapping inputs. Defaults to `True` for SimpleCAD's standard union behavior.
+
+### tol
+
+- **Description**: Optional fuzzy-boolean tolerance passed to the OCC union kernel. When omitted, SimpleCAD derives a conservative scale-aware value automatically.
+
 ## Returns
 
 List[Solid]: Resulting solids after union attempts. Solids that can be fused

{simplecadapi-2.0.6 → simplecadapi-2.0.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "simplecadapi"
-version = "2.0.6"
+version = "2.0.8"
 description = "A simplified CAD modeling Python API based on CADQuery"
 readme = "README.md"
 license = { file = "LICENSE" }

{simplecadapi-2.0.6 → simplecadapi-2.0.8}/skills/simplecad-self-evolve/SKILL.md

@@ -5,9 +5,9 @@ license: MIT
 compatibility: Requires Python 3.10+, active virtual environment, and network access for package installation.
 metadata:
   project: simplecadapi
-  version: 2.0.6
+  version: 2.0.8
   runtime-package: simplecadapi
-  runtime-spec: simplecadapi==2.0.6
+  runtime-spec: simplecadapi==2.0.8
   cases-module: simplecad_self_evolve_cases
 ---
 
@@ -53,7 +53,7 @@ metadata:
 ## Install behavior
 - Preferred: run `scripts/install.sh` once when skill is installed/activated.
 - Runtime wrappers auto-install on demand if `simplecadapi` is missing.
-- Package installed by default: `simplecadapi==2.0.6`
+- Package installed by default: `simplecadapi==2.0.8`
 - Wrappers install only into a virtual environment interpreter (set `PYTHON_BIN` when needed).
 
 ## Interpreter selection

{simplecadapi-2.0.6 → simplecadapi-2.0.8}/skills/simplecad-self-evolve/references/PROJECT_OVERVIEW.md

@@ -1,8 +1,8 @@
 # Project Overview
 
 - Project: `simplecadapi`
-- Version: `2.0.6`
-- Runtime package: `simplecadapi==2.0.6`
+- Version: `2.0.8`
+- Runtime package: `simplecadapi==2.0.8`
 - Skill cases module: `simplecad_self_evolve_cases`
 
 ## What this skill bundles

{simplecadapi-2.0.6 → simplecadapi-2.0.8}/skills/simplecad-self-evolve/references/PROJECT_README.md

@@ -9,7 +9,7 @@ Experimental scripts and temporary modeling examples are not included as formal
 
 ## Package Installation (Python Package Managers)
 
-Current package name: `simplecadapi`, version: `2.0.6` (see `pyproject.toml`).
+Current package name: `simplecadapi`, version: `2.0.8` (see `pyproject.toml`).
 
 ### Method A: Install from package repository with pip
 
@@ -42,7 +42,7 @@ uv add simplecadapi
 The repository already contains example build artifacts (`dist/`):
 
 ```bash
-pip install dist/simplecadapi-2.0.6-py3-none-any.whl
+pip install dist/simplecadapi-2.0.8-py3-none-any.whl
 ```
 
 If you need to rebuild:

{simplecadapi-2.0.6 → simplecadapi-2.0.8}/skills/simplecad-self-evolve/references/RUNTIME_INSTALL.md

@@ -6,7 +6,7 @@
 PYTHON_BIN=.venv/bin/python scripts/install.sh
 ```
 
-This installs `simplecadapi==2.0.6` to the active Python environment.
+This installs `simplecadapi==2.0.8` to the active Python environment.
 If `PYTHON_BIN` is not set, wrappers default to `python3` (fallback `python`).
 Installation is intentionally blocked for non-venv/system interpreters.
 

simplecadapi-2.0.8/skills/simplecad-self-evolve/references/docs/api/export_step.md

@@ -0,0 +1,47 @@
+# export_step
+
+## API Definition
+
+```python
+def export_step(shapes: Union[AnyShape, Sequence[AnyShape]], filename: str) -> None
+```
+
+*Source: operations.py*
+
+## Description
+
+Export shapes to STEP.
+
+Use this function when you want to export one shape or many shapes into the
+same STEP file. Passing `List[Solid]` is valid and often preferred when a
+previous boolean operation returned multiple solids.
+
+## Parameters
+
+### shapes
+
+- **Description**: A single exportable shape or any nested sequence of exportable shapes. Lists of Solid are supported directly, including list results returned by boolean operations.
+
+### filename
+
+- **Description**: Output STEP file path.
+
+## Returns
+
+None: Writes the provided shapes into one STEP file.
+
+## Examples
+
+### Example 1
+```python
+main_body = make_box_rsolid(10, 4, 4, bottom_face_center=(0, 0, 0))
+left_cap = make_sphere_rsolid(2.0, center=(-2.0, 2.0, 2.0))
+right_cap = make_sphere_rsolid(2.0, center=(12.0, 2.0, 2.0))
+body_parts = union_rsolidlist(main_body, [left_cap, right_cap])
+```
+
+### Example 2
+```python
+# Export the full list directly; no need to collapse to body_parts[0].
+export_step(body_parts, "rounded_bar.step")
+```

simplecadapi-2.0.8/skills/simplecad-self-evolve/references/docs/api/export_stl.md

@@ -0,0 +1,47 @@
+# export_stl
+
+## API Definition
+
+```python
+def export_stl(shapes: Union[AnyShape, Sequence[AnyShape]], filename: str) -> None
+```
+
+*Source: operations.py*
+
+## Description
+
+Export shapes to STL.
+
+Use this function when you want to export one solid or many solids/faces into
+the same STL file. Passing `List[Solid]` is valid and often preferred when a
+previous boolean operation returned multiple solids.
+
+## Parameters
+
+### shapes
+
+- **Description**: A single Solid or Face, or any nested sequence of Solid/Face. Lists of Solid are supported directly, including list results returned by boolean operations.
+
+### filename
+
+- **Description**: Output STL file path.
+
+## Returns
+
+None: Writes the provided shapes into one STL file.
+
+## Examples
+
+### Example 1
+```python
+main_body = make_box_rsolid(10, 4, 4, bottom_face_center=(0, 0, 0))
+left_cap = make_sphere_rsolid(2.0, center=(-2.0, 2.0, 2.0))
+right_cap = make_sphere_rsolid(2.0, center=(12.0, 2.0, 2.0))
+body_parts = union_rsolidlist(main_body, [left_cap, right_cap])
+```
+
+### Example 2
+```python
+# Export the list result directly.
+export_stl(body_parts, "rounded_bar.stl")
+```

{simplecadapi-2.0.6 → simplecadapi-2.0.8}/skills/simplecad-self-evolve/references/docs/api/union_rsolidlist.md

@@ -3,7 +3,12 @@
 ## API Definition
 
 ```python
-def union_rsolidlist(*solids: Union[Solid, Sequence[Solid]]) -> List[Solid]
+def union_rsolidlist(
+    *solids: Union[Solid, Sequence[Solid]],
+    clean: bool = True,
+    glue: bool = True,
+    tol: Optional[float] = None,
+) -> List[Solid]
 ```
 
 *Source: operations.py*
@@ -15,13 +20,18 @@ Compute the boolean union of one or more solids.
 All boolean operations (union/cut/intersect) accept a mix of Solid and
 sequences; results are always returned as a list of Solid.
 Keep the list result unless you have explicitly verified `len(result) == 1`.
+SimpleCAD enables glue mode by default and applies a conservative internal fuzzy
+tolerance, so normal modeling code does not need to tune boolean parameters.
+By default this follows CadQuery's union flow: perform one OCC fuse across the
+input solids, then call `clean()` to unify same-domain faces when possible.
 Touching-but-not-intersecting inputs can legitimately return multiple solids.
 If that happens, keep using the list: pass it directly into later union calls,
 or iterate over the solids for later cut/intersect steps.
+When the returned solids are still separated by more than the active tolerance,
+SimpleCAD prints a stdout warning explaining that the objects do not touch and
+that their gap exceeds `tol`.
 If you truly need exactly one merged solid, you must check the list length
-before using `result[0]`. When the length is not 1, do not pick an element
-arbitrarily; instead, adjust part placement so the solids overlap slightly,
-then run the union again.
+before using `result[0]`.
 
 ## Parameters
 
@@ -29,6 +39,18 @@ then run the union again.
 
 - **Description**: One or more Solid objects or sequences of Solid. Nested sequences are flattened before processing.
 
+### clean
+
+- **Description**: Call CadQuery's `clean()` after the union to remove splitter edges and unify same-domain faces when possible.
+
+### glue
+
+- **Description**: Enable OCC glue mode for touching or partially overlapping inputs. Defaults to `True` for SimpleCAD's standard union behavior.
+
+### tol
+
+- **Description**: Optional fuzzy-boolean tolerance passed to the OCC union kernel. When omitted, SimpleCAD derives a conservative scale-aware value automatically.
+
 ## Returns
 
 List[Solid]: Resulting solids after union attempts. Solids that can be fused

{simplecadapi-2.0.6 → simplecadapi-2.0.8}/skills/simplecad-self-evolve/scripts/install.sh

@@ -32,7 +32,7 @@ export SIMPLECAD_RUNTIME_PACKAGE="simplecadapi"
 export SIMPLECAD_CASES_ROOT="${SKILL_ROOT}/cases"
 export SIMPLECAD_CASES_MODULE="simplecad_self_evolve_cases"
 
-PACKAGE_SPEC="simplecadapi==2.0.6"
+PACKAGE_SPEC="simplecadapi==2.0.8"
 JUPYTER_DEPS=("jupyterlab>=4.5.5" "ipykernel>=6.29.5")
 INSTALL_JUPYTER=0
 INSTALL_ARGS=()
@@ -85,4 +85,4 @@ print("simplecadapi import OK")
 print(getattr(scad, "__description__", ""))
 PY
 
-echo "Runtime install completed for simplecadapi 2.0.6."
+echo "Runtime install completed for simplecadapi 2.0.8."

{simplecadapi-2.0.6 → simplecadapi-2.0.8}/skills/simplecad-self-evolve/scripts/repl_bootstrap.py

@@ -10,7 +10,7 @@ import sys
 from pathlib import Path
 
 
-PACKAGE_SPEC = "simplecadapi==2.0.6"
+PACKAGE_SPEC = "simplecadapi==2.0.8"
 CASES_MODULE = "simplecad_self_evolve_cases"
 
 

{simplecadapi-2.0.6 → simplecadapi-2.0.8}/src/simplecadapi/auto_tools/skill_pack.py

@@ -565,13 +565,16 @@ class SkillPackager:
             7. Build and validate incrementally. Each step MUST include a small grounding `print`, and grounding MUST use QL where possible.
             8. For inspection/debugging, query geometry with QL and print only the queried facts you need; do not print whole solids, assemblies, or full model objects.
             9. Boolean operations always return `List[Solid]`. You MUST check `len(results)` before using `results[0]`.
-            10. If tangent-only contact leaves multiple solids after `union_rsolidlist(...)`, that is often acceptable. Keep the list and continue operating on the list or iterate over its solids.
-            11. If the design explicitly requires exactly one merged solid and `len(results) != 1`, you MUST NOT silently pick one item. Instead, slightly adjust part placement so the intended bodies overlap/embed, run the union again, and only then unwrap the single result.
-            12. After model construction, ask the user whether the result is satisfactory and whether any modifications are needed. Only after explicit user confirmation may you add the script to evolve cases.
+            10. `union_rsolidlist(...)` already uses SimpleCAD's tuned default boolean settings internally. Do not add manual boolean tuning unless you are debugging a stubborn edge case.
+            11. If tangent-only contact leaves multiple solids after `union_rsolidlist(...)`, that is often acceptable. Keep the list and continue operating on the list or iterate over its solids.
+            12. If the design explicitly requires exactly one merged solid and `len(results) != 1`, you MUST NOT silently pick one item. Instead, slightly adjust part placement so the intended bodies overlap/embed, run the union again, and only then unwrap the single result.
+            13. After model construction, ask the user whether the result is satisfactory and whether any modifications are needed. Only after explicit user confirmation may you add the script to evolve cases.
 
             ## Boolean result discipline
             - `union_rsolidlist(...)`, `cut_rsolidlist(...)`, and `intersect_rsolidlist(...)` accept mixed inputs: standalone `Solid`, lists of `Solid`, and nested sequences.
             - They always return `List[Solid]`.
+            - `union_rsolidlist(...)` already applies the package's default glue mode and a conservative internal tolerance.
+            - If a union still returns multiple solids that remain separated beyond tolerance, the API prints a stdout warning automatically.
             - Default behavior: keep the list result and pass it forward or iterate over it.
             - Only unwrap to a single solid after an explicit `len(results) == 1` check.
             - If a single merged solid is required but a union still returns multiple solids, slightly move the parts so they overlap instead of merely touching, then recompute the union.