O=ddZddlZddlmZddlZddlZddlZddlm Z m Z m Z m Z m Z mZmZddlmZmZmZdZdZd Zd Zd Zd:d Zd Zd:dZdZdZd:dZd:dZd:dZ d:dZ!d:dZ"dZ#dZ$d:dZ%dZ&dZ'd:dZ(d:dZ)de fdZ*dZ+dZ,d Z-d!Z.d:d"Z/d:d#Z0d$Z1d:d%Z2d&Z3d'Z4d:d(Z5d;d+Z6d,Z7d-Z8dd3Z=d4Z>d:d5Z?d6Z@d7ZAd?d9ZBdS)@zU Functions that operate on lists, dicts, and other objects. .. versionadded:: 1.0.0 N)partial)UNSETbase_getbase_setcallit getargcountiterator iteriteratee) PathTokento_pathto_path_tokens),assign assign_with callablesclone clone_deepclone_deep_with clone_withdefaults defaults_deepfind_key find_last_keyfor_in for_in_rightgethasinvert invert_byinvokekeysmap_keys map_valuesmap_values_deepmerge merge_withomitomit_by parse_intpickpick_by rename_keysset_set_with to_booleanto_dict to_integerto_list to_numberto_pairs to_string transformunsetupdate update_withvaluesct|g|RS)a Assigns properties of source object(s) to the destination object. Args: obj (dict): Destination object whose properties will be modified. sources (dict): Source objects to assign to `obj`. Returns: dict: Modified `obj`. Warning: `obj` is modified in place. Example: >>> obj = {} >>> obj2 = assign(obj, {'a': 1}, {'b': 2}, {'c': 3}) >>> obj == {'a': 1, 'b': 2, 'c': 3} True >>> obj is obj2 True .. versionadded:: 1.0.0 .. versionchanged:: 2.3.2 Apply :func:`clone_deep` to each `source` before assigning to `obj`. .. versionchanged:: 3.0.0 Allow iteratees to accept partial arguments. .. versionchanged:: 3.4.4 Shallow copy each `source` instead of deep copying. .. versionchanged:: 4.0.0 - Moved `iteratee` argument to :func:`assign_with`. - Removed alias ``extend``. )robjsourcess 8D:\Sites\api_v1\venv\Lib\site-packages\pydash/objects.pyrrBsN s %W % % %%c t|}|d}|)t|dr|}|t |d}nd}|D]d}|}|D]9\}}|r-t||||||||}||}|||<:e|S)ab This method is like :func:`assign` except that it accepts customizer which is invoked to produce the assigned values. If customizer returns ``None``, assignment is handled by the method instead. The customizer is invoked with five arguments: ``(obj_value, src_value, key, obj, source)``. Args: obj (dict): Destination object whose properties will be modified. sources (dict): Source objects to assign to `obj`. Keyword Args: customizer (mixed, optional): Customizer applied per iteration. Returns: dict: Modified `obj`. Warning: `obj` is modified in place. Example: >>> customizer = lambda o, s: s if o is None else o >>> results = assign({'a': 1}, {'b': 2}, {'a': 3}, customizer) >>> results == {'a': 1, 'b': 2} True .. versionadded:: 4.0.0 customizerNmaxargsargcount)listrcallablepopr copyitemsr) r=r>kwargsrBrHsourcekeyvaluevals r?rrls:7mmGL))Jhwr{33[[]] z1555   ,,..  JC Zuc3Yabbb?ECHH   Jr@cNtdt|DS)a Creates a sorted list of keys of an object that are callable. Args: obj (list|dict): Object to inspect. Returns: list: All keys whose values are callable. Example: >>> callables({'a': 1, 'b': lambda: 2, 'c': lambda: 3}) ['b', 'c'] .. versionadded:: 1.0.0 .. versionchanged:: 2.0.0 Renamed ``functions`` to ``callables``. .. versionchanged:: 4.0.0 Removed alias ``methods``. c3>K|]\}}t||VdSN)rJ.0rPrQs r? zcallables..s1II*#u%I#IIIIIIr@)sortedr r=s r?rrs'. II III I IIr@c t|S)a Creates a clone of `value`. Args: value (list|dict): Object to clone. Example: >>> x = {'a': 1, 'b': 2, 'c': {'d': 3}} >>> y = clone(x) >>> y == y True >>> x is y False >>> x['c'] is y['c'] True Returns: list|dict: Cloned object. .. versionadded:: 1.0.0 .. versionchanged:: 4.0.0 Moved 'iteratee' parameter to :func:`clone_with`.  base_clonerQs r?rrs4 e  r@c$t||S)a This method is like :func:`clone` except that it accepts customizer which is invoked to produce the cloned value. If customizer returns ``None``, cloning is handled by the method instead. The customizer is invoked with up to three arguments: ``(value, index|key, object)``. Args: value (list|dict): Object to clone. customizer (callable, optional): Function to customize cloning. Returns: list|dict: Cloned object. Example: >>> x = {'a': 1, 'b': 2, 'c': {'d': 3}} >>> cbk = lambda v, k: v + 2 if isinstance(v, int) and k else None >>> y = clone_with(x, cbk) >>> y == {'a': 3, 'b': 4, 'c': {'d': 3}} True rBr\rQrBs r?rrs* e 3 3 33r@c$t|dS)a% Creates a deep clone of `value`. If a iteratee is provided it will be executed to produce the cloned values. Args: value (list|dict): Object to clone. Returns: list|dict: Cloned object. Example: >>> x = {'a': 1, 'b': 2, 'c': {'d': 3}} >>> y = clone_deep(x) >>> y == y True >>> x is y False >>> x['c'] is y['c'] False .. versionadded:: 1.0.0 .. versionchanged:: 4.0.0 Moved 'iteratee' parameter to :func:`clone_deep_with`. T)is_deepr\r^s r?rrs6 eT * * **r@c&t|d|S)a  This method is like :func:`clone_with` except that it recursively clones `value`. Args: value (list|dict): Object to clone. customizer (callable, optional): Function to customize cloning. Returns: list|dict: Cloned object. T)rcrBr\ras r?rrs eTj A A AAr@cp|D]2}|D]\}}|||3|S)aZ Assigns properties of source object(s) to the destination object for all destination properties that resolve to undefined. Args: obj (dict): Destination object whose properties will be modified. sources (dict): Source objects to assign to `obj`. Returns: dict: Modified `obj`. Warning: `obj` is modified in place. Example: >>> obj = {'a': 1} >>> obj2 = defaults(obj, {'b': 2}, {'c': 3}, {'a': 4}) >>> obj is obj2 True >>> obj == {'a': 1, 'b': 2, 'c': 3} True .. versionadded:: 1.0.0 )rM setdefault)r=r>rOrPrQs r?rrsQ4'' ,,.. ' 'JC NN3 & & & & ' Jr@c(d}t|g|Rd|iS)a= This method is like :func:`defaults` except that it recursively assigns default properties. Args: obj (dict): Destination object whose properties will be modified. sources (dict): Source objects to assign to `obj`. Returns: dict: Modified `obj`. Warning: `obj` is modified in place. Example: >>> obj = {'a': {'b': 1}} >>> obj2 = defaults_deep(obj, {'a': {'b': 2, 'c': 3}}) >>> obj is obj2 True >>> obj == {'a': {'b': 1, 'c': 3}} True .. versionadded:: 3.3.0 cVt|dr|||dSdS)Nrf)hasattrrf)r=rPrQs r?setterzdefaults_deep..setterXs8 3 % % ' NN3 & & & & & ' 'r@_setterr&)r=r>rjs r?rr>s14''' c 4G 4 4 4V 4 44r@cBt||D] \}}}}|r|cSdS)a This method is like :func:`pydash.arrays.find_index` except that it returns the key of the first element that passes the predicate check, instead of the element itself. Args: obj (list|dict): Object to search. predicate (mixed): Predicate applied per iteration. Returns: mixed: Found key or ``None``. Example: >>> find_key({'a': 1, 'b': 2, 'c': 3}, lambda x: x == 1) 'a' >>> find_key([1, 2, 3, 4], lambda x: x == 1) 0 .. versionadded:: 1.0.0 Nr )r= predicateresult_rPs r?rr_sF**#y993  JJJ r@czttt||}|D] \}}}}|r|cSdS)ac This method is like :func:`find_key` except that it iterates over elements of a collection in the opposite order. Args: obj (list|dict): Object to search. predicate (mixed): Predicate applied per iteration. Returns: mixed: Found key or ``None``. Example: >>> find_last_key({'a': 1, 'b': 2, 'c': 3}, lambda x: x == 1) 'a' >>> find_last_key([1, 2, 3, 1], lambda x: x == 1) 3 .. versionchanged:: 4.0.0 Made into its own function (instead of an alias of ``find_key``) with proper reverse find implementation. N)reversedrIr )r=ro reversed_objrprqrPs r?rrys[.Dc9!=!=>>??L)3  JJJ r@cZdt||D}t|d|S)ag Iterates over own and inherited enumerable properties of `obj`, executing `iteratee` for each property. Args: obj (list|dict): Object to process. iteratee (mixed): Iteratee applied per iteration. Returns: list|dict: `obj`. Example: >>> obj = {} >>> def cb(v, k): obj[k] = v >>> results = for_in({'a': 1, 'b': 2, 'c': 3}, cb) >>> results == {'a': 1, 'b': 2, 'c': 3} True >>> obj == {'a': 1, 'b': 2, 'c': 3} True .. versionadded:: 1.0.0 .. versionchanged:: 4.0.0 Removed alias ``for_own``. c3,K|]\}}}}|du dVdSFNrWretrqs r?rXzfor_in..s. Q Q\S!QC5LLDLLLL Q Qr@Nr nextr=iterateewalks r?rrs76 R Q\#x%@%@ Q Q QDt Jr@c^dt||dD}t|d|S)a1 This function is like :func:`for_in` except it iterates over the properties in reverse order. Args: obj (list|dict): Object to process. iteratee (mixed): Iteratee applied per iteration. Returns: list|dict: `obj`. Example: >>> data = {'product': 1} >>> def cb(v): data['product'] *= v >>> for_in_right([1, 2, 3, 4], cb) [1, 2, 3, 4] >>> data['product'] == 24 True .. versionadded:: 1.0.0 .. versionchanged:: 4.0.0 Removed alias ``for_own_right``. c3,K|]\}}}}|du dVdSrwrxrys r?rXzfor_in_right..s6 _ _\S!QRUY^R^R^DR^R^R^R^ _ _r@T)reverseNr{r}s r?rrs<2 ` _\#x%N%N%N _ _ _Dt Jr@c|tur|}nt}t|D]}t|||}||ur|}n|S)a? Get the value at any depth of a nested object based on the path described by `path`. If path doesn't exist, `default` is returned. Args: obj (list|dict|Sequence|Mapping): Object to process. path (str|list): List or ``.`` delimited string of path describing path. default (mixed): Default value to return if path doesn't exist. Defaults to ``None``. Returns: mixed: Value of `obj` at path. Example: >>> get({}, 'a.b.c') is None True >>> get({'a': {'b': {'c': [1, 2, 3, 4]}}}, 'a.b.c[1]') 2 >>> get({'a': {'b': {'c': [1, 2, 3, 4]}}}, 'a.b.c.1') 2 >>> get({'a': {'b': [0, {'c': [1, 2]}]}}, 'a.b.1.c.1') 2 >>> get({'a': {'b': [0, {'c': [1, 2]}]}}, ['a', 'b', 1, 'c', 1]) 2 >>> get({'a': {'b': [0, {'c': [1, 2]}]}}, 'a.b.1.c.2') is None True .. versionadded:: 2.0.0 .. versionchanged:: 2.2.0 Support escaping "." delimiter in single string path key. .. versionchanged:: 3.3.0 - Added :func:`get` as main definition and :func:`get_path` as alias. - Made :func:`deep_get` an alias. .. versionchanged:: 3.4.7 Fixed bug where an iterable default was iterated over instead of being returned when an object path wasn't found. .. versionchanged:: 4.0.0 - Support attribute access on `obj` if item access fails. - Removed aliases ``get_path`` and ``deep_get``. .. versionchanged:: 4.7.6 Fixed bug where getattr is used on Mappings and Sequence in Python 3.5+ default)robjectr r)r=pathrsentinelrPs r?rrsjd% 88t}}sC222 (??C E  Jr@c t||td}n%#tttt f$rd}YnwxYw|S)a Checks if `path` exists as a key of `obj`. Args: obj (mixed): Object to test. path (mixed): Path to test for. Can be a list of nested keys or a ``.`` delimited string of path describing the path. Returns: bool: Whether `obj` has `path`. Example: >>> has([1, 2, 3], 1) True >>> has({'a': 1, 'b': 2}, 'b') True >>> has({'a': 1, 'b': 2}, 'c') False >>> has({'a': {'b': [0, {'c': [1, 2]}]}}, 'a.b.1.c.1') True >>> has({'a': {'b': [0, {'c': [1, 2]}]}}, 'a.b.1.c.2') False .. versionadded:: 1.0.0 .. versionchanged:: 3.0.0 Return ``False`` on ``ValueError`` when checking path. .. versionchanged:: 3.3.0 - Added :func:`deep_has` as alias. - Added :func:`has_path` as alias. .. versionchanged:: 4.0.0 Removed aliases ``deep_has`` and ``has_path``. rTF)rrKeyError IndexError TypeError ValueError)r=rexistss r?rrsXL Cu%%%% j)Z 8 Ms >>c4dt|DS)aE Creates an object composed of the inverted keys and values of the given object. Args: obj (dict): Dict to invert. Returns: dict: Inverted dict. Example: >>> results = invert({'a': 1, 'b': 2, 'c': 3}) >>> results == {1: 'a', 2: 'b', 3: 'c'} True Note: Assumes `obj` values are hashable as ``dict`` keys. .. versionadded:: 1.0.0 .. versionchanged:: 2.0.0 Added ``multivalue`` argument. .. versionchanged:: 4.0.0 Moved ``multivalue=True`` functionality to :func:`invert_by`. ci|]\}}|| SrxrxrVs r? zinvert..ds 7 7 7:3E3 7 7 7r@r rZs r?rrIs6 8 7# 7 7 77r@ctj|}i}t|D]7\}}|||g|8|S)a This method is like :func:`invert` except that the inverted object is generated from the results of running each element of object thru iteratee. The corresponding inverted value of each inverted key is a list of keys responsible for generating the inverted value. The iteratee is invoked with one argument: ``(value)``. Args: obj (dict): Object to invert. iteratee (mixed): Iteratee applied per iteration. Returns: dict: Inverted dict. Example: >>> obj = {'a': 1, 'b': 2, 'c': 1} >>> results = invert_by(obj) # {1: ['a', 'c'], 2: ['b']} >>> set(results[1]) == set(['a', 'c']) True >>> set(results[2]) == set(['b']) True >>> results2 = invert_by(obj, lambda value: 'group' + str(value)) >>> results2['group1'] == results[1] True >>> results2['group2'] == results[2] True Note: Assumes `obj` values are hashable as ``dict`` keys. .. versionadded:: 4.0.0 )pydr~r rfappend)r=r~callbackrprPrQs r?rrgsfB|H%%H Fsmm;; U((5//2..55c:::: Mr@ct|}tj|}tj|} t t |||}||i|}n#t $rd}YnwxYw|S)a) Invokes the method at path of object. Args: obj (dict): The object to query. path (list|str): The path of the method to invoke. args (optional): Arguments to pass to method call. kwargs (optional): Keyword arguments to pass to method call. Returns: mixed: Result of the invoked method. Example: >>> obj = {'a': [{'b': {'c': [1, 2, 3, 4]}}]} >>> invoke(obj, 'a[0].b.c.pop', 1) 2 >>> obj {'a': [{'b': {'c': [1, 3, 4]}}]} .. versionadded:: 1.0.0 N)r rinitiallastgetattrrAttributeError) r=rargsrNpaths target_path method_namemethodrzs r?r r s. DMME+e$$K(5//K&S+.. <<fd%f%%  JsA A/.A/c4dt|DS)a Creates a list composed of the keys of `obj`. Args: obj (mixed): Object to extract keys from. Returns: list: List of keys. Example: >>> keys([1, 2, 3]) [0, 1, 2] >>> set(keys({'a': 1, 'b': 2, 'c': 3})) == set(['a', 'b', 'c']) True .. versionadded:: 1.0.0 .. versionchanged:: 1.1.0 Added ``keys_in`` as alias. .. versionchanged:: 4.0.0 Removed alias ``keys_in``. cg|]\}}|Srxrx)rWrPrqs r? zkeys..s , , ,FCC , , ,r@rrZs r?r!r!s2 - ,hsmm , , ,,r@c6dt||DS)a The opposite of :func:`map_values`, this method creates an object with the same values as object and keys generated by running each own enumerable string keyed property of object thru iteratee. The iteratee is invoked with three arguments: ``(value, key, object)``. Args: obj (list|dict): Object to map. iteratee (mixed): Iteratee applied per iteration. Returns: list|dict: Results of running `obj` through `iteratee`. Example: >>> callback = lambda value, key: key * 2 >>> results = map_keys({'a': 1, 'b': 2, 'c': 3}, callback) >>> results == {'aa': 1, 'bb': 2, 'cc': 3} True .. versionadded:: 3.3.0 ci|] \}}}}|| Srxrx)rWrprQrqs r?rzmap_keys..s# Q Q Q1feQFE Q Q Qr@rnr=r~s r?r"r"s#, R Q\#x5P5P Q Q QQr@c6dt||DS)a Creates an object with the same keys as object and values generated by running each string keyed property of object thru iteratee. The iteratee is invoked with three arguments: ``(value, key, object)``. Args: obj (list|dict): Object to map. iteratee (mixed): Iteratee applied per iteration. Returns: list|dict: Results of running `obj` through `iteratee`. Example: >>> results = map_values({'a': 1, 'b': 2, 'c': 3}, lambda x: x * 2) >>> results == {'a': 2, 'b': 4, 'c': 6} True >>> results = map_values({'a': 1, 'b': {'d': 4}, 'c': 3}, {'d': 4}) >>> results == {'a': False, 'b': True, 'c': False} True .. versionadded:: 1.0.0 ci|] \}}}}|| Srxrx)rWrprqrPs r?rzmap_values..s# M M M-FAsAC M M Mr@rnrs r?r#r#s#0 N Mc81L1L M M MMr@ct|tj|r$fd}t|t ||St |S)a Map all non-object values in `obj` with return values from `iteratee`. The iteratee is invoked with two arguments: ``(obj_value, property_path)`` where ``property_path`` contains the list of path keys corresponding to the path of ``obj_value``. Args: obj (list|dict): Object to map. iteratee (callable): Iteratee applied to each value. property_path (mixed, optional): Path key(s) to access. Returns: mixed: The modified object. Warning: `obj` is modified in place. Example: >>> x = {'a': 1, 'b': {'c': 2}} >>> y = map_values_deep(x, lambda val: val * 2) >>> y == {'a': 2, 'b': {'c': 4}} True >>> z = map_values_deep(x, lambda val, props: props) >>> z == {'a': ['a'], 'b': {'c': ['b', 'c']}} True .. versionadded: 2.2.0 .. versionchanged:: 3.0.0 Allow iteratees to accept partial arguments. .. versionchanged:: 4.0.0 Renamed from ``deep_map_values`` to ``map_values_deep``. cNt|tj|gSrU)r$rflatten)rQrPr~ propertiess r? deep_iterateez&map_values_deep..deep_iteratee-s$"5(CKS@Q4R4RSS Sr@)r r is_objectrr#r)r=r~ property_pathrrs ` @r?r$r$sxF''J }S1 T T T T T Tc:c=99:::hZ000r@ct|g|RS)aT Recursively merges properties of the source object(s) into the destination object. Subsequent sources will overwrite property assignments of previous sources. Args: obj (dict): Destination object to merge source(s) into. sources (dict): Source objects to merge from. subsequent sources overwrite previous ones. Returns: dict: Merged object. Warning: `obj` is modified in place. Example: >>> obj = {'a': 2} >>> obj2 = merge(obj, {'a': 1}, {'b': 2, 'c': 3}, {'d': 4}) >>> obj2 == {'a': 1, 'b': 2, 'c': 3, 'd': 4} True >>> obj is obj2 True .. versionadded:: 1.0.0 .. versionchanged:: 2.3.2 Apply :func:`clone_deep` to each `source` before assigning to `obj`. .. versionchanged:: 2.3.2 Allow `iteratee` to be passed by reference if it is the last positional argument. .. versionchanged:: 4.0.0 Moved iteratee argument to :func:`merge_with`. .. versionchanged:: 4.9.3 Fixed regression in v4.8.0 that caused exception when `obj` was ``None``. rlr<s r?r%r%5sL c $G $ $ $$r@cZ|dSt|}|dd}|+|r)t|dr|}d|D}t|r'tt|t |d}nd}t |g|Rd|i|S)a This method is like :func:`merge` except that it accepts customizer which is invoked to produce the merged values of the destination and source properties. If customizer returns ``None``, merging is handled by this method instead. The customizer is invoked with five arguments: ``(obj_value, src_value, key, obj, source)``. Args: obj (dict): Destination object to merge source(s) into. sources (dict): Source objects to merge from. subsequent sources overwrite previous ones. Keyword Args: iteratee (callable, optional): Iteratee function to handle merging (must be passed in as keyword argument). Returns: dict: Merged object. Warning: `obj` is modified in place. Example: >>> cbk = lambda obj_val, src_val: obj_val + src_val >>> obj1 = {'a': [1], 'b': [2]} >>> obj2 = {'a': [3], 'b': [4]} >>> res = merge_with(obj1, obj2, cbk) >>> obj1 == {'a': [1, 3], 'b': [2, 4]} True .. versionadded:: 4.0.0 .. versionchanged:: 4.9.3 Fixed regression in v4.8.0 that caused exception when `obj` was ``None``. Nr~rCc6g|]}tj|Srx)rLdeepcopy)rWrOs r?rzmerge_with..s";;;t}V$$;;;r@rDrErG)rIrKrJrrr _merge_with)r=r>rNr~s r?r&r&^sH {t7mmGzz*d++HG(=(=;;==;;7;;;G68k(TU6V6V6VWWW s BW B B Bx B6 B BBr@c |d}|d}|t}|D]}t|D]\}}t||d}t |t ot |t } t |t ot |t } d} |r||||||} | | } n| s| rt||||} n|} |||| |S)Nr~rkr)r~rk)rrr r isinstancerIdictr) r=r>rNr~rjrOrP src_value obj_value all_sequences all_mappings_resultrps r?rrs,zz*%%H ZZ " "F ~%%&v.. % %NC c4888I&y$77WJyRV>> omit({'a': 1, 'b': 2, 'c': 3}, 'b', 'c') == {'a': 1} True >>> omit({'a': 1, 'b': 2, 'c': 3 }, ['a', 'c']) == {'b': 2} True >>> omit([1, 2, 3, 4], 0, 3) == {1: 2, 2: 3} True >>> omit({'a': {'b': {'c': 'd'}}}, 'a.b.c') == {'a': {'b': {}}} True .. versionadded:: 1.0.0 .. versionchanged:: 4.0.0 Moved iteratee argument to :func:`omit_by`. .. versionchanged:: 4.2.0 Support deep paths. )r(rrr=rs r?r'r's> 3 J// 0 00r@cZtsltjt}t d|Drt |}nt |}d}tj|||}n-tdfdt|D}|S)a The opposite of :func:`pick_by`. This method creates an object composed of the string keyed properties of object that predicate doesn't return truthy for. The predicate is invoked with two arguments: ``(value, key)``. Args: obj (mixed): Object to process. iteratee (mixed, optional): Iteratee used to determine which properties to omit. Returns: dict: Results of omitting properties. Example: >>> omit_by({'a': 1, 'b': '2', 'c': 3}, lambda v: isinstance(v, int)) {'b': '2'} .. versionadded:: 4.0.0 .. versionchanged:: 4.2.0 Support deep paths for `iteratee`. c3<K|]}t|dkVdS)rN)len)rWrs r?rXzomit_by..s,//s4yy1}//////r@c0tj|||SrU)rr7)r=rs r?_unsetzomit_by.._unsets Ic4 Jr@rEcBi|]\}}t||||S)rGr)rWrPrQrHr~s r?rzomit_by..sF   U(E3BBB    r@) rJrmap_r anyrr0reduce_r r )r=r~rclonedrrzrHs ` @r?r(r(s. H   7++ ///// / / "__FFS\\F   k%00x333     &smm    Jr@c|s8tj|r$ t|dd}n#t$rYnwxYw|sd} |dkr|fnt ||f}t|}n#tt f$rd}YnwxYw|S)a  Converts the given `value` into an integer of the specified `radix`. If `radix` is falsey, a radix of ``10`` is used unless the `value` is a hexadecimal, in which case a radix of 16 is used. Args: value (mixed): Value to parse. radix (int, optional): Base to convert to. Returns: mixed: Integer if parsable else ``None``. Example: >>> parse_int('5') 5 >>> parse_int('12', 8) 10 >>> parse_int('x') is None True .. versionadded:: 1.0.0  N)r is_stringintrr5r)rQradixrparseds r?r)r)s0 S]5))  rNNNEE    D  !B;;xxYu-=-=u,Ed  " Ms+ 88#A$$A:9A:cFt|tj|S)a Creates an object composed of the picked object properties. Args: obj (list|dict): Object to pick from. properties (str): Property values to pick. Returns: dict: Dict containing picked properties. Example: >>> pick({'a': 1, 'b': 2, 'c': 3}, 'a', 'b') == {'a': 1, 'b': 2} True .. versionadded:: 1.0.0 .. versionchanged:: 4.0.0 Moved iteratee argument to :func:`pick_by`. )r+rrrs r?r*r*3s* 3 J// 0 00r@c<t|t|r2t}|tj}d}nt |d}n ||ng}fd}d}i}|D]6}t |}t||||rt|||7|S)a! Creates an object composed of the object properties predicate returns truthy for. The predicate is invoked with two arguments: ``(value, key)``. Args: obj (list|dict): Object to pick from. iteratee (mixed, optional): Iteratee used to determine which properties to pick. Returns: dict: Dict containing picked properties. Example: >>> obj = {'a': 1, 'b': '2', 'c': 3 } >>> pick_by(obj, lambda v: isinstance(v, int)) == {'a': 1, 'c': 3} True .. versionadded:: 4.0.0 NrrrEc$t|SrU)r)rQrr=s r?r~zpick_by..iterateekssD>> !r@rG) r0rJr!ridentityr rrr-)r=r~rrHrprrQs` r?r+r+Ks( #,,C8H--S   |HHH"8Q777HH$0b " " " " " F&&C (E4( ; ; ; & u % % % Mr@cDfd|DS)a Rename the keys of `obj` using `key_map` and return new object. Args: obj (dict): Object to rename. key_map (dict): Renaming map whose keys correspond to existing keys in `obj` and whose values are the new key name. Returns: dict: Renamed `obj`. Example: >>> obj = rename_keys({'a': 1, 'b': 2, 'c': 3}, {'a': 'A', 'b': 'B'}) >>> obj == {'A': 1, 'B': 2, 'c': 3} True .. versionadded:: 2.0.0 cDi|]\}}|||Srx)r)rWrPrQkey_maps r?rzrename_keys..s- G G GZS%GKKS ! !5 G G Gr@)rM)r=rs `r?r,r,{s(( H G G G399;; G G GGr@c$t|||S)a Sets the value of an object described by `path`. If any part of the object path doesn't exist, it will be created. Args: obj (list|dict): Object to modify. path (str | list): Target path to set value to. value (mixed): Value to set. Returns: mixed: Modified `obj`. Warning: `obj` is modified in place. Example: >>> set_({}, 'a.b.c', 1) {'a': {'b': {'c': 1}}} >>> set_({}, 'a.0.c', 1) {'a': {'0': {'c': 1}}} >>> set_([1, 2], '[2][0]', 1) [1, 2, [1]] >>> set_({}, 'a.b[0].c', 1) {'a': {'b': [{'c': 1}]}} .. versionadded:: 2.2.0 .. versionchanged:: 3.3.0 Added :func:`set_` as main definition and :func:`deep_set` as alias. .. versionchanged:: 4.0.0 - Modify `obj` in place. - Support creating default path values as ``list`` or ``dict`` based on whether key or index substrings are used. - Remove alias ``deep_set``. )r.)r=rrQs r?r-r-sN Cu % %%r@cLt||tj||S)aN This method is like :func:`set_` except that it accepts customizer which is invoked to produce the objects of path. If customizer returns undefined path creation is handled by the method instead. The customizer is invoked with three arguments: ``(nested_value, key, nested_object)``. Args: obj (list|dict): Object to modify. path (str | list): Target path to set value to. value (mixed): Value to set. customizer (callable, optional): The function to customize assigned values. Returns: mixed: Modified `obj`. Warning: `obj` is modified in place. Example: >>> set_with({}, '[0][1]', 'a', lambda: {}) {0: {1: 'a'}} .. versionadded:: 4.0.0 .. versionchanged:: 4.3.1 Fixed bug where a callable `value` was called when being set. r`)r9rconstant)r=rrQrBs r?r.r.s%8 sD#,u"5"5* M M MMr@true1false0ctj|r<|}d}|r|||rd}n#|r|||rd}nd}nt|}|S)a Convert `obj` to boolean. This is not like the builtin ``bool`` function. By default commonly considered strings values are converted to their boolean equivalent, i.e., ``'0'`` and ``'false'`` are converted to ``False`` while ``'1'`` and ``'true'`` are converted to ``True``. If a string value is provided that isn't recognized as having a common boolean conversion, then the returned value is ``None``. Non-string values of `obj` are converted using ``bool``. Optionally, `true_values` and `false_values` can be overridden but each value must be a string. Args: obj (mixed): Object to convert. true_values (tuple, optional): Values to consider ``True``. Each value must be a string. Comparision is case-insensitive. Defaults to ``('true', '1')``. false_values (tuple, optional): Values to consider ``False``. Each value must be a string. Comparision is case-insensitive. Defaults to ``('false', '0')``. Returns: bool: Boolean value of `obj`. Example: >>> to_boolean('true') True >>> to_boolean('1') True >>> to_boolean('false') False >>> to_boolean('0') False >>> assert to_boolean('a') is None .. versionadded:: 3.0.0 c|d|DvrdStjd||S)Nc6g|]}|Srx)lower)rWrRs r?rz5to_boolean..boolean_match..s <<< <<.boolean_matchsEzz||<> EEEES  Lr@cz t|S#t$rtt|cYSwxYw)a Convert `obj` to ``dict`` by creating a new ``dict`` using `obj` keys and values. Args: obj: (mixed): Object to convert. Returns: dict: Object converted to ``dict``. Example: >>> obj = {'a': 1, 'b': 2} >>> obj2 = to_dict(obj) >>> obj2 == obj True >>> obj2 is not obj True .. versionadded:: 3.0.0 .. versionchanged:: 4.0.0 Removed alias ``to_plain_object``. .. versionchanged:: 4.2.0 Use ``pydash.helpers.iterator`` to generate key/value pairs. .. versionchanged:: 4.7.1 Try to convert to ``dict`` using ``dict()`` first, then fallback to using ``pydash.helpers.iterator``. )r Exceptionr rZs r?r0r0sH>#Cyy ###HSMM"""""#s &::ct tt|}n#ttf$rd}YnwxYw|S)a Converts `obj` to an integer. Args: obj (str|int|float): Object to convert. Returns: int: Converted integer or ``0`` if it can't be converted. Example: >>> to_integer(3.2) 3 >>> to_integer('3.2') 3 >>> to_integer('3.9') 3 >>> to_integer('invalid') 0 .. versionadded:: 4.0.0 r)rfloatrr)r=nums r?r1r16sL.%**oo  " Js 55Tczt|tr |ddSt|tr|S|st|tt fr|gS|r.t|t rtd|DS t|S#t $r|gcYSwxYw)a Converts a obj, an iterable or a single item to a list. Args: obj (mixed): Object to convert item or wrap. split_strings (bool, optional): Whether to split strings into single chars. Defaults to ``True``. Returns: list: Converted obj or wrapped item. Example: >>> results = to_list({'a': 1, 'b': 2, 'c': 3}) >>> assert set(results) == set([1, 2, 3]) >>> to_list((1, 2, 3, 4)) [1, 2, 3, 4] >>> to_list(1) [1] >>> to_list([1]) [1] >>> to_list(a for a in [1, 2, 3]) [1, 2, 3] >>> to_list('cat') ['c', 'a', 't'] >>> to_list('cat', split_strings=False) ['cat'] .. versionadded:: 1.0.0 .. versionchanged:: 4.3.0 - Wrap non-iterable items in a list. - Convert other iterables to list. - Byte objects are returned as single character strings in Python 3. Nc3bK|]*}t|trt|n|V+dSrU)rrchr)rWcs r?rXzto_list..s;EEAjC007CFFFaEEEEEEr@)rrIrr:strbytesr)r= split_stringss r?r2r2WsV#t 111v C   zz||  z#U|<< u :c511EEEEEEEE 99    5LLL sB** B:9B:c td|}|dkr tj}nt}|t ||z|z }n#t $rd}YnwxYw|S)a| Convert `obj` to a number. All numbers are retuned as ``float``. If precision is negative, round `obj` to the nearest positive integer place. If `obj` can't be converted to a number, ``None`` is returned. Args: obj (str|int|float): Object to convert. precision (int, optional): Precision to round number to. Defaults to ``0``. Returns: float: Converted number or ``None`` if can't be converted. Example: >>> to_number('1234.5678') 1235.0 >>> to_number('1234.5678', 4) 1234.5678 >>> to_number(1, 2) 1.0 .. versionadded:: 3.0.0 rrN)powmathfloorroundrr)r= precisionfactorrounderrs r?r3r3s{0 R## q==jGGGgeCjj6)**V3  JsAA AAc4dt|DS)a Creates a two dimensional list of an object's key-value pairs, i.e. ``[[key1, value1], [key2, value2]]``. Args: obj (mixed): Object to process. Returns: list: Two dimensional list of object's key-value pairs. Example: >>> to_pairs([1, 2, 3, 4]) [[0, 1], [1, 2], [2, 3], [3, 4]] >>> to_pairs({'a': 1}) [['a', 1]] .. versionadded:: 1.0.0 .. versionchanged:: 4.0.0 Renamed from ``pairs`` to ``to_pairs``. cg|] \}}||g SrxrxrVs r?rzto_pairs..s 9 9 9ZS%S%L 9 9 9r@rrZs r?r4r4s. : 98C== 9 9 99r@c\tj|r|}n|d}nt|}|S)a Converts an object to string. Args: obj (mixed): Object to convert. Returns: str: String representation of `obj`. Example: >>> to_string(1) == '1' True >>> to_string(None) == '' True >>> to_string([1, 2, 3]) == '[1, 2, 3]' True >>> to_string('a') == 'a' True .. versionadded:: 2.0.0 .. versionchanged:: 3.0.0 Convert ``None`` to empty string. N)rrr)r=ress r?r5r5s94 }S #hh Jr@ctjdntdgfdtD}t |dS)aF An alernative to :func:`pydash.collections.reduce`, this method transforms `obj` to a new accumulator object which is the result of running each of its properties through a iteratee, with each iteratee execution potentially mutating the accumulator object. The iteratee is invoked with four arguments: ``(accumulator, value, key, object)``. Iteratees may exit iteration early by explicitly returning ``False``. Args: obj (list|dict): Object to process. iteratee (mixed): Iteratee applied per iteration. accumulator (mixed, optional): Accumulated object. Defaults to ``list``. Returns: mixed: Accumulated object. Example: >>> transform([1, 2, 3, 4], lambda acc, v, k: acc.append((k, v))) [(0, 1), (1, 2), (2, 3), (3, 4)] .. versionadded:: 1.0.0 NrrEc 3PK|] \}}t||dudV!dS)rGFNr)rWrPitem accumulatorrHr~r=s r?rXztransform..sS   C (KsC( K K Ku T T T T T T  r@)rrr r r|)r=r~rrrHs``` @r?r6r6s.<x333        !#   D  t r@c$t|||S)a This method is like :func:`set_` except that accepts updater to produce the value to set. Use :func:`update_with` to customize path creation. The updater is invoked with one argument: ``(value)``. Args: obj (list|dict): Object to modify. path (str|list): A string or list of keys that describe the object path to modify. updater (callable): Function that returns updated value. Returns: mixed: Updated `obj`. Warning: `obj` is modified in place. Example: >>> update({}, ['a', 'b'], lambda value: value) {'a': {'b': None}} >>> update([], [0, 0], lambda value: 1) [[1]] .. versionadded:: 4.0.0 )r9)r=rupdaters r?r8r8"s4 sD' * **r@c|t|stj|}|-t|sttt |d}n+|r'tt|t |d}nd}t|trtnt}t|}tj |s|g}tj |}t|tr|j}|}ttj|D]\} } t| tr$| j} tj|| dzdg|} n| } |} t%|| d} d}|r || | |}| | }t'|| |d  t%|| d}#t($rL} |t+| }d}n#t,$rd }YnwxYw|rt)d | d |Yd}~d}~wwxYwt%||d}t'||t |||S) a4 This method is like :func:`update` except that it accepts customizer which is invoked to produce the objects of path. If customizer returns ``None``, path creation is handled by the method instead. The customizer is invoked with three arguments: ``(nested_value, key, nested_object)``. Args: obj (list|dict): Object to modify. path (str|list): A string or list of keys that describe the object path to modify. updater (callable): Function that returns updated value. customizer (callable, optional): The function to customize assigned values. Returns: mixed: Updated `obj`. Warning: `obj` is modified in place. Example: >>> update_with({}, '[0][1]', lambda: 'a', lambda: {}) {0: {1: 'a'}} .. versionadded:: 4.0.0 NrrGrEdefault_factoryrF)allow_overrideTz!Unable to update object at index z. )rJrrrrrr rrrIris_listrr rP enumeraterrrrrrr)r=rrrBcall_customizer default_typetokenslast_keytargetidxtokenrProbj_valpath_objexc_failedrQs r?r9r9?s2 G  (,w''hz&:&:!&%aHHH !&*{:_`?a?a?abbb%c400:44dL D ! !F ;v  xH(I&& < F F 3 344TT U eY ' ' +)C!gfsQw8I.JT`aaaOOC*O63555  =&wV<>> obj = {'a': [{'b': {'c': 7}}]} >>> unset(obj, 'a[0].b.c') True >>> obj {'a': [{'b': {}}]} >>> unset(obj, 'a[0].b.c') False FT) rrrrrr rPrrrrrrK)r=rrrrrrP did_unsets r?r7r7s6D ! !F ;v  xH(I&& < FV$$ eY ' ' )CCC  * * * *C) *   FFF  U?? E I U  ! 8$$$  ! ! ! 3x==)))  !    D  s`BB?B;8B?:B;;B??CC/DD<.D85D<7D88D<< E E c4dt|DS)a Creates a list composed of the values of `obj`. Args: obj (mixed): Object to extract values from. Returns: list: List of values. Example: >>> results = values({'a': 1, 'b': 2, 'c': 3}) >>> set(results) == set([1, 2, 3]) True >>> values([2, 4, 6, 8]) [2, 4, 6, 8] .. versionadded:: 1.0.0 .. versionchanged:: 1.1.0 Added ``values_in`` as alias. .. versionchanged:: 4.0.0 Removed alias ``values_in``. cg|]\}}|Srxrx)rWrqrQs r?rzvalues..s 0 0 0haE 0 0 0r@rrZs r?r:r:s4 1 0(3-- 0 0 00r@Fc|r tjn tj}d}t|r+|s)t|d}t t ||}n|r|}nd}|r ||||}||S|s ||}n|}|rit j|sUt|ts@t|D]0\}} |rt| |||d} n || ||} | | ||<1|S)zEBase clone function that supports deep clone and customizer callback.Nr rErGT)_cloned) rLrrJr rrrrrrr r]) rQrcrBrPr'clone_byrprHcbksubvaluerRs r?r]r]s: '6t}}TYH F Gz1555fj8<<<  (UC''  % "3=''" 5%0H0H"%e__ " "MC 0 7CdKKKc(C//!s Mr@rU)rr)T)r)NN)FNNF)C__doc__rL functoolsrrrpydashrhelpersrrrrr r r utilitiesr r r__all__rrrrrrrrrrrrrrrrrr r!r"r#r$r%r&rr'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r8r9r7r:r]rxr@r?r1s   [[[[[[[[[[[[[[[[[[9999999999- `'&'&'&T333lJJJ4:44440+++< B B B BB555B4:@3333l"#"#"#JB8888v&&&&R:::4   F''''T+++:RRRRjEEEP111D""""""r@