Method siblings

cadquery/occ_impl/shapes.py:1758–1799

Iterate over siblings, i.e. shapes within ctx shape that share subshapes of type kind with self.

(
        self, ctx: Shape, kind: Shapes, level: int | Iterable[int] = 1
    )

        )

    def siblings(
        self, ctx: Shape, kind: Shapes, level: int | Iterable[int] = 1
    ) -> Compound:
        """
        Iterate over siblings, i.e. shapes within ctx shape that share subshapes of type kind with self.
        """

        shape_map = TopTools_IndexedDataMapOfShapeListOfShape()
        TopExp.MapShapesAndAncestors_s(
            ctx.wrapped, inverse_shape_LUT[kind], shapetype(self.wrapped), shape_map,
        )
        exclude = TopTools_MapOfShape()

        def _siblings(shapes: Iterable[Shape], level: int) -> set[Shape]:

            rv: set[Shape] = set()

            for s in shapes:
                exclude.Add(s.wrapped)

            for s in shapes:

                rv.update(
                    Shape.cast(el)
                    for child in s._entities(kind)
                    for el in shape_map.FindFromKey(child)
                    if not exclude.Contains(el)
                )

            return rv if level == 1 else _siblings(rv, level - 1)

        # simple query
        if isinstance(level, int):
            rv = _siblings([self], level)
        else:
            # collect all the requested levels
            rv = set()
            for lvl in level:
                exclude.Clear()
                rv |= _siblings([self], lvl)

        return Compound.makeCompound(rv)

    def __add__(self, other: Shape) -> Shape:
        """