iNA dZddlZddlZddlZddlZddlmZmZmZm Z ddl m Z ddl m Z ddlmZmZmZmZddlmZmZedZerdd lmZdd lmZdd lmZndd lmZej8ed ZddlmZGddeZ Gdde Z!Gdde!Z"de#deeegeeffdZ$de%fdZ&de%fdZ'ddezeezde(edffdZ)ddezeezde*efdZ+ddezeezde(edfdzfd Z,dedefd!Z-d"ded#zezdedzfd$Z.d%e#de#fd&Z/d%e#de#fd'Z0d(e ed)e1dee(edffd*Z2d+d,d-e#de%fd.Z3d/ede%fd0Z4d1Z5eGd2d3Z6d=d4d5d6e1de#fd7Z7d>d8Z8d9e#de(e1dffd:Z9d;e#fd<Z:y)?z^To prevent circular dependencies, this module should never import anything else from Cyclopts.N)CallableIterableIteratorSequence)suppress) itemgetter) TYPE_CHECKINGAnyLiteralTypeVar)fieldfrozenT)JSONDecodeError)rConsole)defineT) unsafe_hash)stdlib_module_namesc*eZdZdefdZdedfdZy) SentinelMetareturnc"d|jdS)N<>)__name__clss t/home/jay/workspace/.worktrees/task-2116-dev1/scripts/.codegraph-venv/lib/python3.12/site-packages/cyclopts/utils.py__repr__zSentinelMeta.__repr__s3<<.""Fcy)NFrs r__bool__zSentinelMeta.__bool__"sr!N)r __module__ __qualname__strr r r$r#r!rrrs##r!rceZdZdZy)Sentinelctd)NzGSentinel objects are not intended to be instantiated. Subclass instead.) ValueErrorrs r__new__zSentinel.__new__'sbccr!N)rr%r&r,r#r!rr)r)&sdr!r)) metaclassceZdZdZy)UNSETzTSpecial sentinel value indicating that no data was provided. **Do not instantiate**.N)rr%r&__doc__r#r!rr/r/+s^r!r/targetrcHdttdttffd }|S)zJClass decorator that records init argument names as a tuple to ``target``.rrc|jtj}td|jDt j fd}||_|S)Nc3,K|] }|dk7s |yw)selfNr#).0names r z1record_init..decorator..5s]TdV\nD]s c |g|i|tj|tfdtt |Dt|zy)Nc3(K|] }| ywNr#)r6i param_namess rr8zCrecord_init..decorator..new_init..;s2\a;q>2\s)object __setattr__tuplerangelen)r5argskwargs original_initr=r1s rnew_initz0record_init..decorator..new_init7sJ $ 0 0 0   tVU2\5QTUYQZK[2\-\_dek_l-l mr!)__init__inspect signaturer@ parameters functoolswraps)rfunction_signaturerFrEr=r1s @@r decoratorzrecord_init..decorator2s_ $..}=]-?-J-J]]  ' n ( n    r!)typer)r1rNs` r record_initrP/s& tAw 47  r!ct|ttztztzryt|t  xrt|t S)NT) isinstancelistr@setdictr'robjs r is_iterablerXCs9#te|c)D01#s# # A 3(AAr!ch tj|xr t||S#t$rYywxYw)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)rHisclass issubclass TypeError)hint target_classs ris_class_and_subclassr_Is4t$GD,)GG s "% 11value.c:|yt|r t|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. r#)rXr@r`s rto_tuple_converterrc_s%  } U U|xr!c*tt|Sr;)rSrcrbs rto_list_converterrews "5) **r!c$|y|syt|S)zsConvert a string or Iterable or None into an Iterable or None. Intended to be used in an ``attrs.Field``. Nr#)rcrbs roptional_to_tuple_converterrg{s  }  e $$r!cV|tStj|r t|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. )r/rH isgeneratornextrbs rsort_key_converterrks+ }   U #E{ r! input_value)defaultplainc|yt|tr3|dk(r ddlm}|S|dk(r ddlm}|St d|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. Nrmr)DefaultFormatterrn)PlainFormatterzUnknown formatter: z. Must be 'default' or 'plain')rRr'cyclopts.help.formattersrprqr+)rlrprqs rhelp_formatter_converterrss]& K % ) # A#% % G # ?!# #2;/A_`a ar!sctjdd|}tjdd|}tjdd|}|jS)Nz([A-Z]+)([A-Z][a-z])cL|jdd|jdSN_groupms rz"_pascal_to_snake..s! Aaggaj\6Rr!z([a-z])([A-Z])cL|jdd|jdSrwr{r}s rrz"_pascal_to_snake..!1771:,a |0Lr!z([0-9])([A-Z])cL|jdd|jdSrwr{r}s rrz"_pascal_to_snake..rr!)resublower)rtsnakes r_pascal_to_snakersM FF*,RTU VE FF$&Le TE FF$&Le TE ;;=r!crt|jjddjdS)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. ry-)rrreplacestrip)rts rdefault_name_transformrs0, A  $ $ & . .sC 8 > >s CCr!iterablenctt||zrt|d|dt|g|z}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)rBr+iterzip)rr iteratorss rgrouperrsJ 8}qH<'2('" 8 89W% 1' KD KF KL( )Xr!cneZdZUdZeed< eeZeed< eed< e de dde dfdZ y ) SortHelperzLSort a list of objects by an external key and retrieve the objects in-order.key) converter fallback_keyr`entriesrcjddlm}m}m}g}g}g}g}g}g} |D]} | j|ur|j d| f&| j|ur|j d| fH| j|ur|j d| fj| jt dfvr| j | j| ft| jrE| jdt dfvr.|j | jdd| jz| f|j | j| jf| f!|jtd|jtd| jtd||z|z|z|z| z} | D cgc]} | d c} Scc} w)z(Sorts a sequence of :class:`SortHelper`.r)#DEFAULT_ARGUMENTS_GROUP_SORT_MARKER"DEFAULT_COMMANDS_GROUP_SORT_MARKER$DEFAULT_PARAMETERS_GROUP_SORT_MARKERNrx)r) cyclopts.grouprrrrrr/rrXsortr) rrrrdefault_commands_groupdefault_arguments_groupdefault_parameters_group user_sort_keyordered_no_user_sort_keyno_user_sort_keyentrycombinedxs rrzSortHelper.sortIs  "$"$#%  #%  OEyy>>&--tUm<AA'..e}=BB(//u >udm+ ''););U(CDUYY'EIIaLUDM,I)//12ASAS1SUZ0[\$$uyy%2D2D&Eu%MN O z!}- %%*Q-%8*Q-0 #% && ' '  '    ''!'''s! F0N) rr%r&r0r __annotations__r rcr staticmethodrrSrr#r!rrr8sZV H (:;L#; JJ,(h|,,(l1C,(,(r!r decode_errorrcontextc Z|jj}||jdz }|jdz }||z }|dkrd}d}|}nd}||z }||z}|t |k\rt |dz}d} nd} |||} dt ||zzdz} 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 rxrrz... z ... ^zJSONDecodeError: z  )doc splitlineslinenocolnorBr') rrlinesline error_indexstartprefix_ellipsissegment_error_indexendsuffix_ellipsissegment carat_pointerresponses rjson_decode_error_verbosifierrys    ' ' )E $$q( )D$$q(K ' !E z) )E1  C c$i$i!m 5oG3/2EEFLM ! 1'?:K6R_Q``bcfgsctbuv  Or!c "ddlm}|jxsd}|diddd|dt|dd d |jxsd d |j xsd d |j d |jdt|dd d|jdt|dddt|dddt|dd dt|ddd|jd|jd|jdt|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)consolerrs r!create_error_console_from_consolersk%''16L   ! w(94@ ((0D   "008D   ##  nn w 40 !! w 40 gx. g'7> '<6 !! --  !!! "*d3# $Wnd;% &*d3' r!version_stringcJtfd|jdDS)aIParse a PEP 440 version string into a tuple of ints, stripping pre-release suffixes. Parameters ---------- version_string: str A version string like ``"2.11.2"`` or ``"2.0.0b2"``. Returns ------- tuple[int, ...] Tuple of the numeric components, e.g. ``(2, 11, 2)`` or ``(2, 0, 0)``. c3K|]6}tjd|xstj8yw)z\d+N)rmatchintr|)r6rr~s rr8z parse_version..s2aABHHU[]^L_G_qG_QWWYas??r)r@r)rr~s @r parse_versionrs! a)=)=c)Ba aar! module_pathc6ddlm}d|vr|jdd\}}n|d}} tj|}|rGt ||std|d |d t||}t||std |d |Sd D]}t||d}t||s|cSt|D]0}|jd rt||}t||s.|cStd|d|d#t $r}t d|d||d}~wwxYw)auImport a Cyclopts App from a module path. Parameters ---------- module_path : str Module path in format "module.name" or "module.name:app_name". If ":app_name" is omitted, auto-discovers by searching for common names (app, cli, main) or any public App instance. Returns ------- App The imported Cyclopts App instance. Raises ------ ImportError If the module cannot be imported. AttributeError If the specified app name doesn't exist or no App is found. TypeError If the specified attribute is not a Cyclopts App instance. r)App:rxNzCannot import module 'z': zModule 'z' has no attribute ''z ' is not a Cyclopts App instance)appclimainryzNo Cyclopts App found in 'z'. Specify explicitly: 'z :app_name') cycloptsrrsplit importlib import_module ImportErrorhasattrAttributeErrorrrRr\dirr) rr module_nameapp_namemoduleerr7rWs r import_apprsZ0 k + 2 23 : X +TX O((5vx( 8K=8LXJVW!XY Yfh'#s#az)IJK K 'fdD) c3 J F s#&$'C#s#  5k]BZ[fZggqr ss1 O2;-s1#FGQNOsC88 DDD))rrrr);r0rKrrHrcollections.abcrrrr contextlibroperatorrtypingr r r r attrsr rrjsonrrrrpartialsysrrOrr)r/r'rPboolrXr_r@rcrSrergrkrsrrrrrrrrrrrrr#r!rrskd BB77 CL$$ Y  v4 8F#4dd _H_$q'DG); <(BB ,dSj8C=8U38_0+TCZ(3-7+DI+ %tczHSM'A %eCQTHoX\F\ %cc*" 233c9"4Z"JDcDcD2)hsm))sCx0I)$16!#!$!>OCODO8=(=(=(@"0A"C"Y\"J%P b# b%S/ b 9tC9tr!