o 1)h@sfddlmZddlmZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddl mZddlmZddlmZdd lmZdd lmZdd lmZdd lmZe jroddlZdd lmZddlmZddlmZe dZ!GdddZ"Gddde"Z#Gddde"Z$Gddde"Z%Gddde"Z&Gddde"e j'e!Z(Gddde"Z)Gdd d e"Z*Gd!d"d"e*Z+Gd#d$d$e*Z,Gd%d&d&e+e,Z-Gd'd(d(e*Z.Gd)d*d*e+e.Z/Gd+d,d,e"Z0Gd-d.d.e"Z1Gd/d0d0e"Z2dDd5d6Z3Gd7d8d8e"Z4Gd9d:d:e#Z5dEdFd>d?Z6e%Z7e&Z8e,Z9e.Z:e0Z;e1ZdS)G) annotationsN)datetime)gettext)ngettext)_get_argv_encoding) open_stream BadParameter)format_filename)LazyFile)safecall)Context) ParameterCompletionItemParamTypeValuec@seZdZUdZdZded<dZded<ded <d Zd ed <d.ddZ d/d0ddZ d1ddZ d2ddZ d0d d!Z d3d$d%Z d/d4d(d)Zd5d,d-Zd S)6 ParamTypeaRepresents the type of a parameter. Validates and converts values from the command line or Python into the correct type. To implement a custom type, subclass and implement at least the following: - The :attr:`name` class attribute must be set. - Calling an instance of the type with ``None`` must return ``None``. This is already implemented by default. - :meth:`convert` must convert string values to the correct type. - :meth:`convert` must accept values that are already the correct type. - It must be able to convert a value if the ``ctx`` and ``param`` arguments are ``None``. This can occur when converting prompt input. Fzt.ClassVar[bool] is_compositerzt.ClassVar[int]aritystrnameNzt.ClassVar[str | None]envvar_list_splitterreturndict[str, t.Any]cCsBt|jdd}|dd}t|dr|j}n|}||dS)zGather information that could be useful for a tool generating user-facing documentation. Use :meth:`click.Context.to_info_dict` to traverse the entire CLI structure. .. versionadded:: 8.0 rrZ ParameterTyper) param_typer)type__name__ partitionhasattrr)selfrrr!JC:\Users\User\Downloads\Proyecto_IoT\venv\Lib\site-packages\click/types.py to_info_dict>s    zParamType.to_info_dictvaluet.AnyparamParameter | NonectxContext | NonecCs|dur ||||SdSN)convertr r$r&r(r!r!r"__call__SszParamType.__call__rr str | NonecCdS)z>Returns the metavar default for this param if it provides one.Nr!r r&r(r!r!r" get_metavar\zParamType.get_metavarcCr/)ztOptionally might return extra information about a missing parameter. .. versionadded:: 2.0 Nr!r0r!r!r"get_missing_message_r2zParamType.get_missing_messagecC|S)aConvert the value to the correct type. This is not called if the value is ``None`` (the missing value). This must accept string values from the command line, as well as values that are already the correct type. It may also convert other compatible types. The ``param`` and ``ctx`` arguments may be ``None`` in certain situations, such as when converting prompt input. If the value cannot be converted, call :meth:`fail` with a descriptive message. :param value: The value to convert. :param param: The parameter that is using this type to convert its value. May be ``None``. :param ctx: The current context that arrived at this value. May be ``None``. r!r,r!r!r"r+fszParamType.convertrvcabc.Sequence[str]cCs|pd|jS)auGiven a value from an environment variable this splits it up into small chunks depending on the defined envvar list splitter. If the splitter is set to `None`, which means that whitespace splits, then leading and trailing whitespace is ignored. Otherwise, leading and trailing splitters usually lead to empty items being included. )splitr)r r5r!r!r"split_envvar_value~szParamType.split_envvar_valuemessage t.NoReturncCst|||d)z4Helper method to fail with an invalid value message.r(r&r )r r:r&r(r!r!r"failszParamType.fail incompletelist[CompletionItem]cCsgS)aReturn a list of :class:`~click.shell_completion.CompletionItem` objects for the incomplete value. Most types do not provide completions, but some do, and this allows custom types to provide custom completions as well. :param ctx: Invocation context for this command. :param param: The parameter that is requesting completion. :param incomplete: Value being completed. May be empty. .. versionadded:: 8.0 r!)r r(r&r>r!r!r"shell_completeszParamType.shell_completerr)NNr$r%r&r'r(r)rr%r&rr(rrr.)r&rr(r)rr.)r5rrr6)r:rr&r'r(r)rr;r(rr&rr>rrr?)r __module__ __qualname____doc__r__annotations__rrr#r-r1r3r+r9r=r@r!r!r!r"rs$           rc@seZdZdZedddZdS)CompositeParamTypeTrintcCstr*NotImplementedErrorr r!r!r"rszCompositeParamType.arityNrrJ)rrErFrpropertyrr!r!r!r"rIsrIcs2eZdZdddZdfdd ZdddZZS) FuncParamTypefunct.Callable[[t.Any], t.Any]rNonecCs|j|_||_dSr*)rrrQ)r rQr!r!r"__init__s zFuncParamType.__init__rct}|j|d<|S)NrQ)superr#rQr Z info_dict __class__r!r"r#  zFuncParamType.to_info_dictr$r%r&r'r(r)c Cs\z||WSty-zt|}Wnty"|dd}Ynw||||YdSwNzutf-8replace)rQ ValueErrorr UnicodeErrordecoder=r,r!r!r"r+s    zFuncParamType.convert)rQrRrrSrArB)rrErFrTr#r+ __classcell__r!r!rXr"rPs rPc@$eZdZdZdd d Zdd d ZdS)UnprocessedParamTypetextr$r%r&r'r(r)rcCr4r*r!r,r!r!r"r+szUnprocessedParamType.convertrcCr/)N UNPROCESSEDr!rMr!r!r"__repr__zUnprocessedParamType.__repr__NrBrrrrErFrr+rer!r!r!r"rbs rbc@ra)StringParamTypercr$r%r&r'r(r)rc Cst|trDt}z||}W|StyCt}||kr:z ||}WY|Sty9|dd}YY|Sw|dd}Y|Swt|Sr[) isinstancebytesrr_r^sysgetfilesystemencodingr)r r$r&r(encZfs_encr!r!r"r+s&     zStringParamType.convertrcCr/)NSTRINGr!rMr!r!r"rerfzStringParamType.__repr__NrBrgrhr!r!r!r"ris ricseZdZdZdZ d.d/d d Zd0fd d Z d1d2ddZd3ddZd4ddZ d5dd Z d6d$d%Z d7d&d'Z d8d(d)Z d9d,d-ZZS):Choicea9The choice type allows a value to be checked against a fixed set of supported values. You may pass any iterable value which will be converted to a tuple and thus will only be iterated once. The resulting value will always be one of the originally passed choices. See :meth:`normalize_choice` for more info on the mapping of strings to choices. See :ref:`choice-opts` for an example. :param case_sensitive: Set to false to make choices case insensitive. Defaults to true. .. versionchanged:: 8.2.0 Non-``str`` ``choices`` are now supported. It can additionally be any iterable. Before you were not recommended to pass anything but a list or tuple. .. versionadded:: 8.2.0 Choice normalization can be overridden via :meth:`normalize_choice`. choiceTchoicescabc.Iterable[ParamTypeValue]case_sensitiveboolrrScCst||_||_dSr*)tuplerrrt)r rrrtr!r!r"rTs  zChoice.__init__rcs"t}|j|d<|j|d<|S)Nrrrt)rVr#rrrtrWrXr!r"r#s   zChoice.to_info_dictNr(r)!cabc.Mapping[ParamTypeValue, str]csfddjDS)a Returns mapping where keys are the original choices and the values are the normalized values that are accepted via the command line. This is a simple wrapper around :meth:`normalize_choice`, use that instead which is supported. csi|] }|j|dqS)rqr()normalize_choice.0rqr(r r!r" sz.Choice._normalized_mapping..rr)r r(r!r|r"_normalized_mappings zChoice._normalized_mappingrrcCsHt|tjr |jnt|}|dur|jdur||}|js"|}|S)a1 Normalize a choice value, used to map a passed string to a choice. Each choice must have a unique normalized value. By default uses :meth:`Context.token_normalize_func` and if not case sensitive, convert it to a casefolded value. .. versionadded:: 8.2.0 N)rjenumEnumrrZtoken_normalize_funcrtcasefold)r rqr( normed_valuer!r!r"ry s   zChoice.normalize_choicer&rrr.cCs~|jdkr|jsdd|jD}dgt|}nddd|j|dD}|jr9|jdkr9d|d Sd |d S) NoptioncSsg|] }tt|jqSr!) convert_typerrupperrzr!r!r" 6sz&Choice.get_metavar..|cSg|]}t|qSr!)r)r{ir!r!r"r<r(Zargument{}[]) Zparam_type_nameZ show_choicesrrjoindictfromkeysrvaluesrequired)r r&r(Zchoice_metavars choices_strr!r!r"r14s  zChoice.get_metavarcCs"tdjd|j|ddS)zt Message shown when no choice is passed. .. versionchanged:: 8.2.0 Added ``ctx`` argument. zChoose from: {choices}z, rr~)_formatrrrr0r!r!r"r3FszChoice.get_missing_messager$r%r'csf|j||d|j|d}ztfdd|DWSty2|j|j||d||dYdSw)z For a given value from the parser, normalize it and find its matching normalized value in the list of choices. Then return the matched "original" choice. rxrc3s |] \}}|kr|VqdSr*r!)r{original normalizedrr!r" \sz!Choice.convert..)r$r(r&r(N)ryrnextitems StopIterationr=get_invalid_choice_message)r r$r&r(Znormalized_mappingr!rr"r+Ps     zChoice.convertcCs:dtt|j|d}tddt|jj|||dS)zGet the error message when the given choice is invalid. :param value: The invalid value. .. versionadded:: 8.2 , rz{value!r} is not {choice}.z"{value!r} is not one of {choices}.)r$rqrr) rmapreprrrrlenrrr)r r$r(rr!r!r"rhsz!Choice.get_invalid_choice_messagecCsdt|jdS)NzChoice())listrrrMr!r!r"revzChoice.__repr__r>r?cs^ddlmtt|j}|jrfdd|D}n fdd|D}fdd|DS)aComplete choices that start with the incomplete value. :param ctx: Invocation context for this command. :param param: The parameter that is requesting completion. :param incomplete: Value being completed. May be empty. .. versionadded:: 8.0 rrc3s|] }|r|VqdSr*) startswithr{cr>r!r"rsz(Choice.shell_complete..c3s"|] }|r|VqdSr*)lowerrrrr!r"rs csg|]}|qSr!r!rrr!r"rrz)Choice.shell_complete..)click.shell_completionrrrrrrtr)r r(r&r>Z str_choicesZmatchedr!)rr>r"r@ys zChoice.shell_complete)T)rrrsrtrurrSrAr*)r(r)rrw)rqrr(r)rrrC)r&rr(r)rr)r$r%r&r'r(r)rr)r$r%r(r)rrrgrD)rrErFrGrrTr#rryr1r3r+rrer@r`r!r!rXr"rps      rpcsZeZdZdZdZd d!ddZd"fd d Zd#ddZd$ddZd%ddZ d&ddZ Z S)'DateTimeaKThe DateTime type converts date strings into `datetime` objects. The format strings which are checked are configurable, but default to some common (non-timezone aware) ISO 8601 formats. When specifying *DateTime* formats, you should only pass a list or a tuple. Other iterables, like generators, may lead to surprising results. The format strings are processed using ``datetime.strptime``, and this consequently defines the format strings which are allowed. Parsing is tried using each format, in order, and the first format which parses successfully is used. :param formats: A list or tuple of date format strings, in the order in which they should be tried. Defaults to ``'%Y-%m-%d'``, ``'%Y-%m-%dT%H:%M:%S'``, ``'%Y-%m-%d %H:%M:%S'``. rNformatscabc.Sequence[str] | NonecCs|pgd|_dS)N)z%Y-%m-%dz%Y-%m-%dT%H:%M:%Sz%Y-%m-%d %H:%M:%S)r)r rr!r!r"rTrzDateTime.__init__rrcrU)Nr)rVr#rrWrXr!r"r#rZzDateTime.to_info_dictr&rr(rr.cCsdd|jdS)Nrrr)rrr0r!r!r"r1zDateTime.get_metavarr$r%rrdatetime | NonecCs$zt||WStyYdSwr*)rstrptimer])r r$rr!r!r"_try_to_convert_dates  zDateTime._try_to_convert_dater'r)cCstt|tr|S|jD]}|||}|dur|Sq dtt|j}|tddt |jj |||d||dS)Nrz-{value!r} does not match the format {format}.z/{value!r} does not match the formats {formats}.)r$rr) rjrrrrrrr=rrr)r r$r&r(rZ convertedZ formats_strr!r!r"r+s&   zDateTime.convertcCr/)Nrr!rMr!r!r"rerfzDateTime.__repr__r*)rrrArC)r$r%rrrrrBrg) rrErFrGrrTr#r1rr+rer`r!r!rXr"rs    rc@s eZdZUded<d d d Zd S)_NumberParamTypeBasezt.ClassVar[type[t.Any]] _number_classr$r%r&r'r(r)rc Cs@z||WSty|tdj||jd||YdSw)Nz'{value!r} is not a valid {number_type}.)r$ number_type)rr]r=rrrr,r!r!r"r+s   z_NumberParamTypeBase.convertNrB)rrErFrHr+r!r!r!r"rs rcs`eZdZ     d%d&d d Zd'fdd Zd(fdd Zd)ddZd*d!d"Zd*d#d$ZZ S)+_NumberRangeBaseNFmin float | Nonemaxmin_openrumax_openclamprrScC"||_||_||_||_||_dSr*rrrrrr rrrrrr!r!r"rT  z_NumberRangeBase.__init__rcs,t}|j|j|j|j|j|jd|S)Nr)rVr#updaterrrrrrWrXr!r"r#s z_NumberRangeBase.to_info_dictr$r%r&r'r(r)csddl}t|||}|jduo|jr|jn|j||j}|jduo/|jr)|j n|j ||j}|j rI|r>| |jd|jS|rI| |jd|jS|sM|r]| tdj||d|||S)Nrrz${value} is not in the range {range}.)r$range)operatorrVr+rrleltrrgegtr_clampr=rr_describe_range)r r$r&r(rr5Zlt_minZgt_maxrXr!r"r+s0  z_NumberRangeBase.convertboundfloatdirt.Literal[1, -1]opencCst)zFind the valid value to clamp to bound in the given direction. :param bound: The boundary value. :param dir: 1 or -1 indicating the direction to move. :param open: If true, the range does not include the bound. rKr rrrr!r!r"r#sz_NumberRangeBase._clamprcCs|jdur|jr dnd}d||jS|jdur(|jrdnd}d||jS|jr-dnd}|jr4dnd}|j|d||jS)z(Describe the range for use in help text.Nz>=)rrrr)r opZlopZropr!r!r"r-s  z _NumberRangeBase._describe_rangecCs.|jrdnd}dt|jd||dS)Nz clampedr7r r)rrrr)r rr!r!r"re;s z_NumberRangeBase.__repr__NNFFF rrrrrrurrurrurrSrArBrrrrrrurrrg) rrErFrTr#r+rrrer`r!r!rXr"rs   rc@eZdZdZeZdddZdS) IntParamTypeintegerrrcCr/)NINTr!rMr!r!r"reDrfzIntParamType.__repr__Nrg)rrErFrrJrrer!r!r!r"r@rc@seZdZdZdZd d d Zd S)IntRangeaRestrict an :data:`click.INT` value to a range of accepted values. See :ref:`ranges`. If ``min`` or ``max`` are not passed, any value is accepted in that direction. If ``min_open`` or ``max_open`` are enabled, the corresponding boundary is not included in the range. If ``clamp`` is enabled, a value outside the range is clamped to the boundary instead of failing. .. versionchanged:: 8.0 Added the ``min_open`` and ``max_open`` parameters. z integer rangerrJrrrrurcCs|s|S||Sr*r!rr!r!r"rYszIntRange._clampN)rrJrrrrurrJ)rrErFrGrrr!r!r!r"rHsrc@r)FloatParamTyperrrcCr/)NFLOATr!rMr!r!r"refrfzFloatParamType.__repr__Nrg)rrErFrrrrer!r!r!r"rbrrcs<eZdZdZdZ     ddfdd ZdddZZS) FloatRangea&Restrict a :data:`click.FLOAT` value to a range of accepted values. See :ref:`ranges`. If ``min`` or ``max`` are not passed, any value is accepted in that direction. If ``min_open`` or ``max_open`` are enabled, the corresponding boundary is not included in the range. If ``clamp`` is enabled, a value outside the range is clamped to the boundary instead of failing. This is not supported if either boundary is marked ``open``. .. versionchanged:: 8.0 Added the ``min_open`` and ``max_open`` parameters. z float rangeNFrrrrrurrrrScs2tj|||||d|s|r|rtddSdS)Nr*Clamping is not supported for open bounds.)rVrT TypeErrorrrXr!r"rT|s   zFloatRange.__init__rrrrrcCs|s|Std)Nr) RuntimeErrorrr!r!r"rszFloatRange._clamprrr)rrErFrGrrTrr`r!r!rXr"rjsrc@ra) BoolParamTypebooleanr$r%r&r'r(r)rcCsR|dvrt|S|}|dvrdS|dvrdS|tdj|d||dS)N>FT>trueonyes1ytT>falsenfnooff0Fz!{value!r} is not a valid boolean.r$)rustriprr=rr)r r$r&r(Znormr!r!r"r+s zBoolParamType.convertrcCr/)NBOOLr!rMr!r!r"rerfzBoolParamType.__repr__NrBrgrhr!r!r!r"rs rc@ra)UUIDParameterTypeuuidr$r%r&r'r(r)rcCs\ddl}t||jr |S|}z||WSty-|tdj|d||YdSw)Nrz{value!r} is not a valid UUID.r)rrjUUIDrr]r=rr)r r$r&r(rr!r!r"r+s    zUUIDParameterType.convertrcCr/)Nrr!rMr!r!r"rerfzUUIDParameterType.__repr__NrBrgrhr!r!r!r"rs rcsleZdZUdZdZejjZde d<     d+d,ddZ d-fdd Z d.ddZ d/d#d$Z d0d)d*ZZS)1Filea+Declares a parameter to be a file for reading or writing. The file is automatically closed once the context tears down (after the command finished working). Files can be opened for reading or writing. The special value ``-`` indicates stdin or stdout depending on the mode. By default, the file is opened for reading text data, but it can also be opened in binary mode or for writing. The encoding parameter can be used to force a specific encoding. The `lazy` flag controls if the file should be opened immediately or upon first IO. The default is to be non-lazy for standard input and output streams as well as files opened for reading, `lazy` otherwise. When opening a file lazily for reading, it is still opened temporarily for validation, but will not be held open until first IO. lazy is mainly useful when opening for writing to avoid creating the file until it is needed. Files can also be opened atomically in which case all writes go into a separate file in the same folder and upon completion the file will be moved over to the original location. This is useful if a file regularly read by other users is modified. See :ref:`file-args` for more information. .. versionchanged:: 2.0 Added the ``atomic`` parameter. filenamet.ClassVar[str]rrNstrictFmoderencodingr.errorslazy bool | NoneatomicrurrScCrr*)rrrrr)r rrrrrr!r!r"rTrz File.__init__rcs t}|j|j|jd|S)N)rr)rVr#rrrrWrXr!r"r#s zFile.to_info_dictr$str | os.PathLike[str]cCs4|jdur|jSt|dkrdSd|jvrdSdS)N-FwT)rosfspathrr r$r!r!r"resolve_lazy_flags  zFile.resolve_lazy_flag$str | os.PathLike[str] | t.IO[t.Any]r&r'r(r) t.IO[t.Any]c Cst|r|Std|}zP||}|r2t||j|j|j|jd}|dur+| |j td|WSt ||j|j|j|jd\}}|durZ|rR| t |j |WS| t |j|WSty}z|dt|d|j||WYd}~dSd}~ww)Nr)rr'z': ) _is_file_likercastr r rrrrZ call_on_closeZclose_intelligentlyrr closeflushOSErrorr=r strerror) r r$r&r(rlfrZ should_closeer!r!r"r+s2     .z File.convertrrr>r?cCsddlm}||ddgS)acReturn a special completion marker that tells the completion system to use the shell to provide file path completions. :param ctx: Invocation context for this command. :param param: The parameter that is requesting completion. :param incomplete: Value being completed. May be empty. .. versionadded:: 8.0 rrfiler)rr)r r(r&r>rr!r!r"r@.s zFile.shell_complete)rNrNF) rrrr.rr.rrrrurrSrA)r$rrru)r$rr&r'r(r)rrrD)rrErFrGrr pathpathseprrHrTr#r r+r@r`r!r!rXr"rs    +rr$r%rte.TypeGuard[t.IO[t.Any]]cCst|dp t|dS)Nreadwrite)rrr!r!r"r?rrcspeZdZUdZejjZded<         d*d+ddZ d,fdd Z d-ddZ d.d!d"Z d/d(d)Z ZS)0PathaThe ``Path`` type is similar to the :class:`File` type, but returns the filename instead of an open file. Various checks can be enabled to validate the type of file and permissions. :param exists: The file or directory needs to exist for the value to be valid. If this is not set to ``True``, and the file does not exist, then all further checks are silently skipped. :param file_okay: Allow a file as a value. :param dir_okay: Allow a directory as a value. :param readable: if true, a readable check is performed. :param writable: if true, a writable check is performed. :param executable: if true, an executable check is performed. :param resolve_path: Make the value absolute and resolve any symlinks. A ``~`` is not expanded, as this is supposed to be done by the shell only. :param allow_dash: Allow a single dash as a value, which indicates a standard stream (but does not open it). Use :func:`~click.open_file` to handle opening this value. :param path_type: Convert the incoming path value to this type. If ``None``, keep Python's default, which is ``str``. Useful to convert to :class:`pathlib.Path`. .. versionchanged:: 8.1 Added the ``executable`` parameter. .. versionchanged:: 8.0 Allow passing ``path_type=pathlib.Path``. .. versionchanged:: 6.0 Added the ``allow_dash`` parameter. rrFTNexistsru file_okaydir_okaywritablereadable resolve_path allow_dash path_typetype[t.Any] | None executablec Csx||_||_||_||_||_| |_||_||_||_|jr(|js(t d|_ dS|jr5|js5t d|_ dSt d|_ dS)Nr directoryr) r!r"r#r%r$r*r&r'rrr) r r!r"r#r$r%r&r'r(r*r!r!r"rTfs   z Path.__init__rrcs0t}|j|j|j|j|j|j|jd|S)N)r!r"r#r$r%r') rVr#rr!r"r#r$r%r'rWrXr!r"r#s zPath.to_info_dictr$rstr | bytes | os.PathLike[str]cCsT|jdur(t||js(|jturt|S|jturt|Std||S|S)Nzos.PathLike[str]) rrjrr fsdecoderkfsencoderrr r!r!r"coerce_path_results    zPath.coerce_path_resultr&r'r(r)c Cs|}|jo |jo |dv}|s|jrtj|}zt|}Wn&tyD|js/| |YS| t dj |j t|d||Ynw|jsat|jra| t dj |j t|d|||js}t|jr}| t dj |j t|d|||jrt|tjs| t dj |j t|d|||jrt|tjs| t dj |j t|d|||jrt|tjs| t dj |j t|d||| |S) N)-rz#{name} {filename!r} does not exist.)rrz{name} {filename!r} is a file.z#{name} {filename!r} is a directory.z${name} {filename!r} is not readable.z${name} {filename!r} is not writable.z&{name} {filename!r} is not executable.)r"r'r&r rrealpathstatrr!r/r=rrrtitler S_ISREGst_moder#S_ISDIRr%accessR_OKr$W_OKr*X_OK)r r$r&r(r5Zis_dashstr!r!r"r+sv    z Path.convertrrr>rr?cCs.ddlm}|jr|jsdnd}|||dgS)aReturn a special completion marker that tells the completion system to use the shell to provide path completions for only directories or any paths. :param ctx: Invocation context for this command. :param param: The parameter that is requesting completion. :param incomplete: Value being completed. May be empty. .. versionadded:: 8.0 rrrrr)rrr#r")r r(r&r>rrr!r!r"r@s zPath.shell_complete) FTTFTFFNF)r!rur"rur#rur$rur%rur&rur'rur(r)r*rurA)r$rrr,)r$rr&r'r(r)rr,rD)rrErFrGr rrrrHrTr#r/r+r@r`r!r!rXr"r Cs"    Ir csReZdZdZdddZdfd d Zedd d ZedddZdddZ Z S)TupleaThe default behavior of Click is to apply a type on a value directly. This works well in most cases, except for when `nargs` is set to a fixed count and different types should be used for different items. In this case the :class:`Tuple` type can be used. This type can only be used if `nargs` is set to a fixed number. For more information see :ref:`tuple-type`. This can be selected by using a Python tuple literal as a type. :param types: a list of types that should be used for the tuple items. types&cabc.Sequence[type[t.Any] | ParamType]rrScCsdd|D|_dS)NcSrr!)rr{tyr!r!r"rrz"Tuple.__init__..)r=)r r=r!r!r"rTrzTuple.__init__rcs"t}dd|jD|d<|S)NcSsg|]}|qSr!)r#)r{rr!r!r"r rz&Tuple.to_info_dict..r=)rVr#r=rWrXr!r"r# s zTuple.to_info_dictrcCsdddd|jDdS)Nrrcss|]}|jVqdSr*)rr?r!r!r"rszTuple.name..r)rr=rMr!r!r"rsz Tuple.namerJcCs t|jSr*)rr=rMr!r!r"rs z Tuple.arityr$r%r&r'r(r)cs`t|j}t|}||kr|jtdd|j||ddtfddt|j|ddDS) Nz:{len_type} values are required, but {len_value} was given.z;{len_type} values are required, but {len_value} were given.)len_type len_valuerc3s |] \}}||VqdSr*r!)r{r@rr<r!r"r's z Tuple.convert..F)r)rr=r=rrrvzip)r r$r&r(rArBr!r<r"r+s"  z Tuple.convert)r=r>rrSrArgrNrB) rrErFrGrTr#rOrrr+r`r!r!rXr"r<s   r<r@ t.Any | NonedefaultcCsd}|dur1|dur1t|ttfr+|r*|d}t|ttfr&ttt|}n t|}nt|}d}t|tr:t|St|trA|S|tusI|durKtS|t urQt S|t urWt S|t ur]tS|ratS zt|trptd|dWt|StyYt|Sw)zFind the most appropriate :class:`ParamType` for the given Python type. If the type isn't provided, it can be inferred from a default value. FNrTz3Attempted to use an uninstantiated parameter type (z).)rjrvrrrr<rrrorJrrrrur issubclassAssertionErrorrrP)r@rEZ guessed_typeitemr!r!r"r,sJ     rc@s.eZdZUded<ded<ded<ded<dS)OptionHelpExtraztuple[str, ...]envvarsrrErrN)rrErFrHr!r!r!r"rIs  rIF)total)r$r%rrr*)r@rDrErDrr)? __future__rcollections.abcabcZcabcrr r2rltypingrrrrrZ_compatrr exceptionsr utilsr r r TYPE_CHECKINGZtyping_extensionstecorerrZshell_completionrTypeVarrrrIrPrbriGenericrprrrrrrrrrrrr r<rrdrorrrr TypedDictrIr!r!r!r"sh               )GV+ y6 4G