i UdZddlmZddlZddlZddlZddlmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZddlZddlZddlTer ddlmZddlmZdd lmZdd lm Z m!Z!dd l"m#Z#d Z$djdZ%ej&j'Z(edZ)eddZ*edej+j,Z-edejZ.eGddee*Z/ej0dZ1Gdd e/e*Z2Gd!d"e2ej3Z4Gd#d$e2ej5Z6Gd%d&e2ej7Z8Gd'd(e/ej9Z:Gd)d*e2ej;Z<Gd+d,e2ej+j,Z=Gd-d.e2ej>Z?Gd/d0e2ej@ZAGd1d2e2ejBZCGd3d4e2ejDZEGd5d6e2ejZFGd7d8e2ejGZHGd9d:e/ejIZJeJZKGd;de/ejNZOGd?d@e/ejPZQGdAdBe2ejRZSGdCdDe2ejTZUGdEdFe/ejVZWGdGdHe2ejXZYerejZZnGdIdJe/e[ZZGdKdLe2ej\Z]GdMdNe2ej^Z_GdOdPe/e[Z`GdQdRe e)ZaerddSlbmcZdn GdTdUZddkdWZeefe e)ZgegdXdld\Zhiej3e4ej5e6ej7e8ej;e<ej9e:ej>e?ejPeQejReSejLeMejNeOejIeJej@eAejBeCejTeUejVeWejDeEejeFej+j,e=ejXeYej\e]ejGeHej^e_iZid]ejd^<dmddZkedndgZledodhZldodiZldS)pa: The MIT License (MIT) Copyright (c) 2015-present Rapptz Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ) annotationsN) TYPE_CHECKINGAnyDictGenericIterableListLiteralOptionaloverloadProtocolTupleTypeTypeVarUnionruntime_checkable)*)Channel)Thread) Parameter)BotT_Bot)Context) ConverterObjectConverterMemberConverter UserConverterMessageConverterPartialMessageConverterTextChannelConverterInviteConverterGuildConverter RoleConverter GameConverterColourConverterColorConverterVoiceChannelConverterStageChannelConverterEmojiConverterPartialEmojiConverterCategoryChannelConverterForumChannelConverter IDConverterThreadConverterGuildChannelConverterGuildStickerConverterScheduledEventConverterSoundboardSoundConverter clean_contentGreedyRange Timestamprun_convertersbotrgetterstrargumentrreturnc\d}|jD]!}t|||}|r|cS"|SN)guildsgetattr)r9r:r<resultguilds _/usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages/discord/ext/commands/converter.py_get_from_guildsrE_sL F'''11  MMM  MTT_coT) covariantCT)boundTTceZdZdZd dZd S) raThe base class of custom converters that require the :class:`.Context` to be passed to be useful. This allows you to implement converters that function similar to the special cased ``discord`` classes. Classes that derive from this should override the :meth:`~.Converter.convert` method to do its conversion logic. This method must be a :ref:`coroutine `. ctx Context[BotT]r<r;r=rHc$Ktd)am|coro| The method to override to do conversion logic. If an error is found while converting, it is recommended to raise a :exc:`.CommandError` derived exception as it will properly propagate to the error handlers. Note that if this method is called manually, :exc:`Exception` should be caught to handle the cases where a subclass does not explicitly inherit from :exc:`.CommandError`. Parameters ----------- ctx: :class:`.Context` The invocation context that the argument is being used in. argument: :class:`str` The argument that is being converted. Raises ------- CommandError A generic exception occurred when converting the argument. BadArgument The converter failed to convert the argument. z'Derived classes need to implement this.)NotImplementedErrorselfrNr<s rDconvertzConverter.convert{s6""KLLLrFN)rNrOr<r;r=rH__name__ __module__ __qualname____doc__rTrFrDrros8MMMMMMrFrz([0-9]{15,20})$c$eZdZedZdS)r.c6t|Sr?) _ID_REGEXmatch)r<s rD _get_id_matchzIDConverter._get_id_matchsx(((rFN)rVrWrX staticmethodr_rZrFrDr.r.s-))\)))rFr.ceZdZdZd dZd S) ra"Converts to a :class:`~discord.Object`. The argument must follow the valid ID or mention formats (e.g. ``<@80088516616269824>``). .. versionadded:: 2.0 The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by member, role, or channel mention. rNrOr<r;r=discord.ObjectcK||ptjd|}|t|t |d}t j|S)Nz <(?:@(?:!|&)?|#)([0-9]{15,20})>$rid)r_rer^ObjectNotFoundintgroupdiscordObject)rSrNr<r^rBs rDrTzObjectConverter.convertsi""8,,g9\^f0g0g = ** *U[[^^$$~((((rFN)rNrOr<r;r=rbrUrZrFrDrrs2  ))))))rFrc*eZdZdZddZdd ZddZdS)raConverts to a :class:`~discord.Member`. All lookups are via the local guild. If in a DM context, then the lookup is done by the global cache. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by mention. 3. Lookup by username#discriminator (deprecated). 4. Lookup by username#0 (deprecated, only gets users that migrated from their discriminator). 5. Lookup by user name. 6. Lookup by global name. 7. Lookup by guild nickname. .. versionchanged:: 1.5 Raise :exc:`.MemberNotFound` instead of generic :exc:`.BadArgument` .. versionchanged:: 1.5.1 This converter now lazily fetches members from the gateway and HTTP APIs, optionally caching the result if :attr:`.MemberCacheFlags.joined` is enabled. .. deprecated:: 2.3 Looking up users by discriminator will be removed in a future version due to the removal of discriminators in an API change. rC discord.Guildr<r;r=Optional[discord.Member]cd K|jjj}d\ } s c dks't dkrr } fd}n}fd}||d|d{V}tj ||S)N#0c0|jko |jkSr?name discriminator)mrvusernames rDz4MemberConverter.query_member_named..!&H"4"YM9YrFcF|jkp|jkp |jkSr?)ru global_namenick)rwr<s rDryz4MemberConverter.query_member_named..s)!&H"4"g 8Q"gUVU[_gUgrFd)limitcache) _statemember_cache_flagsjoined rpartitionlenisdigit query_membersrjutilsfind) rSrCr<r_lookup predicatemembersrvrxs ` @@rDquery_member_namedz"MemberConverter.query_member_nameds /6%-%8%8%=%="!] >&. #M8 C  C $6$6!$;$; @U@U@W@W$;FYYYYYIIFggggI++F#U+KKKKKKKK}!!)W555rFr9ruser_idrhctK||j}|jjj}|rL ||d{V}n#tj$rYdSwxYw|r| ||S| d|g|d{V}|sdS|dS)N)shard_idr)ruser_idsrr) _get_websocketrrrris_ratelimited fetch_memberrj HTTPException _add_memberr)rSr9rCrwsrmemberrs rDquery_member_by_idz"MemberConverter.query_member_by_ids     8 8 /6      $11'::::::::(   tt  *!!&)))M++!wiu+UUUUUUUU 4qzsA A32A3rNrOdiscord.MembercK|j}||ptjd|}|j}d}d}|*|r||}nxt |d|}nft|d}|r1| |pt|j j |}nt |d|}t|tjs^|t!||||||d{V}n|||d{V}|st!||S)N<@!?([0-9]{15,20})>$get_member_namedrrd get_member)r9r_rfr^rCrrErhrir _utils_getmessagementions isinstancerjMemberMemberNotFoundrr)rSrNr<r9r^rCrBrs rDrTzMemberConverter.convertssg""8,,[9PRZ0[0[  = M//99)#/A8LL%++a..))G F))'22bjAUZa6b6b6b)#|WEE&'.11 /}$X..."#66sE7KKKKKKKK#66uhGGGGGGGG /$X... rFN)rCrmr<r;r=rn)r9rrCrmrrhr=rn)rNrOr<r;r=r)rVrWrXrYrrrTrZrFrDrrsZ66666$*      rFrceZdZdZd dZd S) ra9Converts to a :class:`~discord.User`. All lookups are via the global user cache. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by mention. 3. Lookup by username#discriminator (deprecated). 4. Lookup by username#0 (deprecated, only gets users that migrated from their discriminator). 5. Lookup by user name. 6. Lookup by global name. .. versionchanged:: 1.5 Raise :exc:`.UserNotFound` instead of generic :exc:`.BadArgument` .. versionchanged:: 1.6 This converter now lazily fetches users from the HTTP APIs if an ID is passed and it's not available in cache. .. deprecated:: 2.3 Looking up users by discriminator will be removed in a future version due to the removal of discriminators in an API change. rNrOr<r;r= discord.Userc K|ptjd}d}|j}|t |d}|j|pt|j j |}|E |j |d{V}n##tj $rtdwxYw|Sd\ } s c dks't! dkr r fd}nfd}tj||j}|t|S) Nrrrdrprqrrc0|jko |jkSr?rt)urvrxs rDryz'UserConverter.convert..QrzrFc0|jkp |jkSr?)rur|)rr<s rDryz'UserConverter.convert..Ss!&H"4"Q 8QrF)r_rfr^rrhrir9get_userrrr fetch_userrjr UserNotFoundrrrrr_usersvalues) rSrNr<r^rBstaterrrrvrxs ` @@rDrTzUserConverter.convert:s""8,,[9PRZ0[0[   %++a..))GW%%g..^*S[=QV]2^2^2^F~;#&7#5#5g#>#>>>>>>>FF,;;;&x00d:;M%-%8%8%=%="!] >&. #M8 C  C $6$6!$;$; @U@U@W@W$;YYYYYIIQQQQI##Iu|/B/B/D/DEE >x(( ( s  B66 CN)rNrOr<r;r=rrUrZrFrDrr s22rFrcJeZdZdZeddZedd ZddZdS)r a7Converts to a :class:`discord.PartialMessage`. .. versionadded:: 1.7 The creation strategy is as follows (in order): 1. By "{channel ID}-{message ID}" (retrieved by shift-clicking on "Copy ID") 2. By message ID (The message is assumed to be in the context channel.) 3. By message URL rNrOr<r;r=Tuple[Optional[int], int, int]ctjd}tjd}||p||}|st||}t j|dp |jj }t|d}| d}||j o |j j }n|dkrd}nt|}|||fS)Nz?(?:(?P[0-9]{15,20})-)?(?P[0-9]{15,20})$zhttps?://(?:(ptb|canary|www)\.)?discord(?:app)?\.com/channels/(?P[0-9]{15,20}|@me)/(?P[0-9]{15,20})/(?P[0-9]{15,20})/?$ channel_id message_idguild_idz@me) rfcompiler^MessageNotFound groupdictrjr_get_as_snowflakechannelrerhgetrC) rNr<id_regex link_regexr^datarrrs rD_get_id_matchesz'PartialMessageConverter._get_id_matcheshs:`aaZ M  x((FJ,<,>  N)::3*UU .j'+2IJJ .!*-- - . ..z:::::::: : , , ,!(++ +  . . .$W-- - .s B--$ruc:t|o |jkSr?)rru)cr<rs rDcheckz5GuildChannelConverter._resolve_channel..checks%a..E16X3EErFrr)r9r.r_rfr^r0rrCrArjrrrget_all_channelsrhrirrErr) rNr<rrr9r^rBrCiterablerrs ` ` rDrz&GuildChannelConverter._resolve_channelsKg  % %h / / ?x-x88 ?$44X>>    = K)0 )B)B'.}'8'8'8'Q'QFFFFFF!++E33G3G3I3IJJU[[^^,,J J**:66)#}jII&$'' ,!(++ + rFType[TT]rLct|p.tjd|pt|}d}|j}|4|r1t||}tj ||}n9t| d}|r| |}|rt||st||S)Nrrr)r.r_rfr^r0rrCrArjrrrhri get_threadrThreadNotFound) rNr<rrr^rBrCr thread_ids rD_resolve_threadz%GuildChannelConverter._resolve_threads  % %h / / ?x-x88 ?$44X>>    = R)0 )B)B'.}'8'8'8'Q'QEKKNN++I 5)))44 +Z55 + ** * rFN)rNrOr<r;r=r)r<r;r=r) rNrOr<r;rr;rrr=rJ) rNrOr<r;rr;rrr=rL) rVrWrXrYrTr`rrrrZrFrDr0r0s$ZZZZ***\*!!!\!F\rFr0ceZdZdZd dZd S) r!a"Converts to a :class:`~discord.TextChannel`. All lookups are via the local guild. If in a DM context, then the lookup is done by the global cache. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by mention. 3. Lookup by channel URL. 4. Lookup by name .. versionchanged:: 1.5 Raise :exc:`.ChannelNotFound` instead of generic :exc:`.BadArgument` .. versionchanged:: 2.4 Add lookup by channel URL, accessed via "Copy Link" in the Discord client within channels. rNrOr<r;r=discord.TextChannelcTKt||dtjS)N text_channels)r0rrj TextChannelrRs rDrTzTextChannelConverter.convert's$$55c8_V]VijjjrFN)rNrOr<r;r=rrUrZrFrDr!r!s8&kkkkkkrFr!ceZdZdZd dZd S) r(a#Converts to a :class:`~discord.VoiceChannel`. All lookups are via the local guild. If in a DM context, then the lookup is done by the global cache. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by mention. 3. Lookup by channel URL. 4. Lookup by name .. versionchanged:: 1.5 Raise :exc:`.ChannelNotFound` instead of generic :exc:`.BadArgument` .. versionchanged:: 2.4 Add lookup by channel URL, accessed via "Copy Link" in the Discord client within channels. rNrOr<r;r=discord.VoiceChannelcTKt||dtjS)Nvoice_channels)r0rrj VoiceChannelrRs rDrTzVoiceChannelConverter.convert?%$55c8EUW^WklllrFN)rNrOr<r;r=rrUrZrFrDr(r(+s8&mmmmmmrFr(ceZdZdZd dZd S) r)aConverts to a :class:`~discord.StageChannel`. .. versionadded:: 1.7 All lookups are via the local guild. If in a DM context, then the lookup is done by the global cache. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by mention. 3. Lookup by channel URL. 4. Lookup by name .. versionchanged:: 2.4 Add lookup by channel URL, accessed via "Copy Link" in the Discord client within channels. rNrOr<r;r=discord.StageChannelcTKt||dtjS)Nstage_channels)r0rrj StageChannelrRs rDrTzStageChannelConverter.convertVrrFN)rNrOr<r;r=rrUrZrFrDr)r)Cs8$mmmmmmrFr)ceZdZdZd dZd S) r,a&Converts to a :class:`~discord.CategoryChannel`. All lookups are via the local guild. If in a DM context, then the lookup is done by the global cache. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by mention. 3. Lookup by channel URL. 4. Lookup by name .. versionchanged:: 2.4 Add lookup by channel URL, accessed via "Copy Link" in the Discord client within channels. .. versionchanged:: 1.5 Raise :exc:`.ChannelNotFound` instead of generic :exc:`.BadArgument` rNrOr<r;r=discord.CategoryChannelcTKt||dtjS)N categories)r0rrjCategoryChannelrRs rDrTz CategoryChannelConverter.convertns$$55c8\SZSjkkkrFN)rNrOr<r;r=rrUrZrFrDr,r,Zs8&llllllrFr,ceZdZdZd dZd S) r/aConverts to a :class:`~discord.Thread`. All lookups are via the local guild. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by mention. 3. Lookup by channel URL. 4. Lookup by name. .. versionadded: 2.0 .. versionchanged:: 2.4 Add lookup by channel URL, accessed via "Copy Link" in the Discord client within channels. rNrOr<r;r=discord.ThreadcTKt||dtjS)Nthreads)r0rrjrrRs rDrTzThreadConverter.converts"$44S(Iw~^^^rFN)rNrOr<r;r=rrUrZrFrDr/r/rs8"______rFr/ceZdZdZd dZd S) r-aConverts to a :class:`~discord.ForumChannel`. All lookups are via the local guild. If in a DM context, then the lookup is done by the global cache. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by mention. 3. Lookup by channel URL. 4. Lookup by name .. versionadded:: 2.0 .. versionchanged:: 2.4 Add lookup by channel URL, accessed via "Copy Link" in the Discord client within channels. rNrOr<r;r=discord.ForumChannelcTKt||dtjS)Nforums)r0rrj ForumChannelrRs rDrTzForumChannelConverter.converts#$55c8XwOcdddrFN)rNrOr<r;r=r rUrZrFrDr-r-s8$eeeeeerFr-ceZdZdZd dZd S) r&aConverts to a :class:`~discord.Colour`. .. versionchanged:: 1.5 Add an alias named ColorConverter The following formats are accepted: - ``0x`` - ``#`` - ``0x#`` - ``rgb(, , )`` - Any of the ``classmethod`` in :class:`~discord.Colour` - The ``_`` in the name can be optionally replaced with spaces. Like CSS, ```` can be either 0-255 or 0-100% and ```` can be either a 6 digit hex number or a 3 digit hex shortcut (e.g. #fff). .. versionchanged:: 1.5 Raise :exc:`.BadColourArgument` instead of generic :exc:`.BadArgument` .. versionchanged:: 1.7 Added support for ``rgb`` function and 3-digit hex shortcuts rNrOr<r;r=discord.ColourctK tj|S#t$r|dd}t tj|d}|ds|tj |st||cYSwxYw)N rfrom_) rjColourfrom_str ValueErrorlowerreplacerA startswithinspectismethodBadColourArgument)rSrNr<argmethods rDrTzColourConverter.converts >**844 4   ..""**344CW^S$77F~~g&& -&.@PQW@X@X.',,,688OOO  s#BB76B7N)rNrOr<r;r=rrUrZrFrDr&r&s22rFr&ceZdZdZd dZd S) r$aConverts to a :class:`~discord.Role`. All lookups are via the local guild. If in a DM context, the converter raises :exc:`.NoPrivateMessage` exception. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by mention. 3. Lookup by name .. versionchanged:: 1.5 Raise :exc:`.RoleNotFound` instead of generic :exc:`.BadArgument` rNrOr<r;r= discord.RolecK|j}|st||ptjd|}|r6|t |d}n8tj |j |}|t||S)Nz<@&([0-9]{15,20})>$rr)rCNoPrivateMessager_rfr^get_rolerhrirjrr_rolesr RoleNotFound)rSrNr<rCr^rBs rDrTzRoleConverter.converts  %"$$ $""8,,Z9OQY0Z0Z  M^^C A$7$788FF]&&u|':':'<'<8&LLF >x(( ( rFN)rNrOr<r;r=rrUrZrFrDr$r$s2        rFr$ceZdZdZd dZd S) r%z%Converts to a :class:`~discord.Game`.rNrOr<r;r= discord.Gamec0Ktj|S)Nr)rjGamerRs rDrTzGameConverter.converts|****rFN)rNrOr<r;r=r&rUrZrFrDr%r%s.//++++++rFr%ceZdZdZd dZd S) r"zConverts to a :class:`~discord.Invite`. This is done via an HTTP request using :meth:`.Bot.fetch_invite`. .. versionchanged:: 1.5 Raise :exc:`.BadInviteArgument` instead of generic :exc:`.BadArgument` rNrOr<r;r=discord.InvitecK |j|d{V}|S#t$r}t||d}~wwxYwr?)r9 fetch_invite ExceptionBadInviteArgument)rSrNr<inviteexcs rDrTzInviteConverter.convertsf 77//99999999FM 7 7 7#H--3 6 7s!& AAAN)rNrOr<r;r=r*rUrZrFrDr"r"s2777777rFr"ceZdZdZd dZd S) r#zConverts to a :class:`~discord.Guild`. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by name. (There is no disambiguation for Guilds with multiple matching names). .. versionadded:: 1.7 rNrOr<r;r=rmc0K||}d}|>**HW&&x00F >]&&sw~H&EEF~#H--- rFN)rNrOr<r;r=rmrUrZrFrDr#r#s2      rFr#ceZdZdZd dZd S) r*aConverts to a :class:`~discord.Emoji`. All lookups are done for the local guild first, if available. If that lookup fails, then it checks the client's global cache. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by extracting ID from the emoji. 3. Lookup by name .. versionchanged:: 1.5 Raise :exc:`.EmojiNotFound` instead of generic :exc:`.BadArgument` rNrOr<r;r= discord.EmojicK||ptjd|}d}|j}|j}|Q|r&t j|j|}|&t j|j|}n7t| d}| |}|t||S)Nz($rr) r_rfr^r9rCrjrremojisrhri get_emoji EmojiNotFound)rSrNr<r^rBr9rCemoji_ids rDrTzEmojiConverter.convert*s""8,,o9dfn0o0og  = H **5>**H]]8,,F >)) ) rFN)rNrOr<r;r=r6rUrZrFrDr*r*s2  rFr*ceZdZdZd dZd S) r+zConverts to a :class:`~discord.PartialEmoji`. This is done by extracting the animated flag, name and ID from the emoji. .. versionchanged:: 1.5 Raise :exc:`.PartialEmojiConversionFailure` instead of generic :exc:`.BadArgument` rNrOr<r;r=discord.PartialEmojic^Ktjd|}|rt|d}|d}t |d}t j|jj |||St|)Nz,<(a?):([a-zA-Z0-9\_]{1,32}):([0-9]{15,20})>$r)animatedrure) rfr^boolrirhrj PartialEmoji with_stater9rPartialEmojiConversionFailure)rSrNr<r^emoji_animated emoji_namer;s rDrTzPartialEmojiConverter.convertLsH(SS  !%++a..11NQJ5;;q>>**H'22#n:RZ3 ,H555rFN)rNrOr<r;r=r=rUrZrFrDr+r+Cs2 6 6 6 6 6 6rFr+ceZdZdZd dZd S) r1a4Converts to a :class:`~discord.GuildSticker`. All lookups are done for the local guild first, if available. If that lookup fails, then it checks the client's global cache. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by name. .. versionadded:: 2.0 rNrOr<r;r=discord.GuildStickercK||}d}|j}|j}|Q|r&tj|j|}|&tj|j|}n7t|d}| |}|t||S)Nrr) r_r9rCrjrrstickersrhri get_stickerGuildStickerNotFound)rSrNr<r^rBr9rC sticker_ids rDrTzGuildStickerConverter.convertis""8,,g  = J **5>*II~ **3&x00 0 rFN)rNrOr<r;r=rIrUrZrFrDr1r1[s2  rFr1ceZdZdZd dZd S) r7abConverts to a :class:`datetime.datetime`. Conversion is attempted based on the :ddocs:`Discord style timestamp ` input format. .. versionadded:: 2.7 .. warning:: Due to a Discord limitation, no timezone is provided with the input. The UTC timezone has been supplanted instead. rNrOr<r;r=datetime.datetimecKtjj|}|st |t jt|dt jj S)Nr)tz) rjrTIMESTAMP_PATTERNr^BadTimestampArgumentdatetime fromtimestamprhtimezoneutc)rSrNr<r^s rDrTzTimestamp.converts`M399(CCE 5*8444$223uQx==XEVEZ2[[ [rFN)rNrOr<r;r=rPrUrZrFrDr7r7s8   \ \ \ \ \ \rFr7ceZdZdZd dZd S) r2aBConverts to a :class:`~discord.ScheduledEvent`. Lookups are done for the local guild if available. Otherwise, for a DM context, lookup is done by the global cache. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by url. 3. Lookup by name. .. versionadded:: 2.0 rNrOr<r;r=discord.ScheduledEventc*K|j}||}d}|rdt|d}|r||}n$|jjD]}||}|rnnd}tj||tj }|rt|j t|d}|r7t|d}||}nb|r'tj |j|}n9|jjD],}tj |j|}|rn-|t||S)Nrzjhttps?://(?:(ptb|canary|www)\.)?discord\.com/events/(?P[0-9]{15,20})/(?P[0-9]{15,20})$)flagsrevent_idr)rCr_rhriget_scheduled_eventr9r@rfr^Irrjrrscheduled_eventsScheduledEventNotFound)rSrNr<rCr^rBr]patterns rDrTzScheduledEventConverter.converts ""8,,  "5;;q>>**H 228<< W^E"66x@@F/  HWhbd;;;E "))#ekk*.E.E*F*FGGA"5;;z#:#:;;H"66x@@F"$]..u/EH.UUFF!$""!(!2!253IPX!2!Y!Y!"!E" >(22 2 rFN)rNrOr<r;r=rZrUrZrFrDr2r2s2  ))))))rFr2ceZdZdZd dZd S) r3a-Converts to a :class:`~discord.SoundboardSound`. Lookups are done for the local guild if available. Otherwise, for a DM context, lookup is done by the global cache. The lookup strategy is as follows (in order): 1. Lookup by ID. 2. Lookup by name. .. versionadded:: 2.5 rNrOr<r;r=discord.SoundboardSoundcK|j}||}d}|rUt|d}|r||}no|j|}nT|r't j|j |}n+t j|jj |}|t||Sr3) rCr_rhriget_soundboard_soundr9rjrrsoundboard_soundsSoundboardSoundNotFound)rSrNr<rCr^rBsound_ids rDrTz SoundboardSoundConverter.converts ""8,,  U5;;q>>**H @33H==55h?? U **5+B*RR **37+D8*TT >)(33 3 rFN)rNrOr<r;r=rdrUrZrFrDr3r3s2  rFr3c.eZdZdZddddddd ZddZdS)r4awConverts the argument to mention scrubbed version of said content. This behaves similarly to :attr:`~discord.Message.clean_content`. Attributes ------------ fix_channel_mentions: :class:`bool` Whether to clean channel mentions. use_nicknames: :class:`bool` Whether to use nicknames when transforming mentions. escape_markdown: :class:`bool` Whether to also escape special markdown characters. remove_markdown: :class:`bool` Whether to also remove special markdown characters. This option is not supported with ``escape_markdown`` .. versionadded:: 1.7 FTfix_channel_mentions use_nicknamesescape_markdownremove_markdownrlrBrmrnror=Nonec>||_||_||_||_dSr?rk)rSrlrmrnros rD__init__zclean_content.__init__ s*%9!*..rFrNrOr<r;c Kjjrdfd }dfd }n dfd }dd}jrjrdfd }ndd }||||d  d fd }tjd||}jr t j|}n&jrt j|}t j |S)Nrerhr=r;ctj|pj|}|rdjr|jn|jndSNrd@z @deleted-user)rrrCrrm display_nameru)rerwrNmsgrSs rDresolve_memberz-clean_content.convert..resolve_membersVs|333Osy7K7KB7O7OQRgMT-?K1>>QVMMMXggrFctj|pj|}|r d|jndS)Nrdrv @deleted-role)r role_mentionsrCr"ru)rerrNrxs rD resolve_rolez+clean_content.convert..resolve_role#sDs0R888RCI.resolve_member)sGs|333Ksw7G7G7K7K/0E+1>+++oErFcdS)Nr{rZrds rDr~z+clean_content.convert..resolve_role-s&rFcTj|}|r d|jndS)Nrpz#deleted-channel)rCrru)rerrNs rDresolve_channelz.clean_content.convert..resolve_channel2s0I..r22'(@|16|||.@@rFcd|dS)Nz<#>rZrds rDrz.clean_content.convert..resolve_channel8s!Bzzz!rF)rvz@!rpz@&r^re.Matchcd|d}t|d}||}|S)Nrr?)rh)r^rre transformed transformss rDreplz#clean_content.convert..replBs58DU1XB**T*2..K rFz<(@[!&]?|#)([0-9]{15,20})>)rerhr=r;)r^rr=r;) rrCrlrfsubrnrjrroescape_mentions) rSrNr<ryr~rrrBrxrs `` @@rDrTzclean_content.convertsk 9 ' h h h h h h h h > > > > > > > >  F F F F F F F ' ' ' '  $ " " A A A A A A A  " " " "             5tXFF   ;]226::FF  ! ;]226::F},,V444rFN) rlrBrmrBrnrBrorBr=rp)rNrOr<r;r=r;)rVrWrXrYrrrTrZrFrDr4r4s^,&+" % % / / / / / /555555555555rFr4cFeZdZdZdZddZdd Zdd ZeddZ dS)r5aA special converter that greedily consumes arguments until it can't. As a consequence of this behaviour, most input errors are silently discarded, since it is used as an indicator of when to stop parsing. When a parser error is met the greedy converter stops converting, undoes the internal string parsing routine, and continues parsing regularly. For example, in the following code: .. code-block:: python3 @commands.command() async def test(ctx, numbers: Greedy[int], reason: str): await ctx.send("numbers: {}, reason: {}".format(numbers, reason)) An invocation of ``[p]test 1 2 3 4 5 6 hello`` would pass ``numbers`` with ``[1, 2, 3, 4, 5, 6]`` and ``reason`` with ``hello``\. For more information, check :ref:`ext_commands_special_converters`. .. note:: For interaction based contexts the conversion error is propagated rather than swallowed due to the difference in user experience with application commands.  converterrrGr=rpc||_dSr?rrSrs rDrrzGreedy.__init__ps %rFr;c^t|jdt|j}d|dS)NrVGreedy[])rArreprrs rD__repr__zGreedy.__repr__ss0DNJT^8L8LMM %%%%%rFparamsUnion[Tuple[T], T] Greedy[T]czt|ts|f}t|dkrtd|d}t |dd}t jjr |jtj ur t|}t |dd}t|s&t|ts|td|ttdfvs |t urtd|jd |tur$td|vrtd|d || S) Nrz(Greedy[...] only takes a single argumentr__args__rZ __origin__z3Greedy[...] expects a type or a Converter instance.rz ] is invalid.r)rtupler TypeErrorrArjrPY_310 __class__types UnionTypercallablerr;rr5rV)clsrrargsorigins rD__class_getitem__zGreedy.__class_getitem__wsE&%(( YF v;;!  FGG G1I y*b11 =  $I$75?$J$Jd IL$77## Sz)Y'G'G S6K]QRR R d4jj) ) )Vv-=-=Gi&8GGGHH H U??tDzzT11@i@@@AA AsY''''rFrctj|jrLt|jtr2tj|jjs|S|jSr?)risclassr issubclassrrrTrSs rDconstructed_converterzGreedy.constructed_converters` ODN + + $4>955 $$T^%;<< $ >>## #~rFN)rrGr=rpr=r;)rrr=rr=r) rVrWrXrY __slots__rrrrpropertyrrZrFrDr5r5Rs6I&&&&&&&&((((0XrFr5) AnnotatedcJeZdZdZddddd ZddZddZddZddZddZ dS)r6a<A special converter that can be applied to a parameter to require a numeric or string type to fit within the range provided. During type checking time this is equivalent to :obj:`typing.Annotated` so type checkers understand the intent of the code. Some example ranges: - ``Range[int, 10]`` means the minimum is 10 with no maximum. - ``Range[int, None, 10]`` means the maximum is 10 with no minimum. - ``Range[int, 1, 10]`` means the minimum is 1 and the maximum is 10. - ``Range[float, 1.0, 5.0]`` means the minimum is 1.0 and the maximum is 5.0. - ``Range[str, 1, 10]`` means the minimum length is 1 and the maximum length is 10. Inside a :class:`HybridCommand` this functions equivalently to :class:`discord.app_commands.Range`. If the value cannot be converted to the provided type or is outside the given range, :class:`~.ext.commands.BadArgument` or :class:`~.ext.commands.RangeError` is raised to the appropriate error handlers respectively. .. versionadded:: 2.0 Examples ---------- .. code-block:: python3 @bot.command() async def range(ctx: commands.Context, value: commands.Range[int, 10, 12]): await ctx.send(f'Your value is {value}') N)minmax annotationrrOptional[Union[int, float]]rr=rpcj||_||_||_|r|r||krtddSdSdS)Nz%minimum cannot be larger than maximum)rrrr)rSrrrs rDrrzRange.__init__s]$.DO47DH47DH Is IsSyy GHHH I I I IyyrFrNrOvaluer;Union[int, float]cfK ||x}}n8#t$r+td|jjd|jjdwxYw|jt urt|}|j ||jks|j '||j krt||j|j |S)NConverting to "" failed for parameter "".)minimummaximum) rr BadArgumentrVcurrent_parameterrur;rrr RangeError)rSrNrcount converteds rDrTz Range.converts $(OOE$:$::    !vdo&>vvX[XmXrvvv  #%%E $)9)9tx?SX]`d`hXhXh DHdhOOOO s 5AcdSr?rZrs rD__call__zRange.__call__s DrFc t||fSr?)r)rSrhss rD__or__z Range.__or__ss# #rFcZ|jjd|jjd|jd|jdS)N[z, r)rrVrrrrs rDrzRange.__repr__s9n-cc0HccDHccX\X`ccc crFcXt|tstd|jjdt |dkrg|dR}n"t |dkrtd|\}}}||td|1|/t |t |krtd|tttfvrtd|d|ttfvrt}nt}||| ||nd| ||nd S) Nz'expected tuple for arguments, received z insteadr?r@zSRange accepts either two or three arguments with the first being the type of range.zRange must not be emptyz/Both min and max in Range must be the same typez4expected int, float, or str as range type, received )rrr) rrrrrVrrrhfloatr;)robjrrrcasts rDrzRange.__class_getitem__sOc5)) l j#-J` j j jkkk3xx1}}"lTllSQ uvvv#& JS{s{ 9:::3?99S ))#$UVVV#uc!222 mWa m m mnnnc3Z''3%!$DDIIId!$DDIIId rF)rrrrrrr=rp)rNrOrr;r=r)r=rprr)r=r6) rVrWrXrYrrrTrrrrrZrFrDr6r6s  H04/3 I I I I I I          $ $ $ $ d d d d      rFr6rBc`|}|dvrdS|dvrdSt|)N)yesytruet1enableonT)nonfalsefrqdisableoffF)rBadBoolArgument)r<lowereds rD_convert_to_boolr sAnnG@@@t D D Dug&&&rF) _GenericAliastprrcvt|trt|tpt||Sr?)rrrr)rrs rDis_generic_typers0 b$   ;Jr7$;$; \z"m?\?\\rFzDict[type, Any]CONVERTER_MAPPINGrNrOrparaminspect.ParametercK|turt|S |j}|E|dr0|dst ||}n#t$rYnwxYw tj |rnt|trYtj |j r| ||d{VS| ||d{VSt|tr| ||d{VSn-#t$rt $r}t#|||d}~wwxYw ||S#t$rt $rF} |j}n#t$r|jj}YnwxYwt)d|d|jd|d}~wwxYw)Nzdiscord.rrrr)rBrrWrendswithrrAttributeErrorrrrrrrTr CommandErrorr-ConversionErrorrVrrru)rNrr<rmoduler0rus rD_actual_conversionr5s\D)))D%  6#4#4Z#@#@ YdIeIe )--iCCI      7 ?9 % % :*Y *J*J : 122 @&..sH=========&Y[[00h?????????  9 - - :"**399999999 9 :  777i--367 cy"""  ccc 0%DD 0 0 0&/DDD 0XDXX%*XXXYY_bb cslA++ A87A80D00EEE E))G>FF>FF>FF>>G'Union[Type[Converter[T]], Converter[T]]rc KdSr?rZrNrr<rs rDr8r8[s  rFc KdSr?rZrs rDr8r8as fifirFcKt|dd}|turg}td}|j}|D]}||urO|j|jkr?|j|jrdn| |d{VcS t||||d{V} | cS#t$r} | | Yd} ~ d} ~ wwxYwt||||turg}i} |j} | D]} t| } | |} nm#t$r` t!||||d{V} | | |<n>#t$r1} | | t#| |<Yd} ~ Yzd} ~ wwxYwYnwxYw| | kr| cSt%|| |||t'|r|}t!||||d{VS)a|coro| Runs converters for a given converter, argument, and parameter. This function does the same work that the library does under the hood. .. versionadded:: 2.0 Parameters ------------ ctx: :class:`Context` The invocation context to run the converters under. converter: Any The converter to run, this corresponds to the annotation in the function. argument: :class:`str` The argument to convert to. param: :class:`Parameter` The parameter being converted. This is mainly for error reporting. Raises ------- CommandError The converter failed to convert. Returns -------- Any The resulting conversion. rN)rArrrkindVAR_POSITIONALviewundorequired get_defaultr8rappendBadUnionArgumentr KeyErrorrobjectBadLiteralArgumentr)rNrr<rrerrors _NoneType union_argsconvrr0 conversions literal_argsliteral literal_types rDr8r8es<Y d 3 3F JJ '   Dy  UZ53G%G%G $~Ott9J9J39O9O3O3O3O3O3O3OOOO ,S$%HHHHHHHH   # # # c"""""""" # uj&999   ) #  G==L 6#L1 6 6 66"4S,RW"X"XXXXXXXE 16K -- $MM#&&&06K -HHHHH .- 6  ! fhGGG oi88 #CHeDD D D D D D DDsT B)) C3C  CD F"E:F E; &E60F6E;;FF)r9rr:r;r<rr=r)r<r;r=rB)rrrrr=rB)rNrOrrr<r;rr) rNrOrrr<r;rrr=rG) rNrOrrr<r;rrr=r)mrY __future__rrUrrftypingrrrrrr r r r r rrrrrrrjr discord.staterdiscord.threadsr parametersr_typesrrcontextr__all__rErrrrGrHrrrJrLrrr]r.rkrrrUserrrr Messagerr0rr!rr(rr)rr,r/r r-rr&r'Roler$r(r%Inviter"Guildr#Emojir*rCr+ GuildStickerr1r7r;ScheduledEventr2SoundboardSoundr3r4r5typing_extensionsrr6rrrrr__annotations__rr8rZrFrDrs3 0#""""" " !%%%%%%&&&&&&%%%%%%""""""""       D]   GCLLwv&&& WT1222 WT(((&M&M&M&M&M&M&M&MR BJ) * * ))))))D/))) )))))k'.1)))0ccccck'.1cccL99999K -999x8F8F8F8F8Fi(>?8F8F8Fv.....{7?3...>ZZZZZK (@AZZZzkkkkk;w':;kkk0mmmmmK(<=mmm0mmmmmK(<=mmm.lllll{7+BClll0_____k'.1___,eeeeeK(<=eee."""""i/"""J!K -@+++++Igl++++77777i/777"[/6&&&&&[/&&&R66666Ig&:;6660$$$$$K(<=$$$N\!II\\\\\IcN\\\$88888k'*@A888v#####{7+BC###LV5V5V5V5V5IcNV5V5V5rFFFFFT!WFFFRl4444444hhhhhhhhV''''T!W 7D]]]]]]& NO& NO& L-& O% &  3 &  - & NO& M>& L-& L-& NO& /& /& M>& /&  5!&" NO#&$ K3 / 3 / 5-&&4#c#c#c#cL       iii iUEUEUEUEUEUErF