#eXddlmZddlZddlZddlmZmZmZmZm Z m Z m Z m Z m Z mZmZddlZddlZddlmZmZddlmZmZmZddlmZddlmZddlmZdd l m!Z!dd l"m#Z#dd l$m%Z%dd l&m'Z'dd l(m)Z)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5ddl6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>ddl?m@Z@mAZAmBZBd dZCd!dZDd"dZEd#dZFd$dZGd%dZHd&dZId'dZJe>edGddZKy)() annotationsN) AnyDictIterableIteratorKeysViewListMappingMutableMappingOptionalSequencecast)definefield)UFOFileStructure UFOReader UFOWriter)DEFAULT_LAYER_NAME)DataSet)Features)Glyph) Guideline)ImageSet)Info)Kerning KerningPair)Layer)LayerSet)Lib _convert_Lib_get_lib _get_tempLib_set_lib _set_tempLib) BoundingBox_deepcopy_unlazify_attrs_getstate_unlazify_attrs _object_lib_prune_object_libs_setstate_attrs)serde) HasIdentifierPathLikeTcPt|tr|Stj|SN) isinstancer from_iterablevalues 6/usr/lib/python3/dist-packages/ufoLib2/objects/font.py_convert_LayerSetr66s!uh/5RX5K5KE5RRc<t|tr|Stdi|S)N)r1rr3s r5 _convert_Infor::sud+5>>r7c<t|tr|St|Sr0)r1rr3s r5_convert_DataSetr<>ug.5BGENBr7c<t|tr|St|Sr0)r1rr3s r5_convert_ImageSetr?Buh/5DXe_Dr7c<t|tr|St|Sr0)r1rr3s r5_convert_FeaturesrBFr@r7c<t|tr|St|Sr0)r1rr3s r5_convert_KerningrDJr=r7Fontc|jSr0)_kerningselfs r5 _get_kerningrJNs ==r7c$t||_yr0)rDrGrIr4s r5 _set_kerningrMRs$U+DMr7T)kw_onlyceZdZUdZeej eddiZde d< ee e Z de d < ee eZd e d < ee Zd e d< eeeZde d< eeeZde d< eeeZde d< eeeZde d< eeeZde d< edddZde d<edddZ de d<edddZ!de d <edddZ"d!e d"<e#dEdFd#Z$e#dGdHd$Z%dId%Z&dJd&Z'dKd'Z(dLd(Z)dMd)Z*dNd*Z+dOdPd+Z,dQd,Z-dRd-Z.dSd.Z/dTd/Z0dUd0Z1dVd1Z2dVd2Z3e4dWd3Z5dRd4Z6e7Z8e9Z:e;ZZNd`d?ZOdadbd@ZPdadbdAZQdcdBZRdOdddCZS de dfdDZTy)grEaA data class representing a single Unified Font Object (UFO). Font uses :class:`fontTools.ufoLib.UFOReader` and :class:`fontTools.ufoLib.UFOWriter` to read and write UFO data from and to disk. It will default to reading lazily, loading glyphs, data and images as they are accessed. Copying a font implicitly loads everything eagerly before. The data model is formally specified at http://unifiedfontobject.org/versions/ufo3/index.html. Parameters: layers (LayerSet): A mapping of layer names to Layer objects. info (Info): The font Info object. features (Features): The font Features object. groups (Dict[str, List[str]]): A mapping of group names to a list of glyph names. kerning (Dict[Tuple[str, str], float]): A mapping of a tuple of first and second kerning pair to a kerning value. lib (Dict[str, Any]): A mapping of keys to arbitrary values. data (DataSet): A mapping of data file paths to arbitrary data. images (ImageSet): A mapping of image file paths to arbitrary image data. tempLib (Dict[str, Any]): A temporary mapping of keys to arbitrary values which unlike lib are *not* saved to disk. Behavior: The Font object has some dict-like behavior for quick access to glyphs on the the default layer. For example, to get a glyph by name from the default layer:: glyph = font["aGlyphName"] To iterate over all glyphs in the default layer:: for glyph in font: pass To get the number of glyphs in the default layer:: glyphCount = len(font) To find out if a font contains a particular glyph in the default layer by name:: exists = "aGlyphName" in font To remove a glyph from the default layer by name:: del font["aGlyphName"] To replace a glyph in the default layer with another :class:`.Glyph` object:: font["aGlyphName"] = otherGlyph To copy a font:: import copy fontCopy = copy.deepcopy(font) Layers behave the same, for when you're working on something other than the default layer. omit_if_defaultF)factory convertermetadatarlayers)rQrRrinforfeatures)rQzDict[str, List[str]]groupsrrGr_librdatarimages_tempLibN)defaulteqinitzOptional[PathLike]_path)r\r^r]zOptional[bool]_lazyzOptional[UFOReader]_readerzOptional[UFOFileStructure]_fileStructurecxt||}|j||}||_|s|j|S)aInstantiates a new Font object from a path to a UFO. Args: path: The path to the UFO to load. lazy: If True, load glyphs, data files and images as they are accessed. If False, load everything up front. validate: If True, enable UFO data model validation during loading. If False, load whatever is deserializable. )validatelazy)rreadr_close)clspathrfrdreaderrIs r5openz Font.opens:4(3xxTx*  LLN r7c |tj||tj||tj||t j|t |j |jt|jt|j}||_ |j|_|r||_|S)aInstantiates a Font object from a :class:`fontTools.ufoLib.UFOReader`. Args: path: The path to the UFO to load. lazy: If True, load glyphs, data files and images as they are accessed. If False, load everything up front. re)rTrYrZrUrVrWkerninglib)rrgrrrr readFeatures readGroupsr readKerningrreadLibr` fileStructurerbra)rirkrfrIs r5rgz Font.reads==d3f40==d36"f1134$$&F..01FNN$%   $22 !DL r7c2||jjvSr0rT _defaultLayerrInames r5 __contains__zFont.__contains__st{{0000r7c2|jj|=yr0rvrxs r5 __delitem__zFont.__delitem__s KK % %d +r7c4|jj|Sr0rvrxs r5 __getitem__zFont.__getitem__s{{((..r7c6||jj|<yr0rv)rIryglyphs r5 __setitem__zFont.__setitem__s*/ !!$'r7c@t|jjSr0)iterrTrwrHs r5__iter__z Font.__iter__sDKK--..r7c@t|jjSr0)lenrTrwrHs r5__len__z Font.__len__s4;;,,--r7cN|jjj||S)zwReturn the :class:`.Glyph` object for name if it is present in the default layer, otherwise return ``default``.)rTrwget)rIryr\s r5rzFont.gets!{{((,,T7;;r7cJ|jjjS)z2Return a list of glyph names in the default layer.)rTrwkeysrHs r5rz Font.keyss{{((--//r7cR|j|jjyy)z\Closes the UFOReader if it still exists to finalize any outstanding file operations.N)rarhrHs r5rhz Font.closes# << # LL    $r7c|Sr0r9rHs r5 __enter__zFont.__enter__ s r7c$|jyr0)rh)rIexc_type exc_valueexc_tbs r5__exit__z Font.__exit__s  r7c dttd|jj|jjg}|r dj dj |nd}dj |jj|jj|tt|S)Nz '{}' z<{}.{}{} at {}>) listfilterrU familyName styleNameformatjoin __class__ __module____name__hexid)rInamesfontNames r5__repr__z Font.__repr__sVD499#7#79L9L"MNO6;7>>#((5/2 '' NN % %t~~'>'>#bQUh-  r7c |j|jurtStt|}||fD]}|js|j !|j |j|j|j|j|j|j|jf|j |j|j|j|j|j|j|jfk(Sr0)rNotImplementedrrEr`unlazifyrTrUrVrWrnrorYrZ)rIotherfonts r5__eq__z Font.__eq__s ??$.. 0! !T5!5M Dzz  KK II MM KK LL HH II KK   LL JJ NN LL MM II JJ LL    r7cF|j|}|turtS| Sr0)rr)rIrresults r5__ne__z Font.__ne__8s&U# ^ #! !zr7c|jS)z;Returns the underlying :class:`fontTools.ufoLib.UFOReader`.)rarHs r5rkz Font.reader>s||r7c|jr\|jJ|jj|jj|j jd|_y)z`Load all glyphs, data files and images if the Font object loaded them lazily previously.NF)r`rarTrrYrZrHs r5rz Font.unlazifyCsR ::<<+ ++ KK " II   KK " r7c vtttt|jj dgS)aThe font's glyph order. See http://unifiedfontobject.org/versions/ufo3/lib.plist/#publicglyphorder for semantics. Getter: Return the font's glyph order, if it is set in lib, or an empty list. Note: The getter always returns a new list, modifications to it do not change the lib content. Setter: Sets the font's glyph order. If ``value`` is None or an empty list, the glyph order key will be deleted from the lib if it exists. public.glyphOrder)rrr strrorrHs r5 glyphOrderzFont.glyphOrderRs*$D# 5H"(MNOOr7c||t|dk(rd|jvr|jd=yy||jd<y)Nrr)rrorLs r5rzFont.glyphOrderfs@ =CJ!O"dhh.HH01/-2DHH( )r7c^|jjgS|jjS)zThe font's global guidelines. Getter: Returns the font's global guidelines or an empty list. Setter: Appends the list of Guidelines to the global Guidelines. XXX Should it replace them? )rU guidelinesrHs r5rzFont.guidelinesns) 99   'Iyy###r7cVg|j_|D]}|j|yr0)rUrappendGuideline)rIr4 guidelines r5rzFont.guidelines}s+!  ,I   + ,r7c.t|j|S)aReturn the lib for an object with an identifier, as stored in a font's lib. If the object does not yet have an identifier, a new one is assigned to it. If the font lib does not yet contain the object's lib, a new one is inserted and returned. .. doctest:: >>> from ufoLib2.objects import Font, Guideline >>> font = Font() >>> font.guidelines = [Guideline(x=100)] >>> guideline_lib = font.objectLib(font.guidelines[0]) >>> guideline_lib["com.test.foo"] = 1234 >>> guideline_id = font.guidelines[0].identifier >>> assert guideline_id is not None >>> assert font.lib["public.objectLibs"][guideline_id] is guideline_lib )r(ro)rIobjects r5 objectLibzFont.objectLibs&488V,,r7c|jS)z3Return the path of the UFO, if it was set, or None.)r_rHs r5rjz Font.pathszzr7cB|jjjS)zReturns the (xMin, yMin, xMax, yMax) bounding box of the default layer, taking the actual contours into account. |defcon_compat| )rTrwboundsrHs r5rz Font.boundss{{((///r7cB|jjjS)zReturns the (xMin, yMin, xMax, yMax) bounding box of the layer, taking only the control points into account. |defcon_compat| )rTrwcontrolPointBoundsrHs r5rzFont.controlPointBoundss{{((;;;r7cN|jjj|y)zAppends glyph object to the default layer unless its name is already taken. Note: Call the method on the layer directly if you want to overwrite entries with the same name or append copies of the glyph. N)rTrwaddGlyph)rIrs r5rz Font.addGlyphs !!**51r7cL|jjj|S)zRCreates and returns new :class:`.Glyph` object in default layer with name.)rTrwnewGlyphrxs r5rz Font.newGlyphs{{((11$77r7c <|jj|fi|S)zCreates and returns a new :class:`.Layer`. Args: name: The name of the new layer. kwargs: The arguments passed to the Layer object constructor. )rTnewLayer)rIrykwargss r5rz Font.newLayers $t{{##D3F33r7cR|jjj|||y)a4Renames a :class:`.Glyph` object in the default layer. Args: name: The old name. newName: The new name. overwrite: If False, raises exception if newName is already taken. If True, overwrites (read: deletes) the old :class:`.Glyph` object. N)rTrw renameGlyphrIrynewName overwrites r5rzFont.renameGlyphs  !!--dGYGr7c>|jj|||y)aRenames a :class:`.Layer`. Args: name: The old name. newName: The new name. overwrite: If False, raises exception if newName is already taken. If True, overwrites (read: deletes) the old :class:`.Layer` object. N)rT renameLayerrs r5rzFont.renameLayers gy9r7c6t|ts=t|ts"tddt |j tdi|}|j jg|j _|j jj|y)a Appends a guideline to the list of the font's global guidelines. Creates the global guideline list unless it already exists. Args: guideline: A :class:`.Guideline` object or a mapping for the Guideline constructor. z/Expected Guideline object or a Mapping for the zGuideline constructor, found Nr9) r1rr TypeErrortyperrUrappend)rIrs r5rzFont.appendGuidelines)Y/i1E3DO4L4L3MN".I.I 99   '#%DII  ##I.r7c||j|u}|jjjtk7rt|jj vsJ|j |jj|j|j|j|j|j|jt|j |j"Dchc]}|j$|j$c}|j'|j |jj)|||j*j)|||j,j)||ycc}w)acWrites this Font to a :class:`fontTools.ufoLib.UFOWriter`. Args: writer: The :class:`fontTools.ufoLib.UFOWriter` to write to. saveAs: If True, tells the writer to save out-of-place. If False, tells the writer to save in-place. This affects how resources are cleaned before writing. NsaveAs)rarTrwryr layerOrder writeFeaturesrVtext writeGroupsrW writeInforU writeKerningrnr)ror identifierwriteLibwriterYrZ)rIwriterrgs r5rz Font.writes >\\/F ;; $ $ ) )-? ?%T[[-C-CC CCT]]//04;;'#DLL) HH#'?? Oaall6NQ\\ O  ! &0 v. &0 Ps *F <F c>|dk7rtd|| t|}n|j |j}|Vt|tj j s2tjjtj|}dx}}|du}|rt|trtjj|r|rO|}tjj}|jtjj!|}n@ddl} t%| j&d|z|j t)d|j} t+|||5} |j-| |ddd j/|t|tsJtjj1|rt3j4|n4tjj7|rtj8|t3j:|||} ||j? t|tj j s||_ yy#1swYxYw#t<$rwxYw#||j?wwxYw) aSaves the font to ``path``. Args: path: The target path. If it is None, the path from the last save (except when that was a ``fs.base.FS``) or when the font was first opened will be used. formatVersion: The version to save the UFO as. Only version 3 is supported currently. structure (fontTools.ufoLib.UFOFileStructure): How to store the UFO. Can be either None, "zip" or "package". If None, it tries to use the same structure as the original UFO at the output path. If "zip", the UFO will be saved as compressed archive. If "package", it is saved as a regular folder or "package". overwrite: If False, raises OSError when the target path exists. If True, overwrites the target path. validate: If True, will validate the data in Font before writing it out. If False, will write out whatever is serializable. zunsupported format version: Nrzpath %r already existsz)'path' is required when saving a new Font) structurerdr)!NotImplementedErrorrrbr1fsbaseFSosrjnormpathfspathrexiststempfsTempFS getsyspathbasenameerrnoOSErrorEEXISTrrrsetModificationTimeisdirshutilrmtreeisfileremovemove Exceptionrhr_) rIrj formatVersionrrrd overwritePathtmprrrs r5savez Font.saves4 A %(D]O&TU U  (3I  ,++I  JtRWWZZ$@77##BIIdO4D"" T! $$)=$(M))**,C>>"''*:*:4*@AD !%,,0H40OPP YY GH H99D 49xH 2F 6& 1 2  & & ((!$,,,77==/MM-0WW^^M2IIm, D-0$ $ +DJ,5 2 2    s7I9+I-?I9BJ-I62I99 JJJ)TT)rjr-rfboolrdrreturnrE)T)rkrrfrrrE)ryrrr)ryrrNone)ryrrr)ryrrrrr)rzIterator[Glyph])rintr0)ryrr\zT | NonerzT | Glyph | None)rz KeysView[str])rr)rrE)rrrrrrrr)rr)rrrr)rzUFOReader | None)rz list[str])r4zlist[str] | Nonerr)rzlist[Guideline])r4z'Iterable[Guideline | Mapping[str, Any]]rr)rr,rzdict[str, Any])rzPathLike | None)rzBoundingBox | None)rrrr)ryrrrrr)F)ryrrrrrrr)rzGuideline | Mapping[str, Any]rr)rrrz bool | Nonerr)NrNFT) rjzPathLike | fs.base.FS | NonerrrzUFOFileStructure | Nonerrrdrrr)Urr __qualname____doc__rrr\r6rT__annotations__rr:rUrrBrVdictrWrrDrGrr rXrr<rYrr?rZr[r_r`rarb classmethodrlrgrzr|r~rrrrrrhrrrrrpropertyrkrr& __deepcopy__r' __getstate__r* __setstate__rsetterrrJrMrnr!r#ror"r$tempLibrrjrrrrrrrrrrr9r7r5rErEVs :x  ##U+FH ?t}=D$=%x;LMHhM-#(#6F 6Rg9IJHgJ c\:D#:Q'5EFD'FBX9JKFHKJ#>Hc>O!&du5 IE I!$UuEE>E#(Ee#LG L165U2N."21,/0/.< 0!   @ ,L+L"L PP&22 $ $,, |\2G 8X &C|\2G-*00<<28 4 H :/(1@.2-1 V*VV+ V  V  V Vr7)r4zLayerSet | Iterable[Layer]rr)r4zInfo | Mapping[str, Any]rr)r4z$DataSet | MutableMapping[str, bytes]rr)r4z%ImageSet | MutableMapping[str, bytes]rr)r4zFeatures | strrr)r4Mapping[KerningPair, float]rr)rIrErr)rIrEr4rrr)L __future__rrrtypingrrrrrr r r r r rfs.baser fs.tempfsattrsrrfontTools.ufoLibrrrufoLib2.constantsrufoLib2.objects.dataSetrufoLib2.objects.featuresrufoLib2.objects.glyphrufoLib2.objects.guidelinerufoLib2.objects.imageSetrufoLib2.objects.inforufoLib2.objects.kerningrrufoLib2.objects.layerrufoLib2.objects.layerSetrufoLib2.objects.librr r!r"r#r$ufoLib2.objects.miscr%r&r'r(r)r* ufoLib2.serder+ufoLib2.typingr,r-r.r6r:r<r?rBrDrJrMrEr9r7r5r$s"     CC0+-'/-%8'- 55S?CEEC,SSSr7