AHj2PddlmZddlZddlmZmZddlmZddlm Z ddl m Z m Z m Z mZddlmZmZddlmZdd lmZdd lmZdd lmZmZdd lmZmZdd lmZe rddl m!Z!e"e#e$fZ% e e&ge&fZ' Gdde(Z)edZ*eGddeZ+GddeZ,eGdde,Z-GddZ.GddZ/y)) annotationsN)ABCabstractmethod) dataclass)partial) TYPE_CHECKINGAnyCallableTypeVar)Protocolruntime_checkable)_time)invoke)cached_property)DEFAULT_EASINGEASING)AnimationLevel CallbackType)Timer)AppceZdZdZy)AnimationErrorz+An issue prevented animation from starting.N)__name__ __module__ __qualname____doc__I/root/tools/cai/cai_env/lib/python3.12/site-packages/textual/_animator.pyrrs5rr ReturnTypec(eZdZdZ ddZy) AnimatablezProtocol for objects that can have their intrinsic values animated. For example, the transition between two colors can be animated because the class [`Color`][textual.color.Color.blend] satisfies this protocol. cyNr)self destinationfactors rblendzAnimatable.blend.s rN)r%r r&r r'floatreturnr )rrrrr(rrrr"r"&s,   '1 ;@  rr"cbeZdZUdZded< e d d dZd dZed d dZd dZ y) AnimationNCallbackType | None on_completectd)zCall the animation, return a boolean indicating whether animation is in-progress or complete. Args: time: The current timestamp Returns: True if the animation has finished, otherwise False. NotImplementedError)r%timeapp_animation_levels r__call__zAnimation.__call__8s""%%rcdK|jt|jd{yy7w)zMCalls the [`on_complete`][Animation.on_complete] callback if one is provided.N)r.rr%s rinvoke_callbackzAnimation.invoke_callbackHs.    '))* * * ( *s %0.0cKtw)z}Stop the animation. Args: complete: Flag to say if the animation should be taken to completion. r1r%completes rstopzAnimation.stopMs"!s cyNFrr%others r__eq__zAnimation.__eq__Vsrfullr3r)r4rr*boolr*NoneTr;rEr*rGr@objectr*rE) rrrr.__annotations__rr5r8r<rArrrr,r,4sa'+K$+3/5 & &, &  & &+ ""rr,ceZdZUded<ded<ded<ded<ded <ded <ded <d ed <dZded<dZded< d ddZdddZddZy)SimpleAnimationrKobjstr attributer) start_timedurationzfloat | Animatable start_value end_value final_valueEasingFunctioneasingNr-r.rCrlevelc@|jdk(s|dk(s|dk(r;|jdk(r,t|j|j|j yt d||jz |jz }|j|}|dk(r|j }n[t|jtrHt|jtsJd|jj|j|}nt|jttfsJd|jt|jttfsJd |j|j|jkDr;|j|}|j|j|jz |zz}n=d |j|z }|j|j|jz |zz}t|j|j||d k\S) NrnonebasicrCTg?zend_value must be animatablez!`start_value` must be float, not z`end_value` must be float, not )rSrYsetattrrOrQrVminrRrX isinstancerTr"rUr(intr))r%r3r4r' eased_factorvalues rr5zSimpleAnimation.__call__hs MMQ "f,"g- f$ DHHdnnd.>.> ?S4$//1T]]BC{{6* S=$$E ((* 5  .- .$$**4>><HE  3, H243C3C2FG He  D00BC D~~ 0 00#{{62 $$~~(8(88LHI !4;;v#66 NNd&6&6&G<%WW $..%0{rcK|r+t|j|j|j|j d{y7w)a Stop the animation. Args: complete: Flag to say if the animation should be taken to completion. Note: [`on_complete`][Animation.on_complete] will be called regardless of the value provided for `complete`. N)r^rOrQrUr8r:s rr<zSimpleAnimation.stops5  DHHdnndnn =""$$$sAA A A ct|tr4|j|jk(xr|j|jk(Syr>)r`rNrVrSr?s rrAzSimpleAnimation.__eq__s? e_ -  E$5$554MMU^^3 rrBrDrHrIrJ) rrrrLr.rYr5r<rArrrrNrNZsv KNO##!! '+K$+"E>"MBH**0>* *X %rrNcTeZdZddZddddeddd d dZy) BoundAnimatorc ||_||_yr$) _animator_obj)r%animatorrOs r__init__zBoundAnimator.__init__s! r.NrC)rVrSspeeddelayrXr.rYc t|j|} t|trt | dr| j |}t|tr t |n|} |jj|j||||||| ||  S)anAnimate an attribute. Args: attribute: Name of the attribute to animate. value: The value to animate to. final_value: The final value of the animation. Defaults to `value` if not set. duration: The duration (in seconds) of the animation. speed: The speed of the animation. delay: A delay (in seconds) before the animation starts. easing: An easing method. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). parse) rQrcrVrSrnrorXr.rY) getattrrjr`rPhasattrrqrrianimate) r%rQrcrVrSrnrorXr.rYrTeasing_functions rr5zBoundAnimator.__call__s4dii3 eS !gk7&C %%e,E,6vs,C&.~~%% II#"#&  r)rkAnimatorrOrKr*rG)rQrPrczstr | float | AnimatablerVrKrS float | Nonernrwror)rXEasingFunction | strr.r-rYrr*rG)rrrrlrr5rrrrgrgs"!%"'5+/ &, , (,  ,  , , , %, ), ,  , rrgcFeZdZdZdddZeddZeddZddZddZ ddZ ddZ d d d e d d d d  d dZ d!dZd d d e d d d d"dZ d#dZd#dZ d$ d%dZd&dZddZd'dZddZddZy )(rvzGAn object to manage updates to a given attribute over a period of time.cdi|_ i|_ ||_ t|d|z d|d|_y)zInitialise the animator object. Args: app: The application that owns the animator. frames_per_second: The number of frames/second to run the animation at. r]rvT)namecallbackpauseN) _animations _scheduledappr_timer)r%rframes_per_seconds rrlzAnimator.__init__sD;=[57a4  ! !   rc*tjS)z!The timer that runs the animator.asyncioEventr7s r _idle_eventzAnimator._idle_event}}rc*tjS)z1Flag if no animations are currently taking place.rr7s r_complete_eventzAnimator._complete_eventrrcK|jj|jj|jj yw)zStart the animator task.N)rsetrr_startr7s rstartzAnimator.starts:    " sAAcNK |jj|jj |j j y#tj$rYJwxYw#|jj |j j wxYww)zStop the animator task.N)rr<rCancelledErrorrrrr7s rr<z Animator.stops ' KK       "  $ $ & %%       "  $ $ &s3B%A5B%A)&A,(A))A,,6B""B%ct||S)zBind the animator to a given object. Args: obj: The object to bind to. Returns: The bound animator. )rg)r%rOs rbindz Animator.bindsT3''rcXt||f}||jvxs||jvS)a1Does the object/attribute pair have an ongoing or scheduled animation? Args: obj: An object to check for. attribute: The attribute on the object to test for. Returns: `True` if that attribute is being animated for that object, `False` if not. )idr~r)r%rOrQkeys ris_being_animatedzAnimator.is_being_animateds1#w "d&&&@#*@@r.NrmrC)rVrSrnrXror.rYc |j|t|j|||||||| |  } |rO|jj |j j || |jt||f<y| y)aAnimate an attribute to a new value. Args: obj: The object containing the attribute. attribute: The name of the attribute. value: The destination value of the attribute. final_value: The final value, or ellipsis if it is the same as ``value``. duration: The duration of the animation, or ``None`` to use speed. speed: The speed of the animation. easing: An easing function. delay: Number of seconds to delay the start of the animation by. on_complete: Callback to run after the animation completes. level: Minimum level required for the animation to take place (inclusive). rVrSrnrXr.rYN) _record_animationr_animaterclearr set_timerrr) r%rOrQrcrVrSrnrXror.rYanimate_callbacks rrtzAnimator.animate)s8 y)" MM   ##     & & (48HH4F4F'5DOORWi0 1  rcy)ztCalled when an attribute is to be animated. Args: attribute: Attribute being animated. Nr)r%rQs rrzAnimator._record_animationZsrrcDt||std|d|d|| ||Jdt||f} |j| =|dur|}|j } t |tr t|n|} d} t|dr%t|d|t|||| ||| ||  } | t |ttfst |tstd |d t||}||k(r|jj| dy||}n:t|d r|j!||xsd z }nt#||z |xsd z }t%||| ||||| | t'|j(j*|nd| } | Jd|jj-| }||| k(ry| |j| <|j.j1|j2j5|j6j5y#t$rYwxYw)azAnimate an attribute to a new value. Args: obj: The object containing the attribute. attribute: The name of the attribute. value: The destination value of the attribute. final_value: The final value, or ellipsis if it is the same as ``value``. duration: The duration of the animation, or ``None`` to use speed. speed: The speed of the animation. easing: An easing function. on_complete: Callback to run after the animation completes. level: Minimum level required for the animation to take place (inclusive). zCan't animate attribute z on z; attribute does not existNz.An Animation should have a duration OR a speed.__textual_animation__)rSrnrXr.rYzDon't know how to animate zA; Can only animate , , or objects with a blend methodget_distance_to2) rQrRrSrTrUrVrXr.rYz!animation expected to be non-None)rsAttributeErrorrrKeyError _get_timer`rPrrrrar)r"rr~poprabsrNrr call_latergetrresumerrr)r%rOrQrcrVrSrnrXr.rY animation_keyrRru animationrTanimation_durationcurrent_animations rrzAnimator._animateas4sI& *9-tC7B\] $  !2 < ; < C),   . # K^^% ,6vs,C&.&* 3/ 0=%<=Y'!&' I  ec5\2:z<%0 :VV "#y1Ke#  $$]D9#%-"5"34).)>)>{)K *&*-U[-@)AU[b)Q&'#%+''&#.DHH//=I"$I&II$ ,,00?  (->)-K *3'    ""$U   s H HHcK |jj|}|j|rE|j8t |jd{|j ||d{yyy#t$rYywxYw707w)zStop a scheduled animation. Args: key: The key for the animation to stop. complete: Should the animation be moved to its completed state? N)rrrr< _callbackr_stop_running_animation)r%rr;schedules r_stop_scheduled_animationz"Animator._stop_scheduled_animations **3/H   **6++, , ,..sH= = =78    - >sEB A76B BB /B0B 7 BB BB B cK |jj|}|j|d{y#t$rYywxYw7w)zStop a running animation. Args: key: The key for the animation to stop. complete: Should the animation be moved to its completed state? N)r~rrr<)r%rr;rs rrz Animator._stop_running_animationsL ((,,S1InnX&&&   &s/A 9A AA  AA AA cKt||f}||jvr|j||d{y||jvr|j ||d{yy7/7w)aCStop an animation on an attribute. Args: obj: The object containing the attribute. attribute: The name of the attribute. complete: Should the animation be set to its final value? Note: If there is no animation scheduled or running, this is a no-op. N)rrrr~r)r%rOrQr;rs rstop_animationzAnimator.stop_animationsk#w " $// !00h? ? ? D$$ $..sH= = =% @ =s!1A'A#(A'A%A'%A'cPddlm}t||f} |jj |}t |trt|||jn#t ||rt|||j|j|jyy#t $rYywxYw)aForce stop an animation on an attribute. This will immediately stop the animation, without running any associated callbacks, setting the attribute to its final value. Args: obj: The object containing the attribute. attribute: The name of the attribute. Note: If there is no animation scheduled or running, this is a no-op. r)ScalarAnimationN) textual.css.scalar_animationrrr~rrr`rNr^rUrVr.)r%rOrQrrrs rforce_stop_animationzAnimator.force_stop_animations AC),  ((,,];I i 1 CI$7$7 8  ? 3 CI$9$9 :  ,  ! ! # -   sB B%$B%c|js\|jj|jj |j s|j j yy|jj}|j}t|jj}|D]G}|j|}|||}|s|j|=|j8|jIyr$) r~rr}rrrrranimation_levelrlistkeysr.)r%r4animation_timeanimation_keysrranimation_completes rr5zAnimator.__call__+s KK       "??$$((*##'((":": !^^-N!$"2"2"7"7"9:N!/ 0  ,,]; %.~?R%S"%((7 ,,8!--/  0rc*tjS)ztGet the current wall clock time, via the internal Timer. Returns: The wall clock time. )rget_timer7s rrzAnimator._get_time=s~~rcTK|jjd{y7w)z$Wait for any animations to complete.N)rwaitr7s r wait_for_idlezAnimator.wait_for_idleGs##%%% (&(cTK|jjd{y7w)z:Wait for any current and scheduled animations to complete.N)rrr7s rwait_until_completezAnimator.wait_until_completeKs""'')))r)<)rrrrar*rG)r*z asyncio.EventrF)rOrKr*rg)rOrKrQrPr*rE)rOrKrQrPrcr rVrKrSrwrnrwrXrxror)r.r-rYrr*rG)rQrPr*rG)rOrKrQrPrcr rVrKrSrwrnrwrXrxr.r-rYrr*rG)r AnimationKeyr;rEr*rGrH)rOrKrQrPr;rEr*rG)rOrKrQrPr*rG)r*r))rrrrrlrrrrr<rrrrtrrrrrrr5rrrrrrrvrvsQ * ' ( A&"!%"'5+/ &/ // /  ///%//)// /b "!%"'5+/ &p% p%p% p%  p%p%p%%p%)p%p% p%d>>+/> >: '=A>>&)>59> >&$60$ &*rrv)0 __future__rrabcrr dataclassesr functoolsrtypingrr r r typing_extensionsr r textualrtextual._callbackrtextual._compatrtextual._easingrrtextual._typesrr textual.timerr textual.apprtuplerarPrr)rW Exceptionrr r"r,rNrgrvrrrrs"#!889$+27c?LS5'5.) 6Y6\ "       ##L MiM M`1 1 hn*n*r