U -eV@s0dZddlmZddlZddlZddlmZddlm Z ddl m Z m Z m Z mZmZmZmZmZmZmZddlmZddlmZdd lmZmZd d lmZmZmZm Z ej!rej"ej#ej$ej fZ%nej Z%Gd d d e&Z'Gddde'Z(GdddeZ)Gddde)Z*ej+dddZ,Gddde*Z-dS)z/A base class for objects that are configurable.) annotationsN)deepcopy)dedent) Any ContainerDict HasTraitsInstance TraitTypedefaultobserveobserve_compatvalidate)warnings)Bunch)indentwrap_paragraphs)ConfigDeferredConfigLazyConfigValue_is_section_keyc@s eZdZdS)ConfigurableErrorN__name__ __module__ __qualname__rr^/var/www/html/Darija-Ai-Train/env/lib/python3.8/site-packages/traitlets/config/configurable.pyr(src@s eZdZdS)MultipleInstanceErrorNrrrrrr,srcs$eZdZeediZedddZdddfdd Zed d d d Z dddddZ d6dddddddZ e de dddddZdddddZed7dd d!d"d#Zed8d$dd%d d&d'd(Zed9ddd!d)d*Zed$d+d,d-d.d/Zed:d0d d1d2d3Zed d d4d5ZZS); Configurablerz*traitlets.config.configurable.ConfigurableT) allow_nonet.AnyNone)kwargsreturnc sdd}|dk r4dddkr.|jd<||_dd}tjftdddfdd }|||dk r||_n ||j| |D]}t |||qdS) aCreate a configurable given a config config. Parameters ---------- config : Config If this is empty, default values are used. If config is a :class:`Config` instance, it will be used to configure the instance. parent : Configurable instance, optional The parent Configurable instance of this object. Notes ----- Subclasses of Configurable must call the :meth:`__init__` method of :class:`Configurable` *before* doing anything else and using :func:`super`:: class MyConfigurable(Configurable): def __init__(self, config=None): super(MyConfigurable, self).__init__(config=config) # Then any other code you need to finish initialization. This ensures that instances will be configured properly. parentNconfigrr#changer%cs|jkr|jdS)zRecord traits set by both config and kwargs. They will need to be overridden again after loading config. N)nameadd)r)Zconfig_override_namesr$rrnotice_config_overrideas z5Configurable.__init__..notice_config_override) popgetr'r&super__init__setr _load_configZ unobservesetattr)selfr$r&r'r-r* __class__r,rr19s       zConfigurable.__init__z list[str]r%csfddtjDS)zreturn section names as a listcs&g|]}t|trt|r|jqSr issubclassr r).0cclsrr s z.Configurable.section_names..)reversed__mro__r=rr=r section_namess zConfigurable.section_namesr)cfgr%cCsX|g}|jr||j|t}|D]*}|D]}||r4|||q4q(|S)aextract my config from a global Config object will construct a Config object of only the config values that apply to me based on my mro(), as well as those of my parent(s) if they exist. If I am Bar and my parent is Foo, and their parent is Tim, this will return merge following config sections, in this order:: [Bar, Foo.Bar, Tim.Foo.Bar] With the last item being the highest priority. )r&append_find_my_configrrBZ _has_sectionmerge)r5rCZcfgs my_configr<ZsnamerrrrEs   zConfigurable._find_my_configNzlist[str] | None)rCrBtraitsr%c Csr|dkr|jdd}|dkr$|}||}|0|D]\}}||krt|trtt||}||}nt|t r|||}t ||t |qBt |sBt|t sBddlm}t|tr|jdk st|jj} ndddd d } |||} d |d |jjd } t| dkr2| d| dd7} n(t| dkrZ| djdt| d7} | | qBW5QRXdS)z load traits from a Config objectNTr'r)get_close_matchesr"r#)msgr%cSstj|tddS)N  stacklevel)rwarn UserWarning)rKrrrrOsz'Configurable._load_config..warnzConfig option `z` not recognized by `z`.rz Did you mean `z`?z# Did you mean one of: `{matches}`?, )matches)rHrBrEZhold_trait_notificationsitems isinstancergetattr get_valuerr4rrrdifflibrJLoggingConfigurablelogAssertionErrorwarningr7rlenformatjoinsorted) r5rCrBrHrGr*Z config_valueinitialrJrOrRrKrrrr3s:            zConfigurable._load_configr'rr(cCs*|jdd}|}|j|j||ddS)zUpdate all the class traits having ``config=True`` in metadata. For any class trait with a ``config`` metadata attribute that is ``True``, we update the trait with the value of the corresponding config entry. TrI)rHrBN)rHrBr3new)r5r)rHrBrrr_config_changeds zConfigurable._config_changed)r'r%cCs&t|j|_|||j|dS)z%Update config and load the new valuesN)rr'r3rF)r5r'rrr update_configs  zConfigurable.update_configzHasTraits | Nonestr)instr%cCs|dkst||stg}ddd|jD}||jd|d|t|ddt|jd d  D]\}}| ||}||qrd |S) zGet the help string for this class in ReST format. If `inst` is given, its current trait values will be used in place of class defaults. NrQcss|] }|jVqdSN)rr;prrr sz.Configurable.class_get_help..(z ) optionsr-TrI ) rTrZr^ __bases__rDrr\r_ class_traitsrSclass_get_trait_help)r>reZ final_helpZ base_classes_vhelprrrclass_get_helps  zConfigurable.class_get_helpzTraitType[t.Any, t.Any]z str | None)traitrehelptextr%c Cs|dkst||stg}d|jd|j}t|ttfr|jdd}t|trZd}nd|jj }|dkr|d|d }q|d |d }n|d |jjd }| ||dkr|j }|d krd t |d}| t|d|jjkr | td||dk r:| tdt||jp,d nbz |}Wntk r`d}YnX|dk rt|dkr|ddd }| td|d |S)aGet the helptext string for a single trait. :param inst: If given, its current trait values will be used in place of the class default. :param helptext: If not given, uses the `help` attribute of the current trait. Nz--. multiplicityrDz=z <%s-item-1>=... z=<>rlLEnumz Choices: %sz Current: @=z Default: %s)rTrZrr*rrmetadatar/r7lowerrDrrr^rrinforUdefault_value_repr Exceptionr\) r>rtrerulinesheaderrwZ sample_valuedvrrrrros>   $   z!Configurable.class_get_trait_helpcCst||dS)z4Get the help string for a single trait and print it.N)printrs)r>rerrrclass_print_helpAszConfigurable.class_print_helpzt.Sequence[type[HasTraits]]ztype[Configurable])rtclassesr%cCsF|}|D]4}t|tr ||kr |jdd|jd|kr |}q |S)a7Get the class that defines a trait For reducing redundant help output in config files. Returns the current class if: - the trait is defined on this class, or - the class where it is defined would not be in the config file Parameters ---------- trait : Trait The trait to look for classes : list The list of other classes to consider for redundancy. Will return `cls` even if it is not defined on `cls` if the defining class is not in `classes`. TrIN)mror:r Zclass_own_traitsr/r*)r>rtrZ defining_clsr&rrr_defining_classFs zConfigurable._defining_classz"t.Sequence[type[HasTraits]] | None)rr%c Csddddd}d}ddd|jD}d |jd |d }|||g}|d }|r`|j}|spt|d d}|r||||dt|jdd D]\}} | } |r| | |} n|} | |kr| j r||| j dt | jkr|d| |d| n<| j r<||| j ddd|d| jd||d|jd|d| |dqd|S)zGet the config section for this class. Parameters ---------- classes : list, optional The list of other classes in the config file. Used to reduce redundant information. rd)sr%cSs dt|d}d|ddS)z"return a commented, wrapped block.z Nz## rlz # )r^rreplace)rrrrr<osz,Configurable.class_config_section..czO#------------------------------------------------------------------------------rQcss|]}t|tr|jVqdSrfr9rgrrrriws z4Configurable.class_config_section..z# rjz) configuration description__doc__r|TrIr~z# Choices: %sz# Default: %srlrrz # See also: rvz# c.z = )r^rmrrnr/ default_valuerUrDr_rSrrrrtypersplit) r>rr<breakerZparent_classesrrdescr*rtZ default_reprdefining_classrrrclass_config_sectionds<      z!Configurable.class_config_sectionc Csg}|j}t|jddD]\}}|jj}|d|j}d|krV|d|7}n |d|7}||z |}Wnt k rd}YnX|dk rt |dkr|ddd }| d d }|t d ||d |j pd}|t t||d qd|S)zwGenerate rST documentation for this class' config options. Excludes traits defined on parent classes. TrIrvr~z : Nrrryz\nz\\nzDefault: ``%s``r|zNo descriptionrl)rr_rnrSr7r*Zinfo_rstrDrrr\rrrrrr^) r>r classnamerprtttypeZtermlinerrrrrrclass_config_rst_docs.         z!Configurable.class_config_rst_doc)NN)N)NN)N)N)rrrr rr'r&r1 classmethodrBrEr3r r rbrcrsrorrrr __classcell__rrr6rr 5s6  H28;r c@sXeZdZdZedddZeddddd d Zeddd d d Z dd ddZ dS)rXzA parent class for Configurables that log. Subclasses have a log trait, and the default behavior is to get the logger from the currently running Application. z Logger or LoggerAdapter instanceF)rrr!rYr LoggerType)proposalr%cCs<t|jtjtjfs6tj|jjd|jdt dd|jS)Nz..log should be a Logger or LoggerAdapter, got rvrM) rTvalueloggingLogger LoggerAdapterrrOr7rrP)r5rrrr _validate_logsz!LoggingConfigurable._validate_logr8cCs@t|jtr,|jdk stttj|jjSddl m}| S)Nr)rY) rTr&rXrZtcastrrrYZ traitletsZ get_logger)r5rYrrr _log_defaults   z LoggingConfigurable._log_defaultzlogging.Handler | NonecCs@|js dSt|jtjr|jn|jj}t|dds6dS|jdS)zReturn the default Handler Returns None if none can be found Deprecated, this now returns the first log handler which may or may not be the default one. Nhandlersr)rYrTrrloggerrUr)r5rrrr_get_log_handlers  z$LoggingConfigurable._get_log_handlerN) rrrrrrYrrr rrrrrrrXs  rXCTSingletonConfigurable)boundc@sbeZdZdZdZeddddZedddd Zed d d d d ddZeddddZ dS)rzA configurable that only allows one instance. This class is for classes that should only have one instance of itself or *any* subclass. To create and retrieve such a class use the :meth:`SingletonConfigurable.instance` method. Nz4t.Generator[type[SingletonConfigurable], None, None]r8ccs4|D]&}t||rt|tr|tkr|VqdS)zfWalk the cls.mro() for parent classes that are also singletons For use in instance() N)rr:rr>subclassrrr _walk_mros zSingletonConfigurable._walk_mror#cCs0|s dS|D]}t|j|rd|_qdS)z5unset _instance for this class and singleton parents.N) initializedrrT _instancerrrrclear_instances   z$SingletonConfigurable.clear_instanceztype[CT]r"r)r>argsr$r%cOs\|jdkr(|||}|D] }||_qt|j|r:|jStd|jdt|jjdS)aReturns a global instance of this class. This method create a new instance if none have previously been created and returns a previously created instance is one already exists. The arguments and keyword arguments passed to this method are passed on to the :meth:`__init__` method of the class upon instantiation. Examples -------- Create a singleton class using instance, and retrieve it:: >>> from traitlets.config.configurable import SingletonConfigurable >>> class Foo(SingletonConfigurable): pass >>> foo = Foo.instance() >>> foo == Foo.instance() True Create a subclass that is retrived using the base class instance:: >>> class Bar(SingletonConfigurable): pass >>> class Bam(Bar): pass >>> bam = Bam.instance() >>> bam == Bar.instance() True NzAn incompatible sibling of 'z(' is already instantiated as singleton: )rrrTrrr)r>rr$rerrrrinstance!s    zSingletonConfigurable.instanceboolcCst|do|jdk S)zHas an instance been created?rN)hasattrrr=rrrrMsz!SingletonConfigurable.initialized) rrrrrrrrrrrrrrrs +).r __future__rrtypingrcopyrtextwraprZtraitlets.traitletsrrrrr r r r r rZtraitlets.utilsrZtraitlets.utils.bunchrZtraitlets.utils.textrrloaderrrrr TYPE_CHECKINGUnionrrrrrrr rXTypeVarrrrrrrs,   0   /