simplecadapi 2.0.6__tar.gz → 2.0.7__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplecadapi
-Version: 2.0.6
+Version: 2.0.7
 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.7` (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.7-py3-none-any.whl
 ```
 
 If you need to rebuild:

{simplecadapi-2.0.6 → simplecadapi-2.0.7}/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.7` (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.7-py3-none-any.whl
 ```
 
 If you need to rebuild:

simplecadapi-2.0.7/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.7/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.7}/pyproject.toml

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

{simplecadapi-2.0.6 → simplecadapi-2.0.7}/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.7
   runtime-package: simplecadapi
-  runtime-spec: simplecadapi==2.0.6
+  runtime-spec: simplecadapi==2.0.7
   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.7`
 - Wrappers install only into a virtual environment interpreter (set `PYTHON_BIN` when needed).
 
 ## Interpreter selection

{simplecadapi-2.0.6 → simplecadapi-2.0.7}/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.7`
+- Runtime package: `simplecadapi==2.0.7`
 - Skill cases module: `simplecad_self_evolve_cases`
 
 ## What this skill bundles

{simplecadapi-2.0.6 → simplecadapi-2.0.7}/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.7` (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.7-py3-none-any.whl
 ```
 
 If you need to rebuild:

{simplecadapi-2.0.6 → simplecadapi-2.0.7}/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.7` 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.7/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.7/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.7}/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.7"
 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.7."

{simplecadapi-2.0.6 → simplecadapi-2.0.7}/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.7"
 CASES_MODULE = "simplecad_self_evolve_cases"
 
 

{simplecadapi-2.0.6 → simplecadapi-2.0.7}/src/simplecadapi/operations.py

@@ -1625,7 +1625,31 @@ def _normalize_shape_input(
 
 
 def export_step(shapes: Union[AnyShape, Sequence[AnyShape]], filename: str) -> None:
-    """Export shapes to STEP."""
+    """Export shapes to STEP.
+
+    Args:
+        shapes: 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: Output STEP file path.
+
+    Returns:
+        None: Writes the provided shapes into one STEP file.
+
+    Usage:
+        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.
+
+    Examples:
+        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])
+
+        # Export the full list directly; no need to collapse to body_parts[0].
+        export_step(body_parts, "rounded_bar.step")
+    """
     try:
         shape_list = _normalize_shape_input(shapes)
 
@@ -1654,7 +1678,31 @@ def export_step(shapes: Union[AnyShape, Sequence[AnyShape]], filename: str) -> N
 
 
 def export_stl(shapes: Union[AnyShape, Sequence[AnyShape]], filename: str) -> None:
-    """Export shapes to STL."""
+    """Export shapes to STL.
+
+    Args:
+        shapes: 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: Output STL file path.
+
+    Returns:
+        None: Writes the provided shapes into one STL file.
+
+    Usage:
+        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.
+
+    Examples:
+        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])
+
+        # Export the list result directly.
+        export_stl(body_parts, "rounded_bar.stl")
+    """
     try:
         shape_list = _normalize_shape_input(shapes)
 

{simplecadapi-2.0.6 → simplecadapi-2.0.7}/uv.lock

@@ -3546,7 +3546,7 @@ wheels = [
 
 [[package]]
 name = "simplecadapi"
-version = "2.0.6"
+version = "2.0.7"
 source = { editable = "." }
 dependencies = [
     { name = "cadquery" },

simplecadapi-2.0.6/docs/api/export_step.md

@@ -1,13 +0,0 @@
-# export_step
-
-## API Definition
-
-```python
-def export_step(shapes: Union[AnyShape, Sequence[AnyShape]], filename: str) -> None
-```
-
-*Source: operations.py*
-
-## Description
-
-Export shapes to STEP.

simplecadapi-2.0.6/docs/api/export_stl.md

@@ -1,13 +0,0 @@
-# export_stl
-
-## API Definition
-
-```python
-def export_stl(shapes: Union[AnyShape, Sequence[AnyShape]], filename: str) -> None
-```
-
-*Source: operations.py*
-
-## Description
-
-Export shapes to STL.

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

@@ -1,13 +0,0 @@
-# export_step
-
-## API Definition
-
-```python
-def export_step(shapes: Union[AnyShape, Sequence[AnyShape]], filename: str) -> None
-```
-
-*Source: operations.py*
-
-## Description
-
-Export shapes to STEP.

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

@@ -1,13 +0,0 @@
-# export_stl
-
-## API Definition
-
-```python
-def export_stl(shapes: Union[AnyShape, Sequence[AnyShape]], filename: str) -> None
-```
-
-*Source: operations.py*
-
-## Description
-
-Export shapes to STL.