+
f7i c s R t RP R4 t]]! ^^ 4 U u. uF p ]! V 4 NK
up ,
t]]! ^4 .,
tRP 4 P R4 t]RP 4 P R4 ,
t^t ! R R]4 t . RR3R lt
. RR3R lt . RR3R
lt ]
R 8X d6 ^ R It^ R It]P ! ]P" ! 4 P$ 4 R # R # u up i )
a
This module implements the algorithm for converting between a "user name" -
something that a user can choose arbitrarily inside a font editor - and a file
name suitable for use in a wide range of operating systems and filesystems.
The `UFO 3 specification `_
provides an example of an algorithm for such conversion, which avoids illegal
characters, reserved file names, ambiguity between upper- and lower-case
characters, and clashes with existing files.
This code was originally copied from
`ufoLib `_
by Tal Leming and is copyright (c) 2005-2016, The RoboFab Developers:
- Erik van Blokland
- Tal Leming
- Just van Rossum
z\" * + / : < > ? [ \ ] | \0Z z!CON PRN AUX CLOCK$ NUL A:-Z: COM1z LPT1 LPT2 LPT3 COM2 COM3 COM4c s ] tR t^ tRtR# )NameTranslationError N)__name__Z
__module__Z __qualname__Z__firstlineno__Z__static_attributes__r ?/usr/lib64/python3.14/site-packages/fontTools/misc/filenames.pyr r s r r c s \ V \ 4 ' g \ R4 h\ V4 p\ V4 pV' g V ^ , R8X d RV R, , p . pV F? pV\ 9 d RpM WwP 4 8w d
VR,
pVP
V4 KA RP V4 p \ V,
V,
pV RV p . p V P R4 F6 p
V
P 4 \ 9 d
RV
, p
V P
V
4 K8 RP V 4 p W , V, p V P 4 V9 d
\ WW#4 p V # )a Converts 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_:i NNr N) Z
isinstancestrZ
ValueErrorlenillegalCharacterslowerZappendZjoinmaxFileNameLengthsplitreservedFileNames handleClash1) userNameexistingprefixsuffix prefixLength suffixLengthZfilteredUserNameZ character sliceLengthZpartsZpartfullName &&&& r userNameToFileNamer s5 D h $ $CDDv;Lv;L hqkS(" % ) )I
//+
+ I * ww'(H#l2\AK %H Es# ::<, ,:D
T $ xxH 6)H~~8# FC Or c s \ V4 p\ V4 pV\ V 4 , V, ^, \ 8 d3 V\ V 4 , V, ^, p\ V,
pV RV p Rp^p Vf\ V \ V 4 P ^4 , p
W*, V, p V P 4 V9 d T pMV ^,
p V R8 g K^ Vf
\ WV4 pV# )a
existing should be a case-insensitive list
of all existing file names.
>>> 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
Nl I5 )r r
r Zzfillr handleClash2) r r r r r r Zlr finalNamecounterZnamer r r r
r
s > v;Lv;Lc(m#l2R7:KK 3x= (< 7" <'!+ L[)IG
#g,,,R00=6) >> 8 + I qLG o % 6: r c s* \ \ V4 ,
\ V4 ,
p\ RV, 4 pRp^pVfD V\ V4 , V, pVP 4 V 9 d TpMV^,
pWd8 g KF Vf \ R4 hV# )a
existing should be a case-insensitive list
of all existing file names.
>>> 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
Z9Nz No unique name could be found.)r
r Zintr r r )r r r Z maxLengthZmaxValuer r r s &&& r r r s 6 "CK/#f+=I3?#HIG
CL(61 >> 8 + I qLG "#CDD r Z__main__N)Z__doc__r r ZrangeZchrr r r
Z Exceptionr r r
r r ZdoctestZsysZexitZtestmodZfailed)Zis 0r r s & 388= eArl3lc!fl3 3 c$i[ 7==?EEcJ 4::<BB3G G 9 +-R eP %'r" 6r R -` zHHW__
%
%& y 4s C2