lKjD dZddlZddlZddlZddlZddlmZmZmZm Z ddl m Z ddl m Z ddlmZmZmZmZddlmZmZedZerdd lmZdd lmZdd lmZdd lmZndd lmZej<edZddlm Z Gdde!Z"Gdde"Z#Gdde#Z$de%dee!ege!effdZ&de'fdZ(de'fdZ)ddezeezde*edffdZ+ddezeezde,efd Z-ddezeezde*edfdzfd!Z.dedefd"Z/ d=d#Z0d$e%de%fd%Z1d$e%de%fd&Z2d'e ed(e3dee*edffd)Z4d*d+d,e%de'fd-Z5de6de%fd.Z7d/ede'fd0Z8d1Z9eGd2d3Z:d>d4d5d6e3de%fd7Z;d?d8Zy)@z^To prevent circular dependencies, this module should never import anything else from Cyclopts.N)CallableIterableIteratorSequence)suppress) itemgetter) TYPE_CHECKINGAnyLiteralTypeVar)fieldfrozenT)JSONDecodeError)rConsole) HelpFormatter)defineT) unsafe_hash)stdlib_module_namesc*eZdZdefdZdedfdZy) SentinelMetareturnc"d|jdS)N<>)__name__clss _/Users/ahmed/devFolder/Ultron/claude-voice/.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"r rr s##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"r r*r*(sdr"r*) metaclassceZdZdZy)UNSETzTSpecial sentinel value indicating that no data was provided. **Do not instantiate**.N)rr&r'__doc__r$r"r r0r0-s^r"r0targetrcHdttdttffd }|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..7s]-JTdV\nD-Js c |g|i|tj|tfdtt |Dt|zy)Nc3(K|] }| ywNr$)r7i param_namess r r9zCrecord_init..decorator..new_init..=s2\K[a;q>K[s)object __setattr__tuplerangelen)r6argskwargs original_initr>r2s r new_initz0record_init..decorator..new_init9sJ $ 0 0 0   tVU2\5QTUYQZK[2\-\_dek_l-l mr")__init__inspect signaturerA parameters functoolswraps)rfunction_signaturerGrFr>r2s @@r decoratorzrecord_init..decorator4s_ $..}=]-?-J-J]]  ' n ( n    r")typer)r2rOs` r record_initrQ1s& tAw 47  r"ct|ttztztzryt|t  xrt|t S)NT) isinstancelistrAsetdictr(robjs r is_iterablerYEs9#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)rIisclass issubclass TypeError)hint target_classs r is_class_and_subclassr`Ks4t$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$)rYrAras r to_tuple_converterrdas%  } U U|xr"c*tt|Sr<)rTrdrcs r to_list_converterrfys "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$)rdrcs r optional_to_tuple_converterrh}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. )r0rI isgeneratornextrcs r sort_key_converterrls+ }   U #E{ r"c|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. Ndefaultr)DefaultFormatterplain)PlainFormatterzUnknown formatter: z. Must be 'default' or 'plain')rSr(cyclopts.help.formattersrorqr,) input_valuerorqs r help_formatter_converterrts]& K % ) # A#% % G # ?!# #2;/A_`a ar"sctjdd|}tjdd|}tjdd|}|jS)Nz([A-Z]+)([A-Z][a-z])cL|jdd|jdSN_groupms r z"_pascal_to_snake..s Aaggaj\6Rr"z([a-z])([A-Z])cL|jdd|jdSrxr|r~s r rz"_pascal_to_snake..1771:,a |0Lr"z([0-9])([A-Z])cL|jdd|jdSrxr|r~s r rz"_pascal_to_snake..rr")resublower)rusnakes 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. rz-)rrreplacestrip)rus r default_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)rCr,iterzip)rr iteratorss r grouperrsJ 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_keyraentriesrcjddlm}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_MARKERNry)r) cyclopts.grouprrrrrr0rrYsortr) rrrrdefault_commands_groupdefault_arguments_groupdefault_parameters_group user_sort_keyordered_no_user_sort_keyno_user_sort_keyentrycombinedxs r rzSortHelper.sort[s  "$"$#%  #% Eyy>>&--tUm<AA'..e}=BB(//u >udm+ ''););U(CDUYY'EIIaLUDM,I)//12ASAS1SUZ0[\$$uyy%2D2D&Eu%MN z!}- %%*Q-%8*Q-0 #% && ' '  '    ''h!h'''s! F0N) rr&r'r1r __annotations__r rdr staticmethodrrTrr$r"r rrJsZV 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 ryrrz... z ... ^zJSONDecodeError: z  )doc splitlineslinenocolnorCr() rrlinesline error_indexrprefix_ellipsissegment_error_indexendsuffix_ellipsissegment carat_pointerresponses r json_decode_error_verbosifierrs    ' ' )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})r7rrs r r9z parse_version..s5a)BABHHU[]^L_G_qG_QWWY)Bs??r)rAr)rrs @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)ApprryNzCannot import module 'z': zModule 'z' has no attribute ''z ' is not a Cyclopts App instance)appclimainrzzNo Cyclopts App found in 'z'. Specify explicitly: 'z :app_name') cycloptsr rsplit importlib import_module ImportErrorhasattrAttributeErrorrrSr]dirr) rr  module_nameapp_namemoduleer r8rXs r import_apprsP0 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)rsz2None | Literal['default', 'plain'] | HelpFormatterrzHelpFormatter | None))rrrr)?r1rLrrIrcollections.abcrrrr contextlibroperatorrtypingr r r r attrsr rrjsonrrrcyclopts.help.protocolsrrpartialsysrrPrr*r0r(rQboolrYr`rArdrTrfrhrlrtrrrrrslicerrrrrrrrr$r"r r(snd BB77 CL$$5 Y  v4 8F#4dd _H_$q'DG); <(BB ,dSj8C=8U38_0+TCZ(3-7+DI+ %tczHSM'A %eCQTHoX\F\ %cc*"E""JDcDcD2)hsm))sCx0I)$16$!#$!$$!NSOCODO8=(=(=(@"0A"C"Y\"J%P b# b%S/ b 9tC9tr"