ó mÜJ]c @`szdZddlmZmZmZmZddlZejeƒZ ddl m Z d)Z dd„Zdd„Zdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd „ƒYZid!„e6d"„e6d#„e6d$„e6d%„e6d&„e6d'„e6Zd(„ZdS(*u} The query module provides functions for searching collections of Bokeh models for instances that match specified criteria. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(t string_typesuEQufinduGEQuGTuINuLEQuLTumatchuNEQuORc`s‡‡fd†|DƒS(u Query a collection of Bokeh models and yield any that match the a selector. Args: obj (Model) : object to test selector (JSON-like) : query selector context (dict) : kwargs to supply callable query attributes Yields: Model : objects that match the query Queries are specified as selectors similar to MongoDB style query selectors, as described for :func:`~bokeh.core.query.match`. Examples: .. code-block:: python # find all objects with type Grid find(p.references(), {'type': Grid}) # find all objects with type Grid or Axis find(p.references(), {OR: [ {'type': Grid}, {'type': Axis} ]}) # same query, using IN operator find(p.references(), {'type': {IN: [Grid, Axis]}}) # find all plot objects on the 'left' layout of the Plot # here layout is a method that takes a plot as context find(p.references(), {'layout': 'left'}, {'plot': p}) c3`s'|]}t|ˆˆƒr|VqdS(N(tmatch(t.0tobj(tcontexttselector(s/lib/python2.7/site-packages/bokeh/core/query.pys Ws((tobjsR R((RR s/lib/python2.7/site-packages/bokeh/core/query.pytfind4s#c`s |p i}xú|jƒD]ì\}}t|tƒr±|dkr§t|tƒr‘t|jƒƒtgkr‘t‡fd†|tDƒƒs¤tSq®tˆ|ƒs®tSq|dkr#t|tƒrØ|ˆj kr tSq®y!t |ƒt ˆj ƒ@søtSWq®t k r|ˆj kr tSq®Xqt ˆ|ƒs6tSt ˆ|ƒ}t|ƒrvy|||sgtSWq®tSXqt|tƒržt|||ƒs®tSq||krtSq|tkrÓtˆ|ƒstSq|tkrùt|ˆ|ƒstSqtdƒ‚qWtS(u Test whether a given Bokeh model matches a given selector. Args: obj (Model) : object to test selector (JSON-like) : query selector context (dict) : kwargs to supply callable query attributes Returns: bool : True if the object matches, False otherwise In general, the selectors have the form: .. code-block:: python { attrname : predicate } Where a predicate is constructed from the operators ``EQ``, ``GT``, etc. and is used to compare against values of model attributes named ``attrname``. For example: .. code-block:: python >>> from bokeh.plotting import figure >>> p = figure(plot_width=400) >>> match(p, {'plot_width': {EQ: 400}}) True >>> match(p, {'plot_width': {GT: 500}}) False There are two selector keys that are handled especially. The first is 'type', which will do an isinstance check: .. code-block:: python >>> from bokeh.plotting import figure >>> from bokeh.models import Axis >>> p = figure() >>> match(p.xaxis[0], {'type': Axis}) True >>> match(p.title, {'type': Axis}) False There is also a ``'tags'`` attribute that ``Model`` objects have, that is a list of user-supplied values. The ``'tags'`` selector key can be used to query against this list of tags. An object matches if any of the tags in the selector match any of the tags on the object: .. code-block:: python >>> from bokeh.plotting import figure >>> p = figure(tags = ["my plot", 10]) >>> match(p, {'tags': "my plot"}) True >>> match(p, {'tags': ["my plot", 10]}) True >>> match(p, {'tags': ["foo"]}) False utypec3`s|]}tˆ|ƒVqdS(N(t isinstance(Rtx(R(s/lib/python2.7/site-packages/bokeh/core/query.pys ¨sutagsumalformed query selector(titemsR RtdicttlisttkeystINtanytFalsettagstsett TypeErrorthasattrtgetattrtcallableRtORt_ort _operatorst ValueErrortTrue(RR Rtkeytvaltattr((Rs/lib/python2.7/site-packages/bokeh/core/query.pyRYsRE  *        RcB`seZdZRS(uY Form disjunctions from other query predicates. Construct an ``OR`` expression by making a dict with ``OR`` as the key, and a list of other query expressions as the value: .. code-block:: python # matches any Axis subclasses or models with .name == "mycircle" { OR: [dict(type=Axis), dict(name="mycircle")] } (t__name__t __module__t__doc__(((s/lib/python2.7/site-packages/bokeh/core/query.pyRÙs RcB`seZdZRS(uO Predicate to test if property values are in some collection. Construct and ``IN`` predicate as a dict with ``IN`` as the key, and a list of values to check against. .. code-block:: python # matches any models with .name in ['a', 'mycircle', 'myline'] dict(name={ IN: ['a', 'mycircle', 'myline'] }) (R#R$R%(((s/lib/python2.7/site-packages/bokeh/core/query.pyRçs tGTcB`seZdZRS(u Predicate to test if property values are greater than some value. Construct and ``GT`` predicate as a dict with ``GT`` as the key, and a value to compare against. .. code-block:: python # matches any models with .size > 10 dict(size={ GT: 10 }) (R#R$R%(((s/lib/python2.7/site-packages/bokeh/core/query.pyR&õs tLTcB`seZdZRS(u Predicate to test if property values are less than some value. Construct and ``LT`` predicate as a dict with ``LT`` as the key, and a value to compare against. .. code-block:: python # matches any models with .size < 10 dict(size={ LT: 10 }) (R#R$R%(((s/lib/python2.7/site-packages/bokeh/core/query.pyR's tEQcB`seZdZRS(u Predicate to test if property values are equal to some value. Construct and ``EQ`` predicate as a dict with ``EQ`` as the key, and a value to compare against. .. code-block:: python # matches any models with .size == 10 dict(size={ EQ: 10 }) (R#R$R%(((s/lib/python2.7/site-packages/bokeh/core/query.pyR(s tGEQcB`seZdZRS(u. Predicate to test if property values are greater than or equal to some value. Construct and ``GEQ`` predicate as a dict with ``GEQ`` as the key, and a value to compare against. .. code-block:: python # matches any models with .size >= 10 dict(size={ GEQ: 10 }) (R#R$R%(((s/lib/python2.7/site-packages/bokeh/core/query.pyR)s tLEQcB`seZdZRS(u+ Predicate to test if property values are less than or equal to some value. Construct and ``LEQ`` predicate as a dict with ``LEQ`` as the key, and a value to compare against. .. code-block:: python # matches any models with .size <= 10 dict(size={ LEQ: 10 }) (R#R$R%(((s/lib/python2.7/site-packages/bokeh/core/query.pyR*.s tNEQcB`seZdZRS(u Predicate to test if property values are unequal to some value. Construct and ``NEQ`` predicate as a dict with ``NEQ`` as the key, and a value to compare against. .. code-block:: python # matches any models with .size != 10 dict(size={ NEQ: 10 }) (R#R$R%(((s/lib/python2.7/site-packages/bokeh/core/query.pyR+=s cC`s ||kS(N((R ty((s/lib/python2.7/site-packages/bokeh/core/query.pytQtcC`s ||kS(N((R R,((s/lib/python2.7/site-packages/bokeh/core/query.pyR-RR.cC`s ||kS(N((R R,((s/lib/python2.7/site-packages/bokeh/core/query.pyR-SR.cC`s ||kS(N((R R,((s/lib/python2.7/site-packages/bokeh/core/query.pyR-TR.cC`s ||kS(N((R R,((s/lib/python2.7/site-packages/bokeh/core/query.pyR-UR.cC`s ||kS(N((R R,((s/lib/python2.7/site-packages/bokeh/core/query.pyR-VR.cC`s ||kS(N((R R,((s/lib/python2.7/site-packages/bokeh/core/query.pyR-WR.c`st‡fd†|DƒƒS(Nc3`s|]}tˆ|ƒVqdS(N(R(RR (R(s/lib/python2.7/site-packages/bokeh/core/query.pys \s(R(Rt selectors((Rs/lib/python2.7/site-packages/bokeh/core/query.pyR[s( uEQufinduGEQuGTuINuLEQuLTumatchuNEQuOR(R%t __future__RRRRtloggingt getLoggerR#tlogtsixRt__all__tNoneR RtobjectRRR&R'R(R)R*R+RR(((s/lib/python2.7/site-packages/bokeh/core/query.pyt sB"    % €