diff options
Diffstat (limited to 'src/buildstream/_pluginfactory/elementfactory.py')
-rw-r--r-- | src/buildstream/_pluginfactory/elementfactory.py | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/src/buildstream/_pluginfactory/elementfactory.py b/src/buildstream/_pluginfactory/elementfactory.py new file mode 100644 index 000000000..8879a4173 --- /dev/null +++ b/src/buildstream/_pluginfactory/elementfactory.py @@ -0,0 +1,58 @@ +# +# Copyright (C) 2016 Codethink Limited +# +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU Lesser General Public +# License as published by the Free Software Foundation; either +# version 2 of the License, or (at your option) any later version. +# +# This library is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public +# License along with this library. If not, see <http://www.gnu.org/licenses/>. +# +# Authors: +# Tristan Van Berkom <tristan.vanberkom@codethink.co.uk> + +from .. import _site +from ..element import Element + +from .pluginfactory import PluginFactory + + +# A ElementFactory creates Element instances +# in the context of a given factory +# +# Args: +# plugin_base (PluginBase): The main PluginBase object to work with +# +class ElementFactory(PluginFactory): + def __init__(self, plugin_base): + + super().__init__( + plugin_base, Element, [_site.element_plugins], "buildstream.plugins.elements", + ) + + # create(): + # + # Create an Element object, the pipeline uses this to create Element + # objects on demand for a given pipeline. + # + # Args: + # context (object): The Context object for processing + # project (object): The project object + # meta (object): The loaded MetaElement + # + # Returns: A newly created Element object of the appropriate kind + # + # Raises: + # PluginError (if the kind lookup failed) + # LoadError (if the element itself took issue with the config) + # + def create(self, context, project, meta): + element_type, default_config = self.lookup(meta.kind) + element = element_type(context, project, meta, default_config) + return element |