ConfigNamespace#

class astropy.config.ConfigNamespace[source]#

Bases: object

A namespace of configuration items. Each subpackage with configuration items should define a subclass of this class, containing ConfigItem instances as members.

For example:

class Conf(_config.ConfigNamespace):
    unicode_output = _config.ConfigItem(
        False,
        'Use Unicode characters when outputting values, ...')
    use_color = _config.ConfigItem(
        sys.platform != 'win32',
        'When True, use ANSI color escape sequences when ...',
        aliases=['astropy.utils.console.USE_COLOR'])
conf = Conf()

Methods Summary

help([name])

Print info about configuration items.

items()

Iterate over configuration item (name, value) pairs.

keys()

Iterate over configuration item names.

reload([attr])

Reload a configuration item from the configuration file.

reset([attr])

Reset a configuration item to its default.

set_temp(attr, value)

Temporarily set a configuration value.

values()

Iterate over configuration item values.

Methods Documentation

help(name=None)[source]#

Print info about configuration items.

Parameters:
namestr, optional

Name of the configuration item to be described. If no name is provided then info about all the configuration items will be printed.

Examples

>>> from astropy import conf
>>> conf.help("unicode_output")
ConfigItem: unicode_output
  cfgtype='boolean'
  defaultvalue=False
  description='When True, use Unicode characters when outputting values, and displaying widgets at the console.'
  module=astropy
  value=False
items()[source]#

Iterate over configuration item (name, value) pairs.

keys()#

Iterate over configuration item names.

reload(attr=None)[source]#

Reload a configuration item from the configuration file.

Parameters:
attrstr, optional

The name of the configuration parameter to reload. If not provided, reload all configuration parameters.

reset(attr=None)[source]#

Reset a configuration item to its default.

Parameters:
attrstr, optional

The name of the configuration parameter to reload. If not provided, reset all configuration parameters.

set_temp(attr, value)[source]#

Temporarily set a configuration value.

Parameters:
attrstr

Configuration item name

valueobject

The value to set temporarily.

Examples

>>> import astropy
>>> with astropy.conf.set_temp('use_color', False):
...     pass
...     # console output will not contain color
>>> # console output contains color again...
values()[source]#

Iterate over configuration item values.