Constraints docs [WIP]

cadquery/assembly.py

@@ -278,7 +278,7 @@ def _query(self, q: str) -> Tuple[str, Optional[Shape]]:
         obj = self.objects[name].obj
 
         if isinstance(obj, Workplane) and query.tag:
-            tmp = obj.ctx.tags[query.tag]
+            tmp = obj._getTagged(query.tag)
         elif isinstance(obj, (Workplane, Shape)):
             tmp = Workplane().add(obj)
         else:

cadquery/cq.py

@@ -636,9 +636,10 @@ def last(self) -> "Workplane":
         """
         return self.newObject([self.objects[-1]])
 
-    def end(self) -> "Workplane":
+    def end(self, n: int = 1) -> "Workplane":
         """
-        Return the parent of this CQ element
+        Return the nth parent of this CQ element
+        :param n: number of ancestor to return (default: 1)
         :rtype: a CQ object
         :raises: ValueError if there are no more parents in the chain.
 
@@ -650,10 +651,15 @@ def end(self) -> "Workplane":
 
             CQ(obj).faces("+Z")
         """
-        if self.parent:
-            return self.parent
-        else:
-            raise ValueError("Cannot End the chain-- no parents!")
+
+        rv = self
+        for _ in range(n):
+            if rv.parent:
+                rv = rv.parent
+            else:
+                raise ValueError("Cannot End the chain-- no parents!")
+
+        return rv
 
     def _findType(self, types, searchStack=True, searchParents=True):
 

doc/apireference.rst

@@ -53,7 +53,6 @@ All 2-d operations require a **Workplane** object to be created.
 	Workplane.sagittaArc
 	Workplane.radiusArc
     Workplane.tangentArcPoint
-	Workplane.rotateAndCopy
 	Workplane.mirrorY
 	Workplane.mirrorX
 	Workplane.wire
@@ -166,8 +165,7 @@ Selectors
 Objects that filter and select CAD objects. Selectors are used to select existing geometry
 as a basis for futher operations.
 
-.. currentmodule:: cadquery
-
+.. currentmodule:: cadquery.selectors
 .. autosummary::
 
         NearestToPointSelector
@@ -186,19 +184,21 @@ as a basis for futher operations.
         SubtractSelector
         InverseSelector
         StringSyntaxSelector
+
+.. _assembly:
 
 Assemblies
 ----------
 
 Workplane and Shape objects can be connected together into assemblies
 
 .. currentmodule:: cadquery
-
 .. autosummary::
 
         Assembly
         Assembly.add
         Assembly.save
         Assembly.constrain
+        Assembly.solve
         Constraint
         Color