ڰjkh%SSKJr SSKJr SSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK r SSKJr SSKJr SSKJr SSKJr SSKJr SS KJr \ R,(a SS KJr SS KJr \ R6S :Xa\ R8S rS\S'O\ R8SrS\S'\\ \!\!\4r"S\S'"SS5r#\RHS"Sj5r%"SS5r&"SS\RN5r("SS5r)"SS\RT5r+S#Sjr,"SS5r-"S S!5r.g)$) annotationsN) TracebackType)_compat) formatting)termui)utils)_find_binary_reader)ReadableBuffer)Commandwin32sysz t.TypeAlias CaptureMode)rfd ExceptionInfoc\rSrSr%S\S'S\S'S\S'SSjrSSjrSS jrSSS jjrSSS jjr SSS jjr SS jr SSjr SSjr Srg) EchoingStdin t.BinaryIO_input_outputbool_pausedc*XlX lSUlg)NFrrr)selfinputoutputs J/home/mande/repo/quber/.venv/lib/python3.13/site-packages/click/testing.py__init__EchoingStdin.__init__%s   c.[URU5$N)getattrrrxs r __getattr__EchoingStdin.__getattr__*st{{A&&r"c^UR(dURRU5 U$r$)rrwrite)rrvs r_echoEchoingStdin._echo-s || LL  r " r"cVURURRU55$r$)r-rreadrns rr0EchoingStdin.read3s zz$++**1-..r"cVURURRU55$r$)r-rread1r1s rr5EchoingStdin.read16s zz$++++A.//r"cVURURRU55$r$)r-rreadliner1s rr8EchoingStdin.readline9s zz$++..q122r"c~URR5Vs/sHoRU5PM sn$s snfr$)r readlinesr-r&s rr;EchoingStdin.readlines<s/'+{{'<'<'>?'>! 1 '>???s:cB^[U4SjTR55$)Nc3F># UHnTRU5v M g7fr$)r-).0r'rs r (EchoingStdin.__iter__..@s7;aDJJqMM;s!)iterrrs`r__iter__EchoingStdin.__iter__?s74;;777r"c,[UR5$r$)reprrrCs r__repr__EchoingStdin.__repr__BsDKK  r"rN)rrrrreturnNone)r'strrJt.Any)r,bytesrJrN))r2intrJrN)rJz list[bytes])rJzcabc.Iterator[bytes]rJrL)__name__ __module__ __qualname____firstlineno____annotations__r r(r-r0r5r8r;rDrH__static_attributes__r"rrr sA   M ' /03@8!r"rc#@# UcSv gSUlSv SUlg7f)NTF)r)streams r _pause_echor[Fs ~  scV\rSrSr%SrS\S'S\S'S\S'S SjrSS jrSS jrS r g ) _FDCapturePa>Redirect a file descriptor to a temporary file for capture. Saves the current target of *targetfd* via :func:`os.dup`, then redirects it to a temporary file via :func:`os.dup2`. On :meth:`stop`, restores the original ``fd`` and returns the captured bytes. Inspired by Pytest's ``FDCapture``. .. versionadded:: 8.4.0 rP _targetfdsaved_fdzt.BinaryIO | None_tmpfilec,XlSUlSUlgNrO)r_r`ra)rtargetfds rr _FDCapture.__init___s!  r"c[R"UR5Ul[R "SS9Ul[R"UR R5UR5 g)Nr) buffering) osdupr_r`tempfile TemporaryFileradup2filenorCs rstart_FDCapture.startdsGt~~.  ..;   $$&7r"c~URcS5e[R"URUR5 [R "UR5 SUlURR S5 URR5nURR 5 SUlU$)Nz!_FDCapture.start() was not calledrOr)rarhrlr`r_closeseekr0)rdatas rstop_FDCapture.stopis}}(M*MM(  t~~.   1}}!!#   r")r_rar`N)rdrPrJrKrJrK)rJrN) rRrSrTrU__doc__rVr rnrtrWrXr"rr]r]Ps(NM 8 r"r]c\^\rSrSr%SrS\S'S U4SjjrS U4SjjrS U4SjjrSr U=r $) BytesIOCopyuz\Patch ``io.BytesIO`` to let the written stream be copied to another. .. versionadded:: 8.2 io.BytesIOcopy_toc.>[TU]5 Xlgr$)superr r|)rr| __class__s rr BytesIOCopy.__init__}s  r"cV>[TU]5 URR5 gr$)r~flushr|rrs rrBytesIOCopy.flushs   r"cX>URRU5 [TU]U5$r$)r|r+r~)rbrs rr+BytesIOCopy.writes$ 1w}Qr"r|)r|r{rJrKrv)rr rJrP) rRrSrTrUrwrVr rr+rW __classcell__rs@rryryus$   r"rycB\rSrSr%SrS\S'S\S'S\S'S SjrS rg ) StreamMixerzvMixes `` and `` streams. The result is available in the ``output`` attribute. .. versionadded:: 8.2 r{rrystdoutstderrc[R"5Ul[URS9Ul[URS9Ulg)Nr)ioBytesIOrryrrrCs rr StreamMixer.__init__s/jjl !$++6 !$++6 r")rrrNrv)rRrSrTrUrwrVr rWrXr"rrrs    7r"rc^\rSrSr%SrS\S'S\S'S\S'SU4SjjrSS jrSU4S jjr\ SS j5r \ SS j5r S r U=r $)_NamedTextIOWrapperaA :class:`~io.TextIOWrapper` with custom ``name`` and ``mode`` that does not close its underlying buffer. When ``CliRunner`` runs in ``fd`` mode, ``_original_fd`` is patched to point at the saved (pre-redirection) ``fd``, so C-level consumers that call :meth:`fileno` (like ``faulthandler`` or ``subprocess``) keep working. In the default ``sys`` mode ``_original_fd`` stays at ``-1`` and :meth:`fileno` raises :exc:`io.UnsupportedOperation`, matching the pre-``8.3.3`` behavior. rL_name_moderP _original_fdc N>[TU]"U40UD6 X lX0lSUlgrc)r~r rrr)rbuffernamemodekwargsrs rr _NamedTextIOWrapper.__init__s) *6*  r"cg)zThe buffer this object contains belongs to some other object, so prevent the default ``__del__`` implementation from closing that buffer. .. versionadded:: 8.3.2 NrXrCs rrq_NamedTextIOWrapper.closesr"cX>URS:a UR$[TU] 5$)zReturn the file descriptor of the saved original stream when ``CliRunner`` runs in ``fd`` mode. Otherwise delegate to :class:`~io.TextIOWrapper`, which raises :exc:`io.UnsupportedOperation` for a ``BytesIO``-backed buffer. r)rr~rmrs rrm_NamedTextIOWrapper.filenos,    !$$ $w~r"cUR$r$)rrCs rr_NamedTextIOWrapper.name zzr"cUR$r$)rrCs rr_NamedTextIOWrapper.moderr")rrr) rrrrLrrLrrMrJrKrv)rJrPrQ)rRrSrTrUrwrVr rqrmpropertyrrrWrrs@rrrs  J J          r"rc[US5(a0[[R"SU55nUbU$[ S5eUcSnO&[ U[ 5(aURU5n[R"U5$)Nr0z t.IO[t.Any]z.Could not find binary reader for input stream.r") hasattrr tcast TypeError isinstancerLencoderr)rcharsetr,s rmake_input_streamrspuf  u!= > >IHII } E3   W% ::e r"c\rSrSr%SrS\S'S\S'S\S'S\S'S \S 'S \S 'S \S'S\S'SSSjjr\SSj5r\SSj5r \SSj5r SSjr Sr g)ResultaHolds the captured result of an invoked CLI script. :param runner: The runner that created the result :param stdout_bytes: The standard output as bytes. :param stderr_bytes: The standard error as bytes. :param output_bytes: A mix of ``stdout_bytes`` and ``stderr_bytes``, as the user would see it in its terminal. :param return_value: The value returned from the invoked command. :param exit_code: The exit code as integer. :param exception: The exception that happened if one did. :param exc_info: Exception information (exception type, exception instance, traceback type). .. versionchanged:: 8.2 ``stderr_bytes`` no longer optional, ``output_bytes`` introduced and ``mix_stderr`` has been removed. .. versionadded:: 8.0 Added ``return_value``. CliRunnerrunnerrN stdout_bytes stderr_bytes output_bytesrM return_valuerP exit_codeBaseException | None exceptionExceptionInfo | Noneexc_infoNc dXlX lX0lX@lXPlX`lXplXlgr$rrrrrrrr) rrrrrrrrrs rr Result.__init__s0 (((("" r"cURRURRS5R SS5$)zThe terminal output as unicode string, as the user would see it. .. versionchanged:: 8.2 No longer a proxy for ``self.stdout``. Now has its own independent stream that is mixing `` and ``, in the order they were written. replace  )rdecoderrrrCs rr Result.outputs9  '' (;(;YGOO D  r"cURRURRS5R SS5$)z&The standard output as unicode string.rrr)rrrrrrCs rr Result.stdout&s9  '' (;(;YGOO D  r"cURRURRS5R SS5$)zThe standard error as unicode string. .. versionchanged:: 8.2 No longer raise an exception, always returns the `` string. rrr)rrrrrrCs rr Result.stderr-s9  '' (;(;YGOO D  r"cUR(a[UR5OSnS[U5RSUS3$)Nokay< >)rrGtyperR)rexc_strs rrHResult.__repr__8s8*...$t~~&f4:&&'q 33r")rrrrrrrrr$)rrrrNrrNrrNrrMrrPrrrrrJrKrQ) rRrSrTrUrwrVr rrrrrHrWrXr"rrrs* N##""*.!!! !  !  !!(!'! !(        4r"rcD\rSrSr%SrS\S'S\S'S\S'S\S 'S \S 'SSS jjrSSjrSSSjjr\ RSSSjj5r SSSjjr \ RSSSjj5r Srg )ri=aThe CLI runner provides functionality to invoke a Click command line script for unittesting purposes in a isolated environment. This only works in single-threaded systems without any concurrency as it changes the global interpreter state. :param charset: the character set for the input and output data. :param env: a dictionary with environment variables for overriding. :param echo_stdin: if this is set to `True`, then reading from `` writes to ``. This is useful for showing examples in some circumstances. Note that regular prompts will automatically echo the input. :param catch_exceptions: Whether to catch any exceptions other than ``SystemExit`` when running :meth:`~CliRunner.invoke`. :param capture: Selects the output capture strategy. ``sys`` (default) captures Python-level writes only and leaves :meth:`sys.stdout.fileno` raising :exc:`io.UnsupportedOperation`, so user code that calls :func:`os.dup2` on ``sys.stdout.fileno()`` cannot clobber the host runner's stdout. ``fd`` redirects file descriptors ``1`` and ``2`` via :func:`os.dup2` to a temporary file, also catching output from stale stream references, C extensions, and subprocesses. ``fd`` is not supported on Windows. .. versionchanged:: 8.4.0 Added the ``capture`` parameter. The default ``sys`` mode no longer exposes the original fd through :meth:`fileno`, reverting the change introduced in ``8.3.3`` that broke Pytest's ``fd``-level capture teardown. Use ``capture="fd"`` to restore that behavior with proper isolation. :issue:`3384` .. versionchanged:: 8.2 Added the ``catch_exceptions`` parameter. .. versionchanged:: 8.2 ``mix_stderr`` parameter has been removed. rLrcabc.Mapping[str, str | None]envr echo_stdincatch_exceptionsrcaptureNcUS;a[SU<S35eUS:Xa$[RS:Xa[SU<S35eXlU=(d 0UlX0lX@lXPlg)N>rrzcapture=z) is not valid. Choose from 'sys' or 'fd'.rr z( is not supported on Windows. Use 'sys'.) ValueErrorrplatformrrrrr)rrrrrrs rr CliRunner.__init__hsv - '7+%NO  d?s||w67+%MN  9"$ 0 r"c,UR=(d S$)zGiven a command object it will return the default program name for it. The default is the `name` attribute or ``"root"`` if not set. root)r)rclis rget_default_prog_nameCliRunner.get_default_prog_name~s xx!6!r"c`[UR5nU(aURU5 U$)z8Returns the environment overrides for invoking a script.)dictrupdate)r overridesr,s rmake_envCliRunner.make_envs%$((^  IIi  r"c#z ^^^# [XR5nSn[Rn[Rn[R n[ Rn S[ lURU5n[5n UR(a9[R"[R[XJR55=pE[X@RSSS9=[lmUR(aSTl[U RURSSS9[l[U R URS SS S 9[l[#U5SSU4S jjj5n [#U5SSU4S jjj5n [#U5SSj5n UmSSU4Sjjjn[$R&n[$R(n[$R*n[,R.n[0R.n[2R4R6mU [$lU [$lU [$lU[,lU[0lSSU4SjjjnU[2R4l0nUR95HRunn[:R<R?U5UU'Uc[:R<U M?U[:R<U'MT U RU R U RB4v UR95H0unnUc[:R<U MU[:R<U'M2 U[lU[lU[lU[$lU[$lU[$lU[,lU[0lU [ lT[2R4lg![@a GMFf=f![@a Mf=f!UR95HAunnUc%[:R<U M![@a M*f=fU[:R<U'MC U[lU[lU[lU[$lU[$lU[$lU[,lU[0lU [ lT[2R4lf=f7f)aA context manager that sets up the isolation for invoking of a command line tool. This sets up `` with the given input data and `os.environ` with the overrides from the given dictionary. This also rebinds some internals in Click to be mocked (like the prompt functionality). This is automatically done in the :meth:`invoke` method. :param input: the input stream to put into `sys.stdin`. :param env: the environment overrides as dictionary. :param color: whether the output should contain color codes. The application can still override this explicitly. .. versionadded:: 8.2 An additional output stream is returned, which is a mix of `` and `` streams. .. versionchanged:: 8.2 Always returns the `` stream. .. versionchanged:: 8.0 `` is opened with ``errors="backslashreplace"`` instead of the default ``"strict"``. .. versionchanged:: 4.0 Added the ``color`` parameter. Nr^zr)encodingrrrzwzbackslashreplace)rrrerrorscH>[RRU=(d S5 [T5R S5n[RRUS35 [RR5 U$![ an[ 5UeSnAff=f)Nrr)rrr+nextrstrip StopIterationEOFErrorr)promptvale text_inputs r visible_input*CliRunner.isolation..visible_inputs~ JJ  V\r * (:&--f5 JJ  uBZ ( JJ   J ! (ja' (sB B! BB!c>[RRU=(d SS35 [RR5 [ T5R S5$![ an[5UeSnAff=f)Nrrr)rrr+rrrrr)rrrs r hidden_input)CliRunner.isolation..hidden_inputse JJ   "~R0 1 JJ    (J'..v66  (ja' (s A&& B0 A;;Bc[RRS5nU(a[RR U5 [RR 5 U$)Nr)rstdinr0rr+r)echochars r_getchar%CliRunner.isolation.._getchars>99>>!$D   & JJ   Kr"c&>UcT(+$U(+$r$rX)rZcolor default_colors rshould_strip_ansi.CliRunner.isolation..should_strip_ansis}(((9 r"cj>Uc[RnUc[RnT"U4XUS.UD6 g)aDefault ``pdb.Pdb`` to real terminal streams during ``CliRunner`` isolation. Without this patch, ``pdb.Pdb.__init__`` inherits from ``cmd.Cmd`` which falls back to ``sys.stdin``/``sys.stdout`` when no explicit streams are provided. During isolation those are ``BytesIO``-backed wrappers, so the debugger reads from an empty buffer and writes to captured output, making interactive debugging impossible. By defaulting to ``sys.__stdin__``/``sys.__stdout__`` (the original terminal streams Python preserves regardless of redirection), debuggers can interact with the user while ``click.echo`` output is still captured normally. This covers ``pdb.set_trace()``, ``breakpoint()``, ``pdb.post_mortem()``, and debuggers that subclass ``pdb.Pdb`` (ipdb, pdbpp). Explicit ``stdin``/``stdout`` arguments are honored and not overridden. Debuggers that do not subclass ``pdb.Pdb`` (pudb, debugpy) are not covered. N) completekeyrr)r __stdin__ __stdout__)rr rrr old_pdb_inits r_patched_pdb_init.CliRunner.isolation.._patched_pdb_init s>:} ~  "-6 MS r"r$)rz str | NonerJrL)rrrJrL)NN)rZzt.IO[t.Any] | Noner bool | NonerJr)tabNN) rzpdb.Pdbr rLrt.IO[str] | NonerrrrMrJrK)"rrrrrrr FORCED_WIDTHrrrrrBinaryIOrr _CHUNK_SIZEr[rvisible_prompt_funchidden_prompt_funcrr r rpdbPdbr itemsrhenvironget Exceptionr)rrrr bytes_input echo_input old_stdin old_stdout old_stderrold_forced_width stream_mixerrrrr old_visible_prompt_funcold_hidden_prompt_funcold__getchar_funcold_should_strip_ansiold__compat_should_strip_ansirold_envkeyvaluerrrs @@@r isolationCliRunner.isolations%D(||<  II ZZ ZZ %22"$ mmC "} ??'(vv L6I6IJ( K"5 ,,YS"   J ??&'J "(   \\   )   \\%    Z    !  Z  ( ( ! ( Z   !  EI & 6A    #)"<"<!'!:!:"OO % 7 7(/(A(A%ww'' %2"$0!""3$5! %&*'+ # # # $# % #   #   # # J- ,!iik U!zz~~c2 =JJsO',BJJsO* && (;(;\=P=PQ Q%mmo U=JJsO',BJJsO.$CJ#CJ!CI)@F &(>F %/FO&;E #(EG %&6J #+CGG /%% &mmo U=JJsO$',BJJsO.$CJ#CJ!CI)@F &(>F %/FO&;E #(EG %&6J #+CGG sI8R;>;O):O >O) R;#O4BR; OO)OO) O&"R;%O&&R;)R8PR8 P% !R8$P% %BR88R;c SnUc URnSn Sn URS:Xa7[S5n [S5n U R5 U R5 UR X4US9n U bAU b>U R [Rl U R [Rl Sn Sn Sn[U[5(a[R"U5nURS5nUR$"SU=(d SUS .UD6n [RR75 [RR75 U bYU bVU R95nU R95nU(aU SR3U5 U(aU SR3U5 U SR;5nU SR;5nU SR;5nSSS5 [=UWWWW WW US 9$![a S=pGNf=f![ a UR#U5nGN;f=f![&an[R("5n[*R,"S UR.5nUcSnUS:waUn [U[05(dI[RR3[U55 [RR3S 5 SnUnSnAGNSnAf[4a,nU(deUn Sn[R("5nSnAGNSnAff=f![RR75 [RR75 U bYU bVU R95nU R95nU(aU SR3U5 U(aU SR3U5 U SR;5nU SR;5nU SR;5nf=f!,(df  GN=f) akInvokes a command in an isolated environment. The arguments are forwarded directly to the command line script, the `extra` keyword arguments are passed to the :meth:`~clickpkg.Command.main` function of the command. This returns a :class:`Result` object. :param cli: the command to invoke :param args: the arguments to invoke. It may be given as an iterable or a string. When given as string it will be interpreted as a Unix shell command. More details at :func:`shlex.split`. :param input: the input data for `sys.stdin`. :param env: the environment overrides. :param catch_exceptions: Whether to catch any other exceptions than ``SystemExit``. If :data:`None`, the value from :class:`CliRunner` is used. :param extra: the keyword arguments to pass to :meth:`main`. :param color: whether the output should contain color codes. The application can still override this explicitly. .. versionadded:: 8.2 The result object has the ``output_bytes`` attribute with the mix of ``stdout_bytes`` and ``stderr_bytes``, as the user would see it in its terminal. .. versionchanged:: 8.2 The result object always returns the ``stderr_bytes`` stream. .. versionchanged:: 8.0 The result object has the ``return_value`` attribute with the value returned from the invoked command. .. versionchanged:: 4.0 Added the ``color`` parameter. .. versionchanged:: 3.0 Added the ``catch_exceptions`` parameter. .. versionchanged:: 3.0 The result object has the ``exc_info`` attribute with the traceback if available. Nrr)rrrr prog_namerX)argsr3zint | t.Any | Nonerr)rrr]rnOSErrorr/r`rrrrrrLshlexsplitpopKeyErrorrmain SystemExitrrrcoderPr+rrrtgetvaluer)rrr4rrrrextrarcap_outcap_err outstreamsrrrr3re_codefd_outfd_errrrrs rinvokeCliRunner.invokeTsjj  ##44 &*%) <<4  mG mG )  ^^%^ >*"w':*1*:*: '*1*:*: 'L.2II$$${{4( <!IIk2 * 2"xxVTZR9VPUV 2   "   " &7+>$\\^F$\\^F"1 ++F3"1 ++F3#A//1#A//1#A//1}?@%  G )$((' )( < 66s;  <  #<<> 4aff=>FQ; !I!&#..JJ$$S[1JJ$$T*F"  *'  <<>  *   "   " &7+>$\\^F$\\^F"1 ++F3"1 ++F3#A//1#A//1#A//1}? >s G>-A6O9$H6H4CO9> HHH1-O90H11O94 L >B#K'!L#' L 4!LL#L  L##CO66O99 Pc## SSKnURS[SS9 [R"5n[ R "US9n[R"U5 Uv [R"U5 UcSSKnURU5 gg![a gf=f![R"U5 Uc'SSKnURU5 f![a ff=ff=f7f)aKA context manager that creates a temporary directory and changes the current working directory to it. This isolates tests that affect the contents of the CWD to prevent them from interfering with each other. .. warning:: This helper predates Python 3 and modern pytest, and is not thread-safe: it relies on :func:`os.chdir`, which mutates process-global state, and :meth:`invoke` swaps the process-global standard streams too. Parallelize tests with processes (``pytest-xdist``), not threads. Locking the runner (:pr:`3511`, :pr:`3520`, :pr:`3530`) and a ``set_filesystem()`` API (:issue:`3123`) were declined: neither removes the global-state mutation. See :issue:`3700` and :issue:`3501`. :param temp_dir: Create the temporary directory under this directory. If given, the created directory is not removed when exiting. .. deprecated:: 8.5.0 Will be removed in Click 9.0. Use :class:`tempfile.TemporaryDirectory` or pytest's ``tmp_path`` fixture with absolute paths instead. .. versionchanged:: 8.0 Added the ``temp_dir`` parameter. rNz'isolated_filesystem' is deprecated and will be removed in Click 9.0. Use 'tempfile.TemporaryDirectory' or pytest's 'tmp_path' fixture with absolute paths instead.) stacklevel)dir) warningswarnDeprecationWarningrhgetcwdrjmkdtempchdirshutilrmtreer5)rtemp_dirrKcwddtrQs risolated_filesystemCliRunner.isolated_filesystems@   4   iik   ( +   H HHSMMM"%   HHSMMM"%  sfAC&B! C&>BC& BC&BC&!C#CC# CC#CC##C&)rrrrr)zutf-8NFTr) rrLr$cabc.Mapping[str, str | None] | NonerrrrrrrJrK)rr rJrLr$)rrXrJr)NNF)r str | bytes | t.IO[t.Any] | NonerrXrrrJz9cabc.Generator[tuple[io.BytesIO, io.BytesIO, io.BytesIO]])NNNNF)rr r4zstr | cabc.Sequence[str] | NonerrYrrXrrrrr>rMrJr)rSzstr | os.PathLike[str] | NonerJzcabc.Generator[str])rRrSrTrUrwrVr rr contextlibcontextmanagerr/rErVrWrXr"rrr=s"HL && 48 !%$ 2      ,"AE= &3748 C,/C,2C, C, C C,C,P152648(,O O .O 0 O 2 O & O O O  O b8<858 88r"r)rZzEchoingStdin | NonerJzcabc.Generator[None])rrYrrLrJr)/ __future__rcollections.abcabccabcrZrrhrr6rrjtypingrtypesrrrrrr r TYPE_CHECKING _typeshedr corer rLiteralrrVtupler BaseExceptionrrr[r[r]rryr TextIOWrapperrrrrrXr"rris"" (??(<<7 yy/K/ yy5K5"4 #6 }#TU {U#!#!L ""J "** *77$4"**4n +69(S4S4laar"