iYdZddlmZddlZddlmZmZmZmZm Z m Z m Z m Z m Z mZmZmZmZmZddlmZmZmZddlmZmZddlmZmZmZmZm Z m!Z!d d l"m#Z$d d l%m&Z&m'Z'm(Z(d d l)m*Z*d d l+m,Z,m-Z.erIddl/m0Z0ddl1m2Z2ddlm3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9d dl:m;Z;d dl"mZ>ddl?m@Z@eede3fge3fZAededdZBedddZCd ZDGddeeCZ#dS)a: The MIT License (MIT) Copyright (c) 2015-present Rapptz Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ) annotationsN) TYPE_CHECKINGAnyCallableClassVarDict GeneratorListLiteralOptionalSequenceTypeTypeVarUnionoverload)ItemContainedItemCallbackType _ItemCallback)Buttonbutton)selectSelect UserSelect RoleSelect ChannelSelectMentionableSelect) ActionRow) ButtonStyle ComponentType ChannelType) PartialEmoji)MISSINGget)Self) LayoutView) BaseSelectTValidDefaultValuesMentionableSelectTChannelSelectT RoleSelectT UserSelectTSelectT)Emoji) SelectOption) Container) DynamicItemS)rr1r'T)bound covariantVr'c eZdZUdZgZded<dZded<dZddddfdZdefd Z dfdZ dgdZ dedZ dhdZ dhdZdZdidZdjd!Zed"Zedkd$Zedld&Zedmd(Zdnd*Zdkd+Zdod/Zdod0Zdpd2Zdqd3Zdrd5Zddd6ejddd7dsd@Z e!e"e#e$dAdAdAdAdAdAdAdB dtdMZ%e!e&e#e$dAdAdAdAdAdAdAdAdN dudSZ%e!e'e#e$dAdAdAdAdAdAdAdAdN dvdVZ%e!e(e#e$dAdAdAdAdAdAdAdAdN dwdYZ%e!e)e#e$e$dAdAdAdAdAdAdAdN dxd\Z%e"e#e$e$de$d]d]d6e$ddN dyd`Z%e*dzdcZ+xZ,S){raRepresents a UI action row. This is a top-level layout component that can only be used on :class:`LayoutView` and can contain :class:`Button`\s and :class:`Select`\s in it. Action rows can only have 5 children. This can be inherited. .. versionadded:: 2.6 Examples -------- .. code-block:: python3 import discord from discord import ui # you can subclass it and add components with the decorators class MyActionRow(ui.ActionRow): @ui.button(label='Click Me!') async def click_me(self, interaction: discord.Interaction, button: discord.ui.Button): await interaction.response.send_message('You clicked me!') # or use it directly on LayoutView class MyView(ui.LayoutView): row = ui.ActionRow() # or you can use your subclass: # row = MyActionRow() # you can add items with row.button and row.select @row.button(label='A button!') async def row_button(self, interaction: discord.Interaction, button: discord.ui.Button): await interaction.response.send_message('You clicked a button!') Parameters ---------- \*children: :class:`Item` The initial children of this action row. id: Optional[:class:`int`] The ID of this component. This must be unique across the view. z+ClassVar[List[ItemCallbackType[Self, Any]]]__action_row_children_items__TzClassVar[bool]__discord_ui_action_row__idNchildrenItem[V]r; Optional[int]returnNonec6t||_t d|jD|_|D]}|||jdkrtd||_dS)Nc3$K|] }|jV dSN)width).0is V/usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages/discord/ui/action_row.py z%ActionRow.__init__..s$@@A@@@@@@#maximum number of children exceeded) super__init___init_children _childrensum_weightadd_item ValueErrorr;)selfr;r<child __class__s rGrMzActionRow.__init__~s (,(;(;(=(=@@@@@@@  ! !E MM% ??,%+HTN , x==1  HII I,01B1B,C,C)))rIstrcLd|jjdt|jdS)N)rV__name__r_rOrTs rG__repr__zActionRow.__repr__s*L4>*LLc$.6I6ILLLLrIList[Item[Any]]cg}|jD]\}|jdi|j}t||||_||_t ||j|||]|S)N) r8rX__discord_ui_model_kwargs__rcallback_parentsetattrrkappend)rTr<funcitems rGrNzActionRow._init_childrens|6 " "D77[[$:Z[[D)$d;;DMDL D$- . . . OOD ! ! ! !rIc6||_|jD] }||_ dSrC)_viewrO)rTviewrUs rG _update_viewzActionRow._update_views- ^  EEKK  rI ActionRow[V]cLtj|}g}|jD]X}|}||_t|jt r ||j_||Y||_|j|_||j |SrC) copyrOrs isinstancerrrparentrur{rz)rTnewr<rUnewchs rGr~zActionRow.copysioo] # #EJJLLEEM%.-88 ,(+% OOE " " " "  l  ### rIc*|SrC)r~)rTmemos rG __deepcopy__zActionRow.__deepcopy__syy{{rIcdSNTrprls rG _has_childrenzActionRow._has_childrenstrIboolcdSrrprls rG_is_v2zActionRow._is_v2s trIrdrrr2 custom_idcN|j|}||j|<dSrC)rOindex)rTrdrr child_indexs rG _swap_itemzActionRow._swap_items)n**400 &){###rIcdS)NrJrprls rGrDzActionRow.widthsqrIintc0dt|jzS)Nr)r_rOrls rG _total_countzActionRow._total_counts3t~&&&&rI!Literal[ComponentType.action_row]ctjSrC)r! action_rowrls rGtypezActionRow.types ''rI List[Item[V]]c4|jS)zFList[:class:`Item`]: The list of children attached to this action row.)rOr~rls rGr<zActionRow.childrens~""$$$rIGenerator[Item[V], Any, None]c#$K|jEd{VdS)zAn iterator that recursively walks through all the children of this action row and its children, if applicable. Yields ------ :class:`Item` An item in the action row. N)r<rls rG walk_childrenzActionRow.walk_childrens(=         rIcPddlmtfd|jDS)zN:class:`int`: Returns the total length of all text content in this action row.r) TextDisplayc3`K|](}t|t|jV)dSrC)rr_content)rErwrs rGrHz+ActionRow.content_length..s=aa:dT_C`C`a3t|$$aaaaaarI) text_displayrrPrO)rTrs @rGcontent_lengthzActionRow.content_lengths:------aaaaaaaaaarIrw Item[Any]r&c|j|jzdkrtdt|jdkrtdt |t std|jj |j r|j d| |j ||_|xjdz c_|j||S)aAdds an item to this action row. This function returns the class instance to allow for fluent-style chaining. Parameters ---------- item: :class:`Item` The item to add to the action row. Raises ------ TypeError An :class:`Item` was not passed. ValueError Maximum number of children has been exceeded (5) or (40) for the entire view. rJrKzexpected Item not r)rQrDrSr_rOrrr`rVrkry _add_countr{rzrsrurTrws rGrRzActionRow.add_items( L4: % * *BCC C t~  ! # #BCC C$%% LJ1HJJKK K : % J ! !! $ $ $ $)$$$    d### rIc |j||jr|jd|xjdzc_n#t $rYnwxYw|S)aRemoves an item from the action row. This function returns the class instance to allow for fluent-style chaining. Parameters ---------- item: :class:`Item` The item to remove from the action row. r)rOremoveryrrQrSrs rG remove_itemzActionRow.remove_itemsz  N ! !$ ' ' 'z * %%b))) LLA LLL     D  sA AAOptional[Item[V]]cHt||S)axGets an item with :attr:`Item.id` set as ``id``, or ``None`` if not found. .. warning:: This is **not the same** as ``custom_id``. Parameters ---------- id: :class:`int` The ID of the component. Returns ------- Optional[:class:`Item`] The item found, or ``None``. r:) _utils_getr)rTr;s rG find_itemzActionRow.find_item1s#$$,,..26666rIc|jr-|jt|j |jd|_|S)zRemoves all items from the action row. This function returns the class instance to allow for fluent-style chaining. r)ryrr_rOclearrQrls rG clear_itemszActionRow.clear_itemsEsQ : 8 J ! !3t~#6#6"6 7 7 7   rIDict[str, Any]cg}|jD])}||*|jj|d}|j |j|d<|S)N)r componentsr;)r<ruto_component_dictrvaluer;)rTr componentrds rGrzActionRow.to_component_dictQsm  = =I   i99;; < < < <IO$   7 DJ rIF)labelrdisabledstyleemojir;r Optional[str]rrr r)Optional[Union[str, Emoji, PartialEmoji]]5Callable[[ItemCallbackType[S, Button[V]]], Button[V]]c,dfd }|S)azA decorator that attaches a button to the action row. The function being decorated should have three parameters, ``self`` representing the :class:`discord.ui.ActionRow`, the :class:`discord.Interaction` you receive and the :class:`discord.ui.Button` being pressed. .. note:: Buttons with a URL or a SKU cannot be created with this function. Consider creating a :class:`Button` manually and adding it via :meth:`ActionRow.add_item` instead. This is beacuse these buttons cannot have a callback associated with them since Discord does not do any processing with them. Parameters ---------- label: Optional[:class:`str`] The label of the button, if any. Can only be up to 80 characters. custom_id: Optional[:class:`str`] The ID of the button that gets received during an interaction. It is recommended to not set this parameters to prevent conflicts. Can only be up to 100 characters. style: :class:`.ButtonStyle` The style of the button. Defaults to :attr:`.ButtonStyle.grey`. disabled: :class:`bool` Whether the button is disabled or not. Defaults to ``False``. emoji: Optional[Union[:class:`str`, :class:`.Emoji`, :class:`.PartialEmoji`]] The emoji of the button. This can be in string form or a :class:`.PartialEmoji` or a full :class:`.Emoji`. id: Optional[:class:`int`] The ID of the component. This must be unique across the view. .. versionadded:: 2.6 rvItemCallbackType[S, Button[V]]r?c Ttd|}|_|S)N)rrrrrrowr;)_button__discord_ui_parent__) rvretrrrr;rrTrs rG decoratorz#ActionRow.button..decoratorsN'#!C)-C %JrI)rvrr?rrp)rTrrrrrr;rs``````` rGrzActionRow.button^sN\            rI.) rcoptions channel_types placeholderr min_values max_valuesrr;rc Type[SelectT]rList[SelectOption]rList[ChannelType]rrr#SelectCallbackDecorator[S, SelectT]c dSrCrp) rTrcrrrrrrrr;s rGrzActionRow.selects /2crI) rcrrrrrrrdefault_valuesr;Type[UserSelectT]rSequence[ValidDefaultValues]'SelectCallbackDecorator[S, UserSelectT]c dSrCrp rTrcrrrrrrrrr;s rGrzActionRow.select 36#rIType[RoleSelectT]'SelectCallbackDecorator[S, RoleSelectT]c dSrCrprs rGrzActionRow.selectrrIType[ChannelSelectT]*SelectCallbackDecorator[S, ChannelSelectT]c dSrCrprs rGrzActionRow.selects 69SrIType[MentionableSelectT].SelectCallbackDecorator[S, MentionableSelectT]c dSrCrprs rGrzActionRow.selects :=rIrType[BaseSelectT]'SelectCallbackDecorator[S, BaseSelectT]c < d  f d } | S)a&A decorator that attaches a select menu to the action row. The function being decorated should have three parameters, ``self`` representing the :class:`discord.ui.ActionRow`, the :class:`discord.Interaction` you receive and the chosen select class. To obtain the selected values inside the callback, you can use the ``values`` attribute of the chosen class in the callback. The list of values will depend on the type of select menu used. View the table below for more information. +----------------------------------------+-----------------------------------------------------------------------------------------------------------------+ | Select Type | Resolved Values | +========================================+=================================================================================================================+ | :class:`discord.ui.Select` | List[:class:`str`] | +----------------------------------------+-----------------------------------------------------------------------------------------------------------------+ | :class:`discord.ui.UserSelect` | List[Union[:class:`discord.Member`, :class:`discord.User`]] | +----------------------------------------+-----------------------------------------------------------------------------------------------------------------+ | :class:`discord.ui.RoleSelect` | List[:class:`discord.Role`] | +----------------------------------------+-----------------------------------------------------------------------------------------------------------------+ | :class:`discord.ui.MentionableSelect` | List[Union[:class:`discord.Role`, :class:`discord.Member`, :class:`discord.User`]] | +----------------------------------------+-----------------------------------------------------------------------------------------------------------------+ | :class:`discord.ui.ChannelSelect` | List[Union[:class:`~discord.app_commands.AppCommandChannel`, :class:`~discord.app_commands.AppCommandThread`]] | +----------------------------------------+-----------------------------------------------------------------------------------------------------------------+ Example --------- .. code-block:: python3 class MyView(discord.ui.LayoutView): action_row = discord.ui.ActionRow() @action_row.select(cls=ChannelSelect, channel_types=[discord.ChannelType.text]) async def select_channels(self, interaction: discord.Interaction, select: ChannelSelect): return await interaction.response.send_message(f'You selected {select.values[0].mention}') Parameters ------------ cls: Union[Type[:class:`discord.ui.Select`], Type[:class:`discord.ui.UserSelect`], Type[:class:`discord.ui.RoleSelect`], Type[:class:`discord.ui.MentionableSelect`], Type[:class:`discord.ui.ChannelSelect`]] The class to use for the select menu. Defaults to :class:`discord.ui.Select`. You can use other select types to display different select menus to the user. See the table above for the different values you can get from each select type. Subclasses work as well, however the callback in the subclass will get overridden. placeholder: Optional[:class:`str`] The placeholder text that is shown if nothing is selected, if any. Can only be up to 150 characters. custom_id: :class:`str` The ID of the select menu that gets received during an interaction. It is recommended not to set this parameter to prevent conflicts. Can only be up to 100 characters. min_values: :class:`int` The minimum number of items that must be chosen for this select menu. Defaults to 1 and must be between 0 and 25. max_values: :class:`int` The maximum number of items that must be chosen for this select menu. Defaults to 1 and must be between 1 and 25. options: List[:class:`discord.SelectOption`] A list of options that can be selected in this menu. This can only be used with :class:`Select` instances. Can only contain up to 25 items. channel_types: List[:class:`~discord.ChannelType`] The types of channels to show in the select menu. Defaults to all channels. This can only be used with :class:`ChannelSelect` instances. disabled: :class:`bool` Whether the select is disabled or not. Defaults to ``False``. default_values: Sequence[:class:`~discord.abc.Snowflake`] A list of objects representing the default values for the select menu. This cannot be used with regular :class:`Select` instances. If ``cls`` is :class:`MentionableSelect` and :class:`.Object` is passed, then the type must be specified in the constructor. Number of items must be in range of ``min_values`` and ``max_values``. id: Optional[:class:`int`] The ID of the component. This must be unique across the view. .. versionadded:: 2.6 rv ItemCallbackType[S, BaseSelectT]r?c Z t    |} |_|S)N) rcrrrrrrrrr;)_selectr) rvrrrcrrrr;rrrrrTs rGrz#ActionRow.select..decoratorBsW '#%%+!-     A'+A #HrI)rvrr?rrp) rTrcrrrrrrrrr;rs ``````````` rGrzActionRow.selectsfp                 rIrActionRowComponentcddlm}||j}|jD]!}||||"|S)Nr)_component_to_itemr:)rzrr;r<rR)rcrrrTcmps rGfrom_componentzActionRow.from_componentTsb,,,,,,sil###% 9 9C MM,,S$77 8 8 8 8 rI)r<r=r;r>r?r@)r?r@)r?rg)r?rn)r?r|)r?r)rdrrr2rrgr?r@)r?r)r?r)r?r)r?r)rwrr?r&)r;rr?r)r?r&)r?r)rrrrrrrr rrr;r>r?r)rcrrrrrrrrrgrrrrrrr;r>r?r)rcrrrrrrrrrgrrrrrrrrr;r>r?r)rcrrrrrrrrrgrrrrrrrrr;r>r?r)rcrrrrrrrrrgrrrrrrrrr;r>r?r)rcrrrrrrrrrgrrrrrrrrr;r>r?r)rcrrrrrrrrrgrrrrrrrrr;r>r?r)rrr?r)-rk __module__ __qualname____doc__r8__annotations__r9__item_repr_attributes__rMrYrmrNr{r~rrrrpropertyrDrrr<rrrRrrrrr secondaryrrrrr$rrrrr classmethodr __classcell__)rVs@rGrrOsz((TRT!SSSS044444& ! D D D D D DMMMM        ****X'''X'(((X(%%%X% ! ! ! !bbbb %%%%N.7777(         $#'(2;? ;;;;;;z$C[&-+.%( 2 2 2 2 2X 2",C&-+.%(7: 6 6 6 6 6X 6",C&-+.%(7: 6 6 6 6 6X 6%2#$6&-+.%(7: 9 9 9 9 9X 9):#(>&-+2%(7: = = = = =X =$"(&-+2%) 7> hhhhhhT[rIr)Er __future__rr~typingrrrrrr r r r r rrrrrwrrItemCallbackTyperrrrrrrrrrrrrrenumsr r!r" partial_emojir#utilsr$r%rtyping_extensionsr&rzr'r(r)r*r+r,r-r.rr/r0 containerr1dynamicr2SelectCallbackDecoratorr3r6__all__rprIrGrs0#""""" "UTTTTTTTTT--------gggggggggggggggg888888;;;;;;;;;;((((((........Z&&&&&&      ))))))$$$$$$$$$$$$&(8k9I(J'K['XY GCuCDPTUUU GC|t444 LLLLLQLLLLLrI