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 @@ -525,6 +525,11 @@ returned by the call::
525
525
526
526
my.package.customFormatterFactory(bar='baz', spam=99.9, answer=42)
527
527
528
+ .. warning :: The values for keys such as ``bar``, ``spam`` and ``answer`` in
529
+ the above example should not be configuration dictionaries or references such
530
+ as ``cfg://foo `` or ``ext://bar ``, because they will not be processed by the
531
+ configuration machinery, but passed to the callable as-is.
532
+
528
533
The key ``'()' `` has been used as the special key because it is not a
529
534
valid keyword parameter name, and so will not clash with the names of
530
535
the keyword arguments used in the call. The ``'()' `` also serves as a
@@ -553,6 +558,11 @@ following configuration::
553
558
the returned formatter will have attribute ``foo `` set to ``'bar' `` and
554
559
attribute ``baz `` set to ``'bozz' ``.
555
560
561
+ .. warning :: The values for attributes such as ``foo`` and ``baz`` in
562
+ the above example should not be configuration dictionaries or references such
563
+ as ``cfg://foo `` or ``ext://bar ``, because they will not be processed by the
564
+ configuration machinery, but set as attribute values as-is.
565
+
556
566
557
567
.. _logging-config-dict-externalobj :
558
568
You can’t perform that action at this time.
0 commit comments