1 # The MIT License (MIT)
3 # Copyright (c) 2017 Philippe Proulx <pproulx@efficios.com>
5 # Permission is hereby granted, free of charge, to any person obtaining a copy
6 # of this software and associated documentation files (the "Software"), to deal
7 # in the Software without restriction, including without limitation the rights
8 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 # copies of the Software, and to permit persons to whom the Software is
10 # furnished to do so, subject to the following conditions:
12 # The above copyright notice and this permission notice shall be included in
13 # all copies or substantial portions of the Software.
15 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
27 def plugin_component_class(component_class
):
28 if not issubclass(component_class
, bt2
.component
._UserComponent
):
29 raise TypeError('component class is not a subclass of a user component class')
31 component_class
._bt
_plugin
_component
_class
= None
32 return component_class
35 def register_plugin(module_name
, name
, description
=None, author
=None,
36 license
=None, version
=None):
39 if module_name
not in sys
.modules
:
40 raise RuntimeError("cannot find module '{}' in loaded modules".format(module_name
))
42 utils
._check
_str
(name
)
44 if description
is not None:
45 utils
._check
_str
(description
)
47 if author
is not None:
48 utils
._check
_str
(author
)
50 if license
is not None:
51 utils
._check
_str
(license
)
53 if version
is not None:
54 if not _validate_version(version
):
55 raise ValueError('wrong version: expecting a tuple: (major, minor, patch) or (major, minor, patch, extra)')
57 sys
.modules
[module_name
]._bt
_plugin
_info
= _PluginInfo(name
, description
,
62 def _validate_version(version
):
66 if not isinstance(version
, tuple):
69 if len(version
) < 3 or len(version
) > 4:
72 if not isinstance(version
[0], int):
75 if not isinstance(version
[1], int):
78 if not isinstance(version
[2], int):
82 if not isinstance(version
[3], str):
89 def __init__(self
, name
, description
, author
, license
, version
):
91 self
.description
= description
93 self
.license
= license
94 self
.version
= version
95 self
.comp_class_addrs
= None
98 # called by the BT plugin system
99 def _try_load_plugin_module(path
):
100 import importlib
.machinery
105 raise TypeError('missing path')
107 # In order to load the module uniquely from its path, even from
108 # different files which have the same basename, we hash the path
109 # and prefix with `bt_plugin_`. This is its key in sys.modules.
111 h
.update(path
.encode())
112 module_name
= 'bt_plugin_{}'.format(h
.hexdigest())
114 # try loading the module: any raised exception is catched by the caller
115 mod
= importlib
.machinery
.SourceFileLoader(module_name
, path
).load_module()
117 # we have the module: look for its plugin info first
118 if not hasattr(mod
, '_bt_plugin_info'):
119 raise RuntimeError("missing '_bt_plugin_info' module attribute")
121 plugin_info
= mod
._bt
_plugin
_info
123 # search for user component classes
124 def is_user_comp_class(obj
):
125 if not inspect
.isclass(obj
):
128 if not hasattr(obj
, '_bt_plugin_component_class'):
133 comp_class_entries
= inspect
.getmembers(mod
, is_user_comp_class
)
134 plugin_info
.comp_class_addrs
= [entry
[1].addr
for entry
in comp_class_entries
]
This page took 0.034134 seconds and 4 git commands to generate.