a d @sddlZddlmZddlmZmZddlmZmZm Z e dddZ dde ee e e d d d Z dd e e e d ddZ e dddZedddZeeegeeeZGdddeZGdddeedZdS)Nwraps) Parameter signature) GeneratorIterableOptionalversioncsfdd}|S)aBDecorator for methods that issues warnings for positional arguments. Using the keyword-only argument syntax in pep 3102, arguments after the * will issue a warning when passed as a positional argument. Args: version (`str`): The version when positional arguments will result in error. csrtggjD]6\}}|jtjkr:|q|jtjkr|qtfdd}|S)Nc st|t}|dkr&|i|Sddtd||| dD}d|}tdjd|ddt|tj|fi|S) NrcSs8g|]0\}}t|tr&|d|dn |d|qS)z=''=) isinstancestr).0nameargrk/var/www/html/stable-diffusion-webui/venv/lib/python3.9/site-packages/huggingface_hub/utils/_deprecation.py !szi_deprecate_positional_args.._inner_deprecate_positional_args..inner_f.., z+Deprecated positional argument(s) used in 'z': pass z as keyword args. From version z? passing these as positional arguments will result in an error,) lenzipjoinwarningswarn__name__ FutureWarningupdate parameters)argskwargs extra_argsZargs_msg)all_argsf kwonly_argssigr rrinner_fs"  zU_deprecate_positional_args.._inner_deprecate_positional_args..inner_f) rritemskindrPOSITIONAL_OR_KEYWORDappend KEYWORD_ONLYr)r#rparamr&r )r"r#r$r%r _inner_deprecate_positional_argss    zD_deprecate_positional_args.._inner_deprecate_positional_argsr)r r-rr r_deprecate_positional_argss "r.)custom_message)r deprecated_argsr/csfdd}|S)aDecorator to issue warnings when using deprecated arguments. TODO: could be useful to be able to set a custom error message. Args: version (`str`): The version when deprecated arguments will result in error. deprecated_args (`List[str]`): List of the arguments to be deprecated. custom_message (`str`, *optional*): Warning message that is raised. If not passed, a default warning message will be created. cs(ttfdd}|S)Ncsg}t|jD]\}}|jvr||jq|D]*\}}|vr<|j|jkr<||q._inner_deprecate_positional_args..inner_f)rrr#r&r/r0r )r#r%rr-Jsz>_deprecate_arguments.._inner_deprecate_positional_argsr)r r0r/r-rr7r_deprecate_arguments6s!r8)r5)r r5csfdd}|S)aCDecorator to issue warnings when using a deprecated method. Args: version (`str`): The version when deprecated arguments will result in error. message (`str`, *optional*): Warning message that is raised. If not passed, a default warning message will be created. cstfdd}|S)NcsJdjdjdd}dur0|d7}t|t|i|S)Nr z ' (from 'z3') is deprecated and will be removed from version 'r1 )r __module__rrr)rr warning_message)r#r5r rrr&zs   zC_deprecate_method.._inner_deprecate_method..inner_frr6r5r r#r_inner_deprecate_methodys z2_deprecate_method.._inner_deprecate_methodr)r r5r>rr<r_deprecate_methodns  r?csfdd}|S)aDecorator to deprecate the usage as a list of the output of a method. To be used when a method currently returns a list of objects but is planned to return an generator instead in the future. Output is still a list but tweaked to issue a warning message when it is specifically used as a list (e.g. get/set/del item, get length,...). Args: version (`str`): The version when output will start to be an generator. cstfdd}|S)Ncs&|i|}t|djdddS)Na''{f.__name__}' currently returns a list of objects but is planned to be a generator starting from version {version} in order to implement pagination. Please avoid to use `{f.__name__}(...).{attr_name}` or explicitly convert the output to a list first with `[item for item in {f.__name__}(...)]`.z {attr_name})r#r attr_namer;)DeprecatedListformat)rr Z list_value)r#r rrr&szH_deprecate_list_output.._inner_deprecate_method..inner_frr6r r=rr>sz7_deprecate_list_output.._inner_deprecate_methodr)r r>rr r_deprecate_list_outputs rD)returnccsdSNrrrrr _empty_gensrGcs eZdZdZfddZZS)DeprecateListMetaclasszFMetaclass that overwrites all list-only methods, including magic ones.csXd|vrtdt|vr tddd}tD]}|tt||||<q,t||||S)N _deprecatezJA `_deprecate` method must be implemented to use `DeprecateListMetaclass`.z?Class must inherit from `list` to use `DeprecateListMetaclass`.cstfdd}|S)Ncs ||g|Ri|SrF)rI)selfrr r#rrr_inners zIDeprecateListMetaclass.__new__.._with_deprecation.._innerr)r#rrLrrKr_with_deprecationsz9DeprecateListMetaclass.__new__.._with_deprecation) TypeErrorlist_LIST_ONLY_ATTRSgetattrsuper__new__)clsZclsnamebasesattrsrMattr __class__rrrSs zDeprecateListMetaclass.__new__)rr: __qualname____doc__rS __classcell__rrrXrrHsrHcs6eZdZdZedfdd ZeddddZZS) rBzCustom List class for which all calls to a list-specific method is deprecated. Methods that are shared with a generator are not deprecated. See `_deprecate_list_output` for more details. rAcst|||_dS)zInitialize the list with a default warning message. Warning message will be formatted at runtime with a "{attr_name}" value. N)rR__init___deprecation_msg)rJiterabler;rXrrr]s zDeprecatedList.__init__N)r@rEcCst|jj|dtdS)N)r@)rrr^rCr)rJr@rrrrIszDeprecatedList._deprecate)rr:rZr[rr]rIr\rrrXrrBsrB) metaclass)r functoolsrinspectrrtypingrrrrr.r8r?rDrG frozensetsetdirrPtyperHrOrBrrrrs  3 8'