added combine cut for all 3D ops

added combine cut for twistextrude sweep.
Didn't added it for extrude as it already as cutBlind and the option to extrude until a given face is combine by default and would need a little bit more change to handle combine=cut (but its still possible)

Author: Jojain

cadquery/cq.py

@@ -2951,7 +2951,7 @@ def twistExtrude(
         self: T,
         distance: float,
         angleDegrees: float,
-        combine: bool = True,
+        combine: Union[bool, str] = True,
         clean: bool = True,
     ) -> T:
         """
@@ -2968,7 +2968,7 @@ def twistExtrude(
 
         :param distance: the distance to extrude normal to the workplane
         :param angle: angle (in degrees) to rotate through the extrusion
-        :param boolean combine: True to combine the resulting solid with parent solids if found.
+        :param boolean or string combine: True to combine the resulting solid with parent solids if found, "cut" to remove the resulting solid with the parent solids if found.
         :param boolean clean: call :py:meth:`clean` afterwards to have a clean shape
         :return: a CQ object with the resulting solid selected.
         """
@@ -2993,7 +2993,9 @@ def twistExtrude(
 
         r = Compound.makeCompound(shapes).fuse()
 
-        if combine:
+        if isinstance(combine, str) and combine == "cut":
+            newS = self._cutFromBase(r)
+        elif isinstance(combine, bool) and combine:
             newS = self._combineWithBase(r)
         else:
             newS = self.newObject([r])
@@ -3072,7 +3074,7 @@ def revolve(
         angleDegrees: float = 360.0,
         axisStart: Optional[VectorLike] = None,
         axisEnd: Optional[VectorLike] = None,
-        combine: bool = True,
+        combine: Union[bool, str] = True,
         clean: bool = True,
     ) -> T:
         """
@@ -3146,7 +3148,7 @@ def sweep(
         sweepAlongWires: Optional[bool] = None,
         makeSolid: bool = True,
         isFrenet: bool = False,
-        combine: bool = True,
+        combine: Union[bool, str] = True,
         clean: bool = True,
         transition: Literal["right", "round", "transformed"] = "right",
         normal: Optional[VectorLike] = None,
@@ -3157,7 +3159,7 @@ def sweep(
 
         :param path: A wire along which the pending wires will be swept
         :param boolean multiSection: False to create multiple swept from wires on the chain along path. True to create only one solid swept along path with shape following the list of wires on the chain
-        :param boolean combine: True to combine the resulting solid with parent solids if found.
+        :param boolean or string combine: True to combine the resulting solid with parent solids if found, "cut" to remove the resulting solid with the parent solids if found.
         :param boolean clean: call :py:meth:`clean` afterwards to have a clean shape
         :param transition: handling of profile orientation at C1 path discontinuities. Possible values are {'transformed','round', 'right'} (default: 'right').
         :param normal: optional fixed normal for extrusion
@@ -3187,7 +3189,9 @@ def sweep(
         )  # returns a Solid (or a compound if there were multiple)
 
         newS: T
-        if combine:
+        if isinstance(combine, str) and combine == "cut":
+            newS = self._cutFromBase(r)
+        elif isinstance(combine, bool) and combine:
             newS = self._combineWithBase(r)
         else:
             newS = self.newObject([r])

tests/test_cadquery.py

@@ -1155,6 +1155,17 @@ def testSweep(self):
                 .sweep(path, auxSpine=Workplane().box(1, 1, 1))
             )
 
+        # test sweep with combine="cut"
+        box = Workplane().box(10, 10, 10, centered=False)
+        path = Workplane("YZ").lineTo(10, 10)
+        cut = (
+            box.vertices(">Z and >X and >Y")
+            .workplane(centerOption="CenterOfMass")
+            .circle(1.5)
+            .sweep(path, combine="cut")
+        )
+        self.assertGreater(box.val().Volume(), cut.val().Volume())
+
     def testMultisectionSweep(self):
         """
         Tests the operation of sweeping along a list of wire(s) along a path
@@ -1279,6 +1290,19 @@ def testTwistExtrude(self):
 
         self.assertEqual(6, r.faces().size())
 
+    def testTwistExtrudeCombineCut(self):
+        """
+        Tests extrusion while twisting through an angle, removing the solid from the base solid
+        """
+        box = Workplane().box(10, 10, 10)
+        cut = (
+            box.faces(">Z")
+            .workplane(invert=True)
+            .rect(1.5, 5)
+            .twistExtrude(10, 90, combine="cut")
+        )
+        self.assertGreater(box.val().Volume(), cut.val().Volume())
+
     def testTwistExtrudeCombine(self):
         """
         Tests extrusion while twisting through an angle, combining with other solids.