dotmapini 1.0.0

Package allow configuration and section's option values of .ini file to be called as attributes, where the section and option are separated by dot notation.

dotmapini

Package allow configuration and section's option values of .ini file to be called as attributes, where the section and option are separated by dot notation.

The focus is to work with .ini configuration data using dot notation. Just call attributes and get their values in development flow while defining them in single place.

• No more configuration values in config['section']['option'] style, just config.section.option;
• Can parse .ini files with dots between section names and convert them as several sections for corresponding values;
• Parse values and convert them to Python data types;

  # Return parsed value types:
  Union[str, bool, int, None]  # other types not implemented and will be parsed as str
  

• Your config is instance of collections.MutableMapping (dict's like) and have the same features;
• Less keystroke;
• No dependencies, only stdlib.

Installation:

pip install dotmapini

Usage:

Imagine you have following .ini configuration file:

# example.ini
[APP]
debug = False

[server]
host = 127.0.0.1
port = 8080

[server.db]
host = localhost
database = test
user = username
password = password

Minimal reproducible example:

from dotmapini import Config


config = Config.load(path='/your/path/to/example.ini')
print(config.APP.debug)  # => False type bool
print(config.server.host)  # => '127.0.0.1' type str
print(config.server.port)  # => 8080 type int
print(config.server.db.database)  # => 'test' type str
print(config.server.db.username)  # => 'username' type str

Of course as always you can do this:

print(config['server']['db']['host'])  # => 'localhost' type str

But for what...

IMPORTANT:

• Uppercase strings for options will be parsed as lowercase.

  Example:

  [section]
  OPTION = ...
  

  Will be:

  config = Config.load(...)
  config.section.option  # not self.section.OPTION
  

• Float numbers in options always will be parsed as a string.

  Example:

  [section]
  option = 1.5
  

  Will be:

  config = Config.load(...)
  config.section.option: str = '1.5'
  

• Only digits in section's name not allowed.

  Example:

  [section.1.subsection]  ; A digit between dots not allowed as well
  ...
  [2]
  ...
  [3.section]
  ...
  

  Will be:

  config = Config.load(...)  # will raise DigitInSectionNameError
  

• If you have DEFAULT section it will be added to all other sections thus it can override same named option values.

  Example:

  [DEFAULT]
  option = value
  
  [section]
  option = value2
  

  Will be:

  config = Config.load(...)
  config.section.option = value  # not value2
  

Most of this stuff is the default behavior of configparser.ConfigParser.

Need to mention:

Q: Why not dotmap?
A: I want to focus to work specifically with .ini/configparser. There is no need to me to create a lot of dict's like objects.
Q: Why not types.SimpleNamesapce?
A: It can instantiate attributes and nothing else, that is not the case here. Class collections.MutableMapping provide more control/isolation when create complex custom dict's like bjects, which is focus to work with .ini configuration files and modify receiving values.

LICENSE

MIT