ó äÛi^c@@s dZddlmZmZddlmZddlZddlmZm Z m Z ddl m Z m Z mZmZmZddlmZmZmZd efd „ƒYZd efd „ƒYZd e fd„ƒYZdefd„ƒYZdefd„ƒYZdS(s/A base class for objects that are configurable.i(tprint_functiontabsolute_import(tdeepcopyNi(tConfigtLazyConfigValuet_is_section_key(t HasTraitstInstancetobservetobserve_compattdefault(tindenttdedenttwrap_paragraphstConfigurableErrorcB@seZRS((t__name__t __module__(((s<lib/python2.7/site-packages/traitlets/config/configurable.pyRstMultipleInstanceErrorcB@seZRS((RR(((s<lib/python2.7/site-packages/traitlets/config/configurable.pyRst ConfigurablecB@sÔeZeediƒZeddeƒZd„Zed„ƒZ d„Z ddd„Z e dƒed„ƒƒZd„Zedd „ƒZedd „ƒZedd „ƒZed „ƒZed „ƒZRS(s*traitlets.config.configurable.Configurablet allow_nonecK@sÓ|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((s<lib/python2.7/site-packages/traitlets/config/configurable.pyR)js    c C@sË|d kr!|jdtƒ}n|d kr<|jƒ}n|j|ƒ}|jƒnxf|jƒD]X\}}||krÆt|tƒr­t ||ƒ}|j |ƒ}nt ||t |ƒƒqet |ƒ ret|tƒ reddlm}t|tƒr|jj} n d„} |||ƒ} djd|d|jjƒ} t| ƒdkrv| d jd | dƒ7} n:t| ƒdkr°| d jd d jt| ƒƒƒ7} n| | ƒqeqeWWd QXd S(s load traits from a Config objectRi(tget_close_matchescS@stj|ddƒS(Nt stackleveli (twarningstwarn(tmsg((s<lib/python2.7/site-packages/traitlets/config/configurable.pytŸsu5Config option `{option}` not recognized by `{klass}`.toptiontklassiu Did you mean `{matches}`?tmatchess# Did you mean one of: `{matches}`?s, N(RttraitstTrueR'R)thold_trait_notificationsRt isinstanceRtgetattrt get_valueRRRRtdifflibR0tLoggingConfigurabletlogtwarningtformatt __class__Rtlentjointsorted( RR,R'R9R.tnamet config_valuetinitialR0R3R8R4((s<lib/python2.7/site-packages/traitlets/config/configurable.pyRƒs2      (RcC@s>|jdtƒ}|jƒ}|j|jd|d|ƒdS(sòUpdate 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. RR9R'N(R9R:R'Rtnew(RtchangeR9R'((s<lib/python2.7/site-packages/traitlets/config/configurable.pyt_config_changedªs  cC@s3t|jƒ|_|j|ƒ|jj|ƒdS(s%Update config and load the new valuesN(RRRR+(RR((s<lib/python2.7/site-packages/traitlets/config/configurable.pyt update_config¼s cC@s±|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(RRERGt class_traitsR:Rtclass_get_trait_helpRF(R%tinstt final_helptktvthelp((s<lib/python2.7/site-packages/traitlets/config/configurable.pytclass_get_helpÌs!+cC@sƒ|d ks!t||ƒs!t‚g}d|j|j|jjf}|j|ƒ|d k rˆ|jtdt||jƒdƒƒnvy|j ƒ}Wnt k r±d }nX|d k rþt |ƒdkrá|d d}n|jtd|dƒƒnd|jjkr0|jtd |j fƒƒn|j }|d krvd 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: %rts iLN(RR<RORRHRDR(R R=tdefault_value_reprt ExceptionREtvaluesRVRFR (R%ttraitRRtlinestheadertdvrRV((s<lib/python2.7/site-packages/traitlets/config/configurable.pyRQÜs*!  )      cC@st|j|ƒƒdS(s4Get the help string for a single trait and print it.N(tprintRW(R%RR((s<lib/python2.7/site-packages/traitlets/config/configurable.pytclass_print_helpüsc C@sEd„}ddd}djd„|jDƒƒ}d|j|f}|||dg}|jƒjd ƒ}|r|j}n|sšt|d dƒ}n|rÃ|j||ƒƒ|jdƒnxrt|j d t ƒj ƒƒD]R\}}|j||j ƒƒ|jd |j||j ƒfƒ|jdƒqâWd j|ƒS(s#Get the config class config sectioncS@s,djt|dƒƒ}d|jddƒS(s"return a commented, wrapped block.s iNs## s s # (RFR treplace(ts((s<lib/python2.7/site-packages/traitlets/config/configurable.pyR&st#t-iNt,cs@s|]}|jVqdS(N(R(t.0tp((s<lib/python2.7/site-packages/traitlets/config/configurable.pys ss# %s(%s) configurationRYt descriptiont__doc__Rs #c.%s.%s = %ss (RFt __bases__RRPRt default_valueR=R(RGtclass_own_traitsR:RRVRZ( R%R&tbreakertparent_classesRdR^tdescRHR]((s<lib/python2.7/site-packages/traitlets/config/configurable.pytclass_config_sections$  +#c C@szg}|j}x[t|jdtƒjƒƒD];\}}|jj}|d|j}d|krŠ|ddjd„|jDƒƒ7}n|d|7}|j |ƒy|j ƒ}Wnt k rÎd}nX|dk r1t |ƒdkrþ|d d }n|jd d ƒ}|j d |ƒ|j d ƒn|jp=d}|j tt|ƒdƒƒ|j d ƒq.Wdj|ƒS(swGenerate rST documentation for this class' config options. Excludes traits defined on parent classes. Rt.RXs : t|cs@s|]}t|ƒVqdS(N(trepr(Rhtx((s<lib/python2.7/site-packages/traitlets/config/configurable.pys 0si@i=s...s\ns\\ns Default: ``%s``RYsNo descriptionis N(RRGRnR:RRDRHRFR\R(RZR[RRERcRVR R ( R%R^t classnameRTR]tttypettermlineR`RV((s<lib/python2.7/site-packages/traitlets/config/configurable.pytclass_config_rst_doc s. +  '    (N(RRRRRR:RRt classmethodR'R)RRRR RMRNRWRQRbRrRz(((s<lib/python2.7/site-packages/traitlets/config/configurable.pyR!s" = '  R@cB@s/eZdZedƒZedƒd„ƒ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.LoggerRAcC@sddlm}|jƒS(Ni(RA(t traitletsRAt get_logger(RRA((s<lib/python2.7/site-packages/traitlets/config/configurable.pyt _log_defaultTs(RRRkRRAR R~(((s<lib/python2.7/site-packages/traitlets/config/configurable.pyR@Ls tSingletonConfigurablecB@sPeZdZdZed„ƒ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. cc@sMxF|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$R(R%tsubclass((s<lib/python2.7/site-packages/traitlets/config/configurable.pyt _walk_mrods  cC@sI|jƒsdSx2|jƒD]$}t|j|ƒrd|_qqWdS(s>unset _instance for this class and singleton parents. N(t initializedR‚R<t _instanceR(R%R((s<lib/python2.7/site-packages/traitlets/config/configurable.pytclear_instanceqs  cO@sq|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(R„RR‚R<RR(R%targsRRRR((s<lib/python2.7/site-packages/traitlets/config/configurable.pytinstance}scC@st|dƒo|jdk S(sHas an instance been created?R„N(thasattrR„R(R%((s<lib/python2.7/site-packages/traitlets/config/configurable.pyRƒªsN( RRRkRR„R{R‚R…R‡Rƒ(((s<lib/python2.7/site-packages/traitlets/config/configurable.pyRZs   -(Rkt __future__RRtcopyRR2tloaderRRRttraitlets.traitletsRRRR R tipython_genutils.textR R R R[RRRR@R(((s<lib/python2.7/site-packages/traitlets/config/configurable.pyts (ÿ,