-edZddlmZddlZejeZddlmZddl m Z m Z m Z m Z mZmZdZd"d Zd#d$dZd%dZd&dZd'd(dZd"dZd#d$dZedZd)d!ZdS)*a Provide a set of decorators useful for repeatedly updating a a function parameter in a specified way each time the function is called. These decorators can be especially useful in conjunction with periodic callbacks in a Bokeh server application. Example: As an example, consider the ``bounce`` forcing function, which advances a sequence forwards and backwards: .. code-block:: python from bokeh.driving import bounce @bounce([0, 1, 2]) def update(i): print(i) If this function is repeatedly called, it will print the following sequence on standard out: .. code-block:: none 0 1 2 2 1 0 0 1 2 2 1 ... ) annotationsN)partial)AnyCallableIterableIteratorSequenceTypeVar)bouncecosinecountforcelinearrepeatsinesequence Sequence[int]returnpartial[Callable[[], None]]cxtdfd }ttt|S)a Return a driver function that can advance a "bounced" sequence of values. .. code-block:: none seq = [0, 1, 2, 3] # bounce(seq) => [0, 1, 2, 3, 3, 2, 1, 0, 0, 1, 2, ...] Args: sequence (seq) : a sequence of values for the driver to bounce iintrcht|\}}|dzdkr|S|z dz S)Nr)divmod)rdivmodNrs -lib/python3.11/site-packages/bokeh/driving.pyfzbounce..f[s>!Q<<S 7a<<C= AcE!G$ $rrrrrlenrr_advancerr!rs` @r r r LsO H A%%%%%%% 58A;; / / //r"rwfloatAphioffsetcrddlmdfd }ttt |S) a Return a driver function that can advance a sequence of cosine values. .. code-block:: none value = A * cos(w*i + phi) + offset Args: w (float) : a frequency for the cosine driver A (float) : an amplitude for the cosine driver phi (float) : a phase offset to start the cosine driver with offset (float) : a global offset to add to the driver values r)cosrr*rc2|zzzzSN)rr+r/r-r,r)s r r!zcosine..fr#33qsSy>>!F**r"r#rr*rr*)mathr/rrr')r)r+r,r-r!r/s```` @r r r cf++++++++++ 58A;; / / //r"cJtttdS)z@ Return a driver function that can advance a simple count. c|Sr1r2)xs r zcount..zsar"r#rrr'r2r"r r r vs! 58KK#8#8 9 9 99r"r!Callable[[Any], None] Iterator[Any]Callable[[], None]cdfd }|S)z Return a decorator that can "force" a function with an arbitrary supplied generator Args: sequence (iterable) : generator to drive f with Returns: decorator rNonec8tdSr1)next)r!rsr wrapperzforce..wrappers $x..r")rr@r2)r!rrCs`` r rr|s, Nr"mbcZdfd }ttt|S)z Return a driver function that can advance a sequence of linear values. .. code-block:: none value = m * i + b Args: m (float) : a slope for the linear driver x (float) : an offset for the linear driver rr*rc|zzSr1r2)rrErDs r r!zlinear..fs1uqyr"r#r4r;)rDrEr!s`` r rrs@ 58A;; / / //r"cxtdfd }ttt|S)a  Return a driver function that can advance a repeated of values. .. code-block:: none seq = [0, 1, 2, 3] # repeat(seq) => [0, 1, 2, 3, 0, 1, 2, 3, 0, 1, ...] Args: sequence (seq) : a sequence of values for the driver to bounce rrrc|zSr1r2)rrrs r r!zrepeat..fs!}r"r#r$r%r(s` @r rrsM H A 58A;; / / //r"crddlmdfd }ttt |S) a Return a driver function that can advance a sequence of sine values. .. code-block:: none value = A * sin(w*i + phi) + offset Args: w (float) : a frequency for the sine driver A (float) : an amplitude for the sine driver phi (float) : a phase offset to start the sine driver with offset (float) : a global offset to add to the driver values r)sinrr*rc2|zzzzSr1r2)rr+r-r,rKr)s r r!zsine..fr3r"r#r4)r5rKrrr')r)r+r,r-r!rKs```` @r rrr6r"TCallable[[int], T] Iterable[T]c#2Kd} ||V|dz })z Yield a sequence generated by calling a given function with successively incremented integer values. Args: f (callable) : The function to advance Yields: f(i) where i increases each call rTrr2)r!rs r r'r's1 Aadd  Qr")rrrr)rrr) r)r*r+r*r,r*r-r*rr)rr)r!r<rr=rr>)rr)rDr*rEr*rr)r!rNrrO)__doc__ __future__rlogging getLogger__name__log functoolsrtypingrrrrr r __all__r r r rrrrrMr'r2r"r rZsr@#"""""g!! 0000.00000&::::  00000 0000$000006 GCLLr"