Hands-On Software Engineering with Python

YAML files

Another good contender for configuration files is YAML. YAML acts like JSON in many respects, in that it provides structured and typed data representations, and can support complex, nested data structures. In addition, it allows for inline comments, and the pyyaml module supports hinting for data structures that would not be usable at all in a JSON-based approach. YAML, like Python, uses indentation as a structural organization mechanism, indicating (in YAML's case) the key/value relationship between items. An equivalent to the preceding JSON configuration file (with comments, and breaking all elements (objects, list members, and so on) into discrete items in the file), would look  like this:

# Logging configuration logging: console_capture: ...