U ꥡc>Pz@s dZddlZddlZddlZddlZddlmZddlmZm Z m Z m Z m Z ddl Z iZeddgddgd dd dgd dgd dd dddgddgddgdfddgddddddgdddddgddgddgddgddgddgddgdhd dgd!dgd"dd#dgd$dd%dgd&dgddid'dfgd(dd)dd*dgd+dd,dd-dgddjd0dfgd1dgdkd3dgd4dd5dgd6dd7dgd8dd9dgd:dgd;dgddgd?dd@dgdldAdddmdCdfgdDdgdEdgdFdgdGddHdgdIdgdJddKdgdLdgdndMdddodNdfgdOdgddPdfgdQddRdgdSdgdTdgdUdgdVddWdgdpdXdgdYddZdd[dgd\dd]dgd^dd_dgd`dgdadgdbdgddqdcdfgddddedgdfdgdgddhddidgdjdgdkddldgdmddndgdoddpdgdqddrdgdsdgdtddrdvdgdwddxdgdyddzdd{dgd|dgd}d~ddfgddsddfgdJee <ddddddgee d<ee jddgdddddtddgdduddfgddddfddddfgddddfddddfgddvddfgddddfgdwddgdddddfgee d<edddfgddgddgddddgdee<eddxddfgddgdddfgdddfgdddfgdyddgddgddgddgddzddfgddgddgddgddddddgddgddddfgdd{ddfgdd|ddfgddgddgddddgddddfgdee<eejddddfgdeddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgd dgd dgd dgd dgd dgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgddgd dgd!dd"dgd#dgd$dgd%dgd&dgd'dgd(dgd)dgd*dgd+dgd,dgd-dgd.dgd/dgd0dgd1dgd2dgd3dgd4dgd5dgd6dgd7dgd8xee<edd9dfgdd}d:dfgdd~d;dfgdded?<edd@dfgdddAdfgdBedC<dDdEZdFdGZdHdIZdJdKZiZeefdLdMZdNdOZdPdQZdRdSZdTdUZdVdWZdXdYZdZd[Zd\d]Zd^d_Zd`daZ dbdcZ!dddeZ"dS(aInternal 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_argscCsdSNxr r 5/tmp/pip-unpacked-wheel-n0vm8il5/toolz/_signatures.py-rcCsdSr r iterabler r r r/rcCsdSr r ) aiteratorr r r r1rcCsdSr r )rdefaultr r r r2rcCsdSr r rr r r r4rcCsdSr r objectr r r r6rcCsdSr r )rargsr r r r7rcCsdSr r )rrkwargsr r r r8rcCsdSr r objr r r r:rcCsdSr r numberr r r r<rFcCsdSr r r r r r r>rcCsdSr r rr r r r@rcCsdSr r )roffsetr r r rArcCsdSr r )rrsizer r r rBrcCsdSr r r r r r rDrcCsdSr r intr r r rErutf8strictcCsdSr r stringencodingerrorsr r r rFrcCsdSr r rr r r rHrcCsdSr r ir r r rJrcCsdSr r functionr r r rLrcCsdSr r r yr r r rNrcCsdSr r r*r r r rPrcCsdSr r )realimagr r r rRrcCsdSr r rnamer r r rTrcKsdSr r )rr r r rVrcKsdSr r )mappingrr r r rWrcCsdSr r r r r r rYrcCsdSr r rr r r rZrcCsdSr r r*r r r r\rcCsdSr r rstartr r r r^rcCsdSr r sourcer r r r`rcCsdSr r r4globalsr r r rarcCsdSr r r4r6localsr r r rbrcCsdSr r )filenamer r r rdrcCsdSr r )r9r6r r r rercCsdSr r )r9r6r8r r r rfrrcCsdSr r )r/mode bufferingr r r rhrcCsdSr r )r)rr r r rjrcCsdSr r r r r r rlrcCsdSr r )valuer r r rnrcCsdSr r )r? format_specr r r rorcCsdSr r r r r r rqrcCsdSr r rr r r rrrcCsdSr r )rr/r r r rtrcCsdSr r )rr/rr r r rurcCsdSr r r r r r rwrcCsdSr r r.r r r ryrcCsdSr r rr r r r{rcCsdSr r rr r r r}rcCsdSr r rr r r rrcCsdSr r r r r r rrcCsdSr r promptr r r rrcCsdSr r r r r r rr cCsdSr r r baser r r rrcCsdSr r )r#r r r rrcCsdSr r )rclass_or_tupler r r rrcCsdSr r )clsrFr r r rrcCsdSr r rr r r rrcCsdSr r )callablesentinelr r r rrcCsdSr r rr r r rrcCsdSr r r r r r rrcCsdSr r rr r r rrcCsdSr r r r r r rrcCsdSr r r r r r rrcCsdSr r rDr r r rrcGsdSr r funcsequence iterablesr r r rrcCsdSr r rr r r rrcCsdSr r )iteratorr r r rrcCsdSr r )rNrr r r rrcCsdSr r r r r r rrcCsdSr r rr r r rrcCsdSr r )cr r r rrcCsdSr r r*r r r rrcCsdSr r )r r+zr r r rrcCsdSr r )fgetfsetfdeldocr r r rrcCsdSr r stopr r r rrcCsdSr r r2rVr r r rrcCsdSr r r2rVstepr r r rrcCsdSr r r r r r rrcCsdSr r rAr r r rrcCsdSr r r)rLr r r rrcCsdSr r r)rLinitialr r r rrcCsdSr r )moduler r r rrcCsdSr r rr r r rrcCsdSr r )rLr r r rrcCsdSr r )rndigitsr r r rrcCsdSr r r r r r rrcCsdSr r rr r r rrcCsdSr r )rr/r?r r r rrcCsdSr r rUr r r rrcCsdSr r rWr r r rrcCsdSr r rXr r r rrcCsdSr r r(r r r rrcCsdSr r rr r r rrcCsdSr r r1r r r rrcCsdSr r )typer r r rrcCsdSr r )r_rr r r rrcCsdSr r r r r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r )r/basesdictr r r rrcCsdSr r r&r r r rrcCsdSr r rr r r rrcCsdSr r r"r r r rrcCsdSr r r r r r rrcCsdSr r rr r r rrcCsdSr r rUr r r rrcCsdSr r rWr r r rrcCsdSr r rXr r r rrcGsdSr r rMr r r rrcOsdSr r )rKr/r`kwdsr r r rr) metaclasscCsdSr r )r/r6r8fromlistlevelr r r rs)JabsallZanextanyapplyasciibinboolbuffer bytearrayrHchr classmethodcmpZcoercecomplexdelattrradirdivmod enumerateevalZexecfilefilefilterfloatformat frozensetgetattrr6hasattrhashhexidinputrintern isinstance issubclassiterlenlistr8longmap memoryviewnextroctordpowpropertyrange raw_inputreducereloadreprreversedroundsetsetattrslice staticmethodsumsupertupler_unichrunicodevarsxrangezip__build_class__ __import__cCsdSr r r3r r r rrcCsdSr r r5r r r rrcCsdSr r r7r r r rrexeccOsdSr r )rkwsr r r rrcCsdSr r r r r r rrcCsdSr r rr r r rrcCsdSr r r"r r r rrcCsdSr r )r4r9r<flags dont_inheritoptimizer r r rscCsdSr r rr r r rr)rkeycGsdSr r Zarg1Zarg2rr r r rr)rcCsdSr r rr r r rrcGsdSr r rr r r rrTcCsdSr r )r{r<r=r$r%newlineclosefdopenerr r r rscCsdSr r rr r r rr)rreverseutfcCsdSr r )rr$r%r r r rr) breakpointbytescompilemaxminopensortedstrcGsdSr r )rr r r rr)sependr{flushprintcCsdSr r )Zmycmpr r r r rcOsdSr r rKrrr r r r rcOsdSr r rr r r rrcCsdSr r rZr r r rrcCsdSr r r[r r r rr) cmp_to_keypartial partialmethodrcCsdSr r )rrKr r r rrcGsdSr r rcr r r rrcCsdSr r rr:r r r rrcCsdSr r rr r r rrcCsdSr r )data selectorsr r r rrcCsdSr r )r2rYr r r r!rcCsdSr r rr r r r#rcCsdSr r  predicaterr r r r%rcCsdSr r rZr r r r'rcCsdSr r )rrr r r r)rcCsdSr r rZr r r r+rcCsdSr r rZr r r r-rcGsdSr r rJr r r r/rcCsdSr r )rrVr r r r1rcCsdSr r )rr2rVr r r r2rcCsdSr r )rr2rVrYr r r r3rcGsdSr r rcr r r r5rcGsdSr r rcr r r r7r) fillvaluecCsdSr r rr r r r9rcCsdSr r )rtimesr r r r;rcCsdSr r rZr r r r=rcCsdSr r rr r r r?rcCsdSr r rr r r rArcCsdSr r )rnr r r rBrcGsdSr r rcr r r rDr) accumulatechain combinationscombinations_with_replacementcompresscountcycle dropwhile filterfalsegroupbyifilter ifilterfalseimapisliceizip izip_longest permutationsrepeatstarmap takewhiletee zip_longestcGsdSr r rcr r r rIr)r)productcCsdSr r ar r r rOrcCsdSr r rbr r r rQrcCsdSr r rr r r rSrcCsdSr r rr r r rUrcCsdSr r rr r r rWrcCsdSr r rr r r rYrcCsdSr r rrrOr r r r[rcCsdSr r rr r r r]rcCsdSr r rr r r r_rcCsdSr r rr r r rarcCsdSr r rr r r rcrcCsdSr r rr r r rercCsdSr r rr r r rgrcCsdSr r rr r r rircCsdSr r rr r r rkrcCsdSr r rr r r rmrcCsdSr r rr r r rorcCsdSr r rr r r rqrcCsdSr r rr r r rsrcCsdSr r rr r r rurcCsdSr r rr r r rwrcCsdSr r rr r r ryrcCsdSr r rr r r r{rcCsdSr r rr r r r}rcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rrrOdr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r r r r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcGsdSr r )attrrr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r r rcGsdSr r )itemrr r r r rcCsdSr r rr r r r rcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r )rrr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcCsdSr r rr r r rrcOsdSr r )r/rrr r r rrcCsdSr r rr r r rrcCsdSr r rr r r r rcCsdSr r rr r r r"rcCsdSr r rr r r r$rcCsdSr r rr r r r&rcCsdSr r rr r r r(rcCsdSr r rr r r r*rcCsdSr r rr r r r,rcCsdSr r rr r r r.rcCsdSr r rr r r r0rcCsdSr r rr r r r2rcCsdSr r rr r r r4rcCsdSr r rr r r r6rcCsdSr r rr r r r8rcCsdSr r rr r r r:rcCsdSr r rr r r r<rcCsdSr r rr r r r>r)x__abs____add____and__ __concat__ __contains__ __delitem__Z __delslice__Z__div____eq__ __floordiv____ge__ __getitem__Z __getslice____gt____iadd____iand__ __iconcat__Z__idiv__ __ifloordiv__ __ilshift__ __imatmul____imod____imul__ __index____inv__ __invert____ior____ipow__Z __irepeat__ __irshift____isub__ __itruediv____ixor____le__ __lshift____lt__ __matmul____mod____mul____ne____neg____not____or____pos____pow__Z __repeat__ __rshift__ __setitem__Z __setslice____sub__ __truediv____xor___abs_compare_digestriaddand_ attrgetterconcatcontainscountOfdelitemZdelslicediveqfloordivgegetitemZgetslicegtiaddiandiconcatZidiv ifloordivilshiftimatmulimodimulindexindexOfinvinvertioripowZirepeatirshiftis_is_notZ isCallableZ isMappingTypeZ isNumberTypeZisSequenceTypeisub itemgetteritruedivixorle length_hintlshiftltmatmul methodcallermodmulnenegnot_or_posrrrshiftZsequenceIncludessetitemZsetslicesubtruedivtruthxorcOsdSr r rrr r r rCrcCsdSr r )excrKhandlerr r r rErcCsdSr r )rKrrr r r rGrcGsdSr r funcsr r r rIrcCsdSr r )rKcacherr r r rKr)ZcurryZexceptsZflipZjuxtmemoizeZtoolzcCsdSr r rTr r r rPrcCsdSr r )rQrRrSrTZclassvalr r r rRs)ZComposeZInstancePropertyztoolz.functoolzcCstdd|jDS)z@ Return the number of positional arguments. ``f(x, y=1)`` has 1css*|]"}|j|jkr|j|jkrdVqdS)rN)kindPOSITIONAL_OR_KEYWORDrempty.0r r r r Ys  znum_pos_args..)r parametersvalues)sigspecr r r num_pos_argsWsracCsT|dkr dStdd|jD}|s,dSt|jd|}tdd|DS)zA Return the names of position-only arguments if func has **kwargsrr css|]}|j|jkVqdSr )rX VAR_KEYWORDr[r r r r]bsz'get_exclude_keywords..Ncss|] }|jVqdSr )r/r[r r r r]gs)rkr^r_rr) num_pos_onlyr`Z has_kwargsZpos_argsr r r get_exclude_keywords^srdc Cs,z t|WSttfk r&YdSXdSr )inspect signature ValueError TypeError)rKr r r signature_or_specjs ricCs|t|trJt|dkr4|\}}}t|dts@tn |\}}d}t|}n|}t|}t|}d}t||}|||||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. r;r )rrrAssertionErrorrirard)sigrcrK keyword_onlyr`keyword_excluder r r expand_sigqs     rocCsd|D]V\}}t|tr"t|}|D]2\}}t||r*tdd|D}||t||<q*qdS)Ncss|]}t|VqdSr )ror\rlr r r r]sz,create_signature_registry..)itemsrrrrrr) module_info signaturesr]infor/sigsZnew_sigsr r r create_signature_registrys  rvcCsj|\}}}}t||krdS|r>t|}|D]}||dq,z|||WdStk rdYdSXdS)z4 Like ``is_valid_args`` for the given signature specFNT)rrapoprh)rlrrrcrKrnr`rr r r check_valids   rxcs,|tkr dSt|}tfdd|DS)zC Like ``is_valid_args`` for builtins in our ``signatures`` registryNc3s|]}t|VqdSr )rxrprQr r r]sz!_is_valid_args..rsrkrKrrrur rQr _is_valid_argssr{c Cs`|\}}}}t||kr0d|t|}||}|rRt|}|D]}||dq@t||||S)z6 Like ``is_partial_args`` for the given signature specr N)rrarwr) rlrrrcrKrnr`padrr r r check_partials  r}cs,|tkr dSt|}tfdd|DS)zE Like ``is_partial_args`` for builtins in our ``signatures`` registryNc3s|]}t|VqdSr )r}rprQr r r]sz#_is_partial_args..ryrzr rQr _is_partial_argssr~cCs(|\}}}}|s||krdSt|||S)NF)r)rrlrcrKrnr`r r r check_aritys  rcsB|tkr dSt|}fdd|D}t|r2dSt|r>dSdS)Ncsg|]}t|qSr )rrprr r sz_is_arity..TFrsrjrk)rrKruchecksr rr _is_aritysrcCs|\}}}}t||Sr )rrlrcrKrnr`r r r check_varargss rcCs>|tkr dSt|}dd|D}t|r.dSt|r:dSdS)NcSsg|] }t|qSr )rrpr r r rsz _has_varargs..TFrrKrurr r r _has_varargssrcCs|\}}}}|rdSt||S)NT)rrr r r check_keywordss rcCs>|tkr dSt|}dd|D}t|r.dSt|r:dSdS)NcSsg|] }t|qSr )rrpr r r rsz!_has_keywords..TFrrr r r _has_keywordssrcCs|\}}}}t||Sr )rrr r r check_required_argss rcsH|tkr dSt|}dd|D}|dtfdd|DrDSdS)NcSsg|] }t|qSr )rrpr r r r sz&_num_required_args..rc3s|]}|kVqdSr r r[valr r r]sz%_num_required_args..)rsrj)rKruvalsr rr _num_required_args sr)F)r r!)rr)r)r:r;)r>)r)rC)r)rC)NNNN)r)rbr r!)NNNN)r r!)rFr;)r:r;NNNTN)rbrr!)N)rr)N)r)r)N)NNN)NNN)NNNNN)#__doc__ functoolsre itertoolsoperator importlibrZ functoolzrrrrrbuiltinsrrraupdaterardrirorsrvrxr{r}r~rrrrrrrrr r r r s             ?                    2  u        "