h) %SSKJr SSKJr 1SkrS\S'1SkrS\S'SrS \S '"S S \5r SSSjjr /S S 4SSjjr /S S 4SSjjr \ S:XaSSKr\R"5 gg)) annotations)Iterable>/     "()*+/:<>?[\]|zset[str]illegalCharacters>auxconnulprncom1com2com3com4com5com6com7com8com9lpt1lpt2lpt3lpt4lpt5lpt6lpt7lpt8lpt9clock$reservedFileNamesintmaxFileNameLengthc\rSrSrSrg)NameTranslationErroroN)__name__ __module__ __qualname____firstlineno____static_attributes__rST/var/www/fran/franai/venv/lib/python3.13/site-packages/fontTools/ufoLib/filenames.pyrQrQosrYrQch[U[5(d [S5e[U5n[U5nU(dUSS:XaSUSS-n/nUH9nU[;aSnOXwR 5:waUS- nUR U5 M; SRU5n[U- U- nUSUn/n URS5H1n U R 5[;aSU -n U R U 5 M3 SRU 5nX -U-n U R 5U;a [XX#5n U $)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.r._Nr[) isinstancestr ValueErrorlenr4lowerappendjoinrOsplitrL handleClash1) userNameexistingprefixsuffix prefixLength suffixLengthfilteredUserName character sliceLengthpartspartfullNames rZuserNameToFileNameruss7H h $ $CDDv;Lv;L hqkS(!"% ) )I //+ +  I *ww'(H#l2\AK %H Es# ::<, ,:D T$xxH 6)H~~8#FC OrYcr[U5n[U5nU[U5-U-S-[:a"U[U5-U-S-n[U- nUSUnSnSn UcLU[U 5RS5-n X*-U-n U R 5U;aU nOU S- n U S:aOUcMLUc [ XU5nU$)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 Nr_lI5)rcrOrazfillrd handleClash2) rirjrkrlrmrnlrq finalNamecounternamerts rZrhrhsTv;Lv;Lc(m#l2R7:KK 3x= (< 7" <'!+ L[)IG  #g,,,R00=6) >> 8 + I  qLG o %    6: rYc[[U5- [U5- n[SU-5nSnSnUc8U[U5-U-nUR 5U;aUnOUS- nXd:aOUcM8Uc [ S5eU$)aA helper function that resolves collisions with existing names when choosing a filename. This function is a fallback to :func:`handleClash1`. It 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. Raises: NameTranslationError: If no suitable name could be generated. Examples:: >>> 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 9Nr_zNo unique name could be found.)rOrcrNrardrQ)rjrkrl maxLengthmaxValuer{r|rts rZryry!sV"CK/#f+=I3?#HIG  CL(61 >> 8 + I  qLG     "#CDD rY__main__N)rSr[r[) rirarj Iterable[str]rkrarlrareturnra)rjrrkrarlrarra) __future__rcollections.abcrr4__annotations__rLrO ExceptionrQrurhryrTdoctesttestmodrSrYrZrs "$:080b823 9 RTgg*g9<gKNggV.0rQSAA*A9<AKNAAJ!"==*-=