ehp ^dZddlZddlmZddlmZddlZddlZddlZddlm Z ddl Z ddl Z ddl Z ddl Z ddlZ ddlZ ddlZ ddlZ ddlZ ddlmZddlddlmZdd lmZdd lmZdd lmZmZgd Zd Z ejBe"Z#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.dZ/Gdde0eejbZ2ejfe2_3GddejbZ4GddZ5Gd d!e5Z6Gd"d#e6Z7e7Z8d$Z9d%Z:d&Z;d'Ze?e@dd*ZAgd+ZBe?e@dd,ZCe?e@dd-ZDgd.ZEhd/ZFid0eGeH1d2eGeH1d3eGeH1d4eGeHeI5d6eGeJ1d7eGeJ1d8eGeJ1d9eGeH1d:eGeH1d;eGeJeKf1d<eGeJeKf1d=eGeJeKf1d>eGeJeKf1d?eGeJeKf1d@eGeKeJf1dAeGeH1dBeGeHeL5idCeGeJeKf1dDeGdEeMeAFdGeGeJeKf1dHeGeJeKf1dIeGeJeKf1dJeGeJ1dKeGeJ1dLeGeJeKf1dMeGeH1dNeGeH1dOeGeH1dPeGeH1dQeGeH1dReGeH1dSeGeH1dTeGeH1dUeGeH1idVeGeH1dWeGeH1dXeGeH1dYeGeH1dZeGeH1d[eGeH1d\eGeJeN5d]eGeJeO5d^eGdEeMeBFd_eGeH1d`eGdEeP5daeGdEeQ5dbeGdEeMeCFdceGdEeMeDFddeGeJeKf1deeGeJeKf1dfeGeJeKf1idgeGeJeKf1dheGeJeKf1dieGdEeMeEFdjeGeJeKf1dkeGeJeKf1dleGeJeKf1dmeGeJeKf1dneGeJeKf1doeGeJeKf1dpeGeJeKf1dqeGeJeKf1dreGeJeKf1dseGeJeKf1dteGeJeKf1dueGeJeKf1dveGeJeKf1dweGeJ1idxeGeJ1dyeGeJeKf1dzeGeH1d{eGeH1d|eGeKeJf1d}eGeJ1d~eGeJeKf1deGeJeKf1deGeR1deGdEeS5deGdEeT5deGdEeS5deGdEeT5deGdEeU5deGdEeU5deGeJeKf1deGeJeKf1eGeKeJf1eGeR1eGeJeKf1eGeJeKf1eGeH1eGeH1eGeJeV5eGeJ1eGeH1d ZWeXeWjZZeeWZ[e[jid7eGeJe]5d;eGeJeKfe^5dCeGeJe^5dGeGeJ1dHeGeJ1dIeGeJ1dLeGeJ1d`eGdEe_5ddeGeJ1deeGeJ1dfeGeJ1dgeGeJe^5dheGeJe^5djeGeJ1dkeGeJ1dleGeJ1dmeGeJ1idneGeJ1doeGeJ1dpeGeJ1dqeGeJ1dreGeJ1dseGeJ1deGde`5deGdea5dteGeJ1dueGeJ1dveGeJ1dyeGeJ1deGeJe]5deGeJe]5deGeGeb5deGeGec5deGeGed5eGeGee5eGeGef5eGeGeg5eGeGeh5eGeGei5eGe?ej5eGe?ek5deXe[jZle?eWjD]\ZnZodeovs epeod<e?e[jD]\ZnZodeovs epeod<dZqidd3ddMddNddOddPddQddRddSddTddUddVddWddXdddd]dd_dd}dzdddd|d{d4d\dd ZreqerZseXerjZtdddddZueqeuZvdeud<dddddddddd ZweqewZxdewd<dewd<dewd<dewd<iddddddddd,dddddddddddœddǓddɓdd˓dd͓dd*ddГddғdddd֜ZyeqeyZzdׄZ{d؄Z|dلZ}dڄZ~hdۣZd;hZhdܣZd݄ZdބZd߄ZdZe"dk(rddlZejyy)a A library for importing .ufo files and their descendants. Refer to http://unifiedfontobject.org for the UFO specification. The main interfaces are the :class:`.UFOReader` and :class:`.UFOWriter` classes, which support versions 1, 2, and 3 of the UFO specification. Set variables are available for external use that list the font info attribute names for the `fontinfo.plist` formats. These are: - :obj:`.fontInfoAttributesVersion1` - :obj:`.fontInfoAttributesVersion2` - :obj:`.fontInfoAttributesVersion3` A set listing the `fontinfo.plist` attributes that were deprecated in version 2 is available for external use: - :obj:`.deprecatedFontInfoAttributesVersion2` Functions that do basic validation on values for `fontinfo.plist` are available for external use. These are - :func:`.validateFontInfoVersion2ValueForAttribute` - :func:`.validateFontInfoVersion3ValueForAttribute` Value conversion functions are available for converting `fontinfo.plist` values between the possible format versions. - :func:`.convertFontInfoValueForAttributeFromVersion1ToVersion2` - :func:`.convertFontInfoValueForAttributeFromVersion2ToVersion1` - :func:`.convertFontInfoValueForAttributeFromVersion2ToVersion3` - :func:`.convertFontInfoValueForAttributeFromVersion3ToVersion2` N)deepcopy)fsdecode) OrderedDict)plistlib)*)userNameToFileName)%convertUFO1OrUFO2KerningToUFO3Kerning) UFOLibError) numberTypes_VersionTupleEnumMixin) makeUFOPathr UFOReader UFOWriterUFOReaderWriterUFOFileStructurefontInfoAttributesVersion1fontInfoAttributesVersion2fontInfoAttributesVersion3$deprecatedFontInfoAttributesVersion2)validateFontInfoVersion2ValueForAttribute)validateFontInfoVersion3ValueForAttribute6convertFontInfoValueForAttributeFromVersion1ToVersion26convertFontInfoValueForAttributeFromVersion2ToVersion1z3.0.0glyphsdataimageszmetainfo.plistzfontinfo.plistz lib.plistz groups.plistz kerning.plistz features.feazlayercontents.plistzlayerinfo.plistzpublic.defaultceZdZdZdZdZy)UFOFormatVersion)r)r)rN)__name__ __module__ __qualname__ FORMAT_1_0 FORMAT_2_0 FORMAT_3_0W/var/www/skyplay_api_hub/venv/lib/python3.12/site-packages/fontTools/ufoLib/__init__.pyrrdsJJJr)rceZdZdZdZy)rzippackageN)r"r#r$ZIPPACKAGEr(r)r*rrps CGr)rc eZdZdZddZdZy) _UFOBaseIOc |jjt|dgj}|j S#tj j tj jf$rYywxYw)a Returns the modification time for the file at the given path, as a floating point number giving the number of seconds since the epoch. The path must be relative to the UFO path. Returns None if the file does not exist. details) namespacesN)fsgetinformodified timestamperrorsMissingInfoNamespaceResourceNotFound)selfpathdts r*getFileModificationTimez"_UFOBaseIO.getFileModificationTime{sd "$YKHQQB<<> ! .. 0J0JK  s1A7A=<A=Nc l |jj|d5}tj|cdddS#1swYyxYw#tjj $r#|t d|d|jd|cYSt$r#}t d|d|jd|d}~wwxYw)a Read a property list relative to the UFO filesystem's root. Raises UFOLibError if the file is missing and default is None, otherwise default is returned. The errors that could be raised during the reading of a plist are unpredictable and/or too large to list, so, a blind try: except: is done. If an exception occurs, a UFOLibError will be raised. rbN'z' is missing on z. This file is requiredz' could not be read on : )r5openrloadr9r;r Exception)r<fileNamedefaultfes r* _getPlistz_UFOBaseIO._getPlists Sh- (}}Q' ( ( (yy)) !FNPTPWPWX S(+B477)2aSQR R Ss7A = A AA A =B3B3B..B3c F|jrm tj|}|j j |r||j j|k(ry|j j||y|j j|d5} tj|| dddy#t$r#}t d|d|j d|d}~wwxYw#t$r#}t d|d|j d|d}~wwxYw#1swYyxYw)a Write a property list to a file relative to the UFO filesystem's root. Do this sort of atomically, making it harder to corrupt existing files, for example when plistlib encounters an error halfway during write. This also checks to see if text matches the text that is already in the file at path. If so, the file is not rewritten so that the modification date is preserved. The errors that could be raised during the writing of a plist are unpredictable and/or too large to list, so, a blind try: except: is done. If an exception occurs, a UFOLibError will be raised. rBz' could not be written on z- because the data is not properly formatted: Nw)mode) _havePreviousFilerdumpsrFr r5exists readbytes writebytesopenbindump)r<rGobjrrJfps r* _writePlistz_UFOBaseIO._writePlists  ! ! ~~c* ww~~h'DDGG4E4Eh4O,O GG  x .4 MM#r*   !@H$''STV !%$TWWa1  sAB9DC(9 C%C  C%( D1DDDD N)r"r#r$r?rKrXr(r)r*r1r1zs "S0"r)r1c.eZdZdZd&dZdZeedZdZeedZ edZ d Z ee d Z d Z d Zd'dZd'dZd'dZdZd'dZd'dZdZd'dZdZd'dZd'dZdZdZd'dZd'dZd(dZd)dZdZ d'd Z!d!Z"d'd"Z#d#Z$d$Z%d%Z&y )*raGRead the various components of a .ufo. Attributes: path: An `os.PathLike` object pointing to the .ufo. validate: A boolean indicating if the data read should be validated. Defaults to `True`. By default read data is validated. Set ``validate`` to ``False`` to not validate the data. ct|dr|j}t|tr$t |} |t j ur#tjj|dd}ntjj|}|t j ur|jdDcgc])}|j r|j"dk7r |j"+}}t%|d k(r4|j'|d tj(j* |_ntd t%|z||_d |_||_nt|tj0j2rI|} |j5||_ |j9d}d|_t j<|_n!t?dtA|jBztE||_#||_$d|_% |jM|y#tjj$r}td|d|d}~wwxYwcc}w#tjj6$rtd|zwxYw#tjj:$rt|}YwxYw#t$r|jOwxYw)N __fspath__Futf-8writeencodingunable to open 'z': /__MACOSXrrfactory+Expected exactly 1 root directory, found %dTthe filesystem '%s' is closedz7Expected a path string or fs.base.FS object, found '%s'validate)(hasattrr\ isinstancestr_sniffFileStructurerr.r5zipfsZipFSosfsOSFSr9 CreateFailedr scandiris_dirnamelenopendirsubfs ClosingSubFS _shouldClose_fileStructurebaseFScheckFilesystemClosed getsyspath NoSysPathr/ TypeErrortyper"r_path _validate_upConvertedKerningData readMetaInfoclose) r<r=ri structureparentFSrJprootDirs filesystems r*__init__zUFOReader.__init__s 4 &??$D dC +D1I C 0 4 44!xx~~d%'~RH!ww||D1H,000 &--c2xxAFFj$8FF x=A%'..  RXX-B-B/DG&EH U #!%D "+D  bggjj )J %  "% '!,,S1 !&D "2":":D It*%%& d^ !'+$    x  0s99)) C!$4TF#aS"ABB C 699-- J!"AD"HII J 99&& ': '&  JJL  sHAH3.I9I I<?J+I/II ,I9<(J('J(+KcRddl}|jdtd|jS)NrzBThe 'path' attribute is deprecated; use the 'fs' attribute insteadr  stacklevel)warningswarnDeprecationWarningrr<rs r* _get_pathzUFOReader._get_path"s+ P   zzr)z!The path of the UFO (DEPRECATED).doccfddl}|jdtd|jjS)NrzIThe 'formatVersion' attribute is deprecated; use the 'formatVersionTuple'r r)rrr_formatVersionmajorrs r*_get_formatVersionzUFOReader._get_formatVersion.s3 W   ""(((r)zIThe (major) format version of the UFO. DEPRECATED: Use formatVersionTuplec|jS)z|The (major, minor) format version of the UFO. This is determined by reading metainfo.plist during __init__. )rr<s r*formatVersionTuplezUFOReader.formatVersionTuple=s """r)c|jSrY)r{rs r*_get_fileStructurezUFOReader._get_fileStructureDs"""r)zVThe file structure of the UFO: either UFOFileStructure.ZIP or UFOFileStructure.PACKAGEc2|jr[|j}||jdk7r td|j}||jdk7r tdy |j}|rd}t |t s t||j D]]\}}t |ts t|t |ts t||D]}t |trt|_t i|ji||_t|jdt|jd|j\} }} | |jd<||jd<| |jd <y ) ap Up convert kerning and groups in UFO 1 and 2. The data will be held internally until each bit of data has been retrieved. The conversion of both must be done at once, so the raw data is cached and an error is raised if one bit of data becomes obsolete before it is called. ``validate`` will validate the data. originalKerningzSThe data in kerning.plist has been modified since it was converted to UFO 3 format.originalGroupszRThe data in groups.plist has been modified since it was converted to UFO 3 format.z'groups.plist is not properly formatted.)kerningrgroupsrrrgroupRenameMapsN) r _readKerningr _readGroupsrkdictitemsrllistr r getGlyphSet) r<ri testKerning testGroupsrinvalidFormatMessage groupName glyphList glyphNamerconversionMapss r*_upConvertKerningzUFOReader._upConvertKerningQs  ' '++-Kd::;LMM!i))+JT99:JKK!hL %%'F'P$!&$/%&:;;,2LLND(Iy%i5)*>??' 48)*>??%.D ))S9"-.B"CCD D,0 $ 1 1 3% ,D (/T,,->?556FGH  "/ +GV^ 7>D ( ( 35;D ( ( 2>LD ( (): ;r)c |jjt|S#tjj$rYywxYw)z Returns the bytes in the file at the given path. The path must be relative to the UFO's filesystem root. Returns None if the file does not exist. N)r5rRrr9r;)r<r=s r*readBytesFromPathzUFOReader.readBytesFromPaths<  77$$Xd^4 4yy))  s#&AANct|} ||jj|S|jj|d|S#tjj $rYywxYw)a Returns a file (or file-like) object for the file at the given path. The path must be relative to the UFO path. Returns None if the file does not exist. By default the file is opened in binary mode (reads bytes). If encoding is passed, the file is opened in text mode (reads str). Note: The caller is responsible for closing the open file. NrrNr`)rr5rTrDr9r;)r<r=r`s r*getReadFileForPathzUFOReader.getReadFileForPaths`~ wwt,,ww||DsX|FFyy))  sAAA('A(c | |j}|jt}|rt|ts t d |d}|jdd} t||f}||d <|S#t $r t dtd|jwxYw#t$rb}d|d |d td|j}|rdd l m }|||tj}tjd ||Yd}~d}~wwxYw)z Read metainfo.plist and return raw data. Only used for internal operations. ``validate`` will validate the read data, by default it is set to the class's validate value, can be overridden. Nz)metainfo.plist is not properly formatted. formatVersionz#Missing required formatVersion in '' on formatVersionMinorrzUnsupported UFO format (.z) in 'UnsupportedUFOFormatz^%s. Assuming the latest supported version (%s). Some data may be skipped or parsed incorrectlyr)rrKMETAINFO_FILENAMErkrr KeyErrorr5 setdefaultr ValueErrorfontTools.ufoLib.errorsrrHloggerwarning) r<rirformatVersionMajorrrrJunsupportedMsgrs r* _readMetaInfozUFOReader._readMetaInfos<  ~~H~~/0 JtT2IJ J !%o!6  "__-A1E ,.@BT-UVM$&3 !" 5 56G5HdggYW   *+=*>a@R?ST()twwi9 H*>:A,446M NNA    s%A. B.)B D#ADDc<|j|}|d|_y)z Read metainfo.plist and set formatVersion. Only used for internal operations. ``validate`` will validate the read data, by default it is set to the class's validate value, can be overridden. rhrN)rrr<rirs r*rzUFOReader.readMetaInfos%!!8!4"#78r)c|jti}|jD]8\}}|jdst t j |||<:|S)N)z public.kern1.z public.kern2.)rKGROUPS_FILENAMEr startswithrrfromkeys)r<rrrs r*rzUFOReader._readGroupss^4$*LLN J Iy##$FG$()=)=i)H$Iy! J r)c| |j}|jtjkr!|j ||j d}n|j }|rt|\}}|s t||S)z Read groups.plist. Returns a dict. ``validate`` will validate the read data, by default it is set to the class's validate value, can be overridden. r) rrrr'rrrgroupsValidatorr )r<rirvalidmessages r* readGroupszUFOReader.readGroupssz  ~~H   !1!>r)cl|jti}|rt|ts t d|S)Nz)fontinfo.plist is not properly formatted.)rKFONTINFO_FILENAMErkrr rs r* _readInfozUFOReader._readInfos0~~/4 JtT2IJ J r)c|| |j}|j|}i}|jtjk(r;t D]}|j |}||||<t|}t|}n|jtjk(rJttjD]\}}|j |}||||< t|}n|jjtjjk(r?ttjD]\}}|j |}||||< nt!|j|r t#|}t|jD]\}} t%|||y#t&$rt)d|zwxYw)a| Read fontinfo.plist. It requires an object that allows setting attributes with names that follow the fontinfo.plist version 3 specification. This will write the attributes defined in the file into the object. ``validate`` will validate the read data, by default it is set to the class's validate value, can be overridden. NzMThe supplied info object does not support setting a necessary attribute (%s).)rrrrr%rget&_convertFontInfoDataVersion1ToVersion2&_convertFontInfoDataVersion2ToVersion3r&r#fontInfoAttributesVersion2ValueDatarrr'#fontInfoAttributesVersion3ValueDataNotImplementedErrorvalidateInfoVersion3DatasetattrAttributeErrorr )r<inforiinfoDict infoDataToSetattrvaluedataValidationDicts r*readInfozUFOReader.readInfos  ~~H>>(+   "2"="= =2 0 T*$*/M$' 0C=QMB=QM  $4$?$? ?,0399;- ,((! T*=&+ d#  ,C=QM  & &*:*E*E*K*K K,0399;- ,((! T*=&+ d#  ,&d&9&9: : 4]CM 3 3 56 KD% dE* " !c s  F##F;c2|jti}|SrY)rKKERNING_FILENAME)r<rs r*rzUFOReader._readKerningWs~~.3 r)c<| |j}|jtjkr!|j ||j d}n|j }|rt|\}}|s t|i}|D]}||D]}|||}||||f<|S)z Read kerning.plist. Returns a dict. ``validate`` will validate the kerning data, by default it is set to the class's validate value, can be overridden. r) rrrr'rrrkerningValidatorr ) r<ri kerningNestedrrrleftrightrs r* readKerningzUFOReader.readKerning[s  ~~H   !1! A AA A A*)A*c|jtjkr ttfgS|j t }|r&t||j\}}|s t||S)z Rebuild the layer contents list by checking what glyphsets are available on disk. ``validate`` will validate the layer contents. ) rrr'DEFAULT_LAYER_NAMEDEFAULT_GLYPHS_DIRNAMErKLAYERCONTENTS_FILENAMElayerContentsValidatorr5r )r<ricontentsrerrors r*_readLayerContentszUFOReader._readLayerContentssa   !1!>"89 1(DGGDLE5!%((r)cx| |j}|j|}|Dcgc]\}}| }}}|Scc}}w)z Get the ordered layer names from layercontents.plist. ``validate`` will validate the data, by default it is set to the class's validate value, can be overridden. )rr )r<ri layerContents layerName directoryName layerNamess r* getLayerNameszUFOReader.getLayerNamessG  ~~H//9 @MN$>L   NNM  00,0GI // = 5B  1O1O+0    FRS S U3J !00%'#   yy)) UYK/FykQRST T Us .B 0Cc| |j}|j||d}|j}i}|jD]+\}}|D]!}||vr||j ||g||<#-|S)zf Return a dictionary that maps unicode values (ints) to lists of glyph names. T)rr)rr getUnicodesrappend) r<r riglyphSet allUnicodescmaprunicodescodes r*getCharacterMappingzUFOReader.getCharacterMappings  ~~H## HD$ **, #.#4#4#6 - Ix  -4<J%%i0"+DJ  - -  r)c |jjt|_ |jjjDcgc]}|jdc}S#tjj $rgcYStjj $r tdwxYwcc}w#tjj$rgcYSwxYw)z Returns a list of all files in the data directory. The returned paths will be relative to the UFO. This will not list directory names, only file names. Thus, empty directories will be skipped. z6The UFO contains a "data" file instead of a directory.rb) r5rw DATA_DIRNAME_dataFSr9r;DirectoryExpectedr walkfileslstrip ResourceError)r<rs r*getDataDirectoryListingz!UFOReader.getDataDirectoryListings X77??<8DL  ,0<<+<+<+B+B+DEaAHHSME Eyy)) Iyy** XVW W X Fyy&& I s4$A(&B9 B4%B9(B1 (B14B99CCc|jtjkrgS| |j} |jj t x|_}g}|jdD]~}|jr|rR|j|j5}t!|\}}dddsH|j#|jd|j#|j|S#tjj$rgcYStjj$r tdwxYw#1swYxYw)a$ Returns a list of all image file names in the images directory. Each of the images will have been verified to have the PNG signature. ``validate`` will validate the data, by default it is set to the class's validate value, can be overridden. Nz9The UFO contains an "images" file instead of a directory.rb)fileObj)rrr'rr5rwIMAGES_DIRNAME _imagesFSr9r;r,r rsrtrTru pngValidatorr")r<riimagesFSresultr=rWrr s r*getImageDirectoryListingz"UFOReader.getImageDirectoryListings   !1!>%%h/D 'T2LE5!%(( " ;77??>: ;yy)) P 5hZuTWWINO O Ps* B(C(CCCC9DcR|jr|jjyyrY)rzr5rrs r*rzUFOReader.closejs    GGMMO r)c|SrYr(rs r* __enter__zUFOReader.__enter__ns r)c$|jyrY)r)r<exc_type exc_valueexc_tbs r*__exit__zUFOReader.__exit__qs  r))TrY)NNNNN)'r"r#r$__doc__rrpropertyr=rrrr fileStructurerrrrrrrrrrrrrrr rrrr(r1r9r<r?rrBrGr(r)r*rrs GV I#F GD) WM ## # FM2Ml *(T9*?8 7v<$  V ' R,*"H :r)rceZdZdZ ddZdZeedZdZdZ d dZ d!d Z e Z d Z d Zd Zd"d Zd"dZd"dZd"dZd"dZd#dZdZ d$dZ d%dZ d&dZd'dZdZdZdZd"dZd"dZd"dZ fdZ!xZ"S)(ra=Write the various components of a .ufo. Attributes: path: An `os.PathLike` object pointing to the .ufo. formatVersion: the UFO format version as a tuple of integers (major, minor), or as a single integer for the major digit only (minor is implied to be 0). By default, the latest formatVersion will be used; currently it is 3.0, which is equivalent to formatVersion=(3, 0). fileCreator: The creator of the .ufo file. Defaults to `com.github.fonttools.ufoLib`. structure: The internal structure of the .ufo file: either `ZIP` or `PACKAGE`. validate: A boolean indicating if the data read should be validated. Defaults to `True`. By default, the written data will be validated before writing. Set ``validate`` to ``False`` if you do not want to validate the data. Validation can also be overriden on a per-method level if desired. Raises: UnsupportedUFOFormat: An exception indicating that the requested UFO formatVersion is not supported. c t|}t |dr|j }t |trtjj|}tjj|}|r2t|} |" t|}|| urutd| d|d| }n`|tj}tjj!|} | r-tjj#| std |z|tj$ur|rt&j(j+} t&j,j/|d 5} t&j0j3| | ddd| j5d D cgc])} | j6r| j8d k7r | j8+}} t;|dk7rtdt;|z| j=|dt&j>j@|_ntjjCtjjE|ddz}t&j,j/|dd } | jG|| j=|t&j>j@|_n&t&jHjK|d|_||_&||_'d|_(nt |t&jRjTr|} |jW||_ |j]d }|r.|tjurddl0}|jcdtddtj|_&|jtf|_'d|_(n!tidtk|jlzto||_8||_9||_:d|_;||_<d}|jNr1|j{|}|d}||kDrddlm}|d|d|di|_>|/|j~d k\r t|j||_>n0|j&jtrtti|_>|jy#t$r}ddlm}|d||d}~wwxYw#t$rtd|zwxYw#1swYxYwcc} w#t&jXjZ$rtd|zwxYw#t&jXj^$rt|}YwxYw)!NrrzUnsupported UFO format: r\z&Invalid or unsupported structure: '%s'z"A UFO with a different structure (z%) already exists at the given path: 'rBz.Cannot write to '%s': directory does not existr]rrbrcrrfrd.ufoTr^creatergz?The 'structure' argument is not used when input is an FS objectr rFz-Expected a path string or fs object, found %srhrz2The UFO located at this path is a higher version (z) than the version (z6) that is trying to be written. This is not supported.r!)Errrrrjr\rkrlosr=normpathrQrmrr r/dirnameisdirr.r5tempfsTempFSrnrocopycopy_fsrsrtrurvrwrxrysplitextbasenamemakedirrprqr{rOrzr|r}r~r9rrrrr UserWarningrrrr"rrr _fileCreator_downConversionKerningDatarrr rrr rr_writeMetaInfo)r<r=r fileCreatorrrirJrhavePreviousFileexistingStructuredirNamerorigFSrrrootDirrrpreviousFormatVersionmetaInfos r*rzUFOWriter.__init__s ,];M 4 &??$D dC 77##D)D!ww~~d3 $7$=!($4Y$? !(99)9JDR !2I$ 0 8 8I''//$/277==#9%H4O,000# "yy//1Hw?:69:"*!1!1#!6 88*(< H  8}))I!(m,#+"2"2$QK1F1F#3# !gg..rww/?/?/EFqIFRG!xx~~d$~QH$$W-&..w@U@U.VDG'',,tD,9"+D %5D " $D  bggjj )J %  "% '!,,S1 Y.>.F.FF U  #3":":D %/%6%67H%ID " %D ?$t*BUBUU  d^ +'*.'!!%  ! !))8)>( #AHLM M 2TB 99??: & GG  VYY DGGX F GG  fiiTWWh Gr)c&t|}|jr:|jj|r||jj |k(ry |jj ||y#tj j$rtd|ztj j$rY|jjtjj|d|jj ||YywxYw)ae Write bytes to a path relative to the UFO filesystem's root. If writing to an existing UFO, check to see if data matches the data that is already in the file at path; if so, the file is not rewritten so that the modification date is preserved. If needed, the directory tree for the given path will be built. NzA directory exists at '%s'Trk) rrOr5isfilerRrSr9 FileExpectedr r;rmr=rS)r<r=rs r*writeBytesToPathzUFOWriter.writeBytesToPathQs~  ! !ww~~d#0A0A$0G(G + GG  tT *yy%% C:TAB Byy)) + GG  RWW__T2T  B GG  tT * +sA00BDDc &t|} |jj|||S#tjj$r}|d}|dk(rYd}~y|dk(s |dk(s|dk(r]|jj tj j|d |jj|||cYd}~SYd}~yd}~wtjj$r(}td |d |jd |cYd}~Sd}~wwxYw) ag Returns a file (or file-like) object for the file at the given path. The path must be relative to the UFO path. Returns None if the file does not exist and the mode is "r" or "rb. An encoding may be passed if the file is opened in text mode. Note: The caller is responsible for closing the open file. rrrNrMaxTrkrarrC) rr5rDr9r;rmr=rSr0r )r<r=rNr`rJms r*getFileObjectForPathzUFOWriter.getFileObjectForPathes~ M77<<4(<C Cyy)) HQACxcQ#Xc  !6 Fww||Dth|GG*2yy&& M!1$uTWWIRsKL L Ms4+D CA&C=D D(D D Dct|} |jj||rMtjj|}|r+tjj|j|yyy#tjj$r|jj |Ytjj $r |std|d|jYwxYw)a_ Remove the file (or directory) at path. The path must be relative to the UFO. Raises UFOLibError if the path doesn't exist. If force=True, ignore non-existent paths. If the directory where 'path' is located becomes empty, it will be automatically removed, unless 'removeEmptyParents' is False. rBz' does not exist on N) rr5remover9rv removetreer;r r=rStools remove_empty)r<r=forceremoveEmptyParentsparents r* removePathzUFOWriter.removePath~s~ K GGNN4 WW__T*F%%dggv6  yy%% % GG  t $yy)) K!AdV+?y"IJJ KsA888C.29C.-C.c|j}|8tjj|r tj|dyyy#t $r }t jd|Yd}~yd}~wwxYw)z Set the UFO modification time to the current time. This is never called automatically. It is up to the caller to call this when finished working on the UFO. NzFailed to set modified time: %s)rrQr=rQutimeOSErrorrr)r<r=rJs r*setModificationTimezUFOWriter.setModificationTimesd zz  t 4 Et$!5  E@!DD EsA A1A,,A1ct|j|jj}|jjdk7r|jj|d<|j t |y)N)creatorrrr)rr]rrminorrXr)r<rgs r*r_zUFOWriter._writeMetaInfosb%%--33     $ $ )-1-@-@-F-FH) * *H5r)c|jtjk\ryi}dD]+}t||j D] \}}|||< -t ||_y)aW Set maps defining the renaming that should be done when writing groups and kerning in UFO 1 and UFO 2. This will effectively undo the conversion done when UFOReader reads this data. The dictionary should have this form:: { "side1" : {"group name to use when writing" : "group name in data"}, "side2" : {"group name to use when writing" : "group name in data"} } This is the same form returned by UFOReader's getKerningGroupConversionRenameMaps method. Nr)groupRenameMap)rrr'rrrr^)r<mapsremapside writeNamedataNames r*#setKerningGroupConversionRenameMapsz-UFOWriter.setKerningGroupConversionRenameMapssn   "2"="= = & ,D'+DJ,<,<,>'? ,# 8"+h , ,+/e*D'r)cT| |j}|rt|\}}|s t||jtj krz|j n|j d}i}t|jD]\}}||vr |||<t|jD]\}}||vr ||}|||<|}i} |jD]\} } t| | | <| r|jt| y|jr|jtddyy)z Write groups.plist. This method requires a dict of glyph groups as an argument. ``validate`` will validate the data, by default it is set to the class's validate value, can be overridden. NrTFrr) rrr rrr'r^rrrXrrOr) r<rrirrrremappedGroupsrur groupsNewkeyrs r* writeGroupszUFOWriter.writeGroupssB  ~~H ,V4NE7!'**   "2"="= =//;334DEEN#'v||~"6 0h5='/t$ 0#'v||~"6 0hu$T{'/t$  0 $F  ,,. )JC!%[IcN )    _i 8  # # OOO4EO R$r)cV| |j}i}ttjD]$}t ||s t ||}| |||<&|jtjk(r|rt|}nv|jtjk(rt|}|rLt|}n@|jtjk(r#t|}|r t|}t!|}|r|j#t$|yy#t $rtd|zwxYw)a Write info.plist. This method requires an object that supports getting attributes that follow the fontinfo.plist version 2 specification. Attributes will be taken from the given object and written into the file. ``validate`` will validate the data, by default it is set to the class's validate value, can be overridden. NzMThe supplied info object does not support getting a necessary attribute (%s).)rrrkeysrjgetattrrr rrr'rr&&_convertFontInfoDataVersion3ToVersion2validateInfoVersion2Datar%&_convertFontInfoDataVersion2ToVersion1rXr)r<rriinfoDatarrs r* writeInfozUFOWriter.writeInfos,  ~~H<AACD 'DtT"#D$/E =!& '   "2"="= =3H=  $4$?$? ?=hGH3H=  $4$?$? ?=hGH3H==hGH    . 9 -&%gs DD(c| |j}|rd}t|s t|t|j D]\}}t |tt fs t|t|dk(s t|t |dts t|t |dts t|t |trt||jtjkrn|jb|jd}i}t|j D]3\\}} }|j||}|j| | } |||| f<5|}i} |jD]\} } || | f}| | vri| | <|| | | <| r|j!t"| y|j$r|j't"dd yy) a Write kerning.plist. This method requires a dict of kerning pairs as an argument. This performs basic structural validation of the kerning, but it does not check for compliance with the spec in regards to conflicting pairs. The assumption is that the kerning data being passed is standards compliant. ``validate`` will validate the data, by default it is set to the class's validate value, can be overridden. Nz&The kerning is not properly formatted.r rrrTFr)r isDictEnoughr rrrktuplervrlr rrr'r^rrrXrrOr) r<rrirpairrrremappedKerningrr kerningDictrrs r* writeKerningzUFOWriter.writeKerning2s  ~~H #K (!"677#GMMO4 < e!$u 6%&:;;4yA~%&:;;!$q'3/%&:;;!$q'3/%&:;;!%5%&:;; <   "2"="= =//;334DEE O)-gmmo)> 6% %/ %/05u - 6&G "<<> -KD%D%K(E;&$& D!',K e $  -    -{ ;  # # OO,DUO S$r)c| |j}|rt|\}}|s t||r|jt|y|j r|j tddyy)z Write lib.plist. This method requires a lib dict as an argument. ``validate`` will validate the data, by default it is set to the class's validate value, can be overridden. NTFr)rrr rXrrOr)r<libDictrirrs r*writeLibzUFOWriter.writeLibkse  ~~H -g6NE7!'**    \7 3  # # OOLO O$r)cD| |j}|jtjk(r t d|rt |t s t d|r&|jt|jdy|jr|jtddyy)zd Write features.fea. This method requires a features string as an argument. Nz4features.fea is not allowed in UFO Format Version 1.zThe features are not text.utf8TFr) rrrr%r rkrlrwrencoderOr)r<featuresris r* writeFeatureszUFOWriter.writeFeaturess  ~~H   "2"="= =TU U h,!">??   ! !"3X__V5L M  # # OO-TeO T$r)c| |j}|jtjkry|%g}|D]}|t}|j ||}n#t |jj}|r:t|t|jjk7r td|Dcgc]}||j|f}}|jt|ycc}w)z Write the layercontents.plist file. This method *must* be called after all glyph sets have been written. NzMThe layer order content does not match the glyph sets that have been created.) rrrr'rr"rr rsetr rXr)r< layerOrderrinewOrderr r s r*writeLayerContentszUFOWriter.writeLayerContentss  ~~H   !1!Could not locate a glyph set directory for the layer named %s.)rr rrr )r<r foundDirectoryexistingLayerNamers r*_findDirectoryForLayerNamez$UFOWriter._findDirectoryForLayerNames{04T5G5G5M5M5O0P  , } ]6L%L!."i/!.  P r)ct| |j}| |j}|jtjkr'|r|#t d|jj d|9|r7|j jD]\}}|tk(s|}|t}n| |s t d|jtjkr|j||||S|jj tjj k(r|j||||||St|j)aW Return the GlyphSet object associated with the appropriate glyph directory in the .ufo. If layerName is None, the default glyph set will be used. The defaultLayer flag indictes that the layer should be saved into the default glyphs directory. ``validateRead`` will validate the read data, by default it is set to the class's validate value, can be overridden. ``validateWrte`` will validate the written data, by default it is set to the class's validate value, can be overridden. ``expectContentsFile`` will raise a GlifLibError if a contents.plist file is not found on the glyph set file system. This should be set to ``True`` if you are reading an existing UFO and ``False`` if you use ``getGlyphSet`` to create a fresh glyph set. z,Only the default layer can be writen in UFO rz5A layer name must be provided for non-default layers.)glyphNameToFileNameFuncr)r  defaultLayerrr) rrrr'r rr rrr_getDefaultGlyphSet_getGlyphSetFormatVersion3r) r<r rrrrrrrs r*rzUFOWriter.getGlyphSets\4  >>L   NNM   !1!t?R?R?X?X>YYZ[   040B0B0H0H0J 2,!9 66 1I 2 .  |UV V   !1! (19% $;!00%'1   LsDc|jtjkry||k(r2|j|tk7r|sy|j|tk(rT|rRy|t }||jvrt d|z|r+t|jjvr t d|j|}|rt}nC|jjDchc]}|j}}t||d}|j|=||j|<|jj||dycc}w)z Rename a glyph set. Note: if a GlyphSet object has already been retrieved for layerName, it is up to the caller to inform that object that the directory it represents has changed. Nz A layer named %s already exists.zA default layer already exists.rrTrO) rrr'r rrr rrrrr5movedir)r<r  newLayerNamer oldDirectory newDirectoryrurs r*renameGlyphSetzUFOWriter.renameGlyphSetIs<   !1!?r)c(| |j}|jtjkr#t d|jj dt |}|rt|\}}|s t ||jtd||y)zg Write data to fileName in the images directory. The data must be a valid PNG. NImages are not allowed in UFO rr>rb) rrrr'r rrr6rwr4)r<rGrrirr s r* writeImagezUFOWriter.writeImages  ~~H   !1!*!HX,>+?@Ar)c| |j}|jtjkr#t d|jj dt dt|}t dt|}|j|||y)z Copy the sourceFileName in the provided UFOReader to destFileName in this writer. This uses the most memory efficient method possible for copying the data possible. Nrrrb) rrrr'r rr4rrs)r<rpsourceFileName destFileNamerirqrrs r*copyImageFromReaderzUFOWriter.copyImageFromReaders  ~~H   !1!? FJ9r)c|jr|jtjurtj j tj j|jddz}tjj|jdd5}tjj|j|j|dddt|Ay#1swYxYw)NrrNTr]r^)rOr{rr.rQr=rYrZrr5rnrorWrXr[superr)r<redestFS __class__s r*rzUFOWriter.closes  ! !d&9&9=M=Q=Q&Qgg&&rww'7'7 'CDQG&PG $I BV)@A B   B Bs ":C33C<)Nzcom.github.fonttools.ufoLibNT)rMN)FTrYrH)NTNNNF)NF)NTNF)F)#r"r#r$rIrrirJr`rsrwr|rremoveFileForPathrr_rrrrrrrrrrrrrrrrrrr __classcell__)rs@r*rrzs41 Z|! [KH.+(M27.# E 6E23Sn*:\5TrP*U&@6$ $ @;L!%  . $ 4 l.A` *L@D$ B: r)rc tj|rtjStj j |rtjStj j|rtd|ztd|z)zReturn UFOFileStructure.ZIP if the UFO at path 'ufo_path' (str) is a zip file, else return UFOFileStructure.PACKAGE if 'ufo_path' is a directory. Raise UFOLibError if it is a file with unknown structure, or if the path does not exist. z7The specified UFO does not have a known structure: '%s'zNo such file or directory: '%s') zipfile is_zipfilerr.rQr=rTr/rur )ufo_paths r*rmrmsr(#### x '''  ! E P  ;hFGGr)ctjj|\}}djdj|jddddg}tjj||S)a" Return a .ufo pathname. >>> makeUFOPath("directory/something.ext") == ( ... os.path.join('directory', 'something.ufo')) True >>> makeUFOPath("directory/something.another.thing.ext") == ( ... os.path.join('directory', 'something.another.thing.ufo')) True rNufo)rQr=splitjoin)r=dirrus r*r r sZ d#IC 88SXXdjjocr23U; (noteyearfondIDnoticelicensexHeightascenderdesignerfondNamefontNamefullNamemenuNamettVendoruniqueID capHeight copyright createdBy descender fontStyle msCharSet otMacName styleName trademark ttVersion vendorURL widthName familyName licenseURL slantAngle ttUniqueID unitsPerEm weightName designerURL italicAngle otStyleName weightValue defaultWidth otFamilyName versionMajor versionMinorr")rrstyleMapFamilyNamestyleMapStyleName)rrr.r/r rrr&rr rrr)ropenTypeHeadCreatedopenTypeHeadLowestRecPPEMopenTypeHeadFlags integerList)rrropenTypeHheaAscenderopenTypeHheaDescenderopenTypeHheaLineGapopenTypeHheaCaretSlopeRiseopenTypeHheaCaretSlopeRunopenTypeHheaCaretOffsetopenTypeNameDesigneropenTypeNameDesignerURLopenTypeNameManufactureropenTypeNameManufacturerURLopenTypeNameLicenseopenTypeNameLicenseURLopenTypeNameVersionopenTypeNameUniqueIDopenTypeNameDescriptionopenTypeNamePreferredFamilyName"openTypeNamePreferredSubfamilyNameopenTypeNameCompatibleFullNameopenTypeNameSampleTextopenTypeNameWWSFamilyNameopenTypeNameWWSSubfamilyNameopenTypeOS2WidthClassopenTypeOS2WeightClassopenTypeOS2SelectionopenTypeOS2VendorIDopenTypeOS2PanoseopenTypeOS2FamilyClassopenTypeOS2UnicodeRangesopenTypeOS2CodePageRangesopenTypeOS2TypoAscenderopenTypeOS2TypoDescenderopenTypeOS2TypoLineGapopenTypeOS2WinAscentopenTypeOS2WinDescentopenTypeOS2TypeopenTypeOS2SubscriptXSizeopenTypeOS2SubscriptYSizeopenTypeOS2SubscriptXOffsetopenTypeOS2SubscriptYOffsetopenTypeOS2SuperscriptXSizeopenTypeOS2SuperscriptYSizeopenTypeOS2SuperscriptXOffsetopenTypeOS2SuperscriptYOffsetopenTypeOS2StrikeoutSizeopenTypeOS2StrikeoutPositionopenTypeVheaVertTypoAscenderopenTypeVheaVertTypoDescenderopenTypeVheaVertTypoLineGapopenTypeVheaCaretSlopeRiseopenTypeVheaCaretSlopeRunopenTypeVheaCaretOffsetpostscriptFontNamepostscriptFullNamepostscriptSlantAnglepostscriptUniqueIDpostscriptUnderlineThicknesspostscriptUnderlinePositionpostscriptIsFixedPitchpostscriptBlueValuespostscriptOtherBluespostscriptFamilyBluespostscriptFamilyOtherBluespostscriptStemSnapHpostscriptStemSnapVpostscriptBlueFuzzpostscriptBlueShift) postscriptBlueScalepostscriptForceBoldpostscriptDefaultWidthXpostscriptNominalWidthXpostscriptWeightNamepostscriptDefaultCharacterpostscriptWindowsCharacterSetmacintoshFONDFamilyIDmacintoshFONDNameopenTypeGaspRangeRecordsdictListopenTypeNameRecordswoffMajorVersionwoffMinorVersionwoffMetadataUniqueIDwoffMetadataVendorwoffMetadataCredits)woffMetadataDescriptionwoffMetadataLicensewoffMetadataCopyrightwoffMetadataTrademarkwoffMetadataLicenseewoffMetadataExtensions guidelinesrcVi}t|jD] \}}|||< |SrY)rr)rflippedrrs r* _flipDictrs2G1779o U Nr)rrr(rr r r#rr%r r-r*rr'r|r+rrrrrzr~) rr rr,r$rrr!rregularitalicboldz bold italic)rr !rr r!rrrr) zUltra-condensedzExtra-condensed CondensedzSemi-condensedzMedium (normal)z Semi-expandedExpandedzExtra-expandedzUltra-expandedNormalAllmediumMediumM )ct|trt||k(r t|}||dk(r,tj |}|t d|d|d|}na|dk(r,t j |}|t d|d|d|}n0|dk(r+tj |}|t d|d|d|}tj ||}||fS)z Convert value from version 1 to version 2 format. Returns the new attribute name and the converted value. If the value is None, None will be returned for the new value. rCannot convert value () for attribute rr!r) rkfloatint_fontStyle1To2rr _widthName1To2_msCharSet1To2fontInfoAttributesVersion1To2rrvs r*rrs% u: JE  ; ""5)Ay!,UI5EdV1ME [ ""5)Ay!,UI5EdV1ME [ ""5)Ay!,UI5EdV1ME ( , ,T4 8D ;r)c|P|dk(rtj|}n5|dk(rtj|}n|dk(rtj|}tj||}||fS)z Convert value from version 2 to version 1 format. Returns the new attribute name and the converted value. If the value is None, None will be returned for the new value. r1rKr~)_fontStyle2To1r_widthName2To1_msCharSet2To1fontInfoAttributesVersion2To1rrs r*rr sq   & &"&&u-E , ,"&&u-E 4 4"&&u-E ( , ,T4 8D ;r)ci}t|jD]A\}}|dk(r|dk(rt||\}}|tvr)|t d|d|d|||<C|S)Nr+rrrr)rrrrr r convertedrrnewAttrnewValues r*rr sIDJJL)& e = Ub[ R %  4 4  =( 1A'!L & '%&& r)ci}t|jD]6\}}t||\}}|tvr|t d|d|d|||<8|S)Nrrr)rrrrr rs r*rr5 sIDJJL) & eR %  4 4  =( 1A'!L & ' & r)>r/rVrWr3>r8r6rVr7rWrUr;rSrhrarTr3rYrZr[r\r]r^rerbrcr_r`rdc|tvr t|}|t vr t t|}||fS|tvr5 tt|}|t |k(r t |}||k7r|}||fS#ttf$rt d|zwxYw#ttf$rt d|zwxYw#ttf$rt d|zwxYw)z Convert value from version 2 to version 3 format. Returns the new attribute name and the converted value. If the value is None, None will be returned for the new value. zCould not convert value for %s.) _ufo2To3FloatToIntroundrrr _ufo2To3NonNegativeIntrabs_ufo2To3NonNegativeIntOrFloatrrs r*6convertFontInfoValueForAttributeFromVersion2ToVersion3ro s   !! H%LE %% HE OE ; . . Hc%j!A A;AA :E ;!I& H?$FG G H I& H?$FG G H I& H?$FG G Hs! A7BB97BB69Cc ||fS)z Convert value from version 3 to version 2 format. Returns the new attribute name and the converted value. If the value is None, None will be returned for the new value. r(rs r*6convertFontInfoValueForAttributeFromVersion3ToVersion2r s ;r)ci}t|jD]"\}}t||\}}|tvr|||<$|SrY)rrrrrs r*rr sYIDJJL)& eR %  4 4 % ' & r)cti}t|jD]\}}t||\}}|||<|SrY)rrr)rrrrs r*rr sKIDJJL) eL % e $  r)__main__)rIrQrWrrloggingrenum collectionsrr5fs.basefs.subfs fs.errorsfs.copyfs.osfsfs.zipfs fs.tempfsfs.toolsfontTools.miscrfontTools.ufoLib.validatorsfontTools.ufoLib.filenamesrfontTools.ufoLib.convertersr rr fontTools.ufoLib.utilsr r __all__ __version__ getLoggerr"rrr*r4rrrrrrrLAYERINFO_FILENAMErrEnumr__str__rr1rrrrmr rrrrrrange fontInfoOpenTypeHeadFlagsOptions#fontInfoOpenTypeOS2SelectionOptions'fontInfoOpenTypeOS2UnicodeRangesOptions(fontInfoOpenTypeOS2CodePageRangesOptionsfontInfoOpenTypeOS2TypeOptionsrrrl"fontInfoStyleMapStyleNameValidatorrr$fontInfoOpenTypeHeadCreatedValidatorgenericIntListValidator&fontInfoOpenTypeOS2WidthClassValidator'fontInfoOpenTypeOS2WeightClassValidator*fontInfoVersion2OpenTypeOS2PanoseValidator'fontInfoOpenTypeOS2FamilyClassValidatorbool fontInfoPostscriptBluesValidator%fontInfoPostscriptOtherBluesValidator fontInfoPostscriptStemsValidator.fontInfoPostscriptWindowsCharacterSetValidatorrrrrrupdategenericNonNegativeIntValidator!genericNonNegativeNumberValidator*fontInfoVersion3OpenTypeOS2PanoseValidator)fontInfoOpenTypeGaspRangeRecordsValidator$fontInfoOpenTypeNameRecordsValidator%fontInfoWOFFMetadataUniqueIDValidator#fontInfoWOFFMetadataVendorValidator$fontInfoWOFFMetadataCreditsValidator(fontInfoWOFFMetadataDescriptionValidator$fontInfoWOFFMetadataLicenseValidator&fontInfoWOFFMetadataCopyrightValidator&fontInfoWOFFMetadataTrademarkValidator%fontInfoWOFFMetadataLicenseeValidator'fontInfoWOFFMetadataExtensionsValidatorguidelinesValidatorrrrdataDictrrrrrrrrrrrrrrrrrrrrrrdoctesttestmodr(r)r*rs& D  # #)9M/F "    8 $" $$  "".&%u4dii299tyyIIbg  g ^N  N dH& #64(4,$(a #5 &;#*.uQ}*='+/a +=(!3)VM'$C.M'3M'$C.M' !C M'DcNM'DcNM' DcNM'3M'3M'$S%L)M'C<(M't#u&M'C<(M' 3,'!M'"4eS\*#M'$ DcN%M'&4 !E'M', C!$C.?M'@ 3AM'Bt#u6CM'DDcNEM'Ft~GM'H#IM'J"4S>KM'L4S>MM'NdnOM'P4S>QM'RDcNSM'Tt~UM'V&t~WM'X)$C.YM'Z%dn[M'\dn]M'^ 3_M'`#DcNaM'bT !GcM'hd !HiM'nD .8oM'x4S>yM'z +U{M'@d +RAM'F .<!GM'P  .="QM'Zt#u6[M'\3, 7]M'^de 5_M'`DsEl3aM'bTU|4cM'dt .3eM'n CO TE O "4S>!O" #DcN#O$ !$C.%O& %F! 'O, %F" -O2 $Ts^3O4 $Ts^5O6 &t~7O8 &t~9O: &t~;O< &t~=O> (3?O@ (3AOB #DcNCOD '#EOF #D,U% GOL t,P MOR '#SOT (3UOV &t~WOX "4S>YOZ D%C [O` D%C aOf &K! gOl d&I mOr t&J sOx$(&N$  $&J "&&L" "&&L" !%&K! #'&M# 5HI]OQd!!D!I!I!KL>DDFG:ND(x'%9!":>DDFG:ND(x'%9!":!$!&!,!+ ! . ! $ !*!&!(! '!5!7!1!(!+! %!!"$#!$%%#-($$(07!:!**G H'*+H+M+M+O'P$H&mL>*q >*xuxxqqq      !"#$ ),>* !H"0*!88  zGOOr)