diff env/lib/python3.7/site-packages/prov/__init__.py @ 0:26e78fe6e8c4 draft

"planemo upload commit c699937486c35866861690329de38ec1a5d9f783"
author shellac
date Sat, 02 May 2020 07:14:21 -0400
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/env/lib/python3.7/site-packages/prov/__init__.py	Sat May 02 07:14:21 2020 -0400
@@ -0,0 +1,47 @@
+from __future__ import (absolute_import, division, print_function,
+                        unicode_literals)
+
+__author__ = 'Trung Dong Huynh'
+__email__ = 'trungdong@donggiang.com'
+__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.")