u×gdZddlmZddlZejeZddlmZddl m Z m Z m Z m Z mZdZddZdddZdd Zdd Zddd Zdd Zddd ZedZddZy)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)AnyCallableIteratorSequenceTypeVar)bouncecosinecountforcelinearrepeatsinec^tdfd }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 cRt|\}}|dzdk(r|S|z dz S)Nr)divmod)idivmodNsequences -lib/python3.12/site-packages/bokeh/driving.pyfzbounce..fZs:!Q<S 7a<C= AcE!G$ $rrintreturnr lenrr _advancerrrs` @rr r Ks& H A% 58A; //rc`ddlmdfd }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)cosc,|zzzzSN)rAr'offsetphiws rrzcosine..fq3qsSy>!F**rrrfloatr!r1)mathr'rr r$)r.r+r-r,rr's```` @rr r b#++ 58A; //rc8tttdS)z@ Return a driver function that can advance a simple count. c|Sr)r*)xs rzcount..ysarrrr r$r*rrr r us 58K#8 99rcdfd }|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 c(tyr))next)rrsrwrapperzforce..wrappers $x.r)r!Noner*)rrr<s`` rr r {s  NrcHdfd }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 b (float) : an offset for the linear driver c|zzSr)r*)rbms rrzlinear..fs1uqyrrr0r8)rAr@rs`` rrrs 58A; //rc^tdfd }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 c|zSr)r*)rrrs rrzrepeat..fs!}rrrr"r%s` @rrrs$ H A 58A; //rc`ddlmdfd }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)sinc,|zzzzSr)r*)rr+r,r-rEr.s rrzsine..fr/rrr0)r2rErr r$)r.r+r-r,rrEs```` @rrrr3rTc#0Kd} |||dz }w)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 rrr*)rrs rr$r$s' A d  Q s)rz Sequence[int]r!partial[Callable[[], None]])rrr) r.r1r+r1r-r1r,r1r!rI)r!rI)rzCallable[[Any], None]rz Iterator[Any]r!zCallable[[], None])rr)rAr1r@r1r!rI)rzCallable[[int], T]r!z Iterator[T])__doc__ __future__rlogging getLogger__name__log functoolsrtypingrrrrr __all__r r r r rrrrGr$r*rrrSsn@#g! 0.0&:  0 0$06 CLr