diff env/lib/python3.9/site-packages/prov/__init__.py @ 0:4f3585e2f14b draft default tip

"planemo upload commit 60cee0fc7c0cda8592644e1aad72851dec82c959"

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/env/lib/python3.9/site-packages/prov/__init__.py	Mon Mar 22 18:12:50 2021 +0000
@@ -0,0 +1,47 @@
+from __future__ import (absolute_import, division, print_function,
+                        unicode_literals)
+
+__author__ = 'Trung Dong Huynh'
+__email__ = '[e-mail]'
+__version__ = '1.5.1'
+
+__all__ = ["Error", "model", "read"]
+
+
+class Error(Exception):
+    """Base class for all errors in this package."""
+    pass
+
+
+def read(source, format=None):
+    """
+    Convenience function returning a ProvDocument instance.
+
+    It does a lazy format detection by simply using try/except for all known
+    formats. The deserializers should fail fairly early when data of the
+    wrong type is passed to them thus the try/except is likely cheap. One
+    could of course also do some more advanced format auto-detection but I am
+    not sure that is necessary.
+
+    The downside is that no proper error messages will be produced, use the
+    format parameter to get the actual traceback.
+    """
+    # Lazy imports to not globber the namespace.
+    from prov.model import ProvDocument
+
+    from prov.serializers import Registry
+    Registry.load_serializers()
+    serializers = Registry.serializers.keys()
+
+    if format:
+        return ProvDocument.deserialize(source=source, format=format.lower())
+
+    for format in serializers:
+        try:
+            return ProvDocument.deserialize(source=source, format=format)
+        except:
+            pass
+    else:
+        raise TypeError("Could not read from the source. To get a proper "
+                        "error message, specify the format with the 'format' "
+                        "parameter.")