ó æNXc@südZddlmZddlZddlmZddlmZmZddl m Z m Z ddl m Z mZmZdd lmZd efd „ƒYZd efd „ƒYZde fd„ƒYZdefd„ƒYZdefd„ƒYZdS(s/A base class for objects that are configurable.iÿÿÿÿ(tprint_functionN(tdeepcopyi(tConfigtLazyConfigValue(t HasTraitstInstance(tindenttdedenttwrap_paragraphs(t iteritemstConfigurableErrorcBseZRS((t__name__t __module__(((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyR stMultipleInstanceErrorcBseZRS((R R (((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyR st ConfigurablecBsÂeZeed iƒZeddeƒZd„Zed„ƒZ d„Z ddd„Z d„Z d„Zedd„ƒZedd „ƒZedd „ƒZed „ƒZed „ƒZRS(s*traitlets.config.configurable.Configurablet allow_nonecKsÓ|jddƒ}|dk rR|jddƒdkrF|j|dW|S(sãextract 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. (Rtappendt_find_my_configRR#t _has_sectiontmerge(Rtcfgtcfgst my_configR"tsname((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyR%ks    c CsÔ|dkr!|jdtƒ}n|dkr<|jƒ}n|j|ƒ}|jƒwxot|ƒD]a\}}||kret|tƒr­t ||ƒ}|j |ƒ}nt ||t |ƒƒqeqeWWdQXdS(s load traits from a Config objectRN( RttraitstTrueR#R%thold_trait_notificationsR t isinstanceRtgetattrt get_valueRR(RR(R#R,R*tnamet config_valuetinitial((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyR„s    cCs;|jdtƒ}|jƒ}|j|d|d|ƒdS(sòUpdate all the class traits having ``config=True`` as 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. RR,R#N(R,R-R#R(RR2toldtnewR,R#((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyt_config_changedœs cCs)t|jƒ}|j|ƒ||_dS(s2Fire the traits events when the config is updated.N(RRR'(RRt newconfig((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyt update_config¬s cCs±|dks!t||ƒs!t‚g}|jd|jƒ|jt|dƒdƒxKt|jdtƒj ƒƒD]+\}}|j ||ƒ}|j|ƒquWdj |ƒS(s«Get the help string for this class in ReST format. If `inst` is given, it's current trait values will be used in place of class defaults. u %s optionsiu-Rs N( RR/tAssertionErrorR$R tlentsortedt class_traitsR-Rtclass_get_trait_helptjoin(R!tinstt final_helptktvthelp((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pytclass_get_help¶s!+cCsŒ|d ks!t||ƒs!t‚g}d|j|j|jjf}|j|ƒ|d k rˆ|jtdt||jƒdƒƒnyyt |j ƒ}Wnt k r´d }nX|d k rt |ƒdkrä|d d}n|jtd|dƒƒnd|jjkr3|jtd |j fƒƒn|jd ƒ}|d k rd jt|d ƒƒ}|jt|dƒƒnd j|ƒS(s£Get the help string for a single trait. If `inst` is given, it's current trait values will be used in place of the class default. s --%s.%s=<%s>s Current: %rii@i=s...s Default: %stEnums Choices: %rRDs iLN(RR/R:R R2t __class__R$RR0treprt default_valuet ExceptionR;tvaluest get_metadataR?R(R!ttraitR@tlinestheadertdvrRD((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyR>Æs*!  )     cCst|j|ƒƒdS(s4Get the help string for a single trait and print it.N(tprintRE(R!R@((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pytclass_print_helpæsc Cs#d„}ddd}d|j}|||dg}|jƒjdƒ}|r]|j}nt|ddƒ}|r˜|j||ƒƒ|jdƒnx{t|jd tƒƒD]a\}}|j d ƒpÏd}|j||ƒƒ|jd |j||jfƒ|jdƒq±Wd j |ƒS( s#Get the config class config sectioncSs,djt|dƒƒ}d|jddƒS(s"return a commented, wrapped block.s iNs# s s # (R?Rtreplace(ts((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyR"îst#t-iNs# %s configurationtt descriptiont__doc__RRDs# c.%s.%s = %rs ( R R=RRIR0R$R tclass_own_traitsR-RLR?( R!R"tbreakerRTRNtdescR2RMRD((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pytclass_config_sectionës"   % c Cs¯g}|j}xt|jdtƒjƒƒD]p\}}|jj}|d|j}d|krŠ|ddjd„|jDƒƒ7}n|d|7}|j |ƒy|j }t |ƒ}Wnt k rÛd}}nX|dk rJ|dk rJt|ƒdkr|d d }n|jd d ƒ}|j d |ƒ|j d ƒn|jdƒ} | dk r„|j tt| ƒdƒƒn |j dƒ|j d ƒq.Wdj|ƒS(swGenerate rST documentation for this class' config options. Excludes traits defined on parent classes. Rt.RFs : t|css|]}t|ƒVqdS(N(RH(t.0tx((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pys si@i=s...s\ns\\ns Default: ``%s``RWRDis No descriptions N(R R<RZR-RRGR2R?RKR$RIRHRJRR;RSRLRR( R!RNt classnameRBRMtttypettermlinetdvRPRD((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pytclass_config_rst_doc s4 +  '     (N(R R RRRR-RRt classmethodR#R%RRR7R9RER>RRR]Rf(((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyR"s  =   tSingletonConfigurablecBsPeZdZdZed„ƒZed„ƒZed„ƒZed„ƒZ RS(sôA 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. ccsMxF|jƒD]8}t||ƒr t|tƒr |tkr |Vq q WdS(sfWalk the cls.mro() for parent classes that are also singletons For use in instance() N(tmroR Rh(R!tsubclass((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyt _walk_mroDs  cCsI|jƒsdSx2|jƒD]$}t|j|ƒrd|_qqWdS(s>unset _instance for this class and singleton parents. N(t initializedRkR/t _instanceR(R!Rj((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pytclear_instanceQs  cOsq|jdkrA|||Ž}x |jƒD]}||_q+Wnt|j|ƒrZ|jStd|jƒ‚dS(s³Returns 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 sAMultiple incompatible subclass instances of %s are being created.N(RmRRkR/R R (R!targsRR@Rj((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pytinstance]scCst|dƒo|jdk S(sHas an instance been created?RmN(thasattrRmR(R!((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyRlŠsN( R R RYRRmRgRkRnRpRl(((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyRh:s   -tLoggingConfigurablecBs#eZdZedƒZd„ZRS(s«A 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. slogging.LoggercCsddlm}|jƒS(Niÿÿÿÿ(tlog(t traitletsRst get_logger(RRs((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyt _log_default˜s(R R RYRRsRv(((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyRrs (RYt __future__RtloggingtcopyRtloaderRRttraitlets.traitletsRRtipython_genutils.textRRRtipython_genutils.py3compatR RJR R RRhRr(((sU/data/av2000/mvv/env_mvv/lib/python2.7/site-packages/traitlets/config/configurable.pyts ÿV