From d4c184169735188b2577d32a61773f7d84e22adb Mon Sep 17 00:00:00 2001 From: Philipp A Date: Tue, 25 Oct 2022 11:59:19 +0200 Subject: [PATCH 1/2] point people to tomllib from configparser --- Doc/library/configparser.rst | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/Doc/library/configparser.rst b/Doc/library/configparser.rst index bf49f2bfbe1b43..e52c5aa7f48fd8 100644 --- a/Doc/library/configparser.rst +++ b/Doc/library/configparser.rst @@ -33,13 +33,17 @@ can be customized by end users easily. .. seealso:: + Module :mod:`tomllib` + TOML is a well-specified format for application configuration files. + It is specifically designed to be an improved version of INI. + Module :mod:`shlex` - Support for creating Unix shell-like mini-languages which can be used as - an alternate format for application configuration files. + Support for creating Unix shell-like mini-languages which can also + be used for this purpose. Module :mod:`json` - The json module implements a subset of JavaScript syntax which can also - be used for this purpose. + The json module implements a subset of JavaScript syntax which is + sometimes used for configuration, but does not support comments. .. testsetup:: From bf64335b3f348fb83b2a9a29127b80cbf4c3efbc Mon Sep 17 00:00:00 2001 From: Philipp A Date: Wed, 26 Oct 2022 12:36:21 +0200 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Jelle Zijlstra --- Doc/library/configparser.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/library/configparser.rst b/Doc/library/configparser.rst index e52c5aa7f48fd8..a925a3dd4fb9c2 100644 --- a/Doc/library/configparser.rst +++ b/Doc/library/configparser.rst @@ -39,10 +39,10 @@ can be customized by end users easily. Module :mod:`shlex` Support for creating Unix shell-like mini-languages which can also - be used for this purpose. + be used for application configuration files. Module :mod:`json` - The json module implements a subset of JavaScript syntax which is + The ``json`` module implements a subset of JavaScript syntax which is sometimes used for configuration, but does not support comments.