annotate src/tools/common/dynamic_import.py @ 2109:85f3e12e984d

core (memory/cache): file caching handling, first draft: instead of having file caching handled individually by plugins, a generic module has been added in memory. - Cache can be global or associated to a profile. In the later case, client.cache can be used. - Cache are managed with unique ids (which can be any unique unicode, hash uuid, or something else). - To know if a file is in cache, getFilePath is used: if the file is in cache, its absolute path is returned, else None is returned. - To cache a file, cacheData is used with at list the source of cache (most of time plugin import name), and unique id. The method return file opened in binary writing mode (so cacheData can - and should - be used with "with" statement). - 2 files will be created: a metadata file (named after the unique id), and the actual file. - each file has a end of life time, after it, the cache is invalidated and the file must be requested again.
author Goffi <goffi@goffi.org>
date Thu, 05 Jan 2017 20:23:38 +0100
parents c02f96756d5c
children 8b37a62336c3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2088
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
1 #!/usr/bin/env python2
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
2 # -*- coding: utf-8 -*-
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
3
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
4 # SàT: a XMPP
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
5 # Copyright (C) 2009-2016 Jérôme Poisson (goffi@goffi.org)
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
6
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
7 # This program is free software: you can redistribute it and/or modify
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
8 # it under the terms of the GNU Affero General Public License as published by
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
9 # the Free Software Foundation, either version 3 of the License, or
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
10 # (at your option) any later version.
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
11
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
12 # This program is distributed in the hope that it will be useful,
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
15 # GNU Affero General Public License for more details.
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
16
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
17 # You should have received a copy of the GNU Affero General Public License
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
18 # along with this program. If not, see <http://www.gnu.org/licenses/>.
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
19
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
20 """ tools dynamic import """
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
21
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
22 from importlib import import_module
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
23
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
24
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
25 def bridge(name, module_path='sat.bridge'):
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
26 """Import bridge module
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
27
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
28 @param module_path(str): path of the module to import
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
29 @param name(str): name of the bridge to import (e.g.: dbus)
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
30 @return (module, None): imported module or None if nothing is found
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
31 """
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
32 try:
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
33 bridge_module = import_module(module_path + '.' + name)
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
34 except ImportError:
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
35 try:
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
36 bridge_module = import_module(module_path + '.' + name + '_bridge')
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
37 except ImportError:
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
38 bridge_module = None
c02f96756d5c core: bridge can now be changed in conf
Goffi <goffi@goffi.org>
parents:
diff changeset
39 return bridge_module