cache.py 4.43 KB
Newer Older
1

2 3 4 5
# Slixmpp: The Slick XMPP Library
# Copyright (C) 2018 Emmanuel Gil Peyrot
# This file is part of Slixmpp.
# See the file LICENSE for copying permission.
6 7 8 9 10 11 12 13 14 15 16 17
import os
import logging

log = logging.getLogger(__name__)

class Cache:
    def retrieve(self, key):
        raise NotImplementedError

    def store(self, key, value):
        raise NotImplementedError

18 19 20
    def remove(self, key):
        raise NotImplemented

21 22 23 24 25 26 27
class PerJidCache:
    def retrieve_by_jid(self, jid, key):
        raise NotImplementedError

    def store_by_jid(self, jid, key, value):
        raise NotImplementedError

28 29 30
    def remove_by_jid(self, jid, key):
        raise NotImplementedError

31 32 33 34 35 36 37 38 39 40 41
class MemoryCache(Cache):
    def __init__(self):
        self.cache = {}

    def retrieve(self, key):
        return self.cache.get(key, None)

    def store(self, key, value):
        self.cache[key] = value
        return True

42 43 44 45 46
    def remove(self, key):
        if key in self.cache:
            del self.cache[key]
        return True

47 48 49 50 51
class MemoryPerJidCache(PerJidCache):
    def __init__(self):
        self.cache = {}

    def retrieve_by_jid(self, jid, key):
52
        cache = self.cache.get(jid, None)
53 54 55 56 57
        if cache is None:
            return None
        return cache.get(key, None)

    def store_by_jid(self, jid, key, value):
58
        cache = self.cache.setdefault(jid, {})
59 60 61
        cache[key] = value
        return True

62 63 64 65 66 67
    def remove_by_jid(self, jid, key):
        cache = self.cache.get(jid, None)
        if cache is not None and key in cache:
            del cache[key]
        return True

68 69
class FileSystemStorage:
    def __init__(self, encode, decode, binary):
70 71
        self.encode = encode if encode is not None else lambda x: x
        self.decode = decode if decode is not None else lambda x: x
72 73 74 75 76 77 78 79 80 81 82 83
        self.read = 'rb' if binary else 'r'
        self.write = 'wb' if binary else 'w'

    def _retrieve(self, directory, key):
        filename = os.path.join(directory, key.replace('/', '_'))
        try:
            with open(filename, self.read) as cache_file:
                return self.decode(cache_file.read())
        except FileNotFoundError:
            log.debug('%s not present in cache', key)
        except OSError:
            log.debug('Failed to read %s from cache:', key, exc_info=True)
84 85 86 87
        except Exception:
            log.debug('Failed to decode %s from cache:', key, exc_info=True)
            log.debug('Removing %s entry', key)
            self._remove(directory, key)
88 89 90 91 92 93 94 95 96 97 98

    def _store(self, directory, key, value):
        filename = os.path.join(directory, key.replace('/', '_'))
        try:
            os.makedirs(directory, exist_ok=True)
            with open(filename, self.write) as output:
                output.write(self.encode(value))
                return True
        except OSError:
            log.debug('Failed to store %s to cache:', key, exc_info=True)
            return False
99 100
        except Exception:
            log.debug('Failed to encode %s to cache:', key, exc_info=True)
101

102 103 104 105 106 107 108 109 110
    def _remove(self, directory, key):
        filename = os.path.join(directory, key.replace('/', '_'))
        try:
            os.remove(filename)
        except OSError:
            log.debug('Failed to remove %s from cache:', key, exc_info=True)
            return False
        return True

111
class FileSystemCache(Cache, FileSystemStorage):
112
    def __init__(self, directory, cache_type, *, encode=None, decode=None, binary=False):
113 114 115 116 117 118 119 120 121
        FileSystemStorage.__init__(self, encode, decode, binary)
        self.base_dir = os.path.join(directory, cache_type)

    def retrieve(self, key):
        return self._retrieve(self.base_dir, key)

    def store(self, key, value):
        return self._store(self.base_dir, key, value)

122 123 124
    def remove(self, key):
        return self._remove(self.base_dir, key)

125
class FileSystemPerJidCache(PerJidCache, FileSystemStorage):
126
    def __init__(self, directory, cache_type, *, encode=None, decode=None, binary=False):
127 128 129 130
        FileSystemStorage.__init__(self, encode, decode, binary)
        self.base_dir = os.path.join(directory, cache_type)

    def retrieve_by_jid(self, jid, key):
131
        directory = os.path.join(self.base_dir, jid)
132 133 134
        return self._retrieve(directory, key)

    def store_by_jid(self, jid, key, value):
135
        directory = os.path.join(self.base_dir, jid)
136
        return self._store(directory, key, value)
137 138 139 140

    def remove_by_jid(self, jid, key):
        directory = os.path.join(self.base_dir, jid)
        return self._remove(directory, key)