+ f7i)csa0t$^RIHt^RIHt0RkRkRkRkRkRkR kR kR kR kR kRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkR kR!kR"kR#kR$kR%kR&kR'kR(kR)kR*kR+kR,kR-kR.kR/kR0kR1ktR2]R3&0RBmtR2]R4&^tR5]R6&!R7R8] 4t RCR:R;llt .R9R93R<R=llt .R9R93R>R?llt ]R@8Xd^RAIt]P !4RA#RA#)Di) annotations)IterableZZZZZZZZZZ Z Z Z Z ZZZZZZZZZZZZZZZZZZZ"Z*Z+Z/Z:ZZ?Z[Z\Z]Z(Z)Z|Zzset[str]illegalCharactersreservedFileNamesintmaxFileNameLengthcs]tRt^otRtR#)NameTranslationErrorN)__name__Z __module__Z __qualname__Z__firstlineno__Z__static_attributes__rA/usr/lib64/python3.14/site-packages/fontTools/ufoLib/filenames.pyrrosr rc ,V^8dQhRRRRRRRRRR/#userNamestrexisting Iterable[str]prefixsuffixreturnrZformat"r __annotate__rss;ggg*g9<gKNggr cs\V\4'g \R4h\V4p\V4pV'gV^,R8XdRVR,,p.pVF?pV\9dRpMWwP 48wd VR, pVP V4KA RPV4p\V, V, pVRVp.p VPR4F6p V P 4\9d RV ,p V P V 4K8 RPV 4pW ,V,p V P 4V9d \WW#4p V #)aConverts from a user name to a file name. Takes care to avoid illegal characters, reserved file names, ambiguity between upper- and lower-case characters, and clashes with existing files. Args: userName (str): The input file name. existing: A case-insensitive list of all existing file names. prefix: Prefix to be prepended to the file name. suffix: Suffix to be appended to the file name. Returns: A suitable filename. Raises: NameTranslationError: If no suitable name could be generated. Examples:: >>> userNameToFileName("a") == "a" True >>> userNameToFileName("A") == "A_" True >>> userNameToFileName("AE") == "A_E_" True >>> userNameToFileName("Ae") == "A_e" True >>> userNameToFileName("ae") == "ae" True >>> userNameToFileName("aE") == "aE_" True >>> userNameToFileName("a.alt") == "a.alt" True >>> userNameToFileName("A.alt") == "A_.alt" True >>> userNameToFileName("A.Alt") == "A_.A_lt" True >>> userNameToFileName("A.aLt") == "A_.aL_t" True >>> userNameToFileName(u"A.alT") == "A_.alT_" True >>> userNameToFileName("T_H") == "T__H_" True >>> userNameToFileName("T_h") == "T__h" True >>> userNameToFileName("t_h") == "t_h" True >>> userNameToFileName("F_F_I") == "F__F__I_" True >>> userNameToFileName("f_f_i") == "f_f_i" True >>> userNameToFileName("Aacute_V.swash") == "A_acute_V_.swash" True >>> userNameToFileName(".notdef") == "_notdef" True >>> userNameToFileName("con") == "_con" True >>> userNameToFileName("CON") == "C_O_N_" True >>> userNameToFileName("con.alt") == "_con.alt" True >>> userNameToFileName("alt.con") == "alt._con" True z(The value for userName must be a string.Z.Z_:iNNr N) Z isinstancerZ ValueErrorlenrlowerZappendZjoinrZsplitr handleClash1) rrrr prefixLength suffixLengthZfilteredUserNameZ character sliceLengthZpartsZpartfullName &&&& r userNameToFileNamer!ss5H h $ $CDDv;Lv;L hqkS("% ) )I //+ +  I *ww'(H#l2\AK %H Es# ::<, ,:D T$xxH 6)H~~8#FC Or c r r rrrr rrs;AAA*A9<AKNAAr cs\V4p\V4pV\V4,V,^,\8d3V\V4,V,^,p\V, pVRVpRp^p Vf\V\V 4P^4,p W*,V,p V P 4V9dT pMV ^, p V R8gK^Vf \ WV4pV#)aA helper function that resolves collisions with existing names when choosing a filename. This function attempts to append an unused integer counter to the filename. Args: userName (str): The input file name. existing: A case-insensitive list of all existing file names. prefix: Prefix to be prepended to the file name. suffix: Suffix to be appended to the file name. Returns: A suitable filename. >>> prefix = ("0" * 5) + "." >>> suffix = "." + ("0" * 10) >>> existing = ["a" * 5] >>> e = list(existing) >>> handleClash1(userName="A" * 5, existing=e, ... prefix=prefix, suffix=suffix) == ( ... '00000.AAAAA000000000000001.0000000000') True >>> e = list(existing) >>> e.append(prefix + "aaaaa" + "1".zfill(15) + suffix) >>> handleClash1(userName="A" * 5, existing=e, ... prefix=prefix, suffix=suffix) == ( ... '00000.AAAAA000000000000002.0000000000') True >>> e = list(existing) >>> e.append(prefix + "AAAAA" + "2".zfill(15) + suffix) >>> handleClash1(userName="A" * 5, existing=e, ... prefix=prefix, suffix=suffix) == ( ... '00000.AAAAA000000000000001.0000000000') True NlI5)rrrZzfillr handleClash2) rrrrrrZlr finalNamecounterZnamerr r rrsTv;Lv;Lc(m#l2R7:KK 3x= (< 7" <'!+ L[)IG  #g,,,R00=6) >> 8 + I  qLG o %  6: r cs(V^8dQhRRRRRRRR/#)rrrrrrrrrrr rr!s,===*-=>> prefix = ("0" * 5) + "." >>> suffix = "." + ("0" * 10) >>> existing = [prefix + str(i) + suffix for i in range(100)] >>> e = list(existing) >>> handleClash2(existing=e, prefix=prefix, suffix=suffix) == ( ... '00000.100.0000000000') True >>> e = list(existing) >>> e.remove(prefix + "1" + suffix) >>> handleClash2(existing=e, prefix=prefix, suffix=suffix) == ( ... '00000.1.0000000000') True >>> e = list(existing) >>> e.remove(prefix + "2" + suffix) >>> handleClash2(existing=e, prefix=prefix, suffix=suffix) == ( ... '00000.2.0000000000') True Z9NzNo unique name could be found.)rrrrrr)rrrZ maxLengthZmaxValuer#r$rs&&& r r"r"!sV"CK/#f+=I3?#HIG  CL(61 >> 8 + I  qLG   "#CDD r Z__main__N>ZauxZconZnulZprnZcom1Zcom2Zcom3Zcom4Zcom5Zcom6Zcom7Zcom8Zcom9Zlpt1Zlpt2Zlpt3Zlpt4Zlpt5Zlpt6Zlpt7Zlpt8Zlpt9zclock$)rr r )__conditional_annotations__Z __future__rZcollections.abcrrZ__annotations__rrZ Exceptionrr!rr"rZdoctestZtestmod)r%s@r r&s""$:0 0 0 0 0  0  0 0 0 0 0 0 0 0 0 0  !0" #0$ %0& '0( )0* +0, -0. /00 102 304 506 708 90: ;0< =0> ?0@ A0BC0DE0FG0HI0JK0LM0NO0PQ0RS0T U0VW0XY0Z[0\]0^ _080b823 9 gV.0rQSAJ!"=@ z OOr