cjhAdZddlmZddlmZmZddlmZmZm Z ddl m Z ddl m Z mZmZmZer:ddlmZdd lmZmZmZdd lmZdd lmZdd lmZddl m Z dd lmZddlm Z!ddlm"Z#dZ$GddZ"GddZ GddZy)aF The MIT License (MIT) 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. ) annotations) TYPE_CHECKINGAny)OnboardingMode PromptTypetry_enum) PartialEmoji)MISSINGcached_propertygenerate_snowflakeget) Snowflake) ForumChannel TextChannel VoiceChannel)Emoji)Guild)Object) Onboarding)OnboardingPrompt) PromptOption)rrrcZeZdZdZ d ddZdZd dZed dZy) raRepresents an onboarding prompt option displayed in :class:`OnboardingPrompt`. .. versionadded:: 2.5 Attributes ---------- id: :class:`int` The id of the prompt option. channels: List[:class:`Snowflake`] The channels assigned to the user when they select this option. roles: List[:class:`Snowflake`] The roles assigned to the user when they select this option. emoji: Union[:class:`Emoji`, :class:`PartialEmoji`] The emoji displayed with the option. title: :class:`str` The option's title. description: Optional[:class:`str`] The option's description. Nc|r t|n t|_||_|xsg|_|xsg|_|xsd|_||_yN)intr idtitlechannelsroles descriptionemoji)selfrrr r!r"rs E/var/www/html/venv/lib/python3.12/site-packages/discord/onboarding.py__init__zPromptOption.__init__IsH#%s2w*<*> )1R &+kr '2':d27 c pd|jd|jd|jd|jd S)Nz)rrr!r"r#s r$__repr__zPromptOption.__repr__Zs<"477)74::. dN^N^Maahimisishvvwxxr&c|j|j|jDcgc]}|jc}|jDcgc]}|jc}t |jd}|j r|j jrt |j jnd|j j|j jd|d<|j j|d<|j jr;t |j j|d<|j j|d<|Scc}wcc}w)N)rr! channel_idsrole_idsr)rnameanimatedr" emoji_nameemoji_idemoji_animated) rr!rrr strr"r/r0)r#channelroledict_s r$to_dictzPromptOption.to_dict]sZZ++6:mmD7GJJD-1ZZ8T8dgg, &  ::,0JJMMc$**--(t  JJ//E'N #'**//E, zz}}$' $6j!*.***=*=&' E8s EE c|jdd}|jdgDcgc] }t|}}|Dcgc]}|j|}}|jdgDcgc] }t|}}|Dcgc]}|j|} }|jd} |jd} |jdxsi} d| vrGt j | } | j r(t|j| j xs| } nd} ||| | | | | Scc}wcc}wcc}wcc}w) Nrrr-r.rr!r"r/r)rr rr!r"r)rr get_channelget_roler from_dictremojis)clsdataguildr channel_idr-rrole_idr.r rr!_emojir"s r$ _from_dictzPromptOption._from_dictrs# XXdA 9=-QS9TU:s:U UDOPjE%%j1PP04R0HIWCLII8@AW(AA!hh}- !%'!2!8b V  **62ExxELLUXX6?%EHEK_dikll!VPIAsD1D6-D;E)NNNNN) rr4rlist[Snowflake] | Noner rFr! str | Noner"zEmoji | PartialEmoji | Noner int | None)returnPromptOptionPayload)r@rJrArrIr __name__ __module__ __qualname____doc__r%r+r8 classmethodrEr&r$rr3sx0,0(,"&-188)8& 8  8 + 8 8"y*mmr&rcbeZdZdZ d ddZdZd dZe d dZy) raRepresents an onboarding prompt displayed in :class:`Onboarding`. .. versionadded:: 2.5 Attributes ---------- id: :class:`int` The id of the prompt. type: :class:`PromptType` The type of onboarding prompt. title: :class:`str` The prompt's title. options: List[:class:`PromptOption`] The list of options available in the prompt. single_select: :class:`bool` Whether the user is limited to selecting one option on this prompt. required: :class:`bool` Whether the user is required to answer this prompt. in_onboarding: :class:`bool` Whether this prompt is displayed in the initial onboarding flow. Nc|r t|n t|_||_t |jtrt t |j|_||_||_||_ ||_ ||_ yr) rr rtype isinstancer roptionsr single_selectrequired in_onboarding)r#rTrrVrWrXrYrs r$r%zOnboardingPrompt.__init__sc#%s2w*<*> $ dii % TYY7DI+2  #0& #0r&cVd|jd|jd|jdS)Nz111$ 1  1  11 1,`  P* P38 P  P Pr&rceZdZdZddZdZddZe ddZe e e e e d ddZ dd  dd Z dd  dd Z dd Z e d  dd Zy)rajRepresents the onboarding flow for a guild. .. versionadded:: 2.5 Attributes ---------- prompts: List[:class:`OnboardingPrompt`] A list of prompts displayed in the onboarding flow. enabled: :class:`bool` Whether onboarding is enabled in the guild. mode: :class:`OnboardingMode` The current onboarding mode. c4||_|j|yr)rA_update)r#r@rAs r$r%zOnboarding.__init__s  Tr&c pd|jd|jd|jd|jd S)Nz4<<.tyykYbcgcocobppqrrr&cP|d|_|jdgDcgc]"}tj||j$c}|_|dDcgc] }t |c}|_|d|_tt|jd|_ ycc}wcc}w)Nguild_idridefault_channel_idsrgrh) rkrrrErArirrlrgr rrh)r#r@promptcs r$rezOnboarding._updates#' #3 ((9b10   ' ' ;0  !!67/ CF/  ")_ $,^TXXf=M$N 0 / s 'BB#c|j#|jDcgc] }t|c}S|jDcgc]*}|jj|xs t|,c}Scc}wcc}w)zThe channels that members are opted into by default. If a channel is not found in the guild's cache, then it will be returned as an :class:`Object`. )rArlrr;)r#rBs r$default_channelszOnboarding.default_channelsst :: 9=9Q9QR:F:&R R#66  JJ " ": . D&2D D  S s A0/A5)rirprgrhreasoncKi}|tur!|Dcgc]}|jc}|d<|tur|Dcgc]}|jc}|d<|tur||d<|tur|j|d<|jj j j|jj||d{} |j| |Scc}wcc}w7!w)a|coro| Edits this onboarding flow. You must have the :attr:`~Permissions.manage_guild` and :attr:`~Permissions.manage_roles` permissions in the guild to do this. Parameters ---------- prompts: Optional[List[:class:`OnboardingPrompt`]] The new list of prompts for this flow. default_channels: Optional[List[:class:`Snowflake`]] The new default channels that users are opted into. enabled: Optional[:class:`bool`] Whether onboarding should be enabled. Setting this to ``True`` requires the guild to have ``COMMUNITY`` in :attr:`~Guild.features` and at least 7 ``default_channels``. mode: Optional[:class:`OnboardingMode`] The new onboarding mode. reason: Optional[:class:`str`] The reason for editing this onboarding flow. Shows up on the audit log. Returns ------- :class:`Onboarding` The updated onboarding flow. Raises ------ HTTPException Editing the onboarding flow failed somehow. Forbidden You don't have permissions to edit the onboarding flow. rirlrgrhrqN) r r8rr]rA_statehttpedit_onboardingre) r#rirprgrhrqfieldsrmr5news r$editzOnboarding.edit sZ"$ ' !@G Hf!1 HF9  7 *GW,XGWZZ,XF( ) ' ! 'F9  w !ZZF6NJJ%%**:: JJMM6&;   S !I-Y s'C$CC$C A3C$C""C$NrscKt||||||}|j|gz} |j| |d{S7w)a|coro| Adds a new onboarding prompt. You must have the :attr:`~Permissions.manage_guild` and :attr:`~Permissions.manage_roles` permissions in the guild to do this. Parameters ---------- type: :class:`PromptType` The type of onboarding prompt. title: :class:`str` The prompt's title. options: List[:class:`PromptOption`] The list of options available in the prompt. single_select: :class:`bool` Whether the user is limited to selecting one option on this prompt. required: :class:`bool` Whether the user is required to answer this prompt. in_onboarding: :class:`bool` Whether this prompt is displayed in the initial onboarding flow. reason: Optional[:class:`str`] The reason for adding this prompt. Shows up on the audit log. Returns ------- :class:`Onboarding` The updated onboarding flow. Raises ------ HTTPException Editing the onboarding flow failed somehow. Forbidden You don't have permissions to edit the onboarding flow. rirqN)rriry) r#rTrrVrWrXrYrqrmris r$ add_promptzOnboarding.add_promptJsK`" %-= ,,&)YYwvY>>>>s7A>AcdK|j|gz}|j||d{S7w)a|coro| Append an onboarding prompt onto this flow. You must have the :attr:`~Permissions.manage_guild` and :attr:`~Permissions.manage_roles` permissions in the guild to do this. Parameters ---------- prompt: :class:`OnboardingPrompt` The onboarding prompt to append. reason: Optional[:class:`str`] The reason for appending this prompt. Shows up on the audit log. Returns ------- :class:`Onboarding` The updated onboarding flow. Raises ------ HTTPException Editing the onboarding flow failed somehow. Forbidden You don't have permissions to edit the onboarding flow. r{N)riry)r#rmrqris r$ append_promptzOnboarding.append_prompts2B,,&)YYwvY>>>>s '0.0c0t|j|S)a-|coro| Get an onboarding prompt with the given ID. Parameters ---------- id: :class:`int` The ID of the prompt to get. Returns ------- :class:`OnboardingPrompt` The matching prompt, or None if it didn't exist. r:)rri)r#rs r$ get_promptzOnboarding.get_prompts&4<>>>sAAAA)r@OnboardingPayloadrAr)r@r)rIz8list[TextChannel | ForumChannel | VoiceChannel | Object]) rizlist[OnboardingPrompt] | NonerprFrgz bool | NonerhzOnboardingMode | NonerqrGrIr)rTrrr4rVr`rWrarXrarYrarqrG)rmrrqrG)rr)rrrqrG)rLrMrNrOr%r+rer rpr ryr|r~rrrQr&r$rrs s O  A    $293:&&-$>/>1 >  > $ >> >R"4?4?4?$ 4?  4?  4?4?4?t" "? "? "?H( (2% )? )? )?r&rN)%rO __future__rtypingrrenumsrrr partial_emojir utilsr r r rabcrr5rrrr"rrArobjectrtypes.onboardingrrrrbrrJ__all__rQr&r$rss0#%77'DD@@+AME RmRmjLPLP^K?K?r&