Components, And All That
========================

.. contents::
   :local:

Overview: Components, Facets, Receptacles
-----------------------------------------

Components are objects that implement functionality. Access to that
funtionality is provided via stubs, so-called *facets*.

A component may use functionality of another component via its
facets. For this, you connect together both components by plugging one
component's facet into a compatible *receptacle* of the using
component.

.. literalinclude:: ../../../Raspi/tests/framework/test_connected_components.py
   :language: python


``Component`` Base Class
------------------------

.. autoclass:: endless.framework.component.Component
   :members:
   :special-members:      

Defining Facets And Receptacles
-------------------------------

.. autoclass:: endless.framework.facet.facet
   :members:
   :special-members:      

.. autoclass:: endless.framework.receptacle.receptacle
   :members:
   :special-members:      

Running Components: Lifetime and Error Management
-------------------------------------------------

.. autoclass:: endless.framework.component.LifetimeComponent
   :members:
   :special-members:      

.. autoclass:: endless.framework.runner.Runner
   :members:
   :special-members:      

.. autoclass:: endless.framework.errorhandler.ErrorHandler
   :members:
   :special-members: