֗jm)*UddlmZddlZddlmZddlmZmZmZm Z m Z m Z m Z m Z ddlZddlmZmZmZddlmZddlmZmZedZed Gd d Ze Gd de Zed GddeZGddej:j<eZGddej:j>eZed GddeZ ed GddeZ!eGddZ"ej:j<Z#ej:j>Z$ej:j<ej:j>ee!fZ%e eeej:j<ej:j>fZ&de'd<y)) annotationsN) dataclass)AnyCallableClassVarHashableProtocolTextIOUnionruntime_checkable)Self TypeAliasTypeVar)State)Empty EmptyTypeTT)frozenceZdZUdZdZded<eZded<edddZe dd Z e dd Z ddd Z dd Z d ddZeddZeddZy )DefaultaRepresents the sequence of fallback methods of default value retrieval for an `Arg`. **All** argument defaults (including static values) are coerced into `Default` instance. When evaluated for an argument, the provided sequence of default retrieval methods are evaluated in order, returning the value of the first option to return a non-None value. The `Default.default` value is returned if none of the provided methods return a value. Examples: - `Arg(default=4) == Arg(default=Default(default=4))` - `Arg(default=Env("FOO")) == Arg(default=Default(Env("FOO")))` - `Arg(default=Env("FOO") | Env("BAR")) == Arg(default=Default(Env("FOO"), Env("BAR")))` ztuple[DefaultType, ...]sequencezEmptyType | Anydefaultrc`tj|d|tj|d|y)Nrrobject __setattr__)selfrrs RC:\Users\pivot\Documents\cueki\casual-preloader\Lib\site-packages\cappa/default.py__init__zDefault.__init__,s&4X64G4c2|j|dS)aProduce a `Default` instance where the provided value is an explicit default. A default produced this way will resolve to a `Value` which gets appended to the fallback sequence rather than being overwriting the Default-level static fallback. Essentially `Default(..., Value(4), default=5)` will **always** evaluate to `4` if upstream fallbacks do not provide a value, and `5` will never be used. In practice this is utilized when `Arg(default=4)` is provided. This is distinct but similar to `Default() | 4 | 5` (which uses `fallback_to`), which would resolve to `Default((), default=5)`, the 4 being overwritten and never used. T)explicit fallback_to)clsrs r from_valuezDefault.from_value0su  4 88r"c\|D]!}|tus tj|cS|S)zReturn a `Default` instance from a sequence of potential defaults. This is used to compose different levels of default sources (Arg.default versus normalization time defaults). )rrr()r'defaultsrs r fallback_fromzDefault.fallback_from@s0 Ge#))'22 u r"c>t|}t||r+|g|j|jd|jiSt|tr|j}|jt urt|t r |j}t|trtj|}t|trtj|}|g|j|d|iS|r|g|jt|S||jd|iS)aProduce a new Default from the current default and a supplied alternative. Examples: >>> Default(Env("FOO")).fallback_to(5) Default(sequence=(Env(env_vars=('FOO',), ...),), default=5) >>> Default(Env("FOO")).fallback_to(5, explicit=True) Default(sequence=(Env(env_vars=('FOO',), ...), Value(value=5)), default=<_EmptyEnum.EMPTY: 0>) r)type isinstancerr default_typesrEnv PromptTypePrompt from_prompt ConfirmTypeConfirm from_confirmValue)rotherr$r'rs r r&zDefault.fallback_toMs4j eS !N NN N N e] +llG||u$E3)?--%,**51%-,,U3> >u>g> > 4 4uU|4 4DMM1511r"c$|j|S)zCompose two potential defaults, returning a new one. For example, `Default() | Prompt('...') | Env('FOO') | 5`. See `fallback_to` for details. r%rr8s r __or__zDefault.__or__ms &&r"Nc|jD][}t|tr ||}n't|ttfr ||}n|}|t usM|j |fcS|jt uryd|jfS)zMEvaluate the default retrieval sequence, returning the first non-Empty value.)state)input)TNT)rr. ValueFromr2r5r is_parsedr)rr=r>rvalues r __call__zDefault.__call__ts}}G'9-e,Gfg%67e, E!((%//% <<5 T\\!!r"cD|j xr|jtuS)z@Whether the default instance **has** a default or if it's Empty.)rrrrs r has_valuezDefault.has_values== :T\\U%::r"cPtd|jD|jS)Nc3VK|]!}t|ts|j#ywN)r.r7rA).0ds r z)Default.fallback_value..s Dmz!U/CQWWms)))nextrrrDs r fallback_valuezDefault.fallback_values! Ddmm Ddll  r")r DefaultTypesrr)rrreturnr)r*z Default | EmptyType | Any | NonerOr)F)r8zDefaultTypes | Anyr$boolrOr)r8rrOr)NN)r=State[Any] | Noner> TextIO | NonerOztuple[bool, Any])rOrP)rOr)__name__ __module__ __qualname____doc__r__annotations__rrr! classmethodr(r+r&r;rBpropertyrErMrr"r rrs )+H%*$G_$?D5 9 9  2@'GK"&"6C" "(;;  r"rc,eZdZUdZded<ddZddZy) DefaultTypeFClassVar[bool]r@cyrHr)r___s r rBzDefaultType.__call__s3r"ct||zSrH)rr:s r r;zDefaultType.__or__st}u$$r"N)r^rr_rrOr)r8rNrOr)rSrTrUr@rWrBr;rr"r r[r[s %I~%6%r"r[cJeZdZUdZded<eZded<ed d dZd dZy ) r0a{Lazily evaluates environment variables in the order given. Argument value interpolation will handle and `Arg`'s default being an `Env` instance, by evaluating the `Env`, in the event the parser-level value fell back to the default. Examples: >>> from cappa import Arg, Env >>> arg = Arg(default=Env("HOST", "HOSTNAME", default="localhost")) ztuple[str, ...]env_varsstr | EmptyType | Nonerrchtj|d|g|tj|d|y)Nrbrr)renv_varrrbs r r!z Env.__init__s0 4g-A-AB4G4r"c|jD]}tj|}||cS|jtS|jSrH)rbosgetenvrr)rrerAs r rBz Env.__call__sD}}GIIg&E  % << L||r"N)restrrbrirrc)rOrc) rSrTrUrVrWrrr!rBrr"r r0r0sC &+G #+OT55'*55K5 r"r0c8eZdZdZeddZddfd ZxZS)r2zPrompt the user for a value, returning the response. Examples: >>> from cappa import Arg, Prompt >>> arg = Arg(default=Prompt("Ask user for value")) ct||r|S||j|j|j|j|j |j SN)consolepromptpasswordchoices show_default show_choicesr.rmrnrorprqrr)r'rns r r3zPrompt.from_promptsL fc "MNN==__NN,,,,   r"c.t|t|SN)rstreamsuperrBrrr> __class__s r rBzPrompt.__call__we<rR)rSrTrUrVrXr3rB __classcell__rzs@r r2r2&    ==r"r2c8eZdZdZeddZddfd ZxZS)r5zPrompt the user for a confirmation, returning `True`/`False`. Examples: >>> from cappa import Arg, Confirm >>> arg = Arg(default=Confirm("Confirm with user")) ct||r|S||j|j|j|j|j |j Srlrs)r'confirms r r6zConfirm.from_confirmsN gs #NOO>>%%OO -- --   r"c.t|t|Srurwrys r rBzConfirm.__call__r{r")rzConfirm | ConfirmTyperOr rHr|)rSrTrUrVrXr6rBr}r~s@r r5r5rr"r5c0eZdZUded<dZded<dd dZy) r7rrATr\r@Nc|jSrH)rA)rr=s r rBzValue.__call__s zzr"rHr=rQ)rSrTrUrWr@rBrr"r r7r7s J $I~$r"r7cFeZdZUdZded<ded<dZded<d d Zd dd Zy )r?aRetrieve the default value by calling the provided function. Optionally, `*args` and `**kwargs` to the supplied function can be provided ahead of time, to be supplied in the event the function is called. Examples: >>> from cappa import Arg, ValueFrom >>> def from_file(name): ... with open(name) as f: ... return f.read() >>> >>> arg = Arg(default=ValueFrom(from_file, name="config.json")) Callable[..., Any]callablezdict[str, Any]kwargsTr\r@c `tj|d|tj|d|y)Nrrr)rrrs r r!zValueFrom.__init__s&4X6462r"Ncddlm}|j}|r7t|i}||j|d}i|j|j}|jdi|S)Nr) fulfill_depsT) allow_emptyr)cappa.invoke.baserrrr)rr=rrdepsresolveds r rBzValueFrom.__call__sW2 ).D#DMM4TJH774;;7Ft}}&v&&r")rrrrrHr)rSrTrUrVrWr@r!rBrr"r r?r?s) !  $I~$3 'r"r?cXeZdZUdZded<dZded<ed dZed dZd dd Z y )DefaultFormatterz {default}riformatTz bool | Noneshowc|dS)NFrr)r's r disabledzDefaultFormatter.disabled%s r"ctt||r|St|tr ||S|t|S)N)rr)r.rirP)r'rAs r from_unknownzDefaultFormatter.from_unknown)s5 eS !L eS !e$ $U $$r"c|jdury|j}|dtfvrd}|jj|}|dk(r|S|j|S)NFr)rrMrr)rrdefault_formatdefault_raw_valuedefault_formatted_values r format_defaultzDefaultFormatter.format_default3sk 99 #22 u - " "&++"4"4=N"4"O "b (* *$$-D$EEr"N)rOr )rAzstr | bool | SelfrOr )r)rrrrirOri) rSrTrUrrWrrXrrrrr"r rr sBFCD+%% Fr"rrrN)( __future__rrg dataclassesrtypingrrrrr r r r rich.promptrichtyping_extensionsr rr cappa.statercappa.type_viewrrrrr[r0rnr2r5r7r?rr1r4r/rNrWrr"r rs" !   66, CL $w w w t%(%% $+@=T[[  =2=dkk!!;=2 $K $!' !'!'H FF FD[[   kk!! ##T[[%8%8#yI  [$++,,dkk.A.AA ir"