Added cq.Vector.projectToLine() for projecting a Vector to a line represented by another Vector

Author: A-G-D

cadquery/occ_impl/geom.py

@@ -175,8 +175,18 @@ def getAngle(self, v: "Vector") -> float:
     def distanceToLine(self):
         raise NotImplementedError("Have not needed this yet, but OCCT supports it!")
 
-    def projectToLine(self):
-        raise NotImplementedError("Have not needed this yet, but OCCT supports it!")
+    def projectToLine(self, line: "Vector") -> "Vector":
+        """
+        Returns a new vector equal to the projection of this Vector onto the line
+        represented by Vector <line>
+
+        :param args: Vector
+
+        Returns the projected vector.
+        """
+        lineLength = line.Length
+
+        return line * (self.dot(line) / (lineLength * lineLength))
 
     def distanceToPlane(self):
         raise NotImplementedError("Have not needed this yet, but OCCT supports it!")