[c>P dZddlZddlZddlZddlZddlmZddlmZm Z m Z m Z m Z ddl Z iZed&iddgdd gd d d gd dgddddgddgddgdd'dgddddgddd d(d#gd$d%gd&d'gd(d)gd*d+gd,d-gd.d)d/gd0d1gd2d3d4gd5d6d7gd8d9gd:dd*d;fgdd?gd@dAdBdCgdDdd+dGfgdHdIgdJd,dLgdMdNdOgdPdQdRgdSdTdUgdVdWgdXdYgdZd[gd\d]gd^d_gd`dadbgdcd*dddd-dffgdgdhgdidjgdkdlgdmdndogdpdqgdrdsdtgdudvgdwd*dxdd-dyfgdzd{gd|dd}fgd~ddgddgddgddgdddgdd.dgddddgdddgdddgddgddgddgddd*dfgdddgddgddddgddgdddgdddgdddgdddgddgddd/dgdddgddddgddÄgdddƄdfgdd d.dɄfgee <dʄd˄d̄gee d<ee d΄gdτdЄd(dфgd d0d҄fgddӄdfddՄdfgddׄdfdd؄dfgd d1dڄfgddۄdfgd2dބgߦdddfgee d<eddfgdgdgddgee<ed&iddd3dfgddgdddfgdddfgdddfgdd4dgddgddgddgddd3dfgddgddgddgddddgddgd dd d fgd dd*d fgddd*dfgddgddgdddgdddd fgee<eedddfged&iddgddgd d!gd"d#gd$d%gd&d'gd(d)gd*d+gd,d-gd.d/gd0d1gd2d3gd4d5gd6d7gd8d9gd:d;gd<d=gd>d?gd@dAgdBdCgdDdEgdFdGgdHdIgdJdKgdLdMgdNdOgdPdQgdRdSgdTdUgdVdWgdXdYgdZd[gd\d]gd^d_gd`dagdbdcgdddegdfdggdhdigdjdkgdldmgdndogdpdqgdrdsgdtdugdvdwgdxdygdzd{gd|d}gd~dgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgdd„gdÐdĄgdŐdƄgdǐdȄgdɐdʄgdːd̄gd͐d΄gdϐdЄgdѐd҄gdӐdԄgdՐdքgdאd؄gdِdڄgdېd܄gdݐdބgdߐddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgdd gee<edd fgdd3d fgdd5d fgdd fgdd5dfged<eddfgd d6dfged<dZdZdZdZiZeefdZdZdZdZdZdZdZd Zd!Zd"Zd#Z d$Z!d%Z"dS(7aInternal module for better introspection of builtins. The main functions are ``is_builtin_valid_args``, ``is_builtin_partial_args``, and ``has_unknown_args``. Other functions in this module support these three. Notably, we create a ``signatures`` registry to enable introspection of builtin functions in any Python version. This includes builtins that have more than one valid signature. Currently, the registry includes builtins from ``builtins``, ``functools``, ``itertools``, and ``operator`` modules. More can be added as requested. We don't guarantee full coverage. Everything in this module should be regarded as implementation details. Users should try to not use this module directly. N) import_module)is_partial_argsis_arity has_varargs has_keywordsnum_required_argsabscdSNxs 1lib/python3.11/site-packages/toolz/_signatures.pyr-$allcdSr r iterables rrr/ranextcdSr r ) aiterators rrr1$rcdSr r )rdefaults rrr24ranycdSr r rs rrr4rrapplycdSr r objects rrr6trcdSr r )r%argss rrr7TrcdSr r )r%r(kwargss rrr8TrasciicdSr r objs rrr:DrbincdSr r numbers rrr<r&rboolFcdSr r rs rrr>rbuffercdSr r r$s rrr@r&rcdSr r )r%offsets rrrAtrcdSr r )r%r<sizes rrrBr,r bytearraycdSr r r rrrrDrcdSr r ints rrrEr1rutf8strictcdSr r stringencodingerrorss rrrFrcallablecdSr r r/s rrrHr1rchrcdSr r is rrrJrr classmethodcdSr r functions rrrLrrcmpcdSr r rys rrrNTrcoercecdSr r rZs rrrPr\rcomplexcdSr r )realimags rrrRr=rdelattrcdSr r r0names rrrTrrdictc dSr r )r+s rrrVrrc dSr r )mappingr+s rrrW$rdircdSr r r rrrrYrBrcdSr r r$s rrrZr&rdivmodcdSr r rZs rrr\r\r enumeratecdSr r rstarts rrr^drevalcdSr r sources rrr`r&rcdSr r ryglobalss rrrarcdSr r ryr|localss rrrbrexecfilecdSr r )filenames rrrdrrcdSr r )rr|s rrrerkrcdSr r )rr|rs rrrfs$rfilercdSr r )rfmode bufferings rrrhsrfiltercdSr r )rWrs rrrjrrfloatcdSr r rs rrrldrformatcdSr r )values rrrnrrcdSr r )r format_specs rrrorr frozensetcdSr r r rrrrqrBrcdSr r rs rrrrrrgetattrcdSr r )r%rfs rrrtr)rcdSr r )r%rfrs rrrururr|cdSr r r rrrrwrBrhasattrcdSr r res rrryrrhashcdSr r r/s rrr{r1rhexcdSr r r4s rrr}r&ridcdSr r r/s rrrr1rinputcdSr r r rrrrrBrcdSr r prompts rrrr&rrEcdSr r rs rrrr1r cdSr r rbases rrrr=rinterncdSr r )rJs rrrr&r isinstancecdSr r )r0class_or_tuples rrrDr issubclasscdSr r )clsrs rrrrritercdSr r rs rrrrrcdSr r )rNsentinels rrrrrlencdSr r r/s rrrr1rlistcdSr r r rrrrrBrcdSr r rs rrrrrrcdSr r r rrrrrBrlongcdSr r rs rrrr1rcdSr r rs rrrr=rmapcdSr r funcsequence iterabless rrr4r memoryviewcdSr r r$s rrr4rnextcdSr r )iterators rrrrrcdSr r )rrs rrrrkrr%cdSr r r rrrrrBroctcdSr r r4s rrrr&rordcdSr r )cs rrrrrpowcdSr r rZs rrrr\rcdSr r )rr[zs rrrr8rpropertycdSr r )fgetfsetfdeldocs rrrs$rrangecdSr r stops rrrr\rcdSr r rtrs rrrDrcdSr r rtrsteps rrrrkr raw_inputcdSr r r rrrrrBrcdSr r rs rrrr&rreducecdSr r rWrs rrrrrcdSr r rWrinitials rrrDrreloadcdSr r )modules rrrr&rreprcdSr r r/s rrrr1rreversedcdSr r )rs rrrrrroundcdSr r )r5ndigitss rrrrursetcdSr r r rrrrrBrcdSr r rs rrrrrsetattrcdSr r )r0rfrs rrrsrslicecdSr r rs rrrr\rcdSr r rs rrrrrcdSr r rs rrrrkr staticmethodcdSr r rVs rrrrrsumcdSr r rs rrrrrcdSr r rss rrrr}rsupercdSr r )types rrrr\rcdSr r )rr0s rrrrrtuplecdSr r r rrrrrBrcdSr r rs rrrrrrcdSr r r$s rrrr&rcdSr r )rfbasesrgs rrrrkrunichrcdSr r rRs rrrrrunicodecdSr r r$s rrrr&rcdSr r rIs rrrsDrvarscdSr r r rrrrrBrcdSr r r$s rrrr&rxrangecdSr r rs rrrr\rcdSr r rs rrrrrcdSr r rs rrrrkrzipcdSr r rs rrrrr__build_class__cdSr r )rrfrkwdss rrrstr) metaclass __import__cdSr r )rfr|rfromlistlevels rrrs rcdSr r rxs rrrs4rcdSr r r{s rrrrrcdSr r rs rrrrrexeccdSr r )r(kwss rrrr)rcdSr r r rrrrrBrcdSr r rDs rrrr1rcdSr r rIs rrrrMrcdSr r )ryrrflags dont_inheritoptimizes rrrs -1rcdSr r rs rrrr)r)rkeycdSr r arg1arg2r(s rrrrur)rBcdSr r rs rrrr)rcdSr r rDs rrrrurTcdSr r )rrrrKrLnewlineclosefdopeners rrrs BFrcdSr r rs rrrr)r)rBreverseutfcdSr r )r%rKrLs rrrs4r) breakpointbytescompilemaxminopensortedstrcdSr r )r(s rrrrr)sependrflushprintcdSr r )mycmps rrr rrcdSr r rr(r+s rrr rurcdSr r ras rrrrurcdSr r rs rrrrrcdSr r rs rrrrr) cmp_to_keypartial partialmethodr accumulatecdSr r )rrs rrrrrchaincdSr r r*s rrrrr combinationscdSr r rrs rrrr}rcombinations_with_replacementcdSr r rns rrrr}rcompresscdSr r )data selectorss rrrrrcountcdSr r )rtrs rrr!r}rcyclecdSr r rs rrr#rr dropwhilecdSr r  predicaters rrr%rr filterfalsecdSr r rs rrr'rrgroupbycdSr r )rrBs rrr)strifiltercdSr r rs rrr+rr ifilterfalsecdSr r rs rrr-rrimapcdSr r rs rrr/rrislicecdSr r )rrs rrr1r=rcdSr r )rrtrs rrr2rurcdSr r )rrtrrs rrr3rrizipcdSr r r*s rrr5rr izip_longestcdSr r r*s rrr7r=r) fillvalue permutationscdSr r rns rrr9rkrrepeatcdSr r )r%timess rrr;rrstarmapcdSr r rs rrr=rr takewhilecdSr r r{s rrr?rrteecdSr r rs rrrArrcdSr r )rns rrrBrr zip_longestcdSr r r*s rrrDr=rcdSr r r*s rrrIr=r)r)product__abs__cdSr r as rrrOrr__add__cdSr r rbs rrrQr\r__and__cdSr r rs rrrSr\r __concat__cdSr r rs rrrUr\r __contains__cdSr r rs rrrWr\r __delitem__cdSr r rs rrrYr\r __delslice__cdSr r rrrs rrr[r8r__div__cdSr r rs rrr]r\r__eq__cdSr r rs rrr_r\r __floordiv__cdSr r rs rrrar\r__ge__cdSr r rs rrrcr\r __getitem__cdSr r rs rrrer\r __getslice__cdSr r rs rrrgr8r__gt__cdSr r rs rrrir\r__iadd__cdSr r rs rrrkr\r__iand__cdSr r rs rrrmr\r __iconcat__cdSr r rs rrror\r__idiv__cdSr r rs rrrqr\r __ifloordiv__cdSr r rs rrrsr\r __ilshift__cdSr r rs rrrur\r __imatmul__cdSr r rs rrrwr\r__imod__cdSr r rs rrryr\r__imul__cdSr r rs rrr{r\r __index__cdSr r rs rrr}rr__inv__cdSr r rs rrrrr __invert__cdSr r rs rrrrr__ior__cdSr r rs rrrr\r__ipow__cdSr r rs rrrr\r __irepeat__cdSr r rs rrrr\r __irshift__cdSr r rs rrrr\r__isub__cdSr r rs rrrr\r __itruediv__cdSr r rs rrrr\r__ixor__cdSr r rs rrrr\r__le__cdSr r rs rrrr\r __lshift__cdSr r rs rrrr\r__lt__cdSr r rs rrrr\r __matmul__cdSr r rs rrrr\r__mod__cdSr r rs rrrr\r__mul__cdSr r rs rrrr\r__ne__cdSr r rs rrrr\r__neg__cdSr r rs rrrrr__not__cdSr r rs rrrrr__or__cdSr r rs rrrr\r__pos__cdSr r rs rrrrr__pow__cdSr r rs rrrr\r __repeat__cdSr r rs rrrr\r __rshift__cdSr r rs rrrr\r __setitem__cdSr r rs rrrr8r __setslice__cdSr r rrrds rrrrr__sub__cdSr r rs rrrr\r __truediv__cdSr r rs rrrr\r__xor__cdSr r rs rrrr\r_abscdSr r rs rrrrr_compare_digestcdSr r rs rrrr\rcdSr r rs rrrrraddcdSr r rs rrrr\rand_cdSr r rs rrrr\r attrgettercdSr r )attrr(s rrrrrconcatcdSr r rs rrrr\rcontainscdSr r rs rrrr\rcountOfcdSr r rs rrrr\rdelitemcdSr r rs rrrr\rdelslicecdSr r rs rrrr8rdivcdSr r rs rrrr\reqcdSr r rs rrrr\rfloordivcdSr r rs rrrr\rgecdSr r rs rrrr\rgetitemcdSr r rs rrrr\rgetslicecdSr r rs rrrr8rgtcdSr r rs rrrr\riaddcdSr r rs rrrr\riandcdSr r rs rrrr\riconcatcdSr r rs rrrr\ridivcdSr r rs rrrr\r ifloordivcdSr r rs rrrr\rilshiftcdSr r rs rrrr\rimatmulcdSr r rs rrrr\rimodcdSr r rs rrrr\rimulcdSr r rs rrrr\rindexcdSr r rs rrrrrindexOfcdSr r rs rrrr\rinvcdSr r rs rrrrrinvertcdSr r rs rrrrriorcdSr r rs rrrr\ripowcdSr r rs rrrr\rirepeatcdSr r rs rrrr\rirshiftcdSr r rs rrrr\ris_cdSr r rs rrrr\ris_notcdSr r rs rrrr\r isCallablecdSr r rs rrrrr isMappingTypecdSr r rs rrrrr isNumberTypecdSr r rs rrrrrisSequenceTypecdSr r rs rrrrrisubcdSr r rs rrr r\r itemgettercdSr r )itemr(s rrr rritruedivcdSr r rs rrr r\rixorcdSr r rs rrrr\rlecdSr r rs rrrr\r length_hintcdSr r r/s rrrr1rcdSr r )r0rs rrrr)rlshiftcdSr r rs rrrr\rltcdSr r rs rrrr\rmatmulcdSr r rs rrrr\r methodcallercdSr r )rfr(r+s rrrrurmodcdSr r rs rrrr\rmulcdSr r rs rrr r\rnecdSr r rs rrr"r\rnegcdSr r rs rrr$rrnot_cdSr r rs rrr&rror_cdSr r rs rrr(r\rposcdSr r rs rrr*rrcdSr r rs rrr,r\rcdSr r rs rrr.r\rrshiftcdSr r rs rrr0r\rsequenceIncludescdSr r rs rrr2r\rsetitemcdSr r rs rrr4r8rsetslicecdSr r rs rrr6rrsubcdSr r rs rrr8r\rtruedivcdSr r rs rrr:r\rtruthcdSr r rs rrr<rrxorcdSr r rs rrr>r\rcdSr r )r(r+s rrrCrrcdSr r )excrhandlers rrrErrcdSr r )rrrs rrrGsdrcdSr r funcss rrrIrrcdSr r )rcacherBs rrrKsDr)curryexceptsflipjuxtmemoizetoolzcdSr r rs rrrPrrcdSr r )rrrrclassvals rrrRs r)ComposeInstancePropertyztoolz.functoolzcbtd|jDS)z@ Return the number of positional arguments. ``f(x, y=1)`` has 1c3VK|]$}|j|jk|j|ju dV%dS)rN)kindPOSITIONAL_OR_KEYWORDrempty.0rs r znum_pos_args..YsU))Q&A33)9')q))))))r)r parametersvalues)sigspecs r num_pos_argsrWs> ))',3355))) ) ))rc|dkrdStd|jD}|sdSt|jd|}t d|DS)zA Return the names of position-only arguments if func has **kwargsrr c36K|]}|j|jkVdSr )r VAR_KEYWORDrs rrz'get_exclude_keywords..bs?;;Vq},;;;;;;rNc3$K|] }|jV dSr )rfrs rrz'get_exclude_keywords..gs$**A******r)r rrrr) num_pos_onlyr has_kwargspos_argss rget_exclude_keywordsr^sqr;;%07799;;;;;J rG&--//00,?H ***** * **rc\ tj|S#ttf$rYdSwxYwr )inspect signature ValueError TypeError)rs rsignature_or_specrjs? &&&  "tts ++c>t|trNt|dkr$|\}}}t|dtsJn|\}}d}t|}n"|}t|}t |}d}t ||}||||z|fS)a Convert the signature spec in ``module_info`` to add to ``signatures`` The input signature spec is one of: - ``lambda_func`` - ``(num_position_args, lambda_func)`` - ``(num_position_args, lambda_func, keyword_only_args)`` The output signature spec is: ``(num_position_args, lambda_func, keyword_exclude, sigspec)`` where ``keyword_exclude`` includes keyword only arguments and, if variadic keywords is present, the names of position-only argument. The latter is included to support builtins such as ``partial(func, *args, **kwargs)``, which allows ``func=`` to be used as a keyword even though it's the name of a positional argument. rr )rrrrrr)sigrr keyword_onlyrkeyword_excludes r expand_sigrqs"#u  s88q= /2 ,L$ c"gu-- - - - -!$ L$L#D))#D))#G,,  *<AAO |o=w FFrc.|D]\}}t|trt|}|D]A\}}t ||r,t d|D}||t ||<BdS)Nc34K|]}t|VdSr )rrrs rrz,create_signature_registry..s( A ASC A A A A A Ar)itemsrrXrrrr) module_info signaturesrinforfsigsnew_sigss rcreate_signature_registryrs#))++==  fc " " +"6**F**,, = =JD$vt$$ = A AD A A AAA4< 764001 ===rc|\}}}}t||krdS|r*t|}|D]}||d ||i|dS#t$rYdSwxYw)z4 Like ``is_valid_args`` for the given signature specFNT)rrgpopr)rr(r+rrrrrfs r check_validrs360L$ 4yy<u#f# # #D JJtT " " " " dft uus A A"!A"cn|tvrdSt|}tfd|DS)zC Like ``is_valid_args`` for builtins in our ``signatures`` registryNc3:K|]}t|VdSr )rrrr(r+s rrz!_is_valid_args..s/>>#{3f-->>>>>>rrr rr(r+rs `` r_is_valid_argsrsF :t d D >>>>>>>> > >>rc|\}}}}t||krd|t|z z}||z}|r*t|}|D]}||dt||||S)z6 Like ``is_partial_args`` for the given signature specr N)rrgrr) rr(r+rrrrpadrfs r check_partialrs360L$ 4yy<D 12cz#f# # #D JJtT " " " " 4vw 7 77rcn|tvrdSt|}tfd|DS)zE Like ``is_partial_args`` for builtins in our ``signatures`` registryNc3:K|]}t|VdSr )rrs rrz#_is_partial_args..s/@@C}S$//@@@@@@rrrs `` r_is_partial_argsrsF :t d D @@@@@4@@@ @ @@rcF|\}}}}|s||krdSt|||S)NF)r)rrrrrrs r check_arityrs;360L$,*u AtW % %%rc|tvrdSt|}fd|D}t|rdSt|rdSdS)Nc0g|]}t|Sr )r)rrrs r z_is_arity..s# 2 2 2ck!S!! 2 2 2rTFrrr )rrrcheckss` r _is_arityrsc :t d D 2 2 2 2T 2 2 2F 6{{t Vt 5rc0|\}}}}t||Sr )rrrrrrs r check_varargsrs 360L$ tW % %%rc|tvrdSt|}d|D}t|rdSt|rdSdS)Nc,g|]}t|Sr )rrs rrz _has_varargs..s 1 1 1SmC  1 1 1rTFrrrrs r _has_varargsrs\ :t d D 1 1D 1 1 1F 6{{t Vt 5rc8|\}}}}|rdSt||S)NT)rrs rcheck_keywordsrs-360L$t g & &&rc|tvrdSt|}d|D}t|rdSt|rdSdS)Nc,g|]}t|Sr )rrs rrz!_has_keywords..s 2 2 2cnS!! 2 2 2rTFrrs r _has_keywordsrs\ :t d D 2 2T 2 2 2F 6{{t Vt 5rc0|\}}}}t||Sr )r rs rcheck_required_argsrs 360L$ T7 + ++rc|tvrdSt|}d|D}|dtfd|DrSdS)Nc,g|]}t|Sr )rrs rrz&_num_required_args.. s! 5 5 5  $ $ 5 5 5rrc3$K|] }|kV dSr r )rrvals rrz%_num_required_args..s' " "18 " " " " " "r)rr)rrvalsrs @r_num_required_argsr sj :t d D 5 5 5 5 5D q'C " " " "T " " """ 4rr )F)rFrG)rr)r)rr)r)r)NNNN)rrFrG)rFr)rrNNNTN)rrOrGr )rr)NNN)NNNNN)#__doc__ functoolsr itertoolsoperator importlibr functoolzrrrrr builtinsrrgupdaterrrrrrrrrrrrrrrrrrr rrr s  ######99999999999999" |||  |   | '' ) ) |   | !!)) + +|   |"   !|&   %|* ##)) + +)|2  ===??1|: 9|>   =|B A|F   E|J   I|N $## % %M|R   Q|V && ( (U|\    [|b   a|f * * *+--e|j $$,, . .i|r &&..00q|z 5 5 56 8 8y|~ (' ) )}|B   A|F '' ) )E|L  K|R "!** , ,Q|X    W|\   [|`   _|d   c|h g|l    k|r  # # #$ & &q|x   w|| )(**{|@ )(**|D '' ) )C|J   I|N    M|T    S|X  # # #$ & &W|^ 0/ 1 1]|b   ""a|f && ( (e|l    k|p   o|t   s|x   w|~ ?>>@@}|B   && ( (A|J  I|P ('00 2 2O|V   U|Z   Y|^ ]|b * * *+ - -a|f    e|l &% ' 'k|p   && ( (o|x w|| $$ & &{|B   A|H    G|N && ( (M|T   S|X @@@ B BW|^    ]|d   && ( (c|l  ! !k|p 3 3^DFFo|t     s| H|  ((!* Hf  H!!#  === ? )+ 2 2 2 3 4 ! !#67 * *H5 7 ! !#67 * *H5 7 <@ G G G H I ! !#56 8 @?? A+2<="? Hg  ! +* , +*, ('00 2    I000 , , ,-//0  ! !0 $ $%'' 0 $ $%#'#'0 ( ()++0 %$$ & &0   0 )(**0$ ('))#0( + + +, . .'0, (' ) )+00 ('))/04 0/ 1 1308 $#**00 2 270@  ! !?0D # #^466C0H & & &'))G0L ( ( () + +K0P (' ) )O0T )(**S0X    " "W0^ # #^466]0 Id I # #[1 3 rrr  r   r    r r r r r   r$   #r( 'r,   +r0 /r4 3r8   7r< ;r@ ?rD CrH GrL KrP OrT SrX Wr\ [r` _rd   crh grl   krp ort srx wr| {r@ rD CrH   GrL KrP   OrT SrX   Wr\   [r`   _rd   crh   grl   krp   ort   srx wr| {r@ rD !!CrH   GrL KrP   OrT   SrX Wr\   [r`   _rd   crh ! ""grl   krp ort   srx   wr| {r@   rD CrH GrL KrP   OrT SrX Wr\   [r`   _rd   crh   grl krp   ort   srx   wr|   {r@   rD   CrH   GrL   KrP   OrT   SrX   Wr\   [r`   _rd   crh grl krp ort srx   wr| ! ""{r@ rD   CrH GrL !!##KrR   QrV UrZ   Yr^ +*,,]rb   arf   erj irn   mrr   qrv   urz   yr~   }rB   ArF   ErJ IrN   MrR !!QrV   UrZ   Yr^   ]rb   ar Hht ( () + 0 0 01 3 2 2 23 5    " 8 8 89 ;    G"&   !     !"""" ))) + + +GGGD +6*====    ??? 8 8 8AAA&&&   &&&   '''   ,,, r