summaryrefslogtreecommitdiff
path: root/contrib/python/podman/libs/__init__.py
blob: 7285921d7d273a70c3b57b9a11b676b94239fdc2 (plain)
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
"""Support files for podman API implementation."""
import datetime
import threading
from dateutil.parser import parse as dateutil_parse


__all__ = [
    'cached_property',
    'datetime_parse',
    'datetime_format',
]


class cached_property(object):
    """cached_property() - computed once per instance, cached as attribute.

    Maybe this will make a future version of python.
    """

    def __init__(self, func):
        """Construct context manager."""
        self.func = func
        self.__doc__ = func.__doc__
        self.lock = threading.RLock()

    def __get__(self, instance, cls=None):
        """Retrieve previous value, or call func()."""
        if instance is None:
            return self

        attrname = self.func.__name__
        try:
            cache = instance.__dict__
        except AttributeError:  # objects with __slots__ have no __dict__
            msg = ("No '__dict__' attribute on {}"
                   " instance to cache {} property.").format(
                       repr(type(instance).__name__), repr(attrname))
            raise TypeError(msg) from None

        with self.lock:
            # check if another thread filled cache while we awaited lock
            if attrname not in cache:
                cache[attrname] = self.func(instance)
        return cache[attrname]


def datetime_parse(string):
    """Convert timestamps to datetime.

    tzinfo aware, if provided.
    """
    return dateutil_parse(string.upper(), fuzzy=True)


def datetime_format(dt):
    """Format datetime in consistent style."""
    if isinstance(dt, str):
        return datetime_parse(dt).isoformat()
    elif isinstance(dt, datetime.datetime):
        return dt.isoformat()
    else:
        raise ValueError('Unable to format {}. Type {} not supported.'.format(
            dt, type(dt)))