This gem provides common configuration services to the various applications that make up NCS Navigator. It's not generally useful outside of that suite.
{NcsNavigator::Configuration} defines the common configuration attributes for applications in the NCS Navigator suite. It also provides helpers (e.g., {NcsNavigator::Configuration#action_mailer_smtp_settings} for applying the configuration to some utility libraries.
{NcsNavigator.configuration} provides a global access point for an
instance of NcsNavigator::Configuration. It can be explicitly set,
but more commonly it is initialized from a configuration file named
/etc/nubic/ncs/navigator.ini (see next section) on first access. If
the INI file is changed, you'll need to set
NcsNavigator.configuration to nil to have the changes reflected in
the global instance.
An instance of {NcsNavigator::Configuration} may be initialized from an INI file or by passing a Hash to its constructor. The INI file should match {file:sample_configuration.ini} available alongside this file. The Hash should have two levels, the top level matching the INI file's sections and the second level the keys.
In addition to the typed configuration properties available on
NcsNavigator::Configuration, there are also three
application-specific accessors:
{NcsNavigator::Configuration#staff_portal #staff_portal},
{NcsNavigator::Configuration#core #core}, and
{NcsNavigator::Configuration#psc #psc}. These provide untyped direct
access to the configuration properties in the respective sections of
the INI file, allowing applications to define their own additional
configuration properties without modifying this library.