cjhXndZddlmZddlmZmZmZmZmZm Z ddl m Z m Z m Z mZdZGdde Z dd Ze d d Ze Gd d e Ze dd ZdZeGddZy)ae The MIT License (MIT) Copyright (c) 2015-2021 Rapptz Copyright (c) 2021-present Pycord Development Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ) annotations) TYPE_CHECKINGAnyCallableClassVarIteratorTypeVar) BaseFlagsalias_flag_valuefill_with_flags flag_value) PermissionsPermissionOverwriteceZdZUded<y)permission_aliasstraliasN)__name__ __module__ __qualname____annotations__F/var/www/html/venv/lib/python3.12/site-packages/discord/permissions.pyrr(s Jrrcdfd }|S)Nc,t|}|_|SN)rr)funcretrs r decoratorz(make_permission_alias..decorator/st$  r)rzCallable[[Any], int]returnrr)rr!s` rmake_permission_aliasr#,s rPr)boundceZdZUdZdZdSdTdZdUdZdUdZdUdZdUdZ eZ de d <eZ de d <eZ de d <e Zde d <edVd ZedVdZedVdZedVdZedVdZedVdZedVdZedVdZedVdZedVdZdWdZdXdZedYdZedYdZedYdZedYdZ edYdZ!edYdZ"edYdZ#edYd Z$edYd!Z%edYd"Z&edYd#Z'e(d$dYd%Z)edYd&Z*edYd'Z+edYd(Z,edYd)Z-edYd*Z.edYd+Z/edYd,Z0edYd-Z1e(d.dYd/Z2edYd0Z3edYd1Z4edYd2Z5edYd3Z6edYd4Z7edYd5Z8edYd6Z9edYd7Z:edYd8Z;edYd9Z<e(d:dYd;Z=edYd<Z>edYd=Z?e(d>dYd?Z@edYd@ZAe(dAdYdBZBedYdCZCedYdDZDedYdEZEedYdFZFedYdGZGedYdHZHe(dIdYdJZIedYdKZJedYdLZKedYdMZLedYdNZMedYdOZNedYdPZOedYdQZPyR)ZraWraps 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 .. describe:: x + y Adds two permissions together. Equivalent to ``x | y``. .. describe:: x - y Subtracts two permissions from each other. .. describe:: x | y Returns the union of two permissions. Equivalent to ``x + y``. .. describe:: x & y Returns the intersection of two permissions. .. describe:: ~x Returns the inverse of a permission. Checks if a permission is a strict superset of another permission. .. 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. 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. rc t|ts#td|jjd||_|j D].\}}||jvrt|dt|||0y)Nz!Expected int parameter, received z instead.z is not a valid permission name.) isinstanceint TypeError __class__rvalueitems VALID_FLAGSsetattr)self permissionskwargskeyr,s r__init__zPermissions.__init__}s+s+))2239>  !  ,,. &JC$***3')I JKK D#u % &rct|tr&|j|jz|jk(Std|jj d|jj )zDReturns ``True`` if self has the same or fewer permissions as other.cannot compare  with r(rr,r*r+rr0others r is_subsetzPermissions.is_subseta e[ )JJ,; ;!$.."9"9!:;OO,,-/ rct|tr&|j|jz|jk(Std|jj d|jj )zCReturns ``True`` if self has the same or more permissions as other.r6r7r8r9s r is_supersetzPermissions.is_supersetr<rc2|j|xr||k7S)zRReturns ``True`` if the permissions on other are a strict subset of those on self.)r;r9s ris_strict_subsetzPermissions.is_strict_subsets~~e$66rc2|j|xr||k7S)zTReturns ``True`` if the permissions on other are a strict superset of those on self.)r>r9s ris_strict_supersetzPermissions.is_strict_supersets&845=8rzCallable[[Permissions], bool]__le____ge____lt____gt__c|dS)zlA factory method that creates a :class:`Permissions` with all permissions set to ``False``. rrclss rnonezPermissions.nones 1v rc|dS)zkA factory method that creates a :class:`Permissions` with all permissions set to ``True``. lrrHs rallzPermissions.all FGGrc|dS)azA :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_emojis` - :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` .. versionchanged:: 1.7 Added :attr:`stream`, :attr:`priority_speaker` and :attr:`use_slash_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. lQgrrHs r all_channelzPermissions.all_channels0<==rc|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. iprrHs rgeneralzPermissions.generals566rc|dS)zA factory method that creates a :class:`Permissions` with all "Membership" permissions from the official Discord UI set to ``True``. .. versionadded:: 1.7 i rrHs r membershipzPermissions.memberships566rc|dS)a#A 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_slash_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. l@xrrHs rtextzPermissions.texts<==rc|dS)zA factory method that creates a :class:`Permissions` with all "Voice" permissions from the official Discord UI set to ``True``. lrrHs rvoicezPermissions.voicerMrc|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 rrHs rstagezPermissions.stages7|rc|dS)zA factory method that creates a :class:`Permissions` with all "Stage Moderator" permissions from the official Discord UI set to ``True``. .. versionadded:: 1.7 lrrHs rstage_moderatorzPermissions.stage_moderators677rc|dS)zA factory method that creates a :class:`Permissions` with all "Advanced" permissions from the official Discord UI set to ``True``. .. versionadded:: 1.7 rrHs radvancedzPermissions.advanceds6{rc l|jD]!\}}||jvst|||#y)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-r.r/r0r2r3r,s rupdatezPermissions.updates7!,,. *JCd&&&c5) *rc4|j|z|z|_yr)r,)r0allowdenys rhandle_overwritezPermissions.handle_overwrite*sjjD5(E1 rcy)zG:class:`bool`: Returns ``True`` if the user can create instant invites.r rr0s rcreate_instant_invitez!Permissions.create_instant_invite9rcy)zJ:class:`bool`: Returns ``True`` if the user can kick users from the guild.rrhs r kick_memberszPermissions.kick_members>rjrcy)zG:class:`bool`: Returns ``True`` if a user can ban users from the guild.rrhs r ban_memberszPermissions.ban_membersCrjrcy)z:class:`bool`: Returns ``True`` if a user is an administrator. This role overrides all other permissions. This also bypasses all channel-specific overrides. r^rrhs r administratorzPermissions.administratorH rcy)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. rrhs rmanage_channelszPermissions.manage_channelsPrsrcy)zD:class:`bool`: Returns ``True`` if a user can edit guild properties. rrhs r manage_guildzPermissions.manage_guildXrjrcy)zH:class:`bool`: Returns ``True`` if a user can add reactions to messages.@rrhs r add_reactionszPermissions.add_reactions]rjrcy)zI:class:`bool`: Returns ``True`` if a user can view the guild's audit log.rrhs rview_audit_logzPermissions.view_audit_logbrjrcy)zQ:class:`bool`: Returns ``True`` if a user can be more easily heard while talking.rrhs rpriority_speakerzPermissions.priority_speakergrjrcy)zH:class:`bool`: Returns ``True`` if a user can stream in a voice channel.irrhs rstreamzPermissions.streamlrjrcy)zL:class:`bool`: Returns ``True`` if a user can view all or specific channels.rrhs r view_channelzPermissions.view_channelqrrcy)zY:class:`bool`: An alias for :attr:`view_channel`. .. versionadded:: 1.3 rrrhs r read_messageszPermissions.read_messagesv rcy)z_:class:`bool`: Returns ``True`` if a user can send messages from all or specific text channels.irrhs r send_messageszPermissions.send_messages~rrcy)zc:class:`bool`: Returns ``True`` if a user can send TTS messages from all or specific text channels.irrhs rsend_tts_messageszPermissions.send_tts_messagesrrcy)z:class:`bool`: Returns ``True`` if a user can delete or pin messages in a text channel. .. note:: Note that there are currently no ways to edit other people's messages. i rrhs rmanage_messageszPermissions.manage_messagessrcy)z_:class:`bool`: Returns ``True`` if a user's messages will automatically be embedded by Discord.i@rrhs r embed_linkszPermissions.embed_linksrrcy)zK:class:`bool`: Returns ``True`` if a user can send files in their messages.irrhs r attach_fileszPermissions.attach_filesrrcy)zV:class:`bool`: Returns ``True`` if a user can read a text channel's previous messages.irrhs rread_message_historyz Permissions.read_message_historyrrcy)zi:class:`bool`: Returns ``True`` if a user's @everyone or @here will mention everyone in the text channel.irrhs rmention_everyonezPermissions.mention_everyonerrcy)zK:class:`bool`: Returns ``True`` if a user can use emojis from other guilds.rrhs rexternal_emojiszPermissions.external_emojisrrrcy)z\:class:`bool`: An alias for :attr:`external_emojis`. .. versionadded:: 1.3 rrrhs ruse_external_emojiszPermissions.use_external_emojisrrcy)zp:class:`bool`: Returns ``True`` if a user can view the guild's insights. .. versionadded:: 1.3 irrhs rview_guild_insightszPermissions.view_guild_insightsrrcy)zI:class:`bool`: Returns ``True`` if a user can connect to a voice channel.irrhs rconnectzPermissions.connectrrcy)zG:class:`bool`: Returns ``True`` if a user can speak in a voice channel.i rrhs rspeakzPermissions.speakrrcy)z?:class:`bool`: Returns ``True`` if a user can mute other users.i@rrhs r mute_memberszPermissions.mute_membersrrcy)zA:class:`bool`: Returns ``True`` if a user can deafen other users.irrhs rdeafen_memberszPermissions.deafen_membersrrcy)zV:class:`bool`: Returns ``True`` if a user can move users between other voice channels.irrhs r move_memberszPermissions.move_membersrrcy)zU:class:`bool`: Returns ``True`` if a user can use voice activation in voice channels.irrhs ruse_voice_activationz Permissions.use_voice_activationrrcy)zQ:class:`bool`: Returns ``True`` if a user can change their nickname in the guild.irrhs rchange_nicknamezPermissions.change_nicknamerrcy)zX:class:`bool`: Returns ``True`` if a user can change other user's nickname in the guild.irrhs rmanage_nicknameszPermissions.manage_nicknamesrrcy)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. rrhs r manage_roleszPermissions.manage_rolesrrrcy)zY:class:`bool`: An alias for :attr:`manage_roles`. .. versionadded:: 1.3 rrrhs rmanage_permissionszPermissions.manage_permissionsrrcy)zO:class:`bool`: Returns ``True`` if a user can create, edit, or delete webhooks.i rrhs rmanage_webhookszPermissions.manage_webhooksrrcy)zM:class:`bool`: Returns ``True`` if a user can create, edit, or delete emojis.@rrhs r manage_emojiszPermissions.manage_emojisrrrcy)zZ:class:`bool`: An alias for :attr:`manage_emojis`. .. versionadded:: 2.0 rrrhs rmanage_emojis_and_stickersz&Permissions.manage_emojis_and_stickersrrcy)zi:class:`bool`: Returns ``True`` if a user can use slash commands. .. versionadded:: 1.7 rrhs ruse_slash_commandszPermissions.use_slash_commandsrrrcy)z_:class:`bool`: An alias for :attr:`use_slash_commands`. .. versionadded:: 2.0 rrrhs ruse_application_commandsz$Permissions.use_application_commands rrcy)zz:class:`bool`: Returns ``True`` if a user can request to speak in a stage channel. .. versionadded:: 1.7 rYrrhs rrequest_to_speakzPermissions.request_to_speakrrcy)zj:class:`bool`: Returns ``True`` if a user can manage guild events. .. versionadded:: 2.0 lrrhs r manage_eventszPermissions.manage_eventsrrcy)ze:class:`bool`: Returns ``True`` if a user can manage threads. .. versionadded:: 2.0 lrrhs rmanage_threadszPermissions.manage_threads%rrcy)zl:class:`bool`: Returns ``True`` if a user can create public threads. .. versionadded:: 2.0 l rrhs rcreate_public_threadsz!Permissions.create_public_threads-rrcy)zm:class:`bool`: Returns ``True`` if a user can create private threads. .. versionadded:: 2.0 l@rrhs rcreate_private_threadsz"Permissions.create_private_threads5rrcy)zu:class:`bool`: Returns ``True`` if a user can use stickers from other guilds. .. versionadded:: 2.0 rrhs rexternal_stickerszPermissions.external_stickers=rrrcy)z^:class:`bool`: An alias for :attr:`external_stickers`. .. versionadded:: 2.0 rrrhs ruse_external_stickersz!Permissions.use_external_stickersErrcy)zo:class:`bool`: Returns ``True`` if a user can send messages in threads. .. versionadded:: 2.0 lrrhs rsend_messages_in_threadsz$Permissions.send_messages_in_threadsMrrcy)z:class:`bool`: Returns ``True`` if a user can launch an activity flagged 'EMBEDDED' in a voice channel. .. versionadded:: 2.0 lrrhs rstart_embedded_activitiesz%Permissions.start_embedded_activitiesUrrcy)zq:class:`bool`: Returns ``True`` if a user can moderate members (timeout). .. versionadded:: 2.0 lrrhs rmoderate_memberszPermissions.moderate_members]rrcy)zl:class:`bool`: Returns ``True`` if a member can send voice messages. .. versionadded:: 2.5 lrrhs rsend_voice_messageszPermissions.send_voice_messageserrcy)zq:class:`bool`: Returns ``True`` if a member can set voice channel status. .. versionadded:: 2.5 lrrhs rset_voice_channel_statusz$Permissions.set_voice_channel_statusmrrcy)zc:class:`bool`: Returns ``True`` if a member can send polls. .. versionadded:: 2.6 lrrhs r send_pollszPermissions.send_pollsurrcy)a/:class:`bool`: Returns ``True`` if a member's user-installed apps can show public responses. Users will still be able to use user-installed apps, but responses will be ephemeral. This only applies to apps that are also not installed to the guild. .. versionadded:: 2.6 l rrhs ruse_external_appszPermissions.use_external_apps}srN)r)r1r)r2bool)r:rr"r)rIztype[P]r"r$r2rr"None)rdr)rer)r"r)r"r))Qrrr__doc__ __slots__r4r;r>r@rBrCrrDrErF classmethodrJrLrOrQrSrUrWrZr\r_rbrfrrirmrprrrvryr|rrrrr#rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr:sG=~I &79-6F )5,7F )7,F )> HH >>2 7 777 > >HH 88* 2>*+,-.>*+?+,/01./0rPOrcttj|_t}tjj D]j\}}t |tr|j}|j|nt |tr|}nH|fd}|fd}t||}t|||l|j|z |_ |S)Nc8|jj|Sr)_valuesget)r0xs rgetterz)_augment_from_permissions..getters<<##A& &rc(|j||yr)_set)r0r,rs rsetterz)_augment_from_permissions..setters IIa r)setrr. VALID_NAMES__dict__r-r(rraddrpropertyr/ PURE_FLAGS)rIaliasesnamer,r3rrprops r_augment_from_permissionsrs+112COeG#++113! e e- .++C KK  z *C  '#& 'T4 #!&__w.CN JrcneZdZUdZdZerded<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<dBd9ZdCd:ZdDd;Z dEd<Z e dFd=Z dGd>Z dHd?ZdId@ZyA)JraA 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]]rr bool | Nonerirmrprrrvryr|rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrc i|_|jD]/\}}||jvrtd|dt |||1y)Nzno permission called .)rr-r ValueErrorr/ras rr4zPermissionOverwrite.__init__sQ/1  ,,. &JC$*** #8Q!?@@ D#u %  &rcXt|txr|j|jk(Sr)r(rrr9s r__eq__zPermissionOverwrite.__eq__ s"%!45W$,,%--:WWrc|dvr"td|jj||jj |dy||j|<y)N)TNFz$Expected bool or NoneType, received )r*r+rrpop)r0r3r,s rrzPermissionOverwrite._setsV + +6u7O7O6PQ  = LL  S$ ' %DLL rctj}tj}|jjD])\}}|durt ||d|dust ||d+||fS)z3Returns the (allow, deny) pair from this overwrite.TF)rrJrr-r/)r0rdrer3r,s rpairzPermissionOverwrite.pairsr  "!,,,,. )JC}sD)%c4(  ) d{rc|}|D]\}}|dus t||d|D]\}}|dus t||d|S)zECreates an overwrite from an allow/deny pair of :class:`Permissions`.TF)r/)rIrdrer r3r,s r from_pairzPermissionOverwrite.from_pair's`e (JC}S$' ( )JC}S%( ) rc2t|jdk(S)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)lenrrhs ris_emptyzPermissionOverwrite.is_empty5s4<< A%%rc l|jD]!\}}||jvrt|||#y)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-rr/ras rrbzPermissionOverwrite.updateBs:!,,. &JC$*** D#u %  &rc#lK|jD]!}||jj|f#ywr)rrr)r0r3s r__iter__zPermissionOverwrite.__iter__Ts3?? -Ct||'',, , -s24N)r2r)r:rr"r)r3rr,rr"r)r"ztuple[Permissions, Permissions])rIztype[PO]rdrrerr"r)r"rr)r"z!Iterator[tuple[str, bool | None]])rrrrrrrr4rrrrrrrbr rrrrrs>I''&&**!!  ""$$!!""##%%""!!""&&$$  !!))%%$$((((!!##!!))$$%%!!''$$""$//''%%""##** ++"--&&**#..%%(("--&&&X &    &&$-rN)rrr"z2Callable[[Callable[[Any], int]], permission_alias])r __future__rtypingrrrrrr flagsr r r r__all__rr#r$rrrrrrrrs2#LLKK ' 7 C}%K )K K \ T./8m-m-m-r