O=dFdZddlmZddlmZddlmZmZddlZddlm Z m Z ddl Z ddl Z ddl ZddlmZmZmZmZmZmZd Ze jd Ze jd Zdaed d dgZdZdZdZdZdZ dZ!dZ"d;dZ#dZ$dZ%dZ&d;dZ'dZ(dZ)dZ*dd;d7Z?d8Z@d9ZAd:ZBdS)>z- Utility functions. .. versionadded:: 1.0.0 ) namedtuple)datetime)partialwrapsN)randintuniform) NUMBER_TYPESUNSETbase_getcallit getargcountiterator)$attemptcondconforms conforms_toconstant default_todefault_to_anyidentityiterateematchesmatches_propertymemoizemethod method_ofnoopnth_argnowover over_every over_some properties property_ property_ofrandomrange_ range_rightresultretry stub_list stub_dict stub_false stub_string stub_truetimesto_path unique_idz(?>> results = attempt(lambda x: x/0, 1) >>> assert isinstance(results, ZeroDivisionError) .. versionadded:: 1.1.0 N) Exception)funcargskwargsretexs :D:\Sites\api_v1\venv\Lib\site-packages\pydash/utilities.pyrrLsR"dD#F##  Js !!c|rgt|zD]k}d} t|dk}n#t$rYnwxYw|stdt t t |stdlfd}|S)a} Creates a function that iterates over `pairs` and invokes the corresponding function of the first predicate to return truthy. Args: pairs (list): A list of predicate-function pairs. Returns: callable: Returns the new composite function. Example: >>> func = cond([[matches({'a': 1}), constant('matches A')], [matches({'b': 2}), constant('matches B')], [stub_true, lambda value: value]]) >>> func({'a': 1, 'b': 2}) 'matches A' >>> func({'a': 0, 'b': 2}) 'matches B' >>> func({'a': 0, 'b': 0}) == {'a': 0, 'b': 0} True .. versionadded:: 4.0.0 .. versionchanged:: 4.2.0 Fixed missing argument passing to matched function and added support for passing in a single list of pairs instead of just pairs as separate arguments. Fz@Each predicate-function pair should contain exactly two elementsz/Both predicate-function pair should be callablecDD]}|\}}t|g|Rr||cSdSNr )r:pair predicaterpairss r>_condzcond.._condsU ' 'D"& Ixi'$''' 'x&&& ' ' ')listlenr8 ValueErrorallmapcallable TypeError)rF extra_pairsrDis_validrGs` r>rres:,${+++ O O 4yyA~HH    D  dbcc c3x&&'' OMNN N O''''' Ls 2 ??cfd}|S)a Creates a function that invokes the predicate properties of `source` with the corresponding property values of a given object, returning ``True`` if all predicates return truthy, else ``False``. Args: source (dict|list): The object of property predicates to conform to. Returns: callable: Returns the new spec function. Example: >>> func = conforms({'b': lambda n: n > 1}) >>> func({'b': 2}) True >>> func({'b': 0}) False >>> func = conforms([lambda n: n > 1, lambda n: n == 0]) >>> func([2, 0]) True >>> func([0, 0]) False .. versionadded:: 4.0.0 ctD].\}}tj||r|||sdS/dS)NFT)rpydhas)objr5rEsources r> _conformszconforms.._conformssX&v..  NC73$$ IIc#h,?,? uu trH)rWrXs` r>rrs$8 rHc2t||S)a| Checks if `obj` conforms to `source` by invoking the predicate properties of `source` with the corresponding property values of `obj`. Args: obj (dict|list): The object to inspect. source (dict|list): The object of property predicates to conform to. Example: >>> conforms_to({'b': 2}, {'b': lambda n: n > 1}) True >>> conforms_to({'b': 0}, {'b': lambda n: n > 1}) False >>> conforms_to([2, 0], [lambda n: n > 1, lambda n: n == 0]) True >>> conforms_to([0, 0], [lambda n: n > 1, lambda n: n == 0]) False .. versionadded:: 4.0.0 )rrVrWs r>rrs, 8F  C  rHc,tt|S)a Creates a function that returns `value`. Args: value (mixed): Constant value to return. Returns: callable: Function that always returns `value`. Example: >>> pi = constant(3.14) >>> pi() == 3.14 True .. versionadded:: 1.0.0 .. versionchanged:: 4.0.0 Returned function ignores arguments instead of raising exception. )rr)values r>rrs* 8U # ##rHc"t||S)a Checks `value` to determine whether a default value should be returned in its place. The `default_value` is returned if value is None. Args: value (mixed): Value passed in by the user. default_value (mixed): Default value passed in by the user. Returns: mixed: Returns `value` if :attr:`value` is given otherwise returns `default_value`. Example: >>> default_to(1, 10) 1 >>> default_to(None, 10) 10 .. versionadded:: 4.0.0 )r)r] default_values r>rrs* % / //rHc(|f|z}|D]}||cS dS)a Checks `value` to determine whether a default value should be returned in its place. The first item that is not None of the `default_values` is returned. Args: value (mixed): Value passed in by the user. *default_values (mixed): Default values passed in by the user. Returns: mixed: Returns `value` if :attr:`value` is given otherwise returns the first not None value of `default_values`. Example: >>> default_to_any(1, 10, 20) 1 >>> default_to_any(None, 10, 20) 10 >>> default_to_any(None, None, 20) 20 .. versionadded:: 4.9.0 NrY)r]default_valuesvaluesvals r>rr s<2X &F ?JJJ rHc|S)a; Return the first argument provided to it. Args: *args (mixed): Arguments. Returns: mixed: First argument or ``None``. Example: >>> identity(1) 1 >>> identity(1, 2, 3) 1 >>> identity() is None True .. versionadded:: 1.0.0 rY)argr:s r>rr)s * JrHcFt|r|}n t|trt|}t|trt |}nt|t r#t |dkrt |}nt|t r%t |dkrt|dd}nKt|tr t|}n,t|trt|}nt}d|_ |S)a Return a pydash style iteratee. If `func` is a property name the created iteratee will return the property value for a given element. If `func` is an object the created iteratee will return ``True`` for elements that contain the equivalent object properties, otherwise it will return ``False``. Args: func (mixed): Object to create iteratee function from. Returns: callable: Iteratee function. Example: >>> get_data = iteratee('data') >>> get_data({'data': [1, 2, 3]}) [1, 2, 3] >>> is_active = iteratee({'active': True}) >>> is_active({'active': True}) True >>> is_active({'active': 0}) False >>> iteratee(['a', 5])({'a': 5}) True >>> iteratee(['a.b'])({'a.b': 5}) 5 >>> iteratee('a.b')({'a': {'b': 5}}) 5 >>> iteratee(('a', ['c', 'd', 'e']))({'a': 1, 'c': {'d': {'e': 3}}}) [1, 3] >>> iteratee(lambda a, b: a + b)(1, 2) 3 >>> ident = iteratee(None) >>> ident('a') 'a' >>> ident(1, 2, 3) 1 .. versionadded:: 1.0.0 .. versionchanged:: 2.0.0 Renamed ``create_iteratee()`` to :func:`iteratee`. .. versionchanged:: 3.0.0 Made pluck style iteratee support deep property access. .. versionchanged:: 3.1.0 - Added support for shallow pluck style property access via single item list/tuple. - Added support for matches property style iteratee via two item list/tuple. .. versionchanged:: 4.0.0 Removed alias ``callback``. .. versionchanged:: 4.1.0 Return :func:`properties` callback when `func` is a ``tuple``. r Nr@)rN isinstanceintstrr%rIrJrtupler$dictrr _argcount)r9cbks r>rrAsr~~ dC  t99D dC D//CC d # # D QD//CC d # # D A "D!H-CC e $ $ d#CC d # # $--CCC JrHcfdS)a Creates a matches-style predicate function which performs a deep comparison between a given object and the `source` object, returning ``True`` if the given object has equivalent property values, else ``False``. Args: source (dict): Source object used for comparision. Returns: callable: Function that compares an object to `source` and returns whether the two objects contain the same items. Example: >>> matches({'a': {'b': 2}})({'a': {'b': 2, 'c':3}}) True >>> matches({'a': 1})({'b': 2, 'a': 1}) True >>> matches({'a': 1})({'b': 2, 'a': 2}) False .. versionadded:: 1.0.0 .. versionchanged:: 3.0.0 Use :func:`pydash.predicates.is_match` as matching function. c.tj|SrB)rTis_matchr[s r>zmatches..ss|C00rHrY)rWs`r>rrs6 1 0 0 00rHc0t|fdS)a? Creates a function that compares the property value of `key` on a given object to `value`. Args: key (str): Object key to match against. value (mixed): Value to compare to. Returns: callable: Function that compares `value` to an object's `key` and returns whether they are equal. Example: >>> matches_property('a', 1)({'a': 1, 'b': 2}) True >>> matches_property(0, 1)([1, 2, 3]) True >>> matches_property('a', 2)({'a': 1, 'b': 2}) False .. versionadded:: 3.1.0 cFt|SrB)r)rV prop_accessorr]s r>rqz"matches_property..s!~wu~~mmC&8&899rH)r%)r5r]rts `@r>rrs#.cNNM 9 9 9 9 99rHc(fdi_S)aG Creates a function that memoizes the result of `func`. If `resolver` is provided it will be used to determine the cache key for storing the result based on the arguments provided to the memoized function. By default, all arguments provided to the memoized function are used as the cache key. The result cache is exposed as the cache property on the memoized function. Args: func (callable): Function to memoize. resolver (callable, optional): Function that returns the cache key to use. Returns: callable: Memoized function. Example: >>> ident = memoize(identity) >>> ident(1) 1 >>> ident.cache['(1,){}'] == 1 True >>> ident(1, 2, 3) 1 >>> ident.cache['(1, 2, 3){}'] == 1 True .. versionadded:: 1.0.0 crr |i|}n||}|jvr|i|j|<j|SrBcache)r:r;r5r9memoizedresolvers r>ryzmemoize..memoizedsf  $(D+F++CC#6##C hn $ $"&$"7"7"7HN3 ~c""rHrw)r9rzrys``@r>rrs6: # # # # # # #HN OrHcfd}|S)a Creates a function that invokes the method at `path` on a given object. Any additional arguments are provided to the invoked method. Args: path (str): Object path of method to invoke. *args (mixed): Global arguments to apply to method when invoked. **kwargs (mixed): Global keyword argument to apply to method when invoked. Returns: callable: Function that invokes method located at path for object. Example: >>> obj = {'a': {'b': [None, lambda x: x]}} >>> echo = method('a.b.1') >>> echo(obj, 1) == 1 True >>> echo(obj, 'one') == 'one' True .. versionadded:: 3.3.0 cdtjtj|gRi}||i|SrBrTrget)rV_args_kwargsr9r:r;paths r>_methodzmethod.._methodC{373--??????tU&g&&&rHrY)rr:r;rs``` r>rrs/2''''''' NrHcfd}|S)a The opposite of :func:`method`. This method creates a function that invokes the method at a given path on object. Any additional arguments are provided to the invoked method. Args: obj (mixed): The object to query. *args (mixed): Global arguments to apply to method when invoked. **kwargs (mixed): Global keyword argument to apply to method when invoked. Returns: callable: Function that invokes method located at path for object. Example: >>> obj = {'a': {'b': [None, lambda x: x]}} >>> dispatch = method_of(obj) >>> dispatch('a.b.1', 1) == 1 True >>> dispatch('a.b.1', 'one') == 'one' True .. versionadded:: 3.3.0 cdtjtj|gRi}||i|SrBr})rrrr9r:r;rVs r> _method_ofzmethod_of.._method_of3rrHrY)rVr:r;rs``` r>rrs02''''''' rHcdS)z? A no-operation function. .. versionadded:: 1.0.0 NrY)r:r;s r>rr:s  DrHcfd}|S)a Creates a function that gets the argument at index n. If n is negative, the nth argument from the end is returned. Args: pos (int): The index of the argument to return. Returns: callable: Returns the new pass-thru function. Example: >>> func = nth_arg(1) >>> func(11, 22, 33, 44) 22 >>> func = nth_arg(-1) >>> func(11, 22, 33, 44) 44 .. versionadded:: 4.0.0 c tjt}n#t$rd}YnwxYwt j||S)Nr)mathceilfloatrKrTr~)r:positionposs r>_nth_argznth_arg.._nth_argZsW ys,,HH   HHH wtX&&&s !% 44rY)rrs` r>rrCs#.''''' OrHc tjd}tj|z }t|dr|}n#|j|j|jdzdzzdzzdz }t|dzS)a) Return the number of milliseconds that have elapsed since the Unix epoch (1 January 1970 00:00:00 UTC). Returns: int: Milliseconds since Unix epoch. .. versionadded:: 1.0.0 .. versionchanged:: 3.0.0 Use ``datetime`` module for calculating elapsed time. r total_secondsii@Bi) rutcfromtimestamputcnowhasattrr microsecondssecondsdaysrh)epochdeltars r>r r es  %a ( (E O   %Euo&&%%''  %-%*r/D2H"HE!Q Q  w~  rHcfd}|S)a Creates a function that invokes all functions in `funcs` with the arguments it receives and returns their results. Args: funcs (list): List of functions to be invoked. Returns: callable: Returns the new pass-thru function. Example: >>> func = over([max, min]) >>> func(1, 2, 3, 4) [4, 1] .. versionadded:: 4.0.0 c"fdDS)Ncg|]}|SrYrY.0r9r:s r> z'over.._over..s...d ...rHrYr:funcss`r>_overzover.._overs........rHrY)rrs` r>r!r!s#(///// LrHcfd}|S)a Creates a function that checks if all of the functions in `funcs` return truthy when invoked with the arguments it receives. Args: funcs (list): List of functions to be invoked. Returns: callable: Returns the new pass-thru function. Example: >>> func = over_every([bool, lambda x: x is not None]) >>> func(1) True .. versionadded:: 4.0.0 c<tfdDS)Nc3"K|] }|V dSrBrYrs r> z2over_every.._over_every..)11444;111111rH)rLrs`r> _over_everyzover_every.._over_every'11115111111rHrY)rrs` r>r"r"s$(22222 rHcfd}|S)a Creates a function that checks if any of the functions in `funcs` return truthy when invoked with the arguments it receives. Args: funcs (list): List of functions to be invoked. Returns: callable: Returns the new pass-thru function. Example: >>> func = over_some([bool, lambda x: x is None]) >>> func(1) True .. versionadded:: 4.0.0 c<tfdDS)Nc3"K|] }|V dSrBrYrs r>rz0over_some.._over_some..rrH)anyrs`r> _over_somezover_some.._over_somerrHrY)rrs` r>r#r#s$(22222 rHcfdS)a8 Creates a function that returns the value at path of a given object. Args: path (str|list): Path value to fetch from object. Returns: callable: Function that returns object's path value. Example: >>> get_data = property_('data') >>> get_data({'data': 1}) 1 >>> get_data({}) is None True >>> get_first = property_(0) >>> get_first([1, 2, 3]) 1 .. versionadded:: 1.0.0 .. versionchanged:: 4.0.1 Made property accessor work with deep path strings. c.tj|SrBrTr~)rVrs r>rqzproperty_..sswsD))rHrY)rs`r>r%r%s4 * ) ) ))rHcfdS)a Like :func:`property_` except that it returns a list of values at each path in `paths`. Args: *path (str|list): Path values to fetch from object. Returns: callable: Function that returns object's path value. Example: >>> getter = properties('a', 'b', ['c', 'd', 'e']) >>> getter({'a': 1, 'b': 2, 'c': {'d': {'e': 3}}}) [1, 2, 3] .. versionadded:: 4.1.0 c6fddDDS)Nc&g|] }|SrYrY)rgetterrVs r>rz0properties....s!ZZZs ZZZrHc3>K|]}tj|VdSrB)rTr%)rrs r>rz/properties....s,2Y2Y43=3F3F2Y2Y2Y2Y2Y2YrHrY)rVpathss`r>rqzproperties..s-ZZZZ2Y2YSX2Y2Y2YZZZrHrY)rs`r>r$r$s$ [ Z Z ZZrHcfdS)a' The inverse of :func:`property_`. This method creates a function that returns the key value of a given key on `obj`. Args: obj (dict|list): Object to fetch values from. Returns: callable: Function that returns object's key value. Example: >>> getter = property_of({'a': 1, 'b': 2, 'c': 3}) >>> getter('a') 1 >>> getter('b') 2 >>> getter('x') is None True .. versionadded:: 3.0.0 .. versionchanged:: 4.0.0 Removed alias ``prop_of``. c.tj|SrBr)r5rVs r>rqzproperty_of..sswsC((rHrY)rVs`r>r&r&s4 ) ( ( ((rHFct|tpt|tp|du}||kr||}}|rt||}nt||}|S)a Produces a random number between `start` and `stop` (inclusive). If only one argument is provided a number between 0 and the given number will be returned. If floating is truthy or either `start` or `stop` are floats a floating-point number will be returned instead of an integer. Args: start (int): Minimum value. stop (int): Maximum value. floating (bool, optional): Whether to force random value to ``float``. Defaults to ``False``. Returns: int|float: Random value. Example: >>> 0 <= random() <= 1 True >>> 5 <= random(5, 10) <= 10 True >>> isinstance(random(floating=True), float) True .. versionadded:: 1.0.0 T)rgrrr)startstopfloatingrnds r>r'r'sl6%''V:dE+B+BVhRVFVH e||Te#eT""eT"" JrHct|S)a Creates a list of numbers (positive and/or negative) progressing from start up to but not including end. If `start` is less than `stop`, a zero-length range is created unless a negative `step` is specified. Args: start (int, optional): Integer to start with. Defaults to ``0``. stop (int): Integer to stop at. step (int, optional): The value to increment or decrement by. Defaults to ``1``. Yields: int: Next integer in range. Example: >>> list(range_(5)) [0, 1, 2, 3, 4] >>> list(range_(1, 4)) [1, 2, 3] >>> list(range_(0, 6, 2)) [0, 2, 4] >>> list(range_(4, 1)) [4, 3, 2] .. versionadded:: 1.0.0 .. versionchanged:: 1.1.0 Moved to :mod:`pydash.uilities`. .. versionchanged:: 3.0.0 Return generator instead of list. .. versionchanged:: 4.0.0 Support decrementing when start argument is greater than stop argument.  base_ranger:s r>r(r(EsH t rHct|ddiS)ac Similar to :func:`range_`, except that it populates the values in descending order. Args: start (int, optional): Integer to start with. Defaults to ``0``. stop (int): Integer to stop at. step (int, optional): The value to increment or decrement by. Defaults to ``1`` if `start` < `stop` else ``-1``. Yields: int: Next integer in range. Example: >>> list(range_right(5)) [4, 3, 2, 1, 0] >>> list(range_right(1, 4)) [3, 2, 1] >>> list(range_right(0, 6, 2)) [4, 2, 0] .. versionadded:: 4.0.0 from_rightTrrs r>r)r)ls0 t - - --rHcd|s|St|||}t|r |}|S)ax Return the value of property `key` on `obj`. If `key` value is a function it will be invoked and its result returned, else the property value is returned. If `obj` is falsey then `default` is returned. Args: obj (list|dict): Object to retrieve result from. key (mixed): Key or index to get result from. default (mixed, optional): Default value to return if `obj` is falsey. Defaults to ``None``. Returns: mixed: Result of ``obj[key]`` or ``None``. Example: >>> result({'a': 1, 'b': lambda: 2}, 'a') 1 >>> result({'a': 1, 'b': lambda: 2}, 'b') 2 >>> result({'a': 1, 'b': lambda: 2}, 'c') is None True >>> result({'a': 1, 'b': lambda: 2}, 'c', default=False) False .. versionadded:: 1.0.0 .. versionchanged:: 2.0.0 Added ``default`` argument. )default)r rN)rVr5rr<s r>r*r*sC<  3W - - -C}}cee JrHg?gb@g@cttrdkrtdttrdkrtdttrdkrtdttrdkrtdtttfzr\ttrdksAttr;t dkst dDstdttrt d Dstd rtstd rttsdfrtd nd fd}|S)a? Decorator that retries a function multiple times if it raises an exception with an optional delay between each attempt. When a `delay` is supplied, there will be a sleep period in between retry attempts. The first delay time will always be equal to `delay`. After subsequent retries, the delay time will be scaled by `scale` up to `max_delay`. If `max_delay` is ``0``, then `delay` can increase unbounded. Args: attempts (int, optional): Number of retry attempts. Defaults to ``3``. delay (int|float, optional): Base amount of seconds to sleep between retry attempts. Defaults to ``0.5``. max_delay (int|float, optional): Maximum number of seconds to sleep between retries. Is ignored when equal to ``0``. Defaults to ``150.0`` (2.5 minutes). scale (int|float, optional): Scale factor to increase `delay` after first retry fails. Defaults to ``2.0``. jitter (int|float|tuple, optional): Random jitter to add to `delay` time. Can be a positive number or 2-item tuple of numbers representing the random range to choose from. When a number is given, the random range will be from ``[0, jitter]``. When jitter is a float or contains a float, then a random float will be chosen; otherwise, a random integer will be selected. Defaults to ``0`` which disables jitter. exceptions (tuple, optional): Tuple of exceptions that trigger a retry attempt. Exceptions not in the tuple will be ignored. Defaults to ``(Exception,)`` (all exceptions). on_exception (callable, optional): Function that is called when a retryable exception is caught. It is invoked with ``on_exception(exc, attempt)`` where ``exc`` is the caught exception and ``attempt`` is the attempt count. All arguments are optional. Defaults to ``None``. Example: >>> @retry(attempts=3, delay=0) ... def do_something(): ... print('something') ... raise Exception('something went wrong') >>> try: do_something() ... except Exception: print('caught something') something something something caught something ..versionadded:: 4.4.0 ..versionchanged:: 4.5.0 Added ``jitter`` argument. rz*attempts must be an integer greater than 0z1delay must be a number greater than or equal to 0z1scale must be a number greater than or equal to 0z%scale must be a number greater than 0r@c3@K|]}t|tVdSrB)rgr )rjits r>rzretry..s,,],]sZ\-J-J,],],],],],]rHzCjitter must be a number greater than 0 or a 2-item tuple of numbersc3@K|]}t|tVdSrB) issubclassr8)rexcs r>rzretry..s=44'* 3 ""444444rHz-exceptions must be a tuple of Exception typeszon_exception must be a callablemaxargsNc Nt f d}|S)Nc L }tddzD]} |i|cS#$rx} rt || |kr r|tdt z }|dkrYd}~U rt | }t j|| z}Yd}~d}~wwxYwdS)Nr argcountr)ranger maxr'mintimesleep)r:r; delay_timerrattemptsdelay exceptionsr9jitter max_delayon_exc_argcount on_exceptionscales r> decoratedz+retry..decorator..decorated sJ HqL11 ( ((4000000!(((#U|S'OTTTT(**>"c!VV_&=&== !A~~  @%(Y%?%? Jz***%'JJJJJJ'(  ( (s$B!>B,+BB!)r) r9rrrrrrrrrs ` r> decoratorzretry..decorator s] t ( ( ( ( ( ( ( ( ( ( ( (  (8rH) rgrhrKr rjrJrLrOrNr) rrrrrrrrrs ``````` @r>r+r+s<p h $ $GA EFFF e\ * *NeaiiLMMM i . .N)a--LMMM e\ * *Beqjj@AAA v|uh6 7 7c v| , ,c17! vu % %2<V!!,],]V\,],],])])]!abbb j% ( (I44.844411IGHHH;H\22;9::: j//V>JTk,::::PTO@ rHcgS)z Returns empty "list". Returns: list: Empty list. Example: >>> stub_list() [] .. versionadded:: 4.0.0 rYrYrHr>r,r,.  IrHciS)z Returns empty "dict". Returns: dict: Empty dict. Example: >>> stub_dict() {} .. versionadded:: 4.0.0 rYrYrHr>r-r-?rrHcdS)z Returns ``False``. Returns: bool: False Example: >>> stub_false() False .. versionadded:: 4.0.0 FrYrYrHr>r.r.Ps  5rHcdS)z Returns an empty string. Returns: str: Empty string Example: >>> stub_string() '' .. versionadded:: 4.0.0 rYrYrHr>r/r/as  2rHcdS)z Returns ``True``. Returns: bool: True Example: >>> stub_true() True .. versionadded:: 4.0.0 TrYrYrHr>r0r0rs  4rHcx tdntdfdt|DS)a Executes the iteratee `n` times, returning a list of the results of each iteratee execution. The iteratee is invoked with one argument: ``(index)``. Args: n (int): Number of times to execute `iteratee`. iteratee (callable): Function to execute. Returns: list: A list of results from calling `iteratee`. Example: >>> times(5, lambda i: i) [0, 1, 2, 3, 4] .. versionadded:: 1.0.0 .. versionchanged:: 3.0.0 Reordered arguments to make `iteratee` first. .. versionchanged:: 4.0.0 - Re-reordered arguments to make `iteratee` last argument. - Added functionality for handling `iteratee` with zero positional arguments. Nr rc4g|]}t|S)rrC)rindexrrs r>rztimes..s( M M M5F8UX 6 6 6 M M MrH)rrr)nrrs `@r>r1r1sM6x333 M M M M ME!HH M M MMrHct|}t|trdt|D}n|g}|S)a Converts values to a property path array. Args: value (mixed): Value to convert. Returns: list: Returns the new property path array. Example: >>> to_path('a.b.c') ['a', 'b', 'c'] >>> to_path('a[0].b.c') ['a', 0, 'b', 'c'] >>> to_path('a[0][1][2].b.c') ['a', 0, 1, 2, 'b', 'c'] .. versionadded:: 4.0.0 .. versionchanged:: 4.2.1 Ensure returned path is always a list. cJg|] }t|tr|jn|!SrY)rgr4r5)rtokens r>rzto_path..s:   EJE955 @EII5   rH)to_path_tokensrgrI)r]tokensrs r>r2r2sZ0E " "F&$  N\]bNcNc   x KrHc^tdz a|d}ntj|}|tS)an Generates a unique ID. If `prefix` is provided the ID will be appended to it. Args: prefix (str, optional): String prefix to prepend to ID value. Returns: str: ID value. Example: >>> unique_id() '1' >>> unique_id('id_') 'id_2' >>> unique_id() '3' .. versionadded:: 1.0.0 r Nr) ID_COUNTERrT to_string)prefixs r>r3r3s9.!OJ ~v&& "j " ""rHc@tj|r;d|vsd|vr3dtdt|D}nNtj|stj|rt |tg}n|turg}n|}|S)z.Parse `value` into :class:`PathToken` objects..[c g|]j}t|r+tt|ddtn"tt |t kS)r r6)RE_PATH_LIST_INDEXmatchr4rhrIunescape_path_keyrk)rr5s r>rz"to_path_tokens..sw   "'',, IIc#ad)nnd ; ; ; ;,S114HHH   rHNr) rT is_stringfilterRE_PATH_KEY_DELIMsplit is_numberr4rkr )r]keyss r>rrs }U  d$5$;$;E$B$BCC     u  u!5!5%6667 % KrHc^|dd}|dd}|S)zUnescape path key.z\\\z\.r)replace)r5s r>rrs- ++eT " "C ++eT " "C JrHc|ddtdkr ddnCtdkrdddfntdkr dddfrd dd}n}|D]<}t|ts%t dt |jd =fd }|S) zYield range values.rFrNr@rr zrange cannot interpret z object as an integerc3KsdS\}}}| ||krdnd}tttj||z |pdz dg}r|||z|z z }|dz}|r|V||z }|dz}|dSdS)Nr rr)rhrrr)rrsteplengthr:rs r>genzbase_range..gens  F tT < 11"DS$)TE\dia$@AA1EFFGG   dVmt+ +E BJD KKK TME aKF      rH)r~rJrgrhrOtype__name__)r:r; check_argsrerrs` @r>rr sL%00J 4yyA~~BQBx TaQa$' Ta47D! Q"1"X  cc#s## cad3ii6Haaabb b c* 355LrHrB)r)rr F)C__doc__ collectionsrr functoolsrrrr'rrrerpydashrThelpersr r r r rr__all__compilerrrr4rrrrrrrrrrrrrrrrr r!r"r#r%r$r&r(r)r*r8r+r,r-r.r/r0r1r2r3rrrrYrHr>rs #"""""$$$$$$$$ ######## QQQQQQQQQQQQQQQQ% XBJ>?? RZ -- J{U,=$> ? ? 2444n"""J!!!2$$$00000>0PPPf111<:::6****Z@@   D6444***:[[[*))):%%%%P$$$N...6&&&&T  |{{{{|"""""!N!N!N!NHD####J,)))))rH