confusion 0.4.0

Syntax

[A]

[B]
flavour = "strawberry"

[DEFAULT]
flavour = "vanilla"

[A]

[B]
flavour = "strawberry"

[A]
flavour = "strawberry"

[B]
flavour = ${A:flavour}

[caveat]
text = """
    Multiline strings
    are possible but
    indentation of these closing quotes
    is required.
    """

Usage

Let’s use this scrap of CFN for demonstration:

text = """

[DEFAULT]
flavour = "vanilla"
flake = false

[A]
flavour = "strawberry"

[B]
flavour = ${A:flavour}
flake = true

"""

The simplest way to construct a parser is via the from_string class method:

from confusion import Config

conf = Config.from_string(text)

Or, to read a file, just use the from_path method:

conf = Config.from_path("my_config.cfn")

A Config object has all the methods of Python’s standard ConfigParser class. There is one difference; the sections attribute is a property which returns a dictionary:

print(conf.sections)
>>> {'A': <Section: A>, 'B': <Section: B>}

The hierarchical TOML data is available via the object’s tables property:

print(conf.tables)
>>> {'A': {'flavour': 'strawberry', 'flake': False}, 'B': {'flavour': 'strawberry', 'flake': True}}

[DB]
USER = "postgres"

import os

conf = Config.from_path("my_config.cfn")
conf.merge(os.environ)

conf.merge({"window.width": 800, "window.height": 600}, sep=".")

conf = Config.from_path("my_config.cfn").merge(os.environ).configure_logging(table_name="logging")

Utilities

cfn2dot is a command line utility which generates a Grapviz .dot file from a data graph in confusion format:

$ python -m confusion.utils.cfn2dot --help

This utility translates a graph defined in a CFN file to an equivalent .dot

Usage:

    python -m confusion.utils.cfn2dot --label-graph Taxonomy --digraph taxonomy.cfn > taxonomy.dot

    dot -Tsvg taxonomy.dot > taxonomy.svg

       [-h] [--label-graph LABEL_GRAPH] [--label-inherits LABEL_INHERITS] [--cluster] [--digraph] input [input ...]

positional arguments:
  input                 Set input file.

options:
  -h, --help            show this help message and exit
  --label-graph LABEL_GRAPH
                        Set a label for the graph.
  --label-inherits LABEL_INHERITS
                        Set the label for an arc signifying an 'inherits' relationship.
  --cluster             Generate a clustered graph.
  --digraph, --directed
                        Make arcs directional.