diff doc/introduction.rst @ 195:28e6c1413947

Added support for TOML style configuration files
author Franz Glasner <fzglas.hg@dom66.de>
date Fri, 03 May 2019 21:51:09 +0200
parents 0d8dd58afc44
children c6904d02beae
line wrap: on
line diff
--- a/doc/introduction.rst	Fri May 03 20:21:12 2019 +0200
+++ b/doc/introduction.rst	Fri May 03 21:51:09 2019 +0200
@@ -13,6 +13,7 @@
 - :ref:`YAML files <yaml-files>`
 - :ref:`JSON files <json-files>`
 - :ref:`INI files <ini-files>`
+- :ref:`TOML files <toml-files>`
 - :ref:`executable Python scripts <executable-python-scripts>`
 
 
@@ -104,6 +105,23 @@
 tree-ish configuration dictionary.
 
 
+.. _toml-files:
+
+TOML Files
+----------
+
+Read the TOML file with the help of the pure Python `uiri/toml` package.
+
+All TOML features map seamingless to "ConfigMix".
+
+The example TOML style configuration below yields an equivalent
+configuration to the YAML configuration above:
+
+
+.. literalinclude:: ../tests/data/conf10.toml
+   :language: ini
+
+
 .. _executable-python-scripts:
 
 Executable Python Scripts
@@ -169,6 +187,9 @@
   ``.py``
     for Python configuration files
 
+  ``.toml``
+    for TOML configuration file
+
   ``.yml`` or ``.yaml``
     for YAML configuration files