o ir @shddlZddlZddlZddlmZmZddlmZmZm Z m Z m Z m Z ddl mZejdkr6ddlmZnddlmZddlmZmZmZmZmZmZmZmZmZerfddlmZdd lmZdd l m!Z!d e d fd dZ"e#Z$GdddeZ%GdddeZ&GdddeZ'de(fddZ)eGdddZ*de+e*de+ede,e+e*e+effddZ-dS)N)CallableIterable) TYPE_CHECKINGAnyLiteralOptionalUnioncast)field) )Self) UNSETSentinel SortHelperfrozenhelp_formatter_converter is_iterableresolve_callablessort_key_converterto_tuple_converter)ArgumentCollection) HelpFormatter) ParametervaluercCs|durdS|jr tddS)Nz,Group default_parameter cannot have a group.)group ValueError)instance attributerrT/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/cyclopts/group.py%_group_default_parameter_must_be_none's r!c@ eZdZdS)"DEFAULT_COMMANDS_GROUP_SORT_MARKERN__name__ __module__ __qualname__rrrr r#4r#c@r")#DEFAULT_ARGUMENTS_GROUP_SORT_MARKERNr$rrrr r)8r(r)c@r")$DEFAULT_PARAMETERS_GROUP_SORT_MARKERNr$rrrr r*<r(r*valcCs|r|StSN)object)r+rrr _group_name_converter@sr.c@sheZdZUeddedZeed< dZeed<edddd Z e dBed <edd e dd Z e ed <edddddZdedge fBeedge fBed<ededdZeded<ededdZededdfed<edefddZeddZeddZed,defd!d"Zed-defd$d%Zed.defd'd(Z e  d/dddddd)defd*d+Z!dS)0Groupname)defaultalias converter_namehelpNshowT)r2r3kw_only_showsort_key)r2r3r4r8 _sort_keycCstttdft|S)N.)r tuplerr)xrrr `szGroup.)r2r4r8r validator)r2r?r8rdefault_parameter)r2plainrhelp_formatterreturncCst|jtur dS|jS)Nr0)typer5r-selfrrr r1nsz Group.namecCs|jdur t|jS|jSr,)r9boolr1rErrr r7rsz Group.showcCs|jturdS|jSr,)r;rrErrr r:vszGroup.sort_key ArgumentscC ||tdSN)r:)r)clsr1rrr create_default_argumentsz zGroup.create_default_arguments ParameterscCrIrJ)r*rKrrr create_default_parameters~rNzGroup.create_default_parametersCommandscCrIrJ)r#rKrrr create_default_commandsrNzGroup.create_default_commandsr7r:r?r@rBc Cs`tt}t|r t|}|durt|f}nt|r!t||f}n||f}||||||||dS)ayCreate a group with a globally incrementing :attr:`~Group.sort_key`. Used to create a group that will be displayed **after** a previously instantiated :meth:`Group.create_ordered` group on the help-page. Parameters ---------- name: str Group name used for the help-page and for group-referenced-by-string. This is a title, so the first character should be capitalized. If a name is not specified, it will not be shown on the help-page. help: str Additional documentation shown on the help-page. This will be displayed inside the group's panel, above the parameters/commands. show: bool | None Show this group on the help-page. Defaults to :obj:`None`, which will only show the group if a ``name`` is provided. sort_key: Any If provided, **prepended** to the globally incremented counter value (i.e. has priority during sorting). validator: None | Callable[[ArgumentCollection], Any] | Iterable[Callable[[ArgumentCollection], Any]] Group validator to collectively apply. default_parameter: cyclopts.Parameter | None Default parameter for elements within the group. help_formatter: cyclopts.help.protocols.HelpFormatter | None Custom help formatter for this group's help display. NrS)next_sort_key_counterinspect isgeneratorrrr<) rLr1r6r7r:r?r@rBcountrrr create_ordereds"&  zGroup.create_ordered)rH)rO)rQ)r0r0)"r%r&r'r r.r5str__annotations__r6r9rGrr;rr?rrr!r@rrrBrrpropertyr1r7r: classmethodr rMrPrRrYrrrr r/Ds`  .   r/groups attributesrCcCsjt|t|ks J|s||fStddt||ddD}tdd|Dddi\}}t|t|fS)aSort groups for the help-page. Note, much logic is similar to here and ``HelpPanel.sort``, so any changes here should probably be reflected over there as well. Parameters ---------- groups: list[Group] List of groups to sort by their ``sort_key``. attributes: list[Any] A list of equal length to ``groups``. Remains consistent with ``groups`` via argsort. cSs*g|]\}}tt|j||j||fqSr)rrr;r1).0rrrrr szsort_groups..F)strictcSsg|]}|jqSr)r)r`r=rrr rasrb)lenrsortziplist)r^r_sorted_entries out_groupsout_attributesrrr sort_groupss  rj).rV itertoolssyscollections.abcrrtypingrrrrrr attrsr version_infor typing_extensionscyclopts.utilsrrrrrrrrrcyclopts.argumentrcyclopts.help.protocolsrcyclopts.parameterrr!rXrUr#r)r*rZr.r/rfr<rjrrrr s.   ,    2{