File: __init__.py

package info (click to toggle)
python-prance 25.4.8.0%2Bds1-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 6,140 kB
  • sloc: python: 3,381; makefile: 205
file content (67 lines) | stat: -rw-r--r-- 1,931 bytes parent folder | download
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
"""This submodule contains utility code for Prance."""

__author__ = "Jens Finkhaeuser"
__copyright__ = "Copyright (c) 2016-2021 Jens Finkhaeuser"
__license__ = "MIT"
__all__ = ("iterators", "fs", "formats", "resolver", "url", "path", "exceptions")


def stringify_keys(data):
    """
    Recursively stringify keys in a dict-like object.

    :param dict-like data: A dict-like object to stringify keys in.
    :return: A new dict-like object of the same type with stringified keys,
        but the same values.
    """
    from collections.abc import Mapping

    assert isinstance(data, Mapping)

    ret = type(data)()
    for key, value in data.items():
        if not isinstance(key, str):
            key = str(key)
        if isinstance(value, Mapping):
            value = stringify_keys(value)
        ret[key] = value
    return ret


def validation_backends():
    """Return a list of validation backends supported by the environment."""
    ret = []

    try:
        import flex  # noqa: F401

        ret.append("flex")  # pragma: nocover
    except (ImportError, SyntaxError):  # pragma: nocover
        pass

    try:
        import openapi_spec_validator  # noqa: F401

        ret.append("openapi-spec-validator")  # pragma: nocover
    except (ImportError, SyntaxError):  # pragma: nocover
        pass

    try:
        import swagger_spec_validator  # noqa: F401

        ret.append("swagger-spec-validator")  # pragma: nocover
    except (ImportError, SyntaxError):  # pragma: nocover
        pass

    return tuple(ret)


def default_validation_backend():
    """Return the default validation backend, or raise an error."""
    backends = validation_backends()
    if len(backends) <= 0:  # pragma: nocover
        raise RuntimeError(
            "No validation backend available! Install one of "
            '"flex", "openapi-spec-validator" or "swagger-spec-validator".'
        )
    return backends[0]