Add tests and some documentation.

Author: Amyantis

setup.py

@@ -14,5 +14,6 @@
     },
     install_requires=[
         "mapbox_vector_tile"
-    ]
+    ],
+    test_suite="tests"
 )

tests/__init__.py

@@ -0,0 +1,16 @@
+import os
+from unittest import TestCase
+
+from vt2geojson.tools import vt_bytes_to_geojson
+
+DIRPATH = os.path.dirname(os.path.realpath(__file__))
+SAMPLE_FILEPATH = os.path.join(DIRPATH, "sample_14_8185_5449.pbf")
+
+with open(SAMPLE_FILEPATH, "rb") as f:
+    sample_content = f.read()
+
+
+class TestConversions(TestCase):
+    def test_bytes_to_geojson(self):
+        result = vt_bytes_to_geojson(sample_content, 8185, 5449, 14)
+        assert result['features']

tests/sample_14_8185_5449.pbf

@@ -5,11 +5,25 @@
 from vt2geojson.features import Layer
 
 
-def _is_url(uri):
+def _is_url(uri: str) -> bool:
+    """
+    Checks if the uri is actually an url.
+    :param uri: the string to check.
+    :return: a boolean.
+    """
     return urlparse(uri).scheme != ""
 
 
-def vt_bytes_to_geojson(b_content, x, y, z, layer=None):
+def vt_bytes_to_geojson(b_content: bytes, x: int, y: int, z: int, layer=None) -> dict:
+    """
+    Make a GeoJSON from bytes in the vector tiles format.
+    :param b_content: the bytes to convert.
+    :param x: tile x coordinate.
+    :param y: tile y coordinate.
+    :param z: tile z coordinate.
+    :param layer: include only the specified layer.
+    :return: a features collection (GeoJSON).
+    """
     data = decode(b_content)
     features_collections = [Layer(x=x, y=y, z=z, name=name, obj=layer_obj).toGeoJSON()
                             for name, layer_obj in data.items() if layer is None or name == layer]