api: Add function to get an object from a URL

Because the series dependencies are represented as a list of URLs, we
need a way to retrieve objects by their API URL instead of the numeric
ID. This adds a function which is more or less a public wrapper of the
private "_get" method.

Signed-off-by: Adam Hassick <[email protected]>

Author: loudonlune

git_pw/api.py

@@ -232,6 +232,11 @@ def version() -> ty.Tuple[int, int]:
     return (1, 0)
 
 
+def get(url: str, params: ty.Optional[Filters]) -> ty.Dict:
+    """Get a JSON document from the API and return it as a dict."""
+    return _get(url, params, stream=False).json()
+
+
 def download(
     url: str,
     params: ty.Optional[Filters] = None,