a @¸Dfp$ã@s”dZddlmZddlZe e¡ZddlZddlZddl m Z m Z m Z m Z ddlmZddlmZddlmZe r~d d lmZd ZGd d „d ƒZdS)zR Encapulate the management of Document models with a DocumentModelManager class. é)Ú annotationsN)Ú TYPE_CHECKINGÚCallableÚ GeneratorÚIteratoré)ÚID)ÚModel)ÚMultiValuedDicté)ÚDocument)ÚDocumentModelManagerc@sveZdZUdZded<ded<ded<ded <d ed <eƒZd ed <ddœdd„Zddœdd„Zdddœdd„Z ddddœdd„Z dddœdd „Z d!dœd"d#„Z ddœd$d%„Z ejd&dœd'd(„ƒZd)d*d+œd,d-„Zdd.dœd/d0„Zd)d.d+œd1d2„Zeddœd3d4„ƒZdHd6dd7œd8d9„Zddœd:d;„Zddœdd?„Zdd@d@ddAœdBdC„ZddœdDdE„ZddœdFdG„Zd5S)Ir zÐ Manage and provide access to all of the models that belong to a Bokeh Document. The set of "all models" means specifically all the models reachable from references form a Document's roots. zweakref.ReferenceType[Document]Ú _documentÚintÚ _freeze_countzdict[ID, Model]Ú_modelsz set[Model]Ú _new_modelszMultiValuedDict[str, Model]Ú_models_by_namezset[ID]Ú_seen_model_idsr )ÚdocumentcCs4t |¡|_d|_i|_tƒ|_tƒ|_tƒ|_ dS)zœ Args: document (Document): A Document to manage models for A weak reference to the Document will be retained rN) ÚweakrefÚrefrrrr rÚsetrr)Úselfr©rúb/nfs/NAS7/SABIOD/METHODE/ermites/ermites_venv/lib/python3.9/site-packages/bokeh/document/models.pyÚ__init__Fs  zDocumentModelManager.__init__)ÚreturncCs t|jƒS©N)Úlenr©rrrrÚ__len__UszDocumentModelManager.__len__rr )ÚidrcCs |j|Sr©r©rr"rrrÚ __getitem__Xsz DocumentModelManager.__getitem__ÚNone)r"ÚmodelrcCs||j|<dSrr#)rr"r'rrrÚ __setitem__[sz DocumentModelManager.__setitem__ÚboolcCs ||jvSrr#r$rrrÚ __contains__^sz!DocumentModelManager.__contains__zIterator[Model]cCst|j ¡ƒSr)ÚiterrÚvaluesr rrrÚ__iter__aszDocumentModelManager.__iter__cCs$|j ¡D] }| ¡q |`|`dS)z6 Clean up references to the Documents models N)rr,Údestroyr)rÚmrrrr.ds zDocumentModelManager.destroyzGenerator[None, None, None]ccs| ¡dV| ¡dS)aˆ Defer expensive model recompuation until intermediate updates are complete. Making updates to the model graph might trigger events that cause more updates. This context manager can be used to prevent expensive model recompuation from happening until all events have finished and the Document state is quiescent. Example: .. code-block:: python with models.freeze(): # updates that might change the model graph, that might trigger # updates that change the model graph, etc. Recompuation will # happen once at the end. N)Ú _push_freezeÚ _pop_freezer rrrÚfreezeqszDocumentModelManager.freezeÚstrz list[Model])ÚnamercCs |j |¡S)z» Find all the models for this Document with a given name. Args: name (str) : the name of a model to search for Returns A list of models )rÚget_all©rr4rrrÚget_all_by_name‰s z$DocumentModelManager.get_all_by_namez Model | NonecCs|j |d¡S)zè Find the model for this Document with a given ID. Args: id (ID) : model ID to search for If no model with the given ID exists, returns None Return: a Model or None N)rÚgetr$rrrÚ get_by_id•s zDocumentModelManager.get_by_idcCs|j |d|›d¡S)a Find a single model for this Document with a given name. If multiple models are found with the name, an error is raised. Args: name (str) : the name of a model to search for Returns A model with the given name, or None z!Found more than one model named 'ú')rZget_oner6rrrÚget_one_by_name¢s z$DocumentModelManager.get_one_by_namecst‡fdd„ˆj ¡DƒƒS)Nc3s|]}|ˆjvr|VqdSr)r)Ú.0r'r rrÚ ²óz9DocumentModelManager.synced_references..)rrr,r rr rÚsynced_references°sz&DocumentModelManager.synced_referencesNzCallable[[Model], bool] | None)Ú is_still_newrcs2ˆdur|j ¡nt‡fdd„|jDƒƒ|_dS)z4 Clean up transient state of the document's models. Nc3s|]}ˆ|ƒr|VqdSrr)r<Z new_model©r@rrr=¹r>z4DocumentModelManager.flush_synced..)rÚclearr)rr@rrArÚ flush_synced´s z!DocumentModelManager.flush_syncedcCs|jdkr| ¡dS)zf Recompute the set of all models, if not currently frozen Returns: None rN©rÚ recomputer rrrÚ invalidate»s zDocumentModelManager.invalidatec CsÖ| ¡}|durdStƒ}|jD]}|| ¡O}q t|j ¡ƒ}||}||}i}tƒ}|D]&} | || j<| jdur^|  | j| ¡q^|D]} |j   | j¡|   ¡qŠ|D]} |   |¡|j  | ¡qª||_||_dS)a Recompute the set of all models based on references reachable from the Document's current roots. This computation can be expensive. Use ``freeze`` to wrap operations that update the model object graph to avoid over-recompuation .. note:: Any models that remove during recomputation will be noted as "previously seen" N)rrÚrootsZ referencesrr,r r"r4Ú add_valuerÚaddZ_detach_documentZ_attach_documentrr) rrZ new_modelsÚmrZ old_modelsZ to_detachZ to_attachZ recomputedZrecomputed_by_nameÚmnZmdÚmarrrrEÅs.      zDocumentModelManager.recomputecCs ||jvS)zÄ Report whether a model id has ever previously belonged to this Document. Args: id (ID) : the model id of a model to check Returns: bool )rr$rrrÚseenôs zDocumentModelManager.seenz str | None)r'Úold_nameÚnew_namercCs0|dur|j ||¡|dur,|j ||¡dS)aD Update the name for a model. .. note:: This function and the internal name mapping exist to support optimizing the common case of name lookup for models. Keeping a dedicated name index is faster than using generic ``bokeh.query`` functions with a name selector Args: model (Model) : a model to update the name for old_name(str, None) : a previous name for the model, or None new_name(str, None) : a new name for the model, or None Returns: None N)rZ remove_valuerH)rr'rNrOrrrÚ update_namesz DocumentModelManager.update_namecCs|jd7_dS)Nr )rr rrrr0sz!DocumentModelManager._push_freezecCs$|jd8_|jdkr | ¡dS)Nr rrDr rrrr1s z DocumentModelManager._pop_freeze)N)Ú__name__Ú __module__Ú __qualname__Ú__doc__Ú__annotations__rrrr!r%r(r*r-r.Ú contextlibÚcontextmanagerr2r7r9r;Úpropertyr?rCrFrErMrPr0r1rrrrr 6s8     / r )rTÚ __future__rÚloggingÚ getLoggerrQÚlogrVrÚtypingrrrrZ core.typesrr'r Zutil.datatypesr rr Ú__all__r rrrrÚs