Method hole

cadquery/cq.py:2935–2977

Makes a hole for each item on the stack. :param diameter: the diameter of the hole :param depth: the depth of the hole :type depth: float > 0 or None to drill thru the entire part. :param clean: call :meth:`clean` afterwards to have a clean shape Th

(
        self: T, diameter: float, depth: Optional[float] = None, clean: bool = True,
    )

    # TODO: almost all code duplicated!
    # but parameter list is different so a simple function pointer won't work
    def hole(
        self: T, diameter: float, depth: Optional[float] = None, clean: bool = True,
    ) -> T:
        """
        Makes a hole for each item on the stack.

        :param diameter: the diameter of the hole
        :param depth: the depth of the hole
        :type depth: float > 0 or None to drill thru the entire part.
        :param clean: call :meth:`clean` afterwards to have a clean shape

        The surface of the hole is at the current workplane.

        One hole is created for each item on the stack.  A very common use case is to use a
        construction rectangle to define the centers of a set of holes, like so::

            s = (
                Workplane()
                .box(2, 4, 0.5)
                .faces(">Z")
                .workplane()
                .rect(1.5, 3.5, forConstruction=True)
                .vertices()
                .hole(0.125, 82)
            )

        This sample creates a plate with a set of holes at the corners.

        **Plugin Note**: this is one example of the power of plugins. CounterSunk holes are quite
        time consuming to create, but are quite easily defined by users.

        see :meth:`cboreHole` and :meth:`cskHole` to make counterbores or countersinks
        """
        if depth is None:
            depth = self.largestDimension()

        boreDir = Vector(0, 0, -1)
        # first make the hole
        h = Solid.makeCylinder(
            diameter / 2.0, depth, Vector(), boreDir
        )  # local coordinates!

        return self.cutEach(lambda loc: h.moved(loc), True, clean)

    # TODO: duplicated code with _extrude and extrude
    def twistExtrude(