Vii2VSrSSKJr SSKrSSKJr \ /SQr \R"S5r Sr Sr S rS rS r\"\Vs/sHo\4PM sn\Vs/sHo\4PM sn-5r\\S 'S rSSjr"SS\5r\"5r"SS\5rg!\a \rNf=fs snfs snf)aF`PEP 3101`_ introduced the :meth:`str.format` method, and what would later be called "new-style" string formatting. For the sake of explicit correctness, it is probably best to refer to Python's dual string formatting capabilities as *bracket-style* and *percent-style*. There is overlap, but one does not replace the other. * Bracket-style is more pluggable, slower, and uses a method. * Percent-style is simpler, faster, and uses an operator. Bracket-style formatting brought with it a much more powerful toolbox, but it was far from a full one. :meth:`str.format` uses `more powerful syntax`_, but `the tools and idioms`_ for working with that syntax are not well-developed nor well-advertised. ``formatutils`` adds several functions for working with bracket-style format strings: * :class:`DeferredValue`: Defer fetching or calculating a value until format time. * :func:`get_format_args`: Parse the positional and keyword arguments out of a format string. * :func:`tokenize_format_str`: Tokenize a format string into literals and :class:`BaseFormatField` objects. * :func:`construct_format_field_str`: Assists in progammatic construction of format strings. * :func:`infer_positional_format_args`: Converts anonymous references in 2.7+ format strings to explicit positional arguments suitable for usage with Python 2.6. .. _more powerful syntax: https://docs.python.org/2/library/string.html#format-string-syntax .. _the tools and idioms: https://docs.python.org/2/library/string.html#string-formatting .. _PEP 3101: https://www.python.org/dev/peps/pep-3101/ )print_functionN) Formatter) DeferredValueget_format_argstokenize_format_strconstruct_format_field_strinfer_positional_format_argsBaseFormatFieldz({{)|(}})|({[:!.\[}])c^UcgSU-nU(aUSU-- nU(aUSU-- nUS- nU$)z Constructs a format field string from the field name, spec, and conversion character (``fname``, ``fspec``, ``conv``). See Python String Formatting for more info. {!:})fnamefspecconvrets f/home/james-whalen/.local/share/pipx/venvs/semgrep/lib/python3.13/site-packages/boltons/formatutils.pyrrZsE  } +C  sTz  sU{3JC Jc/n[5RU5H<up#pEUcURUS45 M[X4U5nURX&45 M> U$)zDoes very basic splitting of a format string, returns a list of strings. For full tokenization, see :func:`tokenize_format_str`. N)rparseappendr)fstrrlitrrr field_strs rsplit_format_strrks_ C#,;#4#4T#:E = JJT{ # .uTB  C#$ $; Jrc"SupSup4n[RU5HenUR5UR5UR 5ptnXS:aXXS- nUnUS:XdUS:XaX- nMQUSU<USS<3- nUS- nMg XUS- nU$)zTakes format strings with anonymous positional arguments, (e.g., "{}" and {:d}), and converts them into numbered ones for explicitness and compatibility with 2.6. Returns a string with the inferred positional arguments. )r r)rrrz{{z}}r N) _pos_farg_refinditerstartendgroup)rrmax_anonr#r$prev_endmatchr%s rr r {sMC"E&&t,!KKM599; E   ' 'C D=ETM LC  (E!"I..A - ?C JrbcdoxXnzeEfFgGn%sc^ ^^[5n//[5smmm S U UU4SjjnURU5Hup4pVUcM USSn[R"SU5n[ U5S:a[ SU-5eUSn U (deU"XG5 URU5Hup n U cM U"U 5 M M TT4$![[4a [ S5ef=f) a Turn a format string into two lists of arguments referenced by the format string. One is positional arguments, and the other is named arguments. Each element of the list includes the name and the nominal type of the field. # >>> get_format_args("{noun} is {1:d} years old{punct}") # ([(1, )], [('noun', ), ('punct', )]) # XXX: Py3k >>> get_format_args("{noun} is {1:d} years old{punct}") == ([(1, int)], [('noun', str), ('punct', str)]) True c>UT;aITRU5 [RU[5nTR [ U5U45 gg![ a TR X45 gf=fN)add _TYPE_MAPgetstrrint ValueError)argname type_charargtype_dedupfargsfkwargss r_add_arg!get_format_args.._add_argsf & JJw mmIs3G 3 c'lG45 !  312 3sAA10A1N[.[]r z#encountered compound format arg: %rrz)encountered anonymous positional argument)r*) rsetrresplitlenr3 IndexErrorAssertionError)r formatterr:rrrrr5 fname_list base_fnamesublitsubfname_r7r8r9s @@@rrrs  ISUE7F33$-??4#8E  bc I&%0J:" !F!NOO N'] !!z U &*3//%*@&!Q'X&+A$9 '>/ N !LMM Ns =CC!c/nU(a [U5n[5nURU5H>upEpgU(aURU5 UcM#UR[ XVU55 M@ U$)aTakes a format string, turns it into a list of alternating string literals and :class:`BaseFormatField` tokens. By default, also infers anonymous positional references into explicit, numbered positional references. To disable this behavior set *resolve_pos* to ``False``. )r rrrr )r resolve_posrrDrrrrs rrrse C+D1 I#,??4#8E  JJsO =  ?567 $9 JrcP\rSrSrSrS SjrSrSrSr\ S5r S r S r S r g) r a|A class representing a reference to an argument inside of a bracket-style format string. For instance, in ``"{greeting}, world!"``, there is a field named "greeting". These fields can have many options applied to them. See the Python docs on `Format String Syntax`_ for the full details. .. _Format String Syntax: https://docs.python.org/2/library/string.html#string-formatting NcjURU5 URU5 URU5 gr-) set_fname set_fspecset_conv)selfrrrs r__init__BaseFormatField.__init__s& u u drc[R"SU5nUSUlXlUSSUlUR(+=(d URR 5Ulg)zSet the field name.r=rr N)r?r@ base_namersubpathisdigit is_positional)rRr path_lists rrOBaseFormatField.set_fnamesRHHVU+ "1  } !%/K4>>3I3I3KrcU=(d Sn/n[5RU5Hup4 nUcM URU5 M X lXlUSSUl[ RUR [5Ul g)zSet the field spec.r Nr<) rrr subfieldsrr5r/r0r1 type_func)rRrr]rGrHrIs rrPBaseFormatField.set_fspecsq  &/k&7&7&> "Fa#  *'?# rs"t~~s;rcXlSUlg)zmThere are only two built-in converters: ``s`` and ``r``. They are somewhat rare and appearlike ``"{ref!r}"``.N)r conv_func)rRrs rrQBaseFormatField.set_convs rcX[URURUR5$)z0The current state of the field in string format.)rrrrrRs rrBaseFormatField.fstr s*$**djj$))LLrc|URRnUR/nURb(UR UR UR/5 O+UR S:waUR UR 5 SRUVs/sHn[U5PM sn5nU<SU<S3$s snf)Nr z, ()) __class____name__rrextendrrjoinrepr)rRcnargsa args_reprs r__repr__BaseFormatField.__repr__s ^^ $ $ | 99 KKTYY/ 0 ZZ2  KK #II51tAw56 y))6sB9cUR$r-)rrds r__str__BaseFormatField.__str__s yyr) rVrrarrrYr]rWr5r^)r N)rj __module__ __qualname____firstlineno____doc__rSrOrPrQpropertyrrrru__static_attributes__rrrr r s< L <MM*rr cL\rSrSrSrS SjrSrSrSrSr Sr S r S r S r g )ri!ai:class:`DeferredValue` is a wrapper type, used to defer computing values which would otherwise be expensive to stringify and format. This is most valuable in areas like logging, where one would not want to waste time formatting a value for a log message which will subsequently be filtered because the message's log level was DEBUG and the logger was set to only emit CRITICAL messages. The :class:``DeferredValue`` is initialized with a callable that takes no arguments and returns the value, which can be of any type. By default DeferredValue only calls that callable once, and future references will get a cached value. This behavior can be disabled by setting *cache_value* to ``False``. Args: func (function): A callable that takes no arguments and computes the value being represented. cache_value (bool): Whether subsequent usages will call *func* again. Defaults to ``True``. >>> import sys >>> dv = DeferredValue(lambda: len(sys._current_frames())) >>> output = "works great in all {0} threads!".format(dv) PROTIP: To keep lines shorter, use: ``from formatutils import DeferredValue as DV`` c2XlX l[Ulgr-)func cache_value_UNSET_value)rRrrs rrSDeferredValue.__init__>s & rcUR[LaUR(aURnU$UR5nUR(aXlU$)zComputes, optionally caches, and returns the value of the *func*. If ``get_value()`` has been called before, a cached value may be returned depending on the *cache_value* option passed to the constructor. )rrrr)rRvalues r get_valueDeferredValue.get_valueCsH ;;f $)9)9KKE  IIKE#  rc4[UR55$r-)r2rrds r__int__DeferredValue.__int__Q4>>#$$rc4[UR55$r-)floatrrds r __float__DeferredValue.__float__TsT^^%&&rc4[UR55$r-)r1rrds rruDeferredValue.__str__Wrrc4[UR55$r-)unicoderrds r __unicode__DeferredValue.__unicode__Zst~~'((rc4[UR55$r-)rmrrds rrrDeferredValue.__repr__]sDNN$%%rcUR5nUSSn[RU[5nUR U5$![ [ 4a U"U5R U5s$f=f)Nr<)rr/r0r1 __format__r3 TypeError)rRfmtrpt type_convs rrDeferredValue.__format__`si  XMM"c*  4##C( (I& 4U#..s3 3 4sA'A,+A,)rrrNT)rjrwrxryrzrSrrrrurrrrr|rrrrr!s/8 %'%)& 4rrr)rz __future__rr?stringrr NameErrorr1__all__compiler!rrr _INTCHARS _FLOATCHARSdictr2rr/rrobjectr rr)xs0rrsB!J&    zz)* "  4   I.Iqc(I.&12ke*k23 4  #,^(<f<~ I4FI4iGT/2sB B! B& BB