il dZddlmZddlmZmZmZmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZddlZddlZddlmZddlmZmZddlmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%dd l&m'Z'dd l(m)Z)dd l)m*Z*dd l+m,Z,dd l-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z4m5Z5ddl6m7Z7m8Z8ddl9m:Z:ddl;mZ>m?Z?dZ@erddlAmBZBmCZCddlDmEZEddlFmGZGddlHmIZImJZJddlKmLZLmMZMddlNmOZOddlPmQZQmRZRmSZSddlTmUZUddlVmWZWddlXmYZYdd lZm[Z[m\Z\dd!l]m^Z^dd"l_m`Z`maZambZbdd#lcmdZdmeZfdd$lgmhZhmiZimjZjdd%lkmlZmmnZompZqmrZsmtZumvZwmxZymzZ{m|Z}m~ZmZdd&lmZdd'lm>Zdd(l=mZed)eGebeZGd<d=ZGd>d?ejKjejKjee'ZlGd@dAejKjejKjejKjee'ZGdBdCeZpGdDdEeZrGdFdGejKjee'ZvGdHdIe'Z~GdJdKejKjee'ZzGdLdMejKjejKje'ZtGdNdOejKjejKje'ZGdPdQejKje'ZdXdTZdXdUZdXdVZdXdWZdS)Ya: 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. ) annotations)Any AsyncIteratorCallableDictIterableListLiteralMapping NamedTupleOptional TYPE_CHECKINGSequenceTupleTypeVar TypedDictUnionoverloadN)ScheduledEvent)PermissionOverwrite Permissions) ChannelTypeForumLayoutTypeForumOrderType PrivacyLeveltry_enumVideoQualityMode EntityTypeVoiceChannelEffectAnimationType)Hashable)utils)MISSING)Asset)ClientException) StageInstance)Thread) _EmojiTag PartialEmoji) ChannelFlags MessageFlags)handle_message_parameters)Object)BaseSoundboardSoundSoundboardDefaultSound) TextChannel VoiceChannel StageChannel DMChannelCategoryChannelForumTag ForumChannel GroupChannelPartialMessageableVoiceChannelEffectVoiceChannelSoundEffect)SelfUnpack)ThreadArchiveDuration)Role)Member VoiceState) Snowflake SnowflakeTime)Embed)MessagePartialMessageEmojiInputType)AllowedMentionsWebhook)ConnectionState) GuildSticker StickerItem)File) ClientUserUserBaseUser)Guild GuildChannel)BaseViewView LayoutView) r0 NewsChannelr1r2r3r4GroupDMChannelr6 MediaChannelr5r9) SnowflakeList)r.)SoundboardSound OverwriteKeyTc$eZdZUded<ded<dS)_BaseCreateChannelOptions Optional[str]reasonintpositionN__name__ __module__ __qualname____annotations__V/home/ubuntu/.hermes/hermes-agent/venv/lib/python3.11/site-packages/discord/channel.pyr]r]|s% rhr]F)totalcLeZdZUded<ded<ded<ded<ded <ded <d S) _CreateTextChannelOptionsstrtopicr`slowmode_delayboolnsfw9Mapping[Union[Role, Member, Object], PermissionOverwrite] overwritesdefault_auto_archive_durationdefault_thread_slowmode_delayNrbrgrhrirlrlsT  MMMM**********rhrlcBeZdZUded<ded<ded<ded<ded <d S) _CreateVoiceChannelOptionsr`bitrate user_limitr^ rtc_regionrvideo_quality_moderrrsNrbrgrhrirwrwH !!!!,,,,MMMMMMrhrwcBeZdZUded<ded<ded<ded<ded <d S) _CreateStageChannelOptionsr`rxryr^rzrr{rrrsNrbrgrhrir~r~r|rhr~cteZdZUded<ded<ded<ded<ded <ded <d ed <d ed<ded<ded<dS)_CreateForumChannelOptionsrmrnr`rorprqrrrsrtrurdefault_sort_orderrFdefault_reaction_emojirdefault_layoutSequence[ForumTag]available_tagsNrbrgrhrirrs  MMMM************....''''******rhrc$eZdZUded<ded<dS)ThreadWithMessager'threadrDmessageNrbrgrhrirrs'NNNrhrc$eZdZUded<ded<dS)VoiceChannelEffectAnimationr`idr typeNrbrgrhrirrs' GGG))))))rhrcPeZdZdZdZdfd Zdd ZeddZddZ xZ S)r:a(Represents a Discord voice channel sound effect. .. versionadded:: 2.5 .. container:: operations .. describe:: x == y Checks if two sound effects are equal. .. describe:: x != y Checks if two sound effects are not equal. .. describe:: hash(x) Returns the sound effect's hash. Attributes ------------ id: :class:`int` The ID of the sound. volume: :class:`float` The volume of the sound as floating point percentage (e.g. ``1.0`` for 100%). )_statestaterJrr`volumefloatcX||d}t||dS)N)sound_idrrdata)super__init__)selfrrrr __class__s rirz VoiceChannelSoundEffect.__init__s:, ,  u400000rhreturnrmcBd|jjd|jd|jdS)N< id=z volume=>)rrcrrrs ri__repr__z VoiceChannelSoundEffect.__repr__s,O4>*OOOOOOOOrhOptional[datetime.datetime]c`|rdStj|jS)zOptional[:class:`datetime.datetime`]: Returns the snowflake's creation time in UTC. Returns ``None`` if it's a default sound.N) is_defaultr"snowflake_timerrs ri created_atz"VoiceChannelSoundEffect.created_ats. ??   14'00 0rhrpc,|jtjkS)z3:class:`bool`: Whether it's a default sound or not.)rr" DISCORD_EPOCHrs rirz"VoiceChannelSoundEffect.is_defaultsw,,,rh)rrJrr`rrrrm)rrrrp) rcrdre__doc__ __slots__rrpropertyrr __classcell__rs@rir:r:s4I111111PPPP111X1--------rhr:c.eZdZdZdZdd Zdd ZddZdS)r9aRepresents a Discord voice channel effect. .. versionadded:: 2.5 Attributes ------------ channel: :class:`VoiceChannel` The channel in which the effect is sent. user: Optional[:class:`Member`] The user who sent the effect. ``None`` if not found in cache. animation: Optional[:class:`VoiceChannelEffectAnimation`] The animation the effect has. Returns ``None`` if the effect has no animation. emoji: Optional[:class:`PartialEmoji`] The emoji of the effect. sound: Optional[:class:`VoiceChannelSoundEffect`] The sound of the effect. Returns ``None`` if it's an emoji effect. )channeluser animationemojisoundrrJrVoiceChannelEffectPayloadguildrQcX|t|d|_|t|d|_d|_|d}|1tt|d}t|||_|d}|tj |nd|_ d|_ tj|d}|0|dpd }t!||| |_ dSdS) N channel_iduser_id animation_idanimation_type)rrrr sound_volumeg)rrr) get_channelr`r get_memberrrgetrr rr) from_dictrrr"_get_as_snowflaker:) rrrrrrrrrs rirzVoiceChannelEffect.__init__s%*%6%6s4 ;M7N7N%O%O &+&6&6s4 ?7K7K&L&L @Dxx//  #%&EtL\G]^^N8L~^^^DN!!NSN_\-CE-J-J-Jei 8< "'"9$ "K"K  88N33:sL0uR^___DJJJ rhrrmcd|jfd|jfd|jfd|jfd|jfg}dd|D}d|jjd|d S) Nrrrrr c3 K|] }d|zV dSz%s=%rNrg.0ts ri z.VoiceChannelEffect.__repr__..s&441444444rhrr)rrrrrjoinrrc)rattrsinners rirzVoiceChannelEffect.__repr__ s{  % TY  $. ) dj ! dj !  44e4444454>*55U5555rhrpc|jduS)z4:class:`bool`: Whether the effect is a sound or not.N)rrs riis_soundzVoiceChannelEffect.is_soundsz%%rhN)rrJrrrrQrr)rcrdrerrrrrrgrhrir9r9sf$CI````& 6 6 6 6&&&&&&rhr9ceZdZdZdZdsd Zdtd ZdudZdvdZe dwdZ e dxdZ e dydZ e jejjjdzfd Ze d{dZe d|dZd}d Zd}d!Ze d~d#Zedd%Zed&d'dd+Zed&d&d&d&d&d&d&d&d&d&d&d&d, dd;Zd.r&55!'A+555555rhrr) rrrarqis_newsrrrrcrrjoineds rirzTextChannel.__repr__is 47O TY   ' TY  T\\^^ $ D, -  55u5555564>*66V6666rhNonec&||_|d|_tj|d|_|d|_|d|_|dd|_|dd|_ |d d |_ |d d|_ |d |j |_ tj|d |_ ||dS)Nr parent_idrnrarqFrate_limit_per_userrrt"default_thread_rate_limit_per_userrr)rrr"rrrrnrarqrortrurr_fill_overwritesrrrs rirzTextChannel._updateus! f */*A$ *T*T$(HHW$5$5 !*- ((6511 #'88,A1#E#EDHHHMlnrDsDs*26((;_ab2c2c*$(HHVTZ$@$@ .3.EdL].^.^ d#####rhr;c K|SNrgrs ri _get_channelzTextChannel._get_channel  rh+Literal[ChannelType.text, ChannelType.news]cH|jdkr tjStjS)1:class:`ChannelType`: The channel's Discord type.r)rrtextrrs rirzTextChannel.types! :??# #rhr`c$tjjSrrrvaluers ri_sorting_bucketzTextChannel._sorting_bucket%%rhOptional[EntityType]cdSrrgrs ri_scheduled_event_entity_typez(TextChannel._scheduled_event_entity_typetrhobjUnion[Member, Role]rct|}||tj}|xj|jzc_|Srrpermissions_for_apply_implicit_permissionsrvoicerrrbasedeniedrs rirzTextChannel.permissions_forWww&&s++ ((..."$$ v|m#  rh List[Member]c4fdjjDS)zEList[:class:`Member`]: Returns all members that can see this channel.cHg|]}|j|Srgr read_messagesrmrs ri z'TextChannel.members../WWWa1E1Ea1H1H1VWWWWrhrmembersrs`rirzTextChannel.memberss%XWWW4:-WWWWrh List[Thread]cXfdjjDS)zhList[:class:`Thread`]: Returns all the threads that you can see. .. versionadded:: 2.0 c4g|]}|jjk|Srgrrrrrs rirz'TextChannel.threads..*aaa6VEUY]Y`E`E`E`E`E`rhr_threadsvaluesrs`rithreadszTextChannel.threadss1 baaaTZ%8%?%?%A%Aaaaarhrpc|jS)z-:class:`bool`: Checks if the channel is NSFW.rqrs riis_nsfwzTextChannel.is_nsfw yrhc6|jtjjkS)z7:class:`bool`: Checks if the channel is a news channel.)rrrrrs rirzTextChannel.is_newssz[-333rhOptional[Message]cR|jr|j|jndS)a:Retrieves the last message from this channel in cache. The message might not be valid or point to an existing message. .. admonition:: Reliable Fetching :class: helpful For a slightly more reliable method of fetching the last message, consider using either :meth:`history` or :meth:`fetch_message` with the :attr:`last_message_id` attribute. Returns --------- Optional[:class:`Message`] The last message in this channel or ``None`` if not found. Nrr _get_messagers ri last_messagezTextChannel.last_messages-&BFAU_t{''(<===[__rhOptional[TextChannel]c KdSrrgrs rieditzTextChannel.edits 363rh.r_rar_r^c KdSrrgrrar_s rir(zTextChannel.edit QTQTrh) r_rrnrarqsync_permissionscategoryrortrurrsrrnrqr-r.Optional[CategoryChannel]rortr=rurrrs+Mapping[OverwriteKeyT, PermissionOverwrite]c  KdSrrg) rr_rrnrarqr-r.rortrurrss rir(zTextChannel.edits crhNoptionsrcK|||d{V}|"||j|j|SdS)a |coro| Edits the channel. You must have :attr:`~Permissions.manage_channels` to do this. .. versionchanged:: 1.3 The ``overwrites`` keyword-only parameter was added. .. versionchanged:: 1.4 The ``type`` keyword-only parameter was added. .. versionchanged:: 2.0 Edits are no longer in-place, the newly edited channel is returned instead. .. versionchanged:: 2.0 This function will now raise :exc:`TypeError` or :exc:`ValueError` instead of ``InvalidArgument``. Parameters ---------- name: :class:`str` The new channel name. topic: :class:`str` The new channel's topic. position: :class:`int` The new channel's position. nsfw: :class:`bool` To mark the channel as NSFW or not. sync_permissions: :class:`bool` Whether to sync permissions with the channel's new or pre-existing category. Defaults to ``False``. category: Optional[:class:`CategoryChannel`] The new category for this channel. Can be ``None`` to remove the category. slowmode_delay: :class:`int` Specifies the slowmode rate limit for user in this channel, in seconds. A value of ``0`` disables slowmode. The maximum value possible is ``21600``. type: :class:`ChannelType` Change the type of this text channel. Currently, only conversion between :attr:`ChannelType.text` and :attr:`ChannelType.news` is supported. This is only available to guilds that contain ``NEWS`` in :attr:`Guild.features`. reason: Optional[:class:`str`] The reason for editing this channel. Shows up on the audit log. overwrites: :class:`Mapping` A :class:`Mapping` of target (either a role or a member) to :class:`PermissionOverwrite` to apply to the channel. default_auto_archive_duration: :class:`int` The new default auto archive duration in minutes for threads created in this channel. Must be one of ``60``, ``1440``, ``4320``, or ``10080``. .. versionadded:: 2.0 default_thread_slowmode_delay: :class:`int` The new default slowmode delay in seconds for threads created in this channel. .. versionadded:: 2.3 Raises ------ ValueError The new ``position`` is less than 0 or greater than the number of channels. TypeError The permission overwrite information is not in proper form. Forbidden You do not have permissions to edit the channel. HTTPException Editing the channel failed. Returns -------- Optional[:class:`.TextChannel`] The newly edited text channel. If the edit was only positional then ``None`` is returned instead. r)Nrrr_editrrrrr_r2payloads rir(zTextChannel.editsZV 76 ::::::::  >> 4:G>TT T  rhrr.r_cK|j|j|j|jd}|s |j|d<|||||d{VS)N)rnrqrtrrr9)rnrqrtrurro _clone_implrrr.r_rs riclonezTextChannel.clone2sZI-1-O262T    ||~~ >*.*=D& '%%  &         rhmessagesIterable[Snowflake]cKt|ttfst|}t|dkrdSt|dkr:|dj}|jj|j|d{VdSt|dkrtdd|D}|jj |j||d{VdS)a1|coro| Deletes a list of messages. This is similar to :meth:`Message.delete` except it bulk deletes multiple messages. As a special case, if the number of messages is 0, then nothing is done. If the number of messages is 1 then single message delete is done. If it's more than two, then bulk delete is used. You cannot bulk delete more than 100 messages or messages that are older than 14 days old. You must have :attr:`~Permissions.manage_messages` to do this. .. versionchanged:: 2.0 ``messages`` parameter is now positional-only. The ``reason`` keyword-only parameter was added. Parameters ----------- messages: Iterable[:class:`abc.Snowflake`] An iterable of messages denoting which ones to bulk delete. reason: Optional[:class:`str`] The reason for deleting the messages. Shows up on the audit log. Raises ------ ClientException The number of messages to delete was more than 100. Forbidden You do not have proper permissions to delete the messages. NotFound If single delete, then the message was already deleted. HTTPException Deleting the messages failed. rNrd0Can only bulk delete messages up to 100 messagescg|] }|j Srgrrr s rirz/TextChannel.delete_messages..~%=%=%=qad%=%=%=rhr) isinstancelisttuplelenrrhttpdelete_messager%delete_messagesrr>r_ message_id message_idss rirNzTextChannel.delete_messagesIsN(T5M22 &H~~H x==A   F x==A  &qknJ+"11$':FF F F F F F F F F x==3  !"TUU U%=%=H%=%=%= k..tw F.SSSSSSSSSSSrhrATlimitcheckbeforeafteraround oldest_firstbulkr_rS Optional[int]rTCallable[[Message], bool]rUOptional[SnowflakeTime]rVrWrXOptional[bool]rY List[Message]c bKtj||||||||| d{VS)a |coro| Purges a list of messages that meet the criteria given by the predicate ``check``. If a ``check`` is not provided then all messages are deleted without discrimination. You must have :attr:`~Permissions.manage_messages` to delete messages even if they are your own. Having :attr:`~Permissions.read_message_history` is also needed to retrieve message history. .. versionchanged:: 2.0 The ``reason`` keyword-only parameter was added. Examples --------- Deleting bot's messages :: def is_me(m): return m.author == client.user deleted = await channel.purge(limit=100, check=is_me) await channel.send(f'Deleted {len(deleted)} message(s)') Parameters ----------- limit: Optional[:class:`int`] The number of messages to search through. This is not the number of messages that will be deleted, though it can be. check: Callable[[:class:`Message`], :class:`bool`] The function used to check if a message should be deleted. It must take a :class:`Message` as its sole parameter. before: Optional[Union[:class:`abc.Snowflake`, :class:`datetime.datetime`]] Same as ``before`` in :meth:`history`. after: Optional[Union[:class:`abc.Snowflake`, :class:`datetime.datetime`]] Same as ``after`` in :meth:`history`. around: Optional[Union[:class:`abc.Snowflake`, :class:`datetime.datetime`]] Same as ``around`` in :meth:`history`. oldest_first: Optional[:class:`bool`] Same as ``oldest_first`` in :meth:`history`. bulk: :class:`bool` If ``True``, use bulk delete. Setting this to ``False`` is useful for mass-deleting a bot's own messages without :attr:`Permissions.manage_messages`. When ``True``, will fall back to single delete if messages are older than two weeks. reason: Optional[:class:`str`] The reason for purging the messages. Shows up on the audit log. Raises ------- Forbidden You do not have proper permissions to do the actions required. HTTPException Purging the messages failed. Returns -------- List[:class:`.Message`] The list of messages that were deleted. rRNdiscordabc _purge_helper rrSrTrUrVrWrXrYr_s ripurgezTextChannel.purgesaR[.. %/         rh List[Webhook]cKddlmjjjd{V}fd|DS)h|coro| Gets the list of webhooks from this channel. You must have :attr:`~.Permissions.manage_webhooks` to do this. Raises ------- Forbidden You don't have permissions to get the webhooks. Returns -------- List[:class:`Webhook`] The webhooks for this channel. rrHNc>g|]}j|jSr from_staterrdrIrs rirz(TextChannel.webhooks...GGGQ""1DK888GGGrhwebhookrIrrLchannel_webhooksrrrrIs` @riwebhookszTextChannel.webhookse$ %$$$$$[%66tw????????GGGGG$GGGGrhavatarr_rxOptional[bytes]rIcKddlm}|tj|}|jj|jt|||d{V}|j ||jS)a|coro| Creates a webhook for this channel. You must have :attr:`~.Permissions.manage_webhooks` to do this. .. versionchanged:: 1.1 Added the ``reason`` keyword-only parameter. Parameters ------------- name: :class:`str` The webhook's name. avatar: Optional[:class:`bytes`] A :term:`py:bytes-like object` representing the webhook's default avatar. This operates similarly to :meth:`~ClientUser.edit`. reason: Optional[:class:`str`] The reason for creating this webhook. Shows up in the audit logs. Raises ------- HTTPException Creating the webhook failed. Forbidden You do not have permissions to create a webhook. Returns -------- :class:`Webhook` The created webhook. rrHNrrxr_rk rrrIr"_bytes_to_base64_datarrLcreate_webhookrrmrmrrrxr_rIrs rir~zTextChannel.create_webhooksB %$$$$$  088F[%44TW3t99U[dj4kkkkkkkk!w!$dk::::rh destinationcXK|stdt|tst d|jjddlm}|j j |j |j |d{V}|j |||j jS)av|coro| Follows a channel using a webhook. Only news channels can be followed. .. note:: The webhook returned will not provide a token to do webhook actions, as Discord does not provide it. .. versionadded:: 1.3 .. versionchanged:: 2.0 This function will now raise :exc:`TypeError` instead of ``InvalidArgument``. Parameters ----------- destination: :class:`TextChannel` The channel you would like to follow from. reason: Optional[:class:`str`] The reason for following the channel. Shows up on the destination guild's audit log. .. versionadded:: 1.4 Raises ------- HTTPException Following the channel failed. Forbidden You do not have the permissions to create a webhook. ClientException The channel is not a news channel. TypeError The destination channel is not a text channel. Returns -------- :class:`Webhook` The created webhook. z#The channel must be a news channel.zExpected TextChannel received rrH)webhook_channel_idr_N)rr)rr%rHr0 TypeErrorrrcrrrIrrLfollow_webhookr _as_followerr)rrr_rIrs rifollowzTextChannel.followsX||~~ I!"GHH H+{33 _][=R=[]]^^ ^$$$$$$[%44TWQ\Q_hn4oooooooo#w#D+DKDTUUUUrhrPrEc(ddlm}|||Sa&Creates a :class:`PartialMessage` from the message ID. This is useful if you want to work with a message and only have its ID without doing an unnecessary API call. .. versionadded:: 1.6 .. versionchanged:: 2.0 ``message_id`` parameter is now positional-only. Parameters ------------ message_id: :class:`int` The message ID to create a partial message for. Returns --------- :class:`PartialMessage` The partial message. rrErrrrErrPrEs riget_partial_messagezTextChannel.get_partial_messageM+. ,+++++~dz::::rh thread_idOptional[Thread]c6|j|S)aReturns a thread with the given ID. .. note:: This does not always retrieve archived threads, as they are not retained in the internal cache. Use :func:`Guild.fetch_channel` instead. .. versionadded:: 2.0 Parameters ----------- thread_id: :class:`int` The ID to search for. Returns -------- Optional[:class:`Thread`] The returned thread or ``None`` if not found. )r get_thread)rrs rirzTextChannel.get_threadhs(z$$Y///rh)rauto_archive_durationrr_ invitablerorOptional[Snowflake]rOptional[ChannelType]rr'c RK| tj}|>|jj|j||p|j|j|||d{V}n<|jj|j|j||p|j||d{V}t|j |j|S)a|coro| Creates a thread in this text channel. To create a public thread, you must have :attr:`~discord.Permissions.create_public_threads`. For a private thread, :attr:`~discord.Permissions.create_private_threads` is needed instead. .. versionadded:: 2.0 Parameters ----------- name: :class:`str` The name of the thread. message: Optional[:class:`abc.Snowflake`] A snowflake representing the message to create the thread with. If ``None`` is passed then a private thread is created. Defaults to ``None``. auto_archive_duration: :class:`int` The duration in minutes before a thread is automatically hidden from the channel list. If not provided, the channel's default auto archive duration is used. Must be one of ``60``, ``1440``, ``4320``, or ``10080``, if provided. type: Optional[:class:`ChannelType`] The type of thread to create. If a ``message`` is passed then this parameter is ignored, as a thread created with a message is always a public thread. By default this creates a private thread if this is ``None``. reason: :class:`str` The reason for creating a new thread. Shows up on the audit log. invitable: :class:`bool` Whether non-moderators can add users to the thread. Only applicable to private threads. Defaults to ``True``. slowmode_delay: Optional[:class:`int`] Specifies the slowmode rate limit for user in this channel, in seconds. The maximum value possible is ``21600``. By default no slowmode rate limit if this is ``None``. Raises ------- Forbidden You do not have permissions to create a thread. HTTPException Starting the thread failed. Returns -------- :class:`Thread` The created thread N)rrrr_rr)rrr_rrrr) rprivate_threadrrLstart_thread_without_messagerrtrstart_thread_with_messager'r) rrrrrr_rrors ri create_threadzTextChannel.create_thread~sx <-D ?)FF&;&at?aZ#$2GDD)CC &;&at?a$2 DDDJdkEEEErhF)privaterrSrUrr-Optional[Union[Snowflake, datetime.datetime]]AsyncIterator[Thread]cvK|r|stdd}t|tjr;|r$tt j|d}nY|}nD|B|rt|j}n+t j|j}d}|j j j j }|rd}|j j j j }n|r|j j j j} d}|&|d krdStd t!||}||j|| d{V} | d g} | D]6} t%|j |j j | WV||dz}|d krdS7| ddsdS|| d})a9Returns an :term:`asynchronous iterator` that iterates over all archived threads in this text channel, in order of decreasing ID for joined threads, and decreasing :attr:`Thread.archive_timestamp` otherwise. You must have :attr:`~Permissions.read_message_history` to do this. If iterating over private threads then :attr:`~Permissions.manage_threads` is also required. .. versionadded:: 2.0 Parameters ----------- limit: Optional[:class:`bool`] The number of threads to retrieve. If ``None``, retrieves every archived thread in the channel. Note, however, that this would make it a slow operation. before: Optional[Union[:class:`abc.Snowflake`, :class:`datetime.datetime`]] Retrieve archived channels before the given date or ID. private: :class:`bool` Whether to retrieve private archived threads. joined: :class:`bool` Whether to retrieve private archived threads that you've joined. You cannot set ``joined`` to ``True`` and ``private`` to ``False``. Raises ------ Forbidden You do not have permissions to get archived threads. HTTPException The request to get the archived threads failed. ValueError ``joined`` was set to ``True`` and ``private`` was set to ``False``. You cannot retrieve public archived threads that you have joined. Yields ------- :class:`Thread` The archived threads. z.Cannot retrieve joined public archived threadsNF)highc|ddSNthread_metadataarchive_timestamprgrs riz.TextChannel.archived_threads..T*;%<=P%Qrhc|dSNrrgrs rirz.TextChannel.archived_threads..s drhTrArrUrSrrrhas_more) ValueErrorrHdatetimermr"time_snowflake isoformatrrrrrLget_public_archived_threads#get_joined_private_archived_threadsget_private_archived_threadsmaxminrr') rrrrSrUbefore_timestamp update_beforeendpointretrieverr raw_threads riarchived_threadszTextChannel.archived_threadssZ  O' OMNN N fh/ 0 0 O 6#&u';F'O'O'O#P#P  #)#3#3#5#5    O#&vy>>  #(#7 #B#B#L#L#N#N QQ :$)E  K33Mz(-QHH  Kz(-JH :H A::Fq#h"6"677!$'2B(SSSSSSSSSDhhy"--G%   4:TZ5FZXXXXXXX$QJEzz88J.. ,}WR[99 - :rh)rrJrrQrrr)rrQrrrrrr;)rrrr`rrrrrrrrrrrrr!)rr&rar`r_r^rr)r_r^rrmrnrmrar`rqrpr-rpr.r/ror`rtr=rur`rrrsr0rr0)r_r^r2rrr&)rr^r.r/r_r^rr0r>r?r_r^rrrSrZrTr[rUr\rVr\rWr\rXr]rYrpr_r^rr^rrfrrmrxryr_r^rrI)rr0r_r^rrIrPr`rrErr`rr)rrmrrrr=rrr_r^rrprorZrr') rrprrprSrZrUrrr)&rcrdrerrrrrrrrrrr"copy_docrarbrRrrrrrr%rr(r=rNr#rerur~rrrrrrrs@rir0r0s(44lI""""" 7 7 7 7 $ $ $ $   X &&&X&XU^GK,<==>=XXXXXbbbXb4444```X`(666X6 CFTTTTTXT !$!$.1!?B-0BEX"59NUNUNUNUNUNU`U^GK,233#.2 $      43 ,_c6T6T6T6T6T6Tv #+2*.)-*.'+ $S S S S S S jHHHH.LPim';';';';';';RQU5V5V5V5V5V5Vn;;;;600004(,7>&* $(,SFSFSFSFSFSFp"@D \:\:\:\:\:\:\:\:\:\:rhr0c eZdZdZdIdZdJd ZdKd ZdLdZdMdZe dNdZ dOdZ e dPdZ e dQdZ e dRdZejejjjdSfd Ze dTd!ZdUd$Zd%d&dVd+Zd,ed%d%d%d%d-d%d.dWd;ZdXd=Zd%d%d>dYdDZejejjjd%d%d%dEdZdHZxZS)[VocalGuildChannel)rrrrqrxryrrarorrrzr{rrrJrrQr/Union[VoiceChannelPayload, StageChannelPayload]ct||_t|d|_|||dSrrr`rrrs rirzVocalGuildChannel.__init__D4', 4: UD!!!!!rhrr;c K|Srrgrs rirzVocalGuildChannel._get_channelIrrhTuple[int, str]c|jjdfS)Nguild_idrrrs ri_get_voice_client_keyz'VocalGuildChannel._get_voice_client_keyLsz}j((rhTuple[int, int]c(|jj|jfSrrrs ri_get_voice_state_pairz'VocalGuildChannel._get_voice_state_pairOsz}dg%%rhrc ||_|d|_|dd|_|d|_t t |dd|_tj |d|_ tj |d|_ |d |_ |d d |_ |d |_|d |_||dS)NrrqFrzr{rrrrarrrxry)rrrrqrzrrr{r"rrrrarorxryrrs rirzVocalGuildChannel._updateRs! f ((6511 )-,)?)?4<=MtxxXlnoOpOp4q4q*/*A$ *T*T.3.EdL].^.^!*- "hh'> ' 'NGU} '!1TW!z2VocalGuildChannel.voice_states..sG   U} "'!1TW!>    rhList[ScheduledEvent]c4fdjjDS)zuList[:class:`ScheduledEvent`]: Returns all scheduled events for this channel. .. versionadded:: 2.0 c4g|]}|jjk|Srg)rr)reventrs rirz6VocalGuildChannel.scheduled_events..s*^^^%%BRVZV]B]B]B]B]B]rh)rscheduled_eventsrs`rirz"VocalGuildChannel.scheduled_eventss% _^^^4:#>^^^^rhrrrct|}|||js@t j}|dd|xj|jzc_|S)NT)manage_channels manage_roles)rrrconnectrrupdaterrs rirz!VocalGuildChannel.permissions_forswww&&s++ ((...| ( &((F MM$TM B B B JJ6<- 'JJ rhr!cR|jr|j|jndS)aYRetrieves the last message from this channel in cache. The message might not be valid or point to an existing message. .. versionadded:: 2.0 .. admonition:: Reliable Fetching :class: helpful For a slightly more reliable method of fetching the last message, consider using either :meth:`history` or :meth:`fetch_message` with the :attr:`last_message_id` attribute. Returns --------- Optional[:class:`Message`] The last message in this channel or ``None`` if not found. Nr#rs rir%zVocalGuildChannel.last_messages-*BFAU_t{''(<===[__rhrPrEc(ddlm}|||S)aCreates a :class:`PartialMessage` from the message ID. This is useful if you want to work with a message and only have its ID without doing an unnecessary API call. .. versionadded:: 2.0 Parameters ------------ message_id: :class:`int` The message ID to create a partial message for. Returns --------- :class:`PartialMessage` The partial message. rrrrrs rirz%VocalGuildChannel.get_partial_messages+& ,+++++~dz::::rhNr)r>r?r_r^cKt|ttfst|}t|dkrdSt|dkr:|dj}|jj|j|d{VdSt|dkrtdd|D}|jj |j||d{VdS)a|coro| Deletes a list of messages. This is similar to :meth:`Message.delete` except it bulk deletes multiple messages. As a special case, if the number of messages is 0, then nothing is done. If the number of messages is 1 then single message delete is done. If it's more than two, then bulk delete is used. You cannot bulk delete more than 100 messages or messages that are older than 14 days old. You must have :attr:`~Permissions.manage_messages` to do this. .. versionadded:: 2.0 Parameters ----------- messages: Iterable[:class:`abc.Snowflake`] An iterable of messages denoting which ones to bulk delete. reason: Optional[:class:`str`] The reason for deleting the messages. Shows up on the audit log. Raises ------ ClientException The number of messages to delete was more than 100. Forbidden You do not have proper permissions to delete the messages. NotFound If single delete, then the message was already deleted. HTTPException Deleting the messages failed. rNrrArBcg|] }|j SrgrDrEs rirz5VocalGuildChannel.delete_messages..rFrhr)rGrOs rirNz!VocalGuildChannel.delete_messagessF(T5M22 &H~~H x==A   F x==A  &qknJ+"11$':FF F F F F F F F F x==3  !"TUU U%=%=H%=%=%= k..tw F.SSSSSSSSSSSrhrATrRrSrZrTr[rUr\rVrWrXr]rYr^c bKtj||||||||| d{VS)aR |coro| Purges a list of messages that meet the criteria given by the predicate ``check``. If a ``check`` is not provided then all messages are deleted without discrimination. You must have :attr:`~Permissions.manage_messages` to delete messages even if they are your own. Having :attr:`~Permissions.read_message_history` is also needed to retrieve message history. .. versionadded:: 2.0 Examples --------- Deleting bot's messages :: def is_me(m): return m.author == client.user deleted = await channel.purge(limit=100, check=is_me) await channel.send(f'Deleted {len(deleted)} message(s)') Parameters ----------- limit: Optional[:class:`int`] The number of messages to search through. This is not the number of messages that will be deleted, though it can be. check: Callable[[:class:`Message`], :class:`bool`] The function used to check if a message should be deleted. It must take a :class:`Message` as its sole parameter. before: Optional[Union[:class:`abc.Snowflake`, :class:`datetime.datetime`]] Same as ``before`` in :meth:`history`. after: Optional[Union[:class:`abc.Snowflake`, :class:`datetime.datetime`]] Same as ``after`` in :meth:`history`. around: Optional[Union[:class:`abc.Snowflake`, :class:`datetime.datetime`]] Same as ``around`` in :meth:`history`. oldest_first: Optional[:class:`bool`] Same as ``oldest_first`` in :meth:`history`. bulk: :class:`bool` If ``True``, use bulk delete. Setting this to ``False`` is useful for mass-deleting a bot's own messages without :attr:`Permissions.manage_messages`. When ``True``, will fall back to single delete if messages are older than two weeks. reason: Optional[:class:`str`] The reason for purging the messages. Shows up on the audit log. Raises ------- Forbidden You do not have proper permissions to do the actions required. HTTPException Purging the messages failed. Returns -------- List[:class:`.Message`] The list of messages that were deleted. rRNr`rds rirezVocalGuildChannel.purgesaP[.. %/         rhrfcKddlmjjjd{V}fd|DS)a|coro| Gets the list of webhooks from this channel. You must have :attr:`~.Permissions.manage_webhooks` to do this. .. versionadded:: 2.0 Raises ------- Forbidden You don't have permissions to get the webhooks. Returns -------- List[:class:`Webhook`] The webhooks for this channel. rrHNc>g|]}j|jSrjrlrns rirz.VocalGuildChannel.webhooks..prprhrqrts` @riruzVocalGuildChannel.webhooksYse( %$$$$$[%66tw????????GGGGG$GGGGrhrwrrmrxryrIcKddlm}|tj|}|jj|jt|||d{V}|j ||jS)aH|coro| Creates a webhook for this channel. You must have :attr:`~.Permissions.manage_webhooks` to do this. .. versionadded:: 2.0 Parameters ------------- name: :class:`str` The webhook's name. avatar: Optional[:class:`bytes`] A :term:`py:bytes-like object` representing the webhook's default avatar. This operates similarly to :meth:`~ClientUser.edit`. reason: Optional[:class:`str`] The reason for creating this webhook. Shows up in the audit logs. Raises ------- HTTPException Creating the webhook failed. Forbidden You do not have permissions to create a webhook. Returns -------- :class:`Webhook` The created webhook. rrHNr{rkr|rs rir~z VocalGuildChannel.create_webhookrs@ %$$$$$  088F[%44TW3t99U[dj4kkkkkkkk!w!$dk::::rhr9r.r/cK|j|j|j|j|jjd}|jr |j|d<|||||d{VS)N)rxryrrqr{rzr9)rxryrorqr{rrzr;r<s rir=zVocalGuildChannel.clones |/#'#6I"&"9"?    ? 1!%D %%  &         rh)rrJrrQrrr)rr)rr)rrQrrrrrrr)rr)rrrrrrrrr)rr^r.r/r_r^rr;)rcrdrerrrrrrrrrrrrr"rrarbrRrr%rrNr#rerur~r=rrs@rirr2sI""""" ))))&&&& $ $ $ $'''X'X   X .___X_U^GK,<==     >= ```X`,;;;;._c2T2T2T2T2T2Tn #+2*.)-*.'+ $R R R R R R hHHHH2LPim&;&;&;&;&;&;PU^GK,233'+SWqu     43     rhrceZdZdZdZd,dZed-dZed.d Ze d/d Z e d d d0dZ e d d d d d d d d d d d d d d d1d#Z d$d d2d(Z d3d+Z d$S)4r1aERepresents a Discord guild voice channel. .. container:: operations .. describe:: x == y Checks if two channels are equal. .. describe:: x != y Checks if two channels are not equal. .. describe:: hash(x) Returns the channel's hash. .. describe:: str(x) Returns the channel's name. Attributes ----------- name: :class:`str` The channel name. guild: :class:`Guild` The guild the channel belongs to. id: :class:`int` The channel ID. nsfw: :class:`bool` If the channel is marked as "not safe for work" or "age restricted". .. versionadded:: 2.0 category_id: Optional[:class:`int`] The category channel ID this channel belongs to, if applicable. position: :class:`int` The position in the channel list. This is a number that starts at 0. e.g. the top channel is position 0. bitrate: :class:`int` The channel's preferred audio bitrate in bits per second. user_limit: :class:`int` The channel's limit for number of members that can be in a voice channel. rtc_region: Optional[:class:`str`] The region for the voice channel's voice communication. A value of ``None`` indicates automatic voice region detection. .. versionadded:: 1.7 .. versionchanged:: 2.0 The type of this attribute has changed to :class:`str`. video_quality_mode: :class:`VideoQualityMode` The camera video quality for the voice channel's participants. .. versionadded:: 2.0 last_message_id: Optional[:class:`int`] The last message ID of the message sent to this channel. It may *not* point to an existing or valid message. .. versionadded:: 2.0 slowmode_delay: :class:`int` The number of seconds a member must wait between sending messages in this channel. A value of ``0`` denotes that it is disabled. Bots and users with :attr:`~Permissions.bypass_slowmode` bypass slowmode. .. versionadded:: 2.2 rgrrmc d|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfg}d d |D}d |j j d |d S) Nrrrzrarxr{ryrrc3 K|] }d|zV dSrrgrs rirz(VoiceChannel.__repr__..rrhrr) rrrzrarxr{ryrrrrcrs rirzVoiceChannel.__repr__s 47O TY  4? +  '  % !4#: ; 4? + D, -  55u5555564>*66V6666rhrctjSr)rrrs rirz)VoiceChannel._scheduled_event_entity_types rhLiteral[ChannelType.voice]ctjSr)rrrs rirzVoiceChannel.type   rhrc KdSrrgrs rir(zVoiceChannel.edit  "%#rh.r)rar`r_r^c KdSrrgr+s rir(zVoiceChannel.editr,rh) rrqrxryrar-r.rsrzr{rostatusr_rrqrprxryr-r.r/rsr0rzr{rror c  KdSrrg)rrrqrxryrar-r.rsrzr{ror r_s rir(zVoiceChannel.edits "srhNr2rOptional[VoiceChannel]cK|||d{V}|"||j|j|SdS)a |coro| Edits the channel. You must have :attr:`~Permissions.manage_channels` to do this. .. versionchanged:: 1.3 The ``overwrites`` keyword-only parameter was added. .. versionchanged:: 2.0 Edits are no longer in-place, the newly edited channel is returned instead. .. versionchanged:: 2.0 The ``region`` parameter now accepts :class:`str` instead of an enum. .. versionchanged:: 2.0 This function will now raise :exc:`TypeError` instead of ``InvalidArgument``. Parameters ---------- name: :class:`str` The new channel's name. bitrate: :class:`int` The new channel's bitrate. nsfw: :class:`bool` To mark the channel as NSFW or not. user_limit: :class:`int` The new channel's user limit. position: :class:`int` The new channel's position. sync_permissions: :class:`bool` Whether to sync permissions with the channel's new or pre-existing category. Defaults to ``False``. category: Optional[:class:`CategoryChannel`] The new category for this channel. Can be ``None`` to remove the category. slowmode_delay: :class:`int` Specifies the slowmode rate limit for user in this channel, in seconds. A value of ``0`` disables slowmode. The maximum value possible is ``21600``. reason: Optional[:class:`str`] The reason for editing this channel. Shows up on the audit log. overwrites: :class:`Mapping` A :class:`Mapping` of target (either a role or a member) to :class:`PermissionOverwrite` to apply to the channel. rtc_region: Optional[:class:`str`] The new region for the voice channel's voice communication. A value of ``None`` indicates automatic voice region detection. .. versionadded:: 1.7 video_quality_mode: :class:`VideoQualityMode` The camera video quality for the voice channel's participants. .. versionadded:: 2.0 status: Optional[:class:`str`] The new voice channel status. It can be up to 500 characters. Can be ``None`` to remove the status. .. versionadded:: 2.4 Raises ------ TypeError If the permission overwrite information is not in proper form. Forbidden You do not have permissions to edit the channel. HTTPException Editing the channel failed. Returns -------- Optional[:class:`.VoiceChannel`] The newly edited voice channel. If the edit was only positional then ``None`` is returned instead. r)Nr4r5r7s rir(zVoiceChannel.edit%sZX 76 ::::::::  >> 4:G>TT T  rhr.Union[SoundboardSound, SoundboardDefaultSound]cKd|ji}t|ts)|jj|jjkr|jj|d<|jjj|jfi|d{VdS)a|coro| Sends a soundboard sound for this channel. You must have :attr:`~Permissions.speak` and :attr:`~Permissions.use_soundboard` to do this. Additionally, you must have :attr:`~Permissions.use_external_sounds` if the sound is from a different guild. .. versionadded:: 2.5 Parameters ----------- sound: Union[:class:`SoundboardSound`, :class:`SoundboardDefaultSound`] The sound to send for this channel. Raises ------- Forbidden You do not have permissions to send a sound for this channel. HTTPException Sending the sound failed. rsource_guild_idN)rrHr/rrrLsend_soundboard_sound)rrr8s ri send_soundzVoiceChannel.send_soundvs.ux(%!788 8TZ]ekn=\=\).G% &4dk4TWHHHHHHHHHHHHHrhrr)rrrrr)rrmrqrprxr`ryr`rar`r-r`r.r/rsr0rzr^r{rror`r r^r_r^rr1)r_r^r2rrr )rr rr) rcrdrerrrrrrrr(rrgrhrir1r1sN@@DI 7 7 7 7   X !!!X!%%%X% CFTTTTTXT  #.1BE$'/2! # #X$59OUOUOUOUOUOUbIIIIIIrhr1cleZdZdZdZd?dZd@fd ZedAd ZedBdZ edBdZ edBdZ edBdZ edCdZ edDdZededddEd$ZdFd%ZedGd&Zed'd(dHd+Zed'd'd'd'd'd'd'd'd'd'd'd'd, dId:Zdd(dJd>ZxZS)Kr2a5Represents a Discord guild stage channel. .. versionadded:: 1.7 .. container:: operations .. describe:: x == y Checks if two channels are equal. .. describe:: x != y Checks if two channels are not equal. .. describe:: hash(x) Returns the channel's hash. .. describe:: str(x) Returns the channel's name. Attributes ----------- name: :class:`str` The channel name. guild: :class:`Guild` The guild the channel belongs to. id: :class:`int` The channel ID. nsfw: :class:`bool` If the channel is marked as "not safe for work" or "age restricted". .. versionadded:: 2.0 topic: Optional[:class:`str`] The channel's topic. ``None`` if it isn't set. category_id: Optional[:class:`int`] The category channel ID this channel belongs to, if applicable. position: :class:`int` The position in the channel list. This is a number that starts at 0. e.g. the top channel is position 0. bitrate: :class:`int` The channel's preferred audio bitrate in bits per second. user_limit: :class:`int` The channel's limit for number of members that can be in a stage channel. rtc_region: Optional[:class:`str`] The region for the stage channel's voice communication. A value of ``None`` indicates automatic voice region detection. video_quality_mode: :class:`VideoQualityMode` The camera video quality for the stage channel's participants. .. versionadded:: 2.0 last_message_id: Optional[:class:`int`] The last message ID of the message sent to this channel. It may *not* point to an existing or valid message. .. versionadded:: 2.2 slowmode_delay: :class:`int` The number of seconds a member must wait between sending messages in this channel. A value of ``0`` denotes that it is disabled. Bots and users with :attr:`~Permissions.bypass_slowmode` bypass slowmode. .. versionadded:: 2.2 )rnrrmc d|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd |jfg }d d |D}d |j j d |d S)Nrrrnrzrarxr{ryrrc3 K|] }d|zV dSrrgrs rirz(StageChannel.__repr__..rrhrr) rrrnrzrarxr{ryrrrrcrs rirzStageChannel.__repr__s 47O TY  dj ! 4? +  '  % !4#: ; 4? + D, -  55u5555564>*66V6666rhrrQrStageChannelPayloadrct|||d|_dS)Nrn)rrrrn)rrrrs rirzStageChannel._updates2 t$$$$(HHW$5$5 rhrctjSr)rstage_instancers rirz)StageChannel._scheduled_event_entity_types ((rhrc$d|jDS)zZList[:class:`Member`]: A list of members who are requesting to speak in the stage channel.c8g|]}|j |jj|Sr)rrequested_to_speak_atrrs rirz4StageChannel.requesting_to_speak..s)uuu6V\uflFhFtFtFtFtrhrrs rirequesting_to_speakz StageChannel.requesting_to_speaksvuT\uuuurhc$d|jDS)zList[:class:`Member`]: A list of members who have been permitted to speak in the stage channel. .. versionadded:: 2.0 cPg|]#}|jr|jjs|jj!|$Sr)rsuppressrrs rirz)StageChannel.speakers..sI   | %+L$9 ?El>`>h >h>h>hrhrrs rispeakerszStageChannel.speakerss%   ,    rhc$d|jDS)zxList[:class:`Member`]: A list of members who are listening in the stage channel. .. versionadded:: 2.0 c8g|]}|j |jj|Srg)rr"rs rirz*StageChannel.listeners..s)\\\6V\\flF[\\\\rhrrs ri listenerszStageChannel.listenerss ]\T\\\\\rhcTtjfdjDS)zvList[:class:`Member`]: A list of members who are moderating the stage channel. .. versionadded:: 2.0 cFg|]}|k|Srg)r)rrrequired_permissionsrs rirz+StageChannel.moderators..s2jjj6T5I5I&5Q5QUi5i5i5i5i5irh)rstage_moderatorr)rr)s`@ri moderatorszStageChannel.moderatorss4 +:<<jjjjjT\jjjjrh Literal[ChannelType.stage_voice]ctjSr)r stage_voicers rirzStageChannel.types &&rhOptional[StageInstance]cLtj|jj|jS)zzOptional[:class:`StageInstance`]: The running stage instance of the stage channel. .. versionadded:: 2.0 )r)r"rrstage_instancesrrs riinstancezStageChannel.instances y3HHHHrhFN) privacy_levelsend_start_notificationscheduled_eventr_rnr3rr4rpr5rAr_r^r&c2K|j|d}|tur.t|tst d|j|d<|tur |j|d<||d<|jjjd i|d|id{V}t|j |j|S) aD|coro| Create a stage instance. You must have :attr:`~Permissions.manage_channels` to do this. .. versionadded:: 2.0 Parameters ----------- topic: :class:`str` The stage instance's topic. privacy_level: :class:`PrivacyLevel` The stage instance's privacy level. Defaults to :attr:`PrivacyLevel.guild_only`. send_start_notification: :class:`bool` Whether to send a start notification. This sends a push notification to @everyone if ``True``. Defaults to ``False``. You must have :attr:`~Permissions.mention_everyone` to do this. .. versionadded:: 2.3 scheduled_event: :class:`~discord.abc.Snowflake` The guild scheduled event associated with the stage instance. .. versionadded:: 2.4 reason: :class:`str` The reason the stage instance was created. Shows up on the audit log. Raises ------ TypeError If the ``privacy_level`` parameter is not the proper type. Forbidden You do not have permissions to create a stage instance. HTTPException Creating a stage instance failed. Returns -------- :class:`StageInstance` The newly created stage instance. )rrnz0privacy_level field must be of type PrivacyLevelr3guild_scheduled_event_idr4r_Nrrg) rr#rHrrrrrLcreate_stage_instancer&r)rrnr3r4r5r_r8rs ricreate_instancezStageChannel.create_instancesd265"I"I  ' 'm\:: T RSSS'4':GO $ ' ) )2A2DG. /-D)*;T[%;UUgUUfUUUUUUUUU4:T[tLLLLrhcK|jj|jd{V}t |j|j|S)au|coro| Gets the running :class:`StageInstance`. .. versionadded:: 2.0 Raises ------- NotFound The stage instance or channel could not be found. HTTPException Getting the stage instance failed. Returns -------- :class:`StageInstance` The stage instance. Nr)rrLget_stage_instancerr&rrrs rifetch_instancezStageChannel.fetch_instance`sM&[%88AAAAAAAA4:T[tLLLLrhc KdSrrgrs rir(zStageChannel.editvrrh.r)rar`c KdSrrgr+s rir(zStageChannel.edityr,rh) rrqrxryrar-r.rsrzr{ror_rrqrxryr-r.r/rsr0rzr{rroc  KdSrrg) rrrqrxryrar-r.rsrzr{ror_s rir(zStageChannel.edit|s srhr2rOptional[StageChannel]cK|||d{V}|"||j|j|SdS)aD |coro| Edits the channel. You must have :attr:`~Permissions.manage_channels` to do this. .. versionchanged:: 2.0 The ``topic`` parameter must now be set via :attr:`create_instance`. .. versionchanged:: 2.0 Edits are no longer in-place, the newly edited channel is returned instead. .. versionchanged:: 2.0 The ``region`` parameter now accepts :class:`str` instead of an enum. .. versionchanged:: 2.0 This function will now raise :exc:`TypeError` instead of ``InvalidArgument``. Parameters ---------- name: :class:`str` The new channel's name. bitrate: :class:`int` The new channel's bitrate. position: :class:`int` The new channel's position. nsfw: :class:`bool` To mark the channel as NSFW or not. user_limit: :class:`int` The new channel's user limit. sync_permissions: :class:`bool` Whether to sync permissions with the channel's new or pre-existing category. Defaults to ``False``. category: Optional[:class:`CategoryChannel`] The new category for this channel. Can be ``None`` to remove the category. slowmode_delay: :class:`int` Specifies the slowmode rate limit for user in this channel, in seconds. A value of ``0`` disables slowmode. The maximum value possible is ``21600``. reason: Optional[:class:`str`] The reason for editing this channel. Shows up on the audit log. overwrites: :class:`Mapping` A :class:`Mapping` of target (either a role or a member) to :class:`PermissionOverwrite` to apply to the channel. rtc_region: Optional[:class:`str`] The new region for the stage channel's voice communication. A value of ``None`` indicates automatic voice region detection. video_quality_mode: :class:`VideoQualityMode` The camera video quality for the stage channel's participants. .. versionadded:: 2.0 Raises ------ ValueError If the permission overwrite information is not in proper form. Forbidden You do not have permissions to edit the channel. HTTPException Editing the channel failed. Returns -------- Optional[:class:`.StageChannel`] The newly edited stage channel. If the edit was only positional then ``None`` is returned instead. r)Nr4r5r7s rir(zStageChannel.editsZL 76 ::::::::  >> 4:G>TT T  rhr)rrQrrrrrr)rr,)rr/) rnrmr3rr4rpr5rAr_r^rr&)rr&rr)rrmrqrprxr`ryr`rar`r-r`r.r/rsr0rzr^r{rror`r_r^rr2)r_r^r2rrrA)rcrdrerrrrrrrr#r&r+rr2r#r9r=rr(rrs@rir2r2s`??BI 7 7 7 7666666)))X)vvvXv    X  ]]]X]kkkXk'''X'IIIXI'.(-%, $@M@M@M@M@M@MDMMMM,%%%X% CFTTTTTXT  #.1BE$'/2! #X"59IUIUIUIUIUIUIUIUIUIUrhr2c8eZdZdZdZdDd ZdEd ZdFdZedGdZ edHdZ edIdZ dJdZ e jejjjdddddKdZedLdZed d!dMd#Zed d d d d d$dNd(Zdd!dOd+Ze jejjjdPfd- ZedQd/ZedRd1ZedSd3ZedTd5ZedUd7ZdVd:ZdWd=ZdXd@ZdYdCZxZS)Zr4aRepresents a Discord channel category. These are useful to group channels to logical compartments. .. container:: operations .. describe:: x == y Checks if two channels are equal. .. describe:: x != y Checks if two channels are not equal. .. describe:: hash(x) Returns the category's hash. .. describe:: str(x) Returns the category's name. Attributes ----------- name: :class:`str` The category name. guild: :class:`Guild` The guild the category belongs to. id: :class:`int` The category channel ID. position: :class:`int` The position in the category list. This is a number that starts at 0. e.g. the top category is position 0. nsfw: :class:`bool` If the channel is marked as "not safe for work". .. note:: To check if the channel or the guild of that channel are marked as NSFW, consider :meth:`is_nsfw` instead. )rrrrqrrarrrrJrrQrCategoryChannelPayloadct||_t|d|_|||dSrrrs rirzCategoryChannel.__init__rrhrrmc Hd|jd|jd|jd|jd S)Nz> 4:G>TT T  rhkwargscvK|ddtjdi|d{VdS)Nr.rg)poprmove)rrTrs rirWzCategoryChannel.movexsO :t$$$eggl$$V$$$$$$$$$$$rhList[GuildChannelType]cjd}fdjjD}|||S)zList[:class:`abc.GuildChannel`]: Returns the channels that are under this category. These are sorted by the official Discord UI, which places voice channels below the text channels. c<t|t |jfSr)rHr0ra)rs ri comparatorz,CategoryChannel.channels..comparators"7K888':JK Krhc4g|]}|jjk|Srg)rrrcrs rirz,CategoryChannel.channels..s'JJJQ$'1I1Iq1I1I1Irhrrchannelssort)rr[rs` rirazCategoryChannel.channels}sO L L LKJJJ$*-JJJ Z    rhList[TextChannel]cffdjjD}|d|S)zSList[:class:`TextChannel`]: Returns the text channels that are under this category.c^g|])}|jjkt|t'|*Srg)rrrHr0r]s rirz1CategoryChannel.text_channels..s8iiiQ$'1I1IjYZ\gNhNh1Iq1I1I1Irhc|j|jfSrrarr^s rirz/CategoryChannel.text_channels.. AD1rhr_r`rrs` ri text_channelszCategoryChannel.text_channelssAjiii$*-iii 11222 rhList[VoiceChannel]cffdjjD}|d|S)zUList[:class:`VoiceChannel`]: Returns the voice channels that are under this category.c^g|])}|jjkt|t'|*Srg)rrrHr1r]s rirz2CategoryChannel.voice_channels..8jjjQ$'1I1IjYZ\hNiNi1Iq1I1I1Irhc|j|jfSrrgrhs rirz0CategoryChannel.voice_channels..rirhr_r`rjs` rivoice_channelszCategoryChannel.voice_channelssAkjjj$*-jjj 11222 rhList[StageChannel]cffdjjD}|d|S)z}List[:class:`StageChannel`]: Returns the stage channels that are under this category. .. versionadded:: 1.7 c^g|])}|jjkt|t'|*Srg)rrrHr2r]s rirz2CategoryChannel.stage_channels..rorhc|j|jfSrrgrhs rirz0CategoryChannel.stage_channels..rirhr_r`rjs` ristage_channelszCategoryChannel.stage_channelssA kjjj$*-jjj 11222 rhList[ForumChannel]cffdjjD}|d|S)z}List[:class:`ForumChannel`]: Returns the forum channels that are under this category. .. versionadded:: 2.4 c^g|])}|jjkt|t'|*Srg)rrrHr6r]s rirz*CategoryChannel.forums..s8 h h h1q}/G/GJWXZfLgLg/GQ/G/G/Grhc|j|jfSrrgrhs rirz(CategoryChannel.forums..saj!$/rhr_r`)rrs` riforumszCategoryChannel.forumssA i h h h + h h h //000rh!Unpack[_CreateTextChannelOptions]r0c<K|jj|fd|i|d{VS)z|coro| A shortcut method to :meth:`Guild.create_text_channel` to create a :class:`TextChannel` in the category. Returns ------- :class:`TextChannel` The channel that was just created. r.N)rcreate_text_channelrrr2s rirz#CategoryChannel.create_text_channels<4TZ3DSS4S7SSSSSSSSSrh"Unpack[_CreateVoiceChannelOptions]r1c<K|jj|fd|i|d{VS)z|coro| A shortcut method to :meth:`Guild.create_voice_channel` to create a :class:`VoiceChannel` in the category. Returns ------- :class:`VoiceChannel` The channel that was just created. r.N)rcreate_voice_channelrs rirz$CategoryChannel.create_voice_channels<5TZ4TTTDTGTTTTTTTTTrh"Unpack[_CreateStageChannelOptions]r2c<K|jj|fd|i|d{VS)a|coro| A shortcut method to :meth:`Guild.create_stage_channel` to create a :class:`StageChannel` in the category. .. versionadded:: 1.7 Returns ------- :class:`StageChannel` The channel that was just created. r.N)rcreate_stage_channelrs rirz$CategoryChannel.create_stage_channels<5TZ4TTTDTGTTTTTTTTTrh"Unpack[_CreateForumChannelOptions]r6c<K|jj|fd|i|d{VS)a |coro| A shortcut method to :meth:`Guild.create_forum` to create a :class:`ForumChannel` in the category. .. versionadded:: 2.0 Returns -------- :class:`ForumChannel` The channel that was just created. r.N)r create_forumrs rirzCategoryChannel.create_forums<-TZ,TLLDLGLLLLLLLLLrh)rrJrrQrrDr)rrQrrDrrrr)rrKr)rr^r.r/r_r^rr4rr) rrmrar`rqrprsr0r_r^rr4)r_r^r2rrr/)rTrrr)rrX)rrc)rrl)rrr)rrw)rrmr2r}rr0)rrmr2rrr1)rrmr2rrr2)rrmr2rrr6) rcrdrerrrrrrrrrrr"rrarbrRr=rr(rWrarkrqrvr|rrrrrrs@rir4r4s''RdI"""" nnnn$$$$***X*X$$$X$U^GK,233#.2 $ UUUUU43U%%%X% CFTTTTTXT BE #X594U4U4U4U4U4UlU^GK,122%%%%%32%   X X X XX T T T T U U U U U U U U M M M M M M M Mrhr4cVeZdZdZdZdddddZeddZddZddZ ddZ dS)r5aRepresents a forum tag that can be applied to a thread within a :class:`ForumChannel`. .. versionadded:: 2.1 .. container:: operations .. describe:: x == y Checks if two forum tags are equal. .. describe:: x != y Checks if two forum tags are not equal. .. describe:: hash(x) Returns the forum tag's hash. .. describe:: str(x) Returns the forum tag's name. Attributes ----------- id: :class:`int` The ID of the tag. If this was manually created then the ID will be ``0``. name: :class:`str` The name of the tag. Can only be up to 20 characters. moderated: :class:`bool` Whether this tag can only be added or removed by a moderator with the :attr:`~Permissions.manage_threads` permission. emoji: Optional[:class:`PartialEmoji`] The emoji that is used to represent this tag. Note that if the emoji is a custom emoji, it will *not* have name information. )rr moderatedrNF)rrrrmrOptional[EmojiInputType]rrprrc:||_d|_||_d|_t |t r||_dSt |trtj ||_dS|td|j j dS)Nrz5emoji must be a Emoji, PartialEmoji, str or None not ) rrrrrHr( _to_partialrmr)from_strrrrc)rrrrs rirzForumTag.__init__ s (-1 eY ' ' p**,,DJJJ s # # p%.u55DJJJ  nTYTcTlnnoo o rhrrJrForumTagPayloadr;cF||}|d|_t|d|_|dd|_|dpd}t j|dpd}|s |sd|_ntj ||||_|S) NrrrF emoji_nameemoji_id)rrr) __new__rr`rrrr"rrr) with_state)clsrrrrrs ri from_datazForumTag.from_data s{{3L d4j//+u55,'-2 *4<<D \( \DJJ%0u:RZ[[[DJ rhDict[str, Any]c|j|jd}|j-||jn|dd|jr |j|d<|S)N)rr)rrr)rrrr_to_forum_tag_payloadr)rr8s rito_dictzForumTag.to_dict% suI# #  : ! NN4:;;== > > > > NNDTN : : : 7 $ GGDMrhc Hd|jd|jd|jd|jd S)Nz . rrhrr)rrrarqrrrrcrs rirzForumChannel.__repr__ s{ 47O TY   ' TY  D, -  55u5555564>*66V6666rhrc"|_|d_tj|d_|d_|d_|dd_|dd_ |d d _ tj|d _ fd |d gD}|dd_ tt|dd_d|D_d_|d}|rKt%jjtj|dpd|dpd_d_|d}|tt,|_|dd_|dS)NrrrnrarqFrrrtrrcRg|]#}tj|$S)r)r5rr)rtagrs rirz(ForumChannel._update.. s.jjjC""3"??jjjrhrrdefault_forum_layoutci|] }|j| SrgrDrrs rirz(ForumChannel._update.. s4Q4Q4QSSVS4Q4Q4Qrhrrrr)rrrrflags)rrr"rrrrnrarqrortrrurrrrrr)rrrrrr)rrrtagsrrs` rirzForumChannel._update s! f */*A$ *T*T$(HHW$5$5 !*- ((6511 #'88,A1#E#EDHHHMlnrDsDs*.3.EdL].^.^jjjj488TdfhKiKijjj26((;_ab2c2c*/7RhjkIlIl/m/m4Q4QD4Q4Q4Q>B#!%*B!C!C ! *6*Ak*+A:NNVRV+// ==C+++D ' =A!XX&:;;  )&.~?Q&R&RD #88GQ//  d#####rh-Literal[ChannelType.forum, ChannelType.media]cH|jdkr tjStjS)r)rrmediaforumrs rirzForumChannel.type s# :  $ $  rhr`c$tjjSrrrs rirzForumChannel._sorting_bucket rrhrc4fdjjDS)zmList[:class:`Member`]: Returns all members that can see this channel. .. versionadded:: 2.5 cHg|]}|j|Srgr r s rirz(ForumChannel.members.. rrhrrs`rirzForumChannel.members s% XWWW4:-WWWWrhrcdSrrgrs rirz)ForumChannel._scheduled_event_entity_type rrhrrrct|}||tj}|xj|jzc_|Srrrs rirzForumChannel.permissions_for rrhrrcb|j|}||j|jkr|SdS)aReturns a thread with the given ID. .. note:: This does not always retrieve archived threads, as they are not retained in the internal cache. Use :func:`Guild.fetch_channel` instead. .. versionadded:: 2.2 Parameters ----------- thread_id: :class:`int` The ID to search for. Returns -------- Optional[:class:`Thread`] The returned thread or ``None`` if not found. N)rrrr)rrrs rirzForumChannel.get_thread s8(&&y11  &"2dg"="=MtrhrcXfdjjDS)z@List[:class:`Thread`]: Returns all the threads that you can see.c4g|]}|jjk|Srgrrs rirz(ForumChannel.threads.. rrhrrs`rirzForumChannel.threads s1baaaTZ%8%?%?%A%Aaaaarhr*c4tj|jS)ze:class:`ChannelFlags`: The flags associated with this thread. .. versionadded:: 2.1 )r* _from_valuerrs rirzForumChannel.flags s ' 444rhrcXtj|jS)zsSequence[:class:`ForumTag`]: Returns all the available tags for this forum. .. versionadded:: 2.1 )r" SequenceProxyrrrs rirzForumChannel.available_tags s$ "4#7#>#>#@#@AAArhtag_idOptional[ForumTag]c6|j|S)a6Returns the tag with the given ID. .. versionadded:: 2.1 Parameters ---------- tag_id: :class:`int` The ID to search for. Returns ------- Optional[:class:`ForumTag`] The tag with the given ID, or ``None`` if not found. )rr)rrs riget_tagzForumChannel.get_tag s#''///rhrpc|jS)z+:class:`bool`: Checks if the forum is NSFW.rrs rirzForumChannel.is_nsfw+ rrhc6|jtjjkS)z`:class:`bool`: Checks if the channel is a media channel. .. versionadded:: 2.4 )rrrrrs riis_mediazForumChannel.is_media/ s z[.444rhNrOrr^r.r/r_clK|j|j|j|jd|jD|jd}|jr|jj|d<|jr|j |d<| s|j r|j j|d<| ||||d{VS)Nc6g|]}|Srgrrs rirz&ForumChannel.clone..C s LLLs{{}}LLLrh)rnrrqrtrrrrrr9) rnrorqrtrrurrrrrrr;r<s rir=zForumChannel.clone6 sZ#'#6I-1-OLL8KLLL262T     " G)-)@)FD% &  & a-1-H-^-^-`-`D) *}} E4#6 E+/+>+DD' (%%  &         rhc KdSrrgrs rir(zForumChannel.editT rrh.r)rac KdSrrgr+s rir(zForumChannel.editW r,rh)r_rrnrarqr-r.rortrrsrrurrr require_tagrnrqr-rortr=rrrsr0rrurrrrrrrc KdSrrg)rr_rrnrarqr-r.rortrrsrrurrrrs rir(zForumChannel.editZ s *srhr2rOptional[ForumChannel]cfK |d}d|D|d<n#t$rYnwxYw |d}|d|d<nt|tr*||d<nOt|t r)tj||d<n#t$rYnwxYw |d}|j }||_ |j |d<n#t$rYnwxYw |d}t|tstd|jj|j |d <n#t$rYnwxYw |d }|d|d <nLt|t std |jj|j |d <n#t$rYnwxYw||| d{V} | "||j|j| SdS)a |coro| Edits the forum. You must have :attr:`~Permissions.manage_channels` to do this. Parameters ---------- name: :class:`str` The new forum name. topic: :class:`str` The new forum's topic. position: :class:`int` The new forum's position. nsfw: :class:`bool` To mark the forum as NSFW or not. sync_permissions: :class:`bool` Whether to sync permissions with the forum's new or pre-existing category. Defaults to ``False``. category: Optional[:class:`CategoryChannel`] The new category for this forum. Can be ``None`` to remove the category. slowmode_delay: :class:`int` Specifies the slowmode rate limit for user in this forum, in seconds. A value of ``0`` disables slowmode. The maximum value possible is ``21600``. type: :class:`ChannelType` Change the type of this text forum. Currently, only conversion between :attr:`ChannelType.text` and :attr:`ChannelType.news` is supported. This is only available to guilds that contain ``NEWS`` in :attr:`Guild.features`. reason: Optional[:class:`str`] The reason for editing this forum. Shows up on the audit log. overwrites: :class:`Mapping` A :class:`Mapping` of target (either a role or a member) to :class:`PermissionOverwrite` to apply to the forum. default_auto_archive_duration: :class:`int` The new default auto archive duration in minutes for threads created in this channel. Must be one of ``60``, ``1440``, ``4320``, or ``10080``. available_tags: Sequence[:class:`ForumTag`] The new available tags for this forum. .. versionadded:: 2.1 default_thread_slowmode_delay: :class:`int` The new default slowmode delay for threads in this channel. .. versionadded:: 2.1 default_reaction_emoji: Optional[Union[:class:`Emoji`, :class:`PartialEmoji`, :class:`str`]] The new default reaction emoji for threads in this channel. .. versionadded:: 2.1 default_layout: :class:`ForumLayoutType` The new default layout for posts in this forum. .. versionadded:: 2.2 default_sort_order: Optional[:class:`ForumOrderType`] The new default sort order for posts in this forum. .. versionadded:: 2.3 require_tag: :class:`bool` Whether to require a tag for threads in this channel or not. .. versionadded:: 2.1 Raises ------ ValueError The new ``position`` is less than 0 or greater than the number of channels. TypeError The permission overwrite information is not in proper form or a type is not the expected type. Forbidden You do not have permissions to edit the forum. HTTPException Editing the forum failed. Returns -------- Optional[:class:`.ForumChannel`] The newly edited forum channel. If the edit was only positional then ``None`` is returned instead. rc6g|]}|Srgrrs rirz%ForumChannel.edit.. s (G(G(G3(G(G(GrhrNrrrz7default_layout parameter must be a ForumLayoutType not rrz:default_sort_order parameter must be a ForumOrderType not r)r4)rVKeyErrorrHr(rrrmr)rrrrrrrrcrr6rr) rr_r2rrrrlayout sort_orderr8s rir(zForumChannel.editq sd H'.{{3C'D'DD)H(G$(G(G(GG$ % %    D  z?F{{Kc?d?d "&-480112I>> z4J4V4V4X4X4n4n4p4p0112C88 z4@4IJ`4a4a4w4w4y4y01    D  +!++m44KJE +E ${GG       D  ;[[!122Ffo66 w uZ`ZjZs u uvvv.4lG* + +     D  A %9::J!04,--!*n==#tU_UiUrtt1;0@,--    D  76 ::::::::  >> 4:G>TT T  sS) 66C C"!C"&D D! D!%E66 FFG G-,G-F)rrr_rOptional[PartialEmoji]rr5cKt|j}t|||}|||jj|j|d|Dd{V} t|ddd|_n#tttf$rYnwxYw|S)aT|coro| Creates a new tag in this forum. You must have :attr:`~Permissions.manage_channels` to do this. Parameters ---------- name: :class:`str` The name of the tag. Can only be up to 20 characters. emoji: Optional[Union[:class:`str`, :class:`PartialEmoji`]] The emoji to use for the tag. moderated: :class:`bool` Whether the tag can only be applied by moderators. reason: Optional[:class:`str`] The reason for creating this tag. Shows up on the audit log. Raises ------ Forbidden You do not have permissions to create a tag in this forum. HTTPException Creating the tag failed. Returns ------- :class:`ForumTag` The newly created tag. )rrrc6g|]}|Srgrrs rirz+ForumChannel.create_tag..' s 3S3S3ScCKKMM3S3S3Srh)r_rNrrr) rIrrr5rrrL edit_channelrr`r IndexErrorr)rrrrr_priorresultr8s ri create_tagzForumChannel.create_tag sLT)002233t5IFFF V (55 GF3S3SU3S3S3S6         G$45b9$?@@FII*j1    D  s&B//C C ) rrofilefilesallowed_mentionsmention_author applied_tagssuppress_embedssilentr_rrZrrMrSequence[File]rrGrrviewrUrrrc  KdSrrg) rrrrorrrrrrrrr_s rirzForumChannel.create_thread0 s  Crh)rrocontentttsembedembedsrrstickersrrrrrrr_rrrrCrSequence[Embed]r*Sequence[Union[GuildSticker, StickerItem]]rTc KdSrrg)rrrrorrrrrrrrrrrrrr_s rirzForumChannel.create_threadB s * CrhrScK|j}|j}| turt}n d| D}|r,t|dst d|jj|s|r#tjd}||_ ||_ nt}|rt|nt}||p|j |dd}| turd| D|d<t|||| ||| || turd n| |||| 5}d d lm}|j|j|| d {V}t'|j|j|}||j||d}|rH|s4|r |j||jt1||cd d d S#1swxYwYd S)ar|coro| Creates a thread in this forum. This thread is a public thread with the initial message given. Currently in order to start a thread in this forum, the user needs :attr:`~discord.Permissions.send_messages`. You must send at least one of ``content``, ``embed``, ``embeds``, ``file``, ``files``, or ``view`` to create a thread in a forum, since forum channels must have a starter message. Parameters ----------- name: :class:`str` The name of the thread. auto_archive_duration: :class:`int` The duration in minutes before a thread is automatically hidden from the channel list. If not provided, the channel's default auto archive duration is used. Must be one of ``60``, ``1440``, ``4320``, or ``10080``, if provided. slowmode_delay: Optional[:class:`int`] Specifies the slowmode rate limit for user in this channel, in seconds. The maximum value possible is ``21600``. By default no slowmode rate limit if this is ``None``. content: Optional[:class:`str`] The content of the message to send with the thread. tts: :class:`bool` Indicates if the message should be sent using text-to-speech. embed: :class:`~discord.Embed` The rich embed for the content. embeds: List[:class:`~discord.Embed`] A list of embeds to upload. Must be a maximum of 10. file: :class:`~discord.File` The file to upload. files: List[:class:`~discord.File`] A list of files to upload. Must be a maximum of 10. allowed_mentions: :class:`~discord.AllowedMentions` Controls the mentions being processed in this message. If this is passed, then the object is merged with :attr:`~discord.Client.allowed_mentions`. The merging behaviour only overrides attributes that have been explicitly passed to the object, otherwise it uses the attributes set in :attr:`~discord.Client.allowed_mentions`. If no object is passed at all then the defaults given by :attr:`~discord.Client.allowed_mentions` are used instead. mention_author: :class:`bool` If set, overrides the :attr:`~discord.AllowedMentions.replied_user` attribute of ``allowed_mentions``. applied_tags: List[:class:`discord.ForumTag`] A list of tags to apply to the thread. view: Union[:class:`discord.ui.View`, :class:`discord.ui.LayoutView`] A Discord UI View to add to the message. stickers: Sequence[Union[:class:`~discord.GuildSticker`, :class:`~discord.StickerItem`]] A list of stickers to upload. Must be a maximum of 3. suppress_embeds: :class:`bool` Whether to suppress embeds for the message. This sends the message without any embeds if set to ``True``. silent: :class:`bool` Whether to suppress push and desktop notifications for the message. This will increment the mention counter in the UI, but will not actually send a notification. .. versionadded:: 2.7 reason: :class:`str` The reason for creating a new thread. Shows up on the audit log. Raises ------- Forbidden You do not have permissions to create a thread. HTTPException Starting the thread failed. ValueError The ``files`` or ``embeds`` list is not of the appropriate size. TypeError You specified both ``file`` and ``files``, or you specified both ``embed`` and ``embeds``. Returns -------- Tuple[:class:`Thread`, :class:`Message`] The created thread with the created message. This is also accessible as a namedtuple with ``thread`` and ``message`` fields. cg|] }|j SrgrD)rss rirz.ForumChannel.create_thread.. s)A)A)A1!$)A)A)Arh__discord_ui_view__z view parameter must be View not r )rrrrc6g|]}t|jSrg)rmrrs rirz.ForumChannel.create_thread.. s .S.S.Sss36{{.S.S.SrhrN) rrrrrrrprevious_allowed_mentionsrrrrchannel_payloadr)rD)paramsr_rr)rrr)rr)rrr#hasattrrrrcr+rrsuppress_notificationsrmrtr,rrDrLstart_thread_in_forumrr'r is_finishedis_dispatchable store_viewr)rrrrorrrrrrrrrrrrrr_rprevious_allowed_mention sticker_idsrrrrDrrrs rirzForumChannel.create_threadY sH #(#9 w  !KK)A)A)A)A)AK  Z&;<< ZXt~?VXXYY Y  f  ,Q//E$3E !+1E ( (E")6#g,,,w%:%`d>`#1    w & &.S.Sl.S.S.SON + &-&>#1W#<#<44. +    E ( ( ( ( ( (99$'&Y_9````````D$*DKdKKKFgDKd9oVVVG 9D,,.. 943G3G3I3I 9 &&tWZ888$FGDDD1 E E E E E E E E E E E E E E E E E Es/B>F::F>F>rfcKddlmjjjd{V}fd|DS)rhrrHNc>g|]}j|jSrjrlrns rirz)ForumChannel.webhooks.. rprhrqrts` @riruzForumChannel.webhooks rvrhrwrxryrIcKddlm}|tj|}|jj|jt|||d{V}|j ||jS)a)|coro| Creates a webhook for this channel. You must have :attr:`~.Permissions.manage_webhooks` to do this. Parameters ------------- name: :class:`str` The webhook's name. avatar: Optional[:class:`bytes`] A :term:`py:bytes-like object` representing the webhook's default avatar. This operates similarly to :meth:`~ClientUser.edit`. reason: Optional[:class:`str`] The reason for creating this webhook. Shows up in the audit logs. Raises ------- HTTPException Creating the webhook failed. Forbidden You do not have permissions to create a webhook. Returns -------- :class:`Webhook` The created webhook. rrHNr{rkr|rs rir~zForumChannel.create_webhook s< %$$$$$  088F[%44TW3t99U[dj4kkkkkkkk!w!$dk::::rhrA)rSrUrSrUrrctKd}t|tjr|}n-|+tj|j}d} d}|&|dkrdSt dt||}|jj j |j||d{V}| dg}|D]6}t|j|jj | WV||d z}|dkrdS7| d d sdS||d })aReturns an :term:`asynchronous iterator` that iterates over all archived threads in this forum in order of decreasing :attr:`Thread.archive_timestamp`. You must have :attr:`~Permissions.read_message_history` to do this. .. versionadded:: 2.0 Parameters ----------- limit: Optional[:class:`bool`] The number of threads to retrieve. If ``None``, retrieves every archived thread in the channel. Note, however, that this would make it a slow operation. before: Optional[Union[:class:`abc.Snowflake`, :class:`datetime.datetime`]] Retrieve archived channels before the given date or ID. Raises ------ Forbidden You do not have permissions to get archived threads. HTTPException The request to get the archived threads failed. Yields ------- :class:`Thread` The archived threads. Nc|ddSrrgrs rirz/ForumChannel.archived_threads..Z rrhTrArrrrrrrFr)rHrrr"rrrrrrrLrrr') rrSrUrrrrrrs rirzForumChannel.archived_threads1 ssD  fh/ 0 0 K%//11    $3FI>>HHJJ QQ  :H A::Fq#h"6"677*/KKDG\lt|K}}}}}}}}Dhhy"--G%   4:TZ5FZXXXXXXX$QJEzz88J.. ,}WR[99 - :rh)rrJrrQrrr)rrQrrrr)rrrrrrrr)rr*)rr)rr`rrr)rr^r.r/r_r^rr6rr)$r_r^rrmrnrmrar`rqrpr-rpr.r/ror`rtr=rrrsr0rrrur`rrrrrrrrprr6)r_r^r2rrr) rrmrrrrpr_r^rr5)rrmrr=rorZrrMrrrrGrrprrrrUrrprrpr_r^rr)$rrmrr=rorZrr^rrprrCrrrrMrrrrrrGrrprrrrTrrprrpr_r^rr)$rrmrr=rorZrr^rrprrCrrrrMrrrrrrGrrprrrrSrrprrpr_r^rrrr)rSrZrUrrr)$rcrdrerrrrrrrrrrr"rrarbrRrrrrrrrrr=rr(rrr#rur~rrrs@rir6r6; sDDLI."""" 7 7 7 7$$$$B!!!X! &&&X&XXXXXXU^GK,<==>=2bbbXb555X5BBBXB0000"5555U^GK,233# $      43 :%%%X% CFTTTTTXT !$!$.1!?BBE-0-0;>*--0'X,59JUJUJUJUJUJU`)- $ 111111f 8;(+ #,/"+. # #     X " 8;(+!$"% #?B,/"+. # #'     X 48?(,!%") '?F,3&+2 % $'YEYEYEYEYEYEvHHHH.LPim$;$;$;$;$;$;R #@D A:A:A:A:A:A:A:A:A:A:rhr6ceZdZdZdZd$d Zd%d Zd&dZd&dZe d'dZ e d(dZ e d)dZ e d*dZe d&dZe d+dZd,d-d Zd.d#ZdS)/r3aRepresents a Discord direct message channel. .. container:: operations .. describe:: x == y Checks if two channels are equal. .. describe:: x != y Checks if two channels are not equal. .. describe:: hash(x) Returns the channel's hash. .. describe:: str(x) Returns a string representation of the channel Attributes ---------- recipient: Optional[:class:`User`] The user you are participating with in the direct message channel. If this channel is received through the gateway, the recipient information may not be always available. recipients: List[:class:`User`] The users you are participating with in the DM channel. .. versionadded:: 2.4 me: :class:`ClientUser` The user presenting yourself. id: :class:`int` The direct message channel ID. )r recipientsmerrrNrrJrDMChannelPayloadc|_fd|dgD|_||_t |d|_dS)Nc:g|]}|Srg) store_user)rurs rirz&DMChannel.__init__.. s'&_&_&_qu'7'7':':&_&_&_rhrr)rrrrr`rrrrrs ` rirzDMChannel.__init__ sP', &_&_&_&_DHH\[]D^D^&_&_&_ 4:rhrr;c K|Srrgrs rirzDMChannel._get_channel rrhrmc(|jr d|jSdS)NzDirect Message with z Direct Message with Unknown User) recipientrs rirzDMChannel.__str__ s" > ;:$.:: :11rhc(d|jd|jdS)Nz.M s)&e&e&eQt{'='=a'@'@&e&e&erhrc$|jjkSr)rr-)r rs rirz,GroupChannel._update_group..S saddm.Crh) r"rr-rr/rrrrr.findr<s` rir2zGroupChannel._update_groupI s','>tZ'P'P $(HHV$4$4 #'88F#3#3 &e&e&e&e$((S_acJdJd&e&e&e & =DGJ & &DJJJ$C$C$C$CT_UUDJJJrhr;c K|Srrgrs rirzGroupChannel._get_channelU rrhrmc|jr|jSt|jdkrdSdt d|jS)NrUnnamedz, c|jSrr)xs rirz&GroupChannel.__str__.._ sqvrh)rrKrrmaprs rirzGroupChannel.__str__X sP 9 9  t  1 $ $9yy--t??@@@rhc(d|jd|jdS)Nz||_||_||_||_dSr)rrrr)rrrrrs rirzPartialMessageable.__init__ s"', '/ +/ rhrrmcBd|jjd|jd|jdS)Nrrz type=r)rrcrrrs rirzPartialMessageable.__repr__ s,M4>*MMMMtyMMMMrhc K|Srrgrs rirzPartialMessageable._get_channel rrhrc@|j|jS)zCOptional[:class:`Guild`]: The guild this partial messageable is in.)r _get_guildrrs rirzPartialMessageable.guild s{%%dm444rhcH|j d|jSd|jd|jS)zJ:class:`str`: Returns a URL that allows the client to jump to the channel.Nrzhttps://discord.com/channels//)rrrs rirzPartialMessageable.jump_url s6 = @tw@@ @Ht}HHtwHHHrhr!c4tj|jSrHr#rs rirzPartialMessageable.created_at r$rhrrrc(tjS)aXHandles permission resolution for a :class:`User`. This function is there for compatibility with other channel types. Since partial messageables cannot reasonably have the concept of permissions, this will always return :meth:`Permissions.none`. Parameters ----------- obj: :class:`User` The user to check permissions for. This parameter is ignored but kept for compatibility with other ``permissions_for`` methods. Returns -------- :class:`Permissions` The resolved permissions. )rnoner's rirz"PartialMessageable.permissions_fors(!!!rhcd|jdS)zn:class:`str`: Returns a string that allows you to mention the channel. .. versionadded:: 2.5 z<#rrDrs rimentionzPartialMessageable.mentions DGrhrPrEc(ddlm}|||S)aCreates a :class:`PartialMessage` from the message ID. This is useful if you want to work with a message and only have its ID without doing an unnecessary API call. Parameters ------------ message_id: :class:`int` The message ID to create a partial message for. Returns --------- :class:`PartialMessage` The partial message. rrrrrs rirz&PartialMessageable.get_partial_message!s+" ,+++++~dz::::rh)NN)rrJrr`rrZrrr)rr8r)r*rr+r)rcrdrerrrrrrrrrr\rrgrhrir8r8 sB00000 NNNN555X5IIIXI ---X-""""",X;;;;;;rhr8 channel_typer`cvtt|}|tjur t|fS|tjur t |fS|tjur t|fS|tjur t|fS|tj ur t|fS|tj ur t|fS|tj ur t|fSd|fSr)rrrr0rr1r.r4rr.r2rr6r)r^rs ri_guild_channel_factoryr`7s [, / /E    E!! +# # #U"" +& & &%% +" " "E!! +) ) )U"" +# # #U"" +# # #U""U{rhct|\}}|tjur t|fS|tjur t |fS||fSr)r`rrr3rAr7r^rrs ri_channel_factoryrcKsO' 55JC ###% +# # #U""Ezrhct|\}}|tjtjtjfvr t |fS||fSr)rcrr public_thread news_threadr'rbs ri_threaded_channel_factoryrgUsB!,//JC +[-F H_```u} :rhct|\}}|tjtjtjfvr t |fS||fSr)r`rrrerfr'rbs ri_threaded_guild_channel_factoryri\sB' 55JC +[-F H_```u} :rh)r^r`)r __future__rtypingrrrrrr r r r r rrrrrrrr discord.abcrar5r permissionsrrenumsrrrrrrrr mixinsr!rr"r#assetr$errorsr%rr&rr' partial_emojir(r)rr*r+rLr,objectr- soundboardr.r/__all__typing_extensionsr;r< types.threadsr=roler>rr?r@rbrArBrrCrrDrErFmentionsrGrrrIrrJstickerrKrLrrMrrNrOrPrrQrRGuildChannelTypeui.viewrSrTrU types.channelr0TextChannelPayloadrVNewsChannelPayloadr1VoiceChannelPayloadr2rr3r r4rDrWr0r6ForumChannelPayloadrXMediaChannelPayloadr5rr9rtypes.snowflakerYtypes.soundboardBaseSoundboardSoundPayloadrZr[r]rlrwr~rrrr: Messageable ConnectablerPrivateChannelr7r8r`rcrgrirgrhrirs. 0#"""""&++++++99999999                    ######))))))22222222--------++++++CCCCCCCC H+........444444********--------@@@@@@@@@@))))))      &&&&&&222222220000000000>>>>>>>>3333333333                          /.....SSSSSS++++++GOT8VU4QWY_K_E`aaMIU+++++$=U++++NNNNN%>eNNNNNNNNN%?uNNNN + + + + +%>e + + + +  ********* 3-3-3-3-3-13-3-3-l5&5&5&5&5&5&5&5&pT :T :T :T :T :'+)7;+CXT :T :T :n{ { { { {  /1H'+Jbdl{ { { | aIaIaIaIaI$aIaIaIHCUCUCUCUCU$CUCUCUL EMEMEMEMEMgk.EMEMEMPVVVVVxVVVrw :w :w :w :w :7;+Xw :w :w :tb;b;b;b;b; ')CXb;b;b;Jg4g4g4g4g47;*GK,Fg4g4g4Tp;p;p;p;p;0(p;p;p;f(rh