]Mh( d Z h dZh dZdZ G d de Zddefd Zg ddfd
Zg ddfd Z e
d k rd
dl Z e j dS dS )aH
Convert user-provided internal UFO names to spec-compliant filenames.
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
>/ *
"()+/:<>?[\]|> clock$auxconnulprncom1com2com3com4com5com6com7com8com9lpt1lpt2lpt3lpt4lpt5lpt6lpt7lpt8lpt9 c e Zd ZdS )NameTranslationErrorN)__name__
__module__ __qualname__ Z/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/fontTools/ufoLib/filenames.pyrJ rJ k s DrO rJ rN userNamec t | t st d t | }t | }|s| d dk r
d| dd z } g }| D ]@}|t v rd}n || k r|dz
}| | Ad | } t |z
|z
}| d| } g } | d D ]7}
|
t v rd|
z }
| |
8d | } || z |z } | |v rt | ||| } | S )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. ._ NrQ )
isinstancestr
ValueErrorlenillegalCharacterslowerappendjoinmaxFileNameLengthsplitreservedFileNames handleClash1) rR existingprefixsuffix prefixLength suffixLengthfilteredUserName character sliceLengthpartspartfullNames rP userNameToFileNamero o s D h $ $ ECDDDv;;Lv;;L &hqkS((!"" % + + ) ) )II
)//++
+
+ I ****ww'((H#l2\AK %H Es## ::<<, , ,:D
TxxH 6)H~~8## (FFCC OrO c t | }t | }|t | z |z dz t k r,|t | z |z dz }t |z
}| d| } d}d} |T| t | d z }
||
z |z } | |vr| }n| dz
} | dk rn|T|t ||| }|S )aC A 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
NrW l I5 )r[ r` rY zfillr] handleClash2) rR rd re rf rg rh lrk finalNamecounternamern s rP rc rc s P v;;Lv;;Lc(mm#l2R7:KKK 3x== (< 7" <'!+ L[L)IG
#g,,,,R000D=6) >> 8 + + I qLG o % %
66:: rO c t t | z
t | z
}t d|z }d}d}|<|t | z |z }| | vr|}n|dz
}||k rn|<|t d |S )ak A 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
9NrW z No unique name could be found.)r` r[ intrY r] rJ )rd re rf maxLengthmaxValueru rv rn s rP rs rs s R "CKK/#f++=I3?##HIG
CLL(61 >> 8 + + I qLG h
"#CDDD rO __main__rT N)rN rQ rQ )
__doc__r\ rb r` ExceptionrJ rY ro rc rs rK doctesttestmodrN rO rP r s :0 0 0 b 2 9 e e e e e eP %'r" ? ? ? ?D R ; ; ; ;| zNNNGO rO