Add axis aligned line repr and str

* pygorithm/geometry/axisall.py - add __str__ and __repr__
* pygorithm/geometry/polygon2.py - document _create_links

Author: Tjstretchalot

pygorithm/geometry/axisall.py

@@ -171,4 +171,55 @@ def contains_point(line, point):
         elif point < line.min or point > line.max:
             return False, False
         else:
-            return False, True
+            return False, True
+            
+    def __repr__(self):
+        """
+        Create an unambiguous representation of this axis aligned
+        line.
+        
+        Example:
+        
+        .. code-block:: python
+        
+            from pygorithm.geometry import axisall
+            
+            aal = axisall.AxisAlignedLine(None, 3, 5)
+            
+            # prints AxisAlignedLine(axis=None, min=3, max=5)
+            print(repr(aal))
+        
+        :returns: un-ambiguous representation of this line
+        :rtype: string
+        """
+        
+        return "AxisAlignedLine(axis={}, min={}, max={})".format(repr(self.axis), self.min, self.max)
+    
+    def __str__(self):
+        """
+        Create a human-readable representation of this axis aligned line.
+        
+        Example:
+        
+        .. code-block:: python
+        
+            from pygorithm.geometry import axisall
+            
+            aal = axisall.AxisAlignedLine(None, 0.7071234, 0.7071234)
+            
+            # prints axisall(along None from 0.707 to 0.707)
+            print(aal)
+        
+        :returns: human-readable representation of this line
+        :rtype: string
+        """
+        
+        pretty_min = round(self.min * 1000) / 1000
+        if pretty_min == math.floor(pretty_min):
+            pretty_min = math.floor(pretty_min)
+            
+        pretty_max = round(self.max * 1000) / 1000
+        if pretty_max == math.floor(pretty_max):
+            pretty_max = math.floor(pretty_max)
+        
+        return "axisall(along {} from {} to {})".format(str(axis), pretty_min, pretty_max)

pygorithm/geometry/polygon2.py

@@ -509,6 +509,17 @@ def find_intersection(poly1, poly2, offset1, offset2, find_mtv = True):
 
     @staticmethod
     def _create_link(pts):
+        """
+        Create a webmath link to display the polygon. 
+        
+        This isn't a perfect drawing since it doesn't show connections (so order is
+        invisible). Avoid programatically connecting to the website. This is mostly
+        used because it's very difficult to visualize polygons from lists of points.
+        
+        :param pts: a set of points (order, number, etc. are irrelevant)
+        :type pts: list of :class:`pygorithm.geometry.vector2.Vector2`
+        """
+        
         param0 = "+".join(('%28{}%2C+{}%29'.format(v.x, v.y)) for v in pts)
         xmin = pts[0].x
         xmax = xmin