Add doctest and tests for clearcode coordinate helpers

Author: drawliin

clearcode/cdutils.py

@@ -524,8 +524,14 @@ def str2coord(s):
         URL: "cd:/gem/rubygems/-/mocha/1.7.0"
         URN: "urn:gem:rubygems:-:mocha:revision:1.7.0:tool:scancode:3.1.0"
         plain: /gem/rubygems/foo/mocha/1.7.0"
+
+    >>> str2coord("cd:/gem/rubygems/-/mocha/1.7.0")
+    {'type': 'gem', 'provider': 'rubygems', 'namespace': '-', 'name': 'mocha', 'revision': '1.7.0'}
+    >>> str2coord("urn:gem:rubygems:-:mocha:revision:1.7.0:tool:scancode:3.1.0")
+    {'type': 'gem', 'provider': 'rubygems', 'namespace': '-', 'name': 'mocha', 'revision': '1.7.0'}
+    >>> str2coord("/gem/rubygems/foo/mocha/1.7.0")
+    {'type': 'gem', 'provider': 'rubygems', 'namespace': 'foo', 'name': 'mocha', 'revision': '1.7.0'}
     """
-    # TODO: Add doctest
     is_urn = s.startswith("urn")
     is_url = s.startswith("cd:")
     splitter = ":" if is_urn else "/"

clearcode/tests/test_cdutils.py

@@ -0,0 +1,37 @@
+#
+# Copyright (c) nexB Inc. and others. All rights reserved.
+#
+from clearcode.cdutils import coord2str
+from clearcode.cdutils import str2coord
+
+
+def test_str2coord_from_cd_url():
+    assert str2coord("cd:/gem/rubygems/-/mocha/1.7.0") == {
+        "type": "gem",
+        "provider": "rubygems",
+        "namespace": "-",
+        "name": "mocha",
+        "revision": "1.7.0",
+    }
+
+
+def test_str2coord_from_urn_ignores_extra_segments():
+    assert str2coord("urn:gem:rubygems:-:mocha:revision:1.7.0:tool:scancode:3.1.0") == {
+        "type": "gem",
+        "provider": "rubygems",
+        "namespace": "-",
+        "name": "mocha",
+        "revision": "1.7.0",
+    }
+
+
+def test_coord2str_preserves_missing_namespace_as_dash():
+    assert coord2str(
+        {
+            "type": "git",
+            "provider": "github",
+            "namespace": None,
+            "name": "license-expression",
+            "revision": "70277cdfc186466667cb58ec9f9c7281e68a221b",
+        }
+    ) == "git/github/-/license-expression/70277cdfc186466667cb58ec9f9c7281e68a221b"