File: exceptions.py

package info (click to toggle)
python-asdf 4.3.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 7,032 kB
  • sloc: python: 24,068; makefile: 123
file content (86 lines) | stat: -rw-r--r-- 2,330 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
from yaml.representer import RepresenterError

from asdf._jsonschema import ValidationError

__all__ = [
    "AsdfConversionWarning",
    "AsdfDeprecationWarning",
    "AsdfLazyReferenceError",
    "AsdfManifestURIMismatchWarning",
    "AsdfPackageVersionWarning",
    "AsdfProvisionalAPIWarning",
    "AsdfSerializationError",
    "AsdfWarning",
    "DelimiterNotFoundError",
    "ValidationError",
]


class AsdfWarning(Warning):
    """
    The base warning class from which all ASDF warnings should inherit.
    """


class AsdfDeprecationWarning(AsdfWarning, DeprecationWarning):
    """
    A warning class to indicate a deprecated feature.
    """


class AsdfConversionWarning(AsdfWarning):
    """
    Warning class used for failures to convert data into custom types.
    """


class AsdfBlockIndexWarning(AsdfWarning):
    """
    Warning class to indicate that a file was read with an invalid block index
    """


class DelimiterNotFoundError(ValueError):
    """
    Indicates that a delimiter was not found when reading or
    seeking through a file.
    """


class AsdfProvisionalAPIWarning(AsdfWarning, FutureWarning):
    """
    Used for provisional features where breaking API changes might be
    introduced at any point (including minor releases). These features
    are likely to be added in a future ASDF version. However, Use of
    provisional features is highly discouraged for production code.
    """


class AsdfPackageVersionWarning(AsdfWarning):
    """
    A warning indicating a package version mismatch
    """


class AsdfManifestURIMismatchWarning(AsdfWarning):
    """
    A warning indicaing that an extension registered with a manifest
    contains a id that does not match the uri of the manifest.
    """


class AsdfLazyReferenceError(ReferenceError):
    """
    Indicates that the lazy tree node failed to resolve a reference
    to an AsdfFile instance. This likely means the AsdfFile was garbage
    collected and you may need to update your code to keep the AsdfFile
    in memory (by keeping a reference).
    """


class AsdfSerializationError(RepresenterError):
    """
    An object failed serialization by asdf and by yaml. This likely indicates
    that the object does not have a supporting asdf Converter and needs to
    be manually converted to a supported type.
    """