Added KML downloading for trackables

Merge pull request #70 from FriedrichFroebel/issue-62 (#62)

Author: tomasbedrich

pycaching/trackable.py

@@ -30,6 +30,7 @@ def __init__(self, geocaching, tid, *, name=None, location=None, owner=None,
         if url is not None:
             self.url = url
         self._log_page_url = None
+        self._kml_url = None
 
     def __str__(self):
         """Return trackable ID."""
@@ -152,6 +153,15 @@ def type(self):
     def type(self, type):
         self._type = type.strip()
 
+    def get_KML(self):
+        """The kml route of the trackable.
+
+        :type: :class:`str`
+        """
+        if not self._kml_url:
+            self.load()  # fills self._kml_url
+        return self.geocaching._request(self._kml_url, expect="raw").text
+
     def load(self):
         """Load all possible details about the trackable.
 
@@ -179,6 +189,7 @@ def load(self):
         self.owner = root.find(id="ctl00_ContentBody_BugDetails_BugOwner").text
         self.goal = root.find(id="TrackableGoal").text
         self.description = root.find(id="TrackableDetails").text
+        self._kml_url = root.find(id="ctl00_ContentBody_lnkGoogleKML").get("href")
 
         # another Groundspeak trick... inconsistent relative / absolute URL on one page
         self._log_page_url = "/track/" + root.find(id="ctl00_ContentBody_LogLink")["href"]

test/test_trackable.py

@@ -124,3 +124,11 @@ def test_post_log(self, mock_request, mock_load_log_page):
                 "ctl00$ContentBody$LogBookPanel1$uxLogInfo": test_log_text,
             }
             mock_request.assert_called_with(self.t._log_page_url, method="POST", data=expected_post_data)
+
+    def test_get_KML(self):
+        kml = self.t.get_KML()
+        self.assertTrue("<?xml version=\"1.0\" encoding=\"UTF-8\"?>" in kml)
+        self.assertTrue("<kml xmlns=\"http://earth.google.com/kml/2.2\">" in kml)
+        self.assertTrue("#tbTravelStyle" in kml)
+        self.assertTrue("<visibility>1</visibility>" in kml)
+        self.assertTrue("</Placemark></Document></kml>" in kml)