+ f7iMcs^RIt^RIt^RIt^RIHt^RIHtHt^RIt^RIH t ]Pt RRRRR R/t !R R ]P4tR tRR lt!RR]4t!RR]P&4t!RR]P*4t!RR]4t]3Rlt]3Rlt]R8Xd>^RIt]P:!]P<!]P>R7P@4R#R#)Nwraps)MappingCallable) PercentStyle*z%(levelname)s: %(message)sZINFOz %(message)sDEBUGcsFaa]tRt^toRtRV3RlltV3RltRtVtV;t #)LevelFormatteraLog formatter with level-specific formatting. Formatter class which optionally takes a dict of logging levels to format strings, allowing to customise the log records appearance for specific levels. Attributes: fmt: A dictionary mapping logging levels to format strings. The ``*`` key identifies the default format string. datefmt: As per py:class:`logging.Formatter` style: As per py:class:`logging.Formatter` >>> import sys >>> handler = logging.StreamHandler(sys.stdout) >>> formatter = LevelFormatter( ... fmt={ ... '*': '[%(levelname)s] %(message)s', ... 'DEBUG': '%(name)s [%(levelname)s] %(message)s', ... 'INFO': '%(message)s', ... }) >>> handler.setFormatter(formatter) >>> log = logging.getLogger('test') >>> log.setLevel(logging.DEBUG) >>> log.addHandler(handler) >>> log.debug('this uses a custom format string') test [DEBUG] this uses a custom format string >>> log.info('this also uses a custom format string') this also uses a custom format string >>> log.warning("this one uses the default format string") [WARNING] this one uses the default format string cs<VR8wd \R4hVf\p\V\4'dTp/pMF\V\4'd\ V4pVP RR4pM\RV,4h\\V`+WB4VPVn /Vn VP4F)wra\P !V4pWPV&K+ R#)%z:only '%' percent style is supported in both python 2 and 3Nrz&fmt must be a str or a dict of str: %r) ValueErrorDEFAULT_FORMATS isinstancestrrZdictpopZ TypeErrorsuperr__init___fmtdefault_formatcustom_formatsZitemsloggingZ _checkLevel)selffmtdatefmtstylerrlevel __class__s&&&& B/usr/lib64/python3.14/site-packages/fontTools/misc/loggingTools.pyrZLevelFormatter.__init__8s C<L  ;!C c3   NN W % %!#YN+//T:NDsJK K nd,^E"ii (..0JE''.E),   &1cs<VP'ddVPPVPVP4pVPV8wd#W n\ 'd\ V4Vn\\V`'V4#N) rgetZlevelnorrr_stylerrformat)rrecordrrs&& rr ZLevelFormatter.formatNse    %%))&..$:M:MNCyyC <".s"3DK^T1&99r)rrrr)NNr ) __name__ __module__ __qualname____firstlineno____doc__rr __static_attributes____classdictcell__ __classcell__r __classdict__@@rrrsB-,::rrc sVPRR4pVfRV9dRV9d \R4hMRV9gRV9d \R4hVfoVPRR4pVPRR4pV'd\P!W#4pM(VPRR4p\P!V4pV.pVPR R 4pV'd\ V\ 4'd\P!V4p\VPR 7VPR R4pVPR R4pVPRR4p \WxV 4p VPR.4p VF_pVPfVPV 4VP'gV Fp VPV 4K VPV4Ka VPR8wdVPRR4VnVPRR4p V eVP#V 4V'd2RP%VP'44p\RV,4hR#)a A more sophisticated logging system configuation manager. This is more or less the same as :py:func:`logging.basicConfig`, with some additional options and defaults. The default behaviour is to create a ``StreamHandler`` which writes to sys.stderr, set a formatter using the ``DEFAULT_FORMATS`` strings, and add the handler to the top-level library logger ("fontTools"). A number of optional keyword arguments may be specified, which can alter the default behaviour. Args: logger: Specifies the logger name or a Logger instance to be configured. (Defaults to "fontTools" logger). Unlike ``basicConfig``, this function can be called multiple times to reconfigure a logger. If the logger or any of its children already exists before the call is made, they will be reset before the new configuration is applied. filename: Specifies that a ``FileHandler`` be created, using the specified filename, rather than a ``StreamHandler``. filemode: Specifies the mode to open the file, if filename is specified. (If filemode is unspecified, it defaults to ``a``). format: Use the specified format string for the handler. This argument also accepts a dictionary of format strings keyed by level name, to allow customising the records appearance for specific levels. The special ``'*'`` key is for 'any other' level. datefmt: Use the specified date/time format. level: Set the logger level to the specified level. stream: Use the specified stream to initialize the StreamHandler. Note that this argument is incompatible with ``filename`` - if both are present, ``stream`` is ignored. handlers: If specified, this should be an iterable of already created handlers, which will be added to the logger. Any handler in the list which does not have a formatter assigned will be assigned the formatter created in this function. filters: If specified, this should be an iterable of already created filters. If the ``handlers`` do not already have filters assigned, these filters will be added to them. propagate: All loggers have a ``propagate`` attribute which determines whether to continue searching for handlers up the logging hierarchy. If not provided, the "propagate" attribute will be set to ``False``. handlersNstreamfilenamez8'stream' and 'filename' should not be specified togetherzG'stream' or 'filename' should not be specified together with 'handlers'ZfilemodeZaloggerZ fontTools)parentr rrr filtersroot propagateFrz, zUnrecognised argument(s): %s)rr rZ FileHandlerZ StreamHandlerr r getLogger_resetExistingLoggersnamerZ formatterZ setFormatterr2Z addFilter addHandlerr4setLeveljoinkeys)kwargsr-r/Zmodehr.r0ZfsZdfsrrr2frr;s, r configLoggerr?YsZzz*d+H v *"6M  v v!55 ::j$/zz*c* ##H3AZZ$/F%%f-A3 ZZ+ .F Z,,""6*- Hd #B **Y %C JJw $E % (CjjB'G  ;;  NN3 yyy A! {{f!::k59 JJw %E  yy'7$>??rcs\\Pp\VPPP 44pVR8Xd V.V,pMW9dR#W9dsV.pVP V4^,pVR,p\V4p\V4pWG8d3W$,RVV8XdVPW$,4V^, pK8XFpVR8XdVP\P4VPR,Fp VPV 4K VPR,Fp VPV 4K RVnKVPPV,p \P V n.V n .V n RV nRV nK R#)zReset the logger named 'parent' and all its children to their initial state, if they already exist in the current configuration. r3N.:NNNFT)rr3ZsortedZmanagerZ loggerDictr;Zindexlenappendr9ZWARNINGr- removeHandlerr2Z removeFiltersdisabledZNOTSETrr4) r1r3ZexistingZloggers_to_resetZiZprefixedZpflenZ num_existingr7r=r>r0s & rr6r6s^ < MM'// *]]1%%""1%&\\!__""1%%!DM\\,,T2F">>FL FOFN#F #FO!rcsa]tRt^toRt]!]P4tRt Rt RRlt RRlt Rt RtR tR tR tRR ltR tRtRtV3RltRtVtR#)TimeraKeeps track of overall time and split/lap times. >>> import time >>> timer = Timer() >>> time.sleep(0.01) >>> print("First lap:", timer.split()) First lap: ... >>> time.sleep(0.02) >>> print("Second lap:", timer.split()) Second lap: ... >>> print("Overall time:", timer.time()) Overall time: ... Can be used as a context manager inside with-statements. >>> with Timer() as t: ... time.sleep(0.01) >>> print("%0.3f seconds" % t.elapsed) 0... seconds If initialised with a logger, it can log the elapsed time automatically upon exiting the with-statement. >>> import logging >>> log = logging.getLogger("my-fancy-timer-logger") >>> configLogger(logger=log, level="DEBUG", format="%(message)s", stream=sys.stdout) >>> with Timer(log, 'do something'): ... time.sleep(0.01) Took ... to do something The same Timer instance, holding a reference to a logger, can be reused in multiple with-statements, optionally with different messages or levels. >>> timer = Timer(log) >>> with timer(): ... time.sleep(0.01) elapsed time: ...s >>> with timer('redo it', level=logging.INFO): ... time.sleep(0.02) Took ... to redo it It can also be used as a function decorator to log the time elapsed to run the decorated function. >>> @timer() ... def test1(): ... time.sleep(0.01) >>> @timer('run test 2', level=logging.INFO) ... def test2(): ... time.sleep(0.02) >>> test1() Took ... to run 'test1' >>> test2() Took ... to run test 2 zelapsed time: %(time).3fszTook %(time).3fs to %(msg)sNcsVPV4Vf7RF0p\4PV4fK \RV,4h WnVeTM\ VnW nR#)Nz*'%s' can't be specified without a 'logger')msgr)resetZlocalsrr r0 TIME_LEVELrrF)rr0rFrstartZargs&&&&& rrZTimer.__init__#sZ 5 >'8<<$0$%QTW%WXX( #/UZ rc svVfVP4VnMWnVPVnRVnR#)z0Reset timer to 'start_time' or the current time.N)_timerIlastelapsed)rrI&&rrGZ Timer.reset-s+ =DJJJJ  rc sDVP4VP, #)z=Return the overall time (in seconds) since the timer started.)rKrIr&rtimeZ Timer.time6szz|djj((rc stVP4pWP, VnWnVP#)z=Split and return the lap time (in seconds) in between splits.rKrLrM)rZcurrent& rsplitZ Timer.split:s***,*  ||rc sV'g VPpVPR4^8dVPRVRV/,pV#VRV/,pV# \\3dT#i;i)zFormat 'time' value in 'msg' and return formatted string. If 'msg' contains a '%(time)' format string, try to use that. Otherwise, use the predefined 'default_format'. If 'msg' is empty or None, fall back to 'default_msg'. z%(time)rFrQ) default_msgfindrZKeyErrorr )rrFrQ&&&r formatTimeZTimer.formatTimeAs{ ""C 88I  "%%VT(BBC   VTN* j)   s AA'&A'c s>VP4VnRVnV#)zStart a new laprJrRrOrPr __enter__ZTimer.__enter__RsJJL   rc sVP4pVPe V'dR#VPVPV4pRVPRV/pVPP VP WV4R#)z|End the current lap. If timer has a logger, log the time elapsed, using the format string in self.msg (or the default one). NrFrQ)rTr0rXrFlogr)rZexc_typeZ exc_value tracebackrQZmessageZ msg_partss&&&& r__exit__ZTimer.__exit__Xs^zz| ;; ( //$((D1DHHfd3   G7rc s^aa\V\4'dDVoSP'gRSP,Sn\ S4VV3Rl4pV#T;'gVP R4pVP RSP 4pSPSPWE4#)a.If the first argument is a function, return a decorator which runs the wrapped function inside Timer's context manager. Otherwise, treat the first argument as a 'msg' string and return an updated Timer instance, referencing the same logger. A 'level' keyword can also be passed to override self.level. zrun '%s'csf<S;_uu_4S!V/VBuuRRR4# +'giR#;ir)argsZkwdsfuncrs*,rwrapperZTimer.__call__..wrapperts!T..TTTs 0 rFr) r rrFr"rrrrr0)rZ func_or_msgr<r`rFrr_sf&, @r__call__ZTimer.__call__gs k8 , ,D888% 5 4[ / /N22E!2CJJw 3E>>$++s: :rcsVP#rrMrOrPr __float__ZTimer.__float__s ||rcs,\VP4#r)ZintrMrOrPr__int__Z Timer.__int__s4<<  rcs(RVP,#)z%.3frbrOrPr__str__Z Timer.__str__s $$rcs:<V^8dQh/S[.S[3,;R&#)irK)rZfloat)r r+s"rZ __annotate__ZTimer.__annotate__st BI Cur)rMrLrr0rFrI)NNNNr)r"r#r$r%r&Z staticmethodtimeitZ default_timerrKrUrrrGrQrTrXrYr\rarcrdreZ__annotate_func__r'r(r+@rrErEsf6r".f.B.B!CE-K2N)" 8;0!%ArrEcs0a]tRtRtoRtRtRtRtVtR#)ChannelsFilteriaProvides a hierarchical filter for log entries based on channel names. Filters out records emitted from a list of enabled channel names, including their children. It works the same as the ``logging.Filter`` class, but allows the user to specify multiple channel names. >>> import sys >>> handler = logging.StreamHandler(sys.stdout) >>> handler.setFormatter(logging.Formatter("%(message)s")) >>> filter = ChannelsFilter("A.B", "C.D") >>> handler.addFilter(filter) >>> root = logging.getLogger() >>> root.addHandler(handler) >>> root.setLevel(level=logging.DEBUG) >>> logging.getLogger('A.B').debug('this record passes through') this record passes through >>> logging.getLogger('A.B.C').debug('records from children also pass') records from children also pass >>> logging.getLogger('C.D').debug('this one as well') this one as well >>> logging.getLogger('A.B.').debug('also this one') also this one >>> logging.getLogger('A.F').debug('but this one does not!') >>> logging.getLogger('C.DE').debug('neither this one!') cs|Wn\V4VnVUu/uFq"\V4bK upVnR#uupir)namesrAnumlengths)rrjZns&* rrZChannelsFilter.__init__s1 u:+015a3q6 51 1s9csVP^8XdR#VPFhpVPV,pW!P8XdR#VPP V^V4^8XgKMVPV,R8XgKgR# R#)rTr@F)rkrjrlr7rV)rr!r7Znlens&& rfilterZChannelsFilter.filtersl 88q=JJD<<%D{{"!!$40A5&++d:Ks:R  r)rlrjrkN) r"r#r$r%r&rrmr'r(rgrhrriris42  rricsNaa]tRtRtoV3RltRtRtRtRRltRt Vt V;t #) CapturingLogHandlerics<\\V` VR7.Vn\ V\ 4'd\ P!V4VnR#WnR#))rN) rrnrrecordsr r rr5r0)rr0rrs&&&rrZCapturingLogHandler.__init__sA !411> fc " "!++F3DK KrcslVPPVnVPPVnVPP VnVPPV4VPPVP4RVPnRVPnV#)F) r0rDoriginal_disabledroriginal_levelr4original_propagater8r9rOrPrrYZCapturingLogHandler.__enter__s}!%!5!5"kk//"&++"7"7 t$ TZZ($  %  rcsVPPV4VPPVP4VPVPnVP VPnV#r)r0rCr9rqrprDrrr4)rZtypeZvaluer[s&&&&rr\ZCapturingLogHandler.__exit__sU !!$' T001#55  $ 7 7  rcs<VPPV4R#r)rorB)rr!rNremitZCapturingLogHandler.emits F#rcs^RIpVPV4pVPF+pVPVP 44'gK*R# Vf RV,pQT4h)rNTz(Pattern '%s' not found in logger records)reZcompileroZsearchZ getMessage)rZregexprFrtZpatternZrs&&& r assertRegexZCapturingLogHandler.assertRegexsS**V$A~~alln-- ;.``. For example: >>> class BaseClass(object): ... pass >>> class MyClass(LogMixin, BaseClass): ... pass >>> a = MyClass() >>> isinstance(a.log, logging.Logger) True >>> print(a.log.name) fontTools.misc.loggingTools.MyClass >>> class AnotherClass(MyClass): ... pass >>> b = AnotherClass() >>> isinstance(b.log, logging.Logger) True >>> print(b.log.name) fontTools.misc.loggingTools.AnotherClass cs\VR4'gWRPVPPVPP34p\ P !V4VnVP#)_logr@)Zhasattrr:rr#r"rr5rw)rr7rSrrZZ LogMixin.logsRtV$$88T^^668O8OPQD))$/DIyyr)rwN) r"r#r$r%r&ZpropertyrZr'r(rgrhrrvrvs6rrvcsF\P!V: RV: 2V^R7R#)z:Raise a warning about deprecated function argument 'name'. is deprecated; categoryZ stacklevelN)warningswarn)r7rFrzrWrdeprecateArgumentr}s MMD#6VWXrcsaaVV3RlpV#)zBDecorator to raise a warning when a deprecated function is called.cs6<a\S4VVV3Rl4pV#)csh<\P!SP: RS: 2S^R7S!V/VB#)rxry)r{r|r")r^r<rzr_rFs*,rr`Z5deprecateFunction..decorator..wrappers3 MM*.--=!  (( (rr)r_r`rzrFsf r decoratorZ$deprecateFunction..decorator s t )  )rr])rFrzr~sff rdeprecateFunctionr s  rZ__main__)Z optionflags)r3)!ZsysrrfZ functoolsrZcollections.abcrrr{rrrHr Z Formatterrr?r6ZobjectrEZFilterriZHandlerrnrvZ UserWarningr}rr"ZdoctestZexitZtestmodZELLIPSISZfailedr]rrrs  - ]]  % M ]@:W&&@:F`@F&$Ra%Fa%H)W^^)X)'//)X!v!H+6Y %0$ zHHW__)9)9 : A ABr