iAdZddlZddlZddlmZddlmZm Z ddl m Z dZ ejd d Zejd Zejd ZGdde ej"eZGddej"eZGddeZefdej,ee fdeefdZdedej0egej2fdefdZy)z5 Method chaining interface. .. versionadded:: 1.0.0 N) InvalidMethod)UNSETUnset)AllFuncs)chaintap ValueT_coT) covariantTT2ceZdZdZeZeZefde je e fddfdZ d dZde fdZdefdZdd Zde j&dd fd Zde fd Zy)Chainz-Enables chaining of :attr:`module` functions.valuereturnNc||_y)N_valueselfrs P/home/Script/Script_env/lib/python3.12/site-packages/pydash/chaining/chaining.py__init__zChain.__init__!s  c.t|j|S)zImplement `AllFuncs` interface.) ChainWrapperr)rfuncs r_wrapz Chain._wrap$sDKK..rc&||jS)z Return current value of the chain operations. Returns: Current value of chain operations. rrs rrz Chain.value(sDKK  rcT|jj|jS)z Return current value as string. Returns: Current value of chain operations casted to ``str``. )module to_stringrr s rr#zChain.to_string1s{{$$TZZ\22rChain[ValueT_co]c4t|jS)z Executes the chained sequence and returns the wrapped result. Returns: New instance of :class:`Chain` with resolved value from previous :class:`Class`. )rrr s rcommitz Chain.commit:sTZZ\""rc~|j}g}t|drV|g}t|jtr9|j}|j d|t|jtr9t |}|D]<}t|j|j |ji|j}>|S)z Return a clone of the chained sequence planting `value` as the wrapped value. Args: value: Value to plant as the initial chain value. rr) rhasattr isinstancerinsertrmethodargskwargs)rrwrapperwrappersclonewraps rplantz Chain.plantDs++ 7H %yHW^^\:!..7+W^^\:$El D;Lt{{;++E   rcpt|jtr|jj|}|S)z Return result of passing `value` through chained methods. Args: value: Initial value to pass through chained methods. Returns: Result of method chain evaluation of `value`. )r)rrunwraprs r__call__zChain.__call__`s+ dkk< 0KK&&u-E r)rz'ChainWrapper[t.Union[ValueT_co, Unset]])rr$)__name__ __module__ __qualname____doc__pydr"rinvalid_method_exceptionrtUnionr rrrrstrr#r&Anyr2r5rrrrs|7F,:?aggi&67D/!y!333#155%78  rrc6eZdZdZdeddfdZdZefdZdZ y) rzGWrap :class:`Chain` method call within a :class:`ChainWrapper` context.rrNc<||_||_d|_i|_y)Nr@)rr+r,r-)rrr+s rrzChainWrapper.__init__ss   ,. rc|jj|j}|jj|_|S)z!Generate a copy of this instance.) __class____new____dict__copy)rnews r _generatezChainWrapper._generateys5nn$$T^^4}}))+  rcf|j}t|jtr!|jj ||_nt|ts|t ur||_|jt ur |j}|j |g|ji|jS)z Execute :meth:`method` with :attr:`_value`, :attr:`args`, and :attr:`kwargs`. If :attr:`_value` is an instance of :class:`ChainWrapper`, then unwrap it before calling :attr:`method`. ) rIr)rrr4rr+r,r-)rrr.s rr4zChainWrapper.unwraps.." gnnl 3$^^2259GNE<0U%5G"GN >> &NNEw~~eEgllEgnnEErc4||_||_t|S)a Invoke the :attr:`method` with :attr:`value` as the first argument and return a new :class:`Chain` object with the return value. Returns: New instance of :class:`Chain` with the results of :attr:`method` passed in as value. )r,r-r)rr,r-s rr5zChainWrapper.__call__s  T{r) r6r7r8r9r rrIrr4r5r@rrrrps-Q/i/D/ !F4 rrcNeZdZdZdZefdejee fde efdZ y)_Dashz}Class that provides attribute access to valid :mod:`pydash` methods and callable access to :mod:`pydash` method chaining.c,tj|S)z"Proxy to :meth:`Chain.get_method`.)r get_method)rattrs r __getattr__z_Dash.__getattr__s%%rrrct|S)zAReturn a new instance of :class:`Chain` with `value` as the seed.rrs rr5z_Dash.__call__s U|rN) r6r7r8r9rQrr<r=r rrr5r@rrrMrMs8&&;@aggi&67E)DTrrMrrct|S)ar Creates a :class:`Chain` object which wraps the given value to enable intuitive method chaining. Chaining is lazy and won't compute a final value until :meth:`Chain.value` is called. Args: value: Value to initialize chain operations with. Returns: Instance of :class:`Chain` initialized with `value`. Example: >>> chain([1, 2, 3, 4]).map(lambda x: x * 2).sum().value() 20 >>> chain().map(lambda x: x * 2).sum()([1, 2, 3, 4]) 20 >>> summer = chain([1, 2, 3, 4]).sum() >>> new_summer = summer.plant([1, 2]) >>> new_summer.value() 3 >>> summer.value() 10 >>> def echo(item): ... print(item) >>> summer = chain([1, 2, 3, 4]).for_each(echo).sum() >>> committed = summer.commit() 1 2 3 4 >>> committed.value() 10 >>> summer.value() 1 2 3 4 10 .. versionadded:: 1.0.0 .. versionchanged:: 2.0.0 Made chaining lazy. .. versionchanged:: 3.0.0 - Added support for late passing of `value`. - Added :meth:`Chain.plant` for replacing initial chain value. - Added :meth:`Chain.commit` for returning a new :class:`Chain` instance initialized with the results from calling :meth:`Chain.value`. rS)rs rr r sl <r interceptorc|||S)a Invokes `interceptor` with the `value` as the first argument and then returns `value`. The purpose of this method is to "tap into" a method chain in order to perform operations on intermediate results within the chain. Args: value: Current value of chain operation. interceptor: Function called on `value`. Returns: `value` after `interceptor` call. Example: >>> data = [] >>> def log(value): ... data.append(value) >>> chain([1, 2, 3, 4]).map(lambda x: x * 2).tap(log).value() [2, 4, 6, 8] >>> data [[2, 4, 6, 8]] .. versionadded:: 1.0.0 r@)rrUs rr r s2 Lr)r9typingr<pydashr:pydash.exceptionsrhelpersrr all_funcsr__all__TypeVarr r rGenericrrobjectrMr=r Callabler?r r@rrras +"  AIIkT 2  AIIcNQYYt_SHaii *Sl5199Y'5p F &+6E"6uQx6rqqzz1#quu*5!r