anyconfig.backend.ini

INI or INI like config files backend.

Changed in version 0.3: Introduce ‘ac_parse_value’ keyword option to switch behaviors, same as original configparser and rich backend parsing each parameter values.

• Format to support: INI or INI like ones
• Requirements: It should be available always.
  • ConfigParser in python 2 standard library: https://docs.python.org/2.7/library/configparser.html
  • configparser in python 3 standard library: https://docs.python.org/3/library/configparser.html
• Limitations: None obvious
• Special options:
  • Use ‘ac_parse_value’ boolean keyword option if you want to parse values by custom parser, anyconfig.backend.ini._parse.

anyconfig.backend.ini._noop(val, *args, **kwargs)

Parser does nothing.

anyconfig.backend.ini._parse(val_s, sep=', ')

FIXME: May be too naive implementation.

Parameters:

• val_s – A string represents some value to parse
• sep – separator between values

>>> _parse(r'"foo string"')
'foo string'
>>> _parse("a, b, c")
['a', 'b', 'c']
>>> _parse("aaa")
'aaa'

anyconfig.backend.ini._to_s(val, sep=', ')

Convert any to string.

Parameters:

• val – An object
• sep – separator between values

>>> _to_s([1, 2, 3])
'1, 2, 3'
>>> _to_s("aaa")
'aaa'

anyconfig.backend.ini._load(stream, sep=', ', **kwargs)

Parameters:

• stream – File or file-like object provides ini-style conf
• sep – Seprator string

Returns:

Dict or dict-like object represents config values

anyconfig.backend.ini._dumps_itr(cnf)

Parameters:cnf – Configuration data to dump :: self.container

anyconfig.backend.ini._dumps(cnf, **kwargs)

Parameters:

• cnf – Configuration data to dump :: self.container
• kwargs – optional keyword parameters to be sanitized :: dict

Returns:

String representation of cnf object in INI format

class anyconfig.backend.ini.Parser

Bases: anyconfig.backend.base.FromStreamLoader, anyconfig.backend.base.ToStringDumper

Ini config files parser.

_type = 'ini'

_extensions = ['ini']

_load_opts = ['defaults', 'dict_type', 'allow_no_value', 'filename', 'ac_parse_value']

load_from_stream(*args, **kwargs)

Parameters:

• stream – File or file-like object provides ini-style conf
• sep – Seprator string

Returns:

Dict or dict-like object represents config values

dump_to_string(*args, **kwargs)

Parameters:

• cnf – Configuration data to dump :: self.container
• kwargs – optional keyword parameters to be sanitized :: dict

Returns:

String representation of cnf object in INI format

__module__ = 'anyconfig.backend.ini'