simplecadapi 2.0.3__tar.gz → 2.0.5__tar.gz

{simplecadapi-2.0.3 → simplecadapi-2.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplecadapi
-Version: 2.0.3
+Version: 2.0.5
 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 @@ SimpleCADAPI 是一个基于 CADQuery 的命令式 CAD 建模 Python 包，目
 
 ## 包安装（Python 包管理器）
 
-当前包名：`simplecadapi`，版本：`2.0.3`（见 `pyproject.toml`）。
+当前包名：`simplecadapi`，版本：`2.0.5`（见 `pyproject.toml`）。
 
 ### 方式 A：用 pip 从包仓库安装
 
@@ -418,7 +418,7 @@ uv add simplecadapi
 仓库内已有示例构建产物（`dist/`）：
 
 ```bash
-pip install dist/simplecadapi-2.0.3-py3-none-any.whl
+pip install dist/simplecadapi-2.0.5-py3-none-any.whl
 ```
 
 如果你需要重新构建：

{simplecadapi-2.0.3 → simplecadapi-2.0.5}/README.md

@@ -9,7 +9,7 @@ SimpleCADAPI 是一个基于 CADQuery 的命令式 CAD 建模 Python 包，目
 
 ## 包安装（Python 包管理器）
 
-当前包名：`simplecadapi`，版本：`2.0.3`（见 `pyproject.toml`）。
+当前包名：`simplecadapi`，版本：`2.0.5`（见 `pyproject.toml`）。
 
 ### 方式 A：用 pip 从包仓库安装
 
@@ -42,7 +42,7 @@ uv add simplecadapi
 仓库内已有示例构建产物（`dist/`）：
 
 ```bash
-pip install dist/simplecadapi-2.0.3-py3-none-any.whl
+pip install dist/simplecadapi-2.0.5-py3-none-any.whl
 ```
 
 如果你需要重新构建：

{simplecadapi-2.0.3/skills/simplecad-self-evolve/references → simplecadapi-2.0.5}/docs/api/add_part_rassembly.md

@@ -10,4 +10,4 @@ def add_part_rassembly(assembly: Assembly, name: str, solid: Solid, parent: Opti
 
 ## Description
 
-Type-2映射：在装配空间中新增零件并返回新装配对象。
+Type-2 mapping: add a part in assembly space and return a new assembly.

{simplecadapi-2.0.3/skills/simplecad-self-evolve/references → simplecadapi-2.0.5}/docs/api/and_.md

@@ -10,7 +10,7 @@ def and_(*predicates: Predicate) -> Predicate
 
 ## Description
 
-构造 AND 组合谓词。
+Build an AND-composed predicate.
 
 Q.and_(Q.tag("face.top"), Q.tag("role.mounting_surface"))
 
@@ -18,8 +18,8 @@ Q.and_(Q.tag("face.top"), Q.tag("role.mounting_surface"))
 
 ### *predicates
 
-- **Description**: 任意数量谓词。
+- **Description**: Any number of predicates.
 
 ## Returns
 
-Callable[[Any], bool]: 组合谓词。
+Callable[[Any], bool]: Combined predicate.

{simplecadapi-2.0.3/skills/simplecad-self-evolve/references → simplecadapi-2.0.5}/docs/api/bounds_rbbox.md

@@ -10,14 +10,14 @@ def bounds_rbbox(field: ScalarField) -> Tuple[Tuple[float, float, float], Tuple[
 
 ## Description
 
-计算标量场的轴对齐包围盒。
+Compute the axis-aligned bounding box of a scalar field.
 
 ## Parameters
 
 ### field
 
-- **Description**: 标量场。
+- **Description**: Scalar field.
 
 ## Returns
 
-Tuple[min_xyz, max_xyz]: 包围盒。
+Tuple[min_xyz, max_xyz]: Bounding box.

simplecadapi-2.0.5/docs/api/chamfer_rsolid.md

@@ -0,0 +1,13 @@
+# chamfer_rsolid
+
+## API Definition
+
+```python
+def chamfer_rsolid(solid: Solid, edges: List[Edge], distance: float) -> Solid
+```
+
+*Source: operations.py*
+
+## Description
+
+Apply chamfers to selected solid edges.

{simplecadapi-2.0.3 → simplecadapi-2.0.5}/docs/api/clear_constraints_rassembly.md

@@ -10,4 +10,4 @@ def clear_constraints_rassembly(assembly: Assembly) -> Assembly
 
 ## Description
 
-Type-2映射：清空约束并返回新装配对象。
+Type-2 mapping: clear constraints and return a new assembly.

{simplecadapi-2.0.3/skills/simplecad-self-evolve/references → simplecadapi-2.0.5}/docs/api/clone_assembly_rassembly.md

@@ -10,4 +10,4 @@ def clone_assembly_rassembly(assembly: Assembly) -> Assembly
 
 ## Description
 
-Type-2映射：装配对象到装配对象（克隆）。
+Type-2 mapping: clone one assembly object into another.

{simplecadapi-2.0.3/skills/simplecad-self-evolve/references → simplecadapi-2.0.5}/docs/api/constrain_coincident_rassembly.md

@@ -10,4 +10,4 @@ def constrain_coincident_rassembly(assembly: Assembly, reference: PointAnchor, m
 
 ## Description
 
-Type-2映射：添加点重合约束并返回新装配对象。
+Type-2 mapping: add a coincident constraint and return a new assembly.

{simplecadapi-2.0.3/skills/simplecad-self-evolve/references → simplecadapi-2.0.5}/docs/api/constrain_concentric_rassembly.md

@@ -10,4 +10,4 @@ def constrain_concentric_rassembly(assembly: Assembly, reference: AxisAnchor, mo
 
 ## Description
 
-Type-2映射：添加同轴约束并返回新装配对象。
+Type-2 mapping: add a concentric constraint and return a new assembly.

{simplecadapi-2.0.3 → simplecadapi-2.0.5}/docs/api/constrain_distance_rassembly.md

@@ -10,4 +10,4 @@ def constrain_distance_rassembly(assembly: Assembly, reference: PointAnchor, mov
 
 ## Description
 
-Type-2映射：添加点距约束并返回新装配对象。
+Type-2 mapping: add a point-distance constraint and return a new assembly.

{simplecadapi-2.0.3 → simplecadapi-2.0.5}/docs/api/constrain_offset_rassembly.md

@@ -10,4 +10,4 @@ def constrain_offset_rassembly(assembly: Assembly, reference: PointAnchor, movin
 
 ## Description
 
-Type-2映射：添加轴向偏移约束并返回新装配对象。
+Type-2 mapping: add an axial offset constraint and return a new assembly.

simplecadapi-2.0.5/docs/api/cut_rsolidlist.md

@@ -0,0 +1,13 @@
+# cut_rsolidlist
+
+## API Definition
+
+```python
+def cut_rsolidlist(*solids: Union[Solid, Sequence[Solid]]) -> List[Solid]
+```
+
+*Source: operations.py*
+
+## Description
+
+Compute the boolean difference of solids.

{simplecadapi-2.0.3 → simplecadapi-2.0.5}/docs/api/eval_rarray.md

@@ -10,26 +10,26 @@ def eval_rarray(field: ScalarField, xs: np.ndarray, ys: np.ndarray, zs: np.ndarr
 
 ## Description
 
-标量场批量求值。
+Evaluate a scalar field on arrays of points.
 
 ## Parameters
 
 ### field
 
-- **Description**: 标量场。
+- **Description**: Scalar field.
 
 ### xs
 
-- **Description**: X 坐标数组。
+- **Description**: Array of X coordinates.
 
 ### ys
 
-- **Description**: Y 坐标数组。
+- **Description**: Array of Y coordinates.
 
 ### zs
 
-- **Description**: Z 坐标数组。
+- **Description**: Array of Z coordinates.
 
 ## Returns
 
-np.ndarray: 场函数值数组。
+np.ndarray: Array of field values.

{simplecadapi-2.0.3/skills/simplecad-self-evolve/references → simplecadapi-2.0.5}/docs/api/eval_rscalar.md

@@ -10,26 +10,26 @@ def eval_rscalar(field: ScalarField, x: float, y: float, z: float) -> float
 
 ## Description
 
-标量场单点求值。
+Evaluate a scalar field at a single point.
 
 ## Parameters
 
 ### field
 
-- **Description**: 标量场。
+- **Description**: Scalar field.
 
 ### x
 
-- **Description**: X 坐标。
+- **Description**: X coordinate.
 
 ### y
 
-- **Description**: Y 坐标。
+- **Description**: Y coordinate.
 
 ### z
 
-- **Description**: Z 坐标。
+- **Description**: Z coordinate.
 
 ## Returns
 
-float: 场函数值。
+float: Field value.

simplecadapi-2.0.5/docs/api/export_step.md

@@ -0,0 +1,13 @@
+# 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.5/docs/api/export_stl.md

@@ -0,0 +1,13 @@
+# 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.5/docs/api/extrude_rsolid.md

@@ -0,0 +1,13 @@
+# extrude_rsolid
+
+## API Definition
+
+```python
+def extrude_rsolid(profile: Union[Wire, Face], direction: Tuple[float, float, float], distance: float) -> Solid
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a solid by extruding a profile.

simplecadapi-2.0.5/docs/api/fillet_rsolid.md

@@ -0,0 +1,13 @@
+# fillet_rsolid
+
+## API Definition
+
+```python
+def fillet_rsolid(solid: Solid, edges: List[Edge], radius: float) -> Solid
+```
+
+*Source: operations.py*
+
+## Description
+
+Apply fillets to selected solid edges.

{simplecadapi-2.0.3 → simplecadapi-2.0.5}/docs/api/geo.md

@@ -10,7 +10,7 @@ def geo(field: str, default: Any = None) -> KeyFn
 
 ## Description
 
-快捷构造 geo 元数据取值函数。
+Convenience builder for a `geo` metadata getter.
 
 Q.select(items).order_by(Q.geo("height"))
 
@@ -18,12 +18,12 @@ Q.select(items).order_by(Q.geo("height"))
 
 ### field
 
-- **Description**: geo 字段名，如 "type"、"height"。
+- **Description**: `geo` field name, such as `type` or `height`.
 
 ### default
 
-- **Description**: 取值失败时的默认值。
+- **Description**: Default value when lookup fails.
 
 ## Returns
 
-Callable[[Any], Any]: 取值函数。
+Callable[[Any], Any]: Getter function.

simplecadapi-2.0.5/docs/api/helical_sweep_rsolid.md

@@ -0,0 +1,13 @@
+# helical_sweep_rsolid
+
+## API Definition
+
+```python
+def helical_sweep_rsolid(profile: Wire, pitch: float, height: float, radius: float, center: Tuple[float, float, float] = (0, 0, 0), dir: Tuple[float, float, float] = (0, 0, 1)) -> Solid
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a solid by sweeping a profile along a helical path.

{simplecadapi-2.0.3 → simplecadapi-2.0.5}/docs/api/intersect_rscalarfield.md

@@ -10,14 +10,14 @@ def intersect_rscalarfield(*fields: ScalarField) -> ScalarField
 
 ## Description
 
-交集组合标量场。
+Create an intersection scalar field.
 
 ## Parameters
 
 ### *fields
 
-- **Description**: 输入标量场。
+- **Description**: Input scalar fields.
 
 ## Returns
 
-ScalarField: 交集标量场。
+ScalarField: Intersection scalar field.

simplecadapi-2.0.5/docs/api/intersect_rsolidlist.md

@@ -0,0 +1,13 @@
+# intersect_rsolidlist
+
+## API Definition
+
+```python
+def intersect_rsolidlist(*solids: Union[Solid, Sequence[Solid]]) -> List[Solid]
+```
+
+*Source: operations.py*
+
+## Description
+
+Compute the boolean intersection of solids.

simplecadapi-2.0.5/docs/api/linear_pattern_rsolidlist.md

@@ -0,0 +1,13 @@
+# linear_pattern_rsolidlist
+
+## API Definition
+
+```python
+def linear_pattern_rsolidlist(shape: AnyShape, direction: Tuple[float, float, float], count: int, spacing: float) -> List[Solid]
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a linear pattern of solids.

simplecadapi-2.0.5/docs/api/loft_rsolid.md

@@ -0,0 +1,13 @@
+# loft_rsolid
+
+## API Definition
+
+```python
+def loft_rsolid(profiles: List[Wire], ruled: bool = False) -> Solid
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a solid by lofting multiple profiles.

simplecadapi-2.0.5/docs/api/make_angle_arc_redge.md

@@ -0,0 +1,13 @@
+# make_angle_arc_redge
+
+## API Definition
+
+```python
+def make_angle_arc_redge(center: Tuple[float, float, float], radius: float, start_angle: float, end_angle: float, normal: Tuple[float, float, float] = (0, 0, 1)) -> Edge
+```
+
+*Source: operations.py*
+
+## Description
+
+Create an arc edge from a center, radius, and angle range.

simplecadapi-2.0.5/docs/api/make_angle_arc_rwire.md

@@ -0,0 +1,13 @@
+# make_angle_arc_rwire
+
+## API Definition
+
+```python
+def make_angle_arc_rwire(center: Tuple[float, float, float], radius: float, start_angle: float, end_angle: float, normal: Tuple[float, float, float] = (0, 0, 1)) -> Wire
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a wire containing an arc defined by a center, radius, and angle range.

{simplecadapi-2.0.3 → simplecadapi-2.0.5}/docs/api/make_assembly_rassembly.md

@@ -10,4 +10,4 @@ def make_assembly_rassembly(parts: Sequence[Tuple[str, Solid]], name: str = 'ass
 
 ## Description
 
-Type-1映射：从参数描述提升到装配对象。
+Type-1 mapping: lift a parameter description into an assembly object.

{simplecadapi-2.0.3 → simplecadapi-2.0.5}/docs/api/make_box_rscalarfield.md

@@ -10,18 +10,18 @@ def make_box_rscalarfield(center: Tuple[float, float, float], size: Tuple[float,
 
 ## Description
 
-创建轴对齐盒体标量场。
+Create an axis-aligned box scalar field.
 
 ## Parameters
 
 ### center
 
-- **Description**: 盒体中心坐标 (x, y, z)。
+- **Description**: Box center coordinates `(x, y, z)`.
 
 ### size
 
-- **Description**: 尺寸 (sx, sy, sz)。
+- **Description**: Box size `(sx, sy, sz)`.
 
 ## Returns
 
-ScalarField: 盒体标量场。
+ScalarField: Box scalar field.

simplecadapi-2.0.5/docs/api/make_box_rsolid.md

@@ -0,0 +1,13 @@
+# make_box_rsolid
+
+## API Definition
+
+```python
+def make_box_rsolid(width: float, height: float, depth: float, bottom_face_center: Tuple[float, float, float] = (0, 0, 0)) -> Solid
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a box solid.

{simplecadapi-2.0.3/skills/simplecad-self-evolve/references → simplecadapi-2.0.5}/docs/api/make_capsule_rscalarfield.md

@@ -10,22 +10,22 @@ def make_capsule_rscalarfield(p0: Tuple[float, float, float], p1: Tuple[float, f
 
 ## Description
 
-创建胶囊体标量场。
+Create a capsule scalar field.
 
 ## Parameters
 
 ### p0
 
-- **Description**: 端点1坐标。
+- **Description**: First endpoint coordinates.
 
 ### p1
 
-- **Description**: 端点2坐标。
+- **Description**: Second endpoint coordinates.
 
 ### radius
 
-- **Description**: 胶囊半径。
+- **Description**: Capsule radius.
 
 ## Returns
 
-ScalarField: 胶囊体标量场。
+ScalarField: Capsule scalar field.

simplecadapi-2.0.5/docs/api/make_circle_redge.md

@@ -0,0 +1,13 @@
+# make_circle_redge
+
+## API Definition
+
+```python
+def make_circle_redge(center: Tuple[float, float, float], radius: float, normal: Tuple[float, float, float] = (0, 0, 1)) -> Edge
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a circular edge.

simplecadapi-2.0.5/docs/api/make_circle_rface.md

@@ -0,0 +1,13 @@
+# make_circle_rface
+
+## API Definition
+
+```python
+def make_circle_rface(center: Tuple[float, float, float], radius: float, normal: Tuple[float, float, float] = (0, 0, 1)) -> Face
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a circular face.

simplecadapi-2.0.5/docs/api/make_circle_rwire.md

@@ -0,0 +1,13 @@
+# make_circle_rwire
+
+## API Definition
+
+```python
+def make_circle_rwire(center: Tuple[float, float, float], radius: float, normal: Tuple[float, float, float] = (0, 0, 1)) -> Wire
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a circular wire.

simplecadapi-2.0.5/docs/api/make_cone_rsolid.md

@@ -0,0 +1,13 @@
+# make_cone_rsolid
+
+## API Definition
+
+```python
+def make_cone_rsolid(bottom_radius: float, height: float, top_radius: float = 0.0, bottom_face_center: Tuple[float, float, float] = (0, 0, 0), axis: Tuple[float, float, float] = (0, 0, 1)) -> Solid
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a cone or truncated cone solid.

simplecadapi-2.0.5/docs/api/make_cylinder_rsolid.md

@@ -0,0 +1,13 @@
+# make_cylinder_rsolid
+
+## API Definition
+
+```python
+def make_cylinder_rsolid(radius: float, height: float, bottom_face_center: Tuple[float, float, float] = (0, 0, 0), axis: Tuple[float, float, float] = (0, 0, 1)) -> Solid
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a cylinder solid.

{simplecadapi-2.0.3 → simplecadapi-2.0.5}/docs/api/make_ellipsoid_rscalarfield.md

@@ -10,18 +10,18 @@ def make_ellipsoid_rscalarfield(center: Tuple[float, float, float], radii: Tuple
 
 ## Description
 
-创建椭球体标量场。
+Create an ellipsoid scalar field.
 
 ## Parameters
 
 ### center
 
-- **Description**: 椭球中心坐标 (x, y, z)。
+- **Description**: Ellipsoid center coordinates `(x, y, z)`.
 
 ### radii
 
-- **Description**: 半径 (rx, ry, rz)。
+- **Description**: Radii `(rx, ry, rz)`.
 
 ## Returns
 
-ScalarField: 椭球体标量场。
+ScalarField: Ellipsoid scalar field.

simplecadapi-2.0.5/docs/api/make_face_from_wire_rface.md

@@ -0,0 +1,13 @@
+# make_face_from_wire_rface
+
+## API Definition
+
+```python
+def make_face_from_wire_rface(wire: Wire, normal: Tuple[float, float, float] = (0, 0, 1)) -> Face
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a face from a closed wire.

simplecadapi-2.0.5/docs/api/make_field_surface_rsolid.md

@@ -0,0 +1,13 @@
+# make_field_surface_rsolid
+
+## API Definition
+
+```python
+def make_field_surface_rsolid(field, bounds: Optional[Tuple[Tuple[float, float, float], Tuple[float, float, float]]] = None, resolution: Tuple[int, int, int] = (24, 24, 24), iso: float = 0.0, cap_bounds: bool = True) -> Solid
+```
+
+*Source: operations.py*
+
+## Description
+
+Build a closed solid from a scalar field isosurface.

simplecadapi-2.0.5/docs/api/make_helix_redge.md

@@ -0,0 +1,13 @@
+# make_helix_redge
+
+## API Definition
+
+```python
+def make_helix_redge(pitch: float, height: float, radius: float, center: Tuple[float, float, float] = (0, 0, 0), dir: Tuple[float, float, float] = (0, 0, 1)) -> Edge
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a helix edge.

simplecadapi-2.0.5/docs/api/make_helix_rwire.md

@@ -0,0 +1,13 @@
+# make_helix_rwire
+
+## API Definition
+
+```python
+def make_helix_rwire(pitch: float, height: float, radius: float, center: Tuple[float, float, float] = (0, 0, 0), dir: Tuple[float, float, float] = (0, 0, 1)) -> Wire
+```
+
+*Source: operations.py*
+
+## Description
+
+Create a helix wire.