File tree 1 file changed +10
-0
lines changed
1 file changed +10
-0
lines changed Original file line number Diff line number Diff line change @@ -519,6 +519,11 @@ returned by the call::
519
519
520
520
my.package.customFormatterFactory(bar='baz', spam=99.9, answer=42)
521
521
522
+ .. warning :: The values for keys such as ``bar``, ``spam`` and ``answer`` in
523
+ the above example should not be configuration dictionaries or references such
524
+ as ``cfg://foo `` or ``ext://bar ``, because they will not be processed by the
525
+ configuration machinery, but passed to the callable as-is.
526
+
522
527
The key ``'()' `` has been used as the special key because it is not a
523
528
valid keyword parameter name, and so will not clash with the names of
524
529
the keyword arguments used in the call. The ``'()' `` also serves as a
@@ -543,6 +548,11 @@ following configuration::
543
548
the returned formatter will have attribute ``foo `` set to ``'bar' `` and
544
549
attribute ``baz `` set to ``'bozz' ``.
545
550
551
+ .. warning :: The values for attributes such as ``foo`` and ``baz`` in
552
+ the above example should not be configuration dictionaries or references such
553
+ as ``cfg://foo `` or ``ext://bar ``, because they will not be processed by the
554
+ configuration machinery, but set as attribute values as-is.
555
+
546
556
547
557
.. _logging-config-dict-externalobj :
548
558
You can’t perform that action at this time.
0 commit comments