libadc-cxx 1.0.0
Structured logging for scientific computing
Loading...
Searching...
No Matches
Public Member Functions | List of all members
adc::none_plugin Class Reference

Message suppression publisher; it quietly ignores all publication requests. More...

Inheritance diagram for adc::none_plugin:
Inheritance graph
[legend]
Collaboration diagram for adc::none_plugin:
Collaboration graph
[legend]

Public Member Functions

 none_plugin ()
 
int publish (std::shared_ptr< builder_api >)
 Publish the content of the builder.
 
int config (const std::map< std::string, std::string > &)
 Configure the plugin with the options given.
 
int config (const std::map< std::string, std::string > &, std::string_view)
 Configure the plugin with the options given and the corresponding environment variables.
 
const std::map< const std::string, const std::string > & get_option_defaults ()
 Look up the settable options and their defaults.
 
int initialize ()
 Ready the plugin to publish following the configuration options set or defaulted.
 
void finalize ()
 Stop publishing and release any resources held for managing publication.
 
void pause ()
 Pause publishing until a call to resume. Duplicate calls are allowed.
 
void resume ()
 Resume publishing Duplicate calls are allowed.
 
std::string_view name () const
 
std::string_view version () const
 
 ~none_plugin ()
 

Detailed Description

Message suppression publisher; it quietly ignores all publication requests.

Definition at line 10 of file none.ipp.

Constructor & Destructor Documentation

◆ none_plugin()

adc::none_plugin::none_plugin ( )
inline

Definition at line 18 of file none.ipp.

◆ ~none_plugin()

adc::none_plugin::~none_plugin ( )
inline

Definition at line 57 of file none.ipp.

Member Function Documentation

◆ publish()

int adc::none_plugin::publish ( std::shared_ptr< builder_api b)
inlinevirtual

Publish the content of the builder.

Parameters
bconverted to a single json object and published

Implements adc::publisher_api.

Definition at line 20 of file none.ipp.

◆ config() [1/2]

int adc::none_plugin::config ( const std::map< std::string, std::string > &  m)
inlinevirtual

Configure the plugin with the options given.

Parameters
ma map with keys documented in the plugin-specific header.

For plugin QQQ, Environment variables ADC_QQQ_PLUGIN_* will override the source code default for any key not defined in m. Here QQQ is the uppercase version of the plugin name.

Implements adc::publisher_api.

Definition at line 24 of file none.ipp.

◆ config() [2/2]

int adc::none_plugin::config ( const std::map< std::string, std::string > &  m,
std::string_view  env_prefix 
)
inlinevirtual

Configure the plugin with the options given and the corresponding environment variables.

Parameters
ma map with keys documented in the plugin-specific header.
env_prefixis prepended to the expected keys for the plugin and values found with getenv that match are used, overriding elements of m. Typically, env_prefix will be PPP_ADC_QQQ_PLUGIN_ if application PPP wants to override the defaults of plugin QQQ. Here QQQ is the uppercase version of the plugin name.

Implements adc::publisher_api.

Definition at line 28 of file none.ipp.

◆ get_option_defaults()

const std::map< const std::string, const std::string > & adc::none_plugin::get_option_defaults ( )
inlinevirtual

Look up the settable options and their defaults.

Some plugins without options will return an empty map.

Implements adc::publisher_api.

Definition at line 32 of file none.ipp.

◆ initialize()

int adc::none_plugin::initialize ( )
inlinevirtual

Ready the plugin to publish following the configuration options set or defaulted.

Implements adc::publisher_api.

Definition at line 36 of file none.ipp.

◆ finalize()

void adc::none_plugin::finalize ( )
inlinevirtual

Stop publishing and release any resources held for managing publication.

Implements adc::publisher_api.

Definition at line 40 of file none.ipp.

◆ pause()

void adc::none_plugin::pause ( )
inlinevirtual

Pause publishing until a call to resume. Duplicate calls are allowed.

Implements adc::publisher_api.

Definition at line 43 of file none.ipp.

◆ resume()

void adc::none_plugin::resume ( )
inlinevirtual

Resume publishing Duplicate calls are allowed.

Implements adc::publisher_api.

Definition at line 46 of file none.ipp.

◆ name()

std::string_view adc::none_plugin::name ( ) const
inlinevirtual
Returns
the name of the plugin

Implements adc::publisher_api.

Definition at line 49 of file none.ipp.

◆ version()

std::string_view adc::none_plugin::version ( ) const
inlinevirtual
Returns
the version of the plugin (should follow semantic versioning practices)

Implements adc::publisher_api.

Definition at line 53 of file none.ipp.


The documentation for this class was generated from the following file: