U PeO@sUdZddlZddlmZddlmZddlmZddlmZddl m Z ddl m Z dd l mZmZmZmZmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlm Z m!Z!dZ"ej#Z#da$da%GdddeZ&ddZ'ddZ(ddZ)ddZ*ddZ+d-dd Z,Gd!d"d"e-Z.ed#e.Z/e.e0d#<e/j1eed$d%d&d'ekrddl2Z2dd(l3m4Z4d)d*Z5d+d,Z6e27e6dS).z_ Builder ====== Class used for the registering and application of rules for specific widgets. N)environ)join)copy)CodeType)partial)Factory)ParserParserException _handlers global_idmapParserRuleProperty)Logger) QueryDict)Cache) kivy_data_dir)register_context) resource_find) ObservableEventDispatcher)rBuilder BuilderBaseBuilderExceptionc@seZdZdZdS)rzIException raised when the Builder fails to apply a rule on a widget. N)__name__ __module__ __qualname____doc__rr5/tmp/pip-unpacked-wheel-xzebddm3/kivy/lang/builder.pyr(srcCs&z|jWStk r |YSXdSN) proxy_refAttributeError)widgetrrr get_proxy.sr"cOs||d<t|j|dS)Nargs)execco_value)Z __kvlang__idmaplargskwargsrrrcustom_callback5sr)c CsZ|\}}}}}td||||jf|jd7_t||}td|ft|||dS)Nz&Lang: call_fn %s, key=%s, value=%r, %rzLang: call_fn => value=%r)tracevaluecountevalsetattr) r#instancevelementkeyr,ruler&Ze_valuerrrcall_fn:s r5cCs6|ddk rdStdkr&|at|d<n t|d<|adS)N)_delayed_start StopIteration)r#r0r1rrrdelayed_call_fnFs  r9c Cs||dD]<\}} } } | dkr"q z|| | Wq tk rFYq Xq ||d=t|ddd}|dkr||dddS|d7}|j} ||dD]} t|ttfr|| d}|dk rt|ddr|| t ||||||} | |j | t | gn| |j | ddgn| t|d|| ddgt|| d}|dkrBqL|d7}qt|ttfr||d||} | r| |j |d|| g||dddS) aB Function that is called when an intermediate property is updated and `rebind` of that property is True. In that case, we unbind all bound funcs that were bound to attrs of the old value of the property and rebind them to the new value of the property. For example, if the rule is `self.a.b.c.d`, then when b is changed, we unbind from `b`, `c` and `d`, if they were bound before (they were not None and `rebind` of the respective properties was True) and we rebind to the new values of the attrs `b`, `c``, `d` that are not None and `rebind` is True. :Parameters: `base` A (proxied) ref to the base widget, `self` in the example above. `keys` A list of the name off the attrs of `base` being watched. In the example above it'd be `['a', 'b', 'c', 'd']`. `bound` A list 4-tuples, each tuple being (widget, attr, callback, uid) representing callback functions bound to the attributed `attr` of `widget`. `uid` is returned by `fbind` when binding. The callback may be None, in which case the attr was not bound, but is there to be able to walk the attr tree. E.g. in the example above, if `b` was not an eventdispatcher, `(_b_ref_, `c`, None)` would be added to the list so we can get to `c` and `d`, which may be eventdispatchers and their attrs. `s` The index in `keys` of the of the attr that needs to be updated. That is all the keys from `s` and further will be rebound, since the `s` key was changed. In bound, the corresponding index is `s - 1`. If `s` is None, we start from 1 (first attr). `fn` The function to be called args, `args` on bound callback. Nr6r*TrebindFr) unbind_uidReferenceErrorgetattrappend isinstancerrpropertyfbindupdate_intermediatesr)basekeysboundsfnr#r0r,fkZfunuidr?valproprrrrCTsP&      rCFc CsHt|}|t|j|d<t|j|}|j}|rJt} |||||dg} nt} |||||f} |j dk r|j D]p} | | d} | dkrqnt | d| } } g}d}|j}d}| ddD]}t | t tfr6| |d}|dk r"t |ddr"| |t| | ||| | }|| j|t|gd}n|| j|ddgn6t | ts\|t | d| |ddgn|| |ddgt | |d} | dkrq|d7}qt | t tfr| | d| | }|r|| j| d| |gd}|rn||qnzt|||fWStk rB}z0td }t|j|jd |jj||d W5d}~XYnXdS) NselfrrFr*r6Tr;r:{}: {}cause)rupdater rr rKr?r9r5Z watched_keysgetr>r@rrrArBrCtyper. Exceptionsysexc_inforctxlineformat __class__r)Ziselfr2r3r,r4r&ZdelayedZ bound_listZhandler_appendrHr#rErDrIrFZ was_boundr?rJrLrMrKetbrrrcreate_handlersv            r^cseZdZdZfddZeddZd%ddZd d Zd d Z d dZ e ddfddZ e ddfddZ ddZde dfddZddZddZddZdd Zd!d"Zd#d$ZZS)&ra/The Builder is responsible for creating a :class:`Parser` for parsing a kv file, merging the results into its internal rules, templates, etc. By default, :class:`Builder` is a global Kivy instance used in widgets that you can use to load other kv files in addition to the default ones. cs<tt|i|_i|_g|_i|_i|_g|_i|_ dSr) superr__init__ _match_cache_match_name_cachefilesdynamic_classes templatesrulesrulectxrNr[rrr`szBuilderBase.__init__cCsh|}t|j|_t|j|_t|j|_t|j|_t|j|_t|j|_|jrXt t |j|_|S)zCreates a instance of the class, and initializes to the state of ``builder``. :param builder: The builder to initialize from. :return: A new instance of this class. ) rrarbrcrdrelistrfrgAssertionErrordict)clsZbuilderobjrrr create_from s        zBuilderBase.create_fromutf8c Ks\t|p |}td||||d<t|d|d$}|}|j|f|W5QRSQRXdS)azInsert a file into the language builder and return the root widget (if defined) of the kv file. :parameters: `rulesonly`: bool, defaults to False If True, the Builder will raise an exception if you have a root widget inside the definition. `encoding`: File character encoding. Defaults to utf-8, z%Lang: load file %s, using %s encodingfilenamerencodingN)rr+openread load_string)rNrqrtr(fddatarrr load_files  zBuilderBase.load_filecstp fdd|jD|_|i}|jD]\}}|dkr8|||<q8||_|jkrr|jtdS)a8Unload all rules associated with a previously imported file. .. versionadded:: 1.0.8 .. warning:: This will not remove rules or templates already applied/used on current widgets. It will only effect the next widgets creation or template invocation. cs g|]}|djjkr|qSr*rXrq.0xrqrr @sz+BuilderBase.unload_file..r:N) rrf_clear_matchcachereitemsrcremoverZunregister_from_filename)rNrqreryrrr unload_file3s     zBuilderBase.unload_filec Ks|dd|dd|_}||jkr8td|zHt||d}|j |j| |j D]4\}}}|||f|j |<t j |t|j|dddqd|jD]\}}t j |||dd q|dr|jr|dd } td | |r|j s|js|jr|j||jrt |jjdd } g} | j| | d |j| |j|j| d| D]} | d| qX| d| | WSW5d|_XdS)aKInsert a string into the Language Builder and return the root widget (if defined) of the kv string. :Parameters: `rulesonly`: bool, defaults to False If True, the Builder will raise an exception if you have a root widget inside the definition. `filename`: str, defaults to None If specified, the filename used to index the kv rules. The filename parameter can be used to unload kv strings in the same way as you unload kv files. This can be achieved using pseudo file names e.g.:: Build.load_string(""" : Label: text="Hello" """, filename="myrule.kv") can be unloaded via:: Build.unload_file("myrule.kv") rulesonlyFrqNzOLang: The file {} is loaded multiples times, you might have unwanted behaviors.)contentrqT)rm is_templatewarn) baseclassesrqrzz/The file <%s> contain also non-rules directivesZ __no_builderroot rule_childrenr on_kv_post) setdefaultrSZ_current_filenamercr warningrZrrfextendrrerregisterrtemplaterdrrrUr?nameapply_class_lang_rules _apply_ruledispatch) rNstringr(rHparserrrmrrrqr!rchildrrrrwNsh         zBuilderBase.load_stringc Os|d}||jkrtd||j|\}}}d||f}td|}|dkrg} |dD]} | t| q\t|t| i}td|||} dd| D} |j | ||| d | S) a Create a specialized template using a specific context. .. versionadded:: 1.0.5 With templates, you can construct custom widgets from a kv lang definition by giving them a context. Check :ref:`Template usage `. rzUnknown <%s> template namez%s|%szkv.langN+cSsi|]\}}|t|qSr)r")r~rJr1rrr sz(BuilderBase.template..) template_ctx) rerUrrSsplitr?rrTtuplerr) rNr#rXrrr4rHr3rmZ rootwidgetsZbaseclsr!Z proxy_ctxrrrrs     zBuilderBase.templateNFc Csv||}tdt||f|s&dS|r:|dk r6|ng}|D]}|j|||||dq>|rr|D]}|d|q`dS)aSearch all the rules that match the name `rule_name` and apply them to `widget`. .. versionadded:: 1.10.0 :Parameters: `widget`: :class:`~kivy.uix.widget.Widget` The widget to whom the matching rules should be applied to. `ignored_consts`: set A set or list type whose elements are property names for which constant KV rules (i.e. those that don't create bindings) of that widget will not be applied. This allows e.g. skipping constant rules that overwrite a value initialized in python. `rule_children`: list If not ``None``, it should be a list that will be populated with all the widgets created by the kv rules being applied. .. versionchanged:: 1.11.0 `dispatch_kv_post`: bool Normally the class `Widget` dispatches the `on_kv_post` event to widgets created during kv rule application. But if the rules are manually applied by calling :meth:`apply`, that may not happen, so if this is `True`, we will dispatch the `on_kv_post` event where needed after applying the rules to `widget` (we won't dispatch it for `widget` itself). Defaults to False. .. versionchanged:: 1.11.0 Lang: Found %d rules for %sNignored_constsrr)match_rule_namer+lenrr) rNr! rule_namerrdispatch_kv_postrfr4wrrr apply_ruless"# zBuilderBase.apply_rulescCsv||}tdt||f|s&dS|r:|dk r6|ng}|D]}|j|||||dq>|rr|D]}|d|q`dS)aPSearch all the rules that match the widget and apply them. :Parameters: `widget`: :class:`~kivy.uix.widget.Widget` The widget whose class rules should be applied to this widget. `ignored_consts`: set A set or list type whose elements are property names for which constant KV rules (i.e. those that don't create bindings) of that widget will not be applied. This allows e.g. skipping constant rules that overwrite a value initialized in python. `rule_children`: list If not ``None``, it should be a list that will be populated with all the widgets created by the kv rules being applied. .. versionchanged:: 1.11.0 `dispatch_kv_post`: bool Normally the class `Widget` dispatches the `on_kv_post` event to widgets created during kv rule application. But if the rules are manually applied by calling :meth:`apply`, that may not happen, so if this is `True`, we will dispatch the `on_kv_post` event where needed after applying the rules to `widget` (we won't dispatch it for `widget` itself). Defaults to False. .. versionchanged:: 1.11.0 rNrr)matchr+rrr)rNr!rrrrfr4rrrrapplys" zBuilderBase.applycCs|j|jdSr)raclearrbrhrrrr#s zBuilderBase._clear_matchcachec Cs||jkstd|jiggd|j|<}||jks8t|j|}|dk rZt||dd<|jr|jddd|_|j|d|j<t|d}|d} | j } | D]\} } | | krq| | | <q| | _ | ||j r |j j||j j||j |W5QRX|jr8|j ||j ||j|W5QRX|jrj|j j||j j||j|W5QRXtj} tj}|jD]}|j}|dkrt|j|jd | |}||ri}tt}|d|ddid|dkr|d|ddizb|jD].}|j }t!|t"kr(t#||}|||j<q|j$D]}t#|j%|}|||j<q|dk rt'(d }t)|j|jd *|j+j,||d |W5d}~XYnXzd}|dD]\}}|D]}t6|t7st|j:ds t|j}|;|s(|dd}tt}||d|j|d<|<|t=||sbt>||jdkrtj?j@A|jBqqWn^t&k r}z>|dk rt'(d }t)|j|jd *|j+j,||d |W5d}~XYnX|j|=dS)Nr)idssethdlrrX#r*r)canvasz canvas.beforez canvas.afterzFCanvas instructions added in kv must be declared before child widgets.r:rOrPTrrrrrZon_rNZ on_parent)CrgrkrridrstriprlpoprrZcreate_missing canvas_beforerbefore _build_canvas canvas_root canvas_afterafterrrSrchildrenrr rXrYrr rR propertiesvaluesr%rTrr.handlersr,rUrVrWrrZr[rZ add_widgetrrr?rjZ ignore_prevrunbind_propertyreversedr@r r^r/ startswithZ is_event_typerBr)r ZWidgetparentr__self__)rNr!r4rootrulerrrZrctxZ_ids_rootZ_new_ids_key_valueZ Factory_getZFactory_is_templatecrulecnamermrXr&pruler,r\r]rr3Z widget_setrfrFrrrr'sL                                      zBuilderBase._apply_rulecCsj|j}|jt|jf}||kr&||Sg}|jD],\}}||r0|jrR|dd=||q0|||<|SzJReturn a list of :class:`ParserRule` objects matching the widget. N)rar[rrmrfravoid_previous_rulesr?)rNr!cacherJrfselectorr4rrrrs   zBuilderBase.matchcCsj|j}t|}|}||kr&||Sg}|jD],\}}||r0|jrR|dd=||q0|||<|Sr)rbstrlowerrfrrr?)rNrrrJrfrr4rrrrs   zBuilderBase.match_rule_namecCsdt}|dkrdS|tk r\zt|ddddWntk rDYnX|}|d}d|d<qdadS)zExecute all the waiting operations, such as the execution of all the expressions related to the canvas. .. versionadded:: 1.7.0 Nr6)r7r8r5r=)rNZ next_argsr#rrrsync s zBuilderBase.syncc Cst|tkr dSt|D]P}|D]F}|D]<\}}}}|dkr>q(z|||Wq(tk rbYq(Xq(q qt|=dS)aUnbind all the handlers created by the KV rules of the widget. The :attr:`kivy.uix.widget.Widget.uid` is passed here instead of the widget itself, because Builder is using it in the widget destructor. This effectively clears all the KV rules associated with this widget. For example: .. code-block:: python >>> w = Builder.load_string(''' ... Widget: ... height: self.width / 2. if self.disabled else self.width ... x: self.y + 50 ... ''') >>> w.size [100, 100] >>> w.pos [50, 0] >>> w.width = 500 >>> w.size [500, 500] >>> Builder.unbind_widget(w.uid) >>> w.width = 222 >>> w.y = 500 >>> w.size [222, 500] >>> w.pos [50, 500] .. versionadded:: 1.7.2 N)r rr<r=)rNrKZprop_callbacks callbacksrIrJrH bound_uidrrr unbind_widget s! zBuilderBase.unbind_widgetc Cs|j}|tkrdSt|}||kr&dS||D]F}|D]<\}}}} |dkrLq6z||| Wq6tk rpYq6Xq6q.||=|st|=dS)aQUnbind the handlers created by all the rules of the widget that set the name. This effectively clears all the rules of widget that take the form:: name: rule For example: .. code-block:: python >>> w = Builder.load_string(''' ... Widget: ... height: self.width / 2. if self.disabled else self.width ... x: self.y + 50 ... ''') >>> w.size [100, 100] >>> w.pos [50, 0] >>> w.width = 500 >>> w.size [500, 500] >>> Builder.unbind_property(w, 'height') >>> w.width = 222 >>> w.size [222, 500] >>> w.y = 500 >>> w.pos [550, 500] .. versionadded:: 1.9.1 N)rKr r<r=) rNr!rrKZ prop_handlersrrIrJrHrrrrrOs""  zBuilderBase.unbind_propertyc Cstdkrtdat|j|d}|jD]}|j}|dkrF|q*t|}t|tslt |j |j dzR|j D]B} | j} | j} t| tkrt||j| | | |d\} } t|| | qxWq*tk r} z0td}t | j | j d| jj| |dW5d} ~ XYq*Xq*dS) N InstructionrZClearz0You can add only graphics Instruction in canvas.Tr:rOrP)rrrSrrgrrrr@rrXrYrrr%rTrr^rr/rUrVrWrZr[r)rNrr!r4rr&rrinstrrr3r,_r\r]rrrrsL      zBuilderBase._build_canvas)rp)rrrrr` classmethodrorzrrwrrrrrrrrrrrr __classcell__rrrirrs6   T  3 / B/7rrzstyle.kvT)rZKIVY_PROFILE_LANG)escapeccs|jj|krdS|jD]\}}|j|kr.q|Vq|jD]}t|||D] }|VqLq<|jrzt|||jD] }|Vqn|jrt|||jD] }|Vq|j rt|||j D] }|VqdSr) rXrqrrrYr match_rulerrr)rHindexr4rMZprprrrrrrrs$    rcCslddddg}ddtjD}|D]}z t|}|}W5QRXWn.ttfk rt}z WYq W5d}~XYnX|d|dd g7}d }t|D]\}}|}t|}g} tjD]\} } | t ||| qt d d| D}|rd nd } |d | dt |dddt |dd|ddg 7}q|dg7}q |dg7}tdddd} | d|W5QRXtddS)NzzcSsh|]}|djjqSr{r|r}rrr sz%dump_builder_stats..z

z

zrcSsh|] }|jqSr)r-r}rrrrs)r)rrrz$zz zz
r*z
z
zzbuilder_stats.htmlrzutf-8rsz'Profiling written at builder_stats.html)rrfru readlinesIOError TypeError enumeraterstriprrrsumrZrwriterprint)htmlrcrHrIlinesr\r-rrYZ matched_prpZpsnr4colorrxrrrdump_builder_statssN       r)F)8rrVosros.pathrrtypesr functoolsrZ kivy.factoryrZkivy.lang.parserrr r r r Z kivy.loggerr Z kivy.utilsrZ kivy.cacherZkivyrZ kivy.contextrZkivy.resourcesrZ kivy._eventrr__all__r+rr7rr"r)r5r9rCr^objectrr__annotations__rzatexitrrrrrrrrrsP             [ I3  &