From d19eb0763371dce836c825bf37dce2eb49e22e68 Mon Sep 17 00:00:00 2001 From: martinRenou <martin.renou@isae.fr> Date: Mon, 21 Aug 2017 14:30:02 +0100 Subject: [PATCH 1/5] Update the documentation --- doc/source/design.rst | 9 ++++++++- doc/source/introduction.rst | 5 +++-- doc/source/plugin_development.rst | 8 +++----- 3 files changed, 14 insertions(+), 8 deletions(-) diff --git a/doc/source/design.rst b/doc/source/design.rst index 574edbf..475604f 100644 --- a/doc/source/design.rst +++ b/doc/source/design.rst @@ -1,11 +1,12 @@ Design ------ -The application is based on three entities, as written in the introduction: +The application is based on four entities, as written in the introduction: - Multi Criteria Optimizer (MCO) - DataSources - Key Performance Indicator (KPI) Calculators +- Notification Listeners There are a few core assumptions about each of these entities: @@ -18,6 +19,10 @@ There are a few core assumptions about each of these entities: numerical result. This result is passed to the KPI calculators. - The KPI calculators now compute the final KPIs that are then returned to the invoker MCO. +- The Notification Listener listens to the state of the MCO (Started/New step + of the computation/Finished). It can be a remote database which is filled + with the MCO results during the computation (e.g. the GUI `force_wfmanager` + has a notification listener in order to fill the result table). The result can be represented with the following data flow @@ -32,6 +37,8 @@ The result can be represented with the following data flow 5. one or more KPICalculators, which perform final data evaluation on the obtained values, eac producing KPIResult... 6. Whose values are then returned to the MCO via the Communicator. +7. The KPI values are then sent to the notification listeners with the + associated MCO parameters values The resulting pipeline is therefore just two layers (DataSources, then KPICalculators). diff --git a/doc/source/introduction.rst b/doc/source/introduction.rst index 70d16fe..9d676ac 100644 --- a/doc/source/introduction.rst +++ b/doc/source/introduction.rst @@ -11,8 +11,10 @@ functionality. All functionality comes from external plugins, extending the API to provide new entities, specifically: - Multi Criteria Optimizer (MCO) -- DataSources +- DataSources, which can be a simulator or just a database - Key Performance Indicator (KPI) Calculators +- Notification Listeners, like a remote database which retrieve data during the + computation Plugin support requires compliancy to the Force BDSS api for plugins. Extensions are registered via setuptools entry points. @@ -20,4 +22,3 @@ Extensions are registered via setuptools entry points. Execution of the force bdss executable is simple. Invoke with:: force_bdss workflow.json - diff --git a/doc/source/plugin_development.rst b/doc/source/plugin_development.rst index 278856a..3b50823 100644 --- a/doc/source/plugin_development.rst +++ b/doc/source/plugin_development.rst @@ -2,10 +2,10 @@ Plugin Development ------------------ A single Plugin can provide one or more of the pluggable entities -described elsewhere (MCO/KPICalculators/DataSources). Multiple plugins can -be installed to provide a broad range of functionalities. +described elsewhere (MCO/KPICalculators/DataSources/NotificationListeners). +Multiple plugins can be installed to provide a broad range of functionalities. -Plugins must return Factories. Each Factory provides factory methods for +Plugins must return Factories. Each Factory provides factory methods for one of the above pluggable entities and its associated classes. To implement a new plugin, you must @@ -37,5 +37,3 @@ To implement a new plugin, you must reimplementing its initialization defaults methods to return your factory. - add the plugin class in the setup.py entry_point, under the namespace ``force.bdss.extensions`` - - -- GitLab From dfffd3515508d95782e3169ed522767eeebd259a Mon Sep 17 00:00:00 2001 From: martinRenou <martin.renou@isae.fr> Date: Mon, 21 Aug 2017 14:31:15 +0100 Subject: [PATCH 2/5] Fix style --- doc/source/design.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/design.rst b/doc/source/design.rst index 475604f..42edd6c 100644 --- a/doc/source/design.rst +++ b/doc/source/design.rst @@ -21,7 +21,7 @@ There are a few core assumptions about each of these entities: the invoker MCO. - The Notification Listener listens to the state of the MCO (Started/New step of the computation/Finished). It can be a remote database which is filled - with the MCO results during the computation (e.g. the GUI `force_wfmanager` + with the MCO results during the computation (e.g. the GUI ``force_wfmanager`` has a notification listener in order to fill the result table). -- GitLab From 2808205733061c710f79fdc11a4308eb412f42de Mon Sep 17 00:00:00 2001 From: martinRenou <martin.renou@isae.fr> Date: Tue, 22 Aug 2017 10:57:10 +0100 Subject: [PATCH 3/5] make apidoc --- doc/source/api/force_bdss.cli.rst | 8 +-- doc/source/api/force_bdss.cli.tests.rst | 8 +-- doc/source/api/force_bdss.core.rst | 20 ++++---- doc/source/api/force_bdss.core.tests.rst | 16 +++--- ..._bdss.core_plugins.dummy.csv_extractor.rst | 16 +++--- ...core_plugins.dummy.csv_extractor.tests.rst | 12 ++--- ...e_bdss.core_plugins.dummy.dummy_dakota.rst | 24 ++++----- ....core_plugins.dummy.dummy_dakota.tests.rst | 16 +++--- ...s.core_plugins.dummy.dummy_data_source.rst | 16 +++--- ..._plugins.dummy.dummy_data_source.tests.rst | 12 ++--- ...ore_plugins.dummy.dummy_kpi_calculator.rst | 16 +++--- ...ugins.dummy.dummy_kpi_calculator.tests.rst | 12 ++--- ...gins.dummy.dummy_notification_listener.rst | 45 ++++++++++++++++ ...ummy.dummy_notification_listener.tests.rst | 38 ++++++++++++++ ...orce_bdss.core_plugins.dummy.kpi_adder.rst | 16 +++--- ...dss.core_plugins.dummy.kpi_adder.tests.rst | 12 ++--- .../api/force_bdss.core_plugins.dummy.rst | 9 ++-- .../force_bdss.core_plugins.dummy.tests.rst | 16 +++--- doc/source/api/force_bdss.core_plugins.rst | 4 +- doc/source/api/force_bdss.data_sources.rst | 20 ++++---- .../api/force_bdss.data_sources.tests.rst | 16 +++--- doc/source/api/force_bdss.io.rst | 12 ++--- doc/source/api/force_bdss.io.tests.rst | 12 ++--- doc/source/api/force_bdss.kpi.rst | 20 ++++---- doc/source/api/force_bdss.kpi.tests.rst | 16 +++--- doc/source/api/force_bdss.mco.parameters.rst | 12 ++--- .../api/force_bdss.mco.parameters.tests.rst | 12 ++--- doc/source/api/force_bdss.mco.rst | 24 ++++----- doc/source/api/force_bdss.mco.tests.rst | 16 +++--- .../api/force_bdss.notification_listeners.rst | 46 +++++++++++++++++ doc/source/api/force_bdss.rst | 51 +++++++++++-------- doc/source/api/force_bdss.tests.fixtures.rst | 4 +- doc/source/api/force_bdss.tests.rst | 40 ++++++++++----- 33 files changed, 386 insertions(+), 231 deletions(-) create mode 100644 doc/source/api/force_bdss.core_plugins.dummy.dummy_notification_listener.rst create mode 100644 doc/source/api/force_bdss.core_plugins.dummy.dummy_notification_listener.tests.rst create mode 100644 doc/source/api/force_bdss.notification_listeners.rst diff --git a/doc/source/api/force_bdss.cli.rst b/doc/source/api/force_bdss.cli.rst index c96292e..c6f155f 100644 --- a/doc/source/api/force_bdss.cli.rst +++ b/doc/source/api/force_bdss.cli.rst @@ -1,5 +1,5 @@ -force_bdss.cli package -====================== +force\_bdss\.cli package +======================== Subpackages ----------- @@ -11,8 +11,8 @@ Subpackages Submodules ---------- -force_bdss.cli.force_bdss module --------------------------------- +force\_bdss\.cli\.force\_bdss module +------------------------------------ .. automodule:: force_bdss.cli.force_bdss :members: diff --git a/doc/source/api/force_bdss.cli.tests.rst b/doc/source/api/force_bdss.cli.tests.rst index 5fef4d6..207d951 100644 --- a/doc/source/api/force_bdss.cli.tests.rst +++ b/doc/source/api/force_bdss.cli.tests.rst @@ -1,11 +1,11 @@ -force_bdss.cli.tests package -============================ +force\_bdss\.cli\.tests package +=============================== Submodules ---------- -force_bdss.cli.tests.test_execution module ------------------------------------------- +force\_bdss\.cli\.tests\.test\_execution module +----------------------------------------------- .. automodule:: force_bdss.cli.tests.test_execution :members: diff --git a/doc/source/api/force_bdss.core.rst b/doc/source/api/force_bdss.core.rst index 06471ee..84e7753 100644 --- a/doc/source/api/force_bdss.core.rst +++ b/doc/source/api/force_bdss.core.rst @@ -1,5 +1,5 @@ -force_bdss.core package -======================= +force\_bdss\.core package +========================= Subpackages ----------- @@ -11,32 +11,32 @@ Subpackages Submodules ---------- -force_bdss.core.data_value module ---------------------------------- +force\_bdss\.core\.data\_value module +------------------------------------- .. automodule:: force_bdss.core.data_value :members: :undoc-members: :show-inheritance: -force_bdss.core.input_slot_map module -------------------------------------- +force\_bdss\.core\.input\_slot\_map module +------------------------------------------ .. automodule:: force_bdss.core.input_slot_map :members: :undoc-members: :show-inheritance: -force_bdss.core.slot module ---------------------------- +force\_bdss\.core\.slot module +------------------------------ .. automodule:: force_bdss.core.slot :members: :undoc-members: :show-inheritance: -force_bdss.core.workflow module -------------------------------- +force\_bdss\.core\.workflow module +---------------------------------- .. automodule:: force_bdss.core.workflow :members: diff --git a/doc/source/api/force_bdss.core.tests.rst b/doc/source/api/force_bdss.core.tests.rst index 21f5407..046bd59 100644 --- a/doc/source/api/force_bdss.core.tests.rst +++ b/doc/source/api/force_bdss.core.tests.rst @@ -1,27 +1,27 @@ -force_bdss.core.tests package -============================= +force\_bdss\.core\.tests package +================================ Submodules ---------- -force_bdss.core.tests.test_data_value module --------------------------------------------- +force\_bdss\.core\.tests\.test\_data\_value module +-------------------------------------------------- .. automodule:: force_bdss.core.tests.test_data_value :members: :undoc-members: :show-inheritance: -force_bdss.core.tests.test_input_slot_map module ------------------------------------------------- +force\_bdss\.core\.tests\.test\_input\_slot\_map module +------------------------------------------------------- .. automodule:: force_bdss.core.tests.test_input_slot_map :members: :undoc-members: :show-inheritance: -force_bdss.core.tests.test_slot module --------------------------------------- +force\_bdss\.core\.tests\.test\_slot module +------------------------------------------- .. automodule:: force_bdss.core.tests.test_slot :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.rst b/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.rst index e1bfabe..42bd5ae 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.rst @@ -1,5 +1,5 @@ -force_bdss.core_plugins.dummy.csv_extractor package -=================================================== +force\_bdss\.core\_plugins\.dummy\.csv\_extractor package +========================================================= Subpackages ----------- @@ -11,24 +11,24 @@ Subpackages Submodules ---------- -force_bdss.core_plugins.dummy.csv_extractor.csv_extractor_data_source module ----------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.csv\_extractor\.csv\_extractor\_data\_source module +-------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.csv_extractor.csv_extractor_data_source :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.csv_extractor.csv_extractor_factory module ------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.csv\_extractor\.csv\_extractor\_factory module +--------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.csv_extractor.csv_extractor_factory :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.csv_extractor.csv_extractor_model module ----------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.csv\_extractor\.csv\_extractor\_model module +------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.csv_extractor.csv_extractor_model :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.tests.rst index bc15d4c..d1f1dff 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.tests.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.csv_extractor.tests.rst @@ -1,19 +1,19 @@ -force_bdss.core_plugins.dummy.csv_extractor.tests package -========================================================= +force\_bdss\.core\_plugins\.dummy\.csv\_extractor\.tests package +================================================================ Submodules ---------- -force_bdss.core_plugins.dummy.csv_extractor.tests.test_csv_extractor_data_source module ---------------------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.csv\_extractor\.tests\.test\_csv\_extractor\_data\_source module +--------------------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.csv_extractor.tests.test_csv_extractor_data_source :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.csv_extractor.tests.test_csv_extractor_factory module ------------------------------------------------------------------------------------ +force\_bdss\.core\_plugins\.dummy\.csv\_extractor\.tests\.test\_csv\_extractor\_factory module +---------------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.csv_extractor.tests.test_csv_extractor_factory :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.rst index da727e9..6092e64 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.rst @@ -1,5 +1,5 @@ -force_bdss.core_plugins.dummy.dummy_dakota package -================================================== +force\_bdss\.core\_plugins\.dummy\.dummy\_dakota package +======================================================== Subpackages ----------- @@ -11,40 +11,40 @@ Subpackages Submodules ---------- -force_bdss.core_plugins.dummy.dummy_dakota.dakota_communicator module ---------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.dakota\_communicator module +----------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.dakota_communicator :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.dummy_dakota.dakota_factory module ----------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.dakota\_factory module +------------------------------------------------------------------------ .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.dakota_factory :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.dummy_dakota.dakota_model module --------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.dakota\_model module +---------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.dakota_model :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.dummy_dakota.dakota_optimizer module ------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.dakota\_optimizer module +-------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.dakota_optimizer :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.dummy_dakota.parameters module ------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.parameters module +------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.parameters :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.tests.rst index f16cfb6..1982bc3 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.tests.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_dakota.tests.rst @@ -1,27 +1,27 @@ -force_bdss.core_plugins.dummy.dummy_dakota.tests package -======================================================== +force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.tests package +=============================================================== Submodules ---------- -force_bdss.core_plugins.dummy.dummy_dakota.tests.test_dakota_communicator module --------------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.tests\.test\_dakota\_communicator module +------------------------------------------------------------------------------------------ .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.tests.test_dakota_communicator :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.dummy_dakota.tests.test_dakota_factory module ---------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.tests\.test\_dakota\_factory module +------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.tests.test_dakota_factory :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.dummy_dakota.tests.test_dakota_optimizer module ------------------------------------------------------------------------------ +force\_bdss\.core\_plugins\.dummy\.dummy\_dakota\.tests\.test\_dakota\_optimizer module +--------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_dakota.tests.test_dakota_optimizer :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.rst index d0d5add..1f144b3 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.rst @@ -1,5 +1,5 @@ -force_bdss.core_plugins.dummy.dummy_data_source package -======================================================= +force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source package +============================================================== Subpackages ----------- @@ -11,24 +11,24 @@ Subpackages Submodules ---------- -force_bdss.core_plugins.dummy.dummy_data_source.dummy_data_source module ------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source\.dummy\_data\_source module +---------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_data_source.dummy_data_source :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.dummy_data_source.dummy_data_source_factory module --------------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source\.dummy\_data\_source\_factory module +------------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_data_source.dummy_data_source_factory :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.dummy_data_source.dummy_data_source_model module ------------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source\.dummy\_data\_source\_model module +----------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_data_source.dummy_data_source_model :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.tests.rst index ba04010..f41ad61 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.tests.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_data_source.tests.rst @@ -1,19 +1,19 @@ -force_bdss.core_plugins.dummy.dummy_data_source.tests package -============================================================= +force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source\.tests package +===================================================================== Submodules ---------- -force_bdss.core_plugins.dummy.dummy_data_source.tests.test_dummy_data_source module ------------------------------------------------------------------------------------ +force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source\.tests\.test\_dummy\_data\_source module +----------------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_data_source.tests.test_dummy_data_source :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.dummy_data_source.tests.test_dummy_data_source_factory module -------------------------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_data\_source\.tests\.test\_dummy\_data\_source\_factory module +-------------------------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_data_source.tests.test_dummy_data_source_factory :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.rst index c4b53e3..421db22 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.rst @@ -1,5 +1,5 @@ -force_bdss.core_plugins.dummy.dummy_kpi_calculator package -========================================================== +force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator package +================================================================= Subpackages ----------- @@ -11,24 +11,24 @@ Subpackages Submodules ---------- -force_bdss.core_plugins.dummy.dummy_kpi_calculator.dummy_kpi_calculator module ------------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator\.dummy\_kpi\_calculator module +---------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_kpi_calculator.dummy_kpi_calculator :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.dummy_kpi_calculator.dummy_kpi_calculator_factory module --------------------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator\.dummy\_kpi\_calculator\_factory module +------------------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_kpi_calculator.dummy_kpi_calculator_factory :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.dummy_kpi_calculator.dummy_kpi_calculator_model module ------------------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator\.dummy\_kpi\_calculator\_model module +----------------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_kpi_calculator.dummy_kpi_calculator_model :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.rst index 99dbeff..1b91f02 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.rst @@ -1,19 +1,19 @@ -force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests package -================================================================ +force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator\.tests package +======================================================================== Submodules ---------- -force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.test_dummy_kpi_calculator module ------------------------------------------------------------------------------------------ +force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator\.tests\.test\_dummy\_kpi\_calculator module +----------------------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.test_dummy_kpi_calculator :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.test_dummy_kpi_calculator_factory module -------------------------------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_kpi\_calculator\.tests\.test\_dummy\_kpi\_calculator\_factory module +-------------------------------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_kpi_calculator.tests.test_dummy_kpi_calculator_factory :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_notification_listener.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_notification_listener.rst new file mode 100644 index 0000000..ba025cc --- /dev/null +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_notification_listener.rst @@ -0,0 +1,45 @@ +force\_bdss\.core\_plugins\.dummy\.dummy\_notification\_listener package +======================================================================== + +Subpackages +----------- + +.. toctree:: + + force_bdss.core_plugins.dummy.dummy_notification_listener.tests + +Submodules +---------- + +force\_bdss\.core\_plugins\.dummy\.dummy\_notification\_listener\.dummy\_notification\_listener module +------------------------------------------------------------------------------------------------------ + +.. automodule:: force_bdss.core_plugins.dummy.dummy_notification_listener.dummy_notification_listener + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.core\_plugins\.dummy\.dummy\_notification\_listener\.dummy\_notification\_listener\_factory module +--------------------------------------------------------------------------------------------------------------- + +.. automodule:: force_bdss.core_plugins.dummy.dummy_notification_listener.dummy_notification_listener_factory + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.core\_plugins\.dummy\.dummy\_notification\_listener\.dummy\_notification\_listener\_model module +------------------------------------------------------------------------------------------------------------- + +.. automodule:: force_bdss.core_plugins.dummy.dummy_notification_listener.dummy_notification_listener_model + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: force_bdss.core_plugins.dummy.dummy_notification_listener + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.dummy_notification_listener.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.dummy_notification_listener.tests.rst new file mode 100644 index 0000000..6cdd3cf --- /dev/null +++ b/doc/source/api/force_bdss.core_plugins.dummy.dummy_notification_listener.tests.rst @@ -0,0 +1,38 @@ +force\_bdss\.core\_plugins\.dummy\.dummy\_notification\_listener\.tests package +=============================================================================== + +Submodules +---------- + +force\_bdss\.core\_plugins\.dummy\.dummy\_notification\_listener\.tests\.test\_dummy\_notification\_listener module +------------------------------------------------------------------------------------------------------------------- + +.. automodule:: force_bdss.core_plugins.dummy.dummy_notification_listener.tests.test_dummy_notification_listener + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.core\_plugins\.dummy\.dummy\_notification\_listener\.tests\.test\_dummy\_notification\_listener\_factory module +---------------------------------------------------------------------------------------------------------------------------- + +.. automodule:: force_bdss.core_plugins.dummy.dummy_notification_listener.tests.test_dummy_notification_listener_factory + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.core\_plugins\.dummy\.dummy\_notification\_listener\.tests\.test\_dummy\_notification\_listener\_model module +-------------------------------------------------------------------------------------------------------------------------- + +.. automodule:: force_bdss.core_plugins.dummy.dummy_notification_listener.tests.test_dummy_notification_listener_model + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: force_bdss.core_plugins.dummy.dummy_notification_listener.tests + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.rst b/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.rst index 67bf402..6167c3f 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.rst @@ -1,5 +1,5 @@ -force_bdss.core_plugins.dummy.kpi_adder package -=============================================== +force\_bdss\.core\_plugins\.dummy\.kpi\_adder package +===================================================== Subpackages ----------- @@ -11,24 +11,24 @@ Subpackages Submodules ---------- -force_bdss.core_plugins.dummy.kpi_adder.kpi_adder_calculator module -------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.kpi\_adder\.kpi\_adder\_calculator module +---------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.kpi_adder.kpi_adder_calculator :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.kpi_adder.kpi_adder_factory module ----------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.kpi\_adder\.kpi\_adder\_factory module +------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.kpi_adder.kpi_adder_factory :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.kpi_adder.kpi_adder_model module --------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.kpi\_adder\.kpi\_adder\_model module +----------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.kpi_adder.kpi_adder_model :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.tests.rst index bde777c..4412e83 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.tests.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.kpi_adder.tests.rst @@ -1,19 +1,19 @@ -force_bdss.core_plugins.dummy.kpi_adder.tests package -===================================================== +force\_bdss\.core\_plugins\.dummy\.kpi\_adder\.tests package +============================================================ Submodules ---------- -force_bdss.core_plugins.dummy.kpi_adder.tests.test_kpi_adder_calculator module ------------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.kpi\_adder\.tests\.test\_kpi\_adder\_calculator module +----------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.kpi_adder.tests.test_kpi_adder_calculator :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.kpi_adder.tests.test_kpi_adder_factory module ---------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.kpi\_adder\.tests\.test\_kpi\_adder\_factory module +-------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.kpi_adder.tests.test_kpi_adder_factory :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.rst b/doc/source/api/force_bdss.core_plugins.dummy.rst index 6d5b57b..ae1d819 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.rst @@ -1,5 +1,5 @@ -force_bdss.core_plugins.dummy package -===================================== +force\_bdss\.core\_plugins\.dummy package +========================================= Subpackages ----------- @@ -10,14 +10,15 @@ Subpackages force_bdss.core_plugins.dummy.dummy_dakota force_bdss.core_plugins.dummy.dummy_data_source force_bdss.core_plugins.dummy.dummy_kpi_calculator + force_bdss.core_plugins.dummy.dummy_notification_listener force_bdss.core_plugins.dummy.kpi_adder force_bdss.core_plugins.dummy.tests Submodules ---------- -force_bdss.core_plugins.dummy.dummy_plugin module -------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.dummy\_plugin module +------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.dummy_plugin :members: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.tests.rst index 5796f32..41e0d30 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.tests.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.tests.rst @@ -1,27 +1,27 @@ -force_bdss.core_plugins.dummy.tests package -=========================================== +force\_bdss\.core\_plugins\.dummy\.tests package +================================================ Submodules ---------- -force_bdss.core_plugins.dummy.tests.data_source_factory_test_mixin module -------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.tests\.data\_source\_factory\_test\_mixin module +----------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.tests.data_source_factory_test_mixin :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.tests.kpi_calculator_factory_test_mixin module ----------------------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.tests\.kpi\_calculator\_factory\_test\_mixin module +-------------------------------------------------------------------------------------- .. automodule:: force_bdss.core_plugins.dummy.tests.kpi_calculator_factory_test_mixin :members: :undoc-members: :show-inheritance: -force_bdss.core_plugins.dummy.tests.test_direct_execution module ----------------------------------------------------------------- +force\_bdss\.core\_plugins\.dummy\.tests\.test\_direct\_execution module +------------------------------------------------------------------------ .. automodule:: force_bdss.core_plugins.dummy.tests.test_direct_execution :members: diff --git a/doc/source/api/force_bdss.core_plugins.rst b/doc/source/api/force_bdss.core_plugins.rst index aabfada..d667de4 100644 --- a/doc/source/api/force_bdss.core_plugins.rst +++ b/doc/source/api/force_bdss.core_plugins.rst @@ -1,5 +1,5 @@ -force_bdss.core_plugins package -=============================== +force\_bdss\.core\_plugins package +================================== Subpackages ----------- diff --git a/doc/source/api/force_bdss.data_sources.rst b/doc/source/api/force_bdss.data_sources.rst index f984d6d..871f272 100644 --- a/doc/source/api/force_bdss.data_sources.rst +++ b/doc/source/api/force_bdss.data_sources.rst @@ -1,5 +1,5 @@ -force_bdss.data_sources package -=============================== +force\_bdss\.data\_sources package +================================== Subpackages ----------- @@ -11,32 +11,32 @@ Subpackages Submodules ---------- -force_bdss.data_sources.base_data_source module ------------------------------------------------ +force\_bdss\.data\_sources\.base\_data\_source module +----------------------------------------------------- .. automodule:: force_bdss.data_sources.base_data_source :members: :undoc-members: :show-inheritance: -force_bdss.data_sources.base_data_source_factory module -------------------------------------------------------- +force\_bdss\.data\_sources\.base\_data\_source\_factory module +-------------------------------------------------------------- .. automodule:: force_bdss.data_sources.base_data_source_factory :members: :undoc-members: :show-inheritance: -force_bdss.data_sources.base_data_source_model module ------------------------------------------------------ +force\_bdss\.data\_sources\.base\_data\_source\_model module +------------------------------------------------------------ .. automodule:: force_bdss.data_sources.base_data_source_model :members: :undoc-members: :show-inheritance: -force_bdss.data_sources.i_data_source_factory module ----------------------------------------------------- +force\_bdss\.data\_sources\.i\_data\_source\_factory module +----------------------------------------------------------- .. automodule:: force_bdss.data_sources.i_data_source_factory :members: diff --git a/doc/source/api/force_bdss.data_sources.tests.rst b/doc/source/api/force_bdss.data_sources.tests.rst index 16d8fcd..e54155a 100644 --- a/doc/source/api/force_bdss.data_sources.tests.rst +++ b/doc/source/api/force_bdss.data_sources.tests.rst @@ -1,27 +1,27 @@ -force_bdss.data_sources.tests package -===================================== +force\_bdss\.data\_sources\.tests package +========================================= Submodules ---------- -force_bdss.data_sources.tests.test_base_data_source module ----------------------------------------------------------- +force\_bdss\.data\_sources\.tests\.test\_base\_data\_source module +------------------------------------------------------------------ .. automodule:: force_bdss.data_sources.tests.test_base_data_source :members: :undoc-members: :show-inheritance: -force_bdss.data_sources.tests.test_base_data_source_factory module ------------------------------------------------------------------- +force\_bdss\.data\_sources\.tests\.test\_base\_data\_source\_factory module +--------------------------------------------------------------------------- .. automodule:: force_bdss.data_sources.tests.test_base_data_source_factory :members: :undoc-members: :show-inheritance: -force_bdss.data_sources.tests.test_base_data_source_model module ----------------------------------------------------------------- +force\_bdss\.data\_sources\.tests\.test\_base\_data\_source\_model module +------------------------------------------------------------------------- .. automodule:: force_bdss.data_sources.tests.test_base_data_source_model :members: diff --git a/doc/source/api/force_bdss.io.rst b/doc/source/api/force_bdss.io.rst index c221828..558ecbe 100644 --- a/doc/source/api/force_bdss.io.rst +++ b/doc/source/api/force_bdss.io.rst @@ -1,5 +1,5 @@ -force_bdss.io package -===================== +force\_bdss\.io package +======================= Subpackages ----------- @@ -11,16 +11,16 @@ Subpackages Submodules ---------- -force_bdss.io.workflow_reader module ------------------------------------- +force\_bdss\.io\.workflow\_reader module +---------------------------------------- .. automodule:: force_bdss.io.workflow_reader :members: :undoc-members: :show-inheritance: -force_bdss.io.workflow_writer module ------------------------------------- +force\_bdss\.io\.workflow\_writer module +---------------------------------------- .. automodule:: force_bdss.io.workflow_writer :members: diff --git a/doc/source/api/force_bdss.io.tests.rst b/doc/source/api/force_bdss.io.tests.rst index d7512c8..7a53cce 100644 --- a/doc/source/api/force_bdss.io.tests.rst +++ b/doc/source/api/force_bdss.io.tests.rst @@ -1,19 +1,19 @@ -force_bdss.io.tests package -=========================== +force\_bdss\.io\.tests package +============================== Submodules ---------- -force_bdss.io.tests.test_workflow_reader module ------------------------------------------------ +force\_bdss\.io\.tests\.test\_workflow\_reader module +----------------------------------------------------- .. automodule:: force_bdss.io.tests.test_workflow_reader :members: :undoc-members: :show-inheritance: -force_bdss.io.tests.test_workflow_writer module ------------------------------------------------ +force\_bdss\.io\.tests\.test\_workflow\_writer module +----------------------------------------------------- .. automodule:: force_bdss.io.tests.test_workflow_writer :members: diff --git a/doc/source/api/force_bdss.kpi.rst b/doc/source/api/force_bdss.kpi.rst index 2215a99..a18dcbd 100644 --- a/doc/source/api/force_bdss.kpi.rst +++ b/doc/source/api/force_bdss.kpi.rst @@ -1,5 +1,5 @@ -force_bdss.kpi package -====================== +force\_bdss\.kpi package +======================== Subpackages ----------- @@ -11,32 +11,32 @@ Subpackages Submodules ---------- -force_bdss.kpi.base_kpi_calculator module ------------------------------------------ +force\_bdss\.kpi\.base\_kpi\_calculator module +---------------------------------------------- .. automodule:: force_bdss.kpi.base_kpi_calculator :members: :undoc-members: :show-inheritance: -force_bdss.kpi.base_kpi_calculator_factory module -------------------------------------------------- +force\_bdss\.kpi\.base\_kpi\_calculator\_factory module +------------------------------------------------------- .. automodule:: force_bdss.kpi.base_kpi_calculator_factory :members: :undoc-members: :show-inheritance: -force_bdss.kpi.base_kpi_calculator_model module ------------------------------------------------ +force\_bdss\.kpi\.base\_kpi\_calculator\_model module +----------------------------------------------------- .. automodule:: force_bdss.kpi.base_kpi_calculator_model :members: :undoc-members: :show-inheritance: -force_bdss.kpi.i_kpi_calculator_factory module ----------------------------------------------- +force\_bdss\.kpi\.i\_kpi\_calculator\_factory module +---------------------------------------------------- .. automodule:: force_bdss.kpi.i_kpi_calculator_factory :members: diff --git a/doc/source/api/force_bdss.kpi.tests.rst b/doc/source/api/force_bdss.kpi.tests.rst index 3ab64ce..d45f293 100644 --- a/doc/source/api/force_bdss.kpi.tests.rst +++ b/doc/source/api/force_bdss.kpi.tests.rst @@ -1,27 +1,27 @@ -force_bdss.kpi.tests package -============================ +force\_bdss\.kpi\.tests package +=============================== Submodules ---------- -force_bdss.kpi.tests.test_base_kpi_calculator module ----------------------------------------------------- +force\_bdss\.kpi\.tests\.test\_base\_kpi\_calculator module +----------------------------------------------------------- .. automodule:: force_bdss.kpi.tests.test_base_kpi_calculator :members: :undoc-members: :show-inheritance: -force_bdss.kpi.tests.test_base_kpi_calculator_factory module ------------------------------------------------------------- +force\_bdss\.kpi\.tests\.test\_base\_kpi\_calculator\_factory module +-------------------------------------------------------------------- .. automodule:: force_bdss.kpi.tests.test_base_kpi_calculator_factory :members: :undoc-members: :show-inheritance: -force_bdss.kpi.tests.test_base_kpi_calculator_model module ----------------------------------------------------------- +force\_bdss\.kpi\.tests\.test\_base\_kpi\_calculator\_model module +------------------------------------------------------------------ .. automodule:: force_bdss.kpi.tests.test_base_kpi_calculator_model :members: diff --git a/doc/source/api/force_bdss.mco.parameters.rst b/doc/source/api/force_bdss.mco.parameters.rst index bf6d87c..f01c2f1 100644 --- a/doc/source/api/force_bdss.mco.parameters.rst +++ b/doc/source/api/force_bdss.mco.parameters.rst @@ -1,5 +1,5 @@ -force_bdss.mco.parameters package -================================= +force\_bdss\.mco\.parameters package +==================================== Subpackages ----------- @@ -11,16 +11,16 @@ Subpackages Submodules ---------- -force_bdss.mco.parameters.base_mco_parameter module ---------------------------------------------------- +force\_bdss\.mco\.parameters\.base\_mco\_parameter module +--------------------------------------------------------- .. automodule:: force_bdss.mco.parameters.base_mco_parameter :members: :undoc-members: :show-inheritance: -force_bdss.mco.parameters.base_mco_parameter_factory module ------------------------------------------------------------ +force\_bdss\.mco\.parameters\.base\_mco\_parameter\_factory module +------------------------------------------------------------------ .. automodule:: force_bdss.mco.parameters.base_mco_parameter_factory :members: diff --git a/doc/source/api/force_bdss.mco.parameters.tests.rst b/doc/source/api/force_bdss.mco.parameters.tests.rst index def0b61..fa013a8 100644 --- a/doc/source/api/force_bdss.mco.parameters.tests.rst +++ b/doc/source/api/force_bdss.mco.parameters.tests.rst @@ -1,19 +1,19 @@ -force_bdss.mco.parameters.tests package -======================================= +force\_bdss\.mco\.parameters\.tests package +=========================================== Submodules ---------- -force_bdss.mco.parameters.tests.test_base_mco_parameter module --------------------------------------------------------------- +force\_bdss\.mco\.parameters\.tests\.test\_base\_mco\_parameter module +---------------------------------------------------------------------- .. automodule:: force_bdss.mco.parameters.tests.test_base_mco_parameter :members: :undoc-members: :show-inheritance: -force_bdss.mco.parameters.tests.test_base_mco_parameter_factory module ----------------------------------------------------------------------- +force\_bdss\.mco\.parameters\.tests\.test\_base\_mco\_parameter\_factory module +------------------------------------------------------------------------------- .. automodule:: force_bdss.mco.parameters.tests.test_base_mco_parameter_factory :members: diff --git a/doc/source/api/force_bdss.mco.rst b/doc/source/api/force_bdss.mco.rst index 9e86c87..62b36b0 100644 --- a/doc/source/api/force_bdss.mco.rst +++ b/doc/source/api/force_bdss.mco.rst @@ -1,5 +1,5 @@ -force_bdss.mco package -====================== +force\_bdss\.mco package +======================== Subpackages ----------- @@ -12,40 +12,40 @@ Subpackages Submodules ---------- -force_bdss.mco.base_mco module ------------------------------- +force\_bdss\.mco\.base\_mco module +---------------------------------- .. automodule:: force_bdss.mco.base_mco :members: :undoc-members: :show-inheritance: -force_bdss.mco.base_mco_communicator module -------------------------------------------- +force\_bdss\.mco\.base\_mco\_communicator module +------------------------------------------------ .. automodule:: force_bdss.mco.base_mco_communicator :members: :undoc-members: :show-inheritance: -force_bdss.mco.base_mco_factory module --------------------------------------- +force\_bdss\.mco\.base\_mco\_factory module +------------------------------------------- .. automodule:: force_bdss.mco.base_mco_factory :members: :undoc-members: :show-inheritance: -force_bdss.mco.base_mco_model module ------------------------------------- +force\_bdss\.mco\.base\_mco\_model module +----------------------------------------- .. automodule:: force_bdss.mco.base_mco_model :members: :undoc-members: :show-inheritance: -force_bdss.mco.i_mco_factory module ------------------------------------ +force\_bdss\.mco\.i\_mco\_factory module +---------------------------------------- .. automodule:: force_bdss.mco.i_mco_factory :members: diff --git a/doc/source/api/force_bdss.mco.tests.rst b/doc/source/api/force_bdss.mco.tests.rst index f1af86e..e20c2d0 100644 --- a/doc/source/api/force_bdss.mco.tests.rst +++ b/doc/source/api/force_bdss.mco.tests.rst @@ -1,27 +1,27 @@ -force_bdss.mco.tests package -============================ +force\_bdss\.mco\.tests package +=============================== Submodules ---------- -force_bdss.mco.tests.test_base_mco module ------------------------------------------ +force\_bdss\.mco\.tests\.test\_base\_mco module +----------------------------------------------- .. automodule:: force_bdss.mco.tests.test_base_mco :members: :undoc-members: :show-inheritance: -force_bdss.mco.tests.test_base_mco_communicator module ------------------------------------------------------- +force\_bdss\.mco\.tests\.test\_base\_mco\_communicator module +------------------------------------------------------------- .. automodule:: force_bdss.mco.tests.test_base_mco_communicator :members: :undoc-members: :show-inheritance: -force_bdss.mco.tests.test_base_mco_factory module -------------------------------------------------- +force\_bdss\.mco\.tests\.test\_base\_mco\_factory module +-------------------------------------------------------- .. automodule:: force_bdss.mco.tests.test_base_mco_factory :members: diff --git a/doc/source/api/force_bdss.notification_listeners.rst b/doc/source/api/force_bdss.notification_listeners.rst new file mode 100644 index 0000000..0aae24e --- /dev/null +++ b/doc/source/api/force_bdss.notification_listeners.rst @@ -0,0 +1,46 @@ +force\_bdss\.notification\_listeners package +============================================ + +Submodules +---------- + +force\_bdss\.notification\_listeners\.base\_notification\_listener module +------------------------------------------------------------------------- + +.. automodule:: force_bdss.notification_listeners.base_notification_listener + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.notification\_listeners\.base\_notification\_listener\_factory module +---------------------------------------------------------------------------------- + +.. automodule:: force_bdss.notification_listeners.base_notification_listener_factory + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.notification\_listeners\.base\_notification\_listener\_model module +-------------------------------------------------------------------------------- + +.. automodule:: force_bdss.notification_listeners.base_notification_listener_model + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.notification\_listeners\.i\_notification\_listener\_factory module +------------------------------------------------------------------------------- + +.. automodule:: force_bdss.notification_listeners.i_notification_listener_factory + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: force_bdss.notification_listeners + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/source/api/force_bdss.rst b/doc/source/api/force_bdss.rst index bbf6b64..96ca6a7 100644 --- a/doc/source/api/force_bdss.rst +++ b/doc/source/api/force_bdss.rst @@ -1,5 +1,5 @@ -force_bdss package -================== +force\_bdss package +=================== Subpackages ----------- @@ -13,85 +13,94 @@ Subpackages force_bdss.io force_bdss.kpi force_bdss.mco + force_bdss.notification_listeners force_bdss.tests Submodules ---------- -force_bdss.api module ---------------------- +force\_bdss\.api module +----------------------- .. automodule:: force_bdss.api :members: :undoc-members: :show-inheritance: -force_bdss.base_core_driver module ----------------------------------- +force\_bdss\.base\_core\_driver module +-------------------------------------- .. automodule:: force_bdss.base_core_driver :members: :undoc-members: :show-inheritance: -force_bdss.base_extension_plugin module ---------------------------------------- +force\_bdss\.base\_extension\_plugin module +------------------------------------------- .. automodule:: force_bdss.base_extension_plugin :members: :undoc-members: :show-inheritance: -force_bdss.bdss_application module ----------------------------------- +force\_bdss\.bdss\_application module +------------------------------------- .. automodule:: force_bdss.bdss_application :members: :undoc-members: :show-inheritance: -force_bdss.core_evaluation_driver module +force\_bdss\.core\_driver\_events module ---------------------------------------- +.. automodule:: force_bdss.core_driver_events + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.core\_evaluation\_driver module +-------------------------------------------- + .. automodule:: force_bdss.core_evaluation_driver :members: :undoc-members: :show-inheritance: -force_bdss.core_mco_driver module ---------------------------------- +force\_bdss\.core\_mco\_driver module +------------------------------------- .. automodule:: force_bdss.core_mco_driver :members: :undoc-members: :show-inheritance: -force_bdss.factory_registry_plugin module ------------------------------------------ +force\_bdss\.factory\_registry\_plugin module +--------------------------------------------- .. automodule:: force_bdss.factory_registry_plugin :members: :undoc-members: :show-inheritance: -force_bdss.ids module ---------------------- +force\_bdss\.ids module +----------------------- .. automodule:: force_bdss.ids :members: :undoc-members: :show-inheritance: -force_bdss.local_traits module ------------------------------- +force\_bdss\.local\_traits module +--------------------------------- .. automodule:: force_bdss.local_traits :members: :undoc-members: :show-inheritance: -force_bdss.version module -------------------------- +force\_bdss\.version module +--------------------------- .. automodule:: force_bdss.version :members: diff --git a/doc/source/api/force_bdss.tests.fixtures.rst b/doc/source/api/force_bdss.tests.fixtures.rst index 67056f7..3c0c12f 100644 --- a/doc/source/api/force_bdss.tests.fixtures.rst +++ b/doc/source/api/force_bdss.tests.fixtures.rst @@ -1,5 +1,5 @@ -force_bdss.tests.fixtures package -================================= +force\_bdss\.tests\.fixtures package +==================================== Module contents --------------- diff --git a/doc/source/api/force_bdss.tests.rst b/doc/source/api/force_bdss.tests.rst index b843215..6350da6 100644 --- a/doc/source/api/force_bdss.tests.rst +++ b/doc/source/api/force_bdss.tests.rst @@ -1,5 +1,5 @@ -force_bdss.tests package -======================== +force\_bdss\.tests package +========================== Subpackages ----------- @@ -11,46 +11,62 @@ Subpackages Submodules ---------- -force_bdss.tests.test_bdss_application module ---------------------------------------------- +force\_bdss\.tests\.test\_bdss\_application module +-------------------------------------------------- .. automodule:: force_bdss.tests.test_bdss_application :members: :undoc-members: :show-inheritance: -force_bdss.tests.test_core_evaluation_driver module ---------------------------------------------------- +force\_bdss\.tests\.test\_core\_evaluation\_driver module +--------------------------------------------------------- .. automodule:: force_bdss.tests.test_core_evaluation_driver :members: :undoc-members: :show-inheritance: -force_bdss.tests.test_factory_registry_plugin module ----------------------------------------------------- +force\_bdss\.tests\.test\_core\_mco\_driver module +-------------------------------------------------- + +.. automodule:: force_bdss.tests.test_core_mco_driver + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.tests\.test\_factory\_registry\_plugin module +---------------------------------------------------------- .. automodule:: force_bdss.tests.test_factory_registry_plugin :members: :undoc-members: :show-inheritance: -force_bdss.tests.test_ids module --------------------------------- +force\_bdss\.tests\.test\_ids module +------------------------------------ .. automodule:: force_bdss.tests.test_ids :members: :undoc-members: :show-inheritance: -force_bdss.tests.test_local_traits module ------------------------------------------ +force\_bdss\.tests\.test\_local\_traits module +---------------------------------------------- .. automodule:: force_bdss.tests.test_local_traits :members: :undoc-members: :show-inheritance: +force\_bdss\.tests\.utils module +-------------------------------- + +.. automodule:: force_bdss.tests.utils + :members: + :undoc-members: + :show-inheritance: + Module contents --------------- -- GitLab From ec3bf3086e32373a7147d87e1550115a2de3bee5 Mon Sep 17 00:00:00 2001 From: martinRenou <martin.renou@isae.fr> Date: Tue, 22 Aug 2017 17:49:07 +0100 Subject: [PATCH 4/5] Update documentation --- doc/source/design.rst | 7 ++++++- doc/source/introduction.rst | 3 +++ doc/source/plugin_development.rst | 4 ++-- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/doc/source/design.rst b/doc/source/design.rst index 42edd6c..b14ec9c 100644 --- a/doc/source/design.rst +++ b/doc/source/design.rst @@ -1,12 +1,13 @@ Design ------ -The application is based on four entities, as written in the introduction: +The application is based on five entities, as written in the introduction: - Multi Criteria Optimizer (MCO) - DataSources - Key Performance Indicator (KPI) Calculators - Notification Listeners +- UI Hooks There are a few core assumptions about each of these entities: @@ -23,6 +24,10 @@ There are a few core assumptions about each of these entities: of the computation/Finished). It can be a remote database which is filled with the MCO results during the computation (e.g. the GUI ``force_wfmanager`` has a notification listener in order to fill the result table). +- UI Hooks permit to define additional operations which will be executed + at specific moments in the UI lifetime (before and after exectution of the + bdss, before saving the workflow). Those operations won't be executed by the + command line interface of the bdss. The result can be represented with the following data flow diff --git a/doc/source/introduction.rst b/doc/source/introduction.rst index 9d676ac..1af0605 100644 --- a/doc/source/introduction.rst +++ b/doc/source/introduction.rst @@ -15,6 +15,9 @@ API to provide new entities, specifically: - Key Performance Indicator (KPI) Calculators - Notification Listeners, like a remote database which retrieve data during the computation +- UI Hooks, which permit to define additional operations which will be executed + at specific moments in the UI lifetime (before and after exectution of the + bdss, before saving the workflow) Plugin support requires compliancy to the Force BDSS api for plugins. Extensions are registered via setuptools entry points. diff --git a/doc/source/plugin_development.rst b/doc/source/plugin_development.rst index 3b50823..b8b7332 100644 --- a/doc/source/plugin_development.rst +++ b/doc/source/plugin_development.rst @@ -1,8 +1,8 @@ Plugin Development ------------------ -A single Plugin can provide one or more of the pluggable entities -described elsewhere (MCO/KPICalculators/DataSources/NotificationListeners). +A single Plugin can provide one or more of the pluggable entities described +elsewhere (MCO/KPICalculators/DataSources/NotificationListeners/UIHooks). Multiple plugins can be installed to provide a broad range of functionalities. Plugins must return Factories. Each Factory provides factory methods for -- GitLab From 9e51188b4efcf47920444c7fcc5ff874a64da895 Mon Sep 17 00:00:00 2001 From: martinRenou <martin.renou@isae.fr> Date: Tue, 22 Aug 2017 17:49:44 +0100 Subject: [PATCH 5/5] Make apidoc --- ...dss.core_plugins.dummy.power_evaluator.rst | 45 +++++++++++++++++++ ...re_plugins.dummy.power_evaluator.tests.rst | 30 +++++++++++++ .../api/force_bdss.core_plugins.dummy.rst | 1 + doc/source/api/force_bdss.rst | 1 + doc/source/api/force_bdss.ui_hooks.rst | 45 +++++++++++++++++++ doc/source/api/force_bdss.ui_hooks.tests.rst | 30 +++++++++++++ 6 files changed, 152 insertions(+) create mode 100644 doc/source/api/force_bdss.core_plugins.dummy.power_evaluator.rst create mode 100644 doc/source/api/force_bdss.core_plugins.dummy.power_evaluator.tests.rst create mode 100644 doc/source/api/force_bdss.ui_hooks.rst create mode 100644 doc/source/api/force_bdss.ui_hooks.tests.rst diff --git a/doc/source/api/force_bdss.core_plugins.dummy.power_evaluator.rst b/doc/source/api/force_bdss.core_plugins.dummy.power_evaluator.rst new file mode 100644 index 0000000..6313c00 --- /dev/null +++ b/doc/source/api/force_bdss.core_plugins.dummy.power_evaluator.rst @@ -0,0 +1,45 @@ +force\_bdss\.core\_plugins\.dummy\.power\_evaluator package +=========================================================== + +Subpackages +----------- + +.. toctree:: + + force_bdss.core_plugins.dummy.power_evaluator.tests + +Submodules +---------- + +force\_bdss\.core\_plugins\.dummy\.power\_evaluator\.power\_evaluator\_data\_source module +------------------------------------------------------------------------------------------ + +.. automodule:: force_bdss.core_plugins.dummy.power_evaluator.power_evaluator_data_source + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.core\_plugins\.dummy\.power\_evaluator\.power\_evaluator\_factory module +------------------------------------------------------------------------------------- + +.. automodule:: force_bdss.core_plugins.dummy.power_evaluator.power_evaluator_factory + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.core\_plugins\.dummy\.power\_evaluator\.power\_evaluator\_model module +----------------------------------------------------------------------------------- + +.. automodule:: force_bdss.core_plugins.dummy.power_evaluator.power_evaluator_model + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: force_bdss.core_plugins.dummy.power_evaluator + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.power_evaluator.tests.rst b/doc/source/api/force_bdss.core_plugins.dummy.power_evaluator.tests.rst new file mode 100644 index 0000000..51a90e8 --- /dev/null +++ b/doc/source/api/force_bdss.core_plugins.dummy.power_evaluator.tests.rst @@ -0,0 +1,30 @@ +force\_bdss\.core\_plugins\.dummy\.power\_evaluator\.tests package +================================================================== + +Submodules +---------- + +force\_bdss\.core\_plugins\.dummy\.power\_evaluator\.tests\.test\_power\_evaluator\_data\_source module +------------------------------------------------------------------------------------------------------- + +.. automodule:: force_bdss.core_plugins.dummy.power_evaluator.tests.test_power_evaluator_data_source + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.core\_plugins\.dummy\.power\_evaluator\.tests\.test\_power\_evaluator\_factory module +-------------------------------------------------------------------------------------------------- + +.. automodule:: force_bdss.core_plugins.dummy.power_evaluator.tests.test_power_evaluator_factory + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: force_bdss.core_plugins.dummy.power_evaluator.tests + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/source/api/force_bdss.core_plugins.dummy.rst b/doc/source/api/force_bdss.core_plugins.dummy.rst index ae1d819..17e91bf 100644 --- a/doc/source/api/force_bdss.core_plugins.dummy.rst +++ b/doc/source/api/force_bdss.core_plugins.dummy.rst @@ -12,6 +12,7 @@ Subpackages force_bdss.core_plugins.dummy.dummy_kpi_calculator force_bdss.core_plugins.dummy.dummy_notification_listener force_bdss.core_plugins.dummy.kpi_adder + force_bdss.core_plugins.dummy.power_evaluator force_bdss.core_plugins.dummy.tests Submodules diff --git a/doc/source/api/force_bdss.rst b/doc/source/api/force_bdss.rst index 96ca6a7..fbf2323 100644 --- a/doc/source/api/force_bdss.rst +++ b/doc/source/api/force_bdss.rst @@ -15,6 +15,7 @@ Subpackages force_bdss.mco force_bdss.notification_listeners force_bdss.tests + force_bdss.ui_hooks Submodules ---------- diff --git a/doc/source/api/force_bdss.ui_hooks.rst b/doc/source/api/force_bdss.ui_hooks.rst new file mode 100644 index 0000000..309a330 --- /dev/null +++ b/doc/source/api/force_bdss.ui_hooks.rst @@ -0,0 +1,45 @@ +force\_bdss\.ui\_hooks package +============================== + +Subpackages +----------- + +.. toctree:: + + force_bdss.ui_hooks.tests + +Submodules +---------- + +force\_bdss\.ui\_hooks\.base\_ui\_hooks\_factory module +------------------------------------------------------- + +.. automodule:: force_bdss.ui_hooks.base_ui_hooks_factory + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.ui\_hooks\.base\_ui\_hooks\_manager module +------------------------------------------------------- + +.. automodule:: force_bdss.ui_hooks.base_ui_hooks_manager + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.ui\_hooks\.i\_ui\_hooks\_factory module +---------------------------------------------------- + +.. automodule:: force_bdss.ui_hooks.i_ui_hooks_factory + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: force_bdss.ui_hooks + :members: + :undoc-members: + :show-inheritance: diff --git a/doc/source/api/force_bdss.ui_hooks.tests.rst b/doc/source/api/force_bdss.ui_hooks.tests.rst new file mode 100644 index 0000000..7842a34 --- /dev/null +++ b/doc/source/api/force_bdss.ui_hooks.tests.rst @@ -0,0 +1,30 @@ +force\_bdss\.ui\_hooks\.tests package +===================================== + +Submodules +---------- + +force\_bdss\.ui\_hooks\.tests\.test\_base\_ui\_hooks\_factory module +-------------------------------------------------------------------- + +.. automodule:: force_bdss.ui_hooks.tests.test_base_ui_hooks_factory + :members: + :undoc-members: + :show-inheritance: + +force\_bdss\.ui\_hooks\.tests\.test\_base\_ui\_hooks\_manager module +-------------------------------------------------------------------- + +.. automodule:: force_bdss.ui_hooks.tests.test_base_ui_hooks_manager + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: force_bdss.ui_hooks.tests + :members: + :undoc-members: + :show-inheritance: -- GitLab