cjha 0dZddlmZddlZddlZddlmZmZmZddl m Z ddl m Z m Z ddlmZdd lmZmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlm Z ddl!m"Z"ddl#m$Z$m%Z%dZ&erddl'm(Z(ddl)m Z*ddl+m,Z,ddl-m.Z.eddZ/edddZ0Gd de$e0Z1ejdejfejhejjejlfZ7ejdfdddde"e"d!dd" d,d#Z8dddde"d!dd$ d-d%Z2ddddd!dd& d.d'Z3ddddd!dd& d.d(Z4ddddd!dd& d.d)Z5ddddd!e"dd* d/d+Z6y)0ae The MIT License (MIT) Copyright (c) 2015-2021 Rapptz Copyright (c) 2021-present Pycord Development 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_CHECKINGCallableTypeVar)_threaded_guild_channel_factory) SelectMenu SelectOption)Emoji) ChannelType ComponentType)InvalidArgument) Interaction)Member) PartialEmoji)Role)Thread)User)MISSING)ItemItemCallbackType)Selectselect string_select user_select role_selectmentionable_selectchannel_select) GuildChannel)r )ComponentInteractionData)ViewSr)boundVr"T)r$ covariantc eZdZUdZdZded<ejfddddddddd d#fd Ze d$d Z e jd%d Z e d&d Z e jd'd Z e d(dZ e jd)dZ e d(dZejd)dZe d*dZejd+dZe d,dZejd-dZe d.dZejd/dZedddd d0dZd1dZe d2dZe d(dZd3dZd4dZd5dZed6d Ze d7d!Zd*d"ZxZS)8ra Represents a UI select menu. This is usually represented as a drop down menu. In order to get the selected items that the user has chosen, use :attr:`Select.values`. .. versionadded:: 2.0 .. versionchanged:: 2.3 Added support for :attr:`discord.ComponentType.string_select`, :attr:`discord.ComponentType.user_select`, :attr:`discord.ComponentType.role_select`, :attr:`discord.ComponentType.mentionable_select`, and :attr:`discord.ComponentType.channel_select`. Parameters ---------- select_type: :class:`discord.ComponentType` The type of select to create. Must be one of :attr:`discord.ComponentType.string_select`, :attr:`discord.ComponentType.user_select`, :attr:`discord.ComponentType.role_select`, :attr:`discord.ComponentType.mentionable_select`, or :attr:`discord.ComponentType.channel_select`. custom_id: :class:`str` The ID of the select menu that gets received during an interaction. If not given then one is generated for you. placeholder: Optional[:class:`str`] The placeholder text that is shown if nothing is selected, if any. min_values: :class:`int` The minimum number of items that must be chosen for this select menu. Defaults to 1 and must be between 1 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. Only valid for selects of type :attr:`discord.ComponentType.string_select`. channel_types: List[:class:`discord.ChannelType`] A list of channel types that can be selected in this menu. Only valid for selects of type :attr:`discord.ComponentType.channel_select`. disabled: :class:`bool` Whether the select is disabled or not. row: Optional[:class:`int`] The relative row this select menu belongs to. A Discord component can only have 5 rows. By default, items are arranged automatically into those 5 rows. If you'd like to control the relative positioning of the row then passing an index is advised. For example, row=1 will show up before row=2. Defaults to ``None``, which is automatic ordering. The row number must be between 0 and 4 (i.e. zero indexed). )type placeholder min_values max_valuesoptions channel_typesdisabledztuple[str, ...]__item_repr_attributes__NrF) custom_idr)r*r+r,r-r.rowc n|r|tjur td|r|tjur tdt |g|_d|_|dks|dkDr td|dks|dkDr td|rt|dkDr td t|ts$|"td |jj|du|_|#t!j"d j%n|}t'j(|||||||xsg|xsg |_| |_y) Nz2options parameter is only valid for string selectsz9channel_types parameter is only valid for channel selectsr#min_values must be between 0 and 25r#max_values must be between 1 and 25+placeholder must be 150 characters or fewerz"expected custom_id to be str, not )r0r(r)r*r+r.r,r-)r rrrsuper__init___selected_values _interaction ValueErrorlen isinstancestr TypeError __class____name___provided_custom_idosurandomhexr _raw_construct _underlyingr1) self select_typer0r)r*r+r,r-r.r1rBs D/var/www/html/venv/lib/python3.12/site-packages/discord/ui/select.pyr:zSelect.__init__}sG {-*E*EE!"VW W [ 0L0LL!K  +-04 >Z"_BC C >Z"_BC C 3{+c1JK K)S)i.C4Y5H5H5Q5Q4RS $-D#8 ,5,=BJJrN&&(9 '1'@'@#!!Mr'-2 ( c.|jjS)zCThe ID of the select menu that gets received during an interaction.)rIr0rJs rLr0zSelect.custom_ids)))rMct|ts tdt|dkDr t d||j _y)Nzcustom_id must be None or strdz)custom_id must be 100 characters or fewer)r?r@rAr>r=rIr0rJvalues rLr0zSelect.custom_ids>%%;< < u: HI I%*"rMc.|jjS)zBThe placeholder text that is shown if nothing is selected, if any.)rIr)rOs rLr)zSelect.placeholders+++rMc|t|ts td|rt|dkDr t d||j _y)Nzplaceholder must be None or strr6r7)r?r@rAr>r=rIr)rRs rLr)zSelect.placeholdersE  Zs%;=> > SZ#%JK K',$rMc.|jjS)zEThe minimum number of items that must be chosen for this select menu.)rIr*rOs rLr*zSelect.min_values***rMcb|dks|dkDr tdt||j_y)Nrr3r4)r=intrIr*rRs rLr*zSelect.min_values- 19 BC C&)%j#rMc.|jjS)zEThe maximum number of items that must be chosen for this select menu.)rIr+rOs rLr+zSelect.max_valuesrWrMcb|dks|dkDr tdt||j_y)Nrr3r5)r=rYrIr+rRs rLr+zSelect.max_valuesrZrMc.|jjS)z&Whether the select is disabled or not.)rIr.rOs rLr.zSelect.disableds(((rMc8t||j_yN)boolrIr.rRs rLr.zSelect.disableds$(K!rMc.|jjS)z:A list of channel types that can be selected in this menu.)rIr-rOs rLr-zSelect.channel_typess---rMc|jjtjur t d||j_y)Nz0channel_types can only be set on channel selects)rIr(r rrr-rRs rLr-zSelect.channel_typess6    (D(D D!"TU U).&rMc.|jjS)z4A list of options that can be selected in this menu.)rIr,rOs rLr,zSelect.optionss'''rMc|jjtjur t dt |t s tdtd|Ds td||j_ y)N)options can only be set on string selectsz&options must be a list of SelectOptionc3<K|]}t|tywr_)r?r ).0objs rL z!Select.options..sBS:c<0Bsz)all list items must subclass SelectOption) rIr(r rrr?listrAallr,rRs rLr,zSelect.optionssf    (C(C C!"MN N%&DE EBEBBGH H#( rM)rS descriptionemojidefaultc|jjtjur t dt |||||}|j |y)alAdds an option to the select menu. To append a pre-existing :class:`discord.SelectOption` use the :meth:`append_option` method instead. Parameters ---------- label: :class:`str` The label of the option. This is displayed to users. Can only be up to 100 characters. value: :class:`str` The value of the option. This is not displayed to users. If not given, defaults to the label. Can only be up to 100 characters. description: Optional[:class:`str`] An additional description of the option, if any. Can only be up to 100 characters. emoji: Optional[Union[:class:`str`, :class:`.Emoji`, :class:`.PartialEmoji`]] The emoji of the option, if available. This can either be a string representing the custom or unicode emoji or an instance of :class:`.PartialEmoji` or :class:`.Emoji`. default: :class:`bool` Whether this option is selected by default. Raises ------ ValueError The number of options exceeds 25. re)labelrSrlrmrnN)rIr(r r Exceptionr append_option)rJrprSrlrmrnoptions rL add_optionzSelect.add_optionsTH    (C(C CGH H#   6"rMc |jjtjur t dt |jj dkDr td|jj j|y)aAppends an option to the select menu. Parameters ---------- option: :class:`discord.SelectOption` The option to append to the select menu. Raises ------ ValueError The number of options exceeds 25. rer3z*maximum number of options already providedN) rIr(r rrqr>r,r=append)rJrss rLrrzSelect.append_option2si    (C(C CGH H t'' (2 -IJ J   ''/rMc|jy|jj}|tjur |j Sg}t |j }|jj}|jj}|jjjdi}|tjur|jdijD]\}}||vr t||jvst||jvrS|j!t|} d|d<t#| t$r| j'|n| j'||nt)|dd} | |||} |j+| n|tj,tj.fvr|j0j2} |jd i} |jd i} |D]v}| j|x}| j|x}/t5|}||d <|}|j7|t|| } n t9|| } |j+| x|tj:tj.fvrJ|jd ijD]'\}}||vr |j+t=|||)|S)aList[:class:`str`] | List[:class:`discord.Member` | :class:`discord.User`]] | List[:class:`discord.Role`]] | List[:class:`discord.Member` | :class:`discord.User` | :class:`discord.Role`]] | List[:class:`discord.abc.GuildChannel`] | None: A list of values that have been selected by the user. This will be ``None`` if the select has not been interacted with yet. NresolvedchannelsT _invoke_flagr(r)statedataguildusersmembersuser)r{r|roles)r}r{r|)r<rIr(r rr;rj_stater}r|getritemsrY _channels_threadsget_channel_or_threadr?r_updaterrvrrmember_cache_flags interactiondict_get_and_update_memberrrr)rJrKrxselected_valuesr{r} resolved_data channel_id_dataresultobj_type cache_flagresolved_user_dataresolved_member_data_id _member_datamemberrole_ids rLvaluesz Select.valuesGs    $&&++ -55 5(( (t445!!((!!''))..22:rB -66 6%2%6%6z2%F%L%L%N (! E_4 Ou6:%..8"88ZIF,0E.)&ff5u-#^^E59 ?uV}MaPH%EUKF'/ (0  % %  , ,  11==J!.!2!27B!? #0#4#4Y#C & ,/33C88EE(<(@(@(EE R!%l!3).v &!&!=!=!3s8Z""&E!>OOF+ , =44m6V6VW W"/"3"3GR"@"F"F"H L/15E JK LrMcy)NrOs rLwidthz Select.widthsrMc6|jjSr_)rIto_dictrOs rLto_component_dictzSelect.to_component_dicts''))rMc||_yr_)rI)rJ components rLrefresh_componentzSelect.refresh_components $rMcX|j}|jdg|_||_y)Nr)r|rr;r<)rJrr|s rL refresh_statezSelect.refresh_states()4)9)9 $2 6'rMc ||j|j|j|j|j|j |j |jd S)N) rKr0r)r*r+r,r-r.r1)r(r0r)r*r+r,r-r.)clsrs rLfrom_componentzSelect.from_componentsX!))!-- ++ ++%%#11''  rMc.|jjSr_)rIr(rOs rLr(z Select.types$$$rMcy)NTrrOs rLis_dispatchablezSelect.is_dispatchablesrM)rKr r0 str | Noner)rr*rYr+rYr,list[SelectOption]r-list[ChannelType]r.r`r1 int | NonereturnNone)rr@)rSr@)rr)rSr)rrY)rSrY)rr`)rSr`)rr)rSr)rr)rSr) rpr@rSr@rlrrmz!str | Emoji | PartialEmoji | Nonernr`)rsr )rzglist[str] | list[Member | User] | list[Role] | list[Member | User | Role] | list[GuildChannel | Thread])rSelectMenuPayload)rr rr)rrrr)rztype[S]rr rr#)rr )rC __module__ __qualname____doc__r/__annotations__r rr:propertyr0setterr)r*r+r.r-r,rrtrrrrrrr classmethodrr(r __classcell__)rBs@rLrrBs.`1o&3%@%@-!%"&&*+/-"- -  -  --$-)--- -^**++,,--++11 ++11 ))__00..// (( ^^))"&37/#/# /#  /# 1 /#/#b0*I &IIV*%(     %%rMF)r)r0r*r+r,r-r.r1c ttvr9tddjtD cgc]} | jc} ztur-t j t jfvr tdturt jur tddf d } | Scc} w)a A decorator that attaches a select menu to a component. The function being decorated should have three parameters, ``self`` representing the :class:`discord.ui.View`, the :class:`discord.ui.Select` being pressed and the :class:`discord.Interaction` you receive. In order to get the selected items that the user has chosen within the callback use :attr:`Select.values`. .. versionchanged:: 2.3 Creating select menus of different types is now supported. Parameters ---------- select_type: :class:`discord.ComponentType` The type of select to create. Must be one of :attr:`discord.ComponentType.string_select`, :attr:`discord.ComponentType.user_select`, :attr:`discord.ComponentType.role_select`, :attr:`discord.ComponentType.mentionable_select`, or :attr:`discord.ComponentType.channel_select`. placeholder: Optional[:class:`str`] The placeholder text that is shown if nothing is selected, if any. 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. row: Optional[:class:`int`] The relative row this select menu belongs to. A Discord component can only have 5 rows. By default, items are arranged automatically into those 5 rows. If you'd like to control the relative positioning of the row then passing an index is advised. For example, row=1 will show up before row=2. Defaults to ``None``, which is automatic ordering. The row number must be between 0 and 4 (i.e. zero indexed). 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. Only valid for the :attr:`discord.ComponentType.string_select` type. channel_types: List[:class:`discord.ChannelType`] The channel types that should be selectable. Only valid for the :attr:`discord.ComponentType.channel_select` type. Defaults to all channel types. disabled: :class:`bool` Whether the select is disabled or not. Defaults to ``False``. zselect_type must be one of z, z0options may only be specified for string selectsz7channel_types may only be specified for channel selectsc tj|s td  d}r|d<r|d<t|_||_|S)Nz,select function must be a coroutine function)rKr)r0r1r*r+r.r,r-)inspectiscoroutinefunctionrAr__discord_ui_model_type____discord_ui_model_kwargs__) func model_kwargsr-r0r.r+r*r,r)r1rKs rL decoratorzselect..decorator sl**40JK K'&"$$   &-L # ,9L ))/&+7( rM)rrrr) _select_typesr=joinnamerr rrrAr) rKr)r0r*r+r,r-r.r1irs ````````` rLrrsv-' )DII}6U!qvv6U,V V  g+##6#JKKG# =;W;W(WQRR. G7VsB5r)r0r*r+r,r.r1c Dttj|||||||S)zA shortcut for :meth:`discord.ui.select` with select type :attr:`discord.ComponentType.string_select`. .. versionadded:: 2.3 r)rr rrs rLrr$s/ ##   rMr)r0r*r+r.r1c Bttj||||||S)zA shortcut for :meth:`discord.ui.select` with select type :attr:`discord.ComponentType.user_select`. .. versionadded:: 2.3 r)rr rrs rLrr>, !!  rMc Bttj||||||S)zA shortcut for :meth:`discord.ui.select` with select type :attr:`discord.ComponentType.role_select`. .. versionadded:: 2.3 r)rr rrs rLrrVrrMc Bttj||||||S)zA shortcut for :meth:`discord.ui.select` with select type :attr:`discord.ComponentType.mentionable_select`. .. versionadded:: 2.3 r)rr rrs rLrrns, ((  rMr)r0r*r+r.r-r1c Dttj|||||||S)zA shortcut for :meth:`discord.ui.select` with select type :attr:`discord.ComponentType.channel_select`. .. versionadded:: 2.3 r)rr rrs rLrrs/ $$#   rM)rKr r)rr0rr*rYr+rYr,rr-rr.r`r1rr.Callable[[ItemCallbackType], ItemCallbackType])r)rr0rr*rYr+rYr,rr.r`r1rrr)r)rr0rr*rYr+rYr.r`r1rrr)r)rr0rr*rYr+rYr.r`r-rr1rrr)9r __future__rrrEtypingrrrchannelr componentsr r rmr enumsr r errorsr interactionsrrr partial_emojirrolerthreadsrrrutilsritemrr__all__abcr types.componentsrtypes.interactionsr!viewr"r#r%rrrrrrrrrrMrLrsF2# 3351.$&(( "B= Cx  Cv.sT!Wsn $$   "/!