o wi @sdZddlZddlZddlZddlZddlZddlZddlZddlZgdZ e e Z de dejdejfddZd d d ejeje fd eddfd dZddZejdejeje fdejfddZejd$ddZejdejeje dfdejejfddZdejeje dfdejejfddZdddejeje dfdejeje dfdejfddZdedddedeje d ejed!efd"d#ZdS)%z3Generic re-useable self-contained helper functions.N)attachmkdirs mapping_itemspromote_pathlikepromote_pathlike_directorydeprecate_positional_argsnameobjectreturncsfdd}|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)setattrfuncrr L/home/ubuntu/sommelier/.venv/lib/python3.10/site-packages/graphviz/_tools.py decorator#s zattach..decoratorr)r rrrrrrs ri)modefilenamercCs4tj|}|s dStd|tj||dddS)zPRecursively create directories up to the path of ``filename`` as needed.Nzos.makedirs(%r)T)rexist_ok)ospathdirnamelogdebugmakedirs)rrrrrrr*s  rcCs(t|}t|turtt|}|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  rfilepathcCdS)z(Return path object for path-like-object.Nrr"rrrrErcCr#)zReturn None for None.Nrr$rrrrJr%cCr#)z9Return path object or ``None`` depending on ``filepath``.Nrr$rrrrOr%cCs|dur t|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(cCst|dur |S|p tjS)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_sr) ignore_argcategory stacklevelsupported_numberr,r-r.csVdks Jddurdd}|SttsJd7fdd}|S) aMark supported_number of positional arguments as the maximum. Args: supported_number: Number of positional arguments for which no warning is raised. ignore_arg: Name of positional argument to ignore. 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 => 0: NcSs|S)z Return the undecorated function.rr rrr nulldecoratorsz0deprecate_positional_args..nulldecoratorr+c st}dd|jD dur1fddD}|s$Jdt|7ddnd d}|s=Jtdjj|j d  d \}}r[|r]|r]J d krcd ndt  f d d}|S)NcSs"g|] \}}|jtjjkr|qSr)kindinspect ParameterPOSITIONAL_OR_KEYWORD).0rparamrrr s z@deprecate_positional_args..decorator..csg|]}|kr|qSrr)r5r)r,rrr7sz#ignore_arg must be a positional argz (ignoring z))z$deprecate positional args: %s.%s(%r)__legacyr+scst|krEt|}tt|}t|}|sJddd|D}tjddddt |d|d  d |i|S) Nz, css"|] \}}|d|VqdS)=Nr)r5rvaluerrr szPdeprecate_positional_args..decorator..wrapper..zThe signature of z will be reduced to z positional arg z: pass z as keyword arg)r.r-) lenzipr itertoolsislicejoinrwarningswarnlist)argskwargs call_args supported deprecatedwanted) argnamesr- check_numberr func_name qualifications_r.r/rrwrappers2    z=deprecate_positional_args..decorator..wrapper)r2 signature parametersrr@rr __module__ __qualname____name__lstrip partition functoolswraps)r rTignoredrLseprestrSr-r,r.r/)rNrOr rPrQrRrrs*      z,deprecate_positional_args..decorator) issubclassWarning)r/r,r-r.r0rrr`rrks,r)r"Nr N)__doc__r[r2rBloggingrr&typingrE__all__ getLoggerrXrstrAnyCallablerUnionPathLikeintrroverloadr'rOptionalrPendingDeprecationWarningTyperbrrrrrsV ( "