o hp @s dZddlZddlmZddlmZddlZddlZddlZddlm Z ddl Z ddl Z ddl Z ddl Z ddlZ ddlZ ddlZ ddlZ ddlZ ddlmZddlTddlmZdd lmZdd lmZdd lmZmZgd Zd Z e!e"Z#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.dZ/Gddde0eej1Z2ej3e2_3Gdddej1Z4GdddZ5Gd d!d!e5Z6Gd"d#d#e6Z7e7Z8d$d%Z9d&d'Z:d(d)Z;d*d+Ze?e@dd0ZAgd1ZBe?e@dd2ZCe?e@dd3ZDgd4ZEhd5ZFid6eGeHd7d8eGeHd7d9eGeHd7d:eGeHeId;deGeJd7d?eGeHd7d@eGeHd7dAeGeJeKfd7dBeGeJeKfd7dCeGeJeKfd7dDeGeJeKfd7dEeGeJeKfd7dFeGeKeJfd7dGeGeHd7dHeGeHeLd;idIeGeJeKfd7dJeGdKeMeAdLdMeGeJeKfd7dNeGeJeKfd7dOeGeJeKfd7dPeGeJd7dQeGeJd7dReGeJeKfd7dSeGeHd7dTeGeHd7dUeGeHd7dVeGeHd7dWeGeHd7dXeGeHd7dYeGeHd7dZeGeHd7d[eGeHd7id\eGeHd7d]eGeHd7d^eGeHd7d_eGeHd7d`eGeHd7daeGeHd7dbeGeJeNd;dceGeJeOd;ddeGdKeMeBdLdeeGeHd7dfeGdKePd;dgeGdKeQd;dheGdKeMeCdLdieGdKeMeDdLdjeGeJeKfd7dkeGeJeKfd7dleGeJeKfd7idmeGeJeKfd7dneGeJeKfd7doeGdKeMeEdLdpeGeJeKfd7dqeGeJeKfd7dreGeJeKfd7dseGeJeKfd7dteGeJeKfd7dueGeJeKfd7dveGeJeKfd7dweGeJeKfd7dxeGeJeKfd7dyeGeJeKfd7dzeGeJeKfd7d{eGeJeKfd7d|eGeJeKfd7d}eGeJd7id~eGeJd7deGeJeKfd7deGeHd7deGeHd7deGeKeJfd7deGeJd7deGeJeKfd7deGeJeKfd7deGeRd7deGdKeSd;deGdKeTd;deGdKeSd;deGdKeTd;deGdKeUd;deGdKeUd;deGeJeKfd7deGeJeKfd7eGeKeJfd7eGeRd7eGeJeKfd7eGeJeKfd7eGeHd7eGeHd7eGeJeVd;eGeJd7eGeHd7d ZWeXeWYZZeeWZ[e[\id=eGeJe]d;dAeGeJeKfe^d;dIeGeJe^d;dMeGeJd7dNeGeJd7dOeGeJd7dReGeJd7dfeGdKe_d;djeGeJd7dkeGeJd7dleGeJd7dmeGeJe^d;dneGeJe^d;dpeGeJd7dqeGeJd7dreGeJd7dseGeJd7idteGeJd7dueGeJd7dveGeJd7dweGeJd7dxeGeJd7dyeGeJd7deGde`d;deGdead;dzeGeJd7d{eGeJd7d|eGeJd7deGeJd7deGeJe]d;deGeJe]d;deGeGebd;deGeGecd;deGeGedd;eGeGeed;eGeGefd;eGeGegd;eGeGehd;eGeGeid;eGe?ejd;eGe?ekd;deXe[YZle?eWmD]\ZnZodeovrepeod<qe?e[mD]\ZnZodeovrepeod<qddZqidd9ddSddTddUddVddWddXddYddZdd[dd\dd]dd^ddddcddeddddddddd:dbdd ZreqerZseXerYZtdddddZueqeuZvdeud<dddddddddd ZweqewZxdewd<dewd<dewd<dewd<iddddddddd2ddddddddddd̓ddΓddГddғddԓdd0ddדddٓddddݜZyeqeyZzdd߄Z{ddZ|ddZ}ddZ~hdZdAhZhdZddZddZddZddZe"dkrddlZedSdS)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.defaultc@seZdZdZdZdZdS)UFOFormatVersion)r)r)rN)__name__ __module__ __qualname__ FORMAT_1_0 FORMAT_2_0 FORMAT_3_0r&r&m/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/fontTools/ufoLib/__init__.pyrdsrc@seZdZdZdZdS)rzippackageN)r r!r"ZIPPACKAGEr&r&r&r'rpsrc@s&eZdZddZdddZddZdS) _UFOBaseIOc CsDz|jjt|dgdj}W|Stjjtjjfy!YdSw)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)fsgetinformodifiederrorsMissingInfoNamespaceResourceNotFound timestamp)selfpathdtr&r&r'getFileModificationTime{s z"_UFOBaseIO.getFileModificationTimeNc Csz |j|d}t|WdWS1swYWdStjjy:|dur6td||jf|YStyS}ztd|d|jd|d}~ww)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. rbNz,'%s' is missing on %s. This file is required'z' could not be read on : )r/openrloadr2r4r Exception)r6fileNamedefaultfer&r&r' _getPlists ( z_UFOBaseIO._getPlistc Cs|jr:zt|}Wnty }z td||j|fd}~ww|j|r1||j|kr1dS|j||dS|jj |dd(}zt ||Wntya}z td||j|fd}~wwWddS1smwYdS)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. zN'%s' could not be written on %s because the data is not properly formatted: %sNw)mode) _havePreviousFilerdumpsr?r r/exists readbytes writebytesopenbindump)r6r@objrrCfpr&r&r' _writePlists6  "z_UFOBaseIO._writePlistN)r r!r"r9rDrPr&r&r&r'r,zs  r,c@sNeZdZdZdFddZddZeeddZd d Zeed dZ ed d Z ddZ ee ddZ ddZ ddZdGddZdGddZdGddZddZdGddZdGd d!Zd"d#ZdGd$d%Zd&d'ZdGd(d)ZdGd*d+Zd,d-Zd.d/ZdGd0d1ZdGd2d3ZdHd4d5ZdId6d7Zd8d9Z dGd:d;Z!dd?Z#d@dAZ$dBdCZ%dDdEZ&dS)Jr aGRead 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. Tc Cst|dr |}t|trvt|}z|tjur"tjj |ddd}ntj |}Wntj j yA}z td|d|d}~ww|tjurldd|d D}t|d krd|j|d tjjd |_n td t|||_d|_||_nJt|tjjr|}z|Wntj jytd|w||_z|d }Wntj jyt|}Ynwd|_tj|_n tdt|jt ||_!||_"d|_#z |j$|dWdSty|%w)N __fspath__Futf-8writeencodingunable to open 'z': cS"g|] }|jr|jdkr|jqS__MACOSXis_dirname.0pr&r&r'  z&UFOReader.__init__../rrfactory+Expected exactly 1 root directory, found %dTthe filesystem '%s' is closedz7Expected a path string or fs.base.FS object, found '%s'validate)&hasattrrR isinstancestr_sniffFileStructurerr*r/zipfsZipFSosfsOSFSr2 CreateFailedr scandirlenopendirsubfs ClosingSubFS _shouldClose_fileStructurebaseFScheckFilesystemClosed getsyspath NoSysPathr+ TypeErrortyper r_path _validate_upConvertedKerningData readMetaInfoclose)r6r7ri structureparentFSrCrootDirs filesystemr&r&r'__init__sp               zUFOReader.__init__cCsddl}|jdtdd|jS)NrzBThe 'path' attribute is deprecated; use the 'fs' attribute insteadr stacklevel)warningswarnDeprecationWarningrr6rr&r&r' _get_path"szUFOReader._get_pathz!The path of the UFO (DEPRECATED).doccCs ddl}|jdtdd|jjS)NrzIThe 'formatVersion' attribute is deprecated; use the 'formatVersionTuple'rr)rrr_formatVersionmajorrr&r&r'_get_formatVersion.szUFOReader._get_formatVersionzIThe (major) format version of the UFO. DEPRECATED: Use formatVersionTuplecC|jS)z|The (major, minor) format version of the UFO. This is determined by reading metainfo.plist during __init__. )rr6r&r&r'formatVersionTuple=szUFOReader.formatVersionTuplecCrrQ)ryrr&r&r'_get_fileStructureDzUFOReader._get_fileStructurezVThe file structure of the UFO: either UFOFileStructure.ZIP or UFOFileStructure.PACKAGEc Cs|jr#|}||jdkrtd|}||jdkr!tdd S|}|r]d}t|ts4t||D]$\}}t|tsEt|t|tsNt||D] }t|ts[t|qPq8ti|i|d|_t |jdt |jd| \} }} | |jd<||jd<| |jd <d S) 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 _readGroupsrkdictitemsrllistrr getGlyphSet) r6ri testKerning testGroupsrinvalidFormatMessage groupName glyphList glyphNamerconversionMapsr&r&r'_upConvertKerningQsR        zUFOReader._upConvertKerningcCs,z |jt|WStjjyYdSw)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)r/rJrr2r4)r6r7r&r&r'readBytesFromPaths zUFOReader.readBytesFromPathNcCsLt|}z|dur|j|WS|jj|d|dWStjjy%YdSw)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. NrrFrV)rr/rLr=r2r4)r6r7rVr&r&r'getReadFileForPaths zUFOReader.getReadFileForPathc Cs|dur|j}|t}|rt|tstdz|d}Wnty/tdtd|jw|dd}zt ||f}Wn9t yw}z-d|d |d td|j}|rbdd l m }|||t }td ||WYd}~nd}~ww||d <|S)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)rrDMETAINFO_FILENAMErkrr KeyErrorr/ setdefaultr ValueErrorfontTools.ufoLib.errorsrrAloggerwarning) r6rirformatVersionMajorrrrCunsupportedMsgrr&r&r' _readMetaInfosF      zUFOReader._readMetaInfocCs|j|d}|d|_dS)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)rrr6rirr&r&r'rs zUFOReader.readMetaInfocCs>|ti}|D]\}}|drtt|||<q |S)N)z public.kern1.z public.kern2.)rDGROUPS_FILENAMEr startswithrrfromkeys)r6rrrr&r&r'rs  zUFOReader._readGroupscCsX|dur|j}|jtjkr|||jd}n|}|r*t|\}}|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. Nr) rrrr%rrrgroupsValidatorr )r6rirvalidmessager&r&r' readGroupss    zUFOReader.readGroupscCs<|dur|j}|jtjkrtiidS|j|d|jdS)aG Get maps defining the renaming that was done during any needed kerning group conversion. This method returns a dictionary of this form:: { "side1" : {"old group name" : "new group name"}, "side2" : {"old group name" : "new group name"} } When no conversion has been performed, the side1 and side2 dictionaries will be empty. ``validate`` will validate the groups, by default it is set to the class's validate value, can be overridden. Nside1side2rhr)rrrr%rrr)r6rir&r&r'#getKerningGroupConversionRenameMapss     z-UFOReader.getKerningGroupConversionRenameMapscCs&|ti}|rt|tstd|S)Nz)fontinfo.plist is not properly formatted.)rDFONTINFO_FILENAMErkrr rr&r&r' _readInfos zUFOReader._readInfoc CsD|dur|j}||}i}|jtjkr/tD]}||}|dur%|||<qt|}t|}nK|jtj krSt t D]\}}||}|durIq;|||<q;t|}n'|jj tjj krut t D]\}}||}|duroqa|||<qant|j|rt|}t | D]\}}zt|||Wqtytd|wdS)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 )r6inforiinfoDict infoDataToSetattrvaluedataValidationDictr&r&r'readInfosX             zUFOReader.readInfocCs|ti}|SrQ)rDKERNING_FILENAME)r6rr&r&r'rWs zUFOReader._readKerningc Cs|dur|j}|jtjkr|||jd}n|}|r*t|\}}|s*t|i}|D]}||D]}|||}||||f<q4q.|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. Nr) rrrr%rrrkerningValidatorr ) r6ri kerningNestedrrrleftrightrr&r&r' readKerning[s"      zUFOReader.readKerningcCs:|dur|j}|ti}|rt|\}}|st||S)z Read lib.plist. Returns a dict. ``validate`` will validate the data, by default it is set to the class's validate value, can be overridden. N)rrD LIB_FILENAMEfontLibValidatorr )r6rirrrr&r&r'readLibys  zUFOReader.readLibcCs\z!|jjtddd }|WdWS1swYWdStjjy-YdSw)zr Read features.fea. Return a string. The returned string is empty if the file is missing. rrSrVN)r/r=FEATURES_FILENAMEreadr2r4)r6rBr&r&r' readFeaturess(zUFOReader.readFeaturescCsD|jtjkr ttfgS|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_DIRNAMErDLAYERCONTENTS_FILENAMElayerContentsValidatorr/r )r6ricontentsrerrorr&r&r'_readLayerContentss   zUFOReader._readLayerContentscCs*|dur|j}||}dd|D}|S)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. NcSsg|]\}}|qSr&r&)r_ layerName directoryNamer&r&r'raz+UFOReader.getLayerNames..)rr)r6ri layerContents layerNamesr&r&r' getLayerNamess  zUFOReader.getLayerNamescCs>|dur|j}||}|D] \}}|tkr|Sqtd)z Get the default layer name from layercontents.plist. ``validate`` will validate the data, by default it is set to the class's validate value, can be overridden. Nz8The default layer is not defined in layercontents.plist.)rrrr )r6rirrlayerDirectoryr&r&r'getDefaultLayerNames  zUFOReader.getDefaultLayerNamec Csddlm}|dur |j}|dur|j}|dur|j|d}d}||}|D] \}}||kr3|}nq'|dur>td|z|j|} Wntjj yZtd|d|dw|| |j ||d d S) a Return the GlyphSet associated with the glyphs directory mapped to layerName in the UFO. If layerName is not provided, the name retrieved with getDefaultLayerName will be used. ``validateRead`` will validate the read data, by default it is set to the class's validate value, can be overridden. ``validateWrite`` will validate the written data, by default it is set to the class's validate value, can be overridden. rGlyphSetNrhz&No glyphs directory is mapped to "%s".zNo 'z' directory for layer 'r;T)ufoFormatVersion validateRead validateWriteexpectContentsFile) fontTools.ufoLib.glifLibrrrrr r/rur2r4r) r6rrrr directoryrstoredLayerNamestoredLayerDirectory glyphSubFSr&r&r'rs8     zUFOReader.getGlyphSetc Csl|dur|j}|j||dd}|}i}|D]\}}|D]}||vr-|||q|g||<qq|S)zf Return a dictionary that maps unicode values (ints) to lists of glyph names. NT)rr)rr getUnicodesrappend) r6rriglyphSet allUnicodescmaprunicodescoder&r&r'getCharacterMappings zUFOReader.getCharacterMappingcCszz |jt|_WntjjygYStjjy"tdwz dd|jj DWStjj y<gYSw)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.cSsg|]}|dqS)rc)lstripr^r&r&r'rasz5UFOReader.getDataDirectoryListing..) r/ru DATA_DIRNAME_dataFSr2r4DirectoryExpectedr walkfiles ResourceErrorrr&r&r'getDataDirectoryListingsz!UFOReader.getDataDirectoryListingc Cs|jtjkrgS|dur|j}z |jt|_}Wntjj y'gYStjj y3t dwg}| dD]4}|j rAq;|ri||j}t|d\}}Wdn1s[wY|rh||jq;||jq;|S)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.rc)fileObj)rrr%rr/ruIMAGES_DIRNAME _imagesFSr2r4rr rsr\rLr] pngValidatorr )r6riimagesFSresultr7rOrrr&r&r'getImageDirectoryListings4  z"UFOReader.getImageDirectoryListingcCslt|}zz|j}Wnty|jt}Ynw||}W|Stjjy5t d|d|jw)zZ Return bytes for the file named 'fileName' inside the 'data/' directory. zNo data file named 'r) rrrr/rurrJr2r4r )r6r@dataFSrr&r&r'readData=s   zUFOReader.readDatacCs|dur|j}|jtjkrtd|jjdt|}zz|j}Wnty0|j t }Ynw| |}Wnt j jyKtd|d|j w|r[t|d\}}|s[t||S)z Return image data for the file named fileName. ``validate`` will validate the data, by default it is set to the class's validate value, can be overridden. Nz%Reading images is not allowed in UFO rzNo image file named 'rr)rrrr%r rrrrr/rurrJr2r4r)r6r@rirrrrr&r&r' readImageMs,   zUFOReader.readImagecCs|jr |jdSdSrQ)rxr/rrr&r&r'rjszUFOReader.closecCs|SrQr&rr&r&r' __enter__nszUFOReader.__enter__cCs |dSrQ)r)r6exc_type exc_valueexc_tbr&r&r'__exit__qs zUFOReader.__exit__)TrQ)NNNNN)'r r!r"__doc__rrpropertyr7rrrr fileStructurerrrrrrrrrrrrrrrrrrrrr r"r$rr%r)r&r&r&r'r sV K    6  *   ;     ) $  r cs@eZdZdZ    d?ddZddZeed d Zd d Zd dZ d@ddZ dAddZ e Z ddZ ddZddZdBddZdBddZdBdd ZdBd!d"ZdBd#d$ZdCd%d&Zd'd(Z      dDd)d*Z  dEd+d,Z    dFd-d.ZdGd/d0Zd1d2Zd3d4Zd5d6ZdBd7d8ZdBd9d:ZdBd;d<Z fd=d>Z!Z"S)Hra=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. Ncom.github.fonttools.ufoLibTc Cszt|}Wnty }zddlm}|d||d}~wwt|dr*|}t|trtj |}tj |}|rjt |} |durgzt |}Wn tyYtd|w|| urftd| |fn| }n|durqt j}tj |} | rtj | std||t jur|rtj} tjj|dd } tj| | Wdn1swYd d | d D} t| d krtdt| | j| dtjjd|_n0tj tj |dd}tjj|ddd} | !|| j|tjjd|_n tj"j#|dd|_||_$||_%d|_&nht|tj'j(rn|}z|)Wntj*j+y/td|w||_z|,d }Wntj*j-yJt|}Ynw|r`|t jur`ddl.}|j/dt0ddt j|_$| t1|_%d|_&n t2dt3|j4t5||_6||_7||_8d|_9||_:d}|j%r|j;|d}|d}||krddlm}|d|d|di|_<|dur|j=dkrt>|?||_.rcrrfrd.ufoTrTcreatergz?The 'structure' argument is not used when input is an FS objectrrFz-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)CrrrrrjrRrkrlosr7normpathrIrmrr r+dirnameisdirr*r/tempfsTempFSrnrocopycopy_fsrsrtrurvrwsplitextbasenamemakedirrprqryrGrxrzr{r|r2r}r~rrr UserWarningrrrr rrr _fileCreator_downConversionKerningDatarrrrrrrr_writeMetaInfo)r6r7r fileCreatorrrirCrhavePreviousFileexistingStructuredirNamerorigFSrrootDirrrpreviousFormatVersionmetaInfor&r&r'rs                          zUFOWriter.__init__cCrrQ)r>rr&r&r'_get_fileCreator0rzUFOWriter._get_fileCreatorzMThe file creator of the UFO. This is set into metainfo.plist during __init__.rcCst|ts tdt|}t|}|j|std||j|r)td||jjtj|dd|j |rHtj |j||j|dStj |j||j|dS)z Copy the sourcePath in the provided UFOReader to destPath in this writer. The paths must be relative. This works with both individual files and directories. z,The reader must be an instance of UFOReader.z.The reader does not have data located at "%s".z!A file named "%s" already exists.TrecreateN) rkr r rr/rImakedirsr7r4r5r8copy_dir copy_file)r6reader sourcePathdestPathr&r&r'copyFromReader:s     zUFOWriter.copyFromReadercCst|}|jr|j|r||j|krdSz |j||WdStjjy0td|tjj yN|jj tj |dd|j||YdSw)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'TrJ) rrGr/isfilerJrKr2 FileExpectedr r4rLr7r4)r6r7rr&r&r'writeBytesToPathQs zUFOWriter.writeBytesToPathrEc Cst|}z |jj|||dWStjjyY}z=|d}|dkr'WYd}~dS|dks3|dks3|dkrN|jjtj|dd |jj|||dWYd}~SWYd}~dSd}~wtjjyz}zt d |d |jd |WYd}~Sd}~ww) 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. rrrNrEaxTrJrWrr<) rr/r=r2r4rLr7r4rr )r6r7rFrVrCmr&r&r'getFileObjectForPathes  (zUFOWriter.getFileObjectForPathFcCst|}z|j|Wn(tjjy|j|Yntjjy4|s2td|d|jYnw|rItj |}|rKtj |j|dSdSdS)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. r;z' does not exist on N) rr/remover2rT removetreer4r r7r4tools remove_empty)r6r7forceremoveEmptyParentsparentr&r&r' removePath~s   zUFOWriter.removePathc Csh|j}|dur0tj|r2z t|dWdSty/}z td|WYd}~dSd}~wwdSdS)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)rr2r7rIutimeOSErrorrr)r6r7rCr&r&r'setModificationTimeszUFOWriter.setModificationTimecCs:t|j|jjd}|jjdkr|jj|d<|t|dS)N)creatorrrr)rr>rrminorrPr)r6rHr&r&r'r@s  zUFOWriter._writeMetaInfocCsP|jtjkrdSi}dD]}t||D]\}}|||<qq t|d|_dS)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?)r6mapsremapside writeNamedataNamer&r&r'#setKerningGroupConversionRenameMapss  z-UFOWriter.setKerningGroupConversionRenameMapsc Cs|dur|j}|rt|\}}|st||jtjkrU|jdurU|jd}i}t|D] \}}||vr6q-|||<q-t|D]\}}||vrJqA||}|||<qA|}i} |D] \} } t| | | <q[| rp| t | dS|j r}|j t ddddSdS)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. NrgTFr^r_) rrr rrr%r?rrrPrrGra) r6rrirrriremappedGroupsr]r groupsNewkeyrr&r&r' writeGroupss8       zUFOWriter.writeGroupsc Cs|dur|j}i}ttD]%}t||r4zt||}Wn ty*td|w|dur0q|||<q|jt j krB|rAt |}n%|jt j krSt |}|rRt|}n|jt jkrgt |}|rct|}t|}|rq|t|dSdS)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#&_convertFontInfoDataVersion2ToVersion1rPr)r6rriinfoDatarrr&r&r' writeInfosF      zUFOWriter.writeInfoc Csz|dur|j}|rRd}t|st|t|D]8\}}t|ttfs(t|t|dks2t|t|dts=t|t|dtsHt|t|t sQt|q|j t j kr|j dur|j d}i}t|D]\\}} }|||}|| | } |||| f<qj|}i} |D]\} } || | f}| | vri| | <|| | | <q| r|t| dS|jr|jtddd dSdS) 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.rrrrgTFrn)r isDictEnoughr rrrktuplertrlr rrr%r?rrsrPrrGra) r6rrirpairrriremappedKerningrr kerningDictrrr&r&r' writeKerning2sL         zUFOWriter.writeKerningcCs\|dur|j}|rt|\}}|st||r|t|dS|jr,|jtddddSdS)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. NTFrn)rrr rPrrGra)r6libDictrirrr&r&r'writeLibks zUFOWriter.writeLibcCsp|dur|j}|jtjkrtd|rt|tstd|r)|t| ddS|j r6|j tddddSdS)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.utf8TFrn) rrrr#r rkrlrUrencoderGra)r6featuresrir&r&r' writeFeaturess  zUFOWriter.writeFeaturescs|durj}jtjkrdS|dur(g}|D] }|durt}||q|}ntj}|r@t |t jkr@t dfdd|D} t |dS)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.csg|] }|j|fqSr&)r)r_rrr&r'rasz0UFOWriter.writeLayerContents..) rrrr%rr rrrssetr rPr)r6 layerOrderrinewOrderrrr&rr'writeLayerContentss(   zUFOWriter.writeLayerContentscCsXd}t|jD]\}}|dur|tkr|}n ||kr!|}nq |s*td||S)Nz>Could not locate a glyph set directory for the layer named %s.)rrrrr )r6rfoundDirectoryexistingLayerNamerr&r&r'_findDirectoryForLayerNames z$UFOWriter._findDirectoryForLayerNamec Cs|dur|j}|dur|j}|jtjkr$|r|dur$td|jjd|durA|rA|jD] \}}|tkr9|}q/|dur@t }n |durK|sKtd|jtjkrZ|j ||||dS|jjtjjkrm|j ||||||dSt |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. Nz,Only the default layer can be writen in UFO rz5A layer name must be provided for non-default layers.)glyphNameToFileNameFuncr)r defaultLayerrr) rrrr%r rrrrr_getDefaultGlyphSet_getGlyphSetFormatVersion3r) r6rrrrrrrrr&r&r'rsL     zUFOWriter.getGlyphSetcCs2ddlm}|jjtdd}||||j|||dS)NrrTrJrrrrr)rrr/r<rr)r6rrrrrr r&r&r'rs zUFOWriter._getDefaultGlyphSetc Csddlm}|r)|jD]\}} | tkr ||krtd|q ||kr(tdq ||jvr4|j|} n|r9t} ndd|jD} t|| dd} |jj | d d } | |j|<|| ||j |||d S) Nrrz@Another layer ('%s') is already mapped to the default directory.z8The layer name is already mapped to a non-default layer.cSh|]}|qSr&lower)r_dr&r&r' 7rz7UFOWriter._getGlyphSetFormatVersion3..glyphs.existingprefixTrJr) rrrrrr valuesrr/r<r) r6rrrrrrrrrrr r&r&r'rsD    z$UFOWriter._getGlyphSetFormatVersion3cCs|jtjkrdS||kr#|j|tkr|sdS|j|tkr"|r"dSn|dur)t}||jvr4td||rAt|jvrAtd||}|rKt}ndd|jD}t ||dd}|j|=||j|<|j j ||dd dS) 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.cSrr&r)r_r]r&r&r'rorz+UFOWriter.renameGlyphSet..rrTr0) rrr%rrrr rrrr/movedir)r6r newLayerNamer oldDirectory newDirectoryrr&r&r'renameGlyphSetIs4     zUFOWriter.renameGlyphSetcCs4|jtjkrdS||}|j|dd|j|=dS)z: Remove the glyph set matching layerName. NF)r_)rrr%rrar)r6rrr&r&r'deleteGlyphSetys   zUFOWriter.deleteGlyphSetcCs|tdt||dS)zj Write data to fileName in the 'data' directory. The data must be a bytes string. rcN)rUrr)r6r@rr&r&r' writeDataszUFOWriter.writeDatacCs|tdt|dS)zI Remove the file named fileName from the data directory. rcN)rarr)r6r@r&r&r' removeDataszUFOWriter.removeDatacCsn|dur|j}|jtjkrtd|jjdt|}|r*t|d\}}|s*t||t d||dS)zg Write data to fileName in the images directory. The data must be a valid PNG. NImages are not allowed in UFO rr#rc) rrrr%r rrrrUr)r6r@rrirrr&r&r' writeImages zUFOWriter.writeImagecCs<|jtjkrtd|jjd|tdt|dS)zS Remove the file named fileName from the images directory. rrrcN)rrr%r rrarr)r6r@rir&r&r' removeImages zUFOWriter.removeImagecCsd|dur|j}|jtjkrtd|jjdtdt|}tdt|}||||dS)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. Nrrrc) rrrr%r rrrrR)r6rOsourceFileName destFileNamerirPrQr&r&r'copyImageFromReaders zUFOWriter.copyImageFromReadercs|jr=|jtjur=tjtj|jdd}t j j |jddd}t j |j ||Wdn1s8wYtdS)Nrr/TrSrT)rGryrr*r2r7r:r;rr/rnror8r9r<superr)r6rFdestFS __class__r&r'rs zUFOWriter.close)Nr.NT)rEN)FTrQr*)NTNNNF)NF)NTNF)F)#r r!r"r+rrIr,rArRrUrYraremoveFileForPathrdr@rmrrryrrrrrrrrrrrrrrrr __classcell__r&r&rr'rzsf     7 . 9   F  60    rcCsFt|rtjStj|rtjStj|rt d|t d|)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*r2r7r5r+rSr )ufo_pathr&r&r'rms    rmcCs@tj|\}}dd|ddddg}tj||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)r2r7splitjoin)r7dirr]r&r&r'r s "r cC^t|}|d}|d}|d}|dur|||}|S|tkr)|||}|S||}|S)a This performs very basic validation of the value for attribute following the UFO 2 fontinfo.plist specification. The results of this should not be interpretted as *correct* for the font that they are part of. This merely indicates that the value is of the proper type and, where the specification defines a set range of possible values for an attribute, that the value is in the accepted range. rvalueValidator valueOptionsN)rrgenericTypeValidatorrrr valueType validatorr isValidValuer&r&r'r     rcCJi}t|D]\}}t||}|std|d|d|||<q|S)a This performs very basic validation of the value for infoData following the UFO 2 fontinfo.plist specification. The results of this should not be interpretted as *correct* for the font that they are part of. This merely indicates that the values are of the proper type and, where the specification defines a set range of possible values for an attribute, that the value is in the accepted range. Invalid value for attribute  ().)rrrr rx validInfoDatarrrr&r&r'rv   rvcCr)a This performs very basic validation of the value for attribute following the UFO 3 fontinfo.plist specification. The results of this should not be interpretted as *correct* for the font that they are part of. This merely indicates that the value is of the proper type and, where the specification defines a set range of possible values for an attribute, that the value is in the accepted range. rrrN)rrrrr&r&r'r0rrcCr)a This performs very basic validation of the value for infoData following the UFO 3 fontinfo.plist specification. The results of this should not be interpretted as *correct* for the font that they are part of. This merely indicates that the values are of the proper type and, where the specification defines a set range of possible values for an attribute, that the value is in the accepted range. rrr)rrrr rr&r&r'rJrr)rrr @)rrrrrr>(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)rrrrrrrrrrrrrropenTypeHeadCreatedopenTypeHeadLowestRecPPEMopenTypeHeadFlags integerList)rrropenTypeHheaAscenderopenTypeHheaDescenderopenTypeHheaLineGapopenTypeHheaCaretSlopeRiseopenTypeHheaCaretSlopeRunopenTypeHheaCaretOffsetopenTypeNameDesigneropenTypeNameDesignerURLopenTypeNameManufactureropenTypeNameManufacturerURLopenTypeNameLicenseopenTypeNameLicenseURLopenTypeNameVersionopenTypeNameUniqueIDopenTypeNameDescriptionopenTypeNamePreferredFamilyName"openTypeNamePreferredSubfamilyNameopenTypeNameCompatibleFullNameopenTypeNameSampleTextopenTypeNameWWSFamilyNameopenTypeNameWWSSubfamilyNameopenTypeOS2WidthClassopenTypeOS2WeightClassopenTypeOS2SelectionopenTypeOS2VendorIDopenTypeOS2PanoseopenTypeOS2FamilyClassopenTypeOS2UnicodeRangesopenTypeOS2CodePageRangesopenTypeOS2TypoAscenderopenTypeOS2TypoDescenderopenTypeOS2TypoLineGapopenTypeOS2WinAscentopenTypeOS2WinDescentopenTypeOS2TypeopenTypeOS2SubscriptXSizeopenTypeOS2SubscriptYSizeopenTypeOS2SubscriptXOffsetopenTypeOS2SubscriptYOffsetopenTypeOS2SuperscriptXSizeopenTypeOS2SuperscriptYSizeopenTypeOS2SuperscriptXOffsetopenTypeOS2SuperscriptYOffsetopenTypeOS2StrikeoutSizeopenTypeOS2StrikeoutPositionopenTypeVheaVertTypoAscenderopenTypeVheaVertTypoDescenderopenTypeVheaVertTypoLineGapopenTypeVheaCaretSlopeRiseopenTypeVheaCaretSlopeRunopenTypeVheaCaretOffsetpostscriptFontNamepostscriptFullNamepostscriptSlantAnglepostscriptUniqueIDpostscriptUnderlineThicknesspostscriptUnderlinePositionpostscriptIsFixedPitchpostscriptBlueValuespostscriptOtherBluespostscriptFamilyBluespostscriptFamilyOtherBluespostscriptStemSnapHpostscriptStemSnapVpostscriptBlueFuzzpostscriptBlueShift) postscriptBlueScalepostscriptForceBoldpostscriptDefaultWidthXpostscriptNominalWidthXpostscriptWeightNamepostscriptDefaultCharacterpostscriptWindowsCharacterSetmacintoshFONDFamilyIDmacintoshFONDNameopenTypeGaspRangeRecordsdictListopenTypeNameRecordswoffMajorVersionwoffMinorVersionwoffMetadataUniqueIDwoffMetadataVendorwoffMetadataCredits)woffMetadataDescriptionwoffMetadataLicensewoffMetadataCopyrightwoffMetadataTrademarkwoffMetadataLicenseewoffMetadataExtensions guidelinesrcCs&i}t|D]\}}|||<q|SrQ)rr)rflippedrqrr&r&r' _flipDicts rXrrrrrrrrrrrrrrrCrrrrFrGrArE) rrrrrrrrrregularitalicboldz bold italic)rr !rrrrrrr) zUltra-condensedzExtra-condensed CondensedzSemi-condensedzMedium (normal)z Semi-expandedExpandedzExtra-expandedzUltra-expandedNormalAllmediumMediumM )cCst|trt||krt|}|durc|dkr.t|}|dur+td|d|d|}n5|dkrIt|}|durFtd|d|d|}n|dkrct|}|duratd|d|d|}t||}||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. NrCannot convert value () for attribute rrr) rkfloatint_fontStyle1To2rr _widthName1To2_msCharSet1To2fontInfoAttributesVersion1To2rrvr&r&r'rs6      rcCsV|dur!|dkrt|}n|dkrt|}n |dkr!t|}t||}||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. NrrrE)_fontStyle2To1r_widthName2To1_msCharSet2To1fontInfoAttributesVersion2To1rrr&r&r'r s    rcCsni}t|D],\}}|dkr|dkrqt||\}}|tvr!q|dur0td|d|d|||<q|S)Nrrrrr)rrrrr r convertedrrnewAttrnewValuer&r&r'r s rcCs\i}t|D]#\}}t||\}}|tvrq|dur'td|d|d|||<q|S)Nrrr)rrrrr rr&r&r'rw5 s rw>rrrr>rrrrrrrrr/r(rrr r!r"r#r$r%r,r)r*r&r'r+c Cs|tvrzt|}Wnttfytd|w|tvr9z tt|}W||fSttfy8td|w|tvrezt t|}WnttfyTtd|w|t|kr_t|}||kre|}||fS)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_ufo2To3NonNegativeIntOrFloatrrr&r&r'6convertFontInfoValueForAttributeFromVersion2ToVersion3o s0      rcCs||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&rr&r&r'6convertFontInfoValueForAttributeFromVersion3ToVersion2 srcCs>i}t|D]\}}t||\}}|tvrq|||<q|SrQ)rrrrrr&r&r'ru s rucCs4i}t|D]\}}t||\}}|||<q|SrQ)rrr)rrrrr&r&r'r s r__main__)r+r2r8rrloggingrenum collectionsrr/fs.basefs.subfs fs.errorsfs.copyfs.osfsfs.zipfs fs.tempfsfs.toolsfontTools.miscrfontTools.ufoLib.validatorsfontTools.ufoLib.filenamesrfontTools.ufoLib.convertersrrr fontTools.ufoLib.utilsr r __all__ __version__ getLoggerr rrrrrrrrrrrLAYERINFO_FILENAMErr{Enumr__str__rr,r rrrmr rrvrrrrange fontInfoOpenTypeHeadFlagsOptions#fontInfoOpenTypeOS2SelectionOptions'fontInfoOpenTypeOS2UnicodeRangesOptions(fontInfoOpenTypeOS2CodePageRangesOptionsfontInfoOpenTypeOS2TypeOptionsrrrl"fontInfoStyleMapStyleNameValidatorrr$fontInfoOpenTypeHeadCreatedValidatorgenericIntListValidator&fontInfoOpenTypeOS2WidthClassValidator'fontInfoOpenTypeOS2WeightClassValidator*fontInfoVersion2OpenTypeOS2PanoseValidator'fontInfoOpenTypeOS2FamilyClassValidatorbool fontInfoPostscriptBluesValidator%fontInfoPostscriptOtherBluesValidator fontInfoPostscriptStemsValidator.fontInfoPostscriptWindowsCharacterSetValidatorrrrsrrupdategenericNonNegativeIntValidator!genericNonNegativeNumberValidator*fontInfoVersion3OpenTypeOS2PanoseValidator)fontInfoOpenTypeGaspRangeRecordsValidator$fontInfoOpenTypeNameRecordsValidator%fontInfoWOFFMetadataUniqueIDValidator#fontInfoWOFFMetadataVendorValidator$fontInfoWOFFMetadataCreditsValidator(fontInfoWOFFMetadataDescriptionValidator$fontInfoWOFFMetadataLicenseValidator&fontInfoWOFFMetadataCopyrightValidator&fontInfoWOFFMetadataTrademarkValidator%fontInfoWOFFMetadataLicenseeValidator'fontInfoWOFFMetadataExtensionsValidatorguidelinesValidatorrrrdataDictrrXrrrrrrrrrrrrrwrrrrrrurdoctesttestmodr&r&r&r'sN"          Q4X+             ! " # $ % & ' ( ) * + , - . / 0147 <=@CHMNOPQRWXYZ[\]^_`abc d ef g hi jkl mnqtwz}                      ! "#& ) * + ,-0369<  R              $