U /eg@s4dZddlmZddlZeeZddlZddlm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZddlmZddlmZmZe rede de fd Zd d d d dZn ddlmZddlm Z m!Z!ddl"m#Z#ddl$m%Z%m&Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.m/Z/m0Z0e rbddl1m2Z2ddl3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:dZ;e rxee2e6fZd$d%d!d&d'Z?d(d)d*d+d,Z@d(d-d.d/ZAGd0d1d1eBZCGd2d d eCd3ZDe ZEGd4d5d5eZFGd6d7d7eZGGd8d9d9eZHGd:d;d;eHZIdi}t|D](\}}t|tr||=|jr|j||<q|Sr)tupleitems isinstancer$Zdefault_overriddendefault)rBoverridden_defaultsnameproprrr_overridden_defaultsos  rJ)rBcCs6i}t|D] \}}t|tr||=|||<q|Sr)rCrDrEr!)rB generatorsrH generatorrrr _generatorsxs   rMcsVeZdZUdZded<ded<ded<ddd d fd d Zddd dddZZS)r2aY Specialize the construction of |HasProps| classes. This class is a `metaclass`_ for |HasProps| that is responsible for creating and adding the |PropertyDescriptor| instances that delegate validation and serialization to |Property| attributes. .. _metaclass: https://docs.python.org/3/reference/datamodel.html#metaclasses Dict[str, Property[Any]]__properties__rA__overridden_defaults____themed_values__strzTuple[type, ...]r@) class_namebasesrBc st|}t|}i}|D]P\}}||} | D]8} | j}||krXtd|d|| ||<| j||<q2q||d<||d<t||||S) z%Two property generators both created .rOrP) rJrMrDZmake_descriptorsrH RuntimeErrorpropertysuper__new__) r4rSrTrBrGrK propertiesrHrLZ descriptors descriptor __class__rrrZs zMetaHasProps.__new__None)rSrTrc Csi}dd|DD]}||jddqdd|jD}||@}|rptd|d|jd td d |j|jdd}|rtd |d|jd td d dS)Ncss|]}t|tr|VqdSr)r5r1).0xrrr s z(MetaHasProps.__init__..T _with_propscSs i|]\}}t|tr||qSr)rEr"r`kvrrr s z)MetaHasProps.__init__..z Properties z in class z were previously declared on a parent class. It never makes sense to do this. Redundant properties should be deleted here, or onthe parent class. Override() can be used to change a default value of a base class property.r) stacklevelz Overrides of z does not override anything.) updater[__dict__rDkeysrr7RuntimeWarningrP) r4rSrT_Zbase_propertiesbaseZown_propertiesZ redeclaredZunused_overridesrrr__init__szMetaHasProps.__init__)r7 __module__ __qualname__r8__annotations__rZrp __classcell__rrr]rr2s  r2cseZdZUdZdZded<ded<ded<ded<d d d fd d Zddd dfdd Zdddfdd ZddddddZ ddddZ e Z ddddd Z ded!<ded"<e d#d$d%d&d'Zd d d%d(d)Zd*d*d+dd,d-d.d d/d0d1Zd d d2d3d4Zd*d*d+d5d6d.d d7d8d9Zee d:d;ddd?d@Zee dd;ddAdBd>dCd@Ze d:d;dddBd>dDd@Zee ed*ddEdAdFdGdHdIZee ed*d:dEdr^rErX#_raise_attribute_error_with_matches)rzrHr{r[r\r]rrr~s   zHasProps.__setattr__)rHrcsj|drt|S|jdd}||kr6t|St|j|d}t|trZt|S|||dSr|) r}rY __getattr__r[r>r^rErXr)rzrHr[r\r]rrrs      zHasProps.__getattr__z Iterable[str]r )rHr[rc CsTt||d}}|s(t|d}}td|d|jjd|dt|dS)NZsimilarpossiblezunexpected attribute z to z, z attributes are )difflibget_close_matcheslowersortedAttributeErrorr^r7r)rzrHr[matchestextrrrr sz,HasProps._raise_attribute_error_with_matches)rcCs|jj}|dS)Nz(...))r^r7)rzrHrrr__str__szHasProps.__str__)otherrcCs$t||jsdS||kSdS)z Structural equality of models. Args: other (HasProps) : the other instance to compare to Returns: True, if properties are structurally equal, otherwise False FN)rEr^properties_with_values)rzrrrrequals s zHasProps.equals__view_model____view_module__r+ModelRef) serializerrcCs ||}|dk r|Sdd|jD}t|dkr8d}n$t|dkrT|d|}ntd|j}|j}|dks|dddkrd}g}g}|jD].} | | } d} | j j } | t | | | d qt|d iD]\} } | t| | d qt|||||d } t||d }|||| |S)NcSsg|]}t|r|qSr)r?)r`Zbaseclsrrr ;sz3HasProps.static_to_serializable..rr z multiple bases are not supported__main__rVZbokeh)rHkindrFrP)rHrF)rHmoduleextendsr[ overrides)rHr)Zget_ref __bases__lenstatic_to_serializablerWrrsplitrOlookuprX_defaultappend PropertyDefr>rD OverrideDefModelDefrZadd_ref)r4rZmodelrefrTrrHrr[rZ prop_namer\rrFZmodeldefrrrr4s4      zHasProps.static_to_serializablecCsdSrr)rzrrrrto_serializable]szHasProps.to_serializableNmodelssetterr(zDict[ID, HasProps] | Nonez Setter | None)rHjsonrrrcCs\||jddkrJtd|d|d|||}|j||||dntd||dS) a Set a property value on this object from JSON. Args: name: (str) : name of the attribute to set json: (JSON-value) : value to set to the attribute to models (dict or None, optional) : Mapping of model ids to models (default: None) This is needed in cases where the attributes to update also have values that have references. setter(ClientSession or ServerSession or None, optional) : This is used to prevent "boomerang" updates to Bokeh apps. In the context of a Bokeh server application, incoming updates to properties will be annotated with the session that is doing the updating. This value is propagated through any subsequent change notifications that the update triggers. The session can compare the event setter to itself, and suppress any updates that originate from itself. Returns: None TrczPatching attribute z of z with rzeJSON had attr %r on obj %r, which is a client-only or invalid attribute that shouldn't have been sentN)r[logtracer set_from_jsonwarning)rzrHrrrr\rrrr`s  zHasProps.set_from_json)kwargsrcKs"|D]\}}t|||qdS)a Updates the object's properties from the given keyword arguments. Returns: None Examples: The following are equivalent: .. code-block:: python from bokeh.models import Range1d r = Range1d # set properties individually: r.start = 10 r.end = 20 # update properties together: r.update(start=10, end=20) N)rDry)rzrrfrgrrrrjszHasProps.updatezDict[str, JSON]zMapping[ID, HasProps] | None)json_attributesrrrcCs(|D]\}}|j||||dqdS)a Updates the object's properties from a JSON attributes dictionary. Args: json_attributes: (JSON-dict) : attributes and values to update models (dict or None, optional) : Mapping of model ids to models (default: None) This is needed in cases where the attributes to update also have values that have references. setter(ClientSession or ServerSession or None, optional) : This is used to prevent "boomerang" updates to Bokeh apps. In the context of a Bokeh server application, incoming updates to properties will be annotated with the session that is doing the updating. This value is propagated through any subsequent change notifications that the update triggers. The session can compare the event setter to itself, and suppress any updates that originate from itself. Returns: None rN)rDr)rzrrrrfrgrrrupdate_from_jsonszHasProps.update_from_jsonT)raisesz Literal[True]zPropertyDescriptor[Any])rHrrcCsdSrrr4rHrrrrrszHasProps.lookupzLiteral[False]zPropertyDescriptor[Any] | NonecCsdSrrrrrrrscCs>t||d}|dk s |dkr$|s$|St|jd|ddS)aX Find the ``PropertyDescriptor`` for a Bokeh property on a class, given the property name. Args: name (str) : name of the property to search for raises (bool) : whether to raise or return None if missing Returns: PropertyDescriptor : descriptor for property named ``name`` NrVz# property descriptor does not exist)r>rr7)r4rHrattrrrrrs rczSet[str])rdrcCsdSrrr4rdrrrr[szHasProps.propertiesrNcCsdSrrrrrrr[sz)Union[Set[str], Dict[str, Property[Any]]]cCs2i}|jD]}|t|diq |s.t|S|S)ae Collect the names of properties on this class. .. warning:: In a future version of Bokeh, this method will return a dictionary mapping property names to property objects. To future-proof this current usage of this method, wrap the return value in ``list``. Returns: property names rO)__mro__rjr>set)r4rdpropscrrrr[s  cCsdd|jddDS)a, Collect the names of all properties on this class that also have references. This method *always* traverses the class hierarchy and includes properties defined on any parent classes. Returns: set[str] : names of properties that have references cSsi|]\}}|jr||qSr)Zhas_refrerrrrhsz1HasProps.properties_with_refs..Trc)r[rDr:rrrproperties_with_refss zHasProps.properties_with_refszDict[str, DataSpec]cs*ddlmfdd|jddDS)a Collect the names of all ``DataSpec`` properties on this class. This method *always* traverses the class hierarchy and includes properties defined on any parent classes. Returns: set[str] : names of ``DataSpec`` properties r r.cs i|]\}}t|r||qSr)rErer.rrrhs z&HasProps.dataspecs..Trc)property.dataspecr/r[rDr:rr.r dataspecss zHasProps.dataspecsinclude_defaultsinclude_undefined)rrrcCs|jdd||dS)a# Collect a dict mapping property names to their values. This method *always* traverses the class hierarchy and includes properties defined on any parent classes. Non-serializable properties are skipped and property values are in "serialized" format which may be slightly different from the values you would normally read from the properties; the intent of this method is to return the information needed to losslessly reconstitute the object instance. Args: include_defaults (bool, optional) : Whether to include properties that haven't been explicitly set since the object was created. (default: True) Returns: dict : mapping from property names to their values cSs|jSr)Z serialized)rIrrr+rz1HasProps.properties_with_values..r)query_properties_with_values)rzrrrrrrs zHasProps.properties_with_valuescCs*i}t|jD]}|t|diq|S)z Returns a dictionary of defaults that have been overridden. .. note:: This is an implementation detail of ``Property``. rP)reversedrrjr>)r4defaultsrrrrrJ.szHasProps._overridden_defaultsz)Callable[[PropertyDescriptor[Any]], bool])queryrrrc Cst}i}|r|jdd}n@t|jt|jB}|}|dk r\t|}||O}|D]t}||} || sxq`z| |} Wn"tk r|rt } nYq`Yn$X|s||krt | t r||jkrq`| ||<q`|S)a Query the properties values of |HasProps| instances with a predicate. Args: query (callable) : A callable that accepts property descriptors and returns True or False include_defaults (bool, optional) : Whether to include properties that have not been explicitly set by a user (default: True) Returns: dict : mapping of property names and values for matching properties TrcN) rr[rvrlrw themed_valuesrZserializable_valuer#r%rEr&) rzrrrZ themed_keysresultrlrkeyr\r{rrrr;s0     z%HasProps.query_properties_with_valueszDict[str, Unknown] | NonecCs t|ddS)z Get any theme-provided overrides. Results are returned as a dict from property name to value, or ``None`` if no theme overrides any values for this instance. Returns: dict or None rQN)r>rzrrrrrs zHasProps.themed_values)property_valuesrc Cs|}||krdSt}|dk r4|t|t|}i}||D]}t||||<qNt|dkr|t|d|nt|drt |d| D]\}}||j kr|j |=q| D](\}}| |}t |tr|||qdS)a Apply a set of theme values which will be used rather than defaults, but will not override application-set values. The passed-in dictionary may be kept around as-is and shared with other instances to save memory (so neither the caller nor the |HasProps| instance should modify it). Args: property_values (dict) : theme values to use in place of defaults Returns: None NrrQ)rrrjrlunionr>rryhasattrdelattrrDrxrrEr"Ztrigger_if_changed) rzrZold_dictremovedaddedZ old_valuesrfrgr\rrr apply_theme~s*        zHasProps.apply_themecCs|jiddS)z\ Remove any themed values and restore defaults. Returns: None )rN)rrrrr unapply_themeszHasProps.unapply_themecCs|jf|jS)z_ Duplicate a HasProps object. Values that are containers are shallow-copied. )r^rvrrrr_cloneszHasProps._clone)!r7rqrrr8rursrpr~rrr__repr__r classmethodrrrrjrrrrr[rrrrJrrrrrrtrrr]rr1sv   ($   7 0 ) metaclassc@s&eZdZUded<ded<ded<dS)rrRrHzKindRef | NonerzUnknown | NonerFNr7rqrrrsrrrrrs rc@seZdZUded<ded<dS)rrRrHr)rFNrrrrrrs rc@seZdZUded<ded<dS)rrRrHz str | NonerNrrrrrrs rc@s&eZdZUded<ded<ded<dS)rzModelRef | NonerzList[PropertyDef] | Noner[zList[OverrideDef] | NonerNrrrrrrs rz .. note:: This is an abstract base class used to help organize the hierarchy of Bokeh model types. **It is not useful to instantiate on its own.** )Kr8 __future__rlogging getLoggerr7rrtypingrrrrrrr r r r r rrrwarningsrZtyping_extensionsrrrr functoolsZ util.stringrrZproperty.descriptor_factoryr!Zproperty.descriptorsr"r#Zproperty.overrider$Zproperty.singletonsr%Zproperty.wrappersr&typesr'r(r)Zclient.sessionr*Zdocument.documentr+Zserver.sessionr,Zproperty.basesr-rr/__all__ZSetterr3r0r?rJrMtyper2r1ZKindRefrrrrr9rrrrsX  @              8