o i 8 @sdZddlZddlZddlZddlmZmZmZmZddl m Z ddl m Z ddl mZmZmZmZddlmZmZedZerSdd lmZdd lmZdd lmZn dd lmZejed dZddlmZGdddeZGdddedZ Gddde Z!de"deeegeeffddZ#de$fddZ%de$fddZ&ddeBeeBde'ed ffd!d"Z(ddeBeeBde)efd#d$Z*ddeBeeBde'ed fdBfd%d&Z+dedefd'd(Z,d)ded*BeBdedBfd+d,Z-d-e"de"fd.d/Z.d-e"de"fd0d1Z/d2eed3e0dee'ed ffd4d5Z1d6d7d8e"de$fd9d:Z2d;ede$fdd?Z4eGd@dAdAZ5dLdCdDdEe0de"fdFdGZ6dMdJdKZ7dS)Nz^To prevent circular dependencies, this module should never import anything else from Cyclopts.N)CallableIterableIteratorSequence)suppress) itemgetter) TYPE_CHECKINGAnyLiteralTypeVar)fieldfrozenT)JSONDecodeError)r Console)defineT) unsafe_hash)stdlib_module_namesc@s,eZdZdefddZdedfddZdS) SentinelMetareturncCsd|jdS)N<>)__name__clsrT/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/utils.py__repr__szSentinelMeta.__repr__FcCsdS)NFrrrrr__bool__!szSentinelMeta.__bool__N)r __module__ __qualname__strrr rrrrrrsrc@seZdZddZdS)SentinelcCstd)NzGSentinel objects are not intended to be instantiated. Subclass instead.) ValueErrorrrrr__new__&szSentinel.__new__N)rr r!r%rrrrr#%s r#) metaclassc@seZdZdZdS)UNSETzTSpecial sentinel value indicating that no data was provided. **Do not instantiate**.N)rr r!__doc__rrrrr'*sr'targetrcs"dttdttffdd }|S)zJClass decorator that records init argument names as a tuple to ``target``.rrcsH|jt}tdd|jDtfdd}||_|S)Ncss|] }|dkr|VqdS)selfNr).0namerrr 4sz1record_init..decorator..c sJ|g|Ri|t|tfddtt|Dt|dS)Nc3s|]}|VqdSNr)r+i) param_namesrrr-:szCrecord_init..decorator..new_init..)object __setattr__tuplerangelen)r*argskwargs) original_initr0r)rrnew_init6s4z0record_init..decorator..new_init)__init__inspect signaturer3 parameters functoolswraps)rfunction_signaturer9r))r8r0r decorator1s zrecord_init..decorator)typer)r)rBrrAr record_init.srDcCs0t|ttBtBtBr dSt|t ot|tS)NT) isinstancelistr3setdictr"robjrrr is_iterableBsrKcCs,z t|o t||WStyYdSw)acSafely check if a type is both a class and a subclass of target_class. Parameters ---------- hint : Any The type to check. target_class : type The target class to check subclass relationship against. Returns ------- bool True if hint is a class and is a subclass of target_class, False otherwise. F)r;isclass issubclass TypeError)hint target_classrrris_class_and_subclassHs  rQvalue.cCs"|durdSt|rt|S|fS)aConvert a single element or an iterable of elements into a tuple. Intended to be used in an ``attrs.Field``. If :obj:`None` is provided, returns an empty tuple. If a single element is provided, returns a tuple containing just that element. If an iterable is provided, converts it into a tuple. Parameters ---------- value: Any | Iterable[Any] | None An element, an iterable of elements, or None. Returns ------- tuple[Any, ...]: A tuple containing the elements. Nr)rKr3rRrrrto_tuple_converter^s rTcCs tt|Sr.)rFrTrSrrrto_list_convertervs rUcCs|durdS|s dSt|S)zsConvert a string or Iterable or None into an Iterable or None. Intended to be used in an ``attrs.Field``. Nr)rTrSrrroptional_to_tuple_converterzs rVcCs"|durtSt|rt|S|S)aBConvert sort_key value, consuming generators with :func:`next`. Parameters ---------- value : Any The sort_key value to convert. Can be None, a generator, or any other value. Returns ------- Any UNSET if value is None, ``next(value)`` if generator, otherwise value unchanged. N)r'r; isgeneratornextrSrrrsort_key_converters   rY input_value)defaultplaincCs^|durdSt|tr-|dkrddlm}|S|dkr%ddlm}|Std|d|S) aConvert string literals to help formatter instances. Parameters ---------- input_value : None | Literal["default", "plain"] | Any The input value to convert. Can be None, "default", "plain", or a formatter instance. Returns ------- Any | None None, or a HelpFormatter instance. Notes ----- Lazily imports formatters to avoid importing Rich during normal execution. Nr[r)DefaultFormatterr\)PlainFormatterzUnknown formatter: z. Must be 'default' or 'plain')rEr"cyclopts.help.formattersr]r^r$)rZr]r^rrrhelp_formatter_converters   r`scCs>tddd|}tddd|}tddd|}|S)Nz([A-Z]+)([A-Z][a-z])cS|dd|dSN_groupmrrrz"_pascal_to_snake..z([a-z])([A-Z])cSrbrcrgrirrrrkrlz([0-9])([A-Z])cSrbrcrgrirrrrkrl)resublower)rasnakerrr_pascal_to_snakesrqcCst|dddS)aConverts a python identifier into a CLI token. Performs the following operations (in order): 1. Convert PascalCase to snake_case. 2. Convert the string to all lowercase. 3. Replace ``_`` with ``-``. 4. Strip any leading/trailing ``-`` (also stripping ``_``, due to point 3). Intended to be used with :attr:`App.name_transform` and :attr:`Parameter.name_transform`. Parameters ---------- s: str Input python identifier string. Returns ------- str Transformed name. re-)rqroreplacestrip)rarrrdefault_name_transformsruiterablencCs<t||rt|d|dt|g|}t|ddiS)a-Collect data into non-overlapping fixed-length chunks or blocks. https://docs.python.org/3/library/itertools.html#itertools-recipes Parameters ---------- iterable: Sequence[Any] Some iterable sequence to group. n: int Number of elements to put in each group. z is not divisible by .strictF)r5r$iterzip)rvrw iteratorsrrrgroupers r}F) allow_numberstokencCs`|s+ttt||dkr WddS WddS1s&wY|dS)a8Checks if a token looks like an option. Namely, negative numbers are not options, but a token like ``--foo`` is. Parameters ---------- token: str String to interpret. allow_numbers: bool If :obj:`True`, then negative numbers (e.g. ``"-2"``) will return :obj:`True`. Otherwise, numbers will be interpreted as non-option-like (:obj:`False`). Note: ``-j`` **is option-like**, even though it can represent an imaginary number. Returns ------- bool Whether or not the ``token`` is option-like. z-jNTFrr)rr$complexro startswith)rr~rrris_option_likes   rrJcCst|ddddtvS)Nr rxr)getattrsplitrrIrrr is_builtinsrcOst|ttr |St|r||i|St|rWg}|D]6}t|ttr+||qt|r:|||i|qt|rM|t|g|Ri|q||qt|S|S)aRecursively resolves callable elements in a tuple. Returns an object that "looks like" the input, but with all callable's invoked and replaced with their return values. Positional and keyword elements will be passed along to each invocation. )rErCr#callablerKappendresolve_callablesr3)tr6r7resolvedelementrrrrs   rc@sXeZdZUdZeed< eedZeed< eed< e de dde dfdd Z d S) SortHelperzLSort a list of objects by an external key and retrieve the objects in-order.key) converter fallback_keyrRentriesrc CsLddlm}m}m}g}g}g}g}g}g} |D]b} | j|ur'|d| fq| j|ur4|d| fq| j|urA|d| fq| jtdfvrQ| | j| fqt| jro| jdtdfvro|| jdd| j| fq|| j| jf| fq|j t dd|j t dd| j t dd|||||| } dd| DS)z(Sorts a sequence of :class:`SortHelper`.r)#DEFAULT_ARGUMENTS_GROUP_SORT_MARKER"DEFAULT_COMMANDS_GROUP_SORT_MARKER$DEFAULT_PARAMETERS_GROUP_SORT_MARKERNrd)rcSsg|]}|dqS)rdr)r+xrrr usz#SortHelper.sort..) cyclopts.grouprrrrrr'rrKsortr) rrrrdefault_commands_groupdefault_arguments_groupdefault_parameters_group user_sort_keyordered_no_user_sort_keyno_user_sort_keyentrycombinedrrrrHsF    zSortHelper.sortN) rr r!r(r __annotations__r rTr staticmethodrrFrrrrrr7s  r decode_errorrcontextc Cs|j}||jd}|jd}||}|dkr d}d}|}nd}||}||}|t|kr9t|d}d} nd} |||} dt||d} d|| | d | d t|} | S) zNot intended to be a super robust implementation, but robust enough to be helpful. Parameters ---------- context: int Number of surrounding-character context rdrrz... z ... ^zJSONDecodeError: z  )doc splitlineslinenocolnor5r") rrlinesline error_indexstartprefix_ellipsissegment_error_indexendsuffix_ellipsissegment carat_pointerresponserrrjson_decode_error_verbosifierxs(      rconsolercCsddlm}|jp d}|diddd|dt|dd d |jp d d |jpyd d |jd |jdt|dd d|jdt|dddt|dddt|dd dt|ddd|j d|j d|j dt|dd dt|dd dt|dd Sd |jd |jdt|dd d|jdt|dddt|dddt|dd dt|ddd|j d|j d|j dt|dd dt|dd dt|dd S) a'Create an error console (stderr=True) that inherits settings from a source console. Parameters ---------- console : Console Source Rich Console to copy settings from. Returns ------- Console New Rich Console with stderr=True and inherited settings. rrautostderrT color_systemforce_terminal_force_terminalN force_jupyterforce_interactive soft_wrapwidthheight_heighttab_sizemarkup_markupemoji_emoji emoji_variant_emoji_variant highlight _highlightno_colorlegacy_windowssafe_box_environ get_datetimeget_timer) rich.consolerrr is_jupyteris_interactiver_widthrrrr)rrrrrr!create_error_console_from_consoles                     r)r)rrrr)8r(r>r;rmcollections.abcrrrr contextlibroperatorrtypingrr r r attrsr r rjsonrrrrpartialsysrrCrr#r'r"rDboolrKrQr3rTrFrUrVrYr`rqruintr}rrrrrrrrrrsT      $&"* % &@%