idZddlmZddlmZmZmZmZmZm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZmZmZer dd lmZdd lmZed ddZdZGdde eZdS)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) TYPE_CHECKINGListLiteralOptionalTypeVarUnion)Item) ComponentType)MISSING)File)MediaGalleryItemMediaGalleryComponentUnfurledMediaItem)Self) LayoutViewVrT)bound covariant) MediaGalleryc6eZdZdZdZddd,fd Zd-d Zed.dZej d/dZed0dZ e j d1dZ dZ d2dZ e e dd3dZd4d Ze e dd5d#Zd4d$Zd6d%Zed7d'Zed(Zed8d+ZxZS)9raRepresents a UI media gallery. Can contain up to 10 :class:`.MediaGalleryItem`\s. This is a top-level layout component that can only be used on :class:`LayoutView`. .. versionadded:: 2.6 Parameters ---------- \*items: :class:`.MediaGalleryItem` The initial items of this gallery. id: Optional[:class:`int`] The ID of this component. This must be unique across the view. itemsidN)rrrr Optional[int]returnNonecttjt |||_dS)Nr)super__init__r_raw_constructlist _underlying)selfrr __class__s Y/usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages/discord/ui/media_gallery.pyr"zMediaGallery.__init__GsG 0?u++   strcVd|jjdt|jjdS)N)r'__name__lenr%rr&s r(__repr__zMediaGallery.__repr__Ss.Q4>*QQ3t7G7M3N3NQQQQr)List[MediaGalleryItem]c>|jjS)zSList[:class:`.MediaGalleryItem`]: Returns a read-only list of this gallery's items.)r%rcopyr0s r(rzMediaGallery.itemsVs%**,,,r)valuecbt|dkrtd||j_dS)N z)media gallery only accepts up to 10 items)r/ ValueErrorr%rr&r5s r(rzMediaGallery.items[s1 u::??HII I!&r)c|jjS)z1Optional[:class:`int`]: The ID of this component.r%rr0s r(rzMediaGallery.idbs""r)c||j_dSNr;r9s r(rzMediaGallery.idgs#r)c4|jSr=)r%to_dictr0s r(to_component_dictzMediaGallery.to_component_dictks'')))r)boolcdS)NTr0s r(_is_v2zMediaGallery._is_v2nstr) descriptionspoilermedia#Union[str, File, UnfurledMediaItem]rF Optional[str]rGrct|jjdkrtdt |||}|jj||S)aiAdds an item to this gallery. This function returns the class instance to allow for fluent-style chaining. Parameters ---------- media: Union[:class:`str`, :class:`discord.File`, :class:`.UnfurledMediaItem`] The media item data. This can be a string representing a local file uploaded as an attachment in the message, which can be accessed using the ``attachment://`` format, or an arbitrary url. description: Optional[:class:`str`] The description to show within this item. Up to 256 characters. Defaults to ``None``. spoiler: :class:`bool` Whether this item should be flagged as a spoiler. Defaults to ``False``. Raises ------ ValueError Maximum number of items has been exceeded (10). r7)maximum number of items has been exceededrE)r/r%rr8rappend)r&rHrFrGitems r(add_itemzMediaGallery.add_itemqs_< t% & &" , ,HII I;PPP %%d+++ r)rNct|jjdkrtdt |t st d|jj|jj ||S)aAppends an item to this gallery. This function returns the class instance to allow for fluent-style chaining. Parameters ---------- item: :class:`.MediaGalleryItem` The item to add to the gallery. Raises ------ TypeError A :class:`.MediaGalleryItem` was not passed. ValueError Maximum number of items has been exceeded (10). r7rLzexpected MediaGalleryItem, not ) r/r%rr8 isinstancer TypeErrorr'r.rMr&rNs r( append_itemzMediaGallery.append_items{& t% & &" , ,HII I$ 011 [Ydn>UYYZZ Z %%d+++ r)indexintct|jjdkrtdt |||}|jj|||S)aInserts an item before a specified index to the media gallery. This function returns the class instance to allow for fluent-style chaining. Parameters ---------- index: :class:`int` The index of where to insert the field. media: Union[:class:`str`, :class:`discord.File`, :class:`.UnfurledMediaItem`] The media item data. This can be a string representing a local file uploaded as an attachment in the message, which can be accessed using the ``attachment://`` format, or an arbitrary url. description: Optional[:class:`str`] The description to show within this item. Up to 256 characters. Defaults to ``None``. spoiler: :class:`bool` Whether this item should be flagged as a spoiler. Defaults to ``False``. Raises ------ ValueError Maximum number of items has been exceeded (10). r7rLrE)r/r%rr8rinsert)r&rUrHrFrGrNs r(insert_item_atzMediaGallery.insert_item_atsmB t% & &" , ,HII I #    %%eT222 r)ch |jj|n#t$rYnwxYw|S)a Removes an item from the gallery. This function returns the class instance to allow for fluent-style chaining. Parameters ---------- item: :class:`.MediaGalleryItem` The item to remove from the gallery. )r%rremover8rSs r( remove_itemzMediaGallery.remove_itemsI    " ) )$ / / / /    D  s " //cB|jj|S)zRemoves all items from the gallery. This function returns the class instance to allow for fluent-style chaining. )r%rclearr0s r( clear_itemszMediaGallery.clear_itemss! $$&&& r)$Literal[ComponentType.media_gallery]c|jjSr=)r%typer0s r(rbzMediaGallery.types$$r)cdS)NrCr0s r(widthzMediaGallery.widthsqr) componentrc&||jd|jiS)Nrr)clsrfs r(from_componentzMediaGallery.from_components%s _ |   r))rrrrrr)rr*)rr2)r5r2rr)rr)r5rrr)rrA)rHrIrFrJrGrArr)rNrrr) rUrVrHrIrFrJrGrArr)rr)rr`)rfrrr)r. __module__ __qualname____doc____item_repr_attributes__r"r1propertyrsetterrr@rDrrOrTrYr\r_rbre classmethodri __classcell__)r's@r(rr1s  !         RRRR---X- \'''\' ###X#Y$$$Y$***&- ######JB&- ******X$%%%X%X   [     r)rN)rl __future__rtypingrrrrrr rNr enumsr utilsrfiler componentsrrrtyping_extensionsrviewrr__all__rrCr)r(r{sX0#"""""IIIIIIIIIIIIIIII!!!!!! !&&&&&&       GC|t444 V V V V V 47V V V V V r)