i[dZddlmZddlmZmZmZmZmZm Z m Z m Z m Z m Z mZmZddlmZmZmZmZdZe r`ddlmZmZede e ZGd d eee d ZGddeeZGddee eZGddeZddZeGddeZ dZ!e!GddZ"dS) a: The MIT License (MIT) Copyright (c) 2015-present Rapptz Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ) annotations) CallableAnyClassVarDictIteratorSet TYPE_CHECKINGTupleOptional TypedDictGenericTypeVar) BaseFlags flag_valuefill_with_flagsalias_flag_value) PermissionsPermissionOverwrite)SelfUnpack BoolOrNoneT)boundcTeZdZUded<ded<ded<ded<ded<ded<ded<ded <ded <ded <ded <ded <ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded <ded!<ded"<ded#<ded$<ded%<ded&<ded'<ded(<ded)<ded*<ded+<ded,<ded-<ded.<ded/<ded0<ded1<ded2<ded3<ded4<ded5<ded6<ded7<ded8<ded9<ded:<ded;<d.decoratorpst$$  r])rmrnrjrgr\)rirrs` r^make_permission_aliasrsos) r]ceZdZdZdZdidjdZdkd Zdkd ZdkdZdkdZ eZ eZ eZ e Z edldZedldZedmdZedldZedndZedldZedldZedldZedldZedldZedldZedldZedldZedldZedld Zedld!Zdod#Zdpd&Z e!dmd'Z"e!dmd(Z#e!dmd)Z$e!dmd*Z%e!dmd+Z&e!dmd,Z'e!dmd-Z(e!dmd.Z)e!dmd/Z*e!dmd0Z+e!dmd1Z,e-d2dmd3Z.e!dmd4Z/e!dmd5Z0e!dmd6Z1e!dmd7Z2e!dmd8Z3e!dmd9Z4e!dmd:Z5e!dmd;Z6e-d<dmd=Z7e!dmd>Z8e!dmd?Z9e!dmd@Z:e!dmdAZ;e!dmdBZe!dmdEZ?e!dmdFZ@e!dmdGZAe-dHdmdIZBe!dmdJZCe!dmdKZDe-dLdmdMZEe-dLdmdNZFe!dmdOZGe!dmdPZHe!dmdQZIe!dmdRZJe!dmdSZKe!dmdTZLe!dmdUZMe-dVdmdWZNe!dmdXZOe!dmdYZPe!dmdZZQe!dmd[ZRe!dmd\ZSe!dmd]ZTe!dmd^ZUe!dmd_ZVe!dmd`ZWe!dmdaZXe!dmdbZYe-dcdmddZZe!dmdeZ[e!dmdfZ\e!dmdgZ]dhS)qraQ Wraps up the Discord permission value. The properties provided are two way. You can set and retrieve individual bits using the properties as if they were regular bools. This allows you to edit permissions. .. versionchanged:: 1.3 You can now use keyword arguments to initialize :class:`Permissions` similar to :meth:`update`. .. container:: operations .. describe:: x == y Checks if two permissions are equal. .. describe:: x != y Checks if two permissions are not equal. .. describe:: x <= y Checks if a permission is a subset of another permission. .. describe:: x >= y Checks if a permission is a superset of another permission. .. describe:: x < y Checks if a permission is a strict subset of another permission. .. describe:: x > y Checks if a permission is a strict superset of another permission. .. describe:: x | y, x |= y Returns a Permissions instance with all enabled flags from both x and y. .. versionadded:: 2.0 .. describe:: x & y, x &= y Returns a Permissions instance with only flags enabled on both x and y. .. versionadded:: 2.0 .. describe:: x ^ y, x ^= y Returns a Permissions instance with only flags enabled on only one of x or y, not on both. .. versionadded:: 2.0 .. describe:: ~x Returns a Permissions instance with all flags inverted from x. .. versionadded:: 2.0 .. describe:: hash(x) Return the permission's hash. .. describe:: iter(x) Returns an iterator of ``(perm, value)`` pairs. This allows it to be, for example, constructed as a dict or a list of pairs. Note that aliases are not shown. .. describe:: bool(b) Returns whether the permissions object has any permissions set to ``True``. .. versionadded:: 2.0 Attributes ----------- value: :class:`int` The raw value. This value is a bit array field of a 53-bit integer representing the currently available permissions. You should query permissions via the properties rather than using this raw value. r\r permissionsintkwargsUnpack[_PermissionsKwargs]c 6t|tstd|jjd||_|D]J\}} |j|}|||*#t$rt|ddwxYwdS)Nz!Expected int parameter, received z instead.z is not a valid permission name.) isinstancerv TypeError __class__rXvalueitems VALID_FLAGS _set_flagKeyError)selfrurwkeykwvalueflags r^__init__zPermissions.__init__s+s++ ki @U@^iiijj j  "LLNN . .LC .',tW---- V V V3 J J JKKQUU V . .s  A88Botherrjboolct|tr|j|jz|jkStd|jjd|jj)zDReturns ``True`` if self has the same or fewer permissions as other.cannot compare  with rzrr}r{r|rXrrs r^ is_subsetzPermissions.is_subsetT e[ ) ) iJ,; ;gdn.EggU_Megghh hr]ct|tr|j|jz|jkStd|jjd|jj)zCReturns ``True`` if self has the same or more permissions as other.rrrrs r^ is_supersetzPermissions.is_supersetrr]c8||o||kS)zRReturns ``True`` if the permissions on other are a strict subset of those on self.)rrs r^is_strict_subsetzPermissions.is_strict_subsets~~e$$66r]c8||o||kS)zTReturns ``True`` if the permissions on other are a strict superset of those on self.)rrs r^is_strict_supersetzPermissions.is_strict_supersets&&845=8r]rc|dS)zcA factory method that creates a :class:`Permissions` with all permissions set to ``False``.rr\clss r^nonezPermissions.noness1vv r]c|dS)zkA factory method that creates a :class:`Permissions` with all permissions set to ``True``. lr\rs r^allzPermissions.alls sdeeer]cV|}d|_d|_|jS)NF)rr(r.r})rps r^ _timeout_maskzPermissions._timeout_masks' GGII!&xr]c|}d|_d|_d|_d|_d|_d|_d|_d|_d|_ |S)NTF) textr'r*r+rUrFrErDrGrV)rbases r^_dm_permissionszPermissions._dm_permissions s\xxzz!!&$ &+#%*"#(-%$ r]in_guildc|}d|_d|_d|_d|_d|_|rd|_d|_d|_|S)NT) rr)r-r,r0rNr'r*rG)rrrs r^_user_installed_permissionsz'Permissions._user_installed_permissionss^xxzz! ##'  1"&D %)D ",0D ) r]c|dS)aA :class:`Permissions` with all channel-specific permissions set to ``True`` and the guild-specific ones set to ``False``. The guild-specific permissions are currently: - :attr:`manage_expressions` - :attr:`view_audit_log` - :attr:`view_guild_insights` - :attr:`manage_guild` - :attr:`change_nickname` - :attr:`manage_nicknames` - :attr:`kick_members` - :attr:`ban_members` - :attr:`administrator` - :attr:`create_expressions` - :attr:`moderate_members` - :attr:`create_events` - :attr:`manage_events` - :attr:`view_creator_monetization_analytics` .. versionchanged:: 1.7 Added :attr:`stream`, :attr:`priority_speaker` and :attr:`use_application_commands` permissions. .. versionchanged:: 2.0 Added :attr:`create_public_threads`, :attr:`create_private_threads`, :attr:`manage_threads`, :attr:`use_external_stickers`, :attr:`send_messages_in_threads` and :attr:`request_to_speak` permissions. .. versionchanged:: 2.3 Added :attr:`use_soundboard`, :attr:`create_expressions` permissions. .. versionchanged:: 2.4 Added :attr:`send_polls`, :attr:`send_voice_messages`, attr:`use_external_sounds`, :attr:`use_embedded_activities`, and :attr:`use_external_apps` permissions. .. versionchanged:: 2.7 Added :attr:`pin_messages` and :attr:`bypass_slowmode` permissions. lQgr\rs r^ all_channelzPermissions.all_channel(sNsdeeer]c|dS)aA factory method that creates a :class:`Permissions` with all "General" permissions from the official Discord UI set to ``True``. .. versionchanged:: 1.7 Permission :attr:`read_messages` is now included in the general permissions, but permissions :attr:`administrator`, :attr:`create_instant_invite`, :attr:`kick_members`, :attr:`ban_members`, :attr:`change_nickname` and :attr:`manage_nicknames` are no longer part of the general permissions. .. versionchanged:: 2.3 Added :attr:`create_expressions` permission. .. versionchanged:: 2.4 Added :attr:`view_creator_monetization_analytics` permission. l`(r\rs r^generalzPermissions.generalQs"sdeeer]c|dS)zA factory method that creates a :class:`Permissions` with all "Membership" permissions from the official Discord UI set to ``True``. .. versionadded:: 1.7 lr\rs r^ membershipzPermissions.membershipdsdeeer]c|dS)afA factory method that creates a :class:`Permissions` with all "Text" permissions from the official Discord UI set to ``True``. .. versionchanged:: 1.7 Permission :attr:`read_messages` is no longer part of the text permissions. Added :attr:`use_application_commands` permission. .. versionchanged:: 2.0 Added :attr:`create_public_threads`, :attr:`create_private_threads`, :attr:`manage_threads`, :attr:`send_messages_in_threads` and :attr:`use_external_stickers` permissions. .. versionchanged:: 2.3 Added :attr:`send_voice_messages` permission. .. versionchanged:: 2.4 Added :attr:`send_polls` and :attr:`use_external_apps` permissions. .. versionchanged:: 2.7 Added :attr:`pin_messages` and :attr:`bypass_slowmode` permissions. l@xr\rs r^rzPermissions.textms,sdeeer]c|dS)zA factory method that creates a :class:`Permissions` with all "Voice" permissions from the official Discord UI set to ``True``. .. versionchanged:: 2.7 Added :attr:`set_voice_channel_status` permission. l r\rs r^voicezPermissions.voicesdeeer]c|dS)zA factory method that creates a :class:`Permissions` with all "Stage Channel" permissions from the official Discord UI set to ``True``. .. versionadded:: 1.7 r\rs r^stagezPermissions.stagess7||r]c|dS)aA factory method that creates a :class:`Permissions` with all permissions for stage moderators set to ``True``. These permissions are currently: - :attr:`manage_channels` - :attr:`mute_members` - :attr:`move_members` .. versionadded:: 1.7 .. versionchanged:: 2.0 Added :attr:`manage_channels` permission and removed :attr:`request_to_speak` permission. i@r\rs r^stage_moderatorzPermissions.stage_moderatorssdeeer]c|dS)a'A factory method that creates a :class:`Permissions` with all permissions that require 2FA set to ``True``. These permissions are currently: - :attr:`kick_members` - :attr:`ban_members` - :attr:`administrator` - :attr:`manage_channels` - :attr:`manage_guild` - :attr:`manage_messages` - :attr:`manage_roles` - :attr:`manage_webhooks` - :attr:`manage_expressions` - :attr:`manage_threads` - :attr:`moderate_members` .. versionadded:: 2.0 l> `r\rs r^elevatedzPermissions.elevateds&sdeeer]c|dS)zA factory method that creates a :class:`Permissions` with all "Apps" permissions from the official Discord UI set to ``True``. .. versionadded:: 2.6 l r\rs r^appszPermissions.appsrr]c|dS)zA factory method that creates a :class:`Permissions` with all "Events" permissions from the official Discord UI set to ``True``. .. versionadded:: 2.4 l@r\rs r^eventszPermissions.eventsrr]c|dS)zA factory method that creates a :class:`Permissions` with all "Advanced" permissions from the official Discord UI set to ``True``. .. versionadded:: 1.7 r\rs r^advancedzPermissions.advancedss6{{r]Nonec |D]7\}}|j|}||||8dS)awBulk updates this permission object. Allows you to set multiple attributes by using keyword arguments. The names must be equivalent to the properties listed. Extraneous key/value pairs will be silently ignored. Parameters ------------ \*\*kwargs A list of key/value pairs to bulk update permissions with. N)r~rgetr)rrwrr}rs r^updatezPermissions.updatesZ!,,.. , ,JC#'',,DtU+++ , ,r]allowdenyc,|j|z|z|_dSrp)r})rrrs r^handle_overwritezPermissions.handle_overwrites :-6 r]cdS)zG:class:`bool`: Returns ``True`` if the user can create instant invites.rr\rs r^rz!Permissions.create_instant_invite vr]cdS)zJ:class:`bool`: Returns ``True`` if the user can kick users from the guild.r\rs r^rzPermissions.kick_membersrr]cdS)zG:class:`bool`: Returns ``True`` if a user can ban users from the guild.r\rs r^rzPermissions.ban_membersrr]cdS)z:class:`bool`: Returns ``True`` if a user is an administrator. This role overrides all other permissions. This also bypasses all channel-specific overrides. rr\rs r^r zPermissions.administrators vr]cdS)z:class:`bool`: Returns ``True`` if a user can edit, delete, or create channels in the guild. This also corresponds to the "Manage Channel" channel-specific override.r\rs r^r!zPermissions.manage_channelss vr]cdS)zD:class:`bool`: Returns ``True`` if a user can edit guild properties. r\rs r^r"zPermissions.manage_guildrr]cdS)zH:class:`bool`: Returns ``True`` if a user can add reactions to messages.@r\rs r^r#zPermissions.add_reactionsrr]cdS)zI:class:`bool`: Returns ``True`` if a user can view the guild's audit log.r\rs r^r$zPermissions.view_audit_log!rr]cdS)zQ:class:`bool`: Returns ``True`` if a user can be more easily heard while talking.r\rs r^r%zPermissions.priority_speaker&rr]cdS)zH:class:`bool`: Returns ``True`` if a user can stream in a voice channel.ir\rs r^r&zPermissions.stream+rr]cdS)z_:class:`bool`: Returns ``True`` if a user can read messages from all or specific text channels.r\rs r^r'zPermissions.read_messages0 wr]r'cdS)zZ:class:`bool`: An alias for :attr:`read_messages`. .. versionadded:: 1.3 rr\rs r^r(zPermissions.view_channel5 wr]cdS)z_:class:`bool`: Returns ``True`` if a user can send messages from all or specific text channels.ir\rs r^r)zPermissions.send_messages=rr]cdS)zc:class:`bool`: Returns ``True`` if a user can send TTS messages from all or specific text channels.ir\rs r^r*zPermissions.send_tts_messagesBrr]cdS)z:class:`bool`: Returns ``True`` if a user can delete messages in a text channel. .. note:: Note that there are currently no ways to edit other people's messages. i r\rs r^r+zPermissions.manage_messagesGs wr]cdS)z_:class:`bool`: Returns ``True`` if a user's messages will automatically be embedded by Discord.i@r\rs r^r,zPermissions.embed_linksQrr]cdS)zK:class:`bool`: Returns ``True`` if a user can send files in their messages.ir\rs r^r-zPermissions.attach_filesVrr]cdS)zV:class:`bool`: Returns ``True`` if a user can read a text channel's previous messages.ir\rs r^r.z Permissions.read_message_history[rr]cdS)zi:class:`bool`: Returns ``True`` if a user's @everyone or @here will mention everyone in the text channel.ir\rs r^r/zPermissions.mention_everyone`rr]cdS)zK:class:`bool`: Returns ``True`` if a user can use emojis from other guilds.r\rs r^r0zPermissions.external_emojiserr]r0cdS)z\:class:`bool`: An alias for :attr:`external_emojis`. .. versionadded:: 1.3 rr\rs r^r1zPermissions.use_external_emojisjrr]cdS)zp:class:`bool`: Returns ``True`` if a user can view the guild's insights. .. versionadded:: 1.3 ir\rs r^r2zPermissions.view_guild_insightsrrr]cdS)zI:class:`bool`: Returns ``True`` if a user can connect to a voice channel.ir\rs r^r3zPermissions.connectzrr]cdS)zG:class:`bool`: Returns ``True`` if a user can speak in a voice channel.i r\rs r^r4zPermissions.speakrr]cdS)z?:class:`bool`: Returns ``True`` if a user can mute other users.i@r\rs r^r5zPermissions.mute_membersrr]cdS)zA:class:`bool`: Returns ``True`` if a user can deafen other users.ir\rs r^r6zPermissions.deafen_membersrr]cdS)zV:class:`bool`: Returns ``True`` if a user can move users between other voice channels.ir\rs r^r7zPermissions.move_membersrr]cdS)zU:class:`bool`: Returns ``True`` if a user can use voice activation in voice channels.ir\rs r^r8z Permissions.use_voice_activationrr]cdS)zQ:class:`bool`: Returns ``True`` if a user can change their nickname in the guild.ir\rs r^r9zPermissions.change_nicknamerr]cdS)zX:class:`bool`: Returns ``True`` if a user can change other user's nickname in the guild.ir\rs r^r:zPermissions.manage_nicknamesrr]cdS)z:class:`bool`: Returns ``True`` if a user can create or edit roles less than their role's position. This also corresponds to the "Manage Permissions" channel-specific override. r\rs r^r;zPermissions.manage_rolesrr]r;cdS)zY:class:`bool`: An alias for :attr:`manage_roles`. .. versionadded:: 1.3 rr\rs r^r<zPermissions.manage_permissionsrr]cdS)zO:class:`bool`: Returns ``True`` if a user can create, edit, or delete webhooks.i r\rs r^r=zPermissions.manage_webhooksrr]cdS)z:class:`bool`: Returns ``True`` if a user can edit or delete emojis, stickers, and soundboard sounds. .. versionadded:: 2.3 @r\rs r^r>zPermissions.manage_expressionsrr]r>cdS)z7:class:`bool`: An alias for :attr:`manage_expressions`.rr\rs r^r?zPermissions.manage_emojisrr]cdS)z_:class:`bool`: An alias for :attr:`manage_expressions`. .. versionadded:: 2.0 rr\rs r^r@z&Permissions.manage_emojis_and_stickersrr]cdS)zi:class:`bool`: Returns ``True`` if a user can use slash commands. .. versionadded:: 1.7 lr\rs r^rAz$Permissions.use_application_commandsrr]cdS)zz:class:`bool`: Returns ``True`` if a user can request to speak in a stage channel. .. versionadded:: 1.7 rr\rs r^rBzPermissions.request_to_speakrr]cdS)zj:class:`bool`: Returns ``True`` if a user can manage guild events. .. versionadded:: 2.0 lr\rs r^rCzPermissions.manage_eventsrr]cdS)ze:class:`bool`: Returns ``True`` if a user can manage threads. .. versionadded:: 2.0 lr\rs r^rDzPermissions.manage_threadsrr]cdS)zl:class:`bool`: Returns ``True`` if a user can create public threads. .. versionadded:: 2.0 l r\rs r^rEz!Permissions.create_public_threadsrr]cdS)zm:class:`bool`: Returns ``True`` if a user can create private threads. .. versionadded:: 2.0 l@r\rs r^rFz"Permissions.create_private_threadsrr]cdS)zu:class:`bool`: Returns ``True`` if a user can use stickers from other guilds. .. versionadded:: 2.0 r\rs r^rHzPermissions.external_stickersrr]rHcdS)z^:class:`bool`: An alias for :attr:`external_stickers`. .. versionadded:: 2.0 rr\rs r^rIz!Permissions.use_external_stickersrr]cdS)zo:class:`bool`: Returns ``True`` if a user can send messages in threads. .. versionadded:: 2.0 lr\rs r^rGz$Permissions.send_messages_in_threads rr]cdS)z:class:`bool`: Returns ``True`` if a user can launch an embedded application in a Voice channel. .. versionadded:: 2.0 lr\rs r^rJz#Permissions.use_embedded_activitiesrr]cdS)zm:class:`bool`: Returns ``True`` if a user can time out other members. .. versionadded:: 2.0 lr\rs r^rKzPermissions.moderate_membersrr]cdS)zv:class:`bool`: Returns ``True`` if a user can view role subscription insights. .. versionadded:: 2.4 lr\rs r^#view_creator_monetization_analyticsz/Permissions.view_creator_monetization_analytics$rr]cdS)zi:class:`bool`: Returns ``True`` if a user can use the soundboard. .. versionadded:: 2.3 lr\rs r^rLzPermissions.use_soundboard,rr]cdS)z:class:`bool`: Returns ``True`` if a user can create emojis, stickers, and soundboard sounds. .. versionadded:: 2.3 l r\rs r^rPzPermissions.create_expressions4rr]cdS)zj:class:`bool`: Returns ``True`` if a user can create guild events. .. versionadded:: 2.4 l@r\rs r^rQzPermissions.create_events<rr]cdS)zs:class:`bool`: Returns ``True`` if a user can use sounds from other guilds. .. versionadded:: 2.3 lr\rs r^rMzPermissions.use_external_soundsDrr]cdS)zj:class:`bool`: Returns ``True`` if a user can send voice messages. .. versionadded:: 2.3 lr\rs r^rNzPermissions.send_voice_messagesLrr]cdS)zo:class:`bool`: Returns ``True`` if a user can set voice channel status. .. versionadded:: 2.7 lr\rs r^rOz$Permissions.set_voice_channel_statusTrr]cdS)zi:class:`bool`: Returns ``True`` if a user can send poll messages. .. versionadded:: 2.4 r\rs r^rRzPermissions.send_polls\rr]rRcdS)zW:class:`bool`: An alias for :attr:`send_polls`. .. versionadded:: 2.4 rr\rs r^rSzPermissions.create_pollsdrr]cdS)zh:class:`bool`: Returns ``True`` if a user can use external apps. .. versionadded:: 2.4 l r\rs r^rTzPermissions.use_external_appslrr]cdS)zc:class:`bool`: Returns ``True`` if a user can pin messages. .. versionadded:: 2.7 l@r\rs r^rUzPermissions.pin_messagestrr]cdS)zf:class:`bool`: Returns ``True`` if a user can bypass slowmode. .. versionadded:: 2.7 lr\rs r^rVzPermissions.bypass_slowmode|rr]N)r)rurvrwrx)rrrjr)rjr)rjrv)rrrjr)rwrxrjr)rrvrrvrjr)^rXrYrZ__doc__ __slots__rrrrr__le____ge____lt____gt__ classmethodrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'rsr(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErFrHrIrGrJrKrrLrPrQrMrNrOrRrSrTrUrVr\r]r^rrxs OObI . . . . .iiiiiiii77779999F F F F[ fff[f[    [    [ &f&f&f[&fPfff[f$fff[ffff[f.fff[f[ f f f[ ffff[f(fff[ffff[f[,,,," 7 7 7 7ZZZZZ ZZZZZZ?++,+ZZZZZZZZ,--.-ZZZZZZZZZZ>**+*ZZ/0010/0010ZZZZZZZ.//0/ZZZZZZZZZZZ<(()(ZZZr]rcttj|_t}tjD]{\}}t |tr|j}| |nt |tr|}nP|fd}|fd}t||}t|||||j|z |_ |S)Nc6|j|Srp)_valuesr)rxs r^getterz)_augment_from_permissions..getters<##A&& &r]c2|||dSrp)_set)rr}rs r^setterz)_augment_from_permissions..setters IIa     r])setrr VALID_NAMES__dict__r~rzrgriaddrpropertysetattr PURE_FLAGS)raliasesnamer}rrr"props r^_augment_from_permissionsr-s+122COeeG#+1133!! e e- . . +C KK     z * * CC  ' ' ' '#&    ''T4    _w.CN Jr]ceZdZUdZdZer,ded<ded<ded<ded<ded <ded <ded <ded <ded <ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded <ded!<ded"<ded#<ded$<ded%<ded&<ded'<ded(<ded)<ded*<ded+<ded,<ded-<ded.<ded/<ded0<ded1<ded2<ded3<ded4<ded5<ded6<ded7<ded8<ded9<ded:<ded;<ded<<ded=<ded><ded?<ded@<dZdEZd[dIZd\dMZ d]dOZ e d^dTZ d_dUZ dZdVZd`dXZdYS)araA type that is used to represent a channel specific permission. Unlike a regular :class:`Permissions`\, the default value of a permission is equivalent to ``None`` and not ``False``. Setting a value to ``False`` is **explicitly** denying that permission, while setting a value to ``True`` is **explicitly** allowing that permission. The values supported by this are the same as :class:`Permissions` with the added possibility of it being set to ``None``. .. container:: operations .. describe:: x == y Checks if two overwrites are equal. .. describe:: x != y Checks if two overwrites are not equal. .. describe:: iter(x) Returns an iterator of ``(perm, value)`` pairs. This allows it to be, for example, constructed as a dict or a list of pairs. Note that aliases are not shown. Parameters ----------- \*\*kwargs Set the value of permissions by their name. )rzClassVar[Set[str]]r$r)Optional[bool]rrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrw"Unpack[_PermissionOverwriteKwargs]rjrc i|_|D]2\}}||jvrtd|dt |||3dS)Nzno permission called .)rr~r$ ValueErrorr(rrwrr}s r^rzPermissionOverwrite.__init__sk24  ,,.. & &JC$*** !?!?!?!?@@@ D#u % % % %  & &r]robjectrcLt|to|j|jkSrp)rzrrrs r^__eq__zPermissionOverwrite.__eq__ s!%!455W$,%-:WWr]rrhr}c|dvrtd|jj||j|ddS||j|<dS)N)TNFz$Expected bool or NoneType, received )r{r|rXrpop)rrr}s r^r!zPermissionOverwrite._sets_ + + +]5?C[]]^^ ^ = L  S$ ' ' ' ' ' %DL   r]Tuple[Permissions, Permissions]ct}t}|jD]0\}}|durt ||d|durt ||d1||fS)zfTuple[:class:`Permissions`, :class:`Permissions`]: Returns the (allow, deny) pair from this overwrite.TF)rrrr~r()rrrrr}s r^pairzPermissionOverwrite.pairs  ""!!,,,.. ) )JC}}sD))))%c4(((d{r]rrrrc|}|D]\}}|durt||d|D]\}}|durt||d|S)zECreates an overwrite from an allow/deny pair of :class:`Permissions`.TF)r()rrrrqrr}s r^ from_pairzPermissionOverwrite.from_pair&srcee ( (JC}}S$''' ) )JC}}S%((( r]c2t|jdkS)aChecks if the permission overwrite is currently empty. An empty permission overwrite is one that has no overwrites set to ``True`` or ``False``. Returns ------- :class:`bool` Indicates if the overwrite is empty. r)lenrrs r^is_emptyzPermissionOverwrite.is_empty4s4<  A%%r]c p|D] \}}||jvrt|||!dS)auBulk updates this permission overwrite object. Allows you to set multiple attributes by using keyword arguments. The names must be equivalent to the properties listed. Extraneous key/value pairs will be silently ignored. Parameters ------------ \*\*kwargs A list of key/value pairs to bulk update with. N)r~r$r(r4s r^rzPermissionOverwrite.updateAsO!,,.. & &JC$*** D#u % % % %  & &r]$Iterator[Tuple[str, Optional[bool]]]c#ZK|jD] }||j|fV!dSrp)r)rr)rrs r^__iter__zPermissionOverwrite.__iter__SsE? - -Ct|'',,, , , , , - -r]N)rwr0rjr)rr5rjr)rrhr}r/rjr)rjr:)rrrrrjr)rjr)rjrC)rXrYrZrrr r[rr7r!r<rr>rArrEr\r]r^rrs>I=(''''&&&&----$$$$####%%%%''''$$$$%%%%&&&&((((%%%%$$$$%%%%))))''''####$$$$,,,,((((''''++++++++$$$$&&&&$$$$,,,,''''(((($$$$****''''****%%%%22220000((((%%%%&&&&----....0000))))----////((((&&&&++++++++0000****%%%%""""$$$$))))$$$$''''&&&&XXXX&&&&       [  & & & &&&&&$------r]rN)rirhrjrk)#r __future__rtypingrrrrrr r r r r rrflagsrrrr__all__typing_extensionsrrrrrrarergrsrr-rr\r]r^rKs=0#"""""||||||||||||||||||||||||||||KKKKKKKKKKKK  CR........'-x~>>>K:%:%:%:%:%!5y:%:%:%:%x@????3D9???QQQQQ%;HTN%KQQQ 'I I I I I )I I I X8s-s-s-s-s-s-s-s-s-s-r]