Added geocaching style point formatting + test

Author: tomasbedrich

pycaching/geo.py

@@ -7,6 +7,7 @@
 import itertools
 import geopy
 import geopy.distance
+import geopy.format
 from statistics import mean
 from collections import namedtuple
 from pycaching.errors import ValueError as PycachingValueError, GeocodeError, BadBlockError, Error
@@ -137,6 +138,20 @@ def to_tile(self, geocaching, zoom):
     def __format__(self, format_spec):
         return "{:{}}".format(str(self), format_spec)
 
+    def format_gc(self):
+        """Return a location of this point in a typical Geocaching format.
+
+        :return str: Human-readable location.
+        """
+        hemisphere_lat = self.latitude >= 0 and "N" or "S"
+        hemisphere_lon = self.longitude >= 0 and "E" or "W"
+
+        fmt = "%(degrees)d%(deg)s %(minutes).3f"
+        lat = geopy.format.format_degrees(abs(self.latitude), fmt, geopy.format.UNICODE_SYMBOLS)
+        lon = geopy.format.format_degrees(abs(self.longitude), fmt, geopy.format.UNICODE_SYMBOLS)
+
+        return "{} {}, {} {}".format(hemisphere_lat, lat, hemisphere_lon, lon)
+
 
 class Area:
     """Geometrical area."""

test/test_geo.py

@@ -127,6 +127,11 @@ def test_to_tile(self):
         with self.subTest("increase in longitude: increase in x value"):
             self.assertGreater(Point(49.75, 14.).to_tile(None, 14).x, t.x)
 
+    def test_format_gc(self):
+        """Test Geocaching point formatting."""
+        self.assertEqual(Point(49.73012, 13.40102).format_gc(), "N 49° 43.807, E 13° 24.061")
+        self.assertEqual(Point(-49.73012, -13.40102).format_gc(), "S 49° 43.807, W 13° 24.061")
+
 
 class TestPolygon(unittest.TestCase):