U d/e@sdZddlZddlZddlZddlZddlZddlZddlZddlZddddddgZ e e Z ej eejd d dZd d ejejefedd ddZddZejejejefejdddZejdddddZejejejedfejejdddZejejedfejejdddZddejejedfejejedfejdddZeddeejeedddZdS)z3Generic re-useable self-contained helper functions.Nattachmkdirs mapping_itemspromote_pathlikepromote_pathlike_directorydeprecate_positional_args)objectnamereturncsfdd}|S)aReturn a decorator doing ``setattr(object, name)`` with its argument. >>> spam = type('Spam', (object,), {})() # doctest: +NO_EXE >>> @attach(spam, 'eggs') ... def func(): ... pass >>> spam.eggs # doctest: +ELLIPSIS cst||S)N)setattrfuncr r3/tmp/pip-unpacked-wheel-n8ok7rre/graphviz/_tools.py decorator#s zattach..decoratorr)rr rrrrrs i)mode)filenamerr cCs4tj|}|sdStd|tj||dddS)zPRecursively create directories up to the path of ``filename`` as needed.Nzos.makedirs(%r)T)rexist_ok)ospathdirnamelogdebugmakedirs)rrrrrrr*s   cCs(t|}t|tkr$tt|}|S)ayReturn an iterator over the ``mapping`` items, sort if it's a plain dict. >>> list(mapping_items({'spam': 0, 'ham': 1, 'eggs': 2})) # doctest: +NO_EXE [('eggs', 2), ('ham', 1), ('spam', 0)] >>> from collections import OrderedDict >>> list(mapping_items(OrderedDict(enumerate(['spam', 'ham', 'eggs'])))) [(0, 'spam'), (1, 'ham'), (2, 'eggs')] )iteritemstypedictsorted)mappingresultrrrr4s   )filepathr cCsdS)z(Return path object for path-like-object.Nrr"rrrrEscCsdS)zReturn None for None.Nrr#rrrrJscCsdS)z9Return path object or ``None`` depending on ``filepath``.Nrr#rrrrOscCs|dk rt|SdS)zReturn path-like object ``filepath`` promoted into a path object. See also: https://docs.python.org/3/glossary.html#term-path-like-object N)pathlibPathr#rrrrUs)default) directoryr&r cCst|dk r|n|ptjS)zReturn path-like object ``directory`` promoted into a path object (default to ``os.curdir``). See also: https://docs.python.org/3/glossary.html#term-path-like-object N)r$r%rcurdir)r'r&rrrr_s)category stacklevel)supported_numberr*r+csTdkstddkr*dd}|Stts8td7fdd}|S) aMark supported_number of positional arguments as the maximum. Args: supported_number: Number of positional arguments for which no warning is raised. category: Type of Warning to raise or None to return a nulldecorator returning the undecorated function. stacklevel: See :func:`warning.warn`. Returns: Return a decorator raising a category warning on more than supported_number positional args. See also: https://docs.python.org/3/library/exceptions.html#FutureWarning https://docs.python.org/3/library/exceptions.html#DeprecationWarning https://docs.python.org/3/library/exceptions.html#PendingDeprecationWarning rzsupported_number at least one: NcSs|S)z Return the undecorated function.rr rrr nulldecoratorsz0deprecate_positional_args..nulldecoratorr)cs\t}dd|jDtdjjdt fdd}|S)NcSs"g|]\}}|jtjjkr|qSr)kindinspect ParameterPOSITIONAL_OR_KEYWORD).0r paramrrr sz@deprecate_positional_args..decorator..z$deprecate positional args: %s.%s(%r)c st|krt|}t|}t|}t|}|s:tjd}|d\}}}t rb|rbtd dd| D}t j djddt|d |d d ||S) N_Z_legacyz, css |]\}}|d|VqdS)=Nr)r2r valuerrr szPdeprecate_positional_args..decorator..wrapper..zThe signature of z will be reduced to z positional args z: pass z as keyword arg(s))r+r*)lenzip itertoolsislicerAssertionError__name__lstrip partitionsetjoinrwarningswarnlist) argskwargsZ call_args supported deprecated func_nameseprestwanted)argnamesr*r r+r,rrwrappers"      &z=deprecate_positional_args..decorator..wrapper) r/ signature parametersrrr __module__ __qualname__ functoolswraps)r rPrOr*r+r,)rNr rrs  z,deprecate_positional_args..decorator)r= issubclassWarning)r,r*r+r-rrrVrrks )__doc__rTr/r;loggingrr$typingrC__all__ getLoggerr>rAnystrCallablerUnionPathLikeintrroverloadr%rOptionalrPendingDeprecationWarningTyperXrrrrrsT $