h+TSrSSKJr SSKrSSKJr SSKJrJrJ r J r J r J r J r JrJrJr \R""\5r/SQr"SS\5r"S S \5r"S S \5r"S S\5r"SS\5r\"SSS9"SS55r"SS\ 5r\"5r"SS\ 5rg)a` Code of the config system; not related to fontTools or fonts in particular. The options that are specific to fontTools are in :mod:`fontTools.config`. To create your own config system, you need to create an instance of :class:`Options`, and a subclass of :class:`AbstractConfig` with its ``options`` class variable set to your instance of Options. ) annotationsN) dataclass) AnyCallableClassVarDictIterableMappingMutableMappingOptionalSetUnion)AbstractConfigConfigAlreadyRegisteredError ConfigErrorConfigUnknownOptionErrorConfigValueParsingErrorConfigValueValidationErrorOptionOptionsc\rSrSrSrSrg)r,z%Base exception for the config module.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__rL/var/www/html/env/lib/python3.13/site-packages/fontTools/misc/configTools.pyrr,s/r rc,^\rSrSrSrU4SjrSrU=r$)r0zRaised when a module tries to register a configuration option that already exists. Should not be raised too much really, only when developing new fontTools modules. c,>[TU]SUS35 g)NConfig option z is already registered.)super__init__)selfname __class__s r!r'%ConfigAlreadyRegisteredError.__init__8s >$/FGHr rrrrrrr'r __classcell__r*s@r!rr0sIIr rc,^\rSrSrSrU4SjrSrU=r$)r<z3Raised when a configuration value cannot be parsed.cD>[TU]SUS[U5S35 g)Nr%z : value cannot be parsed (given )r&r'reprr(r)valuer*s r!r' ConfigValueParsingError.__init__?s' TF"B4;-q Q r rr,r.s@r!rr<s=  r rc,^\rSrSrSrU4SjrSrU=r$)rEz6Raised when a configuration value cannot be validated.cD>[TU]SUS[U5S35 g)Nr%z: value is invalid (given r2r3r5s r!r'#ConfigValueValidationError.__init__Hs' TF"[U[5(aSURS[U5S3OSUS3n[TU]SUS35 g)N'z' (id=z)>r%z is unknown) isinstancerr)idr&r')r(option_or_namer)r*s r!r'!ConfigUnknownOptionError.__init__Qs].&11##$F2n+=*>b A^$A& >${;0nofalseF>1yestrueT>autononezinvalid optional bool: {v!r})rHlower ValueError)vss r!parse_optional_boolOption.parse_optional_boolhsA FLLN $ $ $ $  788r c8USL=(d [U[5$N)r@bool)rZs r!validate_optional_boolOption.validate_optional_boolssDy/Jq$//r r)rZrHreturnzOptional[bool])rZrrcr`) rrrr__annotations__rN staticmethodr\rarrr r!rr[sW IM I$ L( Q04H-4@9900r rc\rSrSr%SrS\S'SSSjjrSSSjjrSSjrSS jr SS jr SS jr SS jr SS jr Srg)rxzRegistry of available options for a given config system. Define new options using the :meth:`register()` method. Access existing options using the Mapping interface. zDict[str, Option]_Options__optionsNcj0UlUb)UR5HnURU5 M ggr_)rhvaluesregister_option)r(otheroptions r!r'Options.__init__s2  ,,.$$V,) r c :UR[XX4U55$)z!Create and register a new option.)rkr)r(r)rIrJrLrNs r!registerOptions.registers##F4wx$PQQr cnURnX R;a [U5eXRU'U$)zRegister a new option.)r)rhr)r(rmr)s r!rkOptions.register_options1{{ >> !.t4 4%t r cPURRUR5UL$)z#Options.__repr__..s-2DAqe,QYYMC2s$&z}))r*rjoinrhitemsr~s r!__repr__Options.__repr__sQ~~&&'u -gg NN002     r ) __optionsr_)rlz 'Options'rcNone r)rHrIrHrJrrLrKrNrMrcr)rmrrcr)rmrrcr`)rzrHrcr)rcz Iterator[str]rcintrcrH)rrrrrrdr'rprkrvryr}rrrrr r!rrxs}! -59 R R R R $ R 2 R  R9/)( r rc\rSrSr%SrS\S'\SSSjj5rS\S'0S S 4SS jjrSS jr SSS jjr \ 4SS jjr Sr SSjrSSjrSSjrS SjrS!SjrS"SjrSrg)#ra Create a set of config values, optionally pre-filled with values from the given dictionary or pre-existing config object. The class implements the MutableMapping protocol keyed by option name (`str`). For convenience its methods accept either Option or str as the key parameter. .. seealso:: :meth:`set()` This config class is abstract because it needs its ``options`` class var to be set to an instance of :class:`Options` before it can be instanciated and used. .. code:: python class MyConfig(AbstractConfig): options = Options() MyConfig.register_option( "test:option_name", "This is an option", 0, int, lambda v: isinstance(v, int)) cfg = MyConfig({"test:option_name": 10}) zClassVar[Options]optionsNc8URRXX4US9$)z3Register an available option in this config system.)rIrJrLrN)rrp)clsr)rIrJrLrNs r!rkAbstractConfig.register_options'{{## WH$  r zDict[str, Any]_valuesFc0Ul[U[5(a UROUnUR5HupVUR XVX#5 M gr_)rr@rrset)r(rj parse_values skip_unknown values_dictr)r6s r!r'AbstractConfig.__init__sF  (26>(J(JfnnPV &,,.KD HHT, =/r cT[U[5(a/UnURRU5(d [ U5eU$[U[ 5(aUnURU$[S[U5RSU<35e![ a [ U5ef=f)Nzexpected Option or str, found z: ) r@rrrvrrHKeyError TypeErrortyper)r(rBrmr)s r!_resolve_optionAbstractConfig._resolve_options nf - -#F<<--f55.v66M  , ,!D 5||D))0'001N3EG  5.t44 5s BB'cURU5nU(aUR U5nURb,URU5(d[URU5eX RUR'g![a0nU(a#[R[ U55 SnAgeSnAff=f![ an[URU5UeSnAff=f)aSet the value of an option. Args: * `option_or_name`: an `Option` object or its name (`str`). * `value`: the value to be assigned to given option. * `parse_values`: parse the configuration value from a string into its proper type, as per its `Option` object. The default behavior is to raise `ConfigValueValidationError` when the value is not of the right type. Useful when reading options from a file type that doesn't support as many types as Python. * `skip_unknown`: skip unknown configuration options. The default behaviour is to raise `ConfigUnknownOptionError`. Useful when reading options from a configuration file that has extra entries (e.g. for a later version of fontTools) N) rrlogdebugrHrL Exceptionrr)rNrr)r(rBr6rrrmes r!rAbstractConfig.sets, )).9F  I U+ ?? &vu/E/E,V[[%@ @$) V[[!#(  #a&!    I-fkk5AqH Is4A>B;> B8%B32B33B8; C!CC!cURU5nURUR;aURUR$U[LaU$UR$)a# Get the value of an option. The value which is returned is the first provided among: 1. a user-provided value in the options's ``self._values`` dict 2. a caller-provided default value to this method call 3. the global default for the option provided in ``fontTools.config`` This is to provide the ability to migrate progressively from config options passed as arguments to fontTools APIs to config options read from the current TTFont, e.g. .. code:: python def fontToolsAPI(font, some_option): value = font.cfg.get("someLib.module:SOME_OPTION", some_option) # use value That way, the function will work the same for users of the API that still pass the option to the function call, but will favour the new config mechanism if the given font specifies a value for that option. )rr)r_USE_GLOBAL_DEFAULTrJ)r(rBrJrms r!ruAbstractConfig.get)sO2%%n5 ;;$,, &<< , , - -N~~r c8URUR5$r_)r*rr~s r!copyAbstractConfig.copyIs~~dll++r c$URU5$r_)ru)r(rBs r!ryAbstractConfig.__getitem__Lsxx''r c$URX5$r_)r)r(rBr6s r! __setitem__AbstractConfig.__setitem__Osxx..r cTURU5nURUR gr_)rrr))r(rBrms r! __delitem__AbstractConfig.__delitem__Rs"%%n5 LL %r c6URR5$r_)rr}r~s r!r}AbstractConfig.__iter__Vs||$$&&r c,[UR5$r_)lenrr~s r!rAbstractConfig.__len__Ys4<<  r c`URRS[UR5S3$)N(r2)r*rr4rr~s r!rAbstractConfig.__repr__\s*..))*!D,>+?qAAr )rr_r)rjz4Union[AbstractConfig, Dict[Union[Option, str], Any]]rr`rr`)rBUnion[Option, str]rcr)FF)rBrr6rrr`rr`)rBrrJrrcr)rBrrcr)rBrr6rrcr)rBrrcr)rcz Iterable[str]rr)rrrrrrd classmethodrkr'rrrrurryrrr}rrrrr r!rrs059        $  2       HJ"" >D > > >,#" )**)*)* )*  )*XBU0;> @,(/&'!Br r) r __future__rlogging dataclassesrtypingrrrrr r r r r r getLoggerrr__all__rrrrrrrrobjectrrrr r!rs #!   ! 0)0 I; I k    ={ = $5!00"088 g8 vhgB^gBr