diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml index ecec4fbbc..06eb16d9a 100644 --- a/.github/FUNDING.yml +++ b/.github/FUNDING.yml @@ -1,4 +1,4 @@ # These are supported funding model platforms -github: [goverfl0w] +github: [i0bs] open_collective: interactions-py diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index c51781019..897047f84 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -4,12 +4,20 @@ This pull request is about (X), which does (Y). ## Checklist -- [ ] I've ran `pre-commit` to format and lint the change(s) made. -- [ ] I've checked to make sure the change(s) work on `3.8.6` and higher. -- [ ] This fixes/solves an [Issue](https://github.com/goverfl0w/discord-interactions/issues) (If existent):. - - resolves # -- I've made this pull request for/as: (check all that apply) - - [ ] Documentation - - [ ] Breaking change - - [ ] New feature/enhancement - - [ ] Bugfix +- [ ] The ``pre-commit`` code linter has been run over all edited files to ensure the code is linted. +- [ ] I've ensured the change(s) work on `3.8.6` and higher. + + +I've made this pull request: (check all that apply) + - [ ] For the documentation + - [ ] To add a new feature + - [ ] As a general enhancement + - [ ] As a refactor of the library/the library's code + - [ ] To fix an existing bug + - [ ] To resolve #ISSUENUMBER + + +This is: + - [ ] A breaking change + + diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index 4de38d2a0..bde5b0c27 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -29,7 +29,7 @@ repos: - id: check-merge-conflict name: Merge Conflicts - repo: https://github.com/psf/black - rev: 22.6.0 + rev: 22.8.0 hooks: - id: black name: Black Formatting diff --git a/docs/api.models.emoji.rst b/docs/api.models.emoji.rst new file mode 100644 index 000000000..6e1813d85 --- /dev/null +++ b/docs/api.models.emoji.rst @@ -0,0 +1,7 @@ +.. currentmodule:: interactions + +Emoji Models +================ + +.. automodule:: interactions.api.models.emoji + :members: diff --git a/docs/api.models.rst b/docs/api.models.rst index b9fd49298..32c5386f6 100644 --- a/docs/api.models.rst +++ b/docs/api.models.rst @@ -8,6 +8,7 @@ Model Objects api.models.audit_log.rst api.models.channel.rst + api.models.emoji.rst api.models.guild.rst api.models.gw.rst api.models.flags.rst diff --git a/docs/api.rst b/docs/api.rst index 7c1cdc37e..ae3cdc806 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -20,7 +20,7 @@ Interactions ext.rst context.rst - get.rst + utils.rst .. toctree:: :maxdepth: 2 diff --git a/docs/conf.py b/docs/conf.py index c40b3032c..33869f8a6 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -37,6 +37,7 @@ # descriptions of the relevant function/method. autodoc_typehints = "description" +autodoc_typehints_description_target = "documented_params" extensions = [ "sphinx.ext.autodoc", diff --git a/docs/events.rst b/docs/events.rst index 119388dd2..a9bf65a3b 100644 --- a/docs/events.rst +++ b/docs/events.rst @@ -66,9 +66,10 @@ Event: ``raw_socket_create`` This event fires on any event sent by Discord, including ``Typing Start`` and ``Voice State Update``. ``Hello``, ``Resumed``, ``Reconnect`` and ``Invalid Session`` still will not be dispatched. -The function handling the event should take in one argument, the type of this argument is a ``dict``. +A function handling an event should take two arguments, +the first argument is the name of the event, the second is the data of that event with type ``dict``. -The value of the argument will be the *raw* data sent from Discord, so it is not recommended to use that event +The value of the second argument will be the *raw* data sent from Discord, so it is not recommended to use that event as long as you don't absolutely need it. diff --git a/docs/faq.rst b/docs/faq.rst index bb572d212..789b56a66 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -154,21 +154,22 @@ A list of all official extensions can be found `on our github page`_ Those are (at the moment): -- A `voice client`_ - which is still WIP, but it is able to listen for the ``VOICE_STATE_UPDATE`` event. -- An `autosharder`_ for automatic sharding +- `voice client`_ - which is still WIP, but it is able to listen for the ``VOICE_STATE_UPDATE`` event. +- `autosharder`_ for automatic sharding - `wait_for`_ allows listening and waiting for a specific event or a component inside a function - `files`_ for file sending with ctx - `Molter`_ for message commands - `enhanced`_ which enhances the DX in general -- A `paginator`_ for paginating embeds on messages using components -- `persistence`_ - for storing data inside your custom IDs (as an alternative to ``wait_for``) +- `paginator`_ for paginating embeds on messages using components +- `persistence`_ for storing data inside your custom IDs (as an alternative to ``wait_for``) +- `lavalink`_ for voice sending and listening ``VOICE_STATE_UPDATE`` event +- `fastapi`_ for building own API - And a `boilerplate`_ Below are a few unofficial exts (for the time being) which implement some functionality similar to what d.py had: - `checks and cooldowns`_ - `tasks`_ -- `get`_ for getting objects from the discord API (will be implemented into the core library at a later time) Usage examples can usually be found at the linked page @@ -318,4 +319,5 @@ Please join our `Discord Server`_ for any further support regarding our library .. _persistence: https://github.com/interactions-py/persistence .. _Molter: https://github.com/interactions-py/molter .. _boilerplate: https://github.com/interactions-py/boilerplate -.. _get: https://github.com/EdVraz/interactions-get +.. _lavalink: https://github.com/interactions-py/interactions-lavalink +.. _fastapi: https://github.com/interactions-py/interactions-fastapi diff --git a/docs/get.rst b/docs/get.rst deleted file mode 100644 index 03e881794..000000000 --- a/docs/get.rst +++ /dev/null @@ -1,7 +0,0 @@ -.. currentmodule:: interactions - -The ``get`` utility method -================ - -.. automodule:: interactions.client.get - :members: diff --git a/docs/index.rst b/docs/index.rst index cf2e1da66..815613d3f 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -8,7 +8,7 @@ Ever since December 2019, this open-source project has become the culmination of - Looking for a compatible library that implements all interactions? - Itching to get your hands on slash commands, but in a simple manner? -Look no more! The goal of this library is to make all three of these questions go from possibilites to trivial matters. +Look no more! The goal of this library is to make all three of these questions go from possibilities to trivial matters. What can we do? *************** @@ -63,10 +63,10 @@ This open-source project utilizes the following workflows for development: #. **pre-commit** ``2.20.0``: the architecture uses this before every commit to format and check for severity/QOL-breaking changes. #. **black** ``22.6.0`` - #. **flake8** ``4.0.1`` + #. **flake8** ``5.0.4`` #. **isort** ``5.10.1`` -#. **Sphinx** ``4.4.0``: all of our documentation is powered off of autogenerated documentation of the Sphinx engine. +#. **Sphinx** ``5.1.1``: all of our documentation is powered off of autogenerated documentation of the Sphinx engine. #. **Conventional Commits** ``1.0.0``: every commit that we make to our branches use the official specification of CC 1.0.0 to make git graphs easier when improving and refining communication between code reviews, Pull Requests and commits. When can I start? diff --git a/docs/locale/de/LC_MESSAGES/api.dispatch.po b/docs/locale/de/LC_MESSAGES/api.dispatch.po index 2b020e27a..18a4ff864 100644 --- a/docs/locale/de/LC_MESSAGES/api.dispatch.po +++ b/docs/locale/de/LC_MESSAGES/api.dispatch.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.dispatch.rst:4 msgid "Dispatching" @@ -38,12 +38,6 @@ msgstr "" msgid "A list of events being dispatched." msgstr "" -#: interactions.api.dispatch.Listener -#: interactions.api.dispatch.Listener.dispatch -#: interactions.api.dispatch.Listener.register of -msgid "Return type" -msgstr "" - #: interactions.api.dispatch.Listener.dispatch:1 of msgid "Dispatches an event given out by the gateway." msgstr "" @@ -83,3 +77,6 @@ msgstr "" #: interactions.api.dispatch.Listener.register:9 of msgid "The name to associate the coroutine with. Defaults to None." msgstr "" + +#~ msgid "Return type" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.gateway.po b/docs/locale/de/LC_MESSAGES/api.gateway.po index aad9d8772..22e00a8ed 100644 --- a/docs/locale/de/LC_MESSAGES/api.gateway.po +++ b/docs/locale/de/LC_MESSAGES/api.gateway.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.gateway.rst:4 msgid "Gateway" @@ -36,121 +36,169 @@ msgid "" "WebSocket." msgstr "" +#: interactions.api.gateway.client.WebSocketClient:4 of +msgid "" +"The ``__heartbeat_event`` Event object is different from the one built in" +" to the Heartbeater object. The latter is used to trace heartbeat " +"acknowledgement." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient of msgid "Variables" msgstr "" -#: interactions.api.gateway.client.WebSocketClient:3 of +#: interactions.api.gateway.client.WebSocketClient:7 of msgid "The asynchronous event loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:4 of +#: interactions.api.gateway.client.WebSocketClient:8 of msgid "The built-in event dispatcher." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:5 of +#: interactions.api.gateway.client.WebSocketClient:9 of +msgid "The websocket ratelimiter object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:10 of msgid "The user-facing HTTP client." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:6 of +#: interactions.api.gateway.client.WebSocketClient:11 of msgid "The WebSocket data of the connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:7 of +#: interactions.api.gateway.client.WebSocketClient:12 of msgid "Whether the connection has been closed or not." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:8 of +#: interactions.api.gateway.client.WebSocketClient:13 of msgid "The connection options made during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:9 of +#: interactions.api.gateway.client.WebSocketClient:14 of msgid "The gateway intents used for connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:10 of +#: interactions.api.gateway.client.WebSocketClient:15 of msgid "The contents of the application returned when ready." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:11 of +#: interactions.api.gateway.client.WebSocketClient:16 of msgid "The context state of a \"heartbeat\" made to the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:12 of +#: interactions.api.gateway.client.WebSocketClient:17 of +msgid "The state of the overall heartbeat process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:18 of msgid "The shards used during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:13 of +#: interactions.api.gateway.client.WebSocketClient:19 of msgid "The presence used in connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:14 of +#: interactions.api.gateway.client.WebSocketClient:20 of msgid "The ready state of the client as an ``asyncio.Event``." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:15 of -msgid "The closing task for ending connections." +#: interactions.api.gateway.client.WebSocketClient:21 of +msgid "The task containing the heartbeat manager process." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:16 of +#: interactions.api.gateway.client.WebSocketClient:22 of msgid "Whether the client has started." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:17 of +#: interactions.api.gateway.client.WebSocketClient:23 of msgid "The ID of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:18 of +#: interactions.api.gateway.client.WebSocketClient:24 of msgid "The sequence identifier of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:19 of +#: interactions.api.gateway.client.WebSocketClient:25 of msgid "" "The latest time of the last send_packet function call since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:20 of +#: interactions.api.gateway.client.WebSocketClient:26 of msgid "" "The latest time of the last ``HEARTBEAT_ACK`` event since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:21 of -msgid "The latency of the connection, in seconds." +#: interactions.api.gateway.client.WebSocketClient:27 of +msgid "The Websocket ratelimit URL for resuming connections, if any." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:28 of +msgid "The Websocket URL for instantiating connections without resuming." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:29 of +msgid "The lock used for reconnecting the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:30 of +msgid "The lock used for closing the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:31 of +msgid "The task containing stopping the client, if any." msgstr "" #: interactions.api.gateway.client.WebSocketClient #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__identify +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache #: interactions.api.gateway.client.WebSocketClient.__option_type_context +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection +#: interactions.api.gateway.client.WebSocketClient._handle_stream +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence +#: interactions.api.gateway.client.WebSocketClient.request_guild_members #: interactions.api.gateway.heartbeat._Heartbeat of msgid "Parameters" msgstr "" -#: interactions.api.gateway.client.WebSocketClient +#: interactions.api.gateway.client.WebSocketClient.latency:1 of +msgid "The latency of the connection, in seconds." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat:1 of +msgid "" +"Controls the heartbeat manager. Do note that this shouldn't be executed " +"by outside processes." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__heartbeat #: interactions.api.gateway.client.WebSocketClient.__identify #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream -#: interactions.api.gateway.client.WebSocketClient.__restart +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__resume #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection #: interactions.api.gateway.client.WebSocketClient._manage_heartbeat +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence -#: interactions.api.gateway.client.WebSocketClient.wait_until_ready -#: interactions.api.gateway.heartbeat._Heartbeat of +#: interactions.api.gateway.client.WebSocketClient.close +#: interactions.api.gateway.client.WebSocketClient.request_guild_members +#: interactions.api.gateway.client.WebSocketClient.run +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat +#: interactions.api.gateway.client.WebSocketClient.wait_until_ready of msgid "Return type" msgstr "" @@ -158,29 +206,21 @@ msgstr "" msgid "Manages the heartbeat loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__restart:1 of -msgid "Restart the client's connection and heartbeat with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:1 of -msgid "Establishes a client connection with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:3 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:5 of -msgid "The shards to establish a connection with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient.run:1 of +msgid "Handles the client's connection with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._establish_connection:5 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:7 of -msgid "The presence to carry with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:1 of +msgid "" +"Parses raw stream data recieved from the Gateway, including Gateway " +"opcodes and events." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:1 of -msgid "Handles the client's connection with the Gateway." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:4 of +msgid "This should never be called directly." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:3 of +#: interactions.api.gateway.client.WebSocketClient._handle_stream:6 of msgid "The packet stream to handle." msgstr "" @@ -192,31 +232,68 @@ msgstr "" msgid "Dispatches an event from the Gateway." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:3 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:3 of msgid "The name of the event." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:5 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:5 of msgid "The data for the event." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of -msgid "" -"Takes raw data given back from the Gateway and gives \"context\" based " -"off of what it is." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:1 of +msgid "Gets an ID from object." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of -msgid "The data from the Gateway." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:5 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:7 of +msgid "The object of the event." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:7 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:5 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:9 of +msgid "The model of the event." msgstr "" #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context of msgid "Returns" msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:9 of +msgid "Object ID" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:1 of +msgid "Gets a list of ids of object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:7 of +msgid "Object IDs" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:1 of +msgid "Modifies guild cache." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of +msgid "" +"Takes raw data given back from the Gateway and gives \"context\" based " +"off of what it is." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of +msgid "The data from the Gateway." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize:6 of msgid "The context object." msgstr "" @@ -255,11 +332,15 @@ msgstr "" msgid "The option type context." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:1 of -msgid "Receives a stream of packets sent from the Gateway." +#: interactions.api.gateway.client.WebSocketClient._reconnect:1 of +msgid "Restarts the client's connection and heartbeat with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:3 of +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:1 of +msgid "Receives a stream of packets sent from the Gateway in an async process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:3 of msgid "The packet stream." msgstr "" @@ -311,6 +392,58 @@ msgid "" "disconnect." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:1 of +msgid "Sends an ``REQUEST_MEMBERS`` packet to the gateway." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:3 of +msgid "ID of the guild to get members for." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:5 of +msgid "" +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:7 of +msgid "String that username starts with." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.close:1 of +msgid "Closes the current connection." +msgstr "" + #: interactions.api.gateway.heartbeat._Heartbeat:1 of msgid "An internal class representing the heartbeat in a WebSocket connection." msgstr "" + +#~ msgid "The closing task for ending connections." +#~ msgstr "" + +#~ msgid "Restart the client's connection and heartbeat with the Gateway." +#~ msgstr "" + +#~ msgid "Establishes a client connection with the Gateway." +#~ msgstr "" + +#~ msgid "The shards to establish a connection with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "The presence to carry with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "Receives a stream of packets sent from the Gateway." +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.http.po b/docs/locale/de/LC_MESSAGES/api.http.po index b141f2d87..fcab462c2 100644 --- a/docs/locale/de/LC_MESSAGES/api.http.po +++ b/docs/locale/de/LC_MESSAGES/api.http.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.http.rst:4 msgid "HTTP" @@ -55,10 +55,13 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag #: interactions.api.http.channel.ChannelRequest.delete_channel #: interactions.api.http.channel.ChannelRequest.delete_channel_permission #: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag #: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -75,6 +78,7 @@ msgstr "" #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template @@ -169,6 +173,7 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker #: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread #: interactions.api.http.thread.ThreadRequest.join_thread #: interactions.api.http.thread.ThreadRequest.leave_thread @@ -198,14 +203,19 @@ msgstr "" msgid "Parameters" msgstr "" -#: interactions.api.http.channel.ChannelRequest +#: interactions.api.http.route.Route.get_bucket:1 of +msgid "" +"Returns the route's bucket. If shared_bucket is None, returns the path " +"with major parameters. Otherwise, it relies on Discord's given bucket." +msgstr "" + +#: interactions.api.http.route.Route.get_bucket:4 of +msgid "The bucket that Discord provides, if available." +msgstr "" + #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance -#: interactions.api.http.channel.ChannelRequest.delete_channel -#: interactions.api.http.channel.ChannelRequest.delete_channel_permission -#: interactions.api.http.channel.ChannelRequest.delete_stage_instance -#: interactions.api.http.channel.ChannelRequest.edit_channel_permission #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -214,37 +224,21 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel -#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway -#: interactions.api.http.client.HTTPClient.get_current_authorisation_information -#: interactions.api.http.client.HTTPClient.get_current_bot_information -#: interactions.api.http.client.HTTPClient.get_gateway -#: interactions.api.http.client.HTTPClient.login -#: interactions.api.http.client.HTTPClient.logout -#: interactions.api.http.emoji.EmojiRequest #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji -#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji -#: interactions.api.http.guild.GuildRequest #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template -#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template -#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.delete_guild -#: interactions.api.http.guild.GuildRequest.delete_guild_integration -#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles -#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild -#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -255,28 +249,17 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings -#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild -#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget -#: interactions.api.http.guild.GuildRequest.modify_user_voice_state -#: interactions.api.http.guild.GuildRequest.remove_guild_ban -#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template -#: interactions.api.http.interaction.InteractionRequest -#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command -#: interactions.api.http.interaction.InteractionRequest.create_interaction_response -#: interactions.api.http.interaction.InteractionRequest.delete_application_command -#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -285,46 +268,22 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command -#: interactions.api.http.limiter.Limiter -#: interactions.api.http.member.MemberRequest -#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member -#: interactions.api.http.member.MemberRequest.remove_member_role -#: interactions.api.http.member.MemberRequest.search_guild_members -#: interactions.api.http.message.MessageRequest -#: interactions.api.http.message.MessageRequest.create_message -#: interactions.api.http.message.MessageRequest.delete_message -#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message -#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message -#: interactions.api.http.message.MessageRequest.send_message -#: interactions.api.http.message.MessageRequest.unpin_message -#: interactions.api.http.reaction.ReactionRequest -#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction -#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction -#: interactions.api.http.request._Request -#: interactions.api.http.request._Request._check_lock -#: interactions.api.http.request._Request._check_session -#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request -#: interactions.api.http.route.Route interactions.api.http.route.Route.endpoint +#: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket -#: interactions.api.http.scheduledEvent.ScheduledEventRequest #: interactions.api.http.scheduledEvent.ScheduledEventRequest.create_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.delete_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event_users #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events #: interactions.api.http.scheduledEvent.ScheduledEventRequest.modify_scheduled_event -#: interactions.api.http.sticker.StickerRequest #: interactions.api.http.sticker.StickerRequest.create_guild_sticker #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker #: interactions.api.http.sticker.StickerRequest.get_guild_sticker @@ -332,53 +291,44 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker -#: interactions.api.http.thread.ThreadRequest -#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread -#: interactions.api.http.thread.ThreadRequest.join_thread -#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members -#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread -#: interactions.api.http.user.UserRequest #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user -#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild -#: interactions.api.http.webhook.WebhookRequest #: interactions.api.http.webhook.WebhookRequest.create_webhook -#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message -#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks -#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Return type" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:1 of -msgid "" -"Returns the route's bucket. If shared_bucket is None, returns the path " -"with major parameters. Otherwise, it relies on Discord's given bucket." +msgid "Returns" msgstr "" -#: interactions.api.http.route.Route.get_bucket:4 of -msgid "The bucket that Discord provides, if available." +#: interactions.api.http.route.Route.get_bucket:7 of +msgid "The route bucket." msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag +#: interactions.api.http.channel.ChannelRequest.delete_channel +#: interactions.api.http.channel.ChannelRequest.delete_channel_permission +#: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag +#: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -387,20 +337,36 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel +#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway +#: interactions.api.http.client.HTTPClient.get_current_authorisation_information +#: interactions.api.http.client.HTTPClient.get_current_bot_information +#: interactions.api.http.client.HTTPClient.get_gateway +#: interactions.api.http.client.HTTPClient.login +#: interactions.api.http.client.HTTPClient.logout #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji +#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template +#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template +#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.delete_guild +#: interactions.api.http.guild.GuildRequest.delete_guild_integration +#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles +#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild +#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -411,17 +377,27 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings +#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild +#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget +#: interactions.api.http.guild.GuildRequest.modify_user_voice_state +#: interactions.api.http.guild.GuildRequest.remove_guild_ban +#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template +#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command +#: interactions.api.http.interaction.InteractionRequest.create_interaction_response +#: interactions.api.http.interaction.InteractionRequest.delete_application_command +#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -430,13 +406,30 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command +#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member +#: interactions.api.http.member.MemberRequest.remove_member_role +#: interactions.api.http.member.MemberRequest.search_guild_members +#: interactions.api.http.message.MessageRequest.create_message +#: interactions.api.http.message.MessageRequest.delete_message +#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message +#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message +#: interactions.api.http.message.MessageRequest.send_message +#: interactions.api.http.message.MessageRequest.unpin_message +#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction +#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction +#: interactions.api.http.request._Request._check_lock +#: interactions.api.http.request._Request._check_session +#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request #: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket @@ -453,31 +446,36 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker +#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread +#: interactions.api.http.thread.ThreadRequest.join_thread +#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members +#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user +#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild #: interactions.api.http.webhook.WebhookRequest.create_webhook +#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message +#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks +#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Returns" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:7 of -msgid "The route bucket." +msgid "Return type" msgstr "" #: interactions.api.http.route.Route.endpoint:1 of @@ -617,9 +615,12 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel_invite:6 #: interactions.api.http.channel.ChannelRequest.create_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.create_tag:7 #: interactions.api.http.channel.ChannelRequest.delete_channel_permission:3 #: interactions.api.http.channel.ChannelRequest.delete_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.delete_tag:3 #: interactions.api.http.channel.ChannelRequest.edit_channel_permission:3 +#: interactions.api.http.channel.ChannelRequest.edit_tag:7 #: interactions.api.http.channel.ChannelRequest.get_channel:3 #: interactions.api.http.channel.ChannelRequest.get_channel_invites:3 #: interactions.api.http.channel.ChannelRequest.get_channel_messages:6 @@ -919,6 +920,51 @@ msgstr "" msgid "Delete a stage instance." msgstr "" +#: interactions.api.http.channel.ChannelRequest.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:4 +#: interactions.api.http.channel.ChannelRequest.edit_tag:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:8 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:9 +#: interactions.api.http.channel.ChannelRequest.edit_tag:10 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:10 +#: interactions.api.http.channel.ChannelRequest.edit_tag:11 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:1 of +msgid "Update a tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:8 of +msgid "The ID of the tag to update." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:1 of +msgid "Delete a forum tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:4 of +msgid "The ID of the tag to delete" +msgstr "" + #: interactions.api.http.emoji.EmojiRequest.get_all_emoji:1 of msgid "Gets all emojis from a guild." msgstr "" @@ -1279,6 +1325,7 @@ msgstr "" msgid "Gets all roles from a Guild." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:3 #: interactions.api.http.guild.GuildRequest.create_guild_ban:3 #: interactions.api.http.guild.GuildRequest.create_guild_kick:3 #: interactions.api.http.guild.GuildRequest.get_all_roles:3 @@ -1374,7 +1421,9 @@ msgid "" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "" +"Number of seconds to delete messages for, between 0 and 604800. Default " +"to 0" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:6 of @@ -1467,20 +1516,36 @@ msgstr "" msgid "Reason to send to audit log, if any." msgstr "" -#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of -msgid "" -"Retrieves a dict from an API that results in how many members would be " -"pruned given the amount of days." +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:1 of +msgid "Begins a prune operation." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:4 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:4 of -msgid "Number of days to count. Defaults to ``7``." +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:5 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:6 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:5 of msgid "Role IDs to include, if given." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:7 of +msgid "A dict containing `{\"pruned\": int}` or `{\"pruned\": None}`" +msgstr "" + +#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of +msgid "" +"Retrieves a dict from an API that results in how many members would be " +"pruned given the amount of days." +msgstr "" + #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:6 of msgid "A dict denoting `{\"pruned\": int}`" msgstr "" @@ -1974,7 +2039,8 @@ msgid "Channel snowflake ID." msgstr "" #: interactions.api.http.message.MessageRequest.create_message:5 -#: interactions.api.http.message.MessageRequest.edit_message:6 of +#: interactions.api.http.message.MessageRequest.edit_message:6 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:9 of msgid "An optional list of files to send attached to the message." msgstr "" @@ -2178,11 +2244,8 @@ msgid "Guild Scheduled Event ID snowflake." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:5 -#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 #: of -msgid "" -"A boolean to include number of users subscribed to the associated event, " -"if given." +msgid "Whether the number of users subscribed to the events is returned." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:6 @@ -2195,6 +2258,13 @@ msgstr "" msgid "Gets all guild scheduled events in a guild." msgstr "" +#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 +#: of +msgid "" +"Whether the number of users subscribed to the associated event is " +"returned." +msgstr "" + #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:5 #: of msgid "" @@ -2307,22 +2377,25 @@ msgid "" "MANAGE_EMOJIS_AND_STICKERS permission." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 -#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of -msgid "the payload to send." +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 of +msgid "The payload to send." msgstr "" #: interactions.api.http.sticker.StickerRequest.create_guild_sticker:4 of +msgid "The file to send." +msgstr "" + +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 of msgid "The guild to create sticker at." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:5 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:6 of msgid "The reason for this action." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 of +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:7 of msgid "The new sticker data on success." msgstr "" @@ -2332,6 +2405,10 @@ msgid "" "permission." msgstr "" +#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of +msgid "the payload to send." +msgstr "" + #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:3 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:4 of msgid "The guild of the target sticker." @@ -2483,15 +2560,18 @@ msgid "" "with.." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:3 of +#: interactions.api.http.thread.ThreadRequest.create_thread:3 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:3 of msgid "The ID of the channel to create this thread in" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:4 of +#: interactions.api.http.thread.ThreadRequest.create_thread:4 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:4 of msgid "The name of the thread" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:5 of +#: interactions.api.http.thread.ThreadRequest.create_thread:5 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:5 of msgid "" "duration in minutes to automatically archive the thread after recent " "activity, can be set to: 60, 1440, 4320, 10080" @@ -2511,7 +2591,8 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:10 of +#: interactions.api.http.thread.ThreadRequest.create_thread:10 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:11 of msgid "An optional reason for the audit log" msgstr "" @@ -2519,6 +2600,28 @@ msgstr "" msgid "The created thread" msgstr "" +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:1 of +msgid "From a given Forum channel, create a Thread with a message to start with." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:7 of +msgid "The payload/dictionary contents of the first message in the forum thread." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:8 of +msgid "List of tag ids that can be applied to the forum, if any." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:10 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:12 of +msgid "Returns a Thread in a Forum object with a starting Message." +msgstr "" + #: interactions.api.http.user.UserRequest.get_self:1 of msgid "An alias to `get_user`, but only gets the current bot user." msgstr "" @@ -2743,3 +2846,15 @@ msgstr "" #: of msgid "Deletes the original message object sent." msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Number of days to count. Defaults to ``7``." +#~ msgstr "" + +#~ msgid "" +#~ "A boolean to include number of " +#~ "users subscribed to the associated " +#~ "event, if given." +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.models.audit_log.po b/docs/locale/de/LC_MESSAGES/api.models.audit_log.po new file mode 100644 index 000000000..7ba1f1c2b --- /dev/null +++ b/docs/locale/de/LC_MESSAGES/api.models.audit_log.po @@ -0,0 +1,413 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.audit_log.rst:4 +msgid "Audit-Log Models" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:1 of +msgid "A class object representing an AuditLogEntry." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange +#: interactions.api.models.audit_log.AuditLogEntry +#: interactions.api.models.audit_log.AuditLogEvents +#: interactions.api.models.audit_log.AuditLogs +#: interactions.api.models.audit_log.OptionalAuditEntryInfo of +msgid "Variables" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:3 of +msgid "ID of the affected entity (webhook, user, role, etc.)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:4 of +msgid "Changes made to the target_id" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:5 of +msgid "User or app that made the changes" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:6 of +msgid "ID of the entry" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:7 of +msgid "Type of action that occurred" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:8 of +msgid "Additional info for certain event types" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:9 of +msgid "Reason for the change (1-512 characters)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "A class object representing the different types of AuditLogEvents." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:3 of +msgid "1 - Server settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:4 of +msgid "10 - Channel was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:5 of +msgid "11 - Channel settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:6 of +msgid "12 - Channel was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:7 of +msgid "13 - Permission overwrite was added to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:8 of +msgid "14 - Permission overwrite was updated for a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:9 of +msgid "15 - Permission overwrite was deleted from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:10 of +msgid "20 - Member was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:11 of +msgid "21 - Members were pruned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:12 of +msgid "22 - Member was banned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:13 of +msgid "23 - Server ban was lifted for a member" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:14 of +msgid "24 - Member was updated in server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:15 of +msgid "25 - Member was added or removed from a role" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:16 of +msgid "26 - Member was moved to a different voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:17 of +msgid "27 - Member was disconnected from a voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:18 of +msgid "28 - Bot user was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:19 of +msgid "30 - Role was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:20 of +msgid "31 - Role was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:21 of +msgid "32 - Role was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:22 of +msgid "40 - Server invite was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:23 of +msgid "41 - Server invite was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:24 of +msgid "42 - Server invite was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:25 of +msgid "50 - Webhook was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:26 of +msgid "51 - Webhook properties or channel were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:27 of +msgid "52 - Webhook was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:28 of +msgid "60 - Emoji was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:29 of +msgid "61 - Emoji name was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:30 of +msgid "62 - Emoji was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:31 of +msgid "72 - Single message was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:32 of +msgid "73 - Multiple messages were deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:33 of +msgid "74 - Message was pinned to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:34 of +msgid "75 - Message was unpinned from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:35 of +msgid "80 - App was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:36 of +msgid "81 - App was updated (as an example, its scopes were updated)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:37 of +msgid "82 - App was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:38 of +msgid "83 - Stage instance was created (stage channel becomes live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:39 of +msgid "84 - Stage instance details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:40 of +msgid "85 - Stage instance was deleted (stage channel no longer live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:41 of +msgid "90 - Sticker was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:42 of +msgid "91 - Sticker details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:43 of +msgid "92 - Sticker was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:44 of +msgid "100 - Event was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:45 of +msgid "101 - Event was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:46 of +msgid "102 - Event was cancelled" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:47 of +msgid "110 - Thread was created in a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:48 of +msgid "111 - Thread was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:49 of +msgid "112 - Thread was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:50 of +msgid "121 - Permissions were updated for a command" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:51 of +msgid "140 - Auto Moderation rule was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:52 of +msgid "141 - Auto Moderation rule was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:53 of +msgid "142 - Auto Moderation rule was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:54 of +msgid "143 - Message was blocked by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:55 of +msgid "144 - Message was flagged by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:56 of +msgid "145 - Member was timed out by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents of +msgid "Member Type" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid ":py:class:`int`" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:1 of +msgid "A class object representing the audit logs of a guild." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:3 of +msgid "List of audit log entries, sorted from most to least recent." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:4 of +msgid "List of auto moderation rules referenced in the audit log." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:5 of +msgid "List of guild scheduled events referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:6 of +msgid "List of partial integration objects" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:7 of +msgid "List of threads referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:8 of +msgid "List of users referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:9 of +msgid "List of webhooks referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:1 of +msgid "A class object representing an AuditLogChange." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:3 of +msgid "New value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:4 of +msgid "Old value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:5 of +msgid "" +"Name of the changed entity, with a few " +"[exceptions](https://discord.com/developers/docs/resources/audit-log" +"#audit-log-change-object-audit-log-change-exceptions)" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:1 of +msgid "A class object representing OptionalAuditEntryInfo." +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:3 of +msgid "" +"ID of the app whose permissions were targeted. ``AuditLogEvents``-type: " +"121" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:4 of +msgid "" +"Channel in which the entities were targeted. ``AuditLogEvents``-types: " +"26, 74, 75, 72, 83, 84, 85" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:5 of +msgid "" +"Name of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:6 of +msgid "" +"Trigger type of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:7 of +msgid "" +"Number of entities that were targeted. ``AuditLogEvents``-types: 72, 73, " +"27, 26" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:8 of +msgid "" +"Number of days after which inactive members were kicked. " +"``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:9 of +msgid "ID of the overwritten entity. ``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:10 of +msgid "Number of members removed by the prune. ``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:11 of +msgid "ID of the message that was targeted. ``AuditLogEvents``-types: 74, 75" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:12 of +msgid "" +"Name of the role if type is \"0\" (not present if type is \"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:13 of +msgid "" +"Type of overwritten entity - role (\"0\") or member (\"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.models.channel.po b/docs/locale/de/LC_MESSAGES/api.models.channel.po index 1ca5f1ac3..81a65bd8e 100644 --- a/docs/locale/de/LC_MESSAGES/api.models.channel.po +++ b/docs/locale/de/LC_MESSAGES/api.models.channel.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.channel.rst:4 msgid "Channel Models" @@ -39,22 +39,24 @@ msgid "Valid values are as follows:" msgstr "" #: interactions.api.models.channel.Thread:1 of -msgid "An object representing a thread." -msgstr "" - -#: interactions.api.models.channel.Thread:4 of -msgid "" -"This is a derivation of the base Channel, since a thread can be its own " -"event." +msgid "An object representing a thread. .. note::" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator +#: interactions.api.models.channel.AsyncTypingContextManager #: interactions.api.models.channel.Channel #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.modify #: interactions.api.models.channel.Channel.pin_message @@ -72,6 +74,9 @@ msgstr "" #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit #: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit #: interactions.api.models.channel.Thread #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of @@ -88,7 +93,7 @@ msgid "" "needed to be used directly." msgstr "" -#: interactions.api.models.channel.Channel +#: interactions.api.models.channel.Channel interactions.api.models.channel.Tags #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of msgid "Variables" @@ -183,33 +188,64 @@ msgid "The amount of members in the channel." msgstr "" #: interactions.api.models.channel.Channel:29 of -msgid "The thread metadata of the channel." +msgid "Boolean representing if a thread is created." msgstr "" #: interactions.api.models.channel.Channel:30 of -msgid "The member of the thread in the channel." +msgid "The thread metadata of the channel." msgstr "" #: interactions.api.models.channel.Channel:31 of +msgid "The member of the thread in the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:32 of msgid "" "The set auto-archive time for all threads to naturally follow in the " "channel." msgstr "" -#: interactions.api.models.channel.Channel:32 of +#: interactions.api.models.channel.Channel:33 of msgid "The permissions of the channel." msgstr "" -#: interactions.api.models.channel.Channel.mention:1 of -msgid "Returns a string that allows you to mention the given channel." +#: interactions.api.models.channel.Channel:34 of +msgid "The flags of the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:35 of +msgid "Number of messages ever sent in a thread." +msgstr "" + +#: interactions.api.models.channel.Channel:36 of +msgid "" +"The default slowmode delay in seconds for threads, if this channel is a " +"forum." +msgstr "" + +#: interactions.api.models.channel.Channel:37 of +msgid "Tags in a forum channel, if any." +msgstr "" + +#: interactions.api.models.channel.Channel:38 of +msgid "Default reaction emoji for threads created in a forum, if any." +msgstr "" + +#: interactions.api.models.channel.Channel.typing:1 of +msgid "Manages the typing of the channel. Use with `await` or `async with`" msgstr "" #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.mention #: interactions.api.models.channel.Channel.modify @@ -224,24 +260,33 @@ msgstr "" #: interactions.api.models.channel.Channel.set_position #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic -#: interactions.api.models.channel.Channel.set_user_limit of +#: interactions.api.models.channel.Channel.set_user_limit +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Tags.edit of msgid "Returns" msgstr "" -#: interactions.api.models.channel.Channel.mention:3 of -msgid "The string of the mentioned channel." +#: interactions.api.models.channel.Channel.typing:3 of +msgid "A manager for typing" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator.flatten #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread #: interactions.api.models.channel.Channel.delete +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages #: interactions.api.models.channel.Channel.get_webhooks +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.join #: interactions.api.models.channel.Channel.leave #: interactions.api.models.channel.Channel.lock @@ -261,10 +306,44 @@ msgstr "" #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit -#: interactions.api.models.channel.Channel.unpin_message of +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit of msgid "Return type" msgstr "" +#: interactions.api.models.channel.Channel.mention:1 of +msgid "Returns a string that allows you to mention the given channel." +msgstr "" + +#: interactions.api.models.channel.Channel.mention:3 of +msgid "The string of the mentioned channel." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:7 +#: interactions.api.models.channel.Channel.history:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:9 +#: interactions.api.models.channel.Channel.history:3 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:13 +#: interactions.api.models.channel.Channel.history:5 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.channel.Channel.history:7 of +msgid "A custom check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.Channel.history:10 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" + #: interactions.api.models.channel.Channel.send:1 of msgid "Sends a message in the channel." msgstr "" @@ -292,7 +371,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.channel.Channel.send:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.channel.Channel.send:15 of @@ -625,10 +704,12 @@ msgstr "" msgid "Creates a thread in the Channel." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:3 #: interactions.api.models.channel.Channel.create_thread:3 of msgid "The name of the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:5 #: interactions.api.models.channel.Channel.create_thread:5 of msgid "" "duration in minutes to automatically archive the thread after recent " @@ -649,6 +730,7 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:16 #: interactions.api.models.channel.Channel.create_thread:14 of msgid "An optional reason for the audit log" msgstr "" @@ -734,6 +816,109 @@ msgstr "" msgid "Add the bot to the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:4 +#: interactions.api.models.channel.Channel.edit_tag:4 +#: interactions.api.models.channel.Tags.edit:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:7 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:9 +#: interactions.api.models.channel.Channel.edit_tag:11 +#: interactions.api.models.channel.Tags.edit:11 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:11 +#: interactions.api.models.channel.Channel.edit_tag:13 +#: interactions.api.models.channel.Tags.edit:13 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:13 of +msgid "The create tag object" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:1 of +msgid "Edits a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:7 of +msgid "The ID of the tag to edit" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:9 +#: interactions.api.models.channel.Tags.edit:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:15 +#: interactions.api.models.channel.Tags.edit:15 of +msgid "The modified tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:1 of +msgid "Deletes a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:3 of +msgid "The ID of the Tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:1 of +msgid "Creates a new post inside a forum channel" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:8 of +msgid "The content to send as first message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:10 of +msgid "Tags to give to the created thread" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:12 of +msgid "An optional list of files to send attached to the message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:14 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:18 of +msgid "A channel of ChannelType 11 (THREAD)" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:1 of +msgid "Returns the permissions of the member in this specific channel." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:4 of +msgid "" +"The permissions returned by this function take into account role and user" +" overwrites that can be assigned to channels or categories. If you don't " +"need these overwrites, look into :meth:`.Member.get_guild_permissions`." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:8 of +msgid "The member to get the permissions from" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:10 of +msgid "Permissions of the member in this channel" +msgstr "" + #: interactions.api.models.channel.ThreadMember:1 of msgid "A class object representing a member in a thread." msgstr "" @@ -793,3 +978,83 @@ msgstr "" #: interactions.api.models.channel.ThreadMetadata:11 of msgid "The ability to invite users to the thread." msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:3 +#: interactions.api.models.channel.AsyncTypingContextManager:5 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:11 of +msgid "A check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:1 of +msgid "An async context manager for triggering typing." +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:3 of +msgid "The channel to trigger typing in." +msgstr "" + +#: interactions.api.models.channel.Tags:1 of +msgid "An object denoting a tag object within a forum channel." +msgstr "" + +#: interactions.api.models.channel.Tags:4 of +msgid "If the emoji is custom, it won't have name information." +msgstr "" + +#: interactions.api.models.channel.Tags:6 of +msgid "Name of the tag. The limit is up to 20 characters." +msgstr "" + +#: interactions.api.models.channel.Tags:7 of +msgid "ID of the tag. Can also be 0 if manually created." +msgstr "" + +#: interactions.api.models.channel.Tags:8 of +msgid "" +"A boolean denoting whether this tag can be removed/added by moderators " +"with ``manage_threads`` permissions." +msgstr "" + +#: interactions.api.models.channel.Tags:9 of +msgid "The emoji to represent the tag, if any." +msgstr "" + +#: interactions.api.models.channel.Tags.delete:1 of +msgid "Deletes this tag" +msgstr "" + +#: interactions.api.models.channel.Tags.delete:3 +#: interactions.api.models.channel.Tags.edit:7 of +msgid "The ID of the channel where the tag belongs to" +msgstr "" + +#: interactions.api.models.channel.Tags.edit:1 of +msgid "Edits this tag" +msgstr "" + +#~ msgid "An object representing a thread." +#~ msgstr "" + +#~ msgid "" +#~ "This is a derivation of the base" +#~ " Channel, since a thread can be " +#~ "its own event." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.models.emoji.po b/docs/locale/de/LC_MESSAGES/api.models.emoji.po new file mode 100644 index 000000000..2809ce66e --- /dev/null +++ b/docs/locale/de/LC_MESSAGES/api.models.emoji.po @@ -0,0 +1,139 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-29 13:24-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.emoji.rst:4 +msgid "Emoji Models" +msgstr "" + +#: interactions.api.models.emoji.Emoji:1 of +msgid "A class objecting representing an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji of +msgid "Variables" +msgstr "" + +#: interactions.api.models.emoji.Emoji:3 of +msgid "Emoji id" +msgstr "" + +#: interactions.api.models.emoji.Emoji:4 of +msgid "Emoji name." +msgstr "" + +#: interactions.api.models.emoji.Emoji:5 of +msgid "Roles allowed to use this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:6 of +msgid "User that created this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:7 of +msgid "Status denoting of this emoji must be wrapped in colons" +msgstr "" + +#: interactions.api.models.emoji.Emoji:8 of +msgid "Status denoting if this emoji is managed (by an integration)" +msgstr "" + +#: interactions.api.models.emoji.Emoji:9 of +msgid "Status denoting if this emoji is animated" +msgstr "" + +#: interactions.api.models.emoji.Emoji:10 of +msgid "" +"Status denoting if this emoji can be used. (Can be false via server " +"boosting)" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:1 of +msgid "Gets an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild of +msgid "Parameters" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:3 of +msgid "The id of the guild of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:5 of +msgid "The id of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:7 +#: interactions.api.models.emoji.Emoji.get_all_of_guild:5 of +msgid "The HTTPClient of your bot. Equals to ``bot._http``" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Returns" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:9 of +msgid "The Emoji as object" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Return type" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:1 of +msgid "Gets all emoji of a guild." +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:3 of +msgid "The id of the guild to get the emojis of" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:7 of +msgid "The Emoji as list" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:1 of +msgid "Deletes the emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:3 of +msgid "The guild id to delete the emoji from" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:5 of +msgid "The reason of the deletion" +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:1 of +msgid "Returns the emoji's URL." +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:3 of +msgid "URL of the emoji" +msgstr "" + +#~ msgid "Audit-Log Models" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.models.guild.po b/docs/locale/de/LC_MESSAGES/api.models.guild.po index a233b694b..6a195d3a5 100644 --- a/docs/locale/de/LC_MESSAGES/api.models.guild.po +++ b/docs/locale/de/LC_MESSAGES/api.models.guild.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:25-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.guild.rst:4 msgid "Guild Models" @@ -85,6 +85,7 @@ msgstr "" msgid "The location of the event, if any." msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator #: interactions.api.models.guild.EventMetadata #: interactions.api.models.guild.Guild #: interactions.api.models.guild.Guild.add_member_role @@ -95,17 +96,25 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji #: interactions.api.models.guild.Guild.delete_role #: interactions.api.models.guild.Guild.delete_scheduled_event +#: interactions.api.models.guild.Guild.delete_sticker +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule @@ -115,6 +124,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -672,13 +683,26 @@ msgid "The id of the member to ban" msgstr "" #: interactions.api.models.guild.Guild.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.guild.Guild.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:13 of +msgid "The reason of the ban" msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator.flatten #: interactions.api.models.guild.Guild.add_member_role #: interactions.api.models.guild.Guild.ban #: interactions.api.models.guild.Guild.clone_channel @@ -687,6 +711,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji @@ -698,13 +723,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.leave #: interactions.api.models.guild.Guild.list_auto_moderation_rules @@ -716,6 +749,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -840,6 +875,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_channel #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.get_all_active_threads #: interactions.api.models.guild.Guild.get_all_bans @@ -847,13 +883,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule #: interactions.api.models.guild.Guild.modify_channel @@ -862,6 +906,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.search_members of msgid "Returns" msgstr "" @@ -1508,6 +1554,20 @@ msgstr "" msgid "The created event" msgstr "" +#: interactions.api.models.guild.Guild.get_scheduled_events:1 of +msgid "Gets all scheduled events of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:3 of +msgid "" +"A boolean to include number of users subscribed to the associated event, " +"if given." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:5 of +msgid "The sheduled events of the guild." +msgstr "" + #: interactions.api.models.guild.Guild.modify_scheduled_event:1 of msgid "Edits a scheduled event of the guild." msgstr "" @@ -1614,6 +1674,40 @@ msgstr "" msgid "Gets all bans of the guild." msgstr "" +#: interactions.api.models.guild.Guild.prune:1 of +msgid "Begins a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:3 +#: interactions.api.models.guild.Guild.prune:3 of +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:4 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:4 +#: interactions.api.models.guild.Guild.prune:5 of +msgid "Role IDs to include, if given." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:6 of +msgid "" +"The number of pruned members, if compute_prune_count is not false. " +"Otherwise returns None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:1 of +msgid "Returns the number of members that would be removed in a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:5 of +msgid "The number of members that would be pruned." +msgstr "" + #: interactions.api.models.guild.Guild.get_emoji:1 of msgid "Gets an emoji of the guild and returns it." msgstr "" @@ -1664,6 +1758,77 @@ msgstr "" msgid "The emoji or the id of the emoji to delete" msgstr "" +#: interactions.api.models.guild.Guild.get_stickers:1 of +msgid "Get the stickers for a guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_stickers:3 of +msgid "List of stickers of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:1 of +msgid "Gets the list of sticker packs available to Nitro subscribers." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:3 of +msgid "List of sticker packs." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:1 of +msgid "Creates a new sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:3 of +msgid "The file of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:5 of +msgid "The tags of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:7 +#: interactions.api.models.guild.Guild.modify_sticker:5 of +msgid "The name of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:9 +#: interactions.api.models.guild.Guild.modify_sticker:7 of +msgid "The description of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:11 of +msgid "The reason of the creation." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:13 of +msgid "Created sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:1 of +msgid "Modifies the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:3 +#: interactions.api.models.guild.Guild.modify_sticker:3 of +msgid "The sticker or ID of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:9 of +msgid "The reason of the modification." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:11 of +msgid "Modified sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:1 of +msgid "Deletes the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:5 of +msgid "The reason of the deletion." +msgstr "" + #: interactions.api.models.guild.Guild.get_list_of_members:1 of msgid "Lists the members of a guild." msgstr "" @@ -1710,6 +1875,23 @@ msgstr "" msgid "Returns a list of all members of the guild" msgstr "" +#: interactions.api.models.guild.Guild.get_members:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:11 +#: interactions.api.models.guild.Guild.get_members:3 of +msgid "A set maximum of members to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:5 of +msgid "A custom check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:8 of +msgid "An asynchronous iterator over the members of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.list_auto_moderation_rules:1 of msgid "Lists all AutoMod rules" msgstr "" @@ -1784,6 +1966,55 @@ msgstr "" msgid "The rule to modify" msgstr "" +#: interactions.api.models.guild.Guild.get_audit_logs:1 of +msgid "Gets the audit logs of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:3 of +msgid "How many entries to get, default 100" +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:5 +#: interactions.api.models.guild.Guild.get_full_audit_logs:3 of +msgid "User ID snowflake. filter the log for actions made by a user." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:7 of +msgid "The Type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:9 of +msgid "filter the log before a certain entry id." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:11 of +msgid "The guild audit logs" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:1 of +msgid "Gets the latest audit log action of either a user or an action type" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:3 of +msgid "The user, user id or action type to look for" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:5 of +msgid "The latest AuditLog action that applies to the ``of`` parameter" +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:1 of +msgid "Gets the full audit log of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:5 of +msgid "The type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:7 of +msgid "The full AuditLog of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.icon_url:1 of msgid "" "Returns the URL of the guild's icon. :return: URL of the guild's icon " @@ -1897,3 +2128,32 @@ msgstr "" #: interactions.api.models.guild.Invite.delete:1 of msgid "Deletes the invite" msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:3 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:5 of +msgid "The guild to get the members from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:7 of +msgid "" +"The member ID to start getting members from (gets all members after that " +"member)" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:9 of +msgid "A check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.models.gw.po b/docs/locale/de/LC_MESSAGES/api.models.gw.po index fe823c232..88a920629 100644 --- a/docs/locale/de/LC_MESSAGES/api.models.gw.po +++ b/docs/locale/de/LC_MESSAGES/api.models.gw.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.gw.rst:4 msgid "Gateway-specific Event Models" @@ -42,10 +42,10 @@ msgstr "" #: interactions.api.models.gw.GuildScheduledEventUser #: interactions.api.models.gw.GuildStickers #: interactions.api.models.gw.Integration +#: interactions.api.models.gw.MessageDelete #: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList +#: interactions.api.models.gw.MessageReactionRemove +#: interactions.api.models.gw.Presence interactions.api.models.gw.ThreadList #: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks #: of msgid "Variables" @@ -93,36 +93,6 @@ msgstr "" msgid "The substring in content that triggered rule." msgstr "" -#: interactions.api.models.gw.ApplicationCommandPermissions -#: interactions.api.models.gw.AutoModerationAction -#: interactions.api.models.gw.AutoModerationRule -#: interactions.api.models.gw.ChannelPins -#: interactions.api.models.gw.EmbeddedActivity -#: interactions.api.models.gw.GuildBan interactions.api.models.gw.GuildEmojis -#: interactions.api.models.gw.GuildIntegrations -#: interactions.api.models.gw.GuildJoinRequest -#: interactions.api.models.gw.GuildMember -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send -#: interactions.api.models.gw.GuildMembers interactions.api.models.gw.GuildRole -#: interactions.api.models.gw.GuildScheduledEvent -#: interactions.api.models.gw.GuildScheduledEventUser -#: interactions.api.models.gw.GuildStickers -#: interactions.api.models.gw.Integration -#: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList -#: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks -#: of -msgid "Parameters" -msgstr "" - #: interactions.api.models.gw.AutoModerationRule:1 of msgid "" "A class object representing the gateway events " @@ -232,14 +202,14 @@ msgstr "" #: interactions.api.models.gw.GuildEmojis:3 #: interactions.api.models.gw.GuildIntegrations:3 #: interactions.api.models.gw.GuildJoinRequest:7 -#: interactions.api.models.gw.GuildMember:3 #: interactions.api.models.gw.GuildMembers:3 #: interactions.api.models.gw.GuildRole:3 #: interactions.api.models.gw.GuildStickers:3 #: interactions.api.models.gw.Integration:23 +#: interactions.api.models.gw.MessageDelete:5 #: interactions.api.models.gw.MessageReaction:6 +#: interactions.api.models.gw.MessageReactionRemove:10 #: interactions.api.models.gw.Presence:4 -#: interactions.api.models.gw.ReactionRemove:10 #: interactions.api.models.gw.ThreadList:3 #: interactions.api.models.gw.ThreadMembers:4 of msgid "The guild ID of the event." @@ -251,8 +221,9 @@ msgstr "" #: interactions.api.models.gw.ChannelPins:4 #: interactions.api.models.gw.EmbeddedActivity:9 +#: interactions.api.models.gw.MessageDelete:4 #: interactions.api.models.gw.MessageReaction:4 -#: interactions.api.models.gw.ReactionRemove:8 of +#: interactions.api.models.gw.MessageReactionRemove:8 of msgid "The channel ID of the event." msgstr "" @@ -312,7 +283,6 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildBan:4 -#: interactions.api.models.gw.GuildMember:5 #: interactions.api.models.gw.Integration:17 #: interactions.api.models.gw.Presence:3 of msgid "The user of the event." @@ -378,14 +348,21 @@ msgstr "" msgid "The members of the thread of the event." msgstr "" -#: interactions.api.models.gw.ReactionRemove:1 of +#: interactions.api.models.gw.MessageDelete:1 of +msgid "A class object representing the gateway event ``MESSAGE_DELETE_BULK``." +msgstr "" + +#: interactions.api.models.gw.MessageDelete:3 of +msgid "The message IDs of the event." +msgstr "" + +#: interactions.api.models.gw.MessageReactionRemove:1 of msgid "" "A class object representing the gateway events " -"``MESSAGE_REACTION_REMOVE``, ``MESSAGE_REACTION_REMOVE_ALL`` and " -"``MESSAGE_REACTION_REMOVE_EMOJI``." +"``MESSAGE_REACTION_REMOVE_ALL`` and ``MESSAGE_REACTION_REMOVE_EMOJI``." msgstr "" -#: interactions.api.models.gw.ReactionRemove:4 of +#: interactions.api.models.gw.MessageReactionRemove:4 of msgid "" "This class inherits the already existing attributes of " ":class:`interactions.api.models.gw.Reaction`. The main missing attribute " @@ -394,22 +371,24 @@ msgstr "" #: interactions.api.models.gw.GuildJoinRequest:6 #: interactions.api.models.gw.MessageReaction:3 -#: interactions.api.models.gw.ReactionRemove:7 of +#: interactions.api.models.gw.MessageReactionRemove:7 of msgid "The user ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:5 -#: interactions.api.models.gw.ReactionRemove:9 of +#: interactions.api.models.gw.MessageReactionRemove:9 of msgid "The message ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:8 -#: interactions.api.models.gw.ReactionRemove:11 of +#: interactions.api.models.gw.MessageReactionRemove:11 of msgid "The emoji of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:1 of -msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +msgid "" +"A class object representing the gateway event ``MESSAGE_REACTION_ADD`` " +"and ``MESSAGE_REACTION_REMOVE``." msgstr "" #: interactions.api.models.gw.MessageReaction:7 of @@ -473,204 +452,58 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildMember:4 of -msgid "The roles of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:6 of -msgid "The nickname of the user of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:7 of -msgid "The avatar URL of the user of the event." +msgid "" +"``pending`` and ``permissions`` only apply for members retroactively " +"requiring to verify rules via. membership screening or lack permissions " +"to speak." msgstr "" #: interactions.api.models.gw.GuildMember:8 of -msgid "The time that the user of the event joined at." +msgid "The guild ID." msgstr "" #: interactions.api.models.gw.GuildMember:9 of -msgid "The time that the user of the event has since had \"premium.\"" +msgid "The user of the guild." msgstr "" #: interactions.api.models.gw.GuildMember:10 of -msgid "Whether the member of the event is deafened or not." +msgid "The nickname of the member." msgstr "" #: interactions.api.models.gw.GuildMember:11 of -msgid "Whether the member of the event is muted or not." +msgid "The hash containing the user's guild avatar, if applicable." msgstr "" #: interactions.api.models.gw.GuildMember:12 of -msgid "" -"Whether the member of the event is still pending -- pass membership " -"screening -- or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:1 of -msgid "Returns the ID of the user." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.send of -msgid "Returns" -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:3 of -msgid "The ID of the user" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send of -msgid "Return type" -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:1 of -msgid "Returns the string of either the user's nickname or username." -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:3 of -msgid "The name of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:1 of -msgid "Returns a string that allows you to mention the given member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:3 of -msgid "The string of the mentioned member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:1 of -msgid "Bans the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:3 of -msgid "The reason of the ban" -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:1 of -msgid "Kicks the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:3 of -msgid "The reason for the kick" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:1 of -msgid "This method adds a role to a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:3 of -msgid "The role to add. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:5 of -msgid "The reason why the roles are added" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:1 of -msgid "This method removes a role from a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:3 of -msgid "The role to remove. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:5 of -msgid "The reason why the roles are removed" -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:1 of -msgid "Sends a DM to the member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:3 of -msgid "The contents of the message as a string or string-converted value." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:5 of -msgid "A component, or list of components for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:7 of -msgid "Whether the message utilizes the text-to-speech Discord programme or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:9 of -msgid "A file or list of files to be attached to the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:11 of -msgid "An embed, or list of embeds for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:13 of -msgid "The message interactions/mention limits that the message can refer to." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:15 of -msgid "The sent message as an object." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:1 of -msgid "Modifies the member of a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:3 of -msgid "The nickname of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:5 of -msgid "A list of all role ids the member has" +msgid "The list of roles of the member." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:7 of -msgid "whether the user is muted in voice channels" +#: interactions.api.models.gw.GuildMember:13 of +msgid "The timestamp the member joined the guild at." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:9 of -msgid "whether the user is deafened in voice channels" +#: interactions.api.models.gw.GuildMember:14 of +msgid "The timestamp the member has been a server booster since." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:11 of -msgid "id of channel to move user to (if they are connected to voice)" +#: interactions.api.models.gw.GuildMember:15 of +msgid "Whether the member is deafened." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:13 of -msgid "" -"when the user's timeout will expire and the user will be able to " -"communicate in the guild again (up to 28 days in the future)" +#: interactions.api.models.gw.GuildMember:16 of +msgid "Whether the member is muted." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:15 of -msgid "The reason of the modifying" +#: interactions.api.models.gw.GuildMember:17 of +msgid "Whether the member is pending to pass membership screening." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:17 of -msgid "The modified member object" +#: interactions.api.models.gw.GuildMember:18 of +msgid "Whether the member has permissions." msgstr "" -#: interactions.api.models.gw.GuildMember.add_to_thread:1 of -msgid "Adds the member to a thread." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_to_thread:3 of -msgid "The id of the thread to add the member to" +#: interactions.api.models.gw.GuildMember:19 of +msgid "How long until they're unmuted, if any." msgstr "" #: interactions.api.models.gw.GuildStickers:1 of @@ -823,3 +656,164 @@ msgstr "" #: interactions.api.models.gw.GuildRole:5 of msgid "The role ID of the event." msgstr "" + +#~ msgid "" +#~ "A class object representing the gateway" +#~ " events ``MESSAGE_REACTION_REMOVE``, " +#~ "``MESSAGE_REACTION_REMOVE_ALL`` and " +#~ "``MESSAGE_REACTION_REMOVE_EMOJI``." +#~ msgstr "" + +#~ msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +#~ msgstr "" + +#~ msgid "The roles of the event." +#~ msgstr "" + +#~ msgid "The nickname of the user of the event." +#~ msgstr "" + +#~ msgid "The avatar URL of the user of the event." +#~ msgstr "" + +#~ msgid "The time that the user of the event joined at." +#~ msgstr "" + +#~ msgid "The time that the user of the event has since had \"premium.\"" +#~ msgstr "" + +#~ msgid "Whether the member of the event is deafened or not." +#~ msgstr "" + +#~ msgid "Whether the member of the event is muted or not." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the member of the event is" +#~ " still pending -- pass membership " +#~ "screening -- or not." +#~ msgstr "" + +#~ msgid "Returns the ID of the user." +#~ msgstr "" + +#~ msgid "Returns" +#~ msgstr "" + +#~ msgid "The ID of the user" +#~ msgstr "" + +#~ msgid "Return type" +#~ msgstr "" + +#~ msgid "Returns the string of either the user's nickname or username." +#~ msgstr "" + +#~ msgid "The name of the member" +#~ msgstr "" + +#~ msgid "Returns a string that allows you to mention the given member." +#~ msgstr "" + +#~ msgid "The string of the mentioned member." +#~ msgstr "" + +#~ msgid "Bans the member from a guild." +#~ msgstr "" + +#~ msgid "The reason of the ban" +#~ msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Kicks the member from a guild." +#~ msgstr "" + +#~ msgid "The reason for the kick" +#~ msgstr "" + +#~ msgid "This method adds a role to a member." +#~ msgstr "" + +#~ msgid "The role to add. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are added" +#~ msgstr "" + +#~ msgid "This method removes a role from a member." +#~ msgstr "" + +#~ msgid "The role to remove. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are removed" +#~ msgstr "" + +#~ msgid "Sends a DM to the member." +#~ msgstr "" + +#~ msgid "The contents of the message as a string or string-converted value." +#~ msgstr "" + +#~ msgid "A component, or list of components for the message." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the message utilizes the " +#~ "text-to-speech Discord programme or " +#~ "not." +#~ msgstr "" + +#~ msgid "A file or list of files to be attached to the message." +#~ msgstr "" + +#~ msgid "An embed, or list of embeds for the message." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The sent message as an object." +#~ msgstr "" + +#~ msgid "Modifies the member of a guild." +#~ msgstr "" + +#~ msgid "The nickname of the member" +#~ msgstr "" + +#~ msgid "A list of all role ids the member has" +#~ msgstr "" + +#~ msgid "whether the user is muted in voice channels" +#~ msgstr "" + +#~ msgid "whether the user is deafened in voice channels" +#~ msgstr "" + +#~ msgid "id of channel to move user to (if they are connected to voice)" +#~ msgstr "" + +#~ msgid "" +#~ "when the user's timeout will expire " +#~ "and the user will be able to " +#~ "communicate in the guild again (up " +#~ "to 28 days in the future)" +#~ msgstr "" + +#~ msgid "The reason of the modifying" +#~ msgstr "" + +#~ msgid "The modified member object" +#~ msgstr "" + +#~ msgid "Adds the member to a thread." +#~ msgstr "" + +#~ msgid "The id of the thread to add the member to" +#~ msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.models.member.po b/docs/locale/de/LC_MESSAGES/api.models.member.po index ce23f99ac..f5839f391 100644 --- a/docs/locale/de/LC_MESSAGES/api.models.member.po +++ b/docs/locale/de/LC_MESSAGES/api.models.member.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.member.rst:4 msgid "Member Models" @@ -86,6 +86,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.modify #: interactions.api.models.member.Member.remove_role @@ -93,10 +95,20 @@ msgstr "" msgid "Parameters" msgstr "" +#: interactions.api.models.member.Member.guild_id:1 of +msgid "" +"Attempts to get the guild ID the member is in. Only works then roles or " +"nick or joined at is present. :return: The ID of the guild this member " +"belongs to." +msgstr "" + #: interactions.api.models.member.Member.id:1 of msgid "Returns the ID of the user." msgstr "" +#: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.mention #: interactions.api.models.member.Member.modify @@ -113,6 +125,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.mention @@ -148,11 +162,23 @@ msgid "The id of the guild to ban the member from" msgstr "" #: interactions.api.models.member.Member.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.member.Member.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.member.Member.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.member.Member.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.member.Member.ban:13 of +msgid "The reason of the ban" msgstr "" #: interactions.api.models.member.Member.kick:1 of @@ -230,7 +256,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.member.Member.send:15 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.member.Member.send:17 of @@ -288,9 +314,83 @@ msgid "The id of the thread to add the member to" msgstr "" #: interactions.api.models.member.Member.get_avatar_url:1 of +msgid "Returns the URL of the member's avatar for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:3 of +msgid "The id of the guild to get the member's avatar from" +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:5 of +msgid "URL of the members's avatar (None will be returned if no avatar is set)" +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:1 of +msgid "Returns the permissions of the member for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:4 of msgid "" -"Returns the URL of the member's avatar for the specified guild. :param " -"guild_id: The id of the guild to get the member's avatar from :type " -"guild_id: Union[int, Snowflake, \"Guild\"] :return: URL of the members's " -"avatar (None will be returned if no avatar is set) :rtype: str" +"The permissions returned by this function will not take into account role" +" and user overwrites that can be assigned to channels or categories. If " +"you need these overwrites, look into " +":meth:`.Channel.get_permissions_for`." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:8 of +msgid "The guild of the member" msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:10 of +msgid "Base permissions of the member in the specified guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:1 of +msgid "Returns whether the member has the permissions passed." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:4 of +msgid "" +"If the channel argument is present, the function will look if the member " +"has the permissions in the specified channel. If the argument is missing," +" then it will only consider the member's guild permissions." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:7 of +msgid "The list of permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:9 of +msgid "The channel where to check for permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:11 of +msgid "The id of the guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:13 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:15 of +msgid "Whether the member has the permissions" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "" +#~ "Returns the URL of the member's " +#~ "avatar for the specified guild. :param" +#~ " guild_id: The id of the guild " +#~ "to get the member's avatar from " +#~ ":type guild_id: Union[int, Snowflake, " +#~ "\"Guild\"] :return: URL of the members's" +#~ " avatar (None will be returned if " +#~ "no avatar is set) :rtype: str" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.models.message.po b/docs/locale/de/LC_MESSAGES/api.models.message.po index 5bcd77f9c..e1f033a87 100644 --- a/docs/locale/de/LC_MESSAGES/api.models.message.po +++ b/docs/locale/de/LC_MESSAGES/api.models.message.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.message.rst:4 msgid "Message Models" @@ -50,14 +50,14 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji #: interactions.api.models.message.Message #: interactions.api.models.message.MessageActivity #: interactions.api.models.message.MessageInteraction #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Variables" msgstr "" @@ -156,33 +156,33 @@ msgid "" msgstr "" #: interactions.api.models.message.Message:26 of -msgid "The allowed mentions of roles attached in the message." -msgstr "" - -#: interactions.api.models.message.Message:27 of msgid "Message flags" msgstr "" -#: interactions.api.models.message.Message:28 of +#: interactions.api.models.message.Message:27 of msgid "Message interaction object, if the message is sent by an interaction." msgstr "" -#: interactions.api.models.message.Message:29 of +#: interactions.api.models.message.Message:28 of msgid "" "The thread that started from this message, if any, with a thread member " "object embedded." msgstr "" +#: interactions.api.models.message.Message:29 of +msgid "Array of Action Rows associated with this message, if any." +msgstr "" + #: interactions.api.models.message.Message:30 of -msgid "Components associated with this message, if any." +msgid "An array of message sticker item objects, if sent with them." msgstr "" #: interactions.api.models.message.Message:31 of -msgid "An array of message sticker item objects, if sent with them." +msgid "Array of sticker objects sent with the message if any. Deprecated." msgstr "" #: interactions.api.models.message.Message:32 of -msgid "Array of sticker objects sent with the message if any. Deprecated." +msgid "The approximate position of the message in a thread." msgstr "" #: interactions.api.models.message.Attachment @@ -202,10 +202,6 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild #: interactions.api.models.message.Message #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread @@ -222,7 +218,8 @@ msgstr "" #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Parameters" msgstr "" @@ -230,6 +227,7 @@ msgstr "" msgid "Gets the channel where the message was sent." msgstr "" +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Embed.add_field #: interactions.api.models.message.Embed.clear_fields #: interactions.api.models.message.Embed.insert_field_at @@ -241,13 +239,10 @@ msgstr "" #: interactions.api.models.message.Embed.set_image #: interactions.api.models.message.Embed.set_thumbnail #: interactions.api.models.message.Embed.set_video -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread #: interactions.api.models.message.Message.delete +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_channel #: interactions.api.models.message.Message.get_from_url @@ -307,7 +302,7 @@ msgstr "" #: interactions.api.models.message.Message.edit:13 #: interactions.api.models.message.Message.reply:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.message.Message.edit:15 @@ -323,10 +318,9 @@ msgid "" "components will be removed" msgstr "" -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Message.create_thread +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_from_url #: interactions.api.models.message.Message.get_users_from_reaction @@ -466,6 +460,14 @@ msgstr "" msgid "The URL of said message" msgstr "" +#: interactions.api.models.message.Message.disable_all_components:1 of +msgid "Sets all components to disabled on this message." +msgstr "" + +#: interactions.api.models.message.Message.disable_all_components:3 of +msgid "The modified message." +msgstr "" + #: interactions.api.models.message.MessageReference:1 of msgid "A class object representing the \"referenced\"/replied message." msgstr "" @@ -654,20 +656,26 @@ msgstr "" msgid "Inserts a field in the embed at the specified index" msgstr "" -#: interactions.api.models.message.Embed.insert_field_at:3 -#: interactions.api.models.message.Embed.remove_field:3 -#: interactions.api.models.message.Embed.set_field_at:3 of -msgid "The new field's index" +#: interactions.api.models.message.Embed.insert_field_at:3 of +msgid "The field's index to insert" msgstr "" #: interactions.api.models.message.Embed.set_field_at:1 of msgid "Overwrites the field in the embed at the specified index" msgstr "" +#: interactions.api.models.message.Embed.set_field_at:3 of +msgid "The field's index to overwrite" +msgstr "" + #: interactions.api.models.message.Embed.remove_field:1 of msgid "Remove field at the specified index" msgstr "" +#: interactions.api.models.message.Embed.remove_field:3 of +msgid "The field's index to remove" +msgstr "" + #: interactions.api.models.message.Embed.remove_author:1 of msgid "Removes the embed's author" msgstr "" @@ -906,95 +914,12 @@ msgstr "" msgid "Whether the attachment is ephemeral." msgstr "" -#: interactions.api.models.message.Emoji:1 of -msgid "A class objecting representing an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji:3 of -msgid "Emoji id" -msgstr "" - -#: interactions.api.models.message.Emoji:4 of -msgid "Emoji name." -msgstr "" - -#: interactions.api.models.message.Emoji:5 of -msgid "Roles allowed to use this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:6 of -msgid "User that created this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:7 of -msgid "Status denoting of this emoji must be wrapped in colons" -msgstr "" - -#: interactions.api.models.message.Emoji:8 of -msgid "Status denoting if this emoji is managed (by an integration)" -msgstr "" - -#: interactions.api.models.message.Emoji:9 of -msgid "Status denoting if this emoji is animated" -msgstr "" - -#: interactions.api.models.message.Emoji:10 of -msgid "" -"Status denoting if this emoji can be used. (Can be false via server " -"boosting)" -msgstr "" - -#: interactions.api.models.message.Emoji.get:1 of -msgid "Gets an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.get:3 of -msgid "The id of the guild of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:5 of -msgid "The id of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:7 -#: interactions.api.models.message.Emoji.get_all_of_guild:5 of -msgid "The HTTPClient of your bot. Equals to ``bot._http``" -msgstr "" - -#: interactions.api.models.message.Emoji.get:9 of -msgid "The Emoji as object" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:1 of -msgid "Gets all emoji of a guild." +#: interactions.api.models.message.Attachment.download:1 of +msgid "Downloads the attachment." msgstr "" -#: interactions.api.models.message.Emoji.get_all_of_guild:3 of -msgid "The id of the guild to get the emojis of" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:7 of -msgid "The Emoji as list" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:1 of -msgid "Deletes the emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.delete:3 of -msgid "The guild id to delete the emoji from" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:5 of -msgid "The reason of the deletion" -msgstr "" - -#: interactions.api.models.message.Emoji.url:1 of -msgid "Returns the emoji's URL." -msgstr "" - -#: interactions.api.models.message.Emoji.url:3 of -msgid "URL of the emoji" +#: interactions.api.models.message.Attachment.download:3 of +msgid "The attachment's bytes as BytesIO object" msgstr "" #: interactions.api.models.message.EmbedFooter:1 of @@ -1093,3 +1018,116 @@ msgstr "" #: interactions.api.models.message.Sticker:14 of msgid "The standard sticker's sort order within its pack" msgstr "" + +#: interactions.api.models.message.StickerPack:1 of +msgid "A class objects representing a pack of stickers." +msgstr "" + +#: interactions.api.models.message.StickerPack:3 of +msgid "ID of the sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:4 of +msgid "The stickers in the pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:5 of +msgid "The name of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:6 of +msgid "ID of the pack's SKU." +msgstr "" + +#: interactions.api.models.message.StickerPack:7 of +msgid "ID of a sticker in the pack which is shown as the pack's icon." +msgstr "" + +#: interactions.api.models.message.StickerPack:8 of +msgid "The description of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:9 of +msgid "ID of the sticker pack's banner image." +msgstr "" + +#~ msgid "The allowed mentions of roles attached in the message." +#~ msgstr "" + +#~ msgid "Components associated with this message, if any." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The new field's index" +#~ msgstr "" + +#~ msgid "A class objecting representing an emoji." +#~ msgstr "" + +#~ msgid "Emoji id" +#~ msgstr "" + +#~ msgid "Emoji name." +#~ msgstr "" + +#~ msgid "Roles allowed to use this emoji" +#~ msgstr "" + +#~ msgid "User that created this emoji" +#~ msgstr "" + +#~ msgid "Status denoting of this emoji must be wrapped in colons" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is managed (by an integration)" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is animated" +#~ msgstr "" + +#~ msgid "" +#~ "Status denoting if this emoji can " +#~ "be used. (Can be false via server" +#~ " boosting)" +#~ msgstr "" + +#~ msgid "Gets an emoji." +#~ msgstr "" + +#~ msgid "The id of the guild of the emoji" +#~ msgstr "" + +#~ msgid "The id of the emoji" +#~ msgstr "" + +#~ msgid "The HTTPClient of your bot. Equals to ``bot._http``" +#~ msgstr "" + +#~ msgid "The Emoji as object" +#~ msgstr "" + +#~ msgid "Gets all emoji of a guild." +#~ msgstr "" + +#~ msgid "The id of the guild to get the emojis of" +#~ msgstr "" + +#~ msgid "The Emoji as list" +#~ msgstr "" + +#~ msgid "Deletes the emoji." +#~ msgstr "" + +#~ msgid "The guild id to delete the emoji from" +#~ msgstr "" + +#~ msgid "The reason of the deletion" +#~ msgstr "" + +#~ msgid "Returns the emoji's URL." +#~ msgstr "" + +#~ msgid "URL of the emoji" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.models.misc.po b/docs/locale/de/LC_MESSAGES/api.models.misc.po index cfed122db..77ec620aa 100644 --- a/docs/locale/de/LC_MESSAGES/api.models.misc.po +++ b/docs/locale/de/LC_MESSAGES/api.models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.misc.rst:4 msgid "Miscellanous Models" @@ -27,6 +27,7 @@ msgstr "" msgid "An enumeration." msgstr "" +#: interactions.api.models.misc.AllowedMentionType #: interactions.api.models.misc.AutoModKeywordPresetTypes #: interactions.api.models.misc.AutoModTriggerType of msgid "Member Type" @@ -37,6 +38,7 @@ msgstr "" msgid ":py:class:`int`" msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 #: interactions.api.models.misc.AutoModKeywordPresetTypes:1 #: interactions.api.models.misc.AutoModTriggerType:1 of msgid "Valid values are as follows:" @@ -50,6 +52,7 @@ msgstr "" msgid "The maximum duration for duration_seconds is 2419200 seconds, aka 4 weeks." msgstr "" +#: interactions.api.models.misc.AllowedMentions #: interactions.api.models.misc.AutoModAction #: interactions.api.models.misc.AutoModMetaData #: interactions.api.models.misc.AutoModTriggerMetadata @@ -66,15 +69,6 @@ msgstr "" msgid "Timeout duration in seconds, if timed out." msgstr "" -#: interactions.api.models.misc.AutoModAction -#: interactions.api.models.misc.AutoModMetaData -#: interactions.api.models.misc.AutoModTriggerMetadata -#: interactions.api.models.misc.ClientStatus interactions.api.models.misc.File -#: interactions.api.models.misc.Image interactions.api.models.misc.Overwrite -#: interactions.api.models.misc.Snowflake of -msgid "Parameters" -msgstr "" - #: interactions.api.models.misc.AutoModAction:1 of msgid "" "A class object used for the ``AUTO_MODERATION_ACTION_EXECUTION`` event. " @@ -107,6 +101,53 @@ msgstr "" msgid "The internally pre-defined wordsets which will be searched for in content." msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "An enumerable object representing the allowed mention types" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:1 of +msgid "A class object representing the allowed mentions object" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:3 of +msgid "" +"Optional[List[AllowedMentionType]]: An array of allowed mention types to " +"parse from the content." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:4 of +msgid "Optional[List[int]]: An array of user ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:5 of +msgid "Optional[List[int]]: An array of role ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:6 of +msgid "" +"Optional[bool]: For replies, whether to mention the author of the message" +" being replied to." +msgstr "" + #: interactions.api.models.misc.Snowflake:1 of msgid "The Snowflake object." msgstr "" @@ -129,17 +170,6 @@ msgid "" "integer." msgstr "" -#: interactions.api.models.misc.Color.black -#: interactions.api.models.misc.Color.blurple -#: interactions.api.models.misc.Color.fuchsia -#: interactions.api.models.misc.Color.green -#: interactions.api.models.misc.Color.red -#: interactions.api.models.misc.Color.white -#: interactions.api.models.misc.Color.yellow -#: interactions.api.models.misc.Snowflake of -msgid "Return type" -msgstr "" - #: interactions.api.models.misc.Snowflake.increment:1 of msgid "" "This is the 'Increment' portion of the snowflake. This is incremented for" @@ -199,6 +229,16 @@ msgstr "" msgid "Returns a hexadecimal value of the blurple color." msgstr "" +#: interactions.api.models.misc.Color.black +#: interactions.api.models.misc.Color.blurple +#: interactions.api.models.misc.Color.fuchsia +#: interactions.api.models.misc.Color.green +#: interactions.api.models.misc.Color.red +#: interactions.api.models.misc.Color.white +#: interactions.api.models.misc.Color.yellow of +msgid "Return type" +msgstr "" + #: interactions.api.models.misc.Color.green:1 of msgid "Returns a hexadecimal value of the green color." msgstr "" @@ -287,3 +327,6 @@ msgstr "" #: interactions.api.models.misc.Overwrite:6 of msgid "Permission bit set." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.models.presence.po b/docs/locale/de/LC_MESSAGES/api.models.presence.po index 347c24dbc..cfbae19fa 100644 --- a/docs/locale/de/LC_MESSAGES/api.models.presence.po +++ b/docs/locale/de/LC_MESSAGES/api.models.presence.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.presence.rst:4 msgid "Presence Models" @@ -43,15 +43,6 @@ msgstr "" msgid "An array denoting the party's current and max size" msgstr "" -#: interactions.api.models.presence.ClientPresence -#: interactions.api.models.presence.PresenceActivity -#: interactions.api.models.presence.PresenceAssets -#: interactions.api.models.presence.PresenceParty -#: interactions.api.models.presence.PresenceSecrets -#: interactions.api.models.presence.PresenceTimestamp of -msgid "Parameters" -msgstr "" - #: interactions.api.models.presence.PresenceAssets:1 of msgid "A class object representing the assets of a presence." msgstr "" @@ -231,3 +222,6 @@ msgstr "" #: interactions.api.models.presence.ClientPresence:6 of msgid "Whether the client is afk or not." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.models.role.po b/docs/locale/de/LC_MESSAGES/api.models.role.po index c78eeec53..4828e3cfc 100644 --- a/docs/locale/de/LC_MESSAGES/api.models.role.po +++ b/docs/locale/de/LC_MESSAGES/api.models.role.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.role.rst:4 msgid "Role Models" @@ -130,6 +130,12 @@ msgstr "" msgid "RGB color value as integer, defaults to the current value of the role" msgstr "" +#: interactions.api.models.role.Role.modify:9 of +msgid "" +"Bitwise value of the enabled/disabled permissions, defaults to the " +"current value of the role" +msgstr "" + #: interactions.api.models.role.Role.modify:11 of msgid "" "Whether the role should be displayed separately in the sidebar, defaults " diff --git a/docs/locale/de/LC_MESSAGES/api.models.team.po b/docs/locale/de/LC_MESSAGES/api.models.team.po index 2958a4252..36accb3a5 100644 --- a/docs/locale/de/LC_MESSAGES/api.models.team.po +++ b/docs/locale/de/LC_MESSAGES/api.models.team.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.team.rst:4 msgid "Team Models" @@ -51,11 +51,6 @@ msgstr "" msgid "The User ID of the current team owner" msgstr "" -#: interactions.api.models.team.Application interactions.api.models.team.Team -#: interactions.api.models.team.TeamMember of -msgid "Parameters" -msgstr "" - #: interactions.api.models.team.TeamMember:1 of msgid "A class object representing the member of a team." msgstr "" @@ -183,3 +178,6 @@ msgstr "" #: interactions.api.models.team.Application.icon_url of msgid "Return type" msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.models.user.po b/docs/locale/de/LC_MESSAGES/api.models.user.po index 5721c56da..00f10cc86 100644 --- a/docs/locale/de/LC_MESSAGES/api.models.user.po +++ b/docs/locale/de/LC_MESSAGES/api.models.user.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.user.rst:4 msgid "User Models" @@ -94,17 +94,14 @@ msgstr "" msgid "The user's public flags" msgstr "" -#: interactions.api.models.user.User of -msgid "Parameters" -msgstr "" - #: interactions.api.models.user.User.mention:1 of msgid "Returns a string that allows you to mention the given user." msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Returns" msgstr "" @@ -114,7 +111,8 @@ msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Return type" msgstr "" @@ -133,3 +131,14 @@ msgstr "" #: interactions.api.models.user.User.banner_url:3 of msgid "URL of the user's banner (None will be returned if no banner is set)" msgstr "" + +#: interactions.api.models.user.User.presence:1 of +msgid "Returns the presence of the user." +msgstr "" + +#: interactions.api.models.user.User.presence:3 of +msgid "Presence of the user (None will be returned if not cached)" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/api.models.webhook.po b/docs/locale/de/LC_MESSAGES/api.models.webhook.po index be10a2fd1..906a172a9 100644 --- a/docs/locale/de/LC_MESSAGES/api.models.webhook.po +++ b/docs/locale/de/LC_MESSAGES/api.models.webhook.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.webhook.rst:4 msgid "Webhook Models" @@ -209,7 +209,7 @@ msgid "embedded ``rich`` content" msgstr "" #: interactions.api.models.webhook.Webhook.execute:18 of -msgid "allowed mentions for the message" +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.webhook.Webhook.execute:20 of @@ -257,3 +257,6 @@ msgstr "" #: interactions.api.models.webhook.WebhookType:1 of msgid "Valid values are as follows:" msgstr "" + +#~ msgid "allowed mentions for the message" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/client.po b/docs/locale/de/LC_MESSAGES/client.po index 854019fc5..48424e61c 100644 --- a/docs/locale/de/LC_MESSAGES/client.po +++ b/docs/locale/de/LC_MESSAGES/client.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../client.rst:4 msgid "Bot Client" @@ -31,10 +31,6 @@ msgstr "" #: interactions.client.bot.Client #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence @@ -44,6 +40,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.user_command #: interactions.client.bot.Extension of msgid "Parameters" @@ -80,60 +77,73 @@ msgid "" "automatic or not." msgstr "" +#: interactions.client.bot.Client:15 of +msgid "" +"Set to ``True`` to enable debug logging or set to a log level to use a " +"specific level" +msgstr "" + #: interactions.client.bot.Client of msgid "Variables" msgstr "" -#: interactions.client.bot.Client:16 of +#: interactions.client.bot.Client:18 of msgid "The asynchronous event loop of the client." msgstr "" -#: interactions.client.bot.Client:17 of +#: interactions.client.bot.Client:19 of msgid "" "The user-facing HTTP connection to the Web API, as its own separate " "client." msgstr "" -#: interactions.client.bot.Client:18 of +#: interactions.client.bot.Client:20 of msgid "An object-orientation of a websocket server connection to the Gateway." msgstr "" -#: interactions.client.bot.Client:19 of +#: interactions.client.bot.Client:21 of msgid "The Gateway intents of the application. Defaults to ``Intents.DEFAULT``." msgstr "" -#: interactions.client.bot.Client:20 of +#: interactions.client.bot.Client:22 of msgid "The list of bucketed shards for the application's connection." msgstr "" -#: interactions.client.bot.Client:21 of +#: interactions.client.bot.Client:23 of msgid "The RPC-like presence shown on an application once connected." msgstr "" -#: interactions.client.bot.Client:22 of +#: interactions.client.bot.Client:24 of msgid "The token of the application used for authentication when connecting." msgstr "" -#: interactions.client.bot.Client:23 of +#: interactions.client.bot.Client:25 of msgid "The \"extensions\" or cog equivalence registered to the main client." msgstr "" -#: interactions.client.bot.Client:24 of +#: interactions.client.bot.Client:26 of msgid "The application representation of the client." msgstr "" -#: interactions.client.bot.Client +#: interactions.client.bot.Client.guilds:1 of +msgid "Returns a list of guilds the bot is in." +msgstr "" + +#: interactions.client.bot.Client.latency:1 of +msgid "Returns the connection latency in milliseconds." +msgstr "" + +#: interactions.client.bot.Client.start:1 of +msgid "Starts the client session." +msgstr "" + #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create -#: interactions.client.bot.Client.__register_events #: interactions.client.bot.Client.__resolve_commands #: interactions.client.bot.Client.__sync #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client._login interactions.client.bot.Client._ready +#: interactions.client.bot.Client._stop #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence #: interactions.client.bot.Client.command @@ -142,6 +152,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.start #: interactions.client.bot.Client.user_command #: interactions.client.bot.Client.wait_until_ready @@ -149,22 +160,6 @@ msgstr "" msgid "Return type" msgstr "" -#: interactions.client.bot.Client.guilds:1 of -msgid "Returns a list of guilds the bot is in." -msgstr "" - -#: interactions.client.bot.Client.latency:1 of -msgid "Returns the connection latency in milliseconds." -msgstr "" - -#: interactions.client.bot.Client.start:1 of -msgid "Starts the client session." -msgstr "" - -#: interactions.client.bot.Client.__register_events:1 of -msgid "Registers all raw gateway events to the known events." -msgstr "" - #: interactions.client.bot.Client.__compare_sync:1 of msgid "Compares an application command during the synchronization process." msgstr "" @@ -178,10 +173,6 @@ msgid "The \"pool\" or list of commands to compare from." msgstr "" #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.command @@ -204,6 +195,10 @@ msgid "" "conditions have been met in a chronological order:" msgstr "" +#: interactions.client.bot.Client._stop:1 of +msgid "Stops the websocket connection gracefully." +msgstr "" + #: interactions.client.bot.Client._login:1 of msgid "Makes a login with the Discord API." msgstr "" @@ -448,7 +443,7 @@ msgid "" msgstr "" #: interactions.client.bot.Client._find_command:3 of -msgid "The name of the command to match" +msgid "The name or ID of the command to match" msgstr "" #: interactions.client.bot.Client._find_command:5 of @@ -574,59 +569,34 @@ msgstr "" msgid "The modified User object" msgstr "" -#: interactions.client.bot.Client.__raw_socket_create:1 of -msgid "" -"This is an internal function that takes any gateway socket event and then" -" returns the data purely based off of what it does in the client " -"instantiation class." -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:5 of -msgid "The data that is returned" -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:7 of -msgid "A dictionary of raw data." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:1 of -msgid "" -"This is an internal function that caches the channel creates when " -"dispatched." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:3 of -msgid "The channel object data in question." +#: interactions.client.bot.Client.request_guild_members:1 of +msgid "Requests guild members via websocket." msgstr "" -#: interactions.client.bot.Client.__raw_channel_create:5 of -msgid "The channel as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:3 of +msgid "ID of the guild to get members for." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:1 of +#: interactions.client.bot.Client.request_guild_members:5 of msgid "" -"This is an internal function that caches the message creates when " -"dispatched." +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:3 of -msgid "The message object data in question." +#: interactions.client.bot.Client.request_guild_members:7 of +msgid "String that username starts with." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:5 of -msgid "The message as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:1 of -msgid "This is an internal function that caches the guild creates on ready." +#: interactions.client.bot.Client.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:3 of -msgid "The guild object data in question." -msgstr "" - -#: interactions.client.bot.Client.__raw_guild_create:5 of -msgid "The guild as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." msgstr "" #: interactions.client.bot.Extension:1 of @@ -639,3 +609,56 @@ msgstr "" #: interactions.client.bot.Extension:5 of msgid "The structure of an extension:" msgstr "" + +#~ msgid "Registers all raw gateway events to the known events." +#~ msgstr "" + +#~ msgid "The name of the command to match" +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "takes any gateway socket event and " +#~ "then returns the data purely based " +#~ "off of what it does in the " +#~ "client instantiation class." +#~ msgstr "" + +#~ msgid "The data that is returned" +#~ msgstr "" + +#~ msgid "A dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the channel creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The channel object data in question." +#~ msgstr "" + +#~ msgid "The channel as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the message creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The message object data in question." +#~ msgstr "" + +#~ msgid "The message as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "This is an internal function that caches the guild creates on ready." +#~ msgstr "" + +#~ msgid "The guild object data in question." +#~ msgstr "" + +#~ msgid "The guild as a dictionary of raw data." +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/context.po b/docs/locale/de/LC_MESSAGES/context.po index 3917f5b73..8352a5d3e 100644 --- a/docs/locale/de/LC_MESSAGES/context.po +++ b/docs/locale/de/LC_MESSAGES/context.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../context.rst:4 msgid "Event Context" @@ -55,7 +55,6 @@ msgstr "" msgid "The guild data model." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update #: interactions.client.context.CommandContext #: interactions.client.context.CommandContext.defer #: interactions.client.context.CommandContext.edit @@ -63,12 +62,15 @@ msgstr "" #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context #: interactions.client.context._Context.edit +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup -#: interactions.client.context._Context.send of +#: interactions.client.context._Context.send +#: interactions.utils.attrs_utils.DictSerializerMixin.update of msgid "Parameters" msgstr "" @@ -79,11 +81,13 @@ msgstr "" #: interactions.client.context.CommandContext.edit #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.send of msgid "Returns" msgstr "" @@ -98,11 +102,13 @@ msgstr "" #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup #: interactions.client.context._Context.send of msgid "Return type" @@ -153,7 +159,7 @@ msgstr "" #: interactions.client.context.CommandContext.send:12 #: interactions.client.context.ComponentContext.send:12 #: interactions.client.context._Context.send:12 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.client.context.CommandContext.send:14 @@ -171,6 +177,12 @@ msgstr "" #: interactions.client.context.CommandContext.send:18 #: interactions.client.context.ComponentContext.send:18 #: interactions.client.context._Context.send:18 of +msgid "Whether embeds are not shown in the message." +msgstr "" + +#: interactions.client.context.CommandContext.send:20 +#: interactions.client.context.ComponentContext.send:20 +#: interactions.client.context._Context.send:20 of msgid "The sent message as an object." msgstr "" @@ -197,13 +209,39 @@ msgstr "" msgid "The components you wish to show." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:1 of +#: interactions.client.context._Context.has_permissions:1 of +msgid "" +"Returns whether the author of the interaction has the permissions in the " +"given context." +msgstr "" + +#: interactions.client.context._Context.has_permissions:3 of +msgid "The list of permissions" +msgstr "" + +#: interactions.client.context._Context.has_permissions:5 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.client.context._Context.has_permissions:7 of +msgid "Whether the author has the permissions" +msgstr "" + +#: ../../docstring interactions.client.context.CommandContext._extras:1 +#: interactions.client.context.ComponentContext._extras:1 +#: interactions.client.context._Context._extras:1 of +msgid "A dict containing values that were not serialized from Discord." +msgstr "" + +#: interactions.utils.attrs_utils.DictSerializerMixin.update:1 of msgid "" "Update an object with new attributes. All data will be converted, and any" " extra attributes will be put in _extras" msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:4 of +#: interactions.utils.attrs_utils.DictSerializerMixin.update:4 of msgid "The dictionary to update from" msgstr "" @@ -286,6 +324,18 @@ msgid "" " was sent from." msgstr "" +#: interactions.client.context.CommandContext:30 of +msgid "The client instance that the command belongs to." +msgstr "" + +#: interactions.client.context.CommandContext:31 of +msgid "The command object that is being invoked." +msgstr "" + +#: interactions.client.context.CommandContext:32 of +msgid "The extension the command belongs to." +msgstr "" + #: interactions.client.context.CommandContext.defer:1 of msgid "" "This \"defers\" an interaction response, allowing up to a 15-minute delay" @@ -342,3 +392,31 @@ msgstr "" #: interactions.client.context.ComponentContext.defer:6 of msgid "Whether you want to edit the original message or send a followup message" msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:1 of +msgid "Disables all components of the message." +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:3 of +msgid "" +"Whether the components should be disabled in an interaction response, " +"default True" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:5 of +msgid "" +"Additional keyword-arguments to pass to the edit method. This only works " +"when this method is used as interaction response and takes the same " +"arguments as :meth:`interactions.client.context._Context:edit()`" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:8 of +msgid "The modified Message" +msgstr "" + +#: interactions.client.context.ComponentContext.label:1 of +msgid "The label of the interacted button. :rtype: Optional[str]" +msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/events.po b/docs/locale/de/LC_MESSAGES/events.po index b91a1dc02..7b4ecba7d 100644 --- a/docs/locale/de/LC_MESSAGES/events.po +++ b/docs/locale/de/LC_MESSAGES/events.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../events.rst:2 msgid "Event Documentation" @@ -98,99 +98,104 @@ msgid "``on_command``" msgstr "" #: ../../events.rst:57 -msgid "``on_component``" +msgid "``on_command_error``" msgstr "" #: ../../events.rst:58 -msgid "``on_autocomplete``" +msgid "``on_component``" msgstr "" #: ../../events.rst:59 +msgid "``on_autocomplete``" +msgstr "" + +#: ../../events.rst:60 msgid "``on_modal``" msgstr "" -#: ../../events.rst:61 +#: ../../events.rst:62 msgid "Lets now have a look at those events in detail:" msgstr "" -#: ../../events.rst:64 +#: ../../events.rst:65 msgid "Event: ``raw_socket_create``" msgstr "" -#: ../../events.rst:65 +#: ../../events.rst:66 msgid "" "This event fires on any event sent by Discord, including ``Typing Start``" " and ``Voice State Update``. ``Hello``, ``Resumed``, ``Reconnect`` and " "``Invalid Session`` still will not be dispatched." msgstr "" -#: ../../events.rst:68 +#: ../../events.rst:69 msgid "" -"The function handling the event should take in one argument, the type of " -"this argument is a ``dict``." +"A function handling an event should take two arguments, the first " +"argument is the name of the event, the second is the data of that event " +"with type ``dict``." msgstr "" -#: ../../events.rst:70 +#: ../../events.rst:72 msgid "" -"The value of the argument will be the *raw* data sent from Discord, so it" -" is not recommended to use that event as long as you don't absolutely " -"need it." +"The value of the second argument will be the *raw* data sent from " +"Discord, so it is not recommended to use that event as long as you don't " +"absolutely need it." msgstr "" -#: ../../events.rst:75 +#: ../../events.rst:77 msgid "Event: ``on_start``" msgstr "" -#: ../../events.rst:76 +#: ../../events.rst:78 msgid "This event fires only when the bot is started." msgstr "" -#: ../../events.rst:78 ../../events.rst:161 +#: ../../events.rst:80 ../../events.rst:173 msgid "This function takes no arguments." msgstr "" -#: ../../events.rst:81 +#: ../../events.rst:83 msgid "Unlike ``on_ready``, this event will never be dispatched more than once." msgstr "" -#: ../../events.rst:84 +#: ../../events.rst:86 msgid "Event: ``on_interaction``" msgstr "" -#: ../../events.rst:85 +#: ../../events.rst:87 msgid "" "This event fires on any interaction (commands, components, autocomplete " "and modals)." msgstr "" -#: ../../events.rst:87 +#: ../../events.rst:89 msgid "" "The function needs one argument. It will have the type ``CommandContext``" " or ``ComponentContext``." msgstr "" -#: ../../events.rst:89 +#: ../../events.rst:91 msgid "" "Because you will have to check for everything, from the " "``InteractionType`` to any data inside the context, we do not recommend " "using this event unless you have experience with it." msgstr "" -#: ../../events.rst:94 +#: ../../events.rst:96 msgid "Event: ``on_command``" msgstr "" -#: ../../events.rst:95 +#: ../../events.rst:97 msgid "" "This event fires on any Application Command (slash command + context menu" " command) used." msgstr "" -#: ../../events.rst:97 ../../events.rst:117 ../../events.rst:127 +#: ../../events.rst:99 ../../events.rst:129 ../../events.rst:139 msgid "The function takes in one argument of the type ``CommandContext``." msgstr "" -#: ../../events.rst:99 +#: ../../events.rst:101 msgid "" "Using this event, you will have to manually check everything, from name " "to whether the used commands have sub commands, options or anything else " @@ -198,138 +203,174 @@ msgid "" "it" msgstr "" -#: ../../events.rst:104 +#: ../../events.rst:106 +msgid "Event: ``on_command_error``" +msgstr "" + +#: ../../events.rst:107 +msgid "This event fires when the following conditions are met:" +msgstr "" + +#: ../../events.rst:109 +msgid "There is an error in the command (or subcommand within the command)" +msgstr "" + +#: ../../events.rst:110 +msgid "There is no error callback assigned to that command" +msgstr "" + +#: ../../events.rst:112 +msgid "" +"The function takes in two arguments, one of the type ``CommandContext``, " +"and the other contains the error." +msgstr "" + +#: ../../events.rst:116 msgid "Event: ``on_component``" msgstr "" -#: ../../events.rst:105 +#: ../../events.rst:117 msgid "" "This event fires on any Component used (for now, those are Buttons and " "Select Menus)." msgstr "" -#: ../../events.rst:107 +#: ../../events.rst:119 msgid "The function takes in one argument of the type ``ComponentContext``." msgstr "" -#: ../../events.rst:109 +#: ../../events.rst:121 msgid "" "Like ``on_command``, you will have to manually check for everything, i.e " "for custom id and component type. Also, you will have to look through the" " argument to find the selected choices, if you have a select menu." msgstr "" -#: ../../events.rst:114 +#: ../../events.rst:126 msgid "Event: ``on_autocomplete``" msgstr "" -#: ../../events.rst:115 +#: ../../events.rst:127 msgid "This event fires on any autocomplete triggered." msgstr "" -#: ../../events.rst:119 +#: ../../events.rst:131 msgid "" "As already in the events above, you will have to get the important values" " yourself. Those values are here the autocompleted option and the user " "input." msgstr "" -#: ../../events.rst:124 +#: ../../events.rst:136 msgid "Event: ``on_modal``" msgstr "" -#: ../../events.rst:125 +#: ../../events.rst:137 msgid "This event fires on every modal that is submitted." msgstr "" -#: ../../events.rst:129 +#: ../../events.rst:141 msgid "" "You will have to get all values yourself and check what modal was used " "when using this event." msgstr "" -#: ../../events.rst:132 +#: ../../events.rst:144 msgid "" "Additionally, if you struggle with getting the values, you can check " ":ref:`how it is handled internally `." msgstr "" -#: ../../events.rst:136 +#: ../../events.rst:148 msgid "After this, let us look at events from the Discord API." msgstr "" -#: ../../events.rst:139 +#: ../../events.rst:151 msgid "Discord API Events" msgstr "" -#: ../../events.rst:141 +#: ../../events.rst:153 msgid "" "Events in this section do not match the name needed to put into the " "function. Please check :ref:`above ` for how to get the correct name." msgstr "" -#: ../../events.rst:145 +#: ../../events.rst:157 msgid "" "There are a lot of events dispatched by the Discord API. All of those can" " be found `here`_." msgstr "" -#: ../../events.rst:147 +#: ../../events.rst:159 msgid "" "The events ``HELLO``, ``RESUMED``, ``RECONNECT``, ``INVALID SESSION`` and" " ``TYPING START`` are not dispatched by the library." msgstr "" -#: ../../events.rst:149 +#: ../../events.rst:161 msgid "" "``TYPING START`` will be included in the raw socket create event. You can" " also listen for it if you choose to subclass the WebSocketClient" msgstr "" -#: ../../events.rst:152 +#: ../../events.rst:164 msgid "" "The event ``VOICE STATE UPDATE`` can be only received with the voice " ":ref:`Extension `." msgstr "" -#: ../../events.rst:155 +#: ../../events.rst:167 msgid "Let's now have a look at a few events:" msgstr "" -#: ../../events.rst:158 +#: ../../events.rst:170 msgid "Event: ``READY``" msgstr "" -#: ../../events.rst:159 +#: ../../events.rst:171 msgid "" "This event fires whenever ``READY`` is dispatched by Discord. This " "happens when connecting to the web socket server." msgstr "" -#: ../../events.rst:164 +#: ../../events.rst:176 msgid "" "Due to the bot reconnecting during runtime, ``on_ready`` will be " "dispatched multiple times. If you rely on ``on_ready`` to do certain " "things once, check against a global variable as shown below:" msgstr "" -#: ../../events.rst:181 +#: ../../events.rst:193 msgid "Events: ``GUILD MEMBER UPDATE`` and ``GUILD MEMBER ADD``" msgstr "" -#: ../../events.rst:182 +#: ../../events.rst:194 msgid "" "These events fire whenever a member joins a guild or a member of a guild " "gets modified." msgstr "" -#: ../../events.rst:184 +#: ../../events.rst:196 msgid "The function takes in one argument of the type ``GuildMember``." msgstr "" -#: ../../events.rst:186 +#: ../../events.rst:198 msgid "" "The argument has the same methods as a normal ``Member`` object, except " "the methods *do not take in a guild id*. Please keep that in mind when " "using this event." msgstr "" + +#~ msgid "" +#~ "The function handling the event should" +#~ " take in one argument, the type " +#~ "of this argument is a ``dict``." +#~ msgstr "" + +#~ msgid "" +#~ "The value of the argument will be" +#~ " the *raw* data sent from Discord," +#~ " so it is not recommended to " +#~ "use that event as long as you " +#~ "don't absolutely need it." +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/faq.po b/docs/locale/de/LC_MESSAGES/faq.po index 1bf421161..09e3ae8c9 100644 --- a/docs/locale/de/LC_MESSAGES/faq.po +++ b/docs/locale/de/LC_MESSAGES/faq.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../faq.rst:2 msgid "Frequently Asked Questions" @@ -283,12 +283,12 @@ msgstr "" #: ../../faq.rst:157 msgid "" -"A `voice client`_ - which is still WIP, but it is able to listen for the " +"`voice client`_ - which is still WIP, but it is able to listen for the " "``VOICE_STATE_UPDATE`` event." msgstr "" #: ../../faq.rst:158 -msgid "An `autosharder`_ for automatic sharding" +msgid "`autosharder`_ for automatic sharding" msgstr "" #: ../../faq.rst:159 @@ -310,146 +310,148 @@ msgid "`enhanced`_ which enhances the DX in general" msgstr "" #: ../../faq.rst:163 -msgid "A `paginator`_ for paginating embeds on messages using components" +msgid "`paginator`_ for paginating embeds on messages using components" msgstr "" #: ../../faq.rst:164 msgid "" -"`persistence`_ - for storing data inside your custom IDs (as an " -"alternative to ``wait_for``)" +"`persistence`_ for storing data inside your custom IDs (as an alternative" +" to ``wait_for``)" msgstr "" #: ../../faq.rst:165 -msgid "And a `boilerplate`_" +msgid "`lavalink`_ for voice sending and listening ``VOICE_STATE_UPDATE`` event" +msgstr "" + +#: ../../faq.rst:166 +msgid "`fastapi`_ for building own API" msgstr "" #: ../../faq.rst:167 +msgid "And a `boilerplate`_" +msgstr "" + +#: ../../faq.rst:169 msgid "" "Below are a few unofficial exts (for the time being) which implement some" " functionality similar to what d.py had:" msgstr "" -#: ../../faq.rst:169 +#: ../../faq.rst:171 msgid "`checks and cooldowns`_" msgstr "" -#: ../../faq.rst:170 +#: ../../faq.rst:172 msgid "`tasks`_" msgstr "" -#: ../../faq.rst:171 -msgid "" -"`get`_ for getting objects from the discord API (will be implemented into" -" the core library at a later time)" -msgstr "" - -#: ../../faq.rst:173 +#: ../../faq.rst:174 msgid "Usage examples can usually be found at the linked page" msgstr "" -#: ../../faq.rst:177 +#: ../../faq.rst:178 msgid "Can I make an Extension Library myself?" msgstr "" -#: ../../faq.rst:178 +#: ../../faq.rst:179 msgid "" "Yeah, you can! We have a special channel reserved for the development of " "external libraries! You can also read `this `_ for more information." msgstr "" -#: ../../faq.rst:183 +#: ../../faq.rst:184 msgid "" "I'm getting \"``AttributeError: HTTPClient not found!``\" when I try to " "execute helper methods!" msgstr "" -#: ../../faq.rst:184 +#: ../../faq.rst:185 msgid "Probably you are doing something like this:" msgstr "" -#: ../../faq.rst:191 +#: ../../faq.rst:192 msgid "" "And the error occurs in the line where you try to send something. You can" " fix this easy by adding one argument:" msgstr "" -#: ../../faq.rst:198 +#: ../../faq.rst:199 msgid "" "You have to add this extra argument for every object you instantiate by " "yourself if you want to use it's methods" msgstr "" -#: ../../faq.rst:202 +#: ../../faq.rst:203 msgid "" "Context and Messages don't have the ``Channel`` and ``Guild`` attributes!" " Why?" msgstr "" -#: ../../faq.rst:203 +#: ../../faq.rst:204 msgid "" "At the moment the Discord API does *not* include them into their " "responses. You can get those object via the ``get_channel()`` and " "``get_guild()`` methods of the Context and Message model." msgstr "" -#: ../../faq.rst:208 +#: ../../faq.rst:209 msgid "\"``ctx.send got an unexpected keyword argument: files``\"! Why?" msgstr "" -#: ../../faq.rst:209 +#: ../../faq.rst:210 msgid "" "It is not supported due to an decision of the core developer team. There " "are two ways to do it:" msgstr "" -#: ../../faq.rst:212 +#: ../../faq.rst:213 msgid "Using ``await channel.send`` instead" msgstr "" -#: ../../faq.rst:213 +#: ../../faq.rst:214 msgid "Using the `files`_ extension" msgstr "" -#: ../../faq.rst:217 +#: ../../faq.rst:218 msgid "\"``ctx.send got an unexpected keyword argument: embed``\"! Why?" msgstr "" -#: ../../faq.rst:218 +#: ../../faq.rst:219 msgid "" "This is quite simple: The argument ``embed`` got deprecated by Discord. " "The new naming is ``embeds``." msgstr "" -#: ../../faq.rst:222 +#: ../../faq.rst:223 msgid "How can I check what exception happened during a request?" msgstr "" -#: ../../faq.rst:223 +#: ../../faq.rst:224 msgid "We, unlike d.py, do not offer something like ``interactions.NotFound``." msgstr "" -#: ../../faq.rst:225 +#: ../../faq.rst:226 msgid "Instead you have to do it like this:" msgstr "" -#: ../../faq.rst:228 +#: ../../faq.rst:229 msgid "" "This feature will be implemented with version 4.3 and is currently only " "available on beta/unstable" msgstr "" -#: ../../faq.rst:242 +#: ../../faq.rst:243 msgid "" "You can additionally get the exact reason for why the exception occurred " "with ``e.message`` or ``e.lookup(e.code)``" msgstr "" -#: ../../faq.rst:246 +#: ../../faq.rst:247 msgid "My message content is always empty! How can I fix this?" msgstr "" -#: ../../faq.rst:247 +#: ../../faq.rst:248 msgid "" "This happens because you did not enable the intent for message content. " "Enable it on the developer portal and add it into the ``Client`` " @@ -459,11 +461,11 @@ msgid "" "``Intents.DEFAULT``, it can be any other intent(s) you need!" msgstr "" -#: ../../faq.rst:254 +#: ../../faq.rst:255 msgid "Is there something like ``Cogs``?" msgstr "" -#: ../../faq.rst:255 +#: ../../faq.rst:256 msgid "" "Yes! Although, we call them ``Extensions``. Yeah, like :ref:`Extension " "Libraries `. This is because an extension " @@ -471,39 +473,39 @@ msgid "" "how you create an extension for yourself:" msgstr "" -#: ../../faq.rst:283 +#: ../../faq.rst:284 msgid "It's nothing more than that." msgstr "" -#: ../../faq.rst:285 +#: ../../faq.rst:286 msgid "" "Since ``@bot.X`` decorators don't work in extensions, you have to use " "these:" msgstr "" -#: ../../faq.rst:287 +#: ../../faq.rst:288 msgid "For event listeners, use ``@interactions.extension_listener``" msgstr "" -#: ../../faq.rst:288 +#: ../../faq.rst:289 msgid "For component listeners, use ``@interactions.extension_component``" msgstr "" -#: ../../faq.rst:289 +#: ../../faq.rst:290 msgid "For modal listeners, use ``@interactions.extension_modal``" msgstr "" -#: ../../faq.rst:290 +#: ../../faq.rst:291 msgid "For autocomplete listeners, use ``@interactions.extension_autocomplete``" msgstr "" -#: ../../faq.rst:294 +#: ../../faq.rst:295 msgid "" "``channel.members`` does not exist, how do I get the people in a voice " "channel?" msgstr "" -#: ../../faq.rst:295 +#: ../../faq.rst:296 msgid "" "``channel.members`` actually does exist, but is reserved for threads. " "There is no attribute for people in a voice channel by the API. The only " @@ -512,12 +514,37 @@ msgid "" " updated when a member joins or leaves." msgstr "" -#: ../../faq.rst:301 +#: ../../faq.rst:302 msgid "My question is not answered on here!" msgstr "" -#: ../../faq.rst:302 +#: ../../faq.rst:303 msgid "" "Please join our `Discord Server`_ for any further support regarding our " "library and/or any integration code depending on it." msgstr "" + +#~ msgid "" +#~ "A `voice client`_ - which is still" +#~ " WIP, but it is able to listen" +#~ " for the ``VOICE_STATE_UPDATE`` event." +#~ msgstr "" + +#~ msgid "An `autosharder`_ for automatic sharding" +#~ msgstr "" + +#~ msgid "A `paginator`_ for paginating embeds on messages using components" +#~ msgstr "" + +#~ msgid "" +#~ "`persistence`_ - for storing data inside" +#~ " your custom IDs (as an alternative" +#~ " to ``wait_for``)" +#~ msgstr "" + +#~ msgid "" +#~ "`get`_ for getting objects from the " +#~ "discord API (will be implemented into" +#~ " the core library at a later " +#~ "time)" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/index.po b/docs/locale/de/LC_MESSAGES/index.po index 91465f9df..d7a1d6841 100644 --- a/docs/locale/de/LC_MESSAGES/index.po +++ b/docs/locale/de/LC_MESSAGES/index.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../index.rst:47 msgid "Pages:" @@ -51,7 +51,7 @@ msgstr "" #: ../../index.rst:11 msgid "" "Look no more! The goal of this library is to make all three of these " -"questions go from possibilites to trivial matters." +"questions go from possibilities to trivial matters." msgstr "" #: ../../index.rst:14 @@ -181,7 +181,7 @@ msgid "**black** ``22.6.0``" msgstr "" #: ../../index.rst:66 -msgid "**flake8** ``4.0.1``" +msgid "**flake8** ``5.0.4``" msgstr "" #: ../../index.rst:67 @@ -190,7 +190,7 @@ msgstr "" #: ../../index.rst:69 msgid "" -"**Sphinx** ``4.4.0``: all of our documentation is powered off of " +"**Sphinx** ``5.1.1``: all of our documentation is powered off of " "autogenerated documentation of the Sphinx engine." msgstr "" @@ -247,3 +247,20 @@ msgstr "" #: ../../index.rst:88 msgid ":ref:`modindex`" msgstr "" + +#~ msgid "" +#~ "Look no more! The goal of this " +#~ "library is to make all three of" +#~ " these questions go from possibilites " +#~ "to trivial matters." +#~ msgstr "" + +#~ msgid "**flake8** ``4.0.1``" +#~ msgstr "" + +#~ msgid "" +#~ "**Sphinx** ``4.4.0``: all of our " +#~ "documentation is powered off of " +#~ "autogenerated documentation of the Sphinx " +#~ "engine." +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/migration.po b/docs/locale/de/LC_MESSAGES/migration.po index 9f0d8e6aa..3546c747d 100644 --- a/docs/locale/de/LC_MESSAGES/migration.po +++ b/docs/locale/de/LC_MESSAGES/migration.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../migration.rst:2 msgid "Migration" @@ -126,7 +126,9 @@ msgid "" msgstr "" #: ../../migration.rst:99 -msgid "You can get more information by reading the `get-documentation`_." +msgid "" +"You can get more information by reading the " +":meth:`interactions.client.get.get`-documentation" msgstr "" #: ../../migration.rst:102 @@ -148,3 +150,6 @@ msgid "" "your argument in your function differently than your option name! " "Example:" msgstr "" + +#~ msgid "You can get more information by reading the `get-documentation`_." +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/models.command.po b/docs/locale/de/LC_MESSAGES/models.command.po index 5c72da5b0..a7fca335f 100644 --- a/docs/locale/de/LC_MESSAGES/models.command.po +++ b/docs/locale/de/LC_MESSAGES/models.command.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.command.rst:4 msgid "Application Command Models" @@ -37,8 +37,10 @@ msgid "The structure for a choice:" msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission of msgid "Variables" @@ -56,13 +58,14 @@ msgstr "" #: interactions.client.models.command.Command:16 #: interactions.client.models.command.Command.group:28 #: interactions.client.models.command.Command.subcommand:33 -#: interactions.client.models.command.Option:34 of +#: interactions.client.models.command.Option:36 of msgid "" "The dictionary of localization for the ``name`` field. This enforces the " "same restrictions as the ``name`` field." msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command #: interactions.client.models.command.Command.__call @@ -72,6 +75,7 @@ msgstr "" #: interactions.client.models.command.Command.error #: interactions.client.models.command.Command.group #: interactions.client.models.command.Command.subcommand +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission #: interactions.client.models.command.option of @@ -100,8 +104,7 @@ msgstr "" msgid "The type of option." msgstr "" -#: interactions.client.models.command.Option:23 -#: interactions.client.models.command.option:14 of +#: interactions.client.models.command.Option:23 of msgid "The name of the option." msgstr "" @@ -142,19 +145,27 @@ msgid "The maximum value supported by the option." msgstr "" #: interactions.client.models.command.Option:33 of +msgid "The minimum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:34 of +msgid "The maximum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:35 of msgid "A status denoting whether this option is an autocomplete option." msgstr "" #: interactions.client.models.command.Command:17 #: interactions.client.models.command.Command.group:30 #: interactions.client.models.command.Command.subcommand:35 -#: interactions.client.models.command.Option:35 of +#: interactions.client.models.command.Option:37 of msgid "" "The dictionary of localization for the ``description`` field. This " "enforces the same restrictions as the ``description`` field." msgstr "" -#: interactions.client.models.command.Option:36 of +#: interactions.client.models.command.Option:38 of msgid "How the option value is passed to the function, if different than ``name``" msgstr "" @@ -248,18 +259,26 @@ msgid "A decorator for adding options to a command." msgstr "" #: interactions.client.models.command.option:3 of -msgid "The structure of an option:" +msgid "" +"The ``type`` and ``name`` of the option are defaulted to the parameter's " +"typehint and name." +msgstr "" + +#: interactions.client.models.command.option:5 of +msgid "" +"When the ``name`` of the option differs from the parameter name, the " +"``converter`` field will default to the name of the parameter." msgstr "" -#: interactions.client.models.command.option:12 of -msgid "The type of the option." +#: interactions.client.models.command.option:8 of +msgid "The structure of an option:" msgstr "" -#: interactions.client.models.command.option:16 of -msgid "The description of the option. Defaults to ``\"No description set\"``." +#: interactions.client.models.command.option:17 of +msgid "The description of the option. Defaults to \"No description set\"." msgstr "" -#: interactions.client.models.command.option:18 of +#: interactions.client.models.command.option:19 of msgid "The keyword arguments of the option, same as :class:`Option`." msgstr "" @@ -283,6 +302,8 @@ msgstr "" msgid "A class that when returned from a command, the command chain is stopped." msgstr "" +#: interactions.client.models.command.BaseResult:3 +#: interactions.client.models.command.GroupResult:3 #: interactions.client.models.command.StopCommand:3 of msgid "Usage:" msgstr "" @@ -291,6 +312,32 @@ msgstr "" msgid "This allows for custom checks that allow stopping the command chain." msgstr "" +#: interactions.client.models.command.BaseResult:1 +#: interactions.client.models.command.GroupResult:1 of +msgid "A class object representing the result of the base command." +msgstr "" + +#: interactions.client.models.command.BaseResult:17 of +msgid "" +"If the subcommand coroutine does not have enough parameters, the " +"``BaseResult`` will not be passed." +msgstr "" + +#: interactions.client.models.command.BaseResult:19 +#: interactions.client.models.command.GroupResult:25 of +msgid "The result of the base command." +msgstr "" + +#: interactions.client.models.command.GroupResult:23 of +msgid "" +"If the subcommand does not have enough arguments, the ``GroupResult`` " +"will not be passed." +msgstr "" + +#: interactions.client.models.command.GroupResult:26 of +msgid "The parent ``BaseResult``." +msgstr "" + #: interactions.client.models.command.Command:1 of msgid "A class object representing a command." msgstr "" @@ -364,6 +411,14 @@ msgstr "" msgid "The extension that the command belongs to, if any." msgstr "" +#: interactions.client.models.command.Command:26 of +msgid "The client that the command belongs to." +msgstr "" + +#: interactions.client.models.command.Command:27 of +msgid "The listener, used for dispatching command errors." +msgstr "" + #: interactions.client.models.command.Command.converters:1 of msgid "" "Returns a dictionary with all converters added to the options of the " @@ -525,3 +580,9 @@ msgid "" ":class:`interactions.client.bot.Extension` is passed to the coroutine, if" " any." msgstr "" + +#~ msgid "The type of the option." +#~ msgstr "" + +#~ msgid "The description of the option. Defaults to ``\"No description set\"``." +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/models.component.po b/docs/locale/de/LC_MESSAGES/models.component.po index ae186054c..ce3834826 100644 --- a/docs/locale/de/LC_MESSAGES/models.component.po +++ b/docs/locale/de/LC_MESSAGES/models.component.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.component.rst:4 msgid "Component Models" @@ -257,36 +257,18 @@ msgid "The maximum length of the input." msgstr "" #: interactions.client.models.component.Modal:1 of -msgid "A class object representing a modal." +msgid "A class object representing a modal. The structure for a modal: ::" msgstr "" -#: interactions.client.models.component.Modal:8 of -msgid "The structure for a modal: ::" -msgstr "" - -#: interactions.client.models.component.Modal:6 of -msgid "interactions.Modal(" -msgstr "" - -#: interactions.client.models.component.Modal:5 of -msgid "" -"title=\"Application Form\", custom_id=\"mod_app_form\", " -"components=[interactions.TextInput(...)]," -msgstr "" - -#: interactions.client.models.component.Modal:8 of -msgid ")" -msgstr "" - -#: interactions.client.models.component.Modal:10 of +#: interactions.client.models.component.Modal:9 of msgid "The custom ID of the modal." msgstr "" -#: interactions.client.models.component.Modal:11 of +#: interactions.client.models.component.Modal:10 of msgid "The title of the modal." msgstr "" -#: interactions.client.models.component.Modal:12 of +#: interactions.client.models.component.Modal:11 of msgid "The components of the modal." msgstr "" @@ -302,22 +284,22 @@ msgid "" " also support only 1 text input component only." msgstr "" -#: interactions.client.models.component.ActionRow:13 of -msgid "The structure for an action row: ::" +#: interactions.client.models.component.ActionRow:8 of +msgid "The structure for an action row: ..code-block:: python" msgstr "" -#: interactions.client.models.component.ActionRow:9 of +#: interactions.client.models.component.ActionRow:10 of msgid "" "# \"...\" represents a component object. # Method 1: " "interactions.ActionRow(...) # Method 2: " "interactions.ActionRow(components=[...])" msgstr "" -#: interactions.client.models.component.ActionRow:15 of +#: interactions.client.models.component.ActionRow:16 of msgid "The type of component. Always defaults to ``1``." msgstr "" -#: interactions.client.models.component.ActionRow:16 of +#: interactions.client.models.component.ActionRow:17 of msgid "A list of components the ActionRow has, if any." msgstr "" @@ -340,3 +322,23 @@ msgstr "" #: interactions.client.models.component.ActionRow.new of msgid "Return type" msgstr "" + +#~ msgid "A class object representing a modal." +#~ msgstr "" + +#~ msgid "The structure for a modal: ::" +#~ msgstr "" + +#~ msgid "interactions.Modal(" +#~ msgstr "" + +#~ msgid "" +#~ "title=\"Application Form\", custom_id=\"mod_app_form\"," +#~ " components=[interactions.TextInput(...)]," +#~ msgstr "" + +#~ msgid ")" +#~ msgstr "" + +#~ msgid "The structure for an action row: ::" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/models.misc.po b/docs/locale/de/LC_MESSAGES/models.misc.po index 9ea8f4346..31ef0b3e5 100644 --- a/docs/locale/de/LC_MESSAGES/models.misc.po +++ b/docs/locale/de/LC_MESSAGES/models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.misc.rst:4 msgid "Miscellaneous Models" @@ -56,12 +56,6 @@ msgstr "" msgid "The resolved attachments data." msgstr "" -#: interactions.client.models.misc.Interaction -#: interactions.client.models.misc.InteractionData -#: interactions.client.models.misc.InteractionResolvedData of -msgid "Parameters" -msgstr "" - #: interactions.client.models.misc.InteractionData:1 of msgid "A class object representing the data of an interaction." msgstr "" @@ -102,6 +96,10 @@ msgstr "" msgid "The targeted ID of the interaction." msgstr "" +#: interactions.client.models.misc.InteractionData:12 of +msgid "Array of Action Rows in modal." +msgstr "" + #: interactions.client.models.misc.Interaction:1 of msgid "A class object representing an interaction." msgstr "" @@ -149,3 +147,6 @@ msgstr "" #: interactions.client.models.misc.Interaction:13 of msgid "The message of the interaction." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/quickstart.po b/docs/locale/de/LC_MESSAGES/quickstart.po index 89ed78f26..76b3670dc 100644 --- a/docs/locale/de/LC_MESSAGES/quickstart.po +++ b/docs/locale/de/LC_MESSAGES/quickstart.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:08-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../quickstart.rst:2 msgid "Quickstart" @@ -28,10 +28,11 @@ msgstr "" #: ../../quickstart.rst:7 msgid "" -"**discord-interactions** is a :ref:`Python library ` for the Discord Application Programming Interface. (API) A" -" library in Python has to be installed through the `pip` file. Run this " -"in your terminal/command line in order to install our library:" +"**discord-interactions** is a :ref:`Python library " +"` for the Discord Application Programming " +"Interface. (API) A library in Python has to be installed through the " +"`pip` file. Run this in your terminal/command line in order to install " +"our library:" msgstr "" #: ../../quickstart.rst:11 @@ -308,109 +309,116 @@ msgid "" msgstr "" #: ../../quickstart.rst:208 -msgid "" -"The first field in the ``@option()`` decorator is the type of the option." -" This is positional only and required. You can use integers, the default " -"Python types, the ``OptionType`` enum, or supported objects such as " -"``interactions.Channel``." +msgid "All arguments in the decorator are keyword arguments only." msgstr "" #: ../../quickstart.rst:209 -msgid "All other arguments in the decorator are keyword arguments only." +msgid "" +"The ``type`` and ``name`` fields default to the typehint and the name of " +"the parameter." msgstr "" #: ../../quickstart.rst:210 -msgid "The ``name`` field is required." +msgid "" +"The ``description`` field is optional and defaults to ``\"No description " +"set``." msgstr "" #: ../../quickstart.rst:211 msgid "" -"The ``description`` field is optional and defaults to ``\"No description " -"set``." +"The ``required`` field defaults to whether the default for the parameter " +"is empty." msgstr "" #: ../../quickstart.rst:212 msgid "" +"For typehinting or inputting the ``type`` field, you can use integers, " +"the default Python types, the ``OptionType`` enum, or supported objects " +"such as ``interactions.Channel``." +msgstr "" + +#: ../../quickstart.rst:213 +msgid "" "Any parameters from ``Option`` can be passed into the ``@option()`` " "decorator." msgstr "" -#: ../../quickstart.rst:215 +#: ../../quickstart.rst:216 msgid "The limit for options per command is 25." msgstr "" -#: ../../quickstart.rst:218 +#: ../../quickstart.rst:219 msgid "Nested commands: subcommands" msgstr "" -#: ../../quickstart.rst:220 +#: ../../quickstart.rst:221 msgid "" "Subcommands are options that are nested to create subcategories of " "commands." msgstr "" -#: ../../quickstart.rst:222 +#: ../../quickstart.rst:223 msgid "Here is the structure of a subcommand:" msgstr "" -#: ../../quickstart.rst:265 +#: ../../quickstart.rst:266 msgid "You can also create subcommands using the command system:" msgstr "" -#: ../../quickstart.rst:291 +#: ../../quickstart.rst:292 msgid "You can add a SUB_COMMAND_GROUP in between the base and command." msgstr "" -#: ../../quickstart.rst:294 +#: ../../quickstart.rst:295 msgid "Additional information about subcommands" msgstr "" -#: ../../quickstart.rst:296 +#: ../../quickstart.rst:297 msgid "" "Base commands are returned the :ref:`Command ` object. From this, you can utilize the following " "decorators:" msgstr "" -#: ../../quickstart.rst:299 +#: ../../quickstart.rst:300 msgid "" ":ref:`@subcommand() `: creates" " a subcommand." msgstr "" -#: ../../quickstart.rst:300 +#: ../../quickstart.rst:301 msgid "" ":ref:`@group() `: creates a " "group." msgstr "" -#: ../../quickstart.rst:301 +#: ../../quickstart.rst:302 msgid "" ":ref:`@error `: registers an " "error callback." msgstr "" -#: ../../quickstart.rst:303 +#: ../../quickstart.rst:304 msgid "Check the documentation for the parameters of each of these decorators." msgstr "" -#: ../../quickstart.rst:305 +#: ../../quickstart.rst:306 msgid "The following is an example of a base command:" msgstr "" -#: ../../quickstart.rst:313 +#: ../../quickstart.rst:314 msgid "The examples below will be using the base command above." msgstr "" -#: ../../quickstart.rst:315 +#: ../../quickstart.rst:316 msgid "The following is an example of a subcommand of the base command:" msgstr "" -#: ../../quickstart.rst:323 +#: ../../quickstart.rst:324 msgid "This code results in the following subcommand: `/base_command subcommand`." msgstr "" -#: ../../quickstart.rst:326 +#: ../../quickstart.rst:327 msgid "" "You can use the ``base_res`` parameter in groups and subcommands, and " "``group_res`` in subcommands inside groups to access the result of the " @@ -418,50 +426,50 @@ msgid "" "``ctx`` parameter." msgstr "" -#: ../../quickstart.rst:329 +#: ../../quickstart.rst:330 msgid "The following is an example of a group with subcommands:" msgstr "" -#: ../../quickstart.rst:341 +#: ../../quickstart.rst:342 msgid "" "You can have multiple groups, with multiple subcommands in each group. " "Subcommands and groups are options, so the same restrictions apply." msgstr "" -#: ../../quickstart.rst:344 +#: ../../quickstart.rst:345 msgid "Create any subcommands without groups *before* creating any groups." msgstr "" -#: ../../quickstart.rst:346 +#: ../../quickstart.rst:347 msgid "" "Since there are multiple coroutines involved that each get executed, you " "may be wondering how you can stop the chain. Luckily, there is a way:" msgstr "" -#: ../../quickstart.rst:360 +#: ../../quickstart.rst:361 msgid "This works on both groups and subcommands." msgstr "" -#: ../../quickstart.rst:362 +#: ../../quickstart.rst:363 msgid "The following is an example of an error callback:" msgstr "" -#: ../../quickstart.rst:378 +#: ../../quickstart.rst:379 msgid "" "The parameters ``ctx`` and ``error`` are required, but you can have more " "parameters, such as ``*args`` and ``**kwargs``, if you need to access " "options." msgstr "" -#: ../../quickstart.rst:382 +#: ../../quickstart.rst:383 msgid "You can have one error callback per command." msgstr "" -#: ../../quickstart.rst:385 +#: ../../quickstart.rst:386 msgid "Special type of commands: Context menus" msgstr "" -#: ../../quickstart.rst:387 +#: ../../quickstart.rst:388 msgid "" "While, granted that application commands are way more intuitive and " "easier to work with as both a bot developer and user from a UX approach, " @@ -472,39 +480,39 @@ msgid "" " right-click actions with menial effort." msgstr "" -#: ../../quickstart.rst:393 +#: ../../quickstart.rst:394 msgid "" "In order to create a menu-based command, all you need to do is simply add" " this one line into your ``@command`` decorator:" msgstr "" -#: ../../quickstart.rst:406 +#: ../../quickstart.rst:407 msgid "Here is an alternate way of creating a context menu:" msgstr "" -#: ../../quickstart.rst:415 +#: ../../quickstart.rst:416 msgid "" "The structure of a menu command differs significantly from that of a " "regular one:" msgstr "" -#: ../../quickstart.rst:417 +#: ../../quickstart.rst:418 msgid "You cannot have any options or choices." msgstr "" -#: ../../quickstart.rst:418 +#: ../../quickstart.rst:419 msgid "You cannot have a description." msgstr "" -#: ../../quickstart.rst:419 +#: ../../quickstart.rst:420 msgid "The ``name`` filter follows a different regex pattern." msgstr "" -#: ../../quickstart.rst:422 +#: ../../quickstart.rst:423 msgid "Creating and sending Components" msgstr "" -#: ../../quickstart.rst:424 +#: ../../quickstart.rst:425 msgid "" "Being able to run your own commands is very useful for a lot of " "automation-related purposes as a bot developer, however, we also have " @@ -513,14 +521,14 @@ msgid "" "components." msgstr "" -#: ../../quickstart.rst:429 +#: ../../quickstart.rst:430 msgid "" "Components are ways of being able to select pre-defined data, or define " "your own. They're very simple but quite powerful when put into practice " "This code block below shows a simplified implementation of a component:" msgstr "" -#: ../../quickstart.rst:455 +#: ../../quickstart.rst:456 msgid "" "This is a design that we ended up choosing to simplify responding to " "buttons when someone presses on one, and to allow bot developers to plug " @@ -530,11 +538,11 @@ msgid "" "modularity." msgstr "" -#: ../../quickstart.rst:462 +#: ../../quickstart.rst:463 msgid "What kinds of components are there?" msgstr "" -#: ../../quickstart.rst:464 +#: ../../quickstart.rst:465 msgid "" "As a bot developer, this may be fairly important for you to want to know." " Different components provide difference user experiences, interactions " @@ -543,18 +551,18 @@ msgid "" "able to `find these component types`_ here." msgstr "" -#: ../../quickstart.rst:471 +#: ../../quickstart.rst:472 msgid "How do I send components in a row?" msgstr "" -#: ../../quickstart.rst:473 +#: ../../quickstart.rst:474 msgid "" "You are also able to organize these components into rows, which are " "defined as ``ActionRow``'s. It is worth noting that you can have only a " "maximum of 5 per message that you send. This code block below shows how:" msgstr "" -#: ../../quickstart.rst:505 +#: ../../quickstart.rst:506 msgid "" "By default, the ``components`` keyword-argument field in the context " "sending method will always support ``ActionRow``-less sending: you only " @@ -563,57 +571,57 @@ msgid "" "class objects instead." msgstr "" -#: ../../quickstart.rst:511 +#: ../../quickstart.rst:512 msgid "" "You cannot use ``TextInput`` with the above shown method. Look :ref:`here" " ` how to create and send them." msgstr "" -#: ../../quickstart.rst:516 +#: ../../quickstart.rst:517 msgid "Creating a TextInput" msgstr "" -#: ../../quickstart.rst:517 +#: ../../quickstart.rst:518 msgid "You want to get a Text from a user? You can use ``TextInput`` for that." msgstr "" -#: ../../quickstart.rst:529 +#: ../../quickstart.rst:530 msgid "" "But how to send it? You can't use ``ctx.send`` for it. Take a look at " ":ref:`Modals ` for that." msgstr "" -#: ../../quickstart.rst:533 +#: ../../quickstart.rst:534 msgid "Modals" msgstr "" -#: ../../quickstart.rst:534 +#: ../../quickstart.rst:535 msgid "" "Modals are a new way to interact with a user. Currently only a " "``TextInput`` component is supported. You can have up to five " "``TextInput`` in a Modal." msgstr "" -#: ../../quickstart.rst:547 +#: ../../quickstart.rst:548 msgid "with the ``TextInput`` example from above we get:" msgstr "" -#: ../../quickstart.rst:552 +#: ../../quickstart.rst:553 msgid "Responding to a Modal interaction" msgstr "" -#: ../../quickstart.rst:560 +#: ../../quickstart.rst:561 msgid "" "You can respond to a modal the same way as you would respond to a normal " "``chat-input`` command, except your function has an extra argument for " "the text what was put into the modal." msgstr "" -#: ../../quickstart.rst:563 +#: ../../quickstart.rst:564 msgid "Adding v2 Permissions" msgstr "" -#: ../../quickstart.rst:565 +#: ../../quickstart.rst:566 msgid "" "v2 permissions consist of the ``default_member_permissions`` and " "``dm_permission`` keyword arguments. Similar to adding privileged " @@ -621,55 +629,87 @@ msgid "" "etc.) as follows:" msgstr "" -#: ../../quickstart.rst:604 +#: ../../quickstart.rst:605 msgid "" "Adding guild-only commands is easier as the only thing it takes is a " "boolean. Here's an example of a guild-only command:" msgstr "" -#: ../../quickstart.rst:623 +#: ../../quickstart.rst:624 msgid "" "Likewise, setting ``dm_permission`` to ``True`` makes it usable in DMs. " "Just to note that this argument's mainly used for global commands. Guild " "commands with this argument will have no effect." msgstr "" -#: ../../quickstart.rst:627 +#: ../../quickstart.rst:628 msgid "Utilities" msgstr "" -#: ../../quickstart.rst:629 +#: ../../quickstart.rst:630 msgid "You can use the following utilities to help you with your commands:" msgstr "" -#: ../../quickstart.rst:631 +#: ../../quickstart.rst:632 msgid "``ActionRow.new()``: Creates a new ``ActionRow`` object." msgstr "" -#: ../../quickstart.rst:632 +#: ../../quickstart.rst:633 msgid "``spread_to_rows()``: Spreads a list of components into a list of rows." msgstr "" -#: ../../quickstart.rst:633 +#: ../../quickstart.rst:634 msgid "" "``@autodefer()``: Automatically defers a command if it did not respond " "within the specified time." msgstr "" -#: ../../quickstart.rst:635 +#: ../../quickstart.rst:636 msgid "" -"Look at their documentation :ref:`here ` for " -"more information." +"Look at their documentation :ref:`here ` for more " +"information." msgstr "" -#: ../../quickstart.rst:637 +#: ../../quickstart.rst:638 msgid "Usage of ``ActionRow.new()``:" msgstr "" -#: ../../quickstart.rst:653 +#: ../../quickstart.rst:654 msgid "Usage of ``spread_to_rows()``:" msgstr "" -#: ../../quickstart.rst:675 +#: ../../quickstart.rst:676 msgid "Usage of ``@autodefer()``:" msgstr "" + +#~ msgid "" +#~ "**discord-interactions** is a :ref:`Python " +#~ "library ` for the" +#~ " Discord Application Programming Interface. " +#~ "(API) A library in Python has to" +#~ " be installed through the `pip` file." +#~ " Run this in your terminal/command " +#~ "line in order to install our " +#~ "library:" +#~ msgstr "" + +#~ msgid "" +#~ "The first field in the ``@option()`` " +#~ "decorator is the type of the " +#~ "option. This is positional only and " +#~ "required. You can use integers, the " +#~ "default Python types, the ``OptionType`` " +#~ "enum, or supported objects such as " +#~ "``interactions.Channel``." +#~ msgstr "" + +#~ msgid "All other arguments in the decorator are keyword arguments only." +#~ msgstr "" + +#~ msgid "The ``name`` field is required." +#~ msgstr "" + +#~ msgid "" +#~ "Look at their documentation :ref:`here " +#~ "` for more information." +#~ msgstr "" diff --git a/docs/locale/de/LC_MESSAGES/utils.po b/docs/locale/de/LC_MESSAGES/utils.po new file mode 100644 index 000000000..2968b6970 --- /dev/null +++ b/docs/locale/de/LC_MESSAGES/utils.po @@ -0,0 +1,361 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../utils.rst:4 +msgid "The ``get`` utility method" +msgstr "" + +#: interactions.utils.get.get:1 of +msgid "Helper method to get an object." +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "This method can do the following:" +msgstr "" + +#: interactions.utils.get.get:6 of +msgid "Get a list of specific objects" +msgstr "" + +#: interactions.utils.get.get:5 interactions.utils.get.get:9 of +msgid "purely from cache" +msgstr "" + +#: interactions.utils.get.get:6 interactions.utils.get.get:10 of +msgid "purely from HTTP" +msgstr "" + +#: interactions.utils.get.get:7 of +msgid "" +"from cache and additionally from HTTP for every ID that was not found in " +"cache" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "Get a single specific object" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "from HTTP if not found in cache else from cache" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "The method has to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "You don't force anything" +msgstr "" + +#: interactions.utils.get.get:15 of +msgid "You force HTTP" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "The method doesn't have to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "You force cache" +msgstr "" + +#: interactions.utils.get.get:20 of +msgid "" +"Technically, there is no need for an ``await`` if there is an object " +"found in the cache. Because of the fact, that, as long as you don't " +"enforce the cache, the function will get the object from HTTP, if it is " +"not in the cache, you still have to await it. This has been done to " +"reduce confusion on whether the object origins from an HTTP call or a " +"cache result and to remove the extra step for you to check if the " +"returned object is an awaitable or not." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing:" +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing can be done via the ``force`` keyword argument." +msgstr "" + +#: interactions.utils.get.get:31 of +msgid "``force=\"cache\"`` or ``force=interactions.Force.CACHE``:" +msgstr "" + +#: interactions.utils.get.get:30 of +msgid "" +"This forces the method to only return from cache (if the object is not " +"found it will return ``None``). If you use this, you don't need to await " +"the method." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "``force=\"http\"`` or ``force=interactions.Force.HTTP``:" +msgstr "" + +#: interactions.utils.get.get:34 of +msgid "" +"This forces the method to make an HTTP request to the discord API and " +"return the result of it. If you use this, you have to await the method." +msgstr "" + +#: interactions.utils.get.get:38 of +msgid "" +"If you are a PyCharm user, please be aware of a bug that causes incorrect" +" suggestions to appear if using an enum. Even if PyCharm shows a normal " +"object as result, you have to await the method if you enforce HTTP. To " +"prevent this bug from happening it is suggested using ``force=\"http\"`` " +"instead of the enum." +msgstr "" + +#: interactions.utils.get.get:43 of +msgid "Getting an object:" +msgstr "" + +#: interactions.utils.get.get:45 of +msgid "" +"Here you will see two examples on how to get a single objects and the " +"variations of how the object can be gotten." +msgstr "" + +#: interactions.utils.get.get:48 of +msgid "Example 1/2: Getting a Channel:" +msgstr "" + +#: interactions.utils.get.get:65 of +msgid "Example 2/2: Getting a Member:" +msgstr "" + +#: interactions.utils.get.get:88 of +msgid "" +"Both examples should have given you a basic overview on how to get a " +"single object. Now we will move on with lists of objects." +msgstr "" + +#: interactions.utils.get.get:92 of +msgid "" +"The ``parent_id`` represents the channel or guild id that belongs to the " +"objects you want to get. It is called ``parent_id`` because " +"``guild_or_channel_id`` would be horrible to type out every time." +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "Getting a list of an object:" +msgstr "" + +#: interactions.utils.get.get:96 of +msgid "" +"Here you will see 1 example of how to get a list of objects. The " +"possibilities on how to force (and their results) are the same as in the " +"examples above." +msgstr "" + +#: interactions.utils.get.get:99 of +msgid "Example 1/1: Getting a list of members:" +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "" +"If you enforce cache when getting a list of objects, found objets will be" +" placed into the list and not found objects will be placed as ``None`` " +"into the list." +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Parameters" +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Return type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "An enumerable object representing the force types for the get method." +msgstr "" + +#: interactions.utils.get.Force of +msgid "Variables" +msgstr "" + +#: interactions.utils.get.Force:3 of +msgid "Enforce the usage of cache and block the usage of http" +msgstr "" + +#: interactions.utils.get.Force:4 of +msgid "Enforce the usage of http and block the usage of cache" +msgstr "" + +#: interactions.utils.get.Force of +msgid "Member Type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: ../../utils.rst:10 +msgid "Utilities" +msgstr "" + +#: interactions.utils.utils.autodefer:1 of +msgid "" +"A decorator that automatically defers a command if it did not respond " +"within ``delay`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:3 of +msgid "The structure of the decorator is:" +msgstr "" + +#: interactions.utils.utils.autodefer:13 of +msgid "" +"The amount of time in seconds to wait before defering the command. " +"Defaults to ``2`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:15 of +msgid "Whether the command is deferred ephemerally. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer:17 of +msgid "Whether the command is deferred on origin. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable of +msgid "Returns" +msgstr "" + +#: interactions.utils.utils.autodefer:19 of +msgid "The inner function, for decorating." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:1 of +msgid "A helper function that spreads components into :class:`ActionRow` s." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:3 of +msgid "Example:" +msgstr "" + +#: interactions.utils.utils.spread_to_rows:24 of +msgid "" +"You can only pass in :class:`ActionRow`s, :class:`Button`s, and " +":class:`SelectMenu`s, but in any order." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:26 of +msgid "The components to spread." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:28 of +msgid "The maximum number of components in a single row. Defaults to ``5``." +msgstr "" + +#: interactions.utils.utils.search_iterable:1 of +msgid "" +"Searches through an iterable for items that: - Are True for the check, if" +" one is given - Have attributes that match the keyword arguments (e.x. " +"passing `id=your_id` will only return objects with that id)" +msgstr "" + +#: interactions.utils.utils.search_iterable:5 of +msgid "The iterable to search through" +msgstr "" + +#: interactions.utils.utils.search_iterable:7 of +msgid "The check that items will be checked against" +msgstr "" + +#: interactions.utils.utils.search_iterable:9 of +msgid "Any attributes the items should have" +msgstr "" + +#: interactions.utils.utils.search_iterable:11 of +msgid "All items that match the check and keywords" +msgstr "" + +#: interactions.utils.utils.disable_components:1 of +msgid "Disables the given components." +msgstr "" + +#: interactions.utils.utils.disable_components:3 of +msgid "The components to disable" +msgstr "" + +#: interactions.utils.utils.get_channel_history:1 of +msgid "Gets the history of a channel." +msgstr "" + +#: interactions.utils.utils.get_channel_history:3 of +msgid "The HTTPClient of the bot or your bot instance" +msgstr "" + +#: interactions.utils.utils.get_channel_history:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:7 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:9 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.utils.utils.get_channel_history:11 of +msgid "A check to ignore specific messages" +msgstr "" + +#: interactions.utils.utils.get_channel_history:13 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.utils.utils.get_channel_history:16 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.dispatch.po b/docs/locale/es/LC_MESSAGES/api.dispatch.po index 2b020e27a..18a4ff864 100644 --- a/docs/locale/es/LC_MESSAGES/api.dispatch.po +++ b/docs/locale/es/LC_MESSAGES/api.dispatch.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.dispatch.rst:4 msgid "Dispatching" @@ -38,12 +38,6 @@ msgstr "" msgid "A list of events being dispatched." msgstr "" -#: interactions.api.dispatch.Listener -#: interactions.api.dispatch.Listener.dispatch -#: interactions.api.dispatch.Listener.register of -msgid "Return type" -msgstr "" - #: interactions.api.dispatch.Listener.dispatch:1 of msgid "Dispatches an event given out by the gateway." msgstr "" @@ -83,3 +77,6 @@ msgstr "" #: interactions.api.dispatch.Listener.register:9 of msgid "The name to associate the coroutine with. Defaults to None." msgstr "" + +#~ msgid "Return type" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.gateway.po b/docs/locale/es/LC_MESSAGES/api.gateway.po index aad9d8772..22e00a8ed 100644 --- a/docs/locale/es/LC_MESSAGES/api.gateway.po +++ b/docs/locale/es/LC_MESSAGES/api.gateway.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.gateway.rst:4 msgid "Gateway" @@ -36,121 +36,169 @@ msgid "" "WebSocket." msgstr "" +#: interactions.api.gateway.client.WebSocketClient:4 of +msgid "" +"The ``__heartbeat_event`` Event object is different from the one built in" +" to the Heartbeater object. The latter is used to trace heartbeat " +"acknowledgement." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient of msgid "Variables" msgstr "" -#: interactions.api.gateway.client.WebSocketClient:3 of +#: interactions.api.gateway.client.WebSocketClient:7 of msgid "The asynchronous event loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:4 of +#: interactions.api.gateway.client.WebSocketClient:8 of msgid "The built-in event dispatcher." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:5 of +#: interactions.api.gateway.client.WebSocketClient:9 of +msgid "The websocket ratelimiter object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:10 of msgid "The user-facing HTTP client." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:6 of +#: interactions.api.gateway.client.WebSocketClient:11 of msgid "The WebSocket data of the connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:7 of +#: interactions.api.gateway.client.WebSocketClient:12 of msgid "Whether the connection has been closed or not." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:8 of +#: interactions.api.gateway.client.WebSocketClient:13 of msgid "The connection options made during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:9 of +#: interactions.api.gateway.client.WebSocketClient:14 of msgid "The gateway intents used for connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:10 of +#: interactions.api.gateway.client.WebSocketClient:15 of msgid "The contents of the application returned when ready." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:11 of +#: interactions.api.gateway.client.WebSocketClient:16 of msgid "The context state of a \"heartbeat\" made to the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:12 of +#: interactions.api.gateway.client.WebSocketClient:17 of +msgid "The state of the overall heartbeat process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:18 of msgid "The shards used during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:13 of +#: interactions.api.gateway.client.WebSocketClient:19 of msgid "The presence used in connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:14 of +#: interactions.api.gateway.client.WebSocketClient:20 of msgid "The ready state of the client as an ``asyncio.Event``." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:15 of -msgid "The closing task for ending connections." +#: interactions.api.gateway.client.WebSocketClient:21 of +msgid "The task containing the heartbeat manager process." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:16 of +#: interactions.api.gateway.client.WebSocketClient:22 of msgid "Whether the client has started." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:17 of +#: interactions.api.gateway.client.WebSocketClient:23 of msgid "The ID of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:18 of +#: interactions.api.gateway.client.WebSocketClient:24 of msgid "The sequence identifier of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:19 of +#: interactions.api.gateway.client.WebSocketClient:25 of msgid "" "The latest time of the last send_packet function call since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:20 of +#: interactions.api.gateway.client.WebSocketClient:26 of msgid "" "The latest time of the last ``HEARTBEAT_ACK`` event since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:21 of -msgid "The latency of the connection, in seconds." +#: interactions.api.gateway.client.WebSocketClient:27 of +msgid "The Websocket ratelimit URL for resuming connections, if any." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:28 of +msgid "The Websocket URL for instantiating connections without resuming." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:29 of +msgid "The lock used for reconnecting the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:30 of +msgid "The lock used for closing the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:31 of +msgid "The task containing stopping the client, if any." msgstr "" #: interactions.api.gateway.client.WebSocketClient #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__identify +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache #: interactions.api.gateway.client.WebSocketClient.__option_type_context +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection +#: interactions.api.gateway.client.WebSocketClient._handle_stream +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence +#: interactions.api.gateway.client.WebSocketClient.request_guild_members #: interactions.api.gateway.heartbeat._Heartbeat of msgid "Parameters" msgstr "" -#: interactions.api.gateway.client.WebSocketClient +#: interactions.api.gateway.client.WebSocketClient.latency:1 of +msgid "The latency of the connection, in seconds." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat:1 of +msgid "" +"Controls the heartbeat manager. Do note that this shouldn't be executed " +"by outside processes." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__heartbeat #: interactions.api.gateway.client.WebSocketClient.__identify #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream -#: interactions.api.gateway.client.WebSocketClient.__restart +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__resume #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection #: interactions.api.gateway.client.WebSocketClient._manage_heartbeat +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence -#: interactions.api.gateway.client.WebSocketClient.wait_until_ready -#: interactions.api.gateway.heartbeat._Heartbeat of +#: interactions.api.gateway.client.WebSocketClient.close +#: interactions.api.gateway.client.WebSocketClient.request_guild_members +#: interactions.api.gateway.client.WebSocketClient.run +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat +#: interactions.api.gateway.client.WebSocketClient.wait_until_ready of msgid "Return type" msgstr "" @@ -158,29 +206,21 @@ msgstr "" msgid "Manages the heartbeat loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__restart:1 of -msgid "Restart the client's connection and heartbeat with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:1 of -msgid "Establishes a client connection with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:3 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:5 of -msgid "The shards to establish a connection with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient.run:1 of +msgid "Handles the client's connection with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._establish_connection:5 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:7 of -msgid "The presence to carry with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:1 of +msgid "" +"Parses raw stream data recieved from the Gateway, including Gateway " +"opcodes and events." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:1 of -msgid "Handles the client's connection with the Gateway." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:4 of +msgid "This should never be called directly." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:3 of +#: interactions.api.gateway.client.WebSocketClient._handle_stream:6 of msgid "The packet stream to handle." msgstr "" @@ -192,31 +232,68 @@ msgstr "" msgid "Dispatches an event from the Gateway." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:3 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:3 of msgid "The name of the event." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:5 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:5 of msgid "The data for the event." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of -msgid "" -"Takes raw data given back from the Gateway and gives \"context\" based " -"off of what it is." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:1 of +msgid "Gets an ID from object." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of -msgid "The data from the Gateway." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:5 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:7 of +msgid "The object of the event." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:7 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:5 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:9 of +msgid "The model of the event." msgstr "" #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context of msgid "Returns" msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:9 of +msgid "Object ID" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:1 of +msgid "Gets a list of ids of object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:7 of +msgid "Object IDs" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:1 of +msgid "Modifies guild cache." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of +msgid "" +"Takes raw data given back from the Gateway and gives \"context\" based " +"off of what it is." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of +msgid "The data from the Gateway." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize:6 of msgid "The context object." msgstr "" @@ -255,11 +332,15 @@ msgstr "" msgid "The option type context." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:1 of -msgid "Receives a stream of packets sent from the Gateway." +#: interactions.api.gateway.client.WebSocketClient._reconnect:1 of +msgid "Restarts the client's connection and heartbeat with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:3 of +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:1 of +msgid "Receives a stream of packets sent from the Gateway in an async process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:3 of msgid "The packet stream." msgstr "" @@ -311,6 +392,58 @@ msgid "" "disconnect." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:1 of +msgid "Sends an ``REQUEST_MEMBERS`` packet to the gateway." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:3 of +msgid "ID of the guild to get members for." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:5 of +msgid "" +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:7 of +msgid "String that username starts with." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.close:1 of +msgid "Closes the current connection." +msgstr "" + #: interactions.api.gateway.heartbeat._Heartbeat:1 of msgid "An internal class representing the heartbeat in a WebSocket connection." msgstr "" + +#~ msgid "The closing task for ending connections." +#~ msgstr "" + +#~ msgid "Restart the client's connection and heartbeat with the Gateway." +#~ msgstr "" + +#~ msgid "Establishes a client connection with the Gateway." +#~ msgstr "" + +#~ msgid "The shards to establish a connection with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "The presence to carry with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "Receives a stream of packets sent from the Gateway." +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.http.po b/docs/locale/es/LC_MESSAGES/api.http.po index b141f2d87..fcab462c2 100644 --- a/docs/locale/es/LC_MESSAGES/api.http.po +++ b/docs/locale/es/LC_MESSAGES/api.http.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.http.rst:4 msgid "HTTP" @@ -55,10 +55,13 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag #: interactions.api.http.channel.ChannelRequest.delete_channel #: interactions.api.http.channel.ChannelRequest.delete_channel_permission #: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag #: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -75,6 +78,7 @@ msgstr "" #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template @@ -169,6 +173,7 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker #: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread #: interactions.api.http.thread.ThreadRequest.join_thread #: interactions.api.http.thread.ThreadRequest.leave_thread @@ -198,14 +203,19 @@ msgstr "" msgid "Parameters" msgstr "" -#: interactions.api.http.channel.ChannelRequest +#: interactions.api.http.route.Route.get_bucket:1 of +msgid "" +"Returns the route's bucket. If shared_bucket is None, returns the path " +"with major parameters. Otherwise, it relies on Discord's given bucket." +msgstr "" + +#: interactions.api.http.route.Route.get_bucket:4 of +msgid "The bucket that Discord provides, if available." +msgstr "" + #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance -#: interactions.api.http.channel.ChannelRequest.delete_channel -#: interactions.api.http.channel.ChannelRequest.delete_channel_permission -#: interactions.api.http.channel.ChannelRequest.delete_stage_instance -#: interactions.api.http.channel.ChannelRequest.edit_channel_permission #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -214,37 +224,21 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel -#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway -#: interactions.api.http.client.HTTPClient.get_current_authorisation_information -#: interactions.api.http.client.HTTPClient.get_current_bot_information -#: interactions.api.http.client.HTTPClient.get_gateway -#: interactions.api.http.client.HTTPClient.login -#: interactions.api.http.client.HTTPClient.logout -#: interactions.api.http.emoji.EmojiRequest #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji -#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji -#: interactions.api.http.guild.GuildRequest #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template -#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template -#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.delete_guild -#: interactions.api.http.guild.GuildRequest.delete_guild_integration -#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles -#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild -#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -255,28 +249,17 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings -#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild -#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget -#: interactions.api.http.guild.GuildRequest.modify_user_voice_state -#: interactions.api.http.guild.GuildRequest.remove_guild_ban -#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template -#: interactions.api.http.interaction.InteractionRequest -#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command -#: interactions.api.http.interaction.InteractionRequest.create_interaction_response -#: interactions.api.http.interaction.InteractionRequest.delete_application_command -#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -285,46 +268,22 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command -#: interactions.api.http.limiter.Limiter -#: interactions.api.http.member.MemberRequest -#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member -#: interactions.api.http.member.MemberRequest.remove_member_role -#: interactions.api.http.member.MemberRequest.search_guild_members -#: interactions.api.http.message.MessageRequest -#: interactions.api.http.message.MessageRequest.create_message -#: interactions.api.http.message.MessageRequest.delete_message -#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message -#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message -#: interactions.api.http.message.MessageRequest.send_message -#: interactions.api.http.message.MessageRequest.unpin_message -#: interactions.api.http.reaction.ReactionRequest -#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction -#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction -#: interactions.api.http.request._Request -#: interactions.api.http.request._Request._check_lock -#: interactions.api.http.request._Request._check_session -#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request -#: interactions.api.http.route.Route interactions.api.http.route.Route.endpoint +#: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket -#: interactions.api.http.scheduledEvent.ScheduledEventRequest #: interactions.api.http.scheduledEvent.ScheduledEventRequest.create_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.delete_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event_users #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events #: interactions.api.http.scheduledEvent.ScheduledEventRequest.modify_scheduled_event -#: interactions.api.http.sticker.StickerRequest #: interactions.api.http.sticker.StickerRequest.create_guild_sticker #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker #: interactions.api.http.sticker.StickerRequest.get_guild_sticker @@ -332,53 +291,44 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker -#: interactions.api.http.thread.ThreadRequest -#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread -#: interactions.api.http.thread.ThreadRequest.join_thread -#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members -#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread -#: interactions.api.http.user.UserRequest #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user -#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild -#: interactions.api.http.webhook.WebhookRequest #: interactions.api.http.webhook.WebhookRequest.create_webhook -#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message -#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks -#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Return type" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:1 of -msgid "" -"Returns the route's bucket. If shared_bucket is None, returns the path " -"with major parameters. Otherwise, it relies on Discord's given bucket." +msgid "Returns" msgstr "" -#: interactions.api.http.route.Route.get_bucket:4 of -msgid "The bucket that Discord provides, if available." +#: interactions.api.http.route.Route.get_bucket:7 of +msgid "The route bucket." msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag +#: interactions.api.http.channel.ChannelRequest.delete_channel +#: interactions.api.http.channel.ChannelRequest.delete_channel_permission +#: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag +#: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -387,20 +337,36 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel +#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway +#: interactions.api.http.client.HTTPClient.get_current_authorisation_information +#: interactions.api.http.client.HTTPClient.get_current_bot_information +#: interactions.api.http.client.HTTPClient.get_gateway +#: interactions.api.http.client.HTTPClient.login +#: interactions.api.http.client.HTTPClient.logout #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji +#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template +#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template +#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.delete_guild +#: interactions.api.http.guild.GuildRequest.delete_guild_integration +#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles +#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild +#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -411,17 +377,27 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings +#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild +#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget +#: interactions.api.http.guild.GuildRequest.modify_user_voice_state +#: interactions.api.http.guild.GuildRequest.remove_guild_ban +#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template +#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command +#: interactions.api.http.interaction.InteractionRequest.create_interaction_response +#: interactions.api.http.interaction.InteractionRequest.delete_application_command +#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -430,13 +406,30 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command +#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member +#: interactions.api.http.member.MemberRequest.remove_member_role +#: interactions.api.http.member.MemberRequest.search_guild_members +#: interactions.api.http.message.MessageRequest.create_message +#: interactions.api.http.message.MessageRequest.delete_message +#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message +#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message +#: interactions.api.http.message.MessageRequest.send_message +#: interactions.api.http.message.MessageRequest.unpin_message +#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction +#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction +#: interactions.api.http.request._Request._check_lock +#: interactions.api.http.request._Request._check_session +#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request #: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket @@ -453,31 +446,36 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker +#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread +#: interactions.api.http.thread.ThreadRequest.join_thread +#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members +#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user +#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild #: interactions.api.http.webhook.WebhookRequest.create_webhook +#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message +#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks +#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Returns" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:7 of -msgid "The route bucket." +msgid "Return type" msgstr "" #: interactions.api.http.route.Route.endpoint:1 of @@ -617,9 +615,12 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel_invite:6 #: interactions.api.http.channel.ChannelRequest.create_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.create_tag:7 #: interactions.api.http.channel.ChannelRequest.delete_channel_permission:3 #: interactions.api.http.channel.ChannelRequest.delete_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.delete_tag:3 #: interactions.api.http.channel.ChannelRequest.edit_channel_permission:3 +#: interactions.api.http.channel.ChannelRequest.edit_tag:7 #: interactions.api.http.channel.ChannelRequest.get_channel:3 #: interactions.api.http.channel.ChannelRequest.get_channel_invites:3 #: interactions.api.http.channel.ChannelRequest.get_channel_messages:6 @@ -919,6 +920,51 @@ msgstr "" msgid "Delete a stage instance." msgstr "" +#: interactions.api.http.channel.ChannelRequest.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:4 +#: interactions.api.http.channel.ChannelRequest.edit_tag:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:8 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:9 +#: interactions.api.http.channel.ChannelRequest.edit_tag:10 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:10 +#: interactions.api.http.channel.ChannelRequest.edit_tag:11 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:1 of +msgid "Update a tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:8 of +msgid "The ID of the tag to update." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:1 of +msgid "Delete a forum tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:4 of +msgid "The ID of the tag to delete" +msgstr "" + #: interactions.api.http.emoji.EmojiRequest.get_all_emoji:1 of msgid "Gets all emojis from a guild." msgstr "" @@ -1279,6 +1325,7 @@ msgstr "" msgid "Gets all roles from a Guild." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:3 #: interactions.api.http.guild.GuildRequest.create_guild_ban:3 #: interactions.api.http.guild.GuildRequest.create_guild_kick:3 #: interactions.api.http.guild.GuildRequest.get_all_roles:3 @@ -1374,7 +1421,9 @@ msgid "" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "" +"Number of seconds to delete messages for, between 0 and 604800. Default " +"to 0" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:6 of @@ -1467,20 +1516,36 @@ msgstr "" msgid "Reason to send to audit log, if any." msgstr "" -#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of -msgid "" -"Retrieves a dict from an API that results in how many members would be " -"pruned given the amount of days." +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:1 of +msgid "Begins a prune operation." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:4 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:4 of -msgid "Number of days to count. Defaults to ``7``." +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:5 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:6 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:5 of msgid "Role IDs to include, if given." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:7 of +msgid "A dict containing `{\"pruned\": int}` or `{\"pruned\": None}`" +msgstr "" + +#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of +msgid "" +"Retrieves a dict from an API that results in how many members would be " +"pruned given the amount of days." +msgstr "" + #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:6 of msgid "A dict denoting `{\"pruned\": int}`" msgstr "" @@ -1974,7 +2039,8 @@ msgid "Channel snowflake ID." msgstr "" #: interactions.api.http.message.MessageRequest.create_message:5 -#: interactions.api.http.message.MessageRequest.edit_message:6 of +#: interactions.api.http.message.MessageRequest.edit_message:6 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:9 of msgid "An optional list of files to send attached to the message." msgstr "" @@ -2178,11 +2244,8 @@ msgid "Guild Scheduled Event ID snowflake." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:5 -#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 #: of -msgid "" -"A boolean to include number of users subscribed to the associated event, " -"if given." +msgid "Whether the number of users subscribed to the events is returned." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:6 @@ -2195,6 +2258,13 @@ msgstr "" msgid "Gets all guild scheduled events in a guild." msgstr "" +#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 +#: of +msgid "" +"Whether the number of users subscribed to the associated event is " +"returned." +msgstr "" + #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:5 #: of msgid "" @@ -2307,22 +2377,25 @@ msgid "" "MANAGE_EMOJIS_AND_STICKERS permission." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 -#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of -msgid "the payload to send." +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 of +msgid "The payload to send." msgstr "" #: interactions.api.http.sticker.StickerRequest.create_guild_sticker:4 of +msgid "The file to send." +msgstr "" + +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 of msgid "The guild to create sticker at." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:5 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:6 of msgid "The reason for this action." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 of +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:7 of msgid "The new sticker data on success." msgstr "" @@ -2332,6 +2405,10 @@ msgid "" "permission." msgstr "" +#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of +msgid "the payload to send." +msgstr "" + #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:3 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:4 of msgid "The guild of the target sticker." @@ -2483,15 +2560,18 @@ msgid "" "with.." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:3 of +#: interactions.api.http.thread.ThreadRequest.create_thread:3 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:3 of msgid "The ID of the channel to create this thread in" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:4 of +#: interactions.api.http.thread.ThreadRequest.create_thread:4 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:4 of msgid "The name of the thread" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:5 of +#: interactions.api.http.thread.ThreadRequest.create_thread:5 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:5 of msgid "" "duration in minutes to automatically archive the thread after recent " "activity, can be set to: 60, 1440, 4320, 10080" @@ -2511,7 +2591,8 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:10 of +#: interactions.api.http.thread.ThreadRequest.create_thread:10 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:11 of msgid "An optional reason for the audit log" msgstr "" @@ -2519,6 +2600,28 @@ msgstr "" msgid "The created thread" msgstr "" +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:1 of +msgid "From a given Forum channel, create a Thread with a message to start with." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:7 of +msgid "The payload/dictionary contents of the first message in the forum thread." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:8 of +msgid "List of tag ids that can be applied to the forum, if any." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:10 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:12 of +msgid "Returns a Thread in a Forum object with a starting Message." +msgstr "" + #: interactions.api.http.user.UserRequest.get_self:1 of msgid "An alias to `get_user`, but only gets the current bot user." msgstr "" @@ -2743,3 +2846,15 @@ msgstr "" #: of msgid "Deletes the original message object sent." msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Number of days to count. Defaults to ``7``." +#~ msgstr "" + +#~ msgid "" +#~ "A boolean to include number of " +#~ "users subscribed to the associated " +#~ "event, if given." +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.models.audit_log.po b/docs/locale/es/LC_MESSAGES/api.models.audit_log.po new file mode 100644 index 000000000..7ba1f1c2b --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/api.models.audit_log.po @@ -0,0 +1,413 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.audit_log.rst:4 +msgid "Audit-Log Models" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:1 of +msgid "A class object representing an AuditLogEntry." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange +#: interactions.api.models.audit_log.AuditLogEntry +#: interactions.api.models.audit_log.AuditLogEvents +#: interactions.api.models.audit_log.AuditLogs +#: interactions.api.models.audit_log.OptionalAuditEntryInfo of +msgid "Variables" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:3 of +msgid "ID of the affected entity (webhook, user, role, etc.)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:4 of +msgid "Changes made to the target_id" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:5 of +msgid "User or app that made the changes" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:6 of +msgid "ID of the entry" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:7 of +msgid "Type of action that occurred" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:8 of +msgid "Additional info for certain event types" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:9 of +msgid "Reason for the change (1-512 characters)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "A class object representing the different types of AuditLogEvents." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:3 of +msgid "1 - Server settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:4 of +msgid "10 - Channel was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:5 of +msgid "11 - Channel settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:6 of +msgid "12 - Channel was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:7 of +msgid "13 - Permission overwrite was added to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:8 of +msgid "14 - Permission overwrite was updated for a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:9 of +msgid "15 - Permission overwrite was deleted from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:10 of +msgid "20 - Member was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:11 of +msgid "21 - Members were pruned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:12 of +msgid "22 - Member was banned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:13 of +msgid "23 - Server ban was lifted for a member" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:14 of +msgid "24 - Member was updated in server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:15 of +msgid "25 - Member was added or removed from a role" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:16 of +msgid "26 - Member was moved to a different voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:17 of +msgid "27 - Member was disconnected from a voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:18 of +msgid "28 - Bot user was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:19 of +msgid "30 - Role was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:20 of +msgid "31 - Role was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:21 of +msgid "32 - Role was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:22 of +msgid "40 - Server invite was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:23 of +msgid "41 - Server invite was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:24 of +msgid "42 - Server invite was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:25 of +msgid "50 - Webhook was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:26 of +msgid "51 - Webhook properties or channel were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:27 of +msgid "52 - Webhook was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:28 of +msgid "60 - Emoji was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:29 of +msgid "61 - Emoji name was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:30 of +msgid "62 - Emoji was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:31 of +msgid "72 - Single message was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:32 of +msgid "73 - Multiple messages were deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:33 of +msgid "74 - Message was pinned to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:34 of +msgid "75 - Message was unpinned from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:35 of +msgid "80 - App was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:36 of +msgid "81 - App was updated (as an example, its scopes were updated)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:37 of +msgid "82 - App was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:38 of +msgid "83 - Stage instance was created (stage channel becomes live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:39 of +msgid "84 - Stage instance details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:40 of +msgid "85 - Stage instance was deleted (stage channel no longer live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:41 of +msgid "90 - Sticker was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:42 of +msgid "91 - Sticker details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:43 of +msgid "92 - Sticker was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:44 of +msgid "100 - Event was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:45 of +msgid "101 - Event was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:46 of +msgid "102 - Event was cancelled" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:47 of +msgid "110 - Thread was created in a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:48 of +msgid "111 - Thread was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:49 of +msgid "112 - Thread was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:50 of +msgid "121 - Permissions were updated for a command" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:51 of +msgid "140 - Auto Moderation rule was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:52 of +msgid "141 - Auto Moderation rule was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:53 of +msgid "142 - Auto Moderation rule was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:54 of +msgid "143 - Message was blocked by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:55 of +msgid "144 - Message was flagged by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:56 of +msgid "145 - Member was timed out by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents of +msgid "Member Type" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid ":py:class:`int`" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:1 of +msgid "A class object representing the audit logs of a guild." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:3 of +msgid "List of audit log entries, sorted from most to least recent." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:4 of +msgid "List of auto moderation rules referenced in the audit log." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:5 of +msgid "List of guild scheduled events referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:6 of +msgid "List of partial integration objects" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:7 of +msgid "List of threads referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:8 of +msgid "List of users referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:9 of +msgid "List of webhooks referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:1 of +msgid "A class object representing an AuditLogChange." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:3 of +msgid "New value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:4 of +msgid "Old value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:5 of +msgid "" +"Name of the changed entity, with a few " +"[exceptions](https://discord.com/developers/docs/resources/audit-log" +"#audit-log-change-object-audit-log-change-exceptions)" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:1 of +msgid "A class object representing OptionalAuditEntryInfo." +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:3 of +msgid "" +"ID of the app whose permissions were targeted. ``AuditLogEvents``-type: " +"121" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:4 of +msgid "" +"Channel in which the entities were targeted. ``AuditLogEvents``-types: " +"26, 74, 75, 72, 83, 84, 85" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:5 of +msgid "" +"Name of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:6 of +msgid "" +"Trigger type of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:7 of +msgid "" +"Number of entities that were targeted. ``AuditLogEvents``-types: 72, 73, " +"27, 26" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:8 of +msgid "" +"Number of days after which inactive members were kicked. " +"``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:9 of +msgid "ID of the overwritten entity. ``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:10 of +msgid "Number of members removed by the prune. ``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:11 of +msgid "ID of the message that was targeted. ``AuditLogEvents``-types: 74, 75" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:12 of +msgid "" +"Name of the role if type is \"0\" (not present if type is \"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:13 of +msgid "" +"Type of overwritten entity - role (\"0\") or member (\"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.models.channel.po b/docs/locale/es/LC_MESSAGES/api.models.channel.po index 1ca5f1ac3..81a65bd8e 100644 --- a/docs/locale/es/LC_MESSAGES/api.models.channel.po +++ b/docs/locale/es/LC_MESSAGES/api.models.channel.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.channel.rst:4 msgid "Channel Models" @@ -39,22 +39,24 @@ msgid "Valid values are as follows:" msgstr "" #: interactions.api.models.channel.Thread:1 of -msgid "An object representing a thread." -msgstr "" - -#: interactions.api.models.channel.Thread:4 of -msgid "" -"This is a derivation of the base Channel, since a thread can be its own " -"event." +msgid "An object representing a thread. .. note::" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator +#: interactions.api.models.channel.AsyncTypingContextManager #: interactions.api.models.channel.Channel #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.modify #: interactions.api.models.channel.Channel.pin_message @@ -72,6 +74,9 @@ msgstr "" #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit #: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit #: interactions.api.models.channel.Thread #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of @@ -88,7 +93,7 @@ msgid "" "needed to be used directly." msgstr "" -#: interactions.api.models.channel.Channel +#: interactions.api.models.channel.Channel interactions.api.models.channel.Tags #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of msgid "Variables" @@ -183,33 +188,64 @@ msgid "The amount of members in the channel." msgstr "" #: interactions.api.models.channel.Channel:29 of -msgid "The thread metadata of the channel." +msgid "Boolean representing if a thread is created." msgstr "" #: interactions.api.models.channel.Channel:30 of -msgid "The member of the thread in the channel." +msgid "The thread metadata of the channel." msgstr "" #: interactions.api.models.channel.Channel:31 of +msgid "The member of the thread in the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:32 of msgid "" "The set auto-archive time for all threads to naturally follow in the " "channel." msgstr "" -#: interactions.api.models.channel.Channel:32 of +#: interactions.api.models.channel.Channel:33 of msgid "The permissions of the channel." msgstr "" -#: interactions.api.models.channel.Channel.mention:1 of -msgid "Returns a string that allows you to mention the given channel." +#: interactions.api.models.channel.Channel:34 of +msgid "The flags of the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:35 of +msgid "Number of messages ever sent in a thread." +msgstr "" + +#: interactions.api.models.channel.Channel:36 of +msgid "" +"The default slowmode delay in seconds for threads, if this channel is a " +"forum." +msgstr "" + +#: interactions.api.models.channel.Channel:37 of +msgid "Tags in a forum channel, if any." +msgstr "" + +#: interactions.api.models.channel.Channel:38 of +msgid "Default reaction emoji for threads created in a forum, if any." +msgstr "" + +#: interactions.api.models.channel.Channel.typing:1 of +msgid "Manages the typing of the channel. Use with `await` or `async with`" msgstr "" #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.mention #: interactions.api.models.channel.Channel.modify @@ -224,24 +260,33 @@ msgstr "" #: interactions.api.models.channel.Channel.set_position #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic -#: interactions.api.models.channel.Channel.set_user_limit of +#: interactions.api.models.channel.Channel.set_user_limit +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Tags.edit of msgid "Returns" msgstr "" -#: interactions.api.models.channel.Channel.mention:3 of -msgid "The string of the mentioned channel." +#: interactions.api.models.channel.Channel.typing:3 of +msgid "A manager for typing" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator.flatten #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread #: interactions.api.models.channel.Channel.delete +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages #: interactions.api.models.channel.Channel.get_webhooks +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.join #: interactions.api.models.channel.Channel.leave #: interactions.api.models.channel.Channel.lock @@ -261,10 +306,44 @@ msgstr "" #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit -#: interactions.api.models.channel.Channel.unpin_message of +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit of msgid "Return type" msgstr "" +#: interactions.api.models.channel.Channel.mention:1 of +msgid "Returns a string that allows you to mention the given channel." +msgstr "" + +#: interactions.api.models.channel.Channel.mention:3 of +msgid "The string of the mentioned channel." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:7 +#: interactions.api.models.channel.Channel.history:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:9 +#: interactions.api.models.channel.Channel.history:3 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:13 +#: interactions.api.models.channel.Channel.history:5 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.channel.Channel.history:7 of +msgid "A custom check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.Channel.history:10 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" + #: interactions.api.models.channel.Channel.send:1 of msgid "Sends a message in the channel." msgstr "" @@ -292,7 +371,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.channel.Channel.send:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.channel.Channel.send:15 of @@ -625,10 +704,12 @@ msgstr "" msgid "Creates a thread in the Channel." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:3 #: interactions.api.models.channel.Channel.create_thread:3 of msgid "The name of the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:5 #: interactions.api.models.channel.Channel.create_thread:5 of msgid "" "duration in minutes to automatically archive the thread after recent " @@ -649,6 +730,7 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:16 #: interactions.api.models.channel.Channel.create_thread:14 of msgid "An optional reason for the audit log" msgstr "" @@ -734,6 +816,109 @@ msgstr "" msgid "Add the bot to the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:4 +#: interactions.api.models.channel.Channel.edit_tag:4 +#: interactions.api.models.channel.Tags.edit:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:7 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:9 +#: interactions.api.models.channel.Channel.edit_tag:11 +#: interactions.api.models.channel.Tags.edit:11 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:11 +#: interactions.api.models.channel.Channel.edit_tag:13 +#: interactions.api.models.channel.Tags.edit:13 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:13 of +msgid "The create tag object" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:1 of +msgid "Edits a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:7 of +msgid "The ID of the tag to edit" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:9 +#: interactions.api.models.channel.Tags.edit:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:15 +#: interactions.api.models.channel.Tags.edit:15 of +msgid "The modified tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:1 of +msgid "Deletes a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:3 of +msgid "The ID of the Tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:1 of +msgid "Creates a new post inside a forum channel" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:8 of +msgid "The content to send as first message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:10 of +msgid "Tags to give to the created thread" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:12 of +msgid "An optional list of files to send attached to the message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:14 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:18 of +msgid "A channel of ChannelType 11 (THREAD)" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:1 of +msgid "Returns the permissions of the member in this specific channel." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:4 of +msgid "" +"The permissions returned by this function take into account role and user" +" overwrites that can be assigned to channels or categories. If you don't " +"need these overwrites, look into :meth:`.Member.get_guild_permissions`." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:8 of +msgid "The member to get the permissions from" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:10 of +msgid "Permissions of the member in this channel" +msgstr "" + #: interactions.api.models.channel.ThreadMember:1 of msgid "A class object representing a member in a thread." msgstr "" @@ -793,3 +978,83 @@ msgstr "" #: interactions.api.models.channel.ThreadMetadata:11 of msgid "The ability to invite users to the thread." msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:3 +#: interactions.api.models.channel.AsyncTypingContextManager:5 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:11 of +msgid "A check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:1 of +msgid "An async context manager for triggering typing." +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:3 of +msgid "The channel to trigger typing in." +msgstr "" + +#: interactions.api.models.channel.Tags:1 of +msgid "An object denoting a tag object within a forum channel." +msgstr "" + +#: interactions.api.models.channel.Tags:4 of +msgid "If the emoji is custom, it won't have name information." +msgstr "" + +#: interactions.api.models.channel.Tags:6 of +msgid "Name of the tag. The limit is up to 20 characters." +msgstr "" + +#: interactions.api.models.channel.Tags:7 of +msgid "ID of the tag. Can also be 0 if manually created." +msgstr "" + +#: interactions.api.models.channel.Tags:8 of +msgid "" +"A boolean denoting whether this tag can be removed/added by moderators " +"with ``manage_threads`` permissions." +msgstr "" + +#: interactions.api.models.channel.Tags:9 of +msgid "The emoji to represent the tag, if any." +msgstr "" + +#: interactions.api.models.channel.Tags.delete:1 of +msgid "Deletes this tag" +msgstr "" + +#: interactions.api.models.channel.Tags.delete:3 +#: interactions.api.models.channel.Tags.edit:7 of +msgid "The ID of the channel where the tag belongs to" +msgstr "" + +#: interactions.api.models.channel.Tags.edit:1 of +msgid "Edits this tag" +msgstr "" + +#~ msgid "An object representing a thread." +#~ msgstr "" + +#~ msgid "" +#~ "This is a derivation of the base" +#~ " Channel, since a thread can be " +#~ "its own event." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.models.emoji.po b/docs/locale/es/LC_MESSAGES/api.models.emoji.po new file mode 100644 index 000000000..2809ce66e --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/api.models.emoji.po @@ -0,0 +1,139 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-29 13:24-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.emoji.rst:4 +msgid "Emoji Models" +msgstr "" + +#: interactions.api.models.emoji.Emoji:1 of +msgid "A class objecting representing an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji of +msgid "Variables" +msgstr "" + +#: interactions.api.models.emoji.Emoji:3 of +msgid "Emoji id" +msgstr "" + +#: interactions.api.models.emoji.Emoji:4 of +msgid "Emoji name." +msgstr "" + +#: interactions.api.models.emoji.Emoji:5 of +msgid "Roles allowed to use this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:6 of +msgid "User that created this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:7 of +msgid "Status denoting of this emoji must be wrapped in colons" +msgstr "" + +#: interactions.api.models.emoji.Emoji:8 of +msgid "Status denoting if this emoji is managed (by an integration)" +msgstr "" + +#: interactions.api.models.emoji.Emoji:9 of +msgid "Status denoting if this emoji is animated" +msgstr "" + +#: interactions.api.models.emoji.Emoji:10 of +msgid "" +"Status denoting if this emoji can be used. (Can be false via server " +"boosting)" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:1 of +msgid "Gets an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild of +msgid "Parameters" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:3 of +msgid "The id of the guild of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:5 of +msgid "The id of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:7 +#: interactions.api.models.emoji.Emoji.get_all_of_guild:5 of +msgid "The HTTPClient of your bot. Equals to ``bot._http``" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Returns" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:9 of +msgid "The Emoji as object" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Return type" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:1 of +msgid "Gets all emoji of a guild." +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:3 of +msgid "The id of the guild to get the emojis of" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:7 of +msgid "The Emoji as list" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:1 of +msgid "Deletes the emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:3 of +msgid "The guild id to delete the emoji from" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:5 of +msgid "The reason of the deletion" +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:1 of +msgid "Returns the emoji's URL." +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:3 of +msgid "URL of the emoji" +msgstr "" + +#~ msgid "Audit-Log Models" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.models.guild.po b/docs/locale/es/LC_MESSAGES/api.models.guild.po index a233b694b..6a195d3a5 100644 --- a/docs/locale/es/LC_MESSAGES/api.models.guild.po +++ b/docs/locale/es/LC_MESSAGES/api.models.guild.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:25-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.guild.rst:4 msgid "Guild Models" @@ -85,6 +85,7 @@ msgstr "" msgid "The location of the event, if any." msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator #: interactions.api.models.guild.EventMetadata #: interactions.api.models.guild.Guild #: interactions.api.models.guild.Guild.add_member_role @@ -95,17 +96,25 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji #: interactions.api.models.guild.Guild.delete_role #: interactions.api.models.guild.Guild.delete_scheduled_event +#: interactions.api.models.guild.Guild.delete_sticker +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule @@ -115,6 +124,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -672,13 +683,26 @@ msgid "The id of the member to ban" msgstr "" #: interactions.api.models.guild.Guild.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.guild.Guild.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:13 of +msgid "The reason of the ban" msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator.flatten #: interactions.api.models.guild.Guild.add_member_role #: interactions.api.models.guild.Guild.ban #: interactions.api.models.guild.Guild.clone_channel @@ -687,6 +711,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji @@ -698,13 +723,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.leave #: interactions.api.models.guild.Guild.list_auto_moderation_rules @@ -716,6 +749,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -840,6 +875,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_channel #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.get_all_active_threads #: interactions.api.models.guild.Guild.get_all_bans @@ -847,13 +883,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule #: interactions.api.models.guild.Guild.modify_channel @@ -862,6 +906,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.search_members of msgid "Returns" msgstr "" @@ -1508,6 +1554,20 @@ msgstr "" msgid "The created event" msgstr "" +#: interactions.api.models.guild.Guild.get_scheduled_events:1 of +msgid "Gets all scheduled events of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:3 of +msgid "" +"A boolean to include number of users subscribed to the associated event, " +"if given." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:5 of +msgid "The sheduled events of the guild." +msgstr "" + #: interactions.api.models.guild.Guild.modify_scheduled_event:1 of msgid "Edits a scheduled event of the guild." msgstr "" @@ -1614,6 +1674,40 @@ msgstr "" msgid "Gets all bans of the guild." msgstr "" +#: interactions.api.models.guild.Guild.prune:1 of +msgid "Begins a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:3 +#: interactions.api.models.guild.Guild.prune:3 of +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:4 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:4 +#: interactions.api.models.guild.Guild.prune:5 of +msgid "Role IDs to include, if given." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:6 of +msgid "" +"The number of pruned members, if compute_prune_count is not false. " +"Otherwise returns None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:1 of +msgid "Returns the number of members that would be removed in a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:5 of +msgid "The number of members that would be pruned." +msgstr "" + #: interactions.api.models.guild.Guild.get_emoji:1 of msgid "Gets an emoji of the guild and returns it." msgstr "" @@ -1664,6 +1758,77 @@ msgstr "" msgid "The emoji or the id of the emoji to delete" msgstr "" +#: interactions.api.models.guild.Guild.get_stickers:1 of +msgid "Get the stickers for a guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_stickers:3 of +msgid "List of stickers of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:1 of +msgid "Gets the list of sticker packs available to Nitro subscribers." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:3 of +msgid "List of sticker packs." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:1 of +msgid "Creates a new sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:3 of +msgid "The file of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:5 of +msgid "The tags of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:7 +#: interactions.api.models.guild.Guild.modify_sticker:5 of +msgid "The name of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:9 +#: interactions.api.models.guild.Guild.modify_sticker:7 of +msgid "The description of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:11 of +msgid "The reason of the creation." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:13 of +msgid "Created sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:1 of +msgid "Modifies the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:3 +#: interactions.api.models.guild.Guild.modify_sticker:3 of +msgid "The sticker or ID of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:9 of +msgid "The reason of the modification." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:11 of +msgid "Modified sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:1 of +msgid "Deletes the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:5 of +msgid "The reason of the deletion." +msgstr "" + #: interactions.api.models.guild.Guild.get_list_of_members:1 of msgid "Lists the members of a guild." msgstr "" @@ -1710,6 +1875,23 @@ msgstr "" msgid "Returns a list of all members of the guild" msgstr "" +#: interactions.api.models.guild.Guild.get_members:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:11 +#: interactions.api.models.guild.Guild.get_members:3 of +msgid "A set maximum of members to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:5 of +msgid "A custom check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:8 of +msgid "An asynchronous iterator over the members of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.list_auto_moderation_rules:1 of msgid "Lists all AutoMod rules" msgstr "" @@ -1784,6 +1966,55 @@ msgstr "" msgid "The rule to modify" msgstr "" +#: interactions.api.models.guild.Guild.get_audit_logs:1 of +msgid "Gets the audit logs of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:3 of +msgid "How many entries to get, default 100" +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:5 +#: interactions.api.models.guild.Guild.get_full_audit_logs:3 of +msgid "User ID snowflake. filter the log for actions made by a user." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:7 of +msgid "The Type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:9 of +msgid "filter the log before a certain entry id." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:11 of +msgid "The guild audit logs" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:1 of +msgid "Gets the latest audit log action of either a user or an action type" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:3 of +msgid "The user, user id or action type to look for" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:5 of +msgid "The latest AuditLog action that applies to the ``of`` parameter" +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:1 of +msgid "Gets the full audit log of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:5 of +msgid "The type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:7 of +msgid "The full AuditLog of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.icon_url:1 of msgid "" "Returns the URL of the guild's icon. :return: URL of the guild's icon " @@ -1897,3 +2128,32 @@ msgstr "" #: interactions.api.models.guild.Invite.delete:1 of msgid "Deletes the invite" msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:3 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:5 of +msgid "The guild to get the members from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:7 of +msgid "" +"The member ID to start getting members from (gets all members after that " +"member)" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:9 of +msgid "A check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.models.gw.po b/docs/locale/es/LC_MESSAGES/api.models.gw.po index fe823c232..88a920629 100644 --- a/docs/locale/es/LC_MESSAGES/api.models.gw.po +++ b/docs/locale/es/LC_MESSAGES/api.models.gw.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.gw.rst:4 msgid "Gateway-specific Event Models" @@ -42,10 +42,10 @@ msgstr "" #: interactions.api.models.gw.GuildScheduledEventUser #: interactions.api.models.gw.GuildStickers #: interactions.api.models.gw.Integration +#: interactions.api.models.gw.MessageDelete #: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList +#: interactions.api.models.gw.MessageReactionRemove +#: interactions.api.models.gw.Presence interactions.api.models.gw.ThreadList #: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks #: of msgid "Variables" @@ -93,36 +93,6 @@ msgstr "" msgid "The substring in content that triggered rule." msgstr "" -#: interactions.api.models.gw.ApplicationCommandPermissions -#: interactions.api.models.gw.AutoModerationAction -#: interactions.api.models.gw.AutoModerationRule -#: interactions.api.models.gw.ChannelPins -#: interactions.api.models.gw.EmbeddedActivity -#: interactions.api.models.gw.GuildBan interactions.api.models.gw.GuildEmojis -#: interactions.api.models.gw.GuildIntegrations -#: interactions.api.models.gw.GuildJoinRequest -#: interactions.api.models.gw.GuildMember -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send -#: interactions.api.models.gw.GuildMembers interactions.api.models.gw.GuildRole -#: interactions.api.models.gw.GuildScheduledEvent -#: interactions.api.models.gw.GuildScheduledEventUser -#: interactions.api.models.gw.GuildStickers -#: interactions.api.models.gw.Integration -#: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList -#: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks -#: of -msgid "Parameters" -msgstr "" - #: interactions.api.models.gw.AutoModerationRule:1 of msgid "" "A class object representing the gateway events " @@ -232,14 +202,14 @@ msgstr "" #: interactions.api.models.gw.GuildEmojis:3 #: interactions.api.models.gw.GuildIntegrations:3 #: interactions.api.models.gw.GuildJoinRequest:7 -#: interactions.api.models.gw.GuildMember:3 #: interactions.api.models.gw.GuildMembers:3 #: interactions.api.models.gw.GuildRole:3 #: interactions.api.models.gw.GuildStickers:3 #: interactions.api.models.gw.Integration:23 +#: interactions.api.models.gw.MessageDelete:5 #: interactions.api.models.gw.MessageReaction:6 +#: interactions.api.models.gw.MessageReactionRemove:10 #: interactions.api.models.gw.Presence:4 -#: interactions.api.models.gw.ReactionRemove:10 #: interactions.api.models.gw.ThreadList:3 #: interactions.api.models.gw.ThreadMembers:4 of msgid "The guild ID of the event." @@ -251,8 +221,9 @@ msgstr "" #: interactions.api.models.gw.ChannelPins:4 #: interactions.api.models.gw.EmbeddedActivity:9 +#: interactions.api.models.gw.MessageDelete:4 #: interactions.api.models.gw.MessageReaction:4 -#: interactions.api.models.gw.ReactionRemove:8 of +#: interactions.api.models.gw.MessageReactionRemove:8 of msgid "The channel ID of the event." msgstr "" @@ -312,7 +283,6 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildBan:4 -#: interactions.api.models.gw.GuildMember:5 #: interactions.api.models.gw.Integration:17 #: interactions.api.models.gw.Presence:3 of msgid "The user of the event." @@ -378,14 +348,21 @@ msgstr "" msgid "The members of the thread of the event." msgstr "" -#: interactions.api.models.gw.ReactionRemove:1 of +#: interactions.api.models.gw.MessageDelete:1 of +msgid "A class object representing the gateway event ``MESSAGE_DELETE_BULK``." +msgstr "" + +#: interactions.api.models.gw.MessageDelete:3 of +msgid "The message IDs of the event." +msgstr "" + +#: interactions.api.models.gw.MessageReactionRemove:1 of msgid "" "A class object representing the gateway events " -"``MESSAGE_REACTION_REMOVE``, ``MESSAGE_REACTION_REMOVE_ALL`` and " -"``MESSAGE_REACTION_REMOVE_EMOJI``." +"``MESSAGE_REACTION_REMOVE_ALL`` and ``MESSAGE_REACTION_REMOVE_EMOJI``." msgstr "" -#: interactions.api.models.gw.ReactionRemove:4 of +#: interactions.api.models.gw.MessageReactionRemove:4 of msgid "" "This class inherits the already existing attributes of " ":class:`interactions.api.models.gw.Reaction`. The main missing attribute " @@ -394,22 +371,24 @@ msgstr "" #: interactions.api.models.gw.GuildJoinRequest:6 #: interactions.api.models.gw.MessageReaction:3 -#: interactions.api.models.gw.ReactionRemove:7 of +#: interactions.api.models.gw.MessageReactionRemove:7 of msgid "The user ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:5 -#: interactions.api.models.gw.ReactionRemove:9 of +#: interactions.api.models.gw.MessageReactionRemove:9 of msgid "The message ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:8 -#: interactions.api.models.gw.ReactionRemove:11 of +#: interactions.api.models.gw.MessageReactionRemove:11 of msgid "The emoji of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:1 of -msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +msgid "" +"A class object representing the gateway event ``MESSAGE_REACTION_ADD`` " +"and ``MESSAGE_REACTION_REMOVE``." msgstr "" #: interactions.api.models.gw.MessageReaction:7 of @@ -473,204 +452,58 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildMember:4 of -msgid "The roles of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:6 of -msgid "The nickname of the user of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:7 of -msgid "The avatar URL of the user of the event." +msgid "" +"``pending`` and ``permissions`` only apply for members retroactively " +"requiring to verify rules via. membership screening or lack permissions " +"to speak." msgstr "" #: interactions.api.models.gw.GuildMember:8 of -msgid "The time that the user of the event joined at." +msgid "The guild ID." msgstr "" #: interactions.api.models.gw.GuildMember:9 of -msgid "The time that the user of the event has since had \"premium.\"" +msgid "The user of the guild." msgstr "" #: interactions.api.models.gw.GuildMember:10 of -msgid "Whether the member of the event is deafened or not." +msgid "The nickname of the member." msgstr "" #: interactions.api.models.gw.GuildMember:11 of -msgid "Whether the member of the event is muted or not." +msgid "The hash containing the user's guild avatar, if applicable." msgstr "" #: interactions.api.models.gw.GuildMember:12 of -msgid "" -"Whether the member of the event is still pending -- pass membership " -"screening -- or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:1 of -msgid "Returns the ID of the user." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.send of -msgid "Returns" -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:3 of -msgid "The ID of the user" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send of -msgid "Return type" -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:1 of -msgid "Returns the string of either the user's nickname or username." -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:3 of -msgid "The name of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:1 of -msgid "Returns a string that allows you to mention the given member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:3 of -msgid "The string of the mentioned member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:1 of -msgid "Bans the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:3 of -msgid "The reason of the ban" -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:1 of -msgid "Kicks the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:3 of -msgid "The reason for the kick" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:1 of -msgid "This method adds a role to a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:3 of -msgid "The role to add. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:5 of -msgid "The reason why the roles are added" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:1 of -msgid "This method removes a role from a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:3 of -msgid "The role to remove. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:5 of -msgid "The reason why the roles are removed" -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:1 of -msgid "Sends a DM to the member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:3 of -msgid "The contents of the message as a string or string-converted value." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:5 of -msgid "A component, or list of components for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:7 of -msgid "Whether the message utilizes the text-to-speech Discord programme or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:9 of -msgid "A file or list of files to be attached to the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:11 of -msgid "An embed, or list of embeds for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:13 of -msgid "The message interactions/mention limits that the message can refer to." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:15 of -msgid "The sent message as an object." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:1 of -msgid "Modifies the member of a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:3 of -msgid "The nickname of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:5 of -msgid "A list of all role ids the member has" +msgid "The list of roles of the member." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:7 of -msgid "whether the user is muted in voice channels" +#: interactions.api.models.gw.GuildMember:13 of +msgid "The timestamp the member joined the guild at." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:9 of -msgid "whether the user is deafened in voice channels" +#: interactions.api.models.gw.GuildMember:14 of +msgid "The timestamp the member has been a server booster since." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:11 of -msgid "id of channel to move user to (if they are connected to voice)" +#: interactions.api.models.gw.GuildMember:15 of +msgid "Whether the member is deafened." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:13 of -msgid "" -"when the user's timeout will expire and the user will be able to " -"communicate in the guild again (up to 28 days in the future)" +#: interactions.api.models.gw.GuildMember:16 of +msgid "Whether the member is muted." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:15 of -msgid "The reason of the modifying" +#: interactions.api.models.gw.GuildMember:17 of +msgid "Whether the member is pending to pass membership screening." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:17 of -msgid "The modified member object" +#: interactions.api.models.gw.GuildMember:18 of +msgid "Whether the member has permissions." msgstr "" -#: interactions.api.models.gw.GuildMember.add_to_thread:1 of -msgid "Adds the member to a thread." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_to_thread:3 of -msgid "The id of the thread to add the member to" +#: interactions.api.models.gw.GuildMember:19 of +msgid "How long until they're unmuted, if any." msgstr "" #: interactions.api.models.gw.GuildStickers:1 of @@ -823,3 +656,164 @@ msgstr "" #: interactions.api.models.gw.GuildRole:5 of msgid "The role ID of the event." msgstr "" + +#~ msgid "" +#~ "A class object representing the gateway" +#~ " events ``MESSAGE_REACTION_REMOVE``, " +#~ "``MESSAGE_REACTION_REMOVE_ALL`` and " +#~ "``MESSAGE_REACTION_REMOVE_EMOJI``." +#~ msgstr "" + +#~ msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +#~ msgstr "" + +#~ msgid "The roles of the event." +#~ msgstr "" + +#~ msgid "The nickname of the user of the event." +#~ msgstr "" + +#~ msgid "The avatar URL of the user of the event." +#~ msgstr "" + +#~ msgid "The time that the user of the event joined at." +#~ msgstr "" + +#~ msgid "The time that the user of the event has since had \"premium.\"" +#~ msgstr "" + +#~ msgid "Whether the member of the event is deafened or not." +#~ msgstr "" + +#~ msgid "Whether the member of the event is muted or not." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the member of the event is" +#~ " still pending -- pass membership " +#~ "screening -- or not." +#~ msgstr "" + +#~ msgid "Returns the ID of the user." +#~ msgstr "" + +#~ msgid "Returns" +#~ msgstr "" + +#~ msgid "The ID of the user" +#~ msgstr "" + +#~ msgid "Return type" +#~ msgstr "" + +#~ msgid "Returns the string of either the user's nickname or username." +#~ msgstr "" + +#~ msgid "The name of the member" +#~ msgstr "" + +#~ msgid "Returns a string that allows you to mention the given member." +#~ msgstr "" + +#~ msgid "The string of the mentioned member." +#~ msgstr "" + +#~ msgid "Bans the member from a guild." +#~ msgstr "" + +#~ msgid "The reason of the ban" +#~ msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Kicks the member from a guild." +#~ msgstr "" + +#~ msgid "The reason for the kick" +#~ msgstr "" + +#~ msgid "This method adds a role to a member." +#~ msgstr "" + +#~ msgid "The role to add. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are added" +#~ msgstr "" + +#~ msgid "This method removes a role from a member." +#~ msgstr "" + +#~ msgid "The role to remove. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are removed" +#~ msgstr "" + +#~ msgid "Sends a DM to the member." +#~ msgstr "" + +#~ msgid "The contents of the message as a string or string-converted value." +#~ msgstr "" + +#~ msgid "A component, or list of components for the message." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the message utilizes the " +#~ "text-to-speech Discord programme or " +#~ "not." +#~ msgstr "" + +#~ msgid "A file or list of files to be attached to the message." +#~ msgstr "" + +#~ msgid "An embed, or list of embeds for the message." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The sent message as an object." +#~ msgstr "" + +#~ msgid "Modifies the member of a guild." +#~ msgstr "" + +#~ msgid "The nickname of the member" +#~ msgstr "" + +#~ msgid "A list of all role ids the member has" +#~ msgstr "" + +#~ msgid "whether the user is muted in voice channels" +#~ msgstr "" + +#~ msgid "whether the user is deafened in voice channels" +#~ msgstr "" + +#~ msgid "id of channel to move user to (if they are connected to voice)" +#~ msgstr "" + +#~ msgid "" +#~ "when the user's timeout will expire " +#~ "and the user will be able to " +#~ "communicate in the guild again (up " +#~ "to 28 days in the future)" +#~ msgstr "" + +#~ msgid "The reason of the modifying" +#~ msgstr "" + +#~ msgid "The modified member object" +#~ msgstr "" + +#~ msgid "Adds the member to a thread." +#~ msgstr "" + +#~ msgid "The id of the thread to add the member to" +#~ msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.models.member.po b/docs/locale/es/LC_MESSAGES/api.models.member.po index ce23f99ac..f5839f391 100644 --- a/docs/locale/es/LC_MESSAGES/api.models.member.po +++ b/docs/locale/es/LC_MESSAGES/api.models.member.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.member.rst:4 msgid "Member Models" @@ -86,6 +86,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.modify #: interactions.api.models.member.Member.remove_role @@ -93,10 +95,20 @@ msgstr "" msgid "Parameters" msgstr "" +#: interactions.api.models.member.Member.guild_id:1 of +msgid "" +"Attempts to get the guild ID the member is in. Only works then roles or " +"nick or joined at is present. :return: The ID of the guild this member " +"belongs to." +msgstr "" + #: interactions.api.models.member.Member.id:1 of msgid "Returns the ID of the user." msgstr "" +#: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.mention #: interactions.api.models.member.Member.modify @@ -113,6 +125,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.mention @@ -148,11 +162,23 @@ msgid "The id of the guild to ban the member from" msgstr "" #: interactions.api.models.member.Member.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.member.Member.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.member.Member.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.member.Member.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.member.Member.ban:13 of +msgid "The reason of the ban" msgstr "" #: interactions.api.models.member.Member.kick:1 of @@ -230,7 +256,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.member.Member.send:15 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.member.Member.send:17 of @@ -288,9 +314,83 @@ msgid "The id of the thread to add the member to" msgstr "" #: interactions.api.models.member.Member.get_avatar_url:1 of +msgid "Returns the URL of the member's avatar for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:3 of +msgid "The id of the guild to get the member's avatar from" +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:5 of +msgid "URL of the members's avatar (None will be returned if no avatar is set)" +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:1 of +msgid "Returns the permissions of the member for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:4 of msgid "" -"Returns the URL of the member's avatar for the specified guild. :param " -"guild_id: The id of the guild to get the member's avatar from :type " -"guild_id: Union[int, Snowflake, \"Guild\"] :return: URL of the members's " -"avatar (None will be returned if no avatar is set) :rtype: str" +"The permissions returned by this function will not take into account role" +" and user overwrites that can be assigned to channels or categories. If " +"you need these overwrites, look into " +":meth:`.Channel.get_permissions_for`." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:8 of +msgid "The guild of the member" msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:10 of +msgid "Base permissions of the member in the specified guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:1 of +msgid "Returns whether the member has the permissions passed." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:4 of +msgid "" +"If the channel argument is present, the function will look if the member " +"has the permissions in the specified channel. If the argument is missing," +" then it will only consider the member's guild permissions." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:7 of +msgid "The list of permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:9 of +msgid "The channel where to check for permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:11 of +msgid "The id of the guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:13 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:15 of +msgid "Whether the member has the permissions" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "" +#~ "Returns the URL of the member's " +#~ "avatar for the specified guild. :param" +#~ " guild_id: The id of the guild " +#~ "to get the member's avatar from " +#~ ":type guild_id: Union[int, Snowflake, " +#~ "\"Guild\"] :return: URL of the members's" +#~ " avatar (None will be returned if " +#~ "no avatar is set) :rtype: str" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.models.message.po b/docs/locale/es/LC_MESSAGES/api.models.message.po index 5bcd77f9c..e1f033a87 100644 --- a/docs/locale/es/LC_MESSAGES/api.models.message.po +++ b/docs/locale/es/LC_MESSAGES/api.models.message.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.message.rst:4 msgid "Message Models" @@ -50,14 +50,14 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji #: interactions.api.models.message.Message #: interactions.api.models.message.MessageActivity #: interactions.api.models.message.MessageInteraction #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Variables" msgstr "" @@ -156,33 +156,33 @@ msgid "" msgstr "" #: interactions.api.models.message.Message:26 of -msgid "The allowed mentions of roles attached in the message." -msgstr "" - -#: interactions.api.models.message.Message:27 of msgid "Message flags" msgstr "" -#: interactions.api.models.message.Message:28 of +#: interactions.api.models.message.Message:27 of msgid "Message interaction object, if the message is sent by an interaction." msgstr "" -#: interactions.api.models.message.Message:29 of +#: interactions.api.models.message.Message:28 of msgid "" "The thread that started from this message, if any, with a thread member " "object embedded." msgstr "" +#: interactions.api.models.message.Message:29 of +msgid "Array of Action Rows associated with this message, if any." +msgstr "" + #: interactions.api.models.message.Message:30 of -msgid "Components associated with this message, if any." +msgid "An array of message sticker item objects, if sent with them." msgstr "" #: interactions.api.models.message.Message:31 of -msgid "An array of message sticker item objects, if sent with them." +msgid "Array of sticker objects sent with the message if any. Deprecated." msgstr "" #: interactions.api.models.message.Message:32 of -msgid "Array of sticker objects sent with the message if any. Deprecated." +msgid "The approximate position of the message in a thread." msgstr "" #: interactions.api.models.message.Attachment @@ -202,10 +202,6 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild #: interactions.api.models.message.Message #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread @@ -222,7 +218,8 @@ msgstr "" #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Parameters" msgstr "" @@ -230,6 +227,7 @@ msgstr "" msgid "Gets the channel where the message was sent." msgstr "" +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Embed.add_field #: interactions.api.models.message.Embed.clear_fields #: interactions.api.models.message.Embed.insert_field_at @@ -241,13 +239,10 @@ msgstr "" #: interactions.api.models.message.Embed.set_image #: interactions.api.models.message.Embed.set_thumbnail #: interactions.api.models.message.Embed.set_video -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread #: interactions.api.models.message.Message.delete +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_channel #: interactions.api.models.message.Message.get_from_url @@ -307,7 +302,7 @@ msgstr "" #: interactions.api.models.message.Message.edit:13 #: interactions.api.models.message.Message.reply:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.message.Message.edit:15 @@ -323,10 +318,9 @@ msgid "" "components will be removed" msgstr "" -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Message.create_thread +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_from_url #: interactions.api.models.message.Message.get_users_from_reaction @@ -466,6 +460,14 @@ msgstr "" msgid "The URL of said message" msgstr "" +#: interactions.api.models.message.Message.disable_all_components:1 of +msgid "Sets all components to disabled on this message." +msgstr "" + +#: interactions.api.models.message.Message.disable_all_components:3 of +msgid "The modified message." +msgstr "" + #: interactions.api.models.message.MessageReference:1 of msgid "A class object representing the \"referenced\"/replied message." msgstr "" @@ -654,20 +656,26 @@ msgstr "" msgid "Inserts a field in the embed at the specified index" msgstr "" -#: interactions.api.models.message.Embed.insert_field_at:3 -#: interactions.api.models.message.Embed.remove_field:3 -#: interactions.api.models.message.Embed.set_field_at:3 of -msgid "The new field's index" +#: interactions.api.models.message.Embed.insert_field_at:3 of +msgid "The field's index to insert" msgstr "" #: interactions.api.models.message.Embed.set_field_at:1 of msgid "Overwrites the field in the embed at the specified index" msgstr "" +#: interactions.api.models.message.Embed.set_field_at:3 of +msgid "The field's index to overwrite" +msgstr "" + #: interactions.api.models.message.Embed.remove_field:1 of msgid "Remove field at the specified index" msgstr "" +#: interactions.api.models.message.Embed.remove_field:3 of +msgid "The field's index to remove" +msgstr "" + #: interactions.api.models.message.Embed.remove_author:1 of msgid "Removes the embed's author" msgstr "" @@ -906,95 +914,12 @@ msgstr "" msgid "Whether the attachment is ephemeral." msgstr "" -#: interactions.api.models.message.Emoji:1 of -msgid "A class objecting representing an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji:3 of -msgid "Emoji id" -msgstr "" - -#: interactions.api.models.message.Emoji:4 of -msgid "Emoji name." -msgstr "" - -#: interactions.api.models.message.Emoji:5 of -msgid "Roles allowed to use this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:6 of -msgid "User that created this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:7 of -msgid "Status denoting of this emoji must be wrapped in colons" -msgstr "" - -#: interactions.api.models.message.Emoji:8 of -msgid "Status denoting if this emoji is managed (by an integration)" -msgstr "" - -#: interactions.api.models.message.Emoji:9 of -msgid "Status denoting if this emoji is animated" -msgstr "" - -#: interactions.api.models.message.Emoji:10 of -msgid "" -"Status denoting if this emoji can be used. (Can be false via server " -"boosting)" -msgstr "" - -#: interactions.api.models.message.Emoji.get:1 of -msgid "Gets an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.get:3 of -msgid "The id of the guild of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:5 of -msgid "The id of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:7 -#: interactions.api.models.message.Emoji.get_all_of_guild:5 of -msgid "The HTTPClient of your bot. Equals to ``bot._http``" -msgstr "" - -#: interactions.api.models.message.Emoji.get:9 of -msgid "The Emoji as object" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:1 of -msgid "Gets all emoji of a guild." +#: interactions.api.models.message.Attachment.download:1 of +msgid "Downloads the attachment." msgstr "" -#: interactions.api.models.message.Emoji.get_all_of_guild:3 of -msgid "The id of the guild to get the emojis of" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:7 of -msgid "The Emoji as list" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:1 of -msgid "Deletes the emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.delete:3 of -msgid "The guild id to delete the emoji from" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:5 of -msgid "The reason of the deletion" -msgstr "" - -#: interactions.api.models.message.Emoji.url:1 of -msgid "Returns the emoji's URL." -msgstr "" - -#: interactions.api.models.message.Emoji.url:3 of -msgid "URL of the emoji" +#: interactions.api.models.message.Attachment.download:3 of +msgid "The attachment's bytes as BytesIO object" msgstr "" #: interactions.api.models.message.EmbedFooter:1 of @@ -1093,3 +1018,116 @@ msgstr "" #: interactions.api.models.message.Sticker:14 of msgid "The standard sticker's sort order within its pack" msgstr "" + +#: interactions.api.models.message.StickerPack:1 of +msgid "A class objects representing a pack of stickers." +msgstr "" + +#: interactions.api.models.message.StickerPack:3 of +msgid "ID of the sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:4 of +msgid "The stickers in the pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:5 of +msgid "The name of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:6 of +msgid "ID of the pack's SKU." +msgstr "" + +#: interactions.api.models.message.StickerPack:7 of +msgid "ID of a sticker in the pack which is shown as the pack's icon." +msgstr "" + +#: interactions.api.models.message.StickerPack:8 of +msgid "The description of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:9 of +msgid "ID of the sticker pack's banner image." +msgstr "" + +#~ msgid "The allowed mentions of roles attached in the message." +#~ msgstr "" + +#~ msgid "Components associated with this message, if any." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The new field's index" +#~ msgstr "" + +#~ msgid "A class objecting representing an emoji." +#~ msgstr "" + +#~ msgid "Emoji id" +#~ msgstr "" + +#~ msgid "Emoji name." +#~ msgstr "" + +#~ msgid "Roles allowed to use this emoji" +#~ msgstr "" + +#~ msgid "User that created this emoji" +#~ msgstr "" + +#~ msgid "Status denoting of this emoji must be wrapped in colons" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is managed (by an integration)" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is animated" +#~ msgstr "" + +#~ msgid "" +#~ "Status denoting if this emoji can " +#~ "be used. (Can be false via server" +#~ " boosting)" +#~ msgstr "" + +#~ msgid "Gets an emoji." +#~ msgstr "" + +#~ msgid "The id of the guild of the emoji" +#~ msgstr "" + +#~ msgid "The id of the emoji" +#~ msgstr "" + +#~ msgid "The HTTPClient of your bot. Equals to ``bot._http``" +#~ msgstr "" + +#~ msgid "The Emoji as object" +#~ msgstr "" + +#~ msgid "Gets all emoji of a guild." +#~ msgstr "" + +#~ msgid "The id of the guild to get the emojis of" +#~ msgstr "" + +#~ msgid "The Emoji as list" +#~ msgstr "" + +#~ msgid "Deletes the emoji." +#~ msgstr "" + +#~ msgid "The guild id to delete the emoji from" +#~ msgstr "" + +#~ msgid "The reason of the deletion" +#~ msgstr "" + +#~ msgid "Returns the emoji's URL." +#~ msgstr "" + +#~ msgid "URL of the emoji" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.models.misc.po b/docs/locale/es/LC_MESSAGES/api.models.misc.po index cfed122db..77ec620aa 100644 --- a/docs/locale/es/LC_MESSAGES/api.models.misc.po +++ b/docs/locale/es/LC_MESSAGES/api.models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.misc.rst:4 msgid "Miscellanous Models" @@ -27,6 +27,7 @@ msgstr "" msgid "An enumeration." msgstr "" +#: interactions.api.models.misc.AllowedMentionType #: interactions.api.models.misc.AutoModKeywordPresetTypes #: interactions.api.models.misc.AutoModTriggerType of msgid "Member Type" @@ -37,6 +38,7 @@ msgstr "" msgid ":py:class:`int`" msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 #: interactions.api.models.misc.AutoModKeywordPresetTypes:1 #: interactions.api.models.misc.AutoModTriggerType:1 of msgid "Valid values are as follows:" @@ -50,6 +52,7 @@ msgstr "" msgid "The maximum duration for duration_seconds is 2419200 seconds, aka 4 weeks." msgstr "" +#: interactions.api.models.misc.AllowedMentions #: interactions.api.models.misc.AutoModAction #: interactions.api.models.misc.AutoModMetaData #: interactions.api.models.misc.AutoModTriggerMetadata @@ -66,15 +69,6 @@ msgstr "" msgid "Timeout duration in seconds, if timed out." msgstr "" -#: interactions.api.models.misc.AutoModAction -#: interactions.api.models.misc.AutoModMetaData -#: interactions.api.models.misc.AutoModTriggerMetadata -#: interactions.api.models.misc.ClientStatus interactions.api.models.misc.File -#: interactions.api.models.misc.Image interactions.api.models.misc.Overwrite -#: interactions.api.models.misc.Snowflake of -msgid "Parameters" -msgstr "" - #: interactions.api.models.misc.AutoModAction:1 of msgid "" "A class object used for the ``AUTO_MODERATION_ACTION_EXECUTION`` event. " @@ -107,6 +101,53 @@ msgstr "" msgid "The internally pre-defined wordsets which will be searched for in content." msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "An enumerable object representing the allowed mention types" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:1 of +msgid "A class object representing the allowed mentions object" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:3 of +msgid "" +"Optional[List[AllowedMentionType]]: An array of allowed mention types to " +"parse from the content." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:4 of +msgid "Optional[List[int]]: An array of user ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:5 of +msgid "Optional[List[int]]: An array of role ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:6 of +msgid "" +"Optional[bool]: For replies, whether to mention the author of the message" +" being replied to." +msgstr "" + #: interactions.api.models.misc.Snowflake:1 of msgid "The Snowflake object." msgstr "" @@ -129,17 +170,6 @@ msgid "" "integer." msgstr "" -#: interactions.api.models.misc.Color.black -#: interactions.api.models.misc.Color.blurple -#: interactions.api.models.misc.Color.fuchsia -#: interactions.api.models.misc.Color.green -#: interactions.api.models.misc.Color.red -#: interactions.api.models.misc.Color.white -#: interactions.api.models.misc.Color.yellow -#: interactions.api.models.misc.Snowflake of -msgid "Return type" -msgstr "" - #: interactions.api.models.misc.Snowflake.increment:1 of msgid "" "This is the 'Increment' portion of the snowflake. This is incremented for" @@ -199,6 +229,16 @@ msgstr "" msgid "Returns a hexadecimal value of the blurple color." msgstr "" +#: interactions.api.models.misc.Color.black +#: interactions.api.models.misc.Color.blurple +#: interactions.api.models.misc.Color.fuchsia +#: interactions.api.models.misc.Color.green +#: interactions.api.models.misc.Color.red +#: interactions.api.models.misc.Color.white +#: interactions.api.models.misc.Color.yellow of +msgid "Return type" +msgstr "" + #: interactions.api.models.misc.Color.green:1 of msgid "Returns a hexadecimal value of the green color." msgstr "" @@ -287,3 +327,6 @@ msgstr "" #: interactions.api.models.misc.Overwrite:6 of msgid "Permission bit set." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.models.presence.po b/docs/locale/es/LC_MESSAGES/api.models.presence.po index 347c24dbc..cfbae19fa 100644 --- a/docs/locale/es/LC_MESSAGES/api.models.presence.po +++ b/docs/locale/es/LC_MESSAGES/api.models.presence.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.presence.rst:4 msgid "Presence Models" @@ -43,15 +43,6 @@ msgstr "" msgid "An array denoting the party's current and max size" msgstr "" -#: interactions.api.models.presence.ClientPresence -#: interactions.api.models.presence.PresenceActivity -#: interactions.api.models.presence.PresenceAssets -#: interactions.api.models.presence.PresenceParty -#: interactions.api.models.presence.PresenceSecrets -#: interactions.api.models.presence.PresenceTimestamp of -msgid "Parameters" -msgstr "" - #: interactions.api.models.presence.PresenceAssets:1 of msgid "A class object representing the assets of a presence." msgstr "" @@ -231,3 +222,6 @@ msgstr "" #: interactions.api.models.presence.ClientPresence:6 of msgid "Whether the client is afk or not." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.models.role.po b/docs/locale/es/LC_MESSAGES/api.models.role.po index c78eeec53..4828e3cfc 100644 --- a/docs/locale/es/LC_MESSAGES/api.models.role.po +++ b/docs/locale/es/LC_MESSAGES/api.models.role.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.role.rst:4 msgid "Role Models" @@ -130,6 +130,12 @@ msgstr "" msgid "RGB color value as integer, defaults to the current value of the role" msgstr "" +#: interactions.api.models.role.Role.modify:9 of +msgid "" +"Bitwise value of the enabled/disabled permissions, defaults to the " +"current value of the role" +msgstr "" + #: interactions.api.models.role.Role.modify:11 of msgid "" "Whether the role should be displayed separately in the sidebar, defaults " diff --git a/docs/locale/es/LC_MESSAGES/api.models.team.po b/docs/locale/es/LC_MESSAGES/api.models.team.po index 2958a4252..36accb3a5 100644 --- a/docs/locale/es/LC_MESSAGES/api.models.team.po +++ b/docs/locale/es/LC_MESSAGES/api.models.team.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.team.rst:4 msgid "Team Models" @@ -51,11 +51,6 @@ msgstr "" msgid "The User ID of the current team owner" msgstr "" -#: interactions.api.models.team.Application interactions.api.models.team.Team -#: interactions.api.models.team.TeamMember of -msgid "Parameters" -msgstr "" - #: interactions.api.models.team.TeamMember:1 of msgid "A class object representing the member of a team." msgstr "" @@ -183,3 +178,6 @@ msgstr "" #: interactions.api.models.team.Application.icon_url of msgid "Return type" msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.models.user.po b/docs/locale/es/LC_MESSAGES/api.models.user.po index 5721c56da..00f10cc86 100644 --- a/docs/locale/es/LC_MESSAGES/api.models.user.po +++ b/docs/locale/es/LC_MESSAGES/api.models.user.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.user.rst:4 msgid "User Models" @@ -94,17 +94,14 @@ msgstr "" msgid "The user's public flags" msgstr "" -#: interactions.api.models.user.User of -msgid "Parameters" -msgstr "" - #: interactions.api.models.user.User.mention:1 of msgid "Returns a string that allows you to mention the given user." msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Returns" msgstr "" @@ -114,7 +111,8 @@ msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Return type" msgstr "" @@ -133,3 +131,14 @@ msgstr "" #: interactions.api.models.user.User.banner_url:3 of msgid "URL of the user's banner (None will be returned if no banner is set)" msgstr "" + +#: interactions.api.models.user.User.presence:1 of +msgid "Returns the presence of the user." +msgstr "" + +#: interactions.api.models.user.User.presence:3 of +msgid "Presence of the user (None will be returned if not cached)" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/api.models.webhook.po b/docs/locale/es/LC_MESSAGES/api.models.webhook.po index be10a2fd1..906a172a9 100644 --- a/docs/locale/es/LC_MESSAGES/api.models.webhook.po +++ b/docs/locale/es/LC_MESSAGES/api.models.webhook.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.webhook.rst:4 msgid "Webhook Models" @@ -209,7 +209,7 @@ msgid "embedded ``rich`` content" msgstr "" #: interactions.api.models.webhook.Webhook.execute:18 of -msgid "allowed mentions for the message" +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.webhook.Webhook.execute:20 of @@ -257,3 +257,6 @@ msgstr "" #: interactions.api.models.webhook.WebhookType:1 of msgid "Valid values are as follows:" msgstr "" + +#~ msgid "allowed mentions for the message" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/client.po b/docs/locale/es/LC_MESSAGES/client.po index 854019fc5..48424e61c 100644 --- a/docs/locale/es/LC_MESSAGES/client.po +++ b/docs/locale/es/LC_MESSAGES/client.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../client.rst:4 msgid "Bot Client" @@ -31,10 +31,6 @@ msgstr "" #: interactions.client.bot.Client #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence @@ -44,6 +40,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.user_command #: interactions.client.bot.Extension of msgid "Parameters" @@ -80,60 +77,73 @@ msgid "" "automatic or not." msgstr "" +#: interactions.client.bot.Client:15 of +msgid "" +"Set to ``True`` to enable debug logging or set to a log level to use a " +"specific level" +msgstr "" + #: interactions.client.bot.Client of msgid "Variables" msgstr "" -#: interactions.client.bot.Client:16 of +#: interactions.client.bot.Client:18 of msgid "The asynchronous event loop of the client." msgstr "" -#: interactions.client.bot.Client:17 of +#: interactions.client.bot.Client:19 of msgid "" "The user-facing HTTP connection to the Web API, as its own separate " "client." msgstr "" -#: interactions.client.bot.Client:18 of +#: interactions.client.bot.Client:20 of msgid "An object-orientation of a websocket server connection to the Gateway." msgstr "" -#: interactions.client.bot.Client:19 of +#: interactions.client.bot.Client:21 of msgid "The Gateway intents of the application. Defaults to ``Intents.DEFAULT``." msgstr "" -#: interactions.client.bot.Client:20 of +#: interactions.client.bot.Client:22 of msgid "The list of bucketed shards for the application's connection." msgstr "" -#: interactions.client.bot.Client:21 of +#: interactions.client.bot.Client:23 of msgid "The RPC-like presence shown on an application once connected." msgstr "" -#: interactions.client.bot.Client:22 of +#: interactions.client.bot.Client:24 of msgid "The token of the application used for authentication when connecting." msgstr "" -#: interactions.client.bot.Client:23 of +#: interactions.client.bot.Client:25 of msgid "The \"extensions\" or cog equivalence registered to the main client." msgstr "" -#: interactions.client.bot.Client:24 of +#: interactions.client.bot.Client:26 of msgid "The application representation of the client." msgstr "" -#: interactions.client.bot.Client +#: interactions.client.bot.Client.guilds:1 of +msgid "Returns a list of guilds the bot is in." +msgstr "" + +#: interactions.client.bot.Client.latency:1 of +msgid "Returns the connection latency in milliseconds." +msgstr "" + +#: interactions.client.bot.Client.start:1 of +msgid "Starts the client session." +msgstr "" + #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create -#: interactions.client.bot.Client.__register_events #: interactions.client.bot.Client.__resolve_commands #: interactions.client.bot.Client.__sync #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client._login interactions.client.bot.Client._ready +#: interactions.client.bot.Client._stop #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence #: interactions.client.bot.Client.command @@ -142,6 +152,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.start #: interactions.client.bot.Client.user_command #: interactions.client.bot.Client.wait_until_ready @@ -149,22 +160,6 @@ msgstr "" msgid "Return type" msgstr "" -#: interactions.client.bot.Client.guilds:1 of -msgid "Returns a list of guilds the bot is in." -msgstr "" - -#: interactions.client.bot.Client.latency:1 of -msgid "Returns the connection latency in milliseconds." -msgstr "" - -#: interactions.client.bot.Client.start:1 of -msgid "Starts the client session." -msgstr "" - -#: interactions.client.bot.Client.__register_events:1 of -msgid "Registers all raw gateway events to the known events." -msgstr "" - #: interactions.client.bot.Client.__compare_sync:1 of msgid "Compares an application command during the synchronization process." msgstr "" @@ -178,10 +173,6 @@ msgid "The \"pool\" or list of commands to compare from." msgstr "" #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.command @@ -204,6 +195,10 @@ msgid "" "conditions have been met in a chronological order:" msgstr "" +#: interactions.client.bot.Client._stop:1 of +msgid "Stops the websocket connection gracefully." +msgstr "" + #: interactions.client.bot.Client._login:1 of msgid "Makes a login with the Discord API." msgstr "" @@ -448,7 +443,7 @@ msgid "" msgstr "" #: interactions.client.bot.Client._find_command:3 of -msgid "The name of the command to match" +msgid "The name or ID of the command to match" msgstr "" #: interactions.client.bot.Client._find_command:5 of @@ -574,59 +569,34 @@ msgstr "" msgid "The modified User object" msgstr "" -#: interactions.client.bot.Client.__raw_socket_create:1 of -msgid "" -"This is an internal function that takes any gateway socket event and then" -" returns the data purely based off of what it does in the client " -"instantiation class." -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:5 of -msgid "The data that is returned" -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:7 of -msgid "A dictionary of raw data." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:1 of -msgid "" -"This is an internal function that caches the channel creates when " -"dispatched." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:3 of -msgid "The channel object data in question." +#: interactions.client.bot.Client.request_guild_members:1 of +msgid "Requests guild members via websocket." msgstr "" -#: interactions.client.bot.Client.__raw_channel_create:5 of -msgid "The channel as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:3 of +msgid "ID of the guild to get members for." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:1 of +#: interactions.client.bot.Client.request_guild_members:5 of msgid "" -"This is an internal function that caches the message creates when " -"dispatched." +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:3 of -msgid "The message object data in question." +#: interactions.client.bot.Client.request_guild_members:7 of +msgid "String that username starts with." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:5 of -msgid "The message as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:1 of -msgid "This is an internal function that caches the guild creates on ready." +#: interactions.client.bot.Client.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:3 of -msgid "The guild object data in question." -msgstr "" - -#: interactions.client.bot.Client.__raw_guild_create:5 of -msgid "The guild as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." msgstr "" #: interactions.client.bot.Extension:1 of @@ -639,3 +609,56 @@ msgstr "" #: interactions.client.bot.Extension:5 of msgid "The structure of an extension:" msgstr "" + +#~ msgid "Registers all raw gateway events to the known events." +#~ msgstr "" + +#~ msgid "The name of the command to match" +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "takes any gateway socket event and " +#~ "then returns the data purely based " +#~ "off of what it does in the " +#~ "client instantiation class." +#~ msgstr "" + +#~ msgid "The data that is returned" +#~ msgstr "" + +#~ msgid "A dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the channel creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The channel object data in question." +#~ msgstr "" + +#~ msgid "The channel as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the message creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The message object data in question." +#~ msgstr "" + +#~ msgid "The message as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "This is an internal function that caches the guild creates on ready." +#~ msgstr "" + +#~ msgid "The guild object data in question." +#~ msgstr "" + +#~ msgid "The guild as a dictionary of raw data." +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/context.po b/docs/locale/es/LC_MESSAGES/context.po index 3917f5b73..8352a5d3e 100644 --- a/docs/locale/es/LC_MESSAGES/context.po +++ b/docs/locale/es/LC_MESSAGES/context.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../context.rst:4 msgid "Event Context" @@ -55,7 +55,6 @@ msgstr "" msgid "The guild data model." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update #: interactions.client.context.CommandContext #: interactions.client.context.CommandContext.defer #: interactions.client.context.CommandContext.edit @@ -63,12 +62,15 @@ msgstr "" #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context #: interactions.client.context._Context.edit +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup -#: interactions.client.context._Context.send of +#: interactions.client.context._Context.send +#: interactions.utils.attrs_utils.DictSerializerMixin.update of msgid "Parameters" msgstr "" @@ -79,11 +81,13 @@ msgstr "" #: interactions.client.context.CommandContext.edit #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.send of msgid "Returns" msgstr "" @@ -98,11 +102,13 @@ msgstr "" #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup #: interactions.client.context._Context.send of msgid "Return type" @@ -153,7 +159,7 @@ msgstr "" #: interactions.client.context.CommandContext.send:12 #: interactions.client.context.ComponentContext.send:12 #: interactions.client.context._Context.send:12 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.client.context.CommandContext.send:14 @@ -171,6 +177,12 @@ msgstr "" #: interactions.client.context.CommandContext.send:18 #: interactions.client.context.ComponentContext.send:18 #: interactions.client.context._Context.send:18 of +msgid "Whether embeds are not shown in the message." +msgstr "" + +#: interactions.client.context.CommandContext.send:20 +#: interactions.client.context.ComponentContext.send:20 +#: interactions.client.context._Context.send:20 of msgid "The sent message as an object." msgstr "" @@ -197,13 +209,39 @@ msgstr "" msgid "The components you wish to show." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:1 of +#: interactions.client.context._Context.has_permissions:1 of +msgid "" +"Returns whether the author of the interaction has the permissions in the " +"given context." +msgstr "" + +#: interactions.client.context._Context.has_permissions:3 of +msgid "The list of permissions" +msgstr "" + +#: interactions.client.context._Context.has_permissions:5 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.client.context._Context.has_permissions:7 of +msgid "Whether the author has the permissions" +msgstr "" + +#: ../../docstring interactions.client.context.CommandContext._extras:1 +#: interactions.client.context.ComponentContext._extras:1 +#: interactions.client.context._Context._extras:1 of +msgid "A dict containing values that were not serialized from Discord." +msgstr "" + +#: interactions.utils.attrs_utils.DictSerializerMixin.update:1 of msgid "" "Update an object with new attributes. All data will be converted, and any" " extra attributes will be put in _extras" msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:4 of +#: interactions.utils.attrs_utils.DictSerializerMixin.update:4 of msgid "The dictionary to update from" msgstr "" @@ -286,6 +324,18 @@ msgid "" " was sent from." msgstr "" +#: interactions.client.context.CommandContext:30 of +msgid "The client instance that the command belongs to." +msgstr "" + +#: interactions.client.context.CommandContext:31 of +msgid "The command object that is being invoked." +msgstr "" + +#: interactions.client.context.CommandContext:32 of +msgid "The extension the command belongs to." +msgstr "" + #: interactions.client.context.CommandContext.defer:1 of msgid "" "This \"defers\" an interaction response, allowing up to a 15-minute delay" @@ -342,3 +392,31 @@ msgstr "" #: interactions.client.context.ComponentContext.defer:6 of msgid "Whether you want to edit the original message or send a followup message" msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:1 of +msgid "Disables all components of the message." +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:3 of +msgid "" +"Whether the components should be disabled in an interaction response, " +"default True" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:5 of +msgid "" +"Additional keyword-arguments to pass to the edit method. This only works " +"when this method is used as interaction response and takes the same " +"arguments as :meth:`interactions.client.context._Context:edit()`" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:8 of +msgid "The modified Message" +msgstr "" + +#: interactions.client.context.ComponentContext.label:1 of +msgid "The label of the interacted button. :rtype: Optional[str]" +msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/events.po b/docs/locale/es/LC_MESSAGES/events.po index b91a1dc02..7b4ecba7d 100644 --- a/docs/locale/es/LC_MESSAGES/events.po +++ b/docs/locale/es/LC_MESSAGES/events.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../events.rst:2 msgid "Event Documentation" @@ -98,99 +98,104 @@ msgid "``on_command``" msgstr "" #: ../../events.rst:57 -msgid "``on_component``" +msgid "``on_command_error``" msgstr "" #: ../../events.rst:58 -msgid "``on_autocomplete``" +msgid "``on_component``" msgstr "" #: ../../events.rst:59 +msgid "``on_autocomplete``" +msgstr "" + +#: ../../events.rst:60 msgid "``on_modal``" msgstr "" -#: ../../events.rst:61 +#: ../../events.rst:62 msgid "Lets now have a look at those events in detail:" msgstr "" -#: ../../events.rst:64 +#: ../../events.rst:65 msgid "Event: ``raw_socket_create``" msgstr "" -#: ../../events.rst:65 +#: ../../events.rst:66 msgid "" "This event fires on any event sent by Discord, including ``Typing Start``" " and ``Voice State Update``. ``Hello``, ``Resumed``, ``Reconnect`` and " "``Invalid Session`` still will not be dispatched." msgstr "" -#: ../../events.rst:68 +#: ../../events.rst:69 msgid "" -"The function handling the event should take in one argument, the type of " -"this argument is a ``dict``." +"A function handling an event should take two arguments, the first " +"argument is the name of the event, the second is the data of that event " +"with type ``dict``." msgstr "" -#: ../../events.rst:70 +#: ../../events.rst:72 msgid "" -"The value of the argument will be the *raw* data sent from Discord, so it" -" is not recommended to use that event as long as you don't absolutely " -"need it." +"The value of the second argument will be the *raw* data sent from " +"Discord, so it is not recommended to use that event as long as you don't " +"absolutely need it." msgstr "" -#: ../../events.rst:75 +#: ../../events.rst:77 msgid "Event: ``on_start``" msgstr "" -#: ../../events.rst:76 +#: ../../events.rst:78 msgid "This event fires only when the bot is started." msgstr "" -#: ../../events.rst:78 ../../events.rst:161 +#: ../../events.rst:80 ../../events.rst:173 msgid "This function takes no arguments." msgstr "" -#: ../../events.rst:81 +#: ../../events.rst:83 msgid "Unlike ``on_ready``, this event will never be dispatched more than once." msgstr "" -#: ../../events.rst:84 +#: ../../events.rst:86 msgid "Event: ``on_interaction``" msgstr "" -#: ../../events.rst:85 +#: ../../events.rst:87 msgid "" "This event fires on any interaction (commands, components, autocomplete " "and modals)." msgstr "" -#: ../../events.rst:87 +#: ../../events.rst:89 msgid "" "The function needs one argument. It will have the type ``CommandContext``" " or ``ComponentContext``." msgstr "" -#: ../../events.rst:89 +#: ../../events.rst:91 msgid "" "Because you will have to check for everything, from the " "``InteractionType`` to any data inside the context, we do not recommend " "using this event unless you have experience with it." msgstr "" -#: ../../events.rst:94 +#: ../../events.rst:96 msgid "Event: ``on_command``" msgstr "" -#: ../../events.rst:95 +#: ../../events.rst:97 msgid "" "This event fires on any Application Command (slash command + context menu" " command) used." msgstr "" -#: ../../events.rst:97 ../../events.rst:117 ../../events.rst:127 +#: ../../events.rst:99 ../../events.rst:129 ../../events.rst:139 msgid "The function takes in one argument of the type ``CommandContext``." msgstr "" -#: ../../events.rst:99 +#: ../../events.rst:101 msgid "" "Using this event, you will have to manually check everything, from name " "to whether the used commands have sub commands, options or anything else " @@ -198,138 +203,174 @@ msgid "" "it" msgstr "" -#: ../../events.rst:104 +#: ../../events.rst:106 +msgid "Event: ``on_command_error``" +msgstr "" + +#: ../../events.rst:107 +msgid "This event fires when the following conditions are met:" +msgstr "" + +#: ../../events.rst:109 +msgid "There is an error in the command (or subcommand within the command)" +msgstr "" + +#: ../../events.rst:110 +msgid "There is no error callback assigned to that command" +msgstr "" + +#: ../../events.rst:112 +msgid "" +"The function takes in two arguments, one of the type ``CommandContext``, " +"and the other contains the error." +msgstr "" + +#: ../../events.rst:116 msgid "Event: ``on_component``" msgstr "" -#: ../../events.rst:105 +#: ../../events.rst:117 msgid "" "This event fires on any Component used (for now, those are Buttons and " "Select Menus)." msgstr "" -#: ../../events.rst:107 +#: ../../events.rst:119 msgid "The function takes in one argument of the type ``ComponentContext``." msgstr "" -#: ../../events.rst:109 +#: ../../events.rst:121 msgid "" "Like ``on_command``, you will have to manually check for everything, i.e " "for custom id and component type. Also, you will have to look through the" " argument to find the selected choices, if you have a select menu." msgstr "" -#: ../../events.rst:114 +#: ../../events.rst:126 msgid "Event: ``on_autocomplete``" msgstr "" -#: ../../events.rst:115 +#: ../../events.rst:127 msgid "This event fires on any autocomplete triggered." msgstr "" -#: ../../events.rst:119 +#: ../../events.rst:131 msgid "" "As already in the events above, you will have to get the important values" " yourself. Those values are here the autocompleted option and the user " "input." msgstr "" -#: ../../events.rst:124 +#: ../../events.rst:136 msgid "Event: ``on_modal``" msgstr "" -#: ../../events.rst:125 +#: ../../events.rst:137 msgid "This event fires on every modal that is submitted." msgstr "" -#: ../../events.rst:129 +#: ../../events.rst:141 msgid "" "You will have to get all values yourself and check what modal was used " "when using this event." msgstr "" -#: ../../events.rst:132 +#: ../../events.rst:144 msgid "" "Additionally, if you struggle with getting the values, you can check " ":ref:`how it is handled internally `." msgstr "" -#: ../../events.rst:136 +#: ../../events.rst:148 msgid "After this, let us look at events from the Discord API." msgstr "" -#: ../../events.rst:139 +#: ../../events.rst:151 msgid "Discord API Events" msgstr "" -#: ../../events.rst:141 +#: ../../events.rst:153 msgid "" "Events in this section do not match the name needed to put into the " "function. Please check :ref:`above ` for how to get the correct name." msgstr "" -#: ../../events.rst:145 +#: ../../events.rst:157 msgid "" "There are a lot of events dispatched by the Discord API. All of those can" " be found `here`_." msgstr "" -#: ../../events.rst:147 +#: ../../events.rst:159 msgid "" "The events ``HELLO``, ``RESUMED``, ``RECONNECT``, ``INVALID SESSION`` and" " ``TYPING START`` are not dispatched by the library." msgstr "" -#: ../../events.rst:149 +#: ../../events.rst:161 msgid "" "``TYPING START`` will be included in the raw socket create event. You can" " also listen for it if you choose to subclass the WebSocketClient" msgstr "" -#: ../../events.rst:152 +#: ../../events.rst:164 msgid "" "The event ``VOICE STATE UPDATE`` can be only received with the voice " ":ref:`Extension `." msgstr "" -#: ../../events.rst:155 +#: ../../events.rst:167 msgid "Let's now have a look at a few events:" msgstr "" -#: ../../events.rst:158 +#: ../../events.rst:170 msgid "Event: ``READY``" msgstr "" -#: ../../events.rst:159 +#: ../../events.rst:171 msgid "" "This event fires whenever ``READY`` is dispatched by Discord. This " "happens when connecting to the web socket server." msgstr "" -#: ../../events.rst:164 +#: ../../events.rst:176 msgid "" "Due to the bot reconnecting during runtime, ``on_ready`` will be " "dispatched multiple times. If you rely on ``on_ready`` to do certain " "things once, check against a global variable as shown below:" msgstr "" -#: ../../events.rst:181 +#: ../../events.rst:193 msgid "Events: ``GUILD MEMBER UPDATE`` and ``GUILD MEMBER ADD``" msgstr "" -#: ../../events.rst:182 +#: ../../events.rst:194 msgid "" "These events fire whenever a member joins a guild or a member of a guild " "gets modified." msgstr "" -#: ../../events.rst:184 +#: ../../events.rst:196 msgid "The function takes in one argument of the type ``GuildMember``." msgstr "" -#: ../../events.rst:186 +#: ../../events.rst:198 msgid "" "The argument has the same methods as a normal ``Member`` object, except " "the methods *do not take in a guild id*. Please keep that in mind when " "using this event." msgstr "" + +#~ msgid "" +#~ "The function handling the event should" +#~ " take in one argument, the type " +#~ "of this argument is a ``dict``." +#~ msgstr "" + +#~ msgid "" +#~ "The value of the argument will be" +#~ " the *raw* data sent from Discord," +#~ " so it is not recommended to " +#~ "use that event as long as you " +#~ "don't absolutely need it." +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/faq.po b/docs/locale/es/LC_MESSAGES/faq.po index 1bf421161..09e3ae8c9 100644 --- a/docs/locale/es/LC_MESSAGES/faq.po +++ b/docs/locale/es/LC_MESSAGES/faq.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../faq.rst:2 msgid "Frequently Asked Questions" @@ -283,12 +283,12 @@ msgstr "" #: ../../faq.rst:157 msgid "" -"A `voice client`_ - which is still WIP, but it is able to listen for the " +"`voice client`_ - which is still WIP, but it is able to listen for the " "``VOICE_STATE_UPDATE`` event." msgstr "" #: ../../faq.rst:158 -msgid "An `autosharder`_ for automatic sharding" +msgid "`autosharder`_ for automatic sharding" msgstr "" #: ../../faq.rst:159 @@ -310,146 +310,148 @@ msgid "`enhanced`_ which enhances the DX in general" msgstr "" #: ../../faq.rst:163 -msgid "A `paginator`_ for paginating embeds on messages using components" +msgid "`paginator`_ for paginating embeds on messages using components" msgstr "" #: ../../faq.rst:164 msgid "" -"`persistence`_ - for storing data inside your custom IDs (as an " -"alternative to ``wait_for``)" +"`persistence`_ for storing data inside your custom IDs (as an alternative" +" to ``wait_for``)" msgstr "" #: ../../faq.rst:165 -msgid "And a `boilerplate`_" +msgid "`lavalink`_ for voice sending and listening ``VOICE_STATE_UPDATE`` event" +msgstr "" + +#: ../../faq.rst:166 +msgid "`fastapi`_ for building own API" msgstr "" #: ../../faq.rst:167 +msgid "And a `boilerplate`_" +msgstr "" + +#: ../../faq.rst:169 msgid "" "Below are a few unofficial exts (for the time being) which implement some" " functionality similar to what d.py had:" msgstr "" -#: ../../faq.rst:169 +#: ../../faq.rst:171 msgid "`checks and cooldowns`_" msgstr "" -#: ../../faq.rst:170 +#: ../../faq.rst:172 msgid "`tasks`_" msgstr "" -#: ../../faq.rst:171 -msgid "" -"`get`_ for getting objects from the discord API (will be implemented into" -" the core library at a later time)" -msgstr "" - -#: ../../faq.rst:173 +#: ../../faq.rst:174 msgid "Usage examples can usually be found at the linked page" msgstr "" -#: ../../faq.rst:177 +#: ../../faq.rst:178 msgid "Can I make an Extension Library myself?" msgstr "" -#: ../../faq.rst:178 +#: ../../faq.rst:179 msgid "" "Yeah, you can! We have a special channel reserved for the development of " "external libraries! You can also read `this `_ for more information." msgstr "" -#: ../../faq.rst:183 +#: ../../faq.rst:184 msgid "" "I'm getting \"``AttributeError: HTTPClient not found!``\" when I try to " "execute helper methods!" msgstr "" -#: ../../faq.rst:184 +#: ../../faq.rst:185 msgid "Probably you are doing something like this:" msgstr "" -#: ../../faq.rst:191 +#: ../../faq.rst:192 msgid "" "And the error occurs in the line where you try to send something. You can" " fix this easy by adding one argument:" msgstr "" -#: ../../faq.rst:198 +#: ../../faq.rst:199 msgid "" "You have to add this extra argument for every object you instantiate by " "yourself if you want to use it's methods" msgstr "" -#: ../../faq.rst:202 +#: ../../faq.rst:203 msgid "" "Context and Messages don't have the ``Channel`` and ``Guild`` attributes!" " Why?" msgstr "" -#: ../../faq.rst:203 +#: ../../faq.rst:204 msgid "" "At the moment the Discord API does *not* include them into their " "responses. You can get those object via the ``get_channel()`` and " "``get_guild()`` methods of the Context and Message model." msgstr "" -#: ../../faq.rst:208 +#: ../../faq.rst:209 msgid "\"``ctx.send got an unexpected keyword argument: files``\"! Why?" msgstr "" -#: ../../faq.rst:209 +#: ../../faq.rst:210 msgid "" "It is not supported due to an decision of the core developer team. There " "are two ways to do it:" msgstr "" -#: ../../faq.rst:212 +#: ../../faq.rst:213 msgid "Using ``await channel.send`` instead" msgstr "" -#: ../../faq.rst:213 +#: ../../faq.rst:214 msgid "Using the `files`_ extension" msgstr "" -#: ../../faq.rst:217 +#: ../../faq.rst:218 msgid "\"``ctx.send got an unexpected keyword argument: embed``\"! Why?" msgstr "" -#: ../../faq.rst:218 +#: ../../faq.rst:219 msgid "" "This is quite simple: The argument ``embed`` got deprecated by Discord. " "The new naming is ``embeds``." msgstr "" -#: ../../faq.rst:222 +#: ../../faq.rst:223 msgid "How can I check what exception happened during a request?" msgstr "" -#: ../../faq.rst:223 +#: ../../faq.rst:224 msgid "We, unlike d.py, do not offer something like ``interactions.NotFound``." msgstr "" -#: ../../faq.rst:225 +#: ../../faq.rst:226 msgid "Instead you have to do it like this:" msgstr "" -#: ../../faq.rst:228 +#: ../../faq.rst:229 msgid "" "This feature will be implemented with version 4.3 and is currently only " "available on beta/unstable" msgstr "" -#: ../../faq.rst:242 +#: ../../faq.rst:243 msgid "" "You can additionally get the exact reason for why the exception occurred " "with ``e.message`` or ``e.lookup(e.code)``" msgstr "" -#: ../../faq.rst:246 +#: ../../faq.rst:247 msgid "My message content is always empty! How can I fix this?" msgstr "" -#: ../../faq.rst:247 +#: ../../faq.rst:248 msgid "" "This happens because you did not enable the intent for message content. " "Enable it on the developer portal and add it into the ``Client`` " @@ -459,11 +461,11 @@ msgid "" "``Intents.DEFAULT``, it can be any other intent(s) you need!" msgstr "" -#: ../../faq.rst:254 +#: ../../faq.rst:255 msgid "Is there something like ``Cogs``?" msgstr "" -#: ../../faq.rst:255 +#: ../../faq.rst:256 msgid "" "Yes! Although, we call them ``Extensions``. Yeah, like :ref:`Extension " "Libraries `. This is because an extension " @@ -471,39 +473,39 @@ msgid "" "how you create an extension for yourself:" msgstr "" -#: ../../faq.rst:283 +#: ../../faq.rst:284 msgid "It's nothing more than that." msgstr "" -#: ../../faq.rst:285 +#: ../../faq.rst:286 msgid "" "Since ``@bot.X`` decorators don't work in extensions, you have to use " "these:" msgstr "" -#: ../../faq.rst:287 +#: ../../faq.rst:288 msgid "For event listeners, use ``@interactions.extension_listener``" msgstr "" -#: ../../faq.rst:288 +#: ../../faq.rst:289 msgid "For component listeners, use ``@interactions.extension_component``" msgstr "" -#: ../../faq.rst:289 +#: ../../faq.rst:290 msgid "For modal listeners, use ``@interactions.extension_modal``" msgstr "" -#: ../../faq.rst:290 +#: ../../faq.rst:291 msgid "For autocomplete listeners, use ``@interactions.extension_autocomplete``" msgstr "" -#: ../../faq.rst:294 +#: ../../faq.rst:295 msgid "" "``channel.members`` does not exist, how do I get the people in a voice " "channel?" msgstr "" -#: ../../faq.rst:295 +#: ../../faq.rst:296 msgid "" "``channel.members`` actually does exist, but is reserved for threads. " "There is no attribute for people in a voice channel by the API. The only " @@ -512,12 +514,37 @@ msgid "" " updated when a member joins or leaves." msgstr "" -#: ../../faq.rst:301 +#: ../../faq.rst:302 msgid "My question is not answered on here!" msgstr "" -#: ../../faq.rst:302 +#: ../../faq.rst:303 msgid "" "Please join our `Discord Server`_ for any further support regarding our " "library and/or any integration code depending on it." msgstr "" + +#~ msgid "" +#~ "A `voice client`_ - which is still" +#~ " WIP, but it is able to listen" +#~ " for the ``VOICE_STATE_UPDATE`` event." +#~ msgstr "" + +#~ msgid "An `autosharder`_ for automatic sharding" +#~ msgstr "" + +#~ msgid "A `paginator`_ for paginating embeds on messages using components" +#~ msgstr "" + +#~ msgid "" +#~ "`persistence`_ - for storing data inside" +#~ " your custom IDs (as an alternative" +#~ " to ``wait_for``)" +#~ msgstr "" + +#~ msgid "" +#~ "`get`_ for getting objects from the " +#~ "discord API (will be implemented into" +#~ " the core library at a later " +#~ "time)" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/index.po b/docs/locale/es/LC_MESSAGES/index.po index 91465f9df..d7a1d6841 100644 --- a/docs/locale/es/LC_MESSAGES/index.po +++ b/docs/locale/es/LC_MESSAGES/index.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../index.rst:47 msgid "Pages:" @@ -51,7 +51,7 @@ msgstr "" #: ../../index.rst:11 msgid "" "Look no more! The goal of this library is to make all three of these " -"questions go from possibilites to trivial matters." +"questions go from possibilities to trivial matters." msgstr "" #: ../../index.rst:14 @@ -181,7 +181,7 @@ msgid "**black** ``22.6.0``" msgstr "" #: ../../index.rst:66 -msgid "**flake8** ``4.0.1``" +msgid "**flake8** ``5.0.4``" msgstr "" #: ../../index.rst:67 @@ -190,7 +190,7 @@ msgstr "" #: ../../index.rst:69 msgid "" -"**Sphinx** ``4.4.0``: all of our documentation is powered off of " +"**Sphinx** ``5.1.1``: all of our documentation is powered off of " "autogenerated documentation of the Sphinx engine." msgstr "" @@ -247,3 +247,20 @@ msgstr "" #: ../../index.rst:88 msgid ":ref:`modindex`" msgstr "" + +#~ msgid "" +#~ "Look no more! The goal of this " +#~ "library is to make all three of" +#~ " these questions go from possibilites " +#~ "to trivial matters." +#~ msgstr "" + +#~ msgid "**flake8** ``4.0.1``" +#~ msgstr "" + +#~ msgid "" +#~ "**Sphinx** ``4.4.0``: all of our " +#~ "documentation is powered off of " +#~ "autogenerated documentation of the Sphinx " +#~ "engine." +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/migration.po b/docs/locale/es/LC_MESSAGES/migration.po index 9f0d8e6aa..3546c747d 100644 --- a/docs/locale/es/LC_MESSAGES/migration.po +++ b/docs/locale/es/LC_MESSAGES/migration.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../migration.rst:2 msgid "Migration" @@ -126,7 +126,9 @@ msgid "" msgstr "" #: ../../migration.rst:99 -msgid "You can get more information by reading the `get-documentation`_." +msgid "" +"You can get more information by reading the " +":meth:`interactions.client.get.get`-documentation" msgstr "" #: ../../migration.rst:102 @@ -148,3 +150,6 @@ msgid "" "your argument in your function differently than your option name! " "Example:" msgstr "" + +#~ msgid "You can get more information by reading the `get-documentation`_." +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/models.command.po b/docs/locale/es/LC_MESSAGES/models.command.po index 5c72da5b0..a7fca335f 100644 --- a/docs/locale/es/LC_MESSAGES/models.command.po +++ b/docs/locale/es/LC_MESSAGES/models.command.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.command.rst:4 msgid "Application Command Models" @@ -37,8 +37,10 @@ msgid "The structure for a choice:" msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission of msgid "Variables" @@ -56,13 +58,14 @@ msgstr "" #: interactions.client.models.command.Command:16 #: interactions.client.models.command.Command.group:28 #: interactions.client.models.command.Command.subcommand:33 -#: interactions.client.models.command.Option:34 of +#: interactions.client.models.command.Option:36 of msgid "" "The dictionary of localization for the ``name`` field. This enforces the " "same restrictions as the ``name`` field." msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command #: interactions.client.models.command.Command.__call @@ -72,6 +75,7 @@ msgstr "" #: interactions.client.models.command.Command.error #: interactions.client.models.command.Command.group #: interactions.client.models.command.Command.subcommand +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission #: interactions.client.models.command.option of @@ -100,8 +104,7 @@ msgstr "" msgid "The type of option." msgstr "" -#: interactions.client.models.command.Option:23 -#: interactions.client.models.command.option:14 of +#: interactions.client.models.command.Option:23 of msgid "The name of the option." msgstr "" @@ -142,19 +145,27 @@ msgid "The maximum value supported by the option." msgstr "" #: interactions.client.models.command.Option:33 of +msgid "The minimum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:34 of +msgid "The maximum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:35 of msgid "A status denoting whether this option is an autocomplete option." msgstr "" #: interactions.client.models.command.Command:17 #: interactions.client.models.command.Command.group:30 #: interactions.client.models.command.Command.subcommand:35 -#: interactions.client.models.command.Option:35 of +#: interactions.client.models.command.Option:37 of msgid "" "The dictionary of localization for the ``description`` field. This " "enforces the same restrictions as the ``description`` field." msgstr "" -#: interactions.client.models.command.Option:36 of +#: interactions.client.models.command.Option:38 of msgid "How the option value is passed to the function, if different than ``name``" msgstr "" @@ -248,18 +259,26 @@ msgid "A decorator for adding options to a command." msgstr "" #: interactions.client.models.command.option:3 of -msgid "The structure of an option:" +msgid "" +"The ``type`` and ``name`` of the option are defaulted to the parameter's " +"typehint and name." +msgstr "" + +#: interactions.client.models.command.option:5 of +msgid "" +"When the ``name`` of the option differs from the parameter name, the " +"``converter`` field will default to the name of the parameter." msgstr "" -#: interactions.client.models.command.option:12 of -msgid "The type of the option." +#: interactions.client.models.command.option:8 of +msgid "The structure of an option:" msgstr "" -#: interactions.client.models.command.option:16 of -msgid "The description of the option. Defaults to ``\"No description set\"``." +#: interactions.client.models.command.option:17 of +msgid "The description of the option. Defaults to \"No description set\"." msgstr "" -#: interactions.client.models.command.option:18 of +#: interactions.client.models.command.option:19 of msgid "The keyword arguments of the option, same as :class:`Option`." msgstr "" @@ -283,6 +302,8 @@ msgstr "" msgid "A class that when returned from a command, the command chain is stopped." msgstr "" +#: interactions.client.models.command.BaseResult:3 +#: interactions.client.models.command.GroupResult:3 #: interactions.client.models.command.StopCommand:3 of msgid "Usage:" msgstr "" @@ -291,6 +312,32 @@ msgstr "" msgid "This allows for custom checks that allow stopping the command chain." msgstr "" +#: interactions.client.models.command.BaseResult:1 +#: interactions.client.models.command.GroupResult:1 of +msgid "A class object representing the result of the base command." +msgstr "" + +#: interactions.client.models.command.BaseResult:17 of +msgid "" +"If the subcommand coroutine does not have enough parameters, the " +"``BaseResult`` will not be passed." +msgstr "" + +#: interactions.client.models.command.BaseResult:19 +#: interactions.client.models.command.GroupResult:25 of +msgid "The result of the base command." +msgstr "" + +#: interactions.client.models.command.GroupResult:23 of +msgid "" +"If the subcommand does not have enough arguments, the ``GroupResult`` " +"will not be passed." +msgstr "" + +#: interactions.client.models.command.GroupResult:26 of +msgid "The parent ``BaseResult``." +msgstr "" + #: interactions.client.models.command.Command:1 of msgid "A class object representing a command." msgstr "" @@ -364,6 +411,14 @@ msgstr "" msgid "The extension that the command belongs to, if any." msgstr "" +#: interactions.client.models.command.Command:26 of +msgid "The client that the command belongs to." +msgstr "" + +#: interactions.client.models.command.Command:27 of +msgid "The listener, used for dispatching command errors." +msgstr "" + #: interactions.client.models.command.Command.converters:1 of msgid "" "Returns a dictionary with all converters added to the options of the " @@ -525,3 +580,9 @@ msgid "" ":class:`interactions.client.bot.Extension` is passed to the coroutine, if" " any." msgstr "" + +#~ msgid "The type of the option." +#~ msgstr "" + +#~ msgid "The description of the option. Defaults to ``\"No description set\"``." +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/models.component.po b/docs/locale/es/LC_MESSAGES/models.component.po index ae186054c..ce3834826 100644 --- a/docs/locale/es/LC_MESSAGES/models.component.po +++ b/docs/locale/es/LC_MESSAGES/models.component.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.component.rst:4 msgid "Component Models" @@ -257,36 +257,18 @@ msgid "The maximum length of the input." msgstr "" #: interactions.client.models.component.Modal:1 of -msgid "A class object representing a modal." +msgid "A class object representing a modal. The structure for a modal: ::" msgstr "" -#: interactions.client.models.component.Modal:8 of -msgid "The structure for a modal: ::" -msgstr "" - -#: interactions.client.models.component.Modal:6 of -msgid "interactions.Modal(" -msgstr "" - -#: interactions.client.models.component.Modal:5 of -msgid "" -"title=\"Application Form\", custom_id=\"mod_app_form\", " -"components=[interactions.TextInput(...)]," -msgstr "" - -#: interactions.client.models.component.Modal:8 of -msgid ")" -msgstr "" - -#: interactions.client.models.component.Modal:10 of +#: interactions.client.models.component.Modal:9 of msgid "The custom ID of the modal." msgstr "" -#: interactions.client.models.component.Modal:11 of +#: interactions.client.models.component.Modal:10 of msgid "The title of the modal." msgstr "" -#: interactions.client.models.component.Modal:12 of +#: interactions.client.models.component.Modal:11 of msgid "The components of the modal." msgstr "" @@ -302,22 +284,22 @@ msgid "" " also support only 1 text input component only." msgstr "" -#: interactions.client.models.component.ActionRow:13 of -msgid "The structure for an action row: ::" +#: interactions.client.models.component.ActionRow:8 of +msgid "The structure for an action row: ..code-block:: python" msgstr "" -#: interactions.client.models.component.ActionRow:9 of +#: interactions.client.models.component.ActionRow:10 of msgid "" "# \"...\" represents a component object. # Method 1: " "interactions.ActionRow(...) # Method 2: " "interactions.ActionRow(components=[...])" msgstr "" -#: interactions.client.models.component.ActionRow:15 of +#: interactions.client.models.component.ActionRow:16 of msgid "The type of component. Always defaults to ``1``." msgstr "" -#: interactions.client.models.component.ActionRow:16 of +#: interactions.client.models.component.ActionRow:17 of msgid "A list of components the ActionRow has, if any." msgstr "" @@ -340,3 +322,23 @@ msgstr "" #: interactions.client.models.component.ActionRow.new of msgid "Return type" msgstr "" + +#~ msgid "A class object representing a modal." +#~ msgstr "" + +#~ msgid "The structure for a modal: ::" +#~ msgstr "" + +#~ msgid "interactions.Modal(" +#~ msgstr "" + +#~ msgid "" +#~ "title=\"Application Form\", custom_id=\"mod_app_form\"," +#~ " components=[interactions.TextInput(...)]," +#~ msgstr "" + +#~ msgid ")" +#~ msgstr "" + +#~ msgid "The structure for an action row: ::" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/models.misc.po b/docs/locale/es/LC_MESSAGES/models.misc.po index 9ea8f4346..31ef0b3e5 100644 --- a/docs/locale/es/LC_MESSAGES/models.misc.po +++ b/docs/locale/es/LC_MESSAGES/models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.misc.rst:4 msgid "Miscellaneous Models" @@ -56,12 +56,6 @@ msgstr "" msgid "The resolved attachments data." msgstr "" -#: interactions.client.models.misc.Interaction -#: interactions.client.models.misc.InteractionData -#: interactions.client.models.misc.InteractionResolvedData of -msgid "Parameters" -msgstr "" - #: interactions.client.models.misc.InteractionData:1 of msgid "A class object representing the data of an interaction." msgstr "" @@ -102,6 +96,10 @@ msgstr "" msgid "The targeted ID of the interaction." msgstr "" +#: interactions.client.models.misc.InteractionData:12 of +msgid "Array of Action Rows in modal." +msgstr "" + #: interactions.client.models.misc.Interaction:1 of msgid "A class object representing an interaction." msgstr "" @@ -149,3 +147,6 @@ msgstr "" #: interactions.client.models.misc.Interaction:13 of msgid "The message of the interaction." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/quickstart.po b/docs/locale/es/LC_MESSAGES/quickstart.po index 89ed78f26..76b3670dc 100644 --- a/docs/locale/es/LC_MESSAGES/quickstart.po +++ b/docs/locale/es/LC_MESSAGES/quickstart.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:08-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../quickstart.rst:2 msgid "Quickstart" @@ -28,10 +28,11 @@ msgstr "" #: ../../quickstart.rst:7 msgid "" -"**discord-interactions** is a :ref:`Python library ` for the Discord Application Programming Interface. (API) A" -" library in Python has to be installed through the `pip` file. Run this " -"in your terminal/command line in order to install our library:" +"**discord-interactions** is a :ref:`Python library " +"` for the Discord Application Programming " +"Interface. (API) A library in Python has to be installed through the " +"`pip` file. Run this in your terminal/command line in order to install " +"our library:" msgstr "" #: ../../quickstart.rst:11 @@ -308,109 +309,116 @@ msgid "" msgstr "" #: ../../quickstart.rst:208 -msgid "" -"The first field in the ``@option()`` decorator is the type of the option." -" This is positional only and required. You can use integers, the default " -"Python types, the ``OptionType`` enum, or supported objects such as " -"``interactions.Channel``." +msgid "All arguments in the decorator are keyword arguments only." msgstr "" #: ../../quickstart.rst:209 -msgid "All other arguments in the decorator are keyword arguments only." +msgid "" +"The ``type`` and ``name`` fields default to the typehint and the name of " +"the parameter." msgstr "" #: ../../quickstart.rst:210 -msgid "The ``name`` field is required." +msgid "" +"The ``description`` field is optional and defaults to ``\"No description " +"set``." msgstr "" #: ../../quickstart.rst:211 msgid "" -"The ``description`` field is optional and defaults to ``\"No description " -"set``." +"The ``required`` field defaults to whether the default for the parameter " +"is empty." msgstr "" #: ../../quickstart.rst:212 msgid "" +"For typehinting or inputting the ``type`` field, you can use integers, " +"the default Python types, the ``OptionType`` enum, or supported objects " +"such as ``interactions.Channel``." +msgstr "" + +#: ../../quickstart.rst:213 +msgid "" "Any parameters from ``Option`` can be passed into the ``@option()`` " "decorator." msgstr "" -#: ../../quickstart.rst:215 +#: ../../quickstart.rst:216 msgid "The limit for options per command is 25." msgstr "" -#: ../../quickstart.rst:218 +#: ../../quickstart.rst:219 msgid "Nested commands: subcommands" msgstr "" -#: ../../quickstart.rst:220 +#: ../../quickstart.rst:221 msgid "" "Subcommands are options that are nested to create subcategories of " "commands." msgstr "" -#: ../../quickstart.rst:222 +#: ../../quickstart.rst:223 msgid "Here is the structure of a subcommand:" msgstr "" -#: ../../quickstart.rst:265 +#: ../../quickstart.rst:266 msgid "You can also create subcommands using the command system:" msgstr "" -#: ../../quickstart.rst:291 +#: ../../quickstart.rst:292 msgid "You can add a SUB_COMMAND_GROUP in between the base and command." msgstr "" -#: ../../quickstart.rst:294 +#: ../../quickstart.rst:295 msgid "Additional information about subcommands" msgstr "" -#: ../../quickstart.rst:296 +#: ../../quickstart.rst:297 msgid "" "Base commands are returned the :ref:`Command ` object. From this, you can utilize the following " "decorators:" msgstr "" -#: ../../quickstart.rst:299 +#: ../../quickstart.rst:300 msgid "" ":ref:`@subcommand() `: creates" " a subcommand." msgstr "" -#: ../../quickstart.rst:300 +#: ../../quickstart.rst:301 msgid "" ":ref:`@group() `: creates a " "group." msgstr "" -#: ../../quickstart.rst:301 +#: ../../quickstart.rst:302 msgid "" ":ref:`@error `: registers an " "error callback." msgstr "" -#: ../../quickstart.rst:303 +#: ../../quickstart.rst:304 msgid "Check the documentation for the parameters of each of these decorators." msgstr "" -#: ../../quickstart.rst:305 +#: ../../quickstart.rst:306 msgid "The following is an example of a base command:" msgstr "" -#: ../../quickstart.rst:313 +#: ../../quickstart.rst:314 msgid "The examples below will be using the base command above." msgstr "" -#: ../../quickstart.rst:315 +#: ../../quickstart.rst:316 msgid "The following is an example of a subcommand of the base command:" msgstr "" -#: ../../quickstart.rst:323 +#: ../../quickstart.rst:324 msgid "This code results in the following subcommand: `/base_command subcommand`." msgstr "" -#: ../../quickstart.rst:326 +#: ../../quickstart.rst:327 msgid "" "You can use the ``base_res`` parameter in groups and subcommands, and " "``group_res`` in subcommands inside groups to access the result of the " @@ -418,50 +426,50 @@ msgid "" "``ctx`` parameter." msgstr "" -#: ../../quickstart.rst:329 +#: ../../quickstart.rst:330 msgid "The following is an example of a group with subcommands:" msgstr "" -#: ../../quickstart.rst:341 +#: ../../quickstart.rst:342 msgid "" "You can have multiple groups, with multiple subcommands in each group. " "Subcommands and groups are options, so the same restrictions apply." msgstr "" -#: ../../quickstart.rst:344 +#: ../../quickstart.rst:345 msgid "Create any subcommands without groups *before* creating any groups." msgstr "" -#: ../../quickstart.rst:346 +#: ../../quickstart.rst:347 msgid "" "Since there are multiple coroutines involved that each get executed, you " "may be wondering how you can stop the chain. Luckily, there is a way:" msgstr "" -#: ../../quickstart.rst:360 +#: ../../quickstart.rst:361 msgid "This works on both groups and subcommands." msgstr "" -#: ../../quickstart.rst:362 +#: ../../quickstart.rst:363 msgid "The following is an example of an error callback:" msgstr "" -#: ../../quickstart.rst:378 +#: ../../quickstart.rst:379 msgid "" "The parameters ``ctx`` and ``error`` are required, but you can have more " "parameters, such as ``*args`` and ``**kwargs``, if you need to access " "options." msgstr "" -#: ../../quickstart.rst:382 +#: ../../quickstart.rst:383 msgid "You can have one error callback per command." msgstr "" -#: ../../quickstart.rst:385 +#: ../../quickstart.rst:386 msgid "Special type of commands: Context menus" msgstr "" -#: ../../quickstart.rst:387 +#: ../../quickstart.rst:388 msgid "" "While, granted that application commands are way more intuitive and " "easier to work with as both a bot developer and user from a UX approach, " @@ -472,39 +480,39 @@ msgid "" " right-click actions with menial effort." msgstr "" -#: ../../quickstart.rst:393 +#: ../../quickstart.rst:394 msgid "" "In order to create a menu-based command, all you need to do is simply add" " this one line into your ``@command`` decorator:" msgstr "" -#: ../../quickstart.rst:406 +#: ../../quickstart.rst:407 msgid "Here is an alternate way of creating a context menu:" msgstr "" -#: ../../quickstart.rst:415 +#: ../../quickstart.rst:416 msgid "" "The structure of a menu command differs significantly from that of a " "regular one:" msgstr "" -#: ../../quickstart.rst:417 +#: ../../quickstart.rst:418 msgid "You cannot have any options or choices." msgstr "" -#: ../../quickstart.rst:418 +#: ../../quickstart.rst:419 msgid "You cannot have a description." msgstr "" -#: ../../quickstart.rst:419 +#: ../../quickstart.rst:420 msgid "The ``name`` filter follows a different regex pattern." msgstr "" -#: ../../quickstart.rst:422 +#: ../../quickstart.rst:423 msgid "Creating and sending Components" msgstr "" -#: ../../quickstart.rst:424 +#: ../../quickstart.rst:425 msgid "" "Being able to run your own commands is very useful for a lot of " "automation-related purposes as a bot developer, however, we also have " @@ -513,14 +521,14 @@ msgid "" "components." msgstr "" -#: ../../quickstart.rst:429 +#: ../../quickstart.rst:430 msgid "" "Components are ways of being able to select pre-defined data, or define " "your own. They're very simple but quite powerful when put into practice " "This code block below shows a simplified implementation of a component:" msgstr "" -#: ../../quickstart.rst:455 +#: ../../quickstart.rst:456 msgid "" "This is a design that we ended up choosing to simplify responding to " "buttons when someone presses on one, and to allow bot developers to plug " @@ -530,11 +538,11 @@ msgid "" "modularity." msgstr "" -#: ../../quickstart.rst:462 +#: ../../quickstart.rst:463 msgid "What kinds of components are there?" msgstr "" -#: ../../quickstart.rst:464 +#: ../../quickstart.rst:465 msgid "" "As a bot developer, this may be fairly important for you to want to know." " Different components provide difference user experiences, interactions " @@ -543,18 +551,18 @@ msgid "" "able to `find these component types`_ here." msgstr "" -#: ../../quickstart.rst:471 +#: ../../quickstart.rst:472 msgid "How do I send components in a row?" msgstr "" -#: ../../quickstart.rst:473 +#: ../../quickstart.rst:474 msgid "" "You are also able to organize these components into rows, which are " "defined as ``ActionRow``'s. It is worth noting that you can have only a " "maximum of 5 per message that you send. This code block below shows how:" msgstr "" -#: ../../quickstart.rst:505 +#: ../../quickstart.rst:506 msgid "" "By default, the ``components`` keyword-argument field in the context " "sending method will always support ``ActionRow``-less sending: you only " @@ -563,57 +571,57 @@ msgid "" "class objects instead." msgstr "" -#: ../../quickstart.rst:511 +#: ../../quickstart.rst:512 msgid "" "You cannot use ``TextInput`` with the above shown method. Look :ref:`here" " ` how to create and send them." msgstr "" -#: ../../quickstart.rst:516 +#: ../../quickstart.rst:517 msgid "Creating a TextInput" msgstr "" -#: ../../quickstart.rst:517 +#: ../../quickstart.rst:518 msgid "You want to get a Text from a user? You can use ``TextInput`` for that." msgstr "" -#: ../../quickstart.rst:529 +#: ../../quickstart.rst:530 msgid "" "But how to send it? You can't use ``ctx.send`` for it. Take a look at " ":ref:`Modals ` for that." msgstr "" -#: ../../quickstart.rst:533 +#: ../../quickstart.rst:534 msgid "Modals" msgstr "" -#: ../../quickstart.rst:534 +#: ../../quickstart.rst:535 msgid "" "Modals are a new way to interact with a user. Currently only a " "``TextInput`` component is supported. You can have up to five " "``TextInput`` in a Modal." msgstr "" -#: ../../quickstart.rst:547 +#: ../../quickstart.rst:548 msgid "with the ``TextInput`` example from above we get:" msgstr "" -#: ../../quickstart.rst:552 +#: ../../quickstart.rst:553 msgid "Responding to a Modal interaction" msgstr "" -#: ../../quickstart.rst:560 +#: ../../quickstart.rst:561 msgid "" "You can respond to a modal the same way as you would respond to a normal " "``chat-input`` command, except your function has an extra argument for " "the text what was put into the modal." msgstr "" -#: ../../quickstart.rst:563 +#: ../../quickstart.rst:564 msgid "Adding v2 Permissions" msgstr "" -#: ../../quickstart.rst:565 +#: ../../quickstart.rst:566 msgid "" "v2 permissions consist of the ``default_member_permissions`` and " "``dm_permission`` keyword arguments. Similar to adding privileged " @@ -621,55 +629,87 @@ msgid "" "etc.) as follows:" msgstr "" -#: ../../quickstart.rst:604 +#: ../../quickstart.rst:605 msgid "" "Adding guild-only commands is easier as the only thing it takes is a " "boolean. Here's an example of a guild-only command:" msgstr "" -#: ../../quickstart.rst:623 +#: ../../quickstart.rst:624 msgid "" "Likewise, setting ``dm_permission`` to ``True`` makes it usable in DMs. " "Just to note that this argument's mainly used for global commands. Guild " "commands with this argument will have no effect." msgstr "" -#: ../../quickstart.rst:627 +#: ../../quickstart.rst:628 msgid "Utilities" msgstr "" -#: ../../quickstart.rst:629 +#: ../../quickstart.rst:630 msgid "You can use the following utilities to help you with your commands:" msgstr "" -#: ../../quickstart.rst:631 +#: ../../quickstart.rst:632 msgid "``ActionRow.new()``: Creates a new ``ActionRow`` object." msgstr "" -#: ../../quickstart.rst:632 +#: ../../quickstart.rst:633 msgid "``spread_to_rows()``: Spreads a list of components into a list of rows." msgstr "" -#: ../../quickstart.rst:633 +#: ../../quickstart.rst:634 msgid "" "``@autodefer()``: Automatically defers a command if it did not respond " "within the specified time." msgstr "" -#: ../../quickstart.rst:635 +#: ../../quickstart.rst:636 msgid "" -"Look at their documentation :ref:`here ` for " -"more information." +"Look at their documentation :ref:`here ` for more " +"information." msgstr "" -#: ../../quickstart.rst:637 +#: ../../quickstart.rst:638 msgid "Usage of ``ActionRow.new()``:" msgstr "" -#: ../../quickstart.rst:653 +#: ../../quickstart.rst:654 msgid "Usage of ``spread_to_rows()``:" msgstr "" -#: ../../quickstart.rst:675 +#: ../../quickstart.rst:676 msgid "Usage of ``@autodefer()``:" msgstr "" + +#~ msgid "" +#~ "**discord-interactions** is a :ref:`Python " +#~ "library ` for the" +#~ " Discord Application Programming Interface. " +#~ "(API) A library in Python has to" +#~ " be installed through the `pip` file." +#~ " Run this in your terminal/command " +#~ "line in order to install our " +#~ "library:" +#~ msgstr "" + +#~ msgid "" +#~ "The first field in the ``@option()`` " +#~ "decorator is the type of the " +#~ "option. This is positional only and " +#~ "required. You can use integers, the " +#~ "default Python types, the ``OptionType`` " +#~ "enum, or supported objects such as " +#~ "``interactions.Channel``." +#~ msgstr "" + +#~ msgid "All other arguments in the decorator are keyword arguments only." +#~ msgstr "" + +#~ msgid "The ``name`` field is required." +#~ msgstr "" + +#~ msgid "" +#~ "Look at their documentation :ref:`here " +#~ "` for more information." +#~ msgstr "" diff --git a/docs/locale/es/LC_MESSAGES/utils.po b/docs/locale/es/LC_MESSAGES/utils.po new file mode 100644 index 000000000..2968b6970 --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/utils.po @@ -0,0 +1,361 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../utils.rst:4 +msgid "The ``get`` utility method" +msgstr "" + +#: interactions.utils.get.get:1 of +msgid "Helper method to get an object." +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "This method can do the following:" +msgstr "" + +#: interactions.utils.get.get:6 of +msgid "Get a list of specific objects" +msgstr "" + +#: interactions.utils.get.get:5 interactions.utils.get.get:9 of +msgid "purely from cache" +msgstr "" + +#: interactions.utils.get.get:6 interactions.utils.get.get:10 of +msgid "purely from HTTP" +msgstr "" + +#: interactions.utils.get.get:7 of +msgid "" +"from cache and additionally from HTTP for every ID that was not found in " +"cache" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "Get a single specific object" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "from HTTP if not found in cache else from cache" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "The method has to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "You don't force anything" +msgstr "" + +#: interactions.utils.get.get:15 of +msgid "You force HTTP" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "The method doesn't have to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "You force cache" +msgstr "" + +#: interactions.utils.get.get:20 of +msgid "" +"Technically, there is no need for an ``await`` if there is an object " +"found in the cache. Because of the fact, that, as long as you don't " +"enforce the cache, the function will get the object from HTTP, if it is " +"not in the cache, you still have to await it. This has been done to " +"reduce confusion on whether the object origins from an HTTP call or a " +"cache result and to remove the extra step for you to check if the " +"returned object is an awaitable or not." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing:" +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing can be done via the ``force`` keyword argument." +msgstr "" + +#: interactions.utils.get.get:31 of +msgid "``force=\"cache\"`` or ``force=interactions.Force.CACHE``:" +msgstr "" + +#: interactions.utils.get.get:30 of +msgid "" +"This forces the method to only return from cache (if the object is not " +"found it will return ``None``). If you use this, you don't need to await " +"the method." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "``force=\"http\"`` or ``force=interactions.Force.HTTP``:" +msgstr "" + +#: interactions.utils.get.get:34 of +msgid "" +"This forces the method to make an HTTP request to the discord API and " +"return the result of it. If you use this, you have to await the method." +msgstr "" + +#: interactions.utils.get.get:38 of +msgid "" +"If you are a PyCharm user, please be aware of a bug that causes incorrect" +" suggestions to appear if using an enum. Even if PyCharm shows a normal " +"object as result, you have to await the method if you enforce HTTP. To " +"prevent this bug from happening it is suggested using ``force=\"http\"`` " +"instead of the enum." +msgstr "" + +#: interactions.utils.get.get:43 of +msgid "Getting an object:" +msgstr "" + +#: interactions.utils.get.get:45 of +msgid "" +"Here you will see two examples on how to get a single objects and the " +"variations of how the object can be gotten." +msgstr "" + +#: interactions.utils.get.get:48 of +msgid "Example 1/2: Getting a Channel:" +msgstr "" + +#: interactions.utils.get.get:65 of +msgid "Example 2/2: Getting a Member:" +msgstr "" + +#: interactions.utils.get.get:88 of +msgid "" +"Both examples should have given you a basic overview on how to get a " +"single object. Now we will move on with lists of objects." +msgstr "" + +#: interactions.utils.get.get:92 of +msgid "" +"The ``parent_id`` represents the channel or guild id that belongs to the " +"objects you want to get. It is called ``parent_id`` because " +"``guild_or_channel_id`` would be horrible to type out every time." +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "Getting a list of an object:" +msgstr "" + +#: interactions.utils.get.get:96 of +msgid "" +"Here you will see 1 example of how to get a list of objects. The " +"possibilities on how to force (and their results) are the same as in the " +"examples above." +msgstr "" + +#: interactions.utils.get.get:99 of +msgid "Example 1/1: Getting a list of members:" +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "" +"If you enforce cache when getting a list of objects, found objets will be" +" placed into the list and not found objects will be placed as ``None`` " +"into the list." +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Parameters" +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Return type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "An enumerable object representing the force types for the get method." +msgstr "" + +#: interactions.utils.get.Force of +msgid "Variables" +msgstr "" + +#: interactions.utils.get.Force:3 of +msgid "Enforce the usage of cache and block the usage of http" +msgstr "" + +#: interactions.utils.get.Force:4 of +msgid "Enforce the usage of http and block the usage of cache" +msgstr "" + +#: interactions.utils.get.Force of +msgid "Member Type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: ../../utils.rst:10 +msgid "Utilities" +msgstr "" + +#: interactions.utils.utils.autodefer:1 of +msgid "" +"A decorator that automatically defers a command if it did not respond " +"within ``delay`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:3 of +msgid "The structure of the decorator is:" +msgstr "" + +#: interactions.utils.utils.autodefer:13 of +msgid "" +"The amount of time in seconds to wait before defering the command. " +"Defaults to ``2`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:15 of +msgid "Whether the command is deferred ephemerally. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer:17 of +msgid "Whether the command is deferred on origin. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable of +msgid "Returns" +msgstr "" + +#: interactions.utils.utils.autodefer:19 of +msgid "The inner function, for decorating." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:1 of +msgid "A helper function that spreads components into :class:`ActionRow` s." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:3 of +msgid "Example:" +msgstr "" + +#: interactions.utils.utils.spread_to_rows:24 of +msgid "" +"You can only pass in :class:`ActionRow`s, :class:`Button`s, and " +":class:`SelectMenu`s, but in any order." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:26 of +msgid "The components to spread." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:28 of +msgid "The maximum number of components in a single row. Defaults to ``5``." +msgstr "" + +#: interactions.utils.utils.search_iterable:1 of +msgid "" +"Searches through an iterable for items that: - Are True for the check, if" +" one is given - Have attributes that match the keyword arguments (e.x. " +"passing `id=your_id` will only return objects with that id)" +msgstr "" + +#: interactions.utils.utils.search_iterable:5 of +msgid "The iterable to search through" +msgstr "" + +#: interactions.utils.utils.search_iterable:7 of +msgid "The check that items will be checked against" +msgstr "" + +#: interactions.utils.utils.search_iterable:9 of +msgid "Any attributes the items should have" +msgstr "" + +#: interactions.utils.utils.search_iterable:11 of +msgid "All items that match the check and keywords" +msgstr "" + +#: interactions.utils.utils.disable_components:1 of +msgid "Disables the given components." +msgstr "" + +#: interactions.utils.utils.disable_components:3 of +msgid "The components to disable" +msgstr "" + +#: interactions.utils.utils.get_channel_history:1 of +msgid "Gets the history of a channel." +msgstr "" + +#: interactions.utils.utils.get_channel_history:3 of +msgid "The HTTPClient of the bot or your bot instance" +msgstr "" + +#: interactions.utils.utils.get_channel_history:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:7 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:9 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.utils.utils.get_channel_history:11 of +msgid "A check to ignore specific messages" +msgstr "" + +#: interactions.utils.utils.get_channel_history:13 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.utils.utils.get_channel_history:16 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.dispatch.po b/docs/locale/fr/LC_MESSAGES/api.dispatch.po index 2b020e27a..18a4ff864 100644 --- a/docs/locale/fr/LC_MESSAGES/api.dispatch.po +++ b/docs/locale/fr/LC_MESSAGES/api.dispatch.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.dispatch.rst:4 msgid "Dispatching" @@ -38,12 +38,6 @@ msgstr "" msgid "A list of events being dispatched." msgstr "" -#: interactions.api.dispatch.Listener -#: interactions.api.dispatch.Listener.dispatch -#: interactions.api.dispatch.Listener.register of -msgid "Return type" -msgstr "" - #: interactions.api.dispatch.Listener.dispatch:1 of msgid "Dispatches an event given out by the gateway." msgstr "" @@ -83,3 +77,6 @@ msgstr "" #: interactions.api.dispatch.Listener.register:9 of msgid "The name to associate the coroutine with. Defaults to None." msgstr "" + +#~ msgid "Return type" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.gateway.po b/docs/locale/fr/LC_MESSAGES/api.gateway.po index aad9d8772..22e00a8ed 100644 --- a/docs/locale/fr/LC_MESSAGES/api.gateway.po +++ b/docs/locale/fr/LC_MESSAGES/api.gateway.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.gateway.rst:4 msgid "Gateway" @@ -36,121 +36,169 @@ msgid "" "WebSocket." msgstr "" +#: interactions.api.gateway.client.WebSocketClient:4 of +msgid "" +"The ``__heartbeat_event`` Event object is different from the one built in" +" to the Heartbeater object. The latter is used to trace heartbeat " +"acknowledgement." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient of msgid "Variables" msgstr "" -#: interactions.api.gateway.client.WebSocketClient:3 of +#: interactions.api.gateway.client.WebSocketClient:7 of msgid "The asynchronous event loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:4 of +#: interactions.api.gateway.client.WebSocketClient:8 of msgid "The built-in event dispatcher." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:5 of +#: interactions.api.gateway.client.WebSocketClient:9 of +msgid "The websocket ratelimiter object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:10 of msgid "The user-facing HTTP client." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:6 of +#: interactions.api.gateway.client.WebSocketClient:11 of msgid "The WebSocket data of the connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:7 of +#: interactions.api.gateway.client.WebSocketClient:12 of msgid "Whether the connection has been closed or not." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:8 of +#: interactions.api.gateway.client.WebSocketClient:13 of msgid "The connection options made during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:9 of +#: interactions.api.gateway.client.WebSocketClient:14 of msgid "The gateway intents used for connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:10 of +#: interactions.api.gateway.client.WebSocketClient:15 of msgid "The contents of the application returned when ready." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:11 of +#: interactions.api.gateway.client.WebSocketClient:16 of msgid "The context state of a \"heartbeat\" made to the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:12 of +#: interactions.api.gateway.client.WebSocketClient:17 of +msgid "The state of the overall heartbeat process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:18 of msgid "The shards used during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:13 of +#: interactions.api.gateway.client.WebSocketClient:19 of msgid "The presence used in connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:14 of +#: interactions.api.gateway.client.WebSocketClient:20 of msgid "The ready state of the client as an ``asyncio.Event``." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:15 of -msgid "The closing task for ending connections." +#: interactions.api.gateway.client.WebSocketClient:21 of +msgid "The task containing the heartbeat manager process." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:16 of +#: interactions.api.gateway.client.WebSocketClient:22 of msgid "Whether the client has started." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:17 of +#: interactions.api.gateway.client.WebSocketClient:23 of msgid "The ID of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:18 of +#: interactions.api.gateway.client.WebSocketClient:24 of msgid "The sequence identifier of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:19 of +#: interactions.api.gateway.client.WebSocketClient:25 of msgid "" "The latest time of the last send_packet function call since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:20 of +#: interactions.api.gateway.client.WebSocketClient:26 of msgid "" "The latest time of the last ``HEARTBEAT_ACK`` event since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:21 of -msgid "The latency of the connection, in seconds." +#: interactions.api.gateway.client.WebSocketClient:27 of +msgid "The Websocket ratelimit URL for resuming connections, if any." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:28 of +msgid "The Websocket URL for instantiating connections without resuming." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:29 of +msgid "The lock used for reconnecting the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:30 of +msgid "The lock used for closing the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:31 of +msgid "The task containing stopping the client, if any." msgstr "" #: interactions.api.gateway.client.WebSocketClient #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__identify +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache #: interactions.api.gateway.client.WebSocketClient.__option_type_context +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection +#: interactions.api.gateway.client.WebSocketClient._handle_stream +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence +#: interactions.api.gateway.client.WebSocketClient.request_guild_members #: interactions.api.gateway.heartbeat._Heartbeat of msgid "Parameters" msgstr "" -#: interactions.api.gateway.client.WebSocketClient +#: interactions.api.gateway.client.WebSocketClient.latency:1 of +msgid "The latency of the connection, in seconds." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat:1 of +msgid "" +"Controls the heartbeat manager. Do note that this shouldn't be executed " +"by outside processes." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__heartbeat #: interactions.api.gateway.client.WebSocketClient.__identify #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream -#: interactions.api.gateway.client.WebSocketClient.__restart +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__resume #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection #: interactions.api.gateway.client.WebSocketClient._manage_heartbeat +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence -#: interactions.api.gateway.client.WebSocketClient.wait_until_ready -#: interactions.api.gateway.heartbeat._Heartbeat of +#: interactions.api.gateway.client.WebSocketClient.close +#: interactions.api.gateway.client.WebSocketClient.request_guild_members +#: interactions.api.gateway.client.WebSocketClient.run +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat +#: interactions.api.gateway.client.WebSocketClient.wait_until_ready of msgid "Return type" msgstr "" @@ -158,29 +206,21 @@ msgstr "" msgid "Manages the heartbeat loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__restart:1 of -msgid "Restart the client's connection and heartbeat with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:1 of -msgid "Establishes a client connection with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:3 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:5 of -msgid "The shards to establish a connection with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient.run:1 of +msgid "Handles the client's connection with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._establish_connection:5 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:7 of -msgid "The presence to carry with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:1 of +msgid "" +"Parses raw stream data recieved from the Gateway, including Gateway " +"opcodes and events." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:1 of -msgid "Handles the client's connection with the Gateway." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:4 of +msgid "This should never be called directly." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:3 of +#: interactions.api.gateway.client.WebSocketClient._handle_stream:6 of msgid "The packet stream to handle." msgstr "" @@ -192,31 +232,68 @@ msgstr "" msgid "Dispatches an event from the Gateway." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:3 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:3 of msgid "The name of the event." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:5 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:5 of msgid "The data for the event." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of -msgid "" -"Takes raw data given back from the Gateway and gives \"context\" based " -"off of what it is." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:1 of +msgid "Gets an ID from object." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of -msgid "The data from the Gateway." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:5 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:7 of +msgid "The object of the event." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:7 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:5 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:9 of +msgid "The model of the event." msgstr "" #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context of msgid "Returns" msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:9 of +msgid "Object ID" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:1 of +msgid "Gets a list of ids of object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:7 of +msgid "Object IDs" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:1 of +msgid "Modifies guild cache." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of +msgid "" +"Takes raw data given back from the Gateway and gives \"context\" based " +"off of what it is." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of +msgid "The data from the Gateway." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize:6 of msgid "The context object." msgstr "" @@ -255,11 +332,15 @@ msgstr "" msgid "The option type context." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:1 of -msgid "Receives a stream of packets sent from the Gateway." +#: interactions.api.gateway.client.WebSocketClient._reconnect:1 of +msgid "Restarts the client's connection and heartbeat with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:3 of +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:1 of +msgid "Receives a stream of packets sent from the Gateway in an async process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:3 of msgid "The packet stream." msgstr "" @@ -311,6 +392,58 @@ msgid "" "disconnect." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:1 of +msgid "Sends an ``REQUEST_MEMBERS`` packet to the gateway." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:3 of +msgid "ID of the guild to get members for." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:5 of +msgid "" +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:7 of +msgid "String that username starts with." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.close:1 of +msgid "Closes the current connection." +msgstr "" + #: interactions.api.gateway.heartbeat._Heartbeat:1 of msgid "An internal class representing the heartbeat in a WebSocket connection." msgstr "" + +#~ msgid "The closing task for ending connections." +#~ msgstr "" + +#~ msgid "Restart the client's connection and heartbeat with the Gateway." +#~ msgstr "" + +#~ msgid "Establishes a client connection with the Gateway." +#~ msgstr "" + +#~ msgid "The shards to establish a connection with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "The presence to carry with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "Receives a stream of packets sent from the Gateway." +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.http.po b/docs/locale/fr/LC_MESSAGES/api.http.po index b141f2d87..fcab462c2 100644 --- a/docs/locale/fr/LC_MESSAGES/api.http.po +++ b/docs/locale/fr/LC_MESSAGES/api.http.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.http.rst:4 msgid "HTTP" @@ -55,10 +55,13 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag #: interactions.api.http.channel.ChannelRequest.delete_channel #: interactions.api.http.channel.ChannelRequest.delete_channel_permission #: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag #: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -75,6 +78,7 @@ msgstr "" #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template @@ -169,6 +173,7 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker #: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread #: interactions.api.http.thread.ThreadRequest.join_thread #: interactions.api.http.thread.ThreadRequest.leave_thread @@ -198,14 +203,19 @@ msgstr "" msgid "Parameters" msgstr "" -#: interactions.api.http.channel.ChannelRequest +#: interactions.api.http.route.Route.get_bucket:1 of +msgid "" +"Returns the route's bucket. If shared_bucket is None, returns the path " +"with major parameters. Otherwise, it relies on Discord's given bucket." +msgstr "" + +#: interactions.api.http.route.Route.get_bucket:4 of +msgid "The bucket that Discord provides, if available." +msgstr "" + #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance -#: interactions.api.http.channel.ChannelRequest.delete_channel -#: interactions.api.http.channel.ChannelRequest.delete_channel_permission -#: interactions.api.http.channel.ChannelRequest.delete_stage_instance -#: interactions.api.http.channel.ChannelRequest.edit_channel_permission #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -214,37 +224,21 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel -#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway -#: interactions.api.http.client.HTTPClient.get_current_authorisation_information -#: interactions.api.http.client.HTTPClient.get_current_bot_information -#: interactions.api.http.client.HTTPClient.get_gateway -#: interactions.api.http.client.HTTPClient.login -#: interactions.api.http.client.HTTPClient.logout -#: interactions.api.http.emoji.EmojiRequest #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji -#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji -#: interactions.api.http.guild.GuildRequest #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template -#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template -#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.delete_guild -#: interactions.api.http.guild.GuildRequest.delete_guild_integration -#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles -#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild -#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -255,28 +249,17 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings -#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild -#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget -#: interactions.api.http.guild.GuildRequest.modify_user_voice_state -#: interactions.api.http.guild.GuildRequest.remove_guild_ban -#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template -#: interactions.api.http.interaction.InteractionRequest -#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command -#: interactions.api.http.interaction.InteractionRequest.create_interaction_response -#: interactions.api.http.interaction.InteractionRequest.delete_application_command -#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -285,46 +268,22 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command -#: interactions.api.http.limiter.Limiter -#: interactions.api.http.member.MemberRequest -#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member -#: interactions.api.http.member.MemberRequest.remove_member_role -#: interactions.api.http.member.MemberRequest.search_guild_members -#: interactions.api.http.message.MessageRequest -#: interactions.api.http.message.MessageRequest.create_message -#: interactions.api.http.message.MessageRequest.delete_message -#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message -#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message -#: interactions.api.http.message.MessageRequest.send_message -#: interactions.api.http.message.MessageRequest.unpin_message -#: interactions.api.http.reaction.ReactionRequest -#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction -#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction -#: interactions.api.http.request._Request -#: interactions.api.http.request._Request._check_lock -#: interactions.api.http.request._Request._check_session -#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request -#: interactions.api.http.route.Route interactions.api.http.route.Route.endpoint +#: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket -#: interactions.api.http.scheduledEvent.ScheduledEventRequest #: interactions.api.http.scheduledEvent.ScheduledEventRequest.create_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.delete_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event_users #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events #: interactions.api.http.scheduledEvent.ScheduledEventRequest.modify_scheduled_event -#: interactions.api.http.sticker.StickerRequest #: interactions.api.http.sticker.StickerRequest.create_guild_sticker #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker #: interactions.api.http.sticker.StickerRequest.get_guild_sticker @@ -332,53 +291,44 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker -#: interactions.api.http.thread.ThreadRequest -#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread -#: interactions.api.http.thread.ThreadRequest.join_thread -#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members -#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread -#: interactions.api.http.user.UserRequest #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user -#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild -#: interactions.api.http.webhook.WebhookRequest #: interactions.api.http.webhook.WebhookRequest.create_webhook -#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message -#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks -#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Return type" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:1 of -msgid "" -"Returns the route's bucket. If shared_bucket is None, returns the path " -"with major parameters. Otherwise, it relies on Discord's given bucket." +msgid "Returns" msgstr "" -#: interactions.api.http.route.Route.get_bucket:4 of -msgid "The bucket that Discord provides, if available." +#: interactions.api.http.route.Route.get_bucket:7 of +msgid "The route bucket." msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag +#: interactions.api.http.channel.ChannelRequest.delete_channel +#: interactions.api.http.channel.ChannelRequest.delete_channel_permission +#: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag +#: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -387,20 +337,36 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel +#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway +#: interactions.api.http.client.HTTPClient.get_current_authorisation_information +#: interactions.api.http.client.HTTPClient.get_current_bot_information +#: interactions.api.http.client.HTTPClient.get_gateway +#: interactions.api.http.client.HTTPClient.login +#: interactions.api.http.client.HTTPClient.logout #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji +#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template +#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template +#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.delete_guild +#: interactions.api.http.guild.GuildRequest.delete_guild_integration +#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles +#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild +#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -411,17 +377,27 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings +#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild +#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget +#: interactions.api.http.guild.GuildRequest.modify_user_voice_state +#: interactions.api.http.guild.GuildRequest.remove_guild_ban +#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template +#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command +#: interactions.api.http.interaction.InteractionRequest.create_interaction_response +#: interactions.api.http.interaction.InteractionRequest.delete_application_command +#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -430,13 +406,30 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command +#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member +#: interactions.api.http.member.MemberRequest.remove_member_role +#: interactions.api.http.member.MemberRequest.search_guild_members +#: interactions.api.http.message.MessageRequest.create_message +#: interactions.api.http.message.MessageRequest.delete_message +#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message +#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message +#: interactions.api.http.message.MessageRequest.send_message +#: interactions.api.http.message.MessageRequest.unpin_message +#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction +#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction +#: interactions.api.http.request._Request._check_lock +#: interactions.api.http.request._Request._check_session +#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request #: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket @@ -453,31 +446,36 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker +#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread +#: interactions.api.http.thread.ThreadRequest.join_thread +#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members +#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user +#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild #: interactions.api.http.webhook.WebhookRequest.create_webhook +#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message +#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks +#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Returns" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:7 of -msgid "The route bucket." +msgid "Return type" msgstr "" #: interactions.api.http.route.Route.endpoint:1 of @@ -617,9 +615,12 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel_invite:6 #: interactions.api.http.channel.ChannelRequest.create_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.create_tag:7 #: interactions.api.http.channel.ChannelRequest.delete_channel_permission:3 #: interactions.api.http.channel.ChannelRequest.delete_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.delete_tag:3 #: interactions.api.http.channel.ChannelRequest.edit_channel_permission:3 +#: interactions.api.http.channel.ChannelRequest.edit_tag:7 #: interactions.api.http.channel.ChannelRequest.get_channel:3 #: interactions.api.http.channel.ChannelRequest.get_channel_invites:3 #: interactions.api.http.channel.ChannelRequest.get_channel_messages:6 @@ -919,6 +920,51 @@ msgstr "" msgid "Delete a stage instance." msgstr "" +#: interactions.api.http.channel.ChannelRequest.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:4 +#: interactions.api.http.channel.ChannelRequest.edit_tag:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:8 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:9 +#: interactions.api.http.channel.ChannelRequest.edit_tag:10 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:10 +#: interactions.api.http.channel.ChannelRequest.edit_tag:11 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:1 of +msgid "Update a tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:8 of +msgid "The ID of the tag to update." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:1 of +msgid "Delete a forum tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:4 of +msgid "The ID of the tag to delete" +msgstr "" + #: interactions.api.http.emoji.EmojiRequest.get_all_emoji:1 of msgid "Gets all emojis from a guild." msgstr "" @@ -1279,6 +1325,7 @@ msgstr "" msgid "Gets all roles from a Guild." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:3 #: interactions.api.http.guild.GuildRequest.create_guild_ban:3 #: interactions.api.http.guild.GuildRequest.create_guild_kick:3 #: interactions.api.http.guild.GuildRequest.get_all_roles:3 @@ -1374,7 +1421,9 @@ msgid "" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "" +"Number of seconds to delete messages for, between 0 and 604800. Default " +"to 0" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:6 of @@ -1467,20 +1516,36 @@ msgstr "" msgid "Reason to send to audit log, if any." msgstr "" -#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of -msgid "" -"Retrieves a dict from an API that results in how many members would be " -"pruned given the amount of days." +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:1 of +msgid "Begins a prune operation." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:4 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:4 of -msgid "Number of days to count. Defaults to ``7``." +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:5 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:6 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:5 of msgid "Role IDs to include, if given." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:7 of +msgid "A dict containing `{\"pruned\": int}` or `{\"pruned\": None}`" +msgstr "" + +#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of +msgid "" +"Retrieves a dict from an API that results in how many members would be " +"pruned given the amount of days." +msgstr "" + #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:6 of msgid "A dict denoting `{\"pruned\": int}`" msgstr "" @@ -1974,7 +2039,8 @@ msgid "Channel snowflake ID." msgstr "" #: interactions.api.http.message.MessageRequest.create_message:5 -#: interactions.api.http.message.MessageRequest.edit_message:6 of +#: interactions.api.http.message.MessageRequest.edit_message:6 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:9 of msgid "An optional list of files to send attached to the message." msgstr "" @@ -2178,11 +2244,8 @@ msgid "Guild Scheduled Event ID snowflake." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:5 -#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 #: of -msgid "" -"A boolean to include number of users subscribed to the associated event, " -"if given." +msgid "Whether the number of users subscribed to the events is returned." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:6 @@ -2195,6 +2258,13 @@ msgstr "" msgid "Gets all guild scheduled events in a guild." msgstr "" +#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 +#: of +msgid "" +"Whether the number of users subscribed to the associated event is " +"returned." +msgstr "" + #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:5 #: of msgid "" @@ -2307,22 +2377,25 @@ msgid "" "MANAGE_EMOJIS_AND_STICKERS permission." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 -#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of -msgid "the payload to send." +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 of +msgid "The payload to send." msgstr "" #: interactions.api.http.sticker.StickerRequest.create_guild_sticker:4 of +msgid "The file to send." +msgstr "" + +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 of msgid "The guild to create sticker at." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:5 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:6 of msgid "The reason for this action." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 of +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:7 of msgid "The new sticker data on success." msgstr "" @@ -2332,6 +2405,10 @@ msgid "" "permission." msgstr "" +#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of +msgid "the payload to send." +msgstr "" + #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:3 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:4 of msgid "The guild of the target sticker." @@ -2483,15 +2560,18 @@ msgid "" "with.." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:3 of +#: interactions.api.http.thread.ThreadRequest.create_thread:3 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:3 of msgid "The ID of the channel to create this thread in" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:4 of +#: interactions.api.http.thread.ThreadRequest.create_thread:4 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:4 of msgid "The name of the thread" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:5 of +#: interactions.api.http.thread.ThreadRequest.create_thread:5 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:5 of msgid "" "duration in minutes to automatically archive the thread after recent " "activity, can be set to: 60, 1440, 4320, 10080" @@ -2511,7 +2591,8 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:10 of +#: interactions.api.http.thread.ThreadRequest.create_thread:10 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:11 of msgid "An optional reason for the audit log" msgstr "" @@ -2519,6 +2600,28 @@ msgstr "" msgid "The created thread" msgstr "" +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:1 of +msgid "From a given Forum channel, create a Thread with a message to start with." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:7 of +msgid "The payload/dictionary contents of the first message in the forum thread." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:8 of +msgid "List of tag ids that can be applied to the forum, if any." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:10 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:12 of +msgid "Returns a Thread in a Forum object with a starting Message." +msgstr "" + #: interactions.api.http.user.UserRequest.get_self:1 of msgid "An alias to `get_user`, but only gets the current bot user." msgstr "" @@ -2743,3 +2846,15 @@ msgstr "" #: of msgid "Deletes the original message object sent." msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Number of days to count. Defaults to ``7``." +#~ msgstr "" + +#~ msgid "" +#~ "A boolean to include number of " +#~ "users subscribed to the associated " +#~ "event, if given." +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.models.audit_log.po b/docs/locale/fr/LC_MESSAGES/api.models.audit_log.po new file mode 100644 index 000000000..7ba1f1c2b --- /dev/null +++ b/docs/locale/fr/LC_MESSAGES/api.models.audit_log.po @@ -0,0 +1,413 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.audit_log.rst:4 +msgid "Audit-Log Models" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:1 of +msgid "A class object representing an AuditLogEntry." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange +#: interactions.api.models.audit_log.AuditLogEntry +#: interactions.api.models.audit_log.AuditLogEvents +#: interactions.api.models.audit_log.AuditLogs +#: interactions.api.models.audit_log.OptionalAuditEntryInfo of +msgid "Variables" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:3 of +msgid "ID of the affected entity (webhook, user, role, etc.)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:4 of +msgid "Changes made to the target_id" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:5 of +msgid "User or app that made the changes" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:6 of +msgid "ID of the entry" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:7 of +msgid "Type of action that occurred" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:8 of +msgid "Additional info for certain event types" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:9 of +msgid "Reason for the change (1-512 characters)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "A class object representing the different types of AuditLogEvents." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:3 of +msgid "1 - Server settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:4 of +msgid "10 - Channel was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:5 of +msgid "11 - Channel settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:6 of +msgid "12 - Channel was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:7 of +msgid "13 - Permission overwrite was added to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:8 of +msgid "14 - Permission overwrite was updated for a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:9 of +msgid "15 - Permission overwrite was deleted from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:10 of +msgid "20 - Member was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:11 of +msgid "21 - Members were pruned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:12 of +msgid "22 - Member was banned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:13 of +msgid "23 - Server ban was lifted for a member" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:14 of +msgid "24 - Member was updated in server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:15 of +msgid "25 - Member was added or removed from a role" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:16 of +msgid "26 - Member was moved to a different voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:17 of +msgid "27 - Member was disconnected from a voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:18 of +msgid "28 - Bot user was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:19 of +msgid "30 - Role was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:20 of +msgid "31 - Role was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:21 of +msgid "32 - Role was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:22 of +msgid "40 - Server invite was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:23 of +msgid "41 - Server invite was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:24 of +msgid "42 - Server invite was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:25 of +msgid "50 - Webhook was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:26 of +msgid "51 - Webhook properties or channel were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:27 of +msgid "52 - Webhook was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:28 of +msgid "60 - Emoji was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:29 of +msgid "61 - Emoji name was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:30 of +msgid "62 - Emoji was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:31 of +msgid "72 - Single message was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:32 of +msgid "73 - Multiple messages were deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:33 of +msgid "74 - Message was pinned to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:34 of +msgid "75 - Message was unpinned from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:35 of +msgid "80 - App was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:36 of +msgid "81 - App was updated (as an example, its scopes were updated)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:37 of +msgid "82 - App was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:38 of +msgid "83 - Stage instance was created (stage channel becomes live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:39 of +msgid "84 - Stage instance details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:40 of +msgid "85 - Stage instance was deleted (stage channel no longer live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:41 of +msgid "90 - Sticker was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:42 of +msgid "91 - Sticker details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:43 of +msgid "92 - Sticker was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:44 of +msgid "100 - Event was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:45 of +msgid "101 - Event was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:46 of +msgid "102 - Event was cancelled" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:47 of +msgid "110 - Thread was created in a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:48 of +msgid "111 - Thread was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:49 of +msgid "112 - Thread was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:50 of +msgid "121 - Permissions were updated for a command" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:51 of +msgid "140 - Auto Moderation rule was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:52 of +msgid "141 - Auto Moderation rule was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:53 of +msgid "142 - Auto Moderation rule was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:54 of +msgid "143 - Message was blocked by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:55 of +msgid "144 - Message was flagged by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:56 of +msgid "145 - Member was timed out by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents of +msgid "Member Type" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid ":py:class:`int`" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:1 of +msgid "A class object representing the audit logs of a guild." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:3 of +msgid "List of audit log entries, sorted from most to least recent." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:4 of +msgid "List of auto moderation rules referenced in the audit log." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:5 of +msgid "List of guild scheduled events referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:6 of +msgid "List of partial integration objects" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:7 of +msgid "List of threads referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:8 of +msgid "List of users referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:9 of +msgid "List of webhooks referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:1 of +msgid "A class object representing an AuditLogChange." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:3 of +msgid "New value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:4 of +msgid "Old value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:5 of +msgid "" +"Name of the changed entity, with a few " +"[exceptions](https://discord.com/developers/docs/resources/audit-log" +"#audit-log-change-object-audit-log-change-exceptions)" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:1 of +msgid "A class object representing OptionalAuditEntryInfo." +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:3 of +msgid "" +"ID of the app whose permissions were targeted. ``AuditLogEvents``-type: " +"121" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:4 of +msgid "" +"Channel in which the entities were targeted. ``AuditLogEvents``-types: " +"26, 74, 75, 72, 83, 84, 85" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:5 of +msgid "" +"Name of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:6 of +msgid "" +"Trigger type of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:7 of +msgid "" +"Number of entities that were targeted. ``AuditLogEvents``-types: 72, 73, " +"27, 26" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:8 of +msgid "" +"Number of days after which inactive members were kicked. " +"``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:9 of +msgid "ID of the overwritten entity. ``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:10 of +msgid "Number of members removed by the prune. ``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:11 of +msgid "ID of the message that was targeted. ``AuditLogEvents``-types: 74, 75" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:12 of +msgid "" +"Name of the role if type is \"0\" (not present if type is \"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:13 of +msgid "" +"Type of overwritten entity - role (\"0\") or member (\"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.models.channel.po b/docs/locale/fr/LC_MESSAGES/api.models.channel.po index 1ca5f1ac3..81a65bd8e 100644 --- a/docs/locale/fr/LC_MESSAGES/api.models.channel.po +++ b/docs/locale/fr/LC_MESSAGES/api.models.channel.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.channel.rst:4 msgid "Channel Models" @@ -39,22 +39,24 @@ msgid "Valid values are as follows:" msgstr "" #: interactions.api.models.channel.Thread:1 of -msgid "An object representing a thread." -msgstr "" - -#: interactions.api.models.channel.Thread:4 of -msgid "" -"This is a derivation of the base Channel, since a thread can be its own " -"event." +msgid "An object representing a thread. .. note::" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator +#: interactions.api.models.channel.AsyncTypingContextManager #: interactions.api.models.channel.Channel #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.modify #: interactions.api.models.channel.Channel.pin_message @@ -72,6 +74,9 @@ msgstr "" #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit #: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit #: interactions.api.models.channel.Thread #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of @@ -88,7 +93,7 @@ msgid "" "needed to be used directly." msgstr "" -#: interactions.api.models.channel.Channel +#: interactions.api.models.channel.Channel interactions.api.models.channel.Tags #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of msgid "Variables" @@ -183,33 +188,64 @@ msgid "The amount of members in the channel." msgstr "" #: interactions.api.models.channel.Channel:29 of -msgid "The thread metadata of the channel." +msgid "Boolean representing if a thread is created." msgstr "" #: interactions.api.models.channel.Channel:30 of -msgid "The member of the thread in the channel." +msgid "The thread metadata of the channel." msgstr "" #: interactions.api.models.channel.Channel:31 of +msgid "The member of the thread in the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:32 of msgid "" "The set auto-archive time for all threads to naturally follow in the " "channel." msgstr "" -#: interactions.api.models.channel.Channel:32 of +#: interactions.api.models.channel.Channel:33 of msgid "The permissions of the channel." msgstr "" -#: interactions.api.models.channel.Channel.mention:1 of -msgid "Returns a string that allows you to mention the given channel." +#: interactions.api.models.channel.Channel:34 of +msgid "The flags of the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:35 of +msgid "Number of messages ever sent in a thread." +msgstr "" + +#: interactions.api.models.channel.Channel:36 of +msgid "" +"The default slowmode delay in seconds for threads, if this channel is a " +"forum." +msgstr "" + +#: interactions.api.models.channel.Channel:37 of +msgid "Tags in a forum channel, if any." +msgstr "" + +#: interactions.api.models.channel.Channel:38 of +msgid "Default reaction emoji for threads created in a forum, if any." +msgstr "" + +#: interactions.api.models.channel.Channel.typing:1 of +msgid "Manages the typing of the channel. Use with `await` or `async with`" msgstr "" #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.mention #: interactions.api.models.channel.Channel.modify @@ -224,24 +260,33 @@ msgstr "" #: interactions.api.models.channel.Channel.set_position #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic -#: interactions.api.models.channel.Channel.set_user_limit of +#: interactions.api.models.channel.Channel.set_user_limit +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Tags.edit of msgid "Returns" msgstr "" -#: interactions.api.models.channel.Channel.mention:3 of -msgid "The string of the mentioned channel." +#: interactions.api.models.channel.Channel.typing:3 of +msgid "A manager for typing" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator.flatten #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread #: interactions.api.models.channel.Channel.delete +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages #: interactions.api.models.channel.Channel.get_webhooks +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.join #: interactions.api.models.channel.Channel.leave #: interactions.api.models.channel.Channel.lock @@ -261,10 +306,44 @@ msgstr "" #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit -#: interactions.api.models.channel.Channel.unpin_message of +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit of msgid "Return type" msgstr "" +#: interactions.api.models.channel.Channel.mention:1 of +msgid "Returns a string that allows you to mention the given channel." +msgstr "" + +#: interactions.api.models.channel.Channel.mention:3 of +msgid "The string of the mentioned channel." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:7 +#: interactions.api.models.channel.Channel.history:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:9 +#: interactions.api.models.channel.Channel.history:3 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:13 +#: interactions.api.models.channel.Channel.history:5 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.channel.Channel.history:7 of +msgid "A custom check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.Channel.history:10 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" + #: interactions.api.models.channel.Channel.send:1 of msgid "Sends a message in the channel." msgstr "" @@ -292,7 +371,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.channel.Channel.send:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.channel.Channel.send:15 of @@ -625,10 +704,12 @@ msgstr "" msgid "Creates a thread in the Channel." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:3 #: interactions.api.models.channel.Channel.create_thread:3 of msgid "The name of the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:5 #: interactions.api.models.channel.Channel.create_thread:5 of msgid "" "duration in minutes to automatically archive the thread after recent " @@ -649,6 +730,7 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:16 #: interactions.api.models.channel.Channel.create_thread:14 of msgid "An optional reason for the audit log" msgstr "" @@ -734,6 +816,109 @@ msgstr "" msgid "Add the bot to the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:4 +#: interactions.api.models.channel.Channel.edit_tag:4 +#: interactions.api.models.channel.Tags.edit:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:7 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:9 +#: interactions.api.models.channel.Channel.edit_tag:11 +#: interactions.api.models.channel.Tags.edit:11 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:11 +#: interactions.api.models.channel.Channel.edit_tag:13 +#: interactions.api.models.channel.Tags.edit:13 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:13 of +msgid "The create tag object" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:1 of +msgid "Edits a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:7 of +msgid "The ID of the tag to edit" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:9 +#: interactions.api.models.channel.Tags.edit:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:15 +#: interactions.api.models.channel.Tags.edit:15 of +msgid "The modified tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:1 of +msgid "Deletes a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:3 of +msgid "The ID of the Tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:1 of +msgid "Creates a new post inside a forum channel" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:8 of +msgid "The content to send as first message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:10 of +msgid "Tags to give to the created thread" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:12 of +msgid "An optional list of files to send attached to the message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:14 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:18 of +msgid "A channel of ChannelType 11 (THREAD)" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:1 of +msgid "Returns the permissions of the member in this specific channel." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:4 of +msgid "" +"The permissions returned by this function take into account role and user" +" overwrites that can be assigned to channels or categories. If you don't " +"need these overwrites, look into :meth:`.Member.get_guild_permissions`." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:8 of +msgid "The member to get the permissions from" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:10 of +msgid "Permissions of the member in this channel" +msgstr "" + #: interactions.api.models.channel.ThreadMember:1 of msgid "A class object representing a member in a thread." msgstr "" @@ -793,3 +978,83 @@ msgstr "" #: interactions.api.models.channel.ThreadMetadata:11 of msgid "The ability to invite users to the thread." msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:3 +#: interactions.api.models.channel.AsyncTypingContextManager:5 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:11 of +msgid "A check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:1 of +msgid "An async context manager for triggering typing." +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:3 of +msgid "The channel to trigger typing in." +msgstr "" + +#: interactions.api.models.channel.Tags:1 of +msgid "An object denoting a tag object within a forum channel." +msgstr "" + +#: interactions.api.models.channel.Tags:4 of +msgid "If the emoji is custom, it won't have name information." +msgstr "" + +#: interactions.api.models.channel.Tags:6 of +msgid "Name of the tag. The limit is up to 20 characters." +msgstr "" + +#: interactions.api.models.channel.Tags:7 of +msgid "ID of the tag. Can also be 0 if manually created." +msgstr "" + +#: interactions.api.models.channel.Tags:8 of +msgid "" +"A boolean denoting whether this tag can be removed/added by moderators " +"with ``manage_threads`` permissions." +msgstr "" + +#: interactions.api.models.channel.Tags:9 of +msgid "The emoji to represent the tag, if any." +msgstr "" + +#: interactions.api.models.channel.Tags.delete:1 of +msgid "Deletes this tag" +msgstr "" + +#: interactions.api.models.channel.Tags.delete:3 +#: interactions.api.models.channel.Tags.edit:7 of +msgid "The ID of the channel where the tag belongs to" +msgstr "" + +#: interactions.api.models.channel.Tags.edit:1 of +msgid "Edits this tag" +msgstr "" + +#~ msgid "An object representing a thread." +#~ msgstr "" + +#~ msgid "" +#~ "This is a derivation of the base" +#~ " Channel, since a thread can be " +#~ "its own event." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.models.emoji.po b/docs/locale/fr/LC_MESSAGES/api.models.emoji.po new file mode 100644 index 000000000..2809ce66e --- /dev/null +++ b/docs/locale/fr/LC_MESSAGES/api.models.emoji.po @@ -0,0 +1,139 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-29 13:24-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.emoji.rst:4 +msgid "Emoji Models" +msgstr "" + +#: interactions.api.models.emoji.Emoji:1 of +msgid "A class objecting representing an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji of +msgid "Variables" +msgstr "" + +#: interactions.api.models.emoji.Emoji:3 of +msgid "Emoji id" +msgstr "" + +#: interactions.api.models.emoji.Emoji:4 of +msgid "Emoji name." +msgstr "" + +#: interactions.api.models.emoji.Emoji:5 of +msgid "Roles allowed to use this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:6 of +msgid "User that created this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:7 of +msgid "Status denoting of this emoji must be wrapped in colons" +msgstr "" + +#: interactions.api.models.emoji.Emoji:8 of +msgid "Status denoting if this emoji is managed (by an integration)" +msgstr "" + +#: interactions.api.models.emoji.Emoji:9 of +msgid "Status denoting if this emoji is animated" +msgstr "" + +#: interactions.api.models.emoji.Emoji:10 of +msgid "" +"Status denoting if this emoji can be used. (Can be false via server " +"boosting)" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:1 of +msgid "Gets an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild of +msgid "Parameters" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:3 of +msgid "The id of the guild of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:5 of +msgid "The id of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:7 +#: interactions.api.models.emoji.Emoji.get_all_of_guild:5 of +msgid "The HTTPClient of your bot. Equals to ``bot._http``" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Returns" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:9 of +msgid "The Emoji as object" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Return type" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:1 of +msgid "Gets all emoji of a guild." +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:3 of +msgid "The id of the guild to get the emojis of" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:7 of +msgid "The Emoji as list" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:1 of +msgid "Deletes the emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:3 of +msgid "The guild id to delete the emoji from" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:5 of +msgid "The reason of the deletion" +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:1 of +msgid "Returns the emoji's URL." +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:3 of +msgid "URL of the emoji" +msgstr "" + +#~ msgid "Audit-Log Models" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.models.guild.po b/docs/locale/fr/LC_MESSAGES/api.models.guild.po index a233b694b..6a195d3a5 100644 --- a/docs/locale/fr/LC_MESSAGES/api.models.guild.po +++ b/docs/locale/fr/LC_MESSAGES/api.models.guild.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:25-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.guild.rst:4 msgid "Guild Models" @@ -85,6 +85,7 @@ msgstr "" msgid "The location of the event, if any." msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator #: interactions.api.models.guild.EventMetadata #: interactions.api.models.guild.Guild #: interactions.api.models.guild.Guild.add_member_role @@ -95,17 +96,25 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji #: interactions.api.models.guild.Guild.delete_role #: interactions.api.models.guild.Guild.delete_scheduled_event +#: interactions.api.models.guild.Guild.delete_sticker +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule @@ -115,6 +124,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -672,13 +683,26 @@ msgid "The id of the member to ban" msgstr "" #: interactions.api.models.guild.Guild.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.guild.Guild.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:13 of +msgid "The reason of the ban" msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator.flatten #: interactions.api.models.guild.Guild.add_member_role #: interactions.api.models.guild.Guild.ban #: interactions.api.models.guild.Guild.clone_channel @@ -687,6 +711,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji @@ -698,13 +723,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.leave #: interactions.api.models.guild.Guild.list_auto_moderation_rules @@ -716,6 +749,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -840,6 +875,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_channel #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.get_all_active_threads #: interactions.api.models.guild.Guild.get_all_bans @@ -847,13 +883,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule #: interactions.api.models.guild.Guild.modify_channel @@ -862,6 +906,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.search_members of msgid "Returns" msgstr "" @@ -1508,6 +1554,20 @@ msgstr "" msgid "The created event" msgstr "" +#: interactions.api.models.guild.Guild.get_scheduled_events:1 of +msgid "Gets all scheduled events of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:3 of +msgid "" +"A boolean to include number of users subscribed to the associated event, " +"if given." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:5 of +msgid "The sheduled events of the guild." +msgstr "" + #: interactions.api.models.guild.Guild.modify_scheduled_event:1 of msgid "Edits a scheduled event of the guild." msgstr "" @@ -1614,6 +1674,40 @@ msgstr "" msgid "Gets all bans of the guild." msgstr "" +#: interactions.api.models.guild.Guild.prune:1 of +msgid "Begins a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:3 +#: interactions.api.models.guild.Guild.prune:3 of +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:4 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:4 +#: interactions.api.models.guild.Guild.prune:5 of +msgid "Role IDs to include, if given." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:6 of +msgid "" +"The number of pruned members, if compute_prune_count is not false. " +"Otherwise returns None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:1 of +msgid "Returns the number of members that would be removed in a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:5 of +msgid "The number of members that would be pruned." +msgstr "" + #: interactions.api.models.guild.Guild.get_emoji:1 of msgid "Gets an emoji of the guild and returns it." msgstr "" @@ -1664,6 +1758,77 @@ msgstr "" msgid "The emoji or the id of the emoji to delete" msgstr "" +#: interactions.api.models.guild.Guild.get_stickers:1 of +msgid "Get the stickers for a guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_stickers:3 of +msgid "List of stickers of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:1 of +msgid "Gets the list of sticker packs available to Nitro subscribers." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:3 of +msgid "List of sticker packs." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:1 of +msgid "Creates a new sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:3 of +msgid "The file of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:5 of +msgid "The tags of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:7 +#: interactions.api.models.guild.Guild.modify_sticker:5 of +msgid "The name of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:9 +#: interactions.api.models.guild.Guild.modify_sticker:7 of +msgid "The description of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:11 of +msgid "The reason of the creation." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:13 of +msgid "Created sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:1 of +msgid "Modifies the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:3 +#: interactions.api.models.guild.Guild.modify_sticker:3 of +msgid "The sticker or ID of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:9 of +msgid "The reason of the modification." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:11 of +msgid "Modified sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:1 of +msgid "Deletes the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:5 of +msgid "The reason of the deletion." +msgstr "" + #: interactions.api.models.guild.Guild.get_list_of_members:1 of msgid "Lists the members of a guild." msgstr "" @@ -1710,6 +1875,23 @@ msgstr "" msgid "Returns a list of all members of the guild" msgstr "" +#: interactions.api.models.guild.Guild.get_members:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:11 +#: interactions.api.models.guild.Guild.get_members:3 of +msgid "A set maximum of members to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:5 of +msgid "A custom check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:8 of +msgid "An asynchronous iterator over the members of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.list_auto_moderation_rules:1 of msgid "Lists all AutoMod rules" msgstr "" @@ -1784,6 +1966,55 @@ msgstr "" msgid "The rule to modify" msgstr "" +#: interactions.api.models.guild.Guild.get_audit_logs:1 of +msgid "Gets the audit logs of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:3 of +msgid "How many entries to get, default 100" +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:5 +#: interactions.api.models.guild.Guild.get_full_audit_logs:3 of +msgid "User ID snowflake. filter the log for actions made by a user." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:7 of +msgid "The Type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:9 of +msgid "filter the log before a certain entry id." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:11 of +msgid "The guild audit logs" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:1 of +msgid "Gets the latest audit log action of either a user or an action type" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:3 of +msgid "The user, user id or action type to look for" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:5 of +msgid "The latest AuditLog action that applies to the ``of`` parameter" +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:1 of +msgid "Gets the full audit log of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:5 of +msgid "The type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:7 of +msgid "The full AuditLog of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.icon_url:1 of msgid "" "Returns the URL of the guild's icon. :return: URL of the guild's icon " @@ -1897,3 +2128,32 @@ msgstr "" #: interactions.api.models.guild.Invite.delete:1 of msgid "Deletes the invite" msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:3 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:5 of +msgid "The guild to get the members from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:7 of +msgid "" +"The member ID to start getting members from (gets all members after that " +"member)" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:9 of +msgid "A check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.models.gw.po b/docs/locale/fr/LC_MESSAGES/api.models.gw.po index fe823c232..88a920629 100644 --- a/docs/locale/fr/LC_MESSAGES/api.models.gw.po +++ b/docs/locale/fr/LC_MESSAGES/api.models.gw.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.gw.rst:4 msgid "Gateway-specific Event Models" @@ -42,10 +42,10 @@ msgstr "" #: interactions.api.models.gw.GuildScheduledEventUser #: interactions.api.models.gw.GuildStickers #: interactions.api.models.gw.Integration +#: interactions.api.models.gw.MessageDelete #: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList +#: interactions.api.models.gw.MessageReactionRemove +#: interactions.api.models.gw.Presence interactions.api.models.gw.ThreadList #: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks #: of msgid "Variables" @@ -93,36 +93,6 @@ msgstr "" msgid "The substring in content that triggered rule." msgstr "" -#: interactions.api.models.gw.ApplicationCommandPermissions -#: interactions.api.models.gw.AutoModerationAction -#: interactions.api.models.gw.AutoModerationRule -#: interactions.api.models.gw.ChannelPins -#: interactions.api.models.gw.EmbeddedActivity -#: interactions.api.models.gw.GuildBan interactions.api.models.gw.GuildEmojis -#: interactions.api.models.gw.GuildIntegrations -#: interactions.api.models.gw.GuildJoinRequest -#: interactions.api.models.gw.GuildMember -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send -#: interactions.api.models.gw.GuildMembers interactions.api.models.gw.GuildRole -#: interactions.api.models.gw.GuildScheduledEvent -#: interactions.api.models.gw.GuildScheduledEventUser -#: interactions.api.models.gw.GuildStickers -#: interactions.api.models.gw.Integration -#: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList -#: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks -#: of -msgid "Parameters" -msgstr "" - #: interactions.api.models.gw.AutoModerationRule:1 of msgid "" "A class object representing the gateway events " @@ -232,14 +202,14 @@ msgstr "" #: interactions.api.models.gw.GuildEmojis:3 #: interactions.api.models.gw.GuildIntegrations:3 #: interactions.api.models.gw.GuildJoinRequest:7 -#: interactions.api.models.gw.GuildMember:3 #: interactions.api.models.gw.GuildMembers:3 #: interactions.api.models.gw.GuildRole:3 #: interactions.api.models.gw.GuildStickers:3 #: interactions.api.models.gw.Integration:23 +#: interactions.api.models.gw.MessageDelete:5 #: interactions.api.models.gw.MessageReaction:6 +#: interactions.api.models.gw.MessageReactionRemove:10 #: interactions.api.models.gw.Presence:4 -#: interactions.api.models.gw.ReactionRemove:10 #: interactions.api.models.gw.ThreadList:3 #: interactions.api.models.gw.ThreadMembers:4 of msgid "The guild ID of the event." @@ -251,8 +221,9 @@ msgstr "" #: interactions.api.models.gw.ChannelPins:4 #: interactions.api.models.gw.EmbeddedActivity:9 +#: interactions.api.models.gw.MessageDelete:4 #: interactions.api.models.gw.MessageReaction:4 -#: interactions.api.models.gw.ReactionRemove:8 of +#: interactions.api.models.gw.MessageReactionRemove:8 of msgid "The channel ID of the event." msgstr "" @@ -312,7 +283,6 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildBan:4 -#: interactions.api.models.gw.GuildMember:5 #: interactions.api.models.gw.Integration:17 #: interactions.api.models.gw.Presence:3 of msgid "The user of the event." @@ -378,14 +348,21 @@ msgstr "" msgid "The members of the thread of the event." msgstr "" -#: interactions.api.models.gw.ReactionRemove:1 of +#: interactions.api.models.gw.MessageDelete:1 of +msgid "A class object representing the gateway event ``MESSAGE_DELETE_BULK``." +msgstr "" + +#: interactions.api.models.gw.MessageDelete:3 of +msgid "The message IDs of the event." +msgstr "" + +#: interactions.api.models.gw.MessageReactionRemove:1 of msgid "" "A class object representing the gateway events " -"``MESSAGE_REACTION_REMOVE``, ``MESSAGE_REACTION_REMOVE_ALL`` and " -"``MESSAGE_REACTION_REMOVE_EMOJI``." +"``MESSAGE_REACTION_REMOVE_ALL`` and ``MESSAGE_REACTION_REMOVE_EMOJI``." msgstr "" -#: interactions.api.models.gw.ReactionRemove:4 of +#: interactions.api.models.gw.MessageReactionRemove:4 of msgid "" "This class inherits the already existing attributes of " ":class:`interactions.api.models.gw.Reaction`. The main missing attribute " @@ -394,22 +371,24 @@ msgstr "" #: interactions.api.models.gw.GuildJoinRequest:6 #: interactions.api.models.gw.MessageReaction:3 -#: interactions.api.models.gw.ReactionRemove:7 of +#: interactions.api.models.gw.MessageReactionRemove:7 of msgid "The user ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:5 -#: interactions.api.models.gw.ReactionRemove:9 of +#: interactions.api.models.gw.MessageReactionRemove:9 of msgid "The message ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:8 -#: interactions.api.models.gw.ReactionRemove:11 of +#: interactions.api.models.gw.MessageReactionRemove:11 of msgid "The emoji of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:1 of -msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +msgid "" +"A class object representing the gateway event ``MESSAGE_REACTION_ADD`` " +"and ``MESSAGE_REACTION_REMOVE``." msgstr "" #: interactions.api.models.gw.MessageReaction:7 of @@ -473,204 +452,58 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildMember:4 of -msgid "The roles of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:6 of -msgid "The nickname of the user of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:7 of -msgid "The avatar URL of the user of the event." +msgid "" +"``pending`` and ``permissions`` only apply for members retroactively " +"requiring to verify rules via. membership screening or lack permissions " +"to speak." msgstr "" #: interactions.api.models.gw.GuildMember:8 of -msgid "The time that the user of the event joined at." +msgid "The guild ID." msgstr "" #: interactions.api.models.gw.GuildMember:9 of -msgid "The time that the user of the event has since had \"premium.\"" +msgid "The user of the guild." msgstr "" #: interactions.api.models.gw.GuildMember:10 of -msgid "Whether the member of the event is deafened or not." +msgid "The nickname of the member." msgstr "" #: interactions.api.models.gw.GuildMember:11 of -msgid "Whether the member of the event is muted or not." +msgid "The hash containing the user's guild avatar, if applicable." msgstr "" #: interactions.api.models.gw.GuildMember:12 of -msgid "" -"Whether the member of the event is still pending -- pass membership " -"screening -- or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:1 of -msgid "Returns the ID of the user." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.send of -msgid "Returns" -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:3 of -msgid "The ID of the user" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send of -msgid "Return type" -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:1 of -msgid "Returns the string of either the user's nickname or username." -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:3 of -msgid "The name of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:1 of -msgid "Returns a string that allows you to mention the given member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:3 of -msgid "The string of the mentioned member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:1 of -msgid "Bans the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:3 of -msgid "The reason of the ban" -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:1 of -msgid "Kicks the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:3 of -msgid "The reason for the kick" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:1 of -msgid "This method adds a role to a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:3 of -msgid "The role to add. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:5 of -msgid "The reason why the roles are added" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:1 of -msgid "This method removes a role from a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:3 of -msgid "The role to remove. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:5 of -msgid "The reason why the roles are removed" -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:1 of -msgid "Sends a DM to the member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:3 of -msgid "The contents of the message as a string or string-converted value." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:5 of -msgid "A component, or list of components for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:7 of -msgid "Whether the message utilizes the text-to-speech Discord programme or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:9 of -msgid "A file or list of files to be attached to the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:11 of -msgid "An embed, or list of embeds for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:13 of -msgid "The message interactions/mention limits that the message can refer to." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:15 of -msgid "The sent message as an object." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:1 of -msgid "Modifies the member of a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:3 of -msgid "The nickname of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:5 of -msgid "A list of all role ids the member has" +msgid "The list of roles of the member." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:7 of -msgid "whether the user is muted in voice channels" +#: interactions.api.models.gw.GuildMember:13 of +msgid "The timestamp the member joined the guild at." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:9 of -msgid "whether the user is deafened in voice channels" +#: interactions.api.models.gw.GuildMember:14 of +msgid "The timestamp the member has been a server booster since." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:11 of -msgid "id of channel to move user to (if they are connected to voice)" +#: interactions.api.models.gw.GuildMember:15 of +msgid "Whether the member is deafened." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:13 of -msgid "" -"when the user's timeout will expire and the user will be able to " -"communicate in the guild again (up to 28 days in the future)" +#: interactions.api.models.gw.GuildMember:16 of +msgid "Whether the member is muted." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:15 of -msgid "The reason of the modifying" +#: interactions.api.models.gw.GuildMember:17 of +msgid "Whether the member is pending to pass membership screening." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:17 of -msgid "The modified member object" +#: interactions.api.models.gw.GuildMember:18 of +msgid "Whether the member has permissions." msgstr "" -#: interactions.api.models.gw.GuildMember.add_to_thread:1 of -msgid "Adds the member to a thread." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_to_thread:3 of -msgid "The id of the thread to add the member to" +#: interactions.api.models.gw.GuildMember:19 of +msgid "How long until they're unmuted, if any." msgstr "" #: interactions.api.models.gw.GuildStickers:1 of @@ -823,3 +656,164 @@ msgstr "" #: interactions.api.models.gw.GuildRole:5 of msgid "The role ID of the event." msgstr "" + +#~ msgid "" +#~ "A class object representing the gateway" +#~ " events ``MESSAGE_REACTION_REMOVE``, " +#~ "``MESSAGE_REACTION_REMOVE_ALL`` and " +#~ "``MESSAGE_REACTION_REMOVE_EMOJI``." +#~ msgstr "" + +#~ msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +#~ msgstr "" + +#~ msgid "The roles of the event." +#~ msgstr "" + +#~ msgid "The nickname of the user of the event." +#~ msgstr "" + +#~ msgid "The avatar URL of the user of the event." +#~ msgstr "" + +#~ msgid "The time that the user of the event joined at." +#~ msgstr "" + +#~ msgid "The time that the user of the event has since had \"premium.\"" +#~ msgstr "" + +#~ msgid "Whether the member of the event is deafened or not." +#~ msgstr "" + +#~ msgid "Whether the member of the event is muted or not." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the member of the event is" +#~ " still pending -- pass membership " +#~ "screening -- or not." +#~ msgstr "" + +#~ msgid "Returns the ID of the user." +#~ msgstr "" + +#~ msgid "Returns" +#~ msgstr "" + +#~ msgid "The ID of the user" +#~ msgstr "" + +#~ msgid "Return type" +#~ msgstr "" + +#~ msgid "Returns the string of either the user's nickname or username." +#~ msgstr "" + +#~ msgid "The name of the member" +#~ msgstr "" + +#~ msgid "Returns a string that allows you to mention the given member." +#~ msgstr "" + +#~ msgid "The string of the mentioned member." +#~ msgstr "" + +#~ msgid "Bans the member from a guild." +#~ msgstr "" + +#~ msgid "The reason of the ban" +#~ msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Kicks the member from a guild." +#~ msgstr "" + +#~ msgid "The reason for the kick" +#~ msgstr "" + +#~ msgid "This method adds a role to a member." +#~ msgstr "" + +#~ msgid "The role to add. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are added" +#~ msgstr "" + +#~ msgid "This method removes a role from a member." +#~ msgstr "" + +#~ msgid "The role to remove. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are removed" +#~ msgstr "" + +#~ msgid "Sends a DM to the member." +#~ msgstr "" + +#~ msgid "The contents of the message as a string or string-converted value." +#~ msgstr "" + +#~ msgid "A component, or list of components for the message." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the message utilizes the " +#~ "text-to-speech Discord programme or " +#~ "not." +#~ msgstr "" + +#~ msgid "A file or list of files to be attached to the message." +#~ msgstr "" + +#~ msgid "An embed, or list of embeds for the message." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The sent message as an object." +#~ msgstr "" + +#~ msgid "Modifies the member of a guild." +#~ msgstr "" + +#~ msgid "The nickname of the member" +#~ msgstr "" + +#~ msgid "A list of all role ids the member has" +#~ msgstr "" + +#~ msgid "whether the user is muted in voice channels" +#~ msgstr "" + +#~ msgid "whether the user is deafened in voice channels" +#~ msgstr "" + +#~ msgid "id of channel to move user to (if they are connected to voice)" +#~ msgstr "" + +#~ msgid "" +#~ "when the user's timeout will expire " +#~ "and the user will be able to " +#~ "communicate in the guild again (up " +#~ "to 28 days in the future)" +#~ msgstr "" + +#~ msgid "The reason of the modifying" +#~ msgstr "" + +#~ msgid "The modified member object" +#~ msgstr "" + +#~ msgid "Adds the member to a thread." +#~ msgstr "" + +#~ msgid "The id of the thread to add the member to" +#~ msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.models.member.po b/docs/locale/fr/LC_MESSAGES/api.models.member.po index ce23f99ac..f5839f391 100644 --- a/docs/locale/fr/LC_MESSAGES/api.models.member.po +++ b/docs/locale/fr/LC_MESSAGES/api.models.member.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.member.rst:4 msgid "Member Models" @@ -86,6 +86,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.modify #: interactions.api.models.member.Member.remove_role @@ -93,10 +95,20 @@ msgstr "" msgid "Parameters" msgstr "" +#: interactions.api.models.member.Member.guild_id:1 of +msgid "" +"Attempts to get the guild ID the member is in. Only works then roles or " +"nick or joined at is present. :return: The ID of the guild this member " +"belongs to." +msgstr "" + #: interactions.api.models.member.Member.id:1 of msgid "Returns the ID of the user." msgstr "" +#: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.mention #: interactions.api.models.member.Member.modify @@ -113,6 +125,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.mention @@ -148,11 +162,23 @@ msgid "The id of the guild to ban the member from" msgstr "" #: interactions.api.models.member.Member.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.member.Member.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.member.Member.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.member.Member.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.member.Member.ban:13 of +msgid "The reason of the ban" msgstr "" #: interactions.api.models.member.Member.kick:1 of @@ -230,7 +256,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.member.Member.send:15 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.member.Member.send:17 of @@ -288,9 +314,83 @@ msgid "The id of the thread to add the member to" msgstr "" #: interactions.api.models.member.Member.get_avatar_url:1 of +msgid "Returns the URL of the member's avatar for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:3 of +msgid "The id of the guild to get the member's avatar from" +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:5 of +msgid "URL of the members's avatar (None will be returned if no avatar is set)" +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:1 of +msgid "Returns the permissions of the member for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:4 of msgid "" -"Returns the URL of the member's avatar for the specified guild. :param " -"guild_id: The id of the guild to get the member's avatar from :type " -"guild_id: Union[int, Snowflake, \"Guild\"] :return: URL of the members's " -"avatar (None will be returned if no avatar is set) :rtype: str" +"The permissions returned by this function will not take into account role" +" and user overwrites that can be assigned to channels or categories. If " +"you need these overwrites, look into " +":meth:`.Channel.get_permissions_for`." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:8 of +msgid "The guild of the member" msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:10 of +msgid "Base permissions of the member in the specified guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:1 of +msgid "Returns whether the member has the permissions passed." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:4 of +msgid "" +"If the channel argument is present, the function will look if the member " +"has the permissions in the specified channel. If the argument is missing," +" then it will only consider the member's guild permissions." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:7 of +msgid "The list of permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:9 of +msgid "The channel where to check for permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:11 of +msgid "The id of the guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:13 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:15 of +msgid "Whether the member has the permissions" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "" +#~ "Returns the URL of the member's " +#~ "avatar for the specified guild. :param" +#~ " guild_id: The id of the guild " +#~ "to get the member's avatar from " +#~ ":type guild_id: Union[int, Snowflake, " +#~ "\"Guild\"] :return: URL of the members's" +#~ " avatar (None will be returned if " +#~ "no avatar is set) :rtype: str" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.models.message.po b/docs/locale/fr/LC_MESSAGES/api.models.message.po index 5bcd77f9c..e1f033a87 100644 --- a/docs/locale/fr/LC_MESSAGES/api.models.message.po +++ b/docs/locale/fr/LC_MESSAGES/api.models.message.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.message.rst:4 msgid "Message Models" @@ -50,14 +50,14 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji #: interactions.api.models.message.Message #: interactions.api.models.message.MessageActivity #: interactions.api.models.message.MessageInteraction #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Variables" msgstr "" @@ -156,33 +156,33 @@ msgid "" msgstr "" #: interactions.api.models.message.Message:26 of -msgid "The allowed mentions of roles attached in the message." -msgstr "" - -#: interactions.api.models.message.Message:27 of msgid "Message flags" msgstr "" -#: interactions.api.models.message.Message:28 of +#: interactions.api.models.message.Message:27 of msgid "Message interaction object, if the message is sent by an interaction." msgstr "" -#: interactions.api.models.message.Message:29 of +#: interactions.api.models.message.Message:28 of msgid "" "The thread that started from this message, if any, with a thread member " "object embedded." msgstr "" +#: interactions.api.models.message.Message:29 of +msgid "Array of Action Rows associated with this message, if any." +msgstr "" + #: interactions.api.models.message.Message:30 of -msgid "Components associated with this message, if any." +msgid "An array of message sticker item objects, if sent with them." msgstr "" #: interactions.api.models.message.Message:31 of -msgid "An array of message sticker item objects, if sent with them." +msgid "Array of sticker objects sent with the message if any. Deprecated." msgstr "" #: interactions.api.models.message.Message:32 of -msgid "Array of sticker objects sent with the message if any. Deprecated." +msgid "The approximate position of the message in a thread." msgstr "" #: interactions.api.models.message.Attachment @@ -202,10 +202,6 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild #: interactions.api.models.message.Message #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread @@ -222,7 +218,8 @@ msgstr "" #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Parameters" msgstr "" @@ -230,6 +227,7 @@ msgstr "" msgid "Gets the channel where the message was sent." msgstr "" +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Embed.add_field #: interactions.api.models.message.Embed.clear_fields #: interactions.api.models.message.Embed.insert_field_at @@ -241,13 +239,10 @@ msgstr "" #: interactions.api.models.message.Embed.set_image #: interactions.api.models.message.Embed.set_thumbnail #: interactions.api.models.message.Embed.set_video -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread #: interactions.api.models.message.Message.delete +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_channel #: interactions.api.models.message.Message.get_from_url @@ -307,7 +302,7 @@ msgstr "" #: interactions.api.models.message.Message.edit:13 #: interactions.api.models.message.Message.reply:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.message.Message.edit:15 @@ -323,10 +318,9 @@ msgid "" "components will be removed" msgstr "" -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Message.create_thread +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_from_url #: interactions.api.models.message.Message.get_users_from_reaction @@ -466,6 +460,14 @@ msgstr "" msgid "The URL of said message" msgstr "" +#: interactions.api.models.message.Message.disable_all_components:1 of +msgid "Sets all components to disabled on this message." +msgstr "" + +#: interactions.api.models.message.Message.disable_all_components:3 of +msgid "The modified message." +msgstr "" + #: interactions.api.models.message.MessageReference:1 of msgid "A class object representing the \"referenced\"/replied message." msgstr "" @@ -654,20 +656,26 @@ msgstr "" msgid "Inserts a field in the embed at the specified index" msgstr "" -#: interactions.api.models.message.Embed.insert_field_at:3 -#: interactions.api.models.message.Embed.remove_field:3 -#: interactions.api.models.message.Embed.set_field_at:3 of -msgid "The new field's index" +#: interactions.api.models.message.Embed.insert_field_at:3 of +msgid "The field's index to insert" msgstr "" #: interactions.api.models.message.Embed.set_field_at:1 of msgid "Overwrites the field in the embed at the specified index" msgstr "" +#: interactions.api.models.message.Embed.set_field_at:3 of +msgid "The field's index to overwrite" +msgstr "" + #: interactions.api.models.message.Embed.remove_field:1 of msgid "Remove field at the specified index" msgstr "" +#: interactions.api.models.message.Embed.remove_field:3 of +msgid "The field's index to remove" +msgstr "" + #: interactions.api.models.message.Embed.remove_author:1 of msgid "Removes the embed's author" msgstr "" @@ -906,95 +914,12 @@ msgstr "" msgid "Whether the attachment is ephemeral." msgstr "" -#: interactions.api.models.message.Emoji:1 of -msgid "A class objecting representing an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji:3 of -msgid "Emoji id" -msgstr "" - -#: interactions.api.models.message.Emoji:4 of -msgid "Emoji name." -msgstr "" - -#: interactions.api.models.message.Emoji:5 of -msgid "Roles allowed to use this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:6 of -msgid "User that created this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:7 of -msgid "Status denoting of this emoji must be wrapped in colons" -msgstr "" - -#: interactions.api.models.message.Emoji:8 of -msgid "Status denoting if this emoji is managed (by an integration)" -msgstr "" - -#: interactions.api.models.message.Emoji:9 of -msgid "Status denoting if this emoji is animated" -msgstr "" - -#: interactions.api.models.message.Emoji:10 of -msgid "" -"Status denoting if this emoji can be used. (Can be false via server " -"boosting)" -msgstr "" - -#: interactions.api.models.message.Emoji.get:1 of -msgid "Gets an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.get:3 of -msgid "The id of the guild of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:5 of -msgid "The id of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:7 -#: interactions.api.models.message.Emoji.get_all_of_guild:5 of -msgid "The HTTPClient of your bot. Equals to ``bot._http``" -msgstr "" - -#: interactions.api.models.message.Emoji.get:9 of -msgid "The Emoji as object" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:1 of -msgid "Gets all emoji of a guild." +#: interactions.api.models.message.Attachment.download:1 of +msgid "Downloads the attachment." msgstr "" -#: interactions.api.models.message.Emoji.get_all_of_guild:3 of -msgid "The id of the guild to get the emojis of" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:7 of -msgid "The Emoji as list" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:1 of -msgid "Deletes the emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.delete:3 of -msgid "The guild id to delete the emoji from" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:5 of -msgid "The reason of the deletion" -msgstr "" - -#: interactions.api.models.message.Emoji.url:1 of -msgid "Returns the emoji's URL." -msgstr "" - -#: interactions.api.models.message.Emoji.url:3 of -msgid "URL of the emoji" +#: interactions.api.models.message.Attachment.download:3 of +msgid "The attachment's bytes as BytesIO object" msgstr "" #: interactions.api.models.message.EmbedFooter:1 of @@ -1093,3 +1018,116 @@ msgstr "" #: interactions.api.models.message.Sticker:14 of msgid "The standard sticker's sort order within its pack" msgstr "" + +#: interactions.api.models.message.StickerPack:1 of +msgid "A class objects representing a pack of stickers." +msgstr "" + +#: interactions.api.models.message.StickerPack:3 of +msgid "ID of the sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:4 of +msgid "The stickers in the pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:5 of +msgid "The name of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:6 of +msgid "ID of the pack's SKU." +msgstr "" + +#: interactions.api.models.message.StickerPack:7 of +msgid "ID of a sticker in the pack which is shown as the pack's icon." +msgstr "" + +#: interactions.api.models.message.StickerPack:8 of +msgid "The description of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:9 of +msgid "ID of the sticker pack's banner image." +msgstr "" + +#~ msgid "The allowed mentions of roles attached in the message." +#~ msgstr "" + +#~ msgid "Components associated with this message, if any." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The new field's index" +#~ msgstr "" + +#~ msgid "A class objecting representing an emoji." +#~ msgstr "" + +#~ msgid "Emoji id" +#~ msgstr "" + +#~ msgid "Emoji name." +#~ msgstr "" + +#~ msgid "Roles allowed to use this emoji" +#~ msgstr "" + +#~ msgid "User that created this emoji" +#~ msgstr "" + +#~ msgid "Status denoting of this emoji must be wrapped in colons" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is managed (by an integration)" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is animated" +#~ msgstr "" + +#~ msgid "" +#~ "Status denoting if this emoji can " +#~ "be used. (Can be false via server" +#~ " boosting)" +#~ msgstr "" + +#~ msgid "Gets an emoji." +#~ msgstr "" + +#~ msgid "The id of the guild of the emoji" +#~ msgstr "" + +#~ msgid "The id of the emoji" +#~ msgstr "" + +#~ msgid "The HTTPClient of your bot. Equals to ``bot._http``" +#~ msgstr "" + +#~ msgid "The Emoji as object" +#~ msgstr "" + +#~ msgid "Gets all emoji of a guild." +#~ msgstr "" + +#~ msgid "The id of the guild to get the emojis of" +#~ msgstr "" + +#~ msgid "The Emoji as list" +#~ msgstr "" + +#~ msgid "Deletes the emoji." +#~ msgstr "" + +#~ msgid "The guild id to delete the emoji from" +#~ msgstr "" + +#~ msgid "The reason of the deletion" +#~ msgstr "" + +#~ msgid "Returns the emoji's URL." +#~ msgstr "" + +#~ msgid "URL of the emoji" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.models.misc.po b/docs/locale/fr/LC_MESSAGES/api.models.misc.po index cfed122db..77ec620aa 100644 --- a/docs/locale/fr/LC_MESSAGES/api.models.misc.po +++ b/docs/locale/fr/LC_MESSAGES/api.models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.misc.rst:4 msgid "Miscellanous Models" @@ -27,6 +27,7 @@ msgstr "" msgid "An enumeration." msgstr "" +#: interactions.api.models.misc.AllowedMentionType #: interactions.api.models.misc.AutoModKeywordPresetTypes #: interactions.api.models.misc.AutoModTriggerType of msgid "Member Type" @@ -37,6 +38,7 @@ msgstr "" msgid ":py:class:`int`" msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 #: interactions.api.models.misc.AutoModKeywordPresetTypes:1 #: interactions.api.models.misc.AutoModTriggerType:1 of msgid "Valid values are as follows:" @@ -50,6 +52,7 @@ msgstr "" msgid "The maximum duration for duration_seconds is 2419200 seconds, aka 4 weeks." msgstr "" +#: interactions.api.models.misc.AllowedMentions #: interactions.api.models.misc.AutoModAction #: interactions.api.models.misc.AutoModMetaData #: interactions.api.models.misc.AutoModTriggerMetadata @@ -66,15 +69,6 @@ msgstr "" msgid "Timeout duration in seconds, if timed out." msgstr "" -#: interactions.api.models.misc.AutoModAction -#: interactions.api.models.misc.AutoModMetaData -#: interactions.api.models.misc.AutoModTriggerMetadata -#: interactions.api.models.misc.ClientStatus interactions.api.models.misc.File -#: interactions.api.models.misc.Image interactions.api.models.misc.Overwrite -#: interactions.api.models.misc.Snowflake of -msgid "Parameters" -msgstr "" - #: interactions.api.models.misc.AutoModAction:1 of msgid "" "A class object used for the ``AUTO_MODERATION_ACTION_EXECUTION`` event. " @@ -107,6 +101,53 @@ msgstr "" msgid "The internally pre-defined wordsets which will be searched for in content." msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "An enumerable object representing the allowed mention types" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:1 of +msgid "A class object representing the allowed mentions object" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:3 of +msgid "" +"Optional[List[AllowedMentionType]]: An array of allowed mention types to " +"parse from the content." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:4 of +msgid "Optional[List[int]]: An array of user ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:5 of +msgid "Optional[List[int]]: An array of role ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:6 of +msgid "" +"Optional[bool]: For replies, whether to mention the author of the message" +" being replied to." +msgstr "" + #: interactions.api.models.misc.Snowflake:1 of msgid "The Snowflake object." msgstr "" @@ -129,17 +170,6 @@ msgid "" "integer." msgstr "" -#: interactions.api.models.misc.Color.black -#: interactions.api.models.misc.Color.blurple -#: interactions.api.models.misc.Color.fuchsia -#: interactions.api.models.misc.Color.green -#: interactions.api.models.misc.Color.red -#: interactions.api.models.misc.Color.white -#: interactions.api.models.misc.Color.yellow -#: interactions.api.models.misc.Snowflake of -msgid "Return type" -msgstr "" - #: interactions.api.models.misc.Snowflake.increment:1 of msgid "" "This is the 'Increment' portion of the snowflake. This is incremented for" @@ -199,6 +229,16 @@ msgstr "" msgid "Returns a hexadecimal value of the blurple color." msgstr "" +#: interactions.api.models.misc.Color.black +#: interactions.api.models.misc.Color.blurple +#: interactions.api.models.misc.Color.fuchsia +#: interactions.api.models.misc.Color.green +#: interactions.api.models.misc.Color.red +#: interactions.api.models.misc.Color.white +#: interactions.api.models.misc.Color.yellow of +msgid "Return type" +msgstr "" + #: interactions.api.models.misc.Color.green:1 of msgid "Returns a hexadecimal value of the green color." msgstr "" @@ -287,3 +327,6 @@ msgstr "" #: interactions.api.models.misc.Overwrite:6 of msgid "Permission bit set." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.models.presence.po b/docs/locale/fr/LC_MESSAGES/api.models.presence.po index 347c24dbc..cfbae19fa 100644 --- a/docs/locale/fr/LC_MESSAGES/api.models.presence.po +++ b/docs/locale/fr/LC_MESSAGES/api.models.presence.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.presence.rst:4 msgid "Presence Models" @@ -43,15 +43,6 @@ msgstr "" msgid "An array denoting the party's current and max size" msgstr "" -#: interactions.api.models.presence.ClientPresence -#: interactions.api.models.presence.PresenceActivity -#: interactions.api.models.presence.PresenceAssets -#: interactions.api.models.presence.PresenceParty -#: interactions.api.models.presence.PresenceSecrets -#: interactions.api.models.presence.PresenceTimestamp of -msgid "Parameters" -msgstr "" - #: interactions.api.models.presence.PresenceAssets:1 of msgid "A class object representing the assets of a presence." msgstr "" @@ -231,3 +222,6 @@ msgstr "" #: interactions.api.models.presence.ClientPresence:6 of msgid "Whether the client is afk or not." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.models.role.po b/docs/locale/fr/LC_MESSAGES/api.models.role.po index c78eeec53..4828e3cfc 100644 --- a/docs/locale/fr/LC_MESSAGES/api.models.role.po +++ b/docs/locale/fr/LC_MESSAGES/api.models.role.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.role.rst:4 msgid "Role Models" @@ -130,6 +130,12 @@ msgstr "" msgid "RGB color value as integer, defaults to the current value of the role" msgstr "" +#: interactions.api.models.role.Role.modify:9 of +msgid "" +"Bitwise value of the enabled/disabled permissions, defaults to the " +"current value of the role" +msgstr "" + #: interactions.api.models.role.Role.modify:11 of msgid "" "Whether the role should be displayed separately in the sidebar, defaults " diff --git a/docs/locale/fr/LC_MESSAGES/api.models.team.po b/docs/locale/fr/LC_MESSAGES/api.models.team.po index 2958a4252..36accb3a5 100644 --- a/docs/locale/fr/LC_MESSAGES/api.models.team.po +++ b/docs/locale/fr/LC_MESSAGES/api.models.team.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.team.rst:4 msgid "Team Models" @@ -51,11 +51,6 @@ msgstr "" msgid "The User ID of the current team owner" msgstr "" -#: interactions.api.models.team.Application interactions.api.models.team.Team -#: interactions.api.models.team.TeamMember of -msgid "Parameters" -msgstr "" - #: interactions.api.models.team.TeamMember:1 of msgid "A class object representing the member of a team." msgstr "" @@ -183,3 +178,6 @@ msgstr "" #: interactions.api.models.team.Application.icon_url of msgid "Return type" msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.models.user.po b/docs/locale/fr/LC_MESSAGES/api.models.user.po index 5721c56da..00f10cc86 100644 --- a/docs/locale/fr/LC_MESSAGES/api.models.user.po +++ b/docs/locale/fr/LC_MESSAGES/api.models.user.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.user.rst:4 msgid "User Models" @@ -94,17 +94,14 @@ msgstr "" msgid "The user's public flags" msgstr "" -#: interactions.api.models.user.User of -msgid "Parameters" -msgstr "" - #: interactions.api.models.user.User.mention:1 of msgid "Returns a string that allows you to mention the given user." msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Returns" msgstr "" @@ -114,7 +111,8 @@ msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Return type" msgstr "" @@ -133,3 +131,14 @@ msgstr "" #: interactions.api.models.user.User.banner_url:3 of msgid "URL of the user's banner (None will be returned if no banner is set)" msgstr "" + +#: interactions.api.models.user.User.presence:1 of +msgid "Returns the presence of the user." +msgstr "" + +#: interactions.api.models.user.User.presence:3 of +msgid "Presence of the user (None will be returned if not cached)" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/api.models.webhook.po b/docs/locale/fr/LC_MESSAGES/api.models.webhook.po index be10a2fd1..906a172a9 100644 --- a/docs/locale/fr/LC_MESSAGES/api.models.webhook.po +++ b/docs/locale/fr/LC_MESSAGES/api.models.webhook.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.webhook.rst:4 msgid "Webhook Models" @@ -209,7 +209,7 @@ msgid "embedded ``rich`` content" msgstr "" #: interactions.api.models.webhook.Webhook.execute:18 of -msgid "allowed mentions for the message" +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.webhook.Webhook.execute:20 of @@ -257,3 +257,6 @@ msgstr "" #: interactions.api.models.webhook.WebhookType:1 of msgid "Valid values are as follows:" msgstr "" + +#~ msgid "allowed mentions for the message" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/client.po b/docs/locale/fr/LC_MESSAGES/client.po index 854019fc5..48424e61c 100644 --- a/docs/locale/fr/LC_MESSAGES/client.po +++ b/docs/locale/fr/LC_MESSAGES/client.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../client.rst:4 msgid "Bot Client" @@ -31,10 +31,6 @@ msgstr "" #: interactions.client.bot.Client #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence @@ -44,6 +40,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.user_command #: interactions.client.bot.Extension of msgid "Parameters" @@ -80,60 +77,73 @@ msgid "" "automatic or not." msgstr "" +#: interactions.client.bot.Client:15 of +msgid "" +"Set to ``True`` to enable debug logging or set to a log level to use a " +"specific level" +msgstr "" + #: interactions.client.bot.Client of msgid "Variables" msgstr "" -#: interactions.client.bot.Client:16 of +#: interactions.client.bot.Client:18 of msgid "The asynchronous event loop of the client." msgstr "" -#: interactions.client.bot.Client:17 of +#: interactions.client.bot.Client:19 of msgid "" "The user-facing HTTP connection to the Web API, as its own separate " "client." msgstr "" -#: interactions.client.bot.Client:18 of +#: interactions.client.bot.Client:20 of msgid "An object-orientation of a websocket server connection to the Gateway." msgstr "" -#: interactions.client.bot.Client:19 of +#: interactions.client.bot.Client:21 of msgid "The Gateway intents of the application. Defaults to ``Intents.DEFAULT``." msgstr "" -#: interactions.client.bot.Client:20 of +#: interactions.client.bot.Client:22 of msgid "The list of bucketed shards for the application's connection." msgstr "" -#: interactions.client.bot.Client:21 of +#: interactions.client.bot.Client:23 of msgid "The RPC-like presence shown on an application once connected." msgstr "" -#: interactions.client.bot.Client:22 of +#: interactions.client.bot.Client:24 of msgid "The token of the application used for authentication when connecting." msgstr "" -#: interactions.client.bot.Client:23 of +#: interactions.client.bot.Client:25 of msgid "The \"extensions\" or cog equivalence registered to the main client." msgstr "" -#: interactions.client.bot.Client:24 of +#: interactions.client.bot.Client:26 of msgid "The application representation of the client." msgstr "" -#: interactions.client.bot.Client +#: interactions.client.bot.Client.guilds:1 of +msgid "Returns a list of guilds the bot is in." +msgstr "" + +#: interactions.client.bot.Client.latency:1 of +msgid "Returns the connection latency in milliseconds." +msgstr "" + +#: interactions.client.bot.Client.start:1 of +msgid "Starts the client session." +msgstr "" + #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create -#: interactions.client.bot.Client.__register_events #: interactions.client.bot.Client.__resolve_commands #: interactions.client.bot.Client.__sync #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client._login interactions.client.bot.Client._ready +#: interactions.client.bot.Client._stop #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence #: interactions.client.bot.Client.command @@ -142,6 +152,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.start #: interactions.client.bot.Client.user_command #: interactions.client.bot.Client.wait_until_ready @@ -149,22 +160,6 @@ msgstr "" msgid "Return type" msgstr "" -#: interactions.client.bot.Client.guilds:1 of -msgid "Returns a list of guilds the bot is in." -msgstr "" - -#: interactions.client.bot.Client.latency:1 of -msgid "Returns the connection latency in milliseconds." -msgstr "" - -#: interactions.client.bot.Client.start:1 of -msgid "Starts the client session." -msgstr "" - -#: interactions.client.bot.Client.__register_events:1 of -msgid "Registers all raw gateway events to the known events." -msgstr "" - #: interactions.client.bot.Client.__compare_sync:1 of msgid "Compares an application command during the synchronization process." msgstr "" @@ -178,10 +173,6 @@ msgid "The \"pool\" or list of commands to compare from." msgstr "" #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.command @@ -204,6 +195,10 @@ msgid "" "conditions have been met in a chronological order:" msgstr "" +#: interactions.client.bot.Client._stop:1 of +msgid "Stops the websocket connection gracefully." +msgstr "" + #: interactions.client.bot.Client._login:1 of msgid "Makes a login with the Discord API." msgstr "" @@ -448,7 +443,7 @@ msgid "" msgstr "" #: interactions.client.bot.Client._find_command:3 of -msgid "The name of the command to match" +msgid "The name or ID of the command to match" msgstr "" #: interactions.client.bot.Client._find_command:5 of @@ -574,59 +569,34 @@ msgstr "" msgid "The modified User object" msgstr "" -#: interactions.client.bot.Client.__raw_socket_create:1 of -msgid "" -"This is an internal function that takes any gateway socket event and then" -" returns the data purely based off of what it does in the client " -"instantiation class." -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:5 of -msgid "The data that is returned" -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:7 of -msgid "A dictionary of raw data." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:1 of -msgid "" -"This is an internal function that caches the channel creates when " -"dispatched." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:3 of -msgid "The channel object data in question." +#: interactions.client.bot.Client.request_guild_members:1 of +msgid "Requests guild members via websocket." msgstr "" -#: interactions.client.bot.Client.__raw_channel_create:5 of -msgid "The channel as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:3 of +msgid "ID of the guild to get members for." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:1 of +#: interactions.client.bot.Client.request_guild_members:5 of msgid "" -"This is an internal function that caches the message creates when " -"dispatched." +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:3 of -msgid "The message object data in question." +#: interactions.client.bot.Client.request_guild_members:7 of +msgid "String that username starts with." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:5 of -msgid "The message as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:1 of -msgid "This is an internal function that caches the guild creates on ready." +#: interactions.client.bot.Client.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:3 of -msgid "The guild object data in question." -msgstr "" - -#: interactions.client.bot.Client.__raw_guild_create:5 of -msgid "The guild as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." msgstr "" #: interactions.client.bot.Extension:1 of @@ -639,3 +609,56 @@ msgstr "" #: interactions.client.bot.Extension:5 of msgid "The structure of an extension:" msgstr "" + +#~ msgid "Registers all raw gateway events to the known events." +#~ msgstr "" + +#~ msgid "The name of the command to match" +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "takes any gateway socket event and " +#~ "then returns the data purely based " +#~ "off of what it does in the " +#~ "client instantiation class." +#~ msgstr "" + +#~ msgid "The data that is returned" +#~ msgstr "" + +#~ msgid "A dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the channel creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The channel object data in question." +#~ msgstr "" + +#~ msgid "The channel as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the message creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The message object data in question." +#~ msgstr "" + +#~ msgid "The message as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "This is an internal function that caches the guild creates on ready." +#~ msgstr "" + +#~ msgid "The guild object data in question." +#~ msgstr "" + +#~ msgid "The guild as a dictionary of raw data." +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/context.po b/docs/locale/fr/LC_MESSAGES/context.po index 3917f5b73..8352a5d3e 100644 --- a/docs/locale/fr/LC_MESSAGES/context.po +++ b/docs/locale/fr/LC_MESSAGES/context.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../context.rst:4 msgid "Event Context" @@ -55,7 +55,6 @@ msgstr "" msgid "The guild data model." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update #: interactions.client.context.CommandContext #: interactions.client.context.CommandContext.defer #: interactions.client.context.CommandContext.edit @@ -63,12 +62,15 @@ msgstr "" #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context #: interactions.client.context._Context.edit +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup -#: interactions.client.context._Context.send of +#: interactions.client.context._Context.send +#: interactions.utils.attrs_utils.DictSerializerMixin.update of msgid "Parameters" msgstr "" @@ -79,11 +81,13 @@ msgstr "" #: interactions.client.context.CommandContext.edit #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.send of msgid "Returns" msgstr "" @@ -98,11 +102,13 @@ msgstr "" #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup #: interactions.client.context._Context.send of msgid "Return type" @@ -153,7 +159,7 @@ msgstr "" #: interactions.client.context.CommandContext.send:12 #: interactions.client.context.ComponentContext.send:12 #: interactions.client.context._Context.send:12 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.client.context.CommandContext.send:14 @@ -171,6 +177,12 @@ msgstr "" #: interactions.client.context.CommandContext.send:18 #: interactions.client.context.ComponentContext.send:18 #: interactions.client.context._Context.send:18 of +msgid "Whether embeds are not shown in the message." +msgstr "" + +#: interactions.client.context.CommandContext.send:20 +#: interactions.client.context.ComponentContext.send:20 +#: interactions.client.context._Context.send:20 of msgid "The sent message as an object." msgstr "" @@ -197,13 +209,39 @@ msgstr "" msgid "The components you wish to show." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:1 of +#: interactions.client.context._Context.has_permissions:1 of +msgid "" +"Returns whether the author of the interaction has the permissions in the " +"given context." +msgstr "" + +#: interactions.client.context._Context.has_permissions:3 of +msgid "The list of permissions" +msgstr "" + +#: interactions.client.context._Context.has_permissions:5 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.client.context._Context.has_permissions:7 of +msgid "Whether the author has the permissions" +msgstr "" + +#: ../../docstring interactions.client.context.CommandContext._extras:1 +#: interactions.client.context.ComponentContext._extras:1 +#: interactions.client.context._Context._extras:1 of +msgid "A dict containing values that were not serialized from Discord." +msgstr "" + +#: interactions.utils.attrs_utils.DictSerializerMixin.update:1 of msgid "" "Update an object with new attributes. All data will be converted, and any" " extra attributes will be put in _extras" msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:4 of +#: interactions.utils.attrs_utils.DictSerializerMixin.update:4 of msgid "The dictionary to update from" msgstr "" @@ -286,6 +324,18 @@ msgid "" " was sent from." msgstr "" +#: interactions.client.context.CommandContext:30 of +msgid "The client instance that the command belongs to." +msgstr "" + +#: interactions.client.context.CommandContext:31 of +msgid "The command object that is being invoked." +msgstr "" + +#: interactions.client.context.CommandContext:32 of +msgid "The extension the command belongs to." +msgstr "" + #: interactions.client.context.CommandContext.defer:1 of msgid "" "This \"defers\" an interaction response, allowing up to a 15-minute delay" @@ -342,3 +392,31 @@ msgstr "" #: interactions.client.context.ComponentContext.defer:6 of msgid "Whether you want to edit the original message or send a followup message" msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:1 of +msgid "Disables all components of the message." +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:3 of +msgid "" +"Whether the components should be disabled in an interaction response, " +"default True" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:5 of +msgid "" +"Additional keyword-arguments to pass to the edit method. This only works " +"when this method is used as interaction response and takes the same " +"arguments as :meth:`interactions.client.context._Context:edit()`" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:8 of +msgid "The modified Message" +msgstr "" + +#: interactions.client.context.ComponentContext.label:1 of +msgid "The label of the interacted button. :rtype: Optional[str]" +msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/events.po b/docs/locale/fr/LC_MESSAGES/events.po index b91a1dc02..7b4ecba7d 100644 --- a/docs/locale/fr/LC_MESSAGES/events.po +++ b/docs/locale/fr/LC_MESSAGES/events.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../events.rst:2 msgid "Event Documentation" @@ -98,99 +98,104 @@ msgid "``on_command``" msgstr "" #: ../../events.rst:57 -msgid "``on_component``" +msgid "``on_command_error``" msgstr "" #: ../../events.rst:58 -msgid "``on_autocomplete``" +msgid "``on_component``" msgstr "" #: ../../events.rst:59 +msgid "``on_autocomplete``" +msgstr "" + +#: ../../events.rst:60 msgid "``on_modal``" msgstr "" -#: ../../events.rst:61 +#: ../../events.rst:62 msgid "Lets now have a look at those events in detail:" msgstr "" -#: ../../events.rst:64 +#: ../../events.rst:65 msgid "Event: ``raw_socket_create``" msgstr "" -#: ../../events.rst:65 +#: ../../events.rst:66 msgid "" "This event fires on any event sent by Discord, including ``Typing Start``" " and ``Voice State Update``. ``Hello``, ``Resumed``, ``Reconnect`` and " "``Invalid Session`` still will not be dispatched." msgstr "" -#: ../../events.rst:68 +#: ../../events.rst:69 msgid "" -"The function handling the event should take in one argument, the type of " -"this argument is a ``dict``." +"A function handling an event should take two arguments, the first " +"argument is the name of the event, the second is the data of that event " +"with type ``dict``." msgstr "" -#: ../../events.rst:70 +#: ../../events.rst:72 msgid "" -"The value of the argument will be the *raw* data sent from Discord, so it" -" is not recommended to use that event as long as you don't absolutely " -"need it." +"The value of the second argument will be the *raw* data sent from " +"Discord, so it is not recommended to use that event as long as you don't " +"absolutely need it." msgstr "" -#: ../../events.rst:75 +#: ../../events.rst:77 msgid "Event: ``on_start``" msgstr "" -#: ../../events.rst:76 +#: ../../events.rst:78 msgid "This event fires only when the bot is started." msgstr "" -#: ../../events.rst:78 ../../events.rst:161 +#: ../../events.rst:80 ../../events.rst:173 msgid "This function takes no arguments." msgstr "" -#: ../../events.rst:81 +#: ../../events.rst:83 msgid "Unlike ``on_ready``, this event will never be dispatched more than once." msgstr "" -#: ../../events.rst:84 +#: ../../events.rst:86 msgid "Event: ``on_interaction``" msgstr "" -#: ../../events.rst:85 +#: ../../events.rst:87 msgid "" "This event fires on any interaction (commands, components, autocomplete " "and modals)." msgstr "" -#: ../../events.rst:87 +#: ../../events.rst:89 msgid "" "The function needs one argument. It will have the type ``CommandContext``" " or ``ComponentContext``." msgstr "" -#: ../../events.rst:89 +#: ../../events.rst:91 msgid "" "Because you will have to check for everything, from the " "``InteractionType`` to any data inside the context, we do not recommend " "using this event unless you have experience with it." msgstr "" -#: ../../events.rst:94 +#: ../../events.rst:96 msgid "Event: ``on_command``" msgstr "" -#: ../../events.rst:95 +#: ../../events.rst:97 msgid "" "This event fires on any Application Command (slash command + context menu" " command) used." msgstr "" -#: ../../events.rst:97 ../../events.rst:117 ../../events.rst:127 +#: ../../events.rst:99 ../../events.rst:129 ../../events.rst:139 msgid "The function takes in one argument of the type ``CommandContext``." msgstr "" -#: ../../events.rst:99 +#: ../../events.rst:101 msgid "" "Using this event, you will have to manually check everything, from name " "to whether the used commands have sub commands, options or anything else " @@ -198,138 +203,174 @@ msgid "" "it" msgstr "" -#: ../../events.rst:104 +#: ../../events.rst:106 +msgid "Event: ``on_command_error``" +msgstr "" + +#: ../../events.rst:107 +msgid "This event fires when the following conditions are met:" +msgstr "" + +#: ../../events.rst:109 +msgid "There is an error in the command (or subcommand within the command)" +msgstr "" + +#: ../../events.rst:110 +msgid "There is no error callback assigned to that command" +msgstr "" + +#: ../../events.rst:112 +msgid "" +"The function takes in two arguments, one of the type ``CommandContext``, " +"and the other contains the error." +msgstr "" + +#: ../../events.rst:116 msgid "Event: ``on_component``" msgstr "" -#: ../../events.rst:105 +#: ../../events.rst:117 msgid "" "This event fires on any Component used (for now, those are Buttons and " "Select Menus)." msgstr "" -#: ../../events.rst:107 +#: ../../events.rst:119 msgid "The function takes in one argument of the type ``ComponentContext``." msgstr "" -#: ../../events.rst:109 +#: ../../events.rst:121 msgid "" "Like ``on_command``, you will have to manually check for everything, i.e " "for custom id and component type. Also, you will have to look through the" " argument to find the selected choices, if you have a select menu." msgstr "" -#: ../../events.rst:114 +#: ../../events.rst:126 msgid "Event: ``on_autocomplete``" msgstr "" -#: ../../events.rst:115 +#: ../../events.rst:127 msgid "This event fires on any autocomplete triggered." msgstr "" -#: ../../events.rst:119 +#: ../../events.rst:131 msgid "" "As already in the events above, you will have to get the important values" " yourself. Those values are here the autocompleted option and the user " "input." msgstr "" -#: ../../events.rst:124 +#: ../../events.rst:136 msgid "Event: ``on_modal``" msgstr "" -#: ../../events.rst:125 +#: ../../events.rst:137 msgid "This event fires on every modal that is submitted." msgstr "" -#: ../../events.rst:129 +#: ../../events.rst:141 msgid "" "You will have to get all values yourself and check what modal was used " "when using this event." msgstr "" -#: ../../events.rst:132 +#: ../../events.rst:144 msgid "" "Additionally, if you struggle with getting the values, you can check " ":ref:`how it is handled internally `." msgstr "" -#: ../../events.rst:136 +#: ../../events.rst:148 msgid "After this, let us look at events from the Discord API." msgstr "" -#: ../../events.rst:139 +#: ../../events.rst:151 msgid "Discord API Events" msgstr "" -#: ../../events.rst:141 +#: ../../events.rst:153 msgid "" "Events in this section do not match the name needed to put into the " "function. Please check :ref:`above ` for how to get the correct name." msgstr "" -#: ../../events.rst:145 +#: ../../events.rst:157 msgid "" "There are a lot of events dispatched by the Discord API. All of those can" " be found `here`_." msgstr "" -#: ../../events.rst:147 +#: ../../events.rst:159 msgid "" "The events ``HELLO``, ``RESUMED``, ``RECONNECT``, ``INVALID SESSION`` and" " ``TYPING START`` are not dispatched by the library." msgstr "" -#: ../../events.rst:149 +#: ../../events.rst:161 msgid "" "``TYPING START`` will be included in the raw socket create event. You can" " also listen for it if you choose to subclass the WebSocketClient" msgstr "" -#: ../../events.rst:152 +#: ../../events.rst:164 msgid "" "The event ``VOICE STATE UPDATE`` can be only received with the voice " ":ref:`Extension `." msgstr "" -#: ../../events.rst:155 +#: ../../events.rst:167 msgid "Let's now have a look at a few events:" msgstr "" -#: ../../events.rst:158 +#: ../../events.rst:170 msgid "Event: ``READY``" msgstr "" -#: ../../events.rst:159 +#: ../../events.rst:171 msgid "" "This event fires whenever ``READY`` is dispatched by Discord. This " "happens when connecting to the web socket server." msgstr "" -#: ../../events.rst:164 +#: ../../events.rst:176 msgid "" "Due to the bot reconnecting during runtime, ``on_ready`` will be " "dispatched multiple times. If you rely on ``on_ready`` to do certain " "things once, check against a global variable as shown below:" msgstr "" -#: ../../events.rst:181 +#: ../../events.rst:193 msgid "Events: ``GUILD MEMBER UPDATE`` and ``GUILD MEMBER ADD``" msgstr "" -#: ../../events.rst:182 +#: ../../events.rst:194 msgid "" "These events fire whenever a member joins a guild or a member of a guild " "gets modified." msgstr "" -#: ../../events.rst:184 +#: ../../events.rst:196 msgid "The function takes in one argument of the type ``GuildMember``." msgstr "" -#: ../../events.rst:186 +#: ../../events.rst:198 msgid "" "The argument has the same methods as a normal ``Member`` object, except " "the methods *do not take in a guild id*. Please keep that in mind when " "using this event." msgstr "" + +#~ msgid "" +#~ "The function handling the event should" +#~ " take in one argument, the type " +#~ "of this argument is a ``dict``." +#~ msgstr "" + +#~ msgid "" +#~ "The value of the argument will be" +#~ " the *raw* data sent from Discord," +#~ " so it is not recommended to " +#~ "use that event as long as you " +#~ "don't absolutely need it." +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/faq.po b/docs/locale/fr/LC_MESSAGES/faq.po index 1bf421161..09e3ae8c9 100644 --- a/docs/locale/fr/LC_MESSAGES/faq.po +++ b/docs/locale/fr/LC_MESSAGES/faq.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../faq.rst:2 msgid "Frequently Asked Questions" @@ -283,12 +283,12 @@ msgstr "" #: ../../faq.rst:157 msgid "" -"A `voice client`_ - which is still WIP, but it is able to listen for the " +"`voice client`_ - which is still WIP, but it is able to listen for the " "``VOICE_STATE_UPDATE`` event." msgstr "" #: ../../faq.rst:158 -msgid "An `autosharder`_ for automatic sharding" +msgid "`autosharder`_ for automatic sharding" msgstr "" #: ../../faq.rst:159 @@ -310,146 +310,148 @@ msgid "`enhanced`_ which enhances the DX in general" msgstr "" #: ../../faq.rst:163 -msgid "A `paginator`_ for paginating embeds on messages using components" +msgid "`paginator`_ for paginating embeds on messages using components" msgstr "" #: ../../faq.rst:164 msgid "" -"`persistence`_ - for storing data inside your custom IDs (as an " -"alternative to ``wait_for``)" +"`persistence`_ for storing data inside your custom IDs (as an alternative" +" to ``wait_for``)" msgstr "" #: ../../faq.rst:165 -msgid "And a `boilerplate`_" +msgid "`lavalink`_ for voice sending and listening ``VOICE_STATE_UPDATE`` event" +msgstr "" + +#: ../../faq.rst:166 +msgid "`fastapi`_ for building own API" msgstr "" #: ../../faq.rst:167 +msgid "And a `boilerplate`_" +msgstr "" + +#: ../../faq.rst:169 msgid "" "Below are a few unofficial exts (for the time being) which implement some" " functionality similar to what d.py had:" msgstr "" -#: ../../faq.rst:169 +#: ../../faq.rst:171 msgid "`checks and cooldowns`_" msgstr "" -#: ../../faq.rst:170 +#: ../../faq.rst:172 msgid "`tasks`_" msgstr "" -#: ../../faq.rst:171 -msgid "" -"`get`_ for getting objects from the discord API (will be implemented into" -" the core library at a later time)" -msgstr "" - -#: ../../faq.rst:173 +#: ../../faq.rst:174 msgid "Usage examples can usually be found at the linked page" msgstr "" -#: ../../faq.rst:177 +#: ../../faq.rst:178 msgid "Can I make an Extension Library myself?" msgstr "" -#: ../../faq.rst:178 +#: ../../faq.rst:179 msgid "" "Yeah, you can! We have a special channel reserved for the development of " "external libraries! You can also read `this `_ for more information." msgstr "" -#: ../../faq.rst:183 +#: ../../faq.rst:184 msgid "" "I'm getting \"``AttributeError: HTTPClient not found!``\" when I try to " "execute helper methods!" msgstr "" -#: ../../faq.rst:184 +#: ../../faq.rst:185 msgid "Probably you are doing something like this:" msgstr "" -#: ../../faq.rst:191 +#: ../../faq.rst:192 msgid "" "And the error occurs in the line where you try to send something. You can" " fix this easy by adding one argument:" msgstr "" -#: ../../faq.rst:198 +#: ../../faq.rst:199 msgid "" "You have to add this extra argument for every object you instantiate by " "yourself if you want to use it's methods" msgstr "" -#: ../../faq.rst:202 +#: ../../faq.rst:203 msgid "" "Context and Messages don't have the ``Channel`` and ``Guild`` attributes!" " Why?" msgstr "" -#: ../../faq.rst:203 +#: ../../faq.rst:204 msgid "" "At the moment the Discord API does *not* include them into their " "responses. You can get those object via the ``get_channel()`` and " "``get_guild()`` methods of the Context and Message model." msgstr "" -#: ../../faq.rst:208 +#: ../../faq.rst:209 msgid "\"``ctx.send got an unexpected keyword argument: files``\"! Why?" msgstr "" -#: ../../faq.rst:209 +#: ../../faq.rst:210 msgid "" "It is not supported due to an decision of the core developer team. There " "are two ways to do it:" msgstr "" -#: ../../faq.rst:212 +#: ../../faq.rst:213 msgid "Using ``await channel.send`` instead" msgstr "" -#: ../../faq.rst:213 +#: ../../faq.rst:214 msgid "Using the `files`_ extension" msgstr "" -#: ../../faq.rst:217 +#: ../../faq.rst:218 msgid "\"``ctx.send got an unexpected keyword argument: embed``\"! Why?" msgstr "" -#: ../../faq.rst:218 +#: ../../faq.rst:219 msgid "" "This is quite simple: The argument ``embed`` got deprecated by Discord. " "The new naming is ``embeds``." msgstr "" -#: ../../faq.rst:222 +#: ../../faq.rst:223 msgid "How can I check what exception happened during a request?" msgstr "" -#: ../../faq.rst:223 +#: ../../faq.rst:224 msgid "We, unlike d.py, do not offer something like ``interactions.NotFound``." msgstr "" -#: ../../faq.rst:225 +#: ../../faq.rst:226 msgid "Instead you have to do it like this:" msgstr "" -#: ../../faq.rst:228 +#: ../../faq.rst:229 msgid "" "This feature will be implemented with version 4.3 and is currently only " "available on beta/unstable" msgstr "" -#: ../../faq.rst:242 +#: ../../faq.rst:243 msgid "" "You can additionally get the exact reason for why the exception occurred " "with ``e.message`` or ``e.lookup(e.code)``" msgstr "" -#: ../../faq.rst:246 +#: ../../faq.rst:247 msgid "My message content is always empty! How can I fix this?" msgstr "" -#: ../../faq.rst:247 +#: ../../faq.rst:248 msgid "" "This happens because you did not enable the intent for message content. " "Enable it on the developer portal and add it into the ``Client`` " @@ -459,11 +461,11 @@ msgid "" "``Intents.DEFAULT``, it can be any other intent(s) you need!" msgstr "" -#: ../../faq.rst:254 +#: ../../faq.rst:255 msgid "Is there something like ``Cogs``?" msgstr "" -#: ../../faq.rst:255 +#: ../../faq.rst:256 msgid "" "Yes! Although, we call them ``Extensions``. Yeah, like :ref:`Extension " "Libraries `. This is because an extension " @@ -471,39 +473,39 @@ msgid "" "how you create an extension for yourself:" msgstr "" -#: ../../faq.rst:283 +#: ../../faq.rst:284 msgid "It's nothing more than that." msgstr "" -#: ../../faq.rst:285 +#: ../../faq.rst:286 msgid "" "Since ``@bot.X`` decorators don't work in extensions, you have to use " "these:" msgstr "" -#: ../../faq.rst:287 +#: ../../faq.rst:288 msgid "For event listeners, use ``@interactions.extension_listener``" msgstr "" -#: ../../faq.rst:288 +#: ../../faq.rst:289 msgid "For component listeners, use ``@interactions.extension_component``" msgstr "" -#: ../../faq.rst:289 +#: ../../faq.rst:290 msgid "For modal listeners, use ``@interactions.extension_modal``" msgstr "" -#: ../../faq.rst:290 +#: ../../faq.rst:291 msgid "For autocomplete listeners, use ``@interactions.extension_autocomplete``" msgstr "" -#: ../../faq.rst:294 +#: ../../faq.rst:295 msgid "" "``channel.members`` does not exist, how do I get the people in a voice " "channel?" msgstr "" -#: ../../faq.rst:295 +#: ../../faq.rst:296 msgid "" "``channel.members`` actually does exist, but is reserved for threads. " "There is no attribute for people in a voice channel by the API. The only " @@ -512,12 +514,37 @@ msgid "" " updated when a member joins or leaves." msgstr "" -#: ../../faq.rst:301 +#: ../../faq.rst:302 msgid "My question is not answered on here!" msgstr "" -#: ../../faq.rst:302 +#: ../../faq.rst:303 msgid "" "Please join our `Discord Server`_ for any further support regarding our " "library and/or any integration code depending on it." msgstr "" + +#~ msgid "" +#~ "A `voice client`_ - which is still" +#~ " WIP, but it is able to listen" +#~ " for the ``VOICE_STATE_UPDATE`` event." +#~ msgstr "" + +#~ msgid "An `autosharder`_ for automatic sharding" +#~ msgstr "" + +#~ msgid "A `paginator`_ for paginating embeds on messages using components" +#~ msgstr "" + +#~ msgid "" +#~ "`persistence`_ - for storing data inside" +#~ " your custom IDs (as an alternative" +#~ " to ``wait_for``)" +#~ msgstr "" + +#~ msgid "" +#~ "`get`_ for getting objects from the " +#~ "discord API (will be implemented into" +#~ " the core library at a later " +#~ "time)" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/index.po b/docs/locale/fr/LC_MESSAGES/index.po index 91465f9df..d7a1d6841 100644 --- a/docs/locale/fr/LC_MESSAGES/index.po +++ b/docs/locale/fr/LC_MESSAGES/index.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../index.rst:47 msgid "Pages:" @@ -51,7 +51,7 @@ msgstr "" #: ../../index.rst:11 msgid "" "Look no more! The goal of this library is to make all three of these " -"questions go from possibilites to trivial matters." +"questions go from possibilities to trivial matters." msgstr "" #: ../../index.rst:14 @@ -181,7 +181,7 @@ msgid "**black** ``22.6.0``" msgstr "" #: ../../index.rst:66 -msgid "**flake8** ``4.0.1``" +msgid "**flake8** ``5.0.4``" msgstr "" #: ../../index.rst:67 @@ -190,7 +190,7 @@ msgstr "" #: ../../index.rst:69 msgid "" -"**Sphinx** ``4.4.0``: all of our documentation is powered off of " +"**Sphinx** ``5.1.1``: all of our documentation is powered off of " "autogenerated documentation of the Sphinx engine." msgstr "" @@ -247,3 +247,20 @@ msgstr "" #: ../../index.rst:88 msgid ":ref:`modindex`" msgstr "" + +#~ msgid "" +#~ "Look no more! The goal of this " +#~ "library is to make all three of" +#~ " these questions go from possibilites " +#~ "to trivial matters." +#~ msgstr "" + +#~ msgid "**flake8** ``4.0.1``" +#~ msgstr "" + +#~ msgid "" +#~ "**Sphinx** ``4.4.0``: all of our " +#~ "documentation is powered off of " +#~ "autogenerated documentation of the Sphinx " +#~ "engine." +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/migration.po b/docs/locale/fr/LC_MESSAGES/migration.po index 9f0d8e6aa..3546c747d 100644 --- a/docs/locale/fr/LC_MESSAGES/migration.po +++ b/docs/locale/fr/LC_MESSAGES/migration.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../migration.rst:2 msgid "Migration" @@ -126,7 +126,9 @@ msgid "" msgstr "" #: ../../migration.rst:99 -msgid "You can get more information by reading the `get-documentation`_." +msgid "" +"You can get more information by reading the " +":meth:`interactions.client.get.get`-documentation" msgstr "" #: ../../migration.rst:102 @@ -148,3 +150,6 @@ msgid "" "your argument in your function differently than your option name! " "Example:" msgstr "" + +#~ msgid "You can get more information by reading the `get-documentation`_." +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/models.command.po b/docs/locale/fr/LC_MESSAGES/models.command.po index 5c72da5b0..a7fca335f 100644 --- a/docs/locale/fr/LC_MESSAGES/models.command.po +++ b/docs/locale/fr/LC_MESSAGES/models.command.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.command.rst:4 msgid "Application Command Models" @@ -37,8 +37,10 @@ msgid "The structure for a choice:" msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission of msgid "Variables" @@ -56,13 +58,14 @@ msgstr "" #: interactions.client.models.command.Command:16 #: interactions.client.models.command.Command.group:28 #: interactions.client.models.command.Command.subcommand:33 -#: interactions.client.models.command.Option:34 of +#: interactions.client.models.command.Option:36 of msgid "" "The dictionary of localization for the ``name`` field. This enforces the " "same restrictions as the ``name`` field." msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command #: interactions.client.models.command.Command.__call @@ -72,6 +75,7 @@ msgstr "" #: interactions.client.models.command.Command.error #: interactions.client.models.command.Command.group #: interactions.client.models.command.Command.subcommand +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission #: interactions.client.models.command.option of @@ -100,8 +104,7 @@ msgstr "" msgid "The type of option." msgstr "" -#: interactions.client.models.command.Option:23 -#: interactions.client.models.command.option:14 of +#: interactions.client.models.command.Option:23 of msgid "The name of the option." msgstr "" @@ -142,19 +145,27 @@ msgid "The maximum value supported by the option." msgstr "" #: interactions.client.models.command.Option:33 of +msgid "The minimum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:34 of +msgid "The maximum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:35 of msgid "A status denoting whether this option is an autocomplete option." msgstr "" #: interactions.client.models.command.Command:17 #: interactions.client.models.command.Command.group:30 #: interactions.client.models.command.Command.subcommand:35 -#: interactions.client.models.command.Option:35 of +#: interactions.client.models.command.Option:37 of msgid "" "The dictionary of localization for the ``description`` field. This " "enforces the same restrictions as the ``description`` field." msgstr "" -#: interactions.client.models.command.Option:36 of +#: interactions.client.models.command.Option:38 of msgid "How the option value is passed to the function, if different than ``name``" msgstr "" @@ -248,18 +259,26 @@ msgid "A decorator for adding options to a command." msgstr "" #: interactions.client.models.command.option:3 of -msgid "The structure of an option:" +msgid "" +"The ``type`` and ``name`` of the option are defaulted to the parameter's " +"typehint and name." +msgstr "" + +#: interactions.client.models.command.option:5 of +msgid "" +"When the ``name`` of the option differs from the parameter name, the " +"``converter`` field will default to the name of the parameter." msgstr "" -#: interactions.client.models.command.option:12 of -msgid "The type of the option." +#: interactions.client.models.command.option:8 of +msgid "The structure of an option:" msgstr "" -#: interactions.client.models.command.option:16 of -msgid "The description of the option. Defaults to ``\"No description set\"``." +#: interactions.client.models.command.option:17 of +msgid "The description of the option. Defaults to \"No description set\"." msgstr "" -#: interactions.client.models.command.option:18 of +#: interactions.client.models.command.option:19 of msgid "The keyword arguments of the option, same as :class:`Option`." msgstr "" @@ -283,6 +302,8 @@ msgstr "" msgid "A class that when returned from a command, the command chain is stopped." msgstr "" +#: interactions.client.models.command.BaseResult:3 +#: interactions.client.models.command.GroupResult:3 #: interactions.client.models.command.StopCommand:3 of msgid "Usage:" msgstr "" @@ -291,6 +312,32 @@ msgstr "" msgid "This allows for custom checks that allow stopping the command chain." msgstr "" +#: interactions.client.models.command.BaseResult:1 +#: interactions.client.models.command.GroupResult:1 of +msgid "A class object representing the result of the base command." +msgstr "" + +#: interactions.client.models.command.BaseResult:17 of +msgid "" +"If the subcommand coroutine does not have enough parameters, the " +"``BaseResult`` will not be passed." +msgstr "" + +#: interactions.client.models.command.BaseResult:19 +#: interactions.client.models.command.GroupResult:25 of +msgid "The result of the base command." +msgstr "" + +#: interactions.client.models.command.GroupResult:23 of +msgid "" +"If the subcommand does not have enough arguments, the ``GroupResult`` " +"will not be passed." +msgstr "" + +#: interactions.client.models.command.GroupResult:26 of +msgid "The parent ``BaseResult``." +msgstr "" + #: interactions.client.models.command.Command:1 of msgid "A class object representing a command." msgstr "" @@ -364,6 +411,14 @@ msgstr "" msgid "The extension that the command belongs to, if any." msgstr "" +#: interactions.client.models.command.Command:26 of +msgid "The client that the command belongs to." +msgstr "" + +#: interactions.client.models.command.Command:27 of +msgid "The listener, used for dispatching command errors." +msgstr "" + #: interactions.client.models.command.Command.converters:1 of msgid "" "Returns a dictionary with all converters added to the options of the " @@ -525,3 +580,9 @@ msgid "" ":class:`interactions.client.bot.Extension` is passed to the coroutine, if" " any." msgstr "" + +#~ msgid "The type of the option." +#~ msgstr "" + +#~ msgid "The description of the option. Defaults to ``\"No description set\"``." +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/models.component.po b/docs/locale/fr/LC_MESSAGES/models.component.po index ae186054c..ce3834826 100644 --- a/docs/locale/fr/LC_MESSAGES/models.component.po +++ b/docs/locale/fr/LC_MESSAGES/models.component.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.component.rst:4 msgid "Component Models" @@ -257,36 +257,18 @@ msgid "The maximum length of the input." msgstr "" #: interactions.client.models.component.Modal:1 of -msgid "A class object representing a modal." +msgid "A class object representing a modal. The structure for a modal: ::" msgstr "" -#: interactions.client.models.component.Modal:8 of -msgid "The structure for a modal: ::" -msgstr "" - -#: interactions.client.models.component.Modal:6 of -msgid "interactions.Modal(" -msgstr "" - -#: interactions.client.models.component.Modal:5 of -msgid "" -"title=\"Application Form\", custom_id=\"mod_app_form\", " -"components=[interactions.TextInput(...)]," -msgstr "" - -#: interactions.client.models.component.Modal:8 of -msgid ")" -msgstr "" - -#: interactions.client.models.component.Modal:10 of +#: interactions.client.models.component.Modal:9 of msgid "The custom ID of the modal." msgstr "" -#: interactions.client.models.component.Modal:11 of +#: interactions.client.models.component.Modal:10 of msgid "The title of the modal." msgstr "" -#: interactions.client.models.component.Modal:12 of +#: interactions.client.models.component.Modal:11 of msgid "The components of the modal." msgstr "" @@ -302,22 +284,22 @@ msgid "" " also support only 1 text input component only." msgstr "" -#: interactions.client.models.component.ActionRow:13 of -msgid "The structure for an action row: ::" +#: interactions.client.models.component.ActionRow:8 of +msgid "The structure for an action row: ..code-block:: python" msgstr "" -#: interactions.client.models.component.ActionRow:9 of +#: interactions.client.models.component.ActionRow:10 of msgid "" "# \"...\" represents a component object. # Method 1: " "interactions.ActionRow(...) # Method 2: " "interactions.ActionRow(components=[...])" msgstr "" -#: interactions.client.models.component.ActionRow:15 of +#: interactions.client.models.component.ActionRow:16 of msgid "The type of component. Always defaults to ``1``." msgstr "" -#: interactions.client.models.component.ActionRow:16 of +#: interactions.client.models.component.ActionRow:17 of msgid "A list of components the ActionRow has, if any." msgstr "" @@ -340,3 +322,23 @@ msgstr "" #: interactions.client.models.component.ActionRow.new of msgid "Return type" msgstr "" + +#~ msgid "A class object representing a modal." +#~ msgstr "" + +#~ msgid "The structure for a modal: ::" +#~ msgstr "" + +#~ msgid "interactions.Modal(" +#~ msgstr "" + +#~ msgid "" +#~ "title=\"Application Form\", custom_id=\"mod_app_form\"," +#~ " components=[interactions.TextInput(...)]," +#~ msgstr "" + +#~ msgid ")" +#~ msgstr "" + +#~ msgid "The structure for an action row: ::" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/models.misc.po b/docs/locale/fr/LC_MESSAGES/models.misc.po index 9ea8f4346..31ef0b3e5 100644 --- a/docs/locale/fr/LC_MESSAGES/models.misc.po +++ b/docs/locale/fr/LC_MESSAGES/models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.misc.rst:4 msgid "Miscellaneous Models" @@ -56,12 +56,6 @@ msgstr "" msgid "The resolved attachments data." msgstr "" -#: interactions.client.models.misc.Interaction -#: interactions.client.models.misc.InteractionData -#: interactions.client.models.misc.InteractionResolvedData of -msgid "Parameters" -msgstr "" - #: interactions.client.models.misc.InteractionData:1 of msgid "A class object representing the data of an interaction." msgstr "" @@ -102,6 +96,10 @@ msgstr "" msgid "The targeted ID of the interaction." msgstr "" +#: interactions.client.models.misc.InteractionData:12 of +msgid "Array of Action Rows in modal." +msgstr "" + #: interactions.client.models.misc.Interaction:1 of msgid "A class object representing an interaction." msgstr "" @@ -149,3 +147,6 @@ msgstr "" #: interactions.client.models.misc.Interaction:13 of msgid "The message of the interaction." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/quickstart.po b/docs/locale/fr/LC_MESSAGES/quickstart.po index 89ed78f26..76b3670dc 100644 --- a/docs/locale/fr/LC_MESSAGES/quickstart.po +++ b/docs/locale/fr/LC_MESSAGES/quickstart.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:08-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../quickstart.rst:2 msgid "Quickstart" @@ -28,10 +28,11 @@ msgstr "" #: ../../quickstart.rst:7 msgid "" -"**discord-interactions** is a :ref:`Python library ` for the Discord Application Programming Interface. (API) A" -" library in Python has to be installed through the `pip` file. Run this " -"in your terminal/command line in order to install our library:" +"**discord-interactions** is a :ref:`Python library " +"` for the Discord Application Programming " +"Interface. (API) A library in Python has to be installed through the " +"`pip` file. Run this in your terminal/command line in order to install " +"our library:" msgstr "" #: ../../quickstart.rst:11 @@ -308,109 +309,116 @@ msgid "" msgstr "" #: ../../quickstart.rst:208 -msgid "" -"The first field in the ``@option()`` decorator is the type of the option." -" This is positional only and required. You can use integers, the default " -"Python types, the ``OptionType`` enum, or supported objects such as " -"``interactions.Channel``." +msgid "All arguments in the decorator are keyword arguments only." msgstr "" #: ../../quickstart.rst:209 -msgid "All other arguments in the decorator are keyword arguments only." +msgid "" +"The ``type`` and ``name`` fields default to the typehint and the name of " +"the parameter." msgstr "" #: ../../quickstart.rst:210 -msgid "The ``name`` field is required." +msgid "" +"The ``description`` field is optional and defaults to ``\"No description " +"set``." msgstr "" #: ../../quickstart.rst:211 msgid "" -"The ``description`` field is optional and defaults to ``\"No description " -"set``." +"The ``required`` field defaults to whether the default for the parameter " +"is empty." msgstr "" #: ../../quickstart.rst:212 msgid "" +"For typehinting or inputting the ``type`` field, you can use integers, " +"the default Python types, the ``OptionType`` enum, or supported objects " +"such as ``interactions.Channel``." +msgstr "" + +#: ../../quickstart.rst:213 +msgid "" "Any parameters from ``Option`` can be passed into the ``@option()`` " "decorator." msgstr "" -#: ../../quickstart.rst:215 +#: ../../quickstart.rst:216 msgid "The limit for options per command is 25." msgstr "" -#: ../../quickstart.rst:218 +#: ../../quickstart.rst:219 msgid "Nested commands: subcommands" msgstr "" -#: ../../quickstart.rst:220 +#: ../../quickstart.rst:221 msgid "" "Subcommands are options that are nested to create subcategories of " "commands." msgstr "" -#: ../../quickstart.rst:222 +#: ../../quickstart.rst:223 msgid "Here is the structure of a subcommand:" msgstr "" -#: ../../quickstart.rst:265 +#: ../../quickstart.rst:266 msgid "You can also create subcommands using the command system:" msgstr "" -#: ../../quickstart.rst:291 +#: ../../quickstart.rst:292 msgid "You can add a SUB_COMMAND_GROUP in between the base and command." msgstr "" -#: ../../quickstart.rst:294 +#: ../../quickstart.rst:295 msgid "Additional information about subcommands" msgstr "" -#: ../../quickstart.rst:296 +#: ../../quickstart.rst:297 msgid "" "Base commands are returned the :ref:`Command ` object. From this, you can utilize the following " "decorators:" msgstr "" -#: ../../quickstart.rst:299 +#: ../../quickstart.rst:300 msgid "" ":ref:`@subcommand() `: creates" " a subcommand." msgstr "" -#: ../../quickstart.rst:300 +#: ../../quickstart.rst:301 msgid "" ":ref:`@group() `: creates a " "group." msgstr "" -#: ../../quickstart.rst:301 +#: ../../quickstart.rst:302 msgid "" ":ref:`@error `: registers an " "error callback." msgstr "" -#: ../../quickstart.rst:303 +#: ../../quickstart.rst:304 msgid "Check the documentation for the parameters of each of these decorators." msgstr "" -#: ../../quickstart.rst:305 +#: ../../quickstart.rst:306 msgid "The following is an example of a base command:" msgstr "" -#: ../../quickstart.rst:313 +#: ../../quickstart.rst:314 msgid "The examples below will be using the base command above." msgstr "" -#: ../../quickstart.rst:315 +#: ../../quickstart.rst:316 msgid "The following is an example of a subcommand of the base command:" msgstr "" -#: ../../quickstart.rst:323 +#: ../../quickstart.rst:324 msgid "This code results in the following subcommand: `/base_command subcommand`." msgstr "" -#: ../../quickstart.rst:326 +#: ../../quickstart.rst:327 msgid "" "You can use the ``base_res`` parameter in groups and subcommands, and " "``group_res`` in subcommands inside groups to access the result of the " @@ -418,50 +426,50 @@ msgid "" "``ctx`` parameter." msgstr "" -#: ../../quickstart.rst:329 +#: ../../quickstart.rst:330 msgid "The following is an example of a group with subcommands:" msgstr "" -#: ../../quickstart.rst:341 +#: ../../quickstart.rst:342 msgid "" "You can have multiple groups, with multiple subcommands in each group. " "Subcommands and groups are options, so the same restrictions apply." msgstr "" -#: ../../quickstart.rst:344 +#: ../../quickstart.rst:345 msgid "Create any subcommands without groups *before* creating any groups." msgstr "" -#: ../../quickstart.rst:346 +#: ../../quickstart.rst:347 msgid "" "Since there are multiple coroutines involved that each get executed, you " "may be wondering how you can stop the chain. Luckily, there is a way:" msgstr "" -#: ../../quickstart.rst:360 +#: ../../quickstart.rst:361 msgid "This works on both groups and subcommands." msgstr "" -#: ../../quickstart.rst:362 +#: ../../quickstart.rst:363 msgid "The following is an example of an error callback:" msgstr "" -#: ../../quickstart.rst:378 +#: ../../quickstart.rst:379 msgid "" "The parameters ``ctx`` and ``error`` are required, but you can have more " "parameters, such as ``*args`` and ``**kwargs``, if you need to access " "options." msgstr "" -#: ../../quickstart.rst:382 +#: ../../quickstart.rst:383 msgid "You can have one error callback per command." msgstr "" -#: ../../quickstart.rst:385 +#: ../../quickstart.rst:386 msgid "Special type of commands: Context menus" msgstr "" -#: ../../quickstart.rst:387 +#: ../../quickstart.rst:388 msgid "" "While, granted that application commands are way more intuitive and " "easier to work with as both a bot developer and user from a UX approach, " @@ -472,39 +480,39 @@ msgid "" " right-click actions with menial effort." msgstr "" -#: ../../quickstart.rst:393 +#: ../../quickstart.rst:394 msgid "" "In order to create a menu-based command, all you need to do is simply add" " this one line into your ``@command`` decorator:" msgstr "" -#: ../../quickstart.rst:406 +#: ../../quickstart.rst:407 msgid "Here is an alternate way of creating a context menu:" msgstr "" -#: ../../quickstart.rst:415 +#: ../../quickstart.rst:416 msgid "" "The structure of a menu command differs significantly from that of a " "regular one:" msgstr "" -#: ../../quickstart.rst:417 +#: ../../quickstart.rst:418 msgid "You cannot have any options or choices." msgstr "" -#: ../../quickstart.rst:418 +#: ../../quickstart.rst:419 msgid "You cannot have a description." msgstr "" -#: ../../quickstart.rst:419 +#: ../../quickstart.rst:420 msgid "The ``name`` filter follows a different regex pattern." msgstr "" -#: ../../quickstart.rst:422 +#: ../../quickstart.rst:423 msgid "Creating and sending Components" msgstr "" -#: ../../quickstart.rst:424 +#: ../../quickstart.rst:425 msgid "" "Being able to run your own commands is very useful for a lot of " "automation-related purposes as a bot developer, however, we also have " @@ -513,14 +521,14 @@ msgid "" "components." msgstr "" -#: ../../quickstart.rst:429 +#: ../../quickstart.rst:430 msgid "" "Components are ways of being able to select pre-defined data, or define " "your own. They're very simple but quite powerful when put into practice " "This code block below shows a simplified implementation of a component:" msgstr "" -#: ../../quickstart.rst:455 +#: ../../quickstart.rst:456 msgid "" "This is a design that we ended up choosing to simplify responding to " "buttons when someone presses on one, and to allow bot developers to plug " @@ -530,11 +538,11 @@ msgid "" "modularity." msgstr "" -#: ../../quickstart.rst:462 +#: ../../quickstart.rst:463 msgid "What kinds of components are there?" msgstr "" -#: ../../quickstart.rst:464 +#: ../../quickstart.rst:465 msgid "" "As a bot developer, this may be fairly important for you to want to know." " Different components provide difference user experiences, interactions " @@ -543,18 +551,18 @@ msgid "" "able to `find these component types`_ here." msgstr "" -#: ../../quickstart.rst:471 +#: ../../quickstart.rst:472 msgid "How do I send components in a row?" msgstr "" -#: ../../quickstart.rst:473 +#: ../../quickstart.rst:474 msgid "" "You are also able to organize these components into rows, which are " "defined as ``ActionRow``'s. It is worth noting that you can have only a " "maximum of 5 per message that you send. This code block below shows how:" msgstr "" -#: ../../quickstart.rst:505 +#: ../../quickstart.rst:506 msgid "" "By default, the ``components`` keyword-argument field in the context " "sending method will always support ``ActionRow``-less sending: you only " @@ -563,57 +571,57 @@ msgid "" "class objects instead." msgstr "" -#: ../../quickstart.rst:511 +#: ../../quickstart.rst:512 msgid "" "You cannot use ``TextInput`` with the above shown method. Look :ref:`here" " ` how to create and send them." msgstr "" -#: ../../quickstart.rst:516 +#: ../../quickstart.rst:517 msgid "Creating a TextInput" msgstr "" -#: ../../quickstart.rst:517 +#: ../../quickstart.rst:518 msgid "You want to get a Text from a user? You can use ``TextInput`` for that." msgstr "" -#: ../../quickstart.rst:529 +#: ../../quickstart.rst:530 msgid "" "But how to send it? You can't use ``ctx.send`` for it. Take a look at " ":ref:`Modals ` for that." msgstr "" -#: ../../quickstart.rst:533 +#: ../../quickstart.rst:534 msgid "Modals" msgstr "" -#: ../../quickstart.rst:534 +#: ../../quickstart.rst:535 msgid "" "Modals are a new way to interact with a user. Currently only a " "``TextInput`` component is supported. You can have up to five " "``TextInput`` in a Modal." msgstr "" -#: ../../quickstart.rst:547 +#: ../../quickstart.rst:548 msgid "with the ``TextInput`` example from above we get:" msgstr "" -#: ../../quickstart.rst:552 +#: ../../quickstart.rst:553 msgid "Responding to a Modal interaction" msgstr "" -#: ../../quickstart.rst:560 +#: ../../quickstart.rst:561 msgid "" "You can respond to a modal the same way as you would respond to a normal " "``chat-input`` command, except your function has an extra argument for " "the text what was put into the modal." msgstr "" -#: ../../quickstart.rst:563 +#: ../../quickstart.rst:564 msgid "Adding v2 Permissions" msgstr "" -#: ../../quickstart.rst:565 +#: ../../quickstart.rst:566 msgid "" "v2 permissions consist of the ``default_member_permissions`` and " "``dm_permission`` keyword arguments. Similar to adding privileged " @@ -621,55 +629,87 @@ msgid "" "etc.) as follows:" msgstr "" -#: ../../quickstart.rst:604 +#: ../../quickstart.rst:605 msgid "" "Adding guild-only commands is easier as the only thing it takes is a " "boolean. Here's an example of a guild-only command:" msgstr "" -#: ../../quickstart.rst:623 +#: ../../quickstart.rst:624 msgid "" "Likewise, setting ``dm_permission`` to ``True`` makes it usable in DMs. " "Just to note that this argument's mainly used for global commands. Guild " "commands with this argument will have no effect." msgstr "" -#: ../../quickstart.rst:627 +#: ../../quickstart.rst:628 msgid "Utilities" msgstr "" -#: ../../quickstart.rst:629 +#: ../../quickstart.rst:630 msgid "You can use the following utilities to help you with your commands:" msgstr "" -#: ../../quickstart.rst:631 +#: ../../quickstart.rst:632 msgid "``ActionRow.new()``: Creates a new ``ActionRow`` object." msgstr "" -#: ../../quickstart.rst:632 +#: ../../quickstart.rst:633 msgid "``spread_to_rows()``: Spreads a list of components into a list of rows." msgstr "" -#: ../../quickstart.rst:633 +#: ../../quickstart.rst:634 msgid "" "``@autodefer()``: Automatically defers a command if it did not respond " "within the specified time." msgstr "" -#: ../../quickstart.rst:635 +#: ../../quickstart.rst:636 msgid "" -"Look at their documentation :ref:`here ` for " -"more information." +"Look at their documentation :ref:`here ` for more " +"information." msgstr "" -#: ../../quickstart.rst:637 +#: ../../quickstart.rst:638 msgid "Usage of ``ActionRow.new()``:" msgstr "" -#: ../../quickstart.rst:653 +#: ../../quickstart.rst:654 msgid "Usage of ``spread_to_rows()``:" msgstr "" -#: ../../quickstart.rst:675 +#: ../../quickstart.rst:676 msgid "Usage of ``@autodefer()``:" msgstr "" + +#~ msgid "" +#~ "**discord-interactions** is a :ref:`Python " +#~ "library ` for the" +#~ " Discord Application Programming Interface. " +#~ "(API) A library in Python has to" +#~ " be installed through the `pip` file." +#~ " Run this in your terminal/command " +#~ "line in order to install our " +#~ "library:" +#~ msgstr "" + +#~ msgid "" +#~ "The first field in the ``@option()`` " +#~ "decorator is the type of the " +#~ "option. This is positional only and " +#~ "required. You can use integers, the " +#~ "default Python types, the ``OptionType`` " +#~ "enum, or supported objects such as " +#~ "``interactions.Channel``." +#~ msgstr "" + +#~ msgid "All other arguments in the decorator are keyword arguments only." +#~ msgstr "" + +#~ msgid "The ``name`` field is required." +#~ msgstr "" + +#~ msgid "" +#~ "Look at their documentation :ref:`here " +#~ "` for more information." +#~ msgstr "" diff --git a/docs/locale/fr/LC_MESSAGES/utils.po b/docs/locale/fr/LC_MESSAGES/utils.po new file mode 100644 index 000000000..2968b6970 --- /dev/null +++ b/docs/locale/fr/LC_MESSAGES/utils.po @@ -0,0 +1,361 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../utils.rst:4 +msgid "The ``get`` utility method" +msgstr "" + +#: interactions.utils.get.get:1 of +msgid "Helper method to get an object." +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "This method can do the following:" +msgstr "" + +#: interactions.utils.get.get:6 of +msgid "Get a list of specific objects" +msgstr "" + +#: interactions.utils.get.get:5 interactions.utils.get.get:9 of +msgid "purely from cache" +msgstr "" + +#: interactions.utils.get.get:6 interactions.utils.get.get:10 of +msgid "purely from HTTP" +msgstr "" + +#: interactions.utils.get.get:7 of +msgid "" +"from cache and additionally from HTTP for every ID that was not found in " +"cache" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "Get a single specific object" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "from HTTP if not found in cache else from cache" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "The method has to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "You don't force anything" +msgstr "" + +#: interactions.utils.get.get:15 of +msgid "You force HTTP" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "The method doesn't have to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "You force cache" +msgstr "" + +#: interactions.utils.get.get:20 of +msgid "" +"Technically, there is no need for an ``await`` if there is an object " +"found in the cache. Because of the fact, that, as long as you don't " +"enforce the cache, the function will get the object from HTTP, if it is " +"not in the cache, you still have to await it. This has been done to " +"reduce confusion on whether the object origins from an HTTP call or a " +"cache result and to remove the extra step for you to check if the " +"returned object is an awaitable or not." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing:" +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing can be done via the ``force`` keyword argument." +msgstr "" + +#: interactions.utils.get.get:31 of +msgid "``force=\"cache\"`` or ``force=interactions.Force.CACHE``:" +msgstr "" + +#: interactions.utils.get.get:30 of +msgid "" +"This forces the method to only return from cache (if the object is not " +"found it will return ``None``). If you use this, you don't need to await " +"the method." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "``force=\"http\"`` or ``force=interactions.Force.HTTP``:" +msgstr "" + +#: interactions.utils.get.get:34 of +msgid "" +"This forces the method to make an HTTP request to the discord API and " +"return the result of it. If you use this, you have to await the method." +msgstr "" + +#: interactions.utils.get.get:38 of +msgid "" +"If you are a PyCharm user, please be aware of a bug that causes incorrect" +" suggestions to appear if using an enum. Even if PyCharm shows a normal " +"object as result, you have to await the method if you enforce HTTP. To " +"prevent this bug from happening it is suggested using ``force=\"http\"`` " +"instead of the enum." +msgstr "" + +#: interactions.utils.get.get:43 of +msgid "Getting an object:" +msgstr "" + +#: interactions.utils.get.get:45 of +msgid "" +"Here you will see two examples on how to get a single objects and the " +"variations of how the object can be gotten." +msgstr "" + +#: interactions.utils.get.get:48 of +msgid "Example 1/2: Getting a Channel:" +msgstr "" + +#: interactions.utils.get.get:65 of +msgid "Example 2/2: Getting a Member:" +msgstr "" + +#: interactions.utils.get.get:88 of +msgid "" +"Both examples should have given you a basic overview on how to get a " +"single object. Now we will move on with lists of objects." +msgstr "" + +#: interactions.utils.get.get:92 of +msgid "" +"The ``parent_id`` represents the channel or guild id that belongs to the " +"objects you want to get. It is called ``parent_id`` because " +"``guild_or_channel_id`` would be horrible to type out every time." +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "Getting a list of an object:" +msgstr "" + +#: interactions.utils.get.get:96 of +msgid "" +"Here you will see 1 example of how to get a list of objects. The " +"possibilities on how to force (and their results) are the same as in the " +"examples above." +msgstr "" + +#: interactions.utils.get.get:99 of +msgid "Example 1/1: Getting a list of members:" +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "" +"If you enforce cache when getting a list of objects, found objets will be" +" placed into the list and not found objects will be placed as ``None`` " +"into the list." +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Parameters" +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Return type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "An enumerable object representing the force types for the get method." +msgstr "" + +#: interactions.utils.get.Force of +msgid "Variables" +msgstr "" + +#: interactions.utils.get.Force:3 of +msgid "Enforce the usage of cache and block the usage of http" +msgstr "" + +#: interactions.utils.get.Force:4 of +msgid "Enforce the usage of http and block the usage of cache" +msgstr "" + +#: interactions.utils.get.Force of +msgid "Member Type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: ../../utils.rst:10 +msgid "Utilities" +msgstr "" + +#: interactions.utils.utils.autodefer:1 of +msgid "" +"A decorator that automatically defers a command if it did not respond " +"within ``delay`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:3 of +msgid "The structure of the decorator is:" +msgstr "" + +#: interactions.utils.utils.autodefer:13 of +msgid "" +"The amount of time in seconds to wait before defering the command. " +"Defaults to ``2`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:15 of +msgid "Whether the command is deferred ephemerally. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer:17 of +msgid "Whether the command is deferred on origin. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable of +msgid "Returns" +msgstr "" + +#: interactions.utils.utils.autodefer:19 of +msgid "The inner function, for decorating." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:1 of +msgid "A helper function that spreads components into :class:`ActionRow` s." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:3 of +msgid "Example:" +msgstr "" + +#: interactions.utils.utils.spread_to_rows:24 of +msgid "" +"You can only pass in :class:`ActionRow`s, :class:`Button`s, and " +":class:`SelectMenu`s, but in any order." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:26 of +msgid "The components to spread." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:28 of +msgid "The maximum number of components in a single row. Defaults to ``5``." +msgstr "" + +#: interactions.utils.utils.search_iterable:1 of +msgid "" +"Searches through an iterable for items that: - Are True for the check, if" +" one is given - Have attributes that match the keyword arguments (e.x. " +"passing `id=your_id` will only return objects with that id)" +msgstr "" + +#: interactions.utils.utils.search_iterable:5 of +msgid "The iterable to search through" +msgstr "" + +#: interactions.utils.utils.search_iterable:7 of +msgid "The check that items will be checked against" +msgstr "" + +#: interactions.utils.utils.search_iterable:9 of +msgid "Any attributes the items should have" +msgstr "" + +#: interactions.utils.utils.search_iterable:11 of +msgid "All items that match the check and keywords" +msgstr "" + +#: interactions.utils.utils.disable_components:1 of +msgid "Disables the given components." +msgstr "" + +#: interactions.utils.utils.disable_components:3 of +msgid "The components to disable" +msgstr "" + +#: interactions.utils.utils.get_channel_history:1 of +msgid "Gets the history of a channel." +msgstr "" + +#: interactions.utils.utils.get_channel_history:3 of +msgid "The HTTPClient of the bot or your bot instance" +msgstr "" + +#: interactions.utils.utils.get_channel_history:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:7 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:9 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.utils.utils.get_channel_history:11 of +msgid "A check to ignore specific messages" +msgstr "" + +#: interactions.utils.utils.get_channel_history:13 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.utils.utils.get_channel_history:16 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.dispatch.po b/docs/locale/hi/LC_MESSAGES/api.dispatch.po index 2b020e27a..18a4ff864 100644 --- a/docs/locale/hi/LC_MESSAGES/api.dispatch.po +++ b/docs/locale/hi/LC_MESSAGES/api.dispatch.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.dispatch.rst:4 msgid "Dispatching" @@ -38,12 +38,6 @@ msgstr "" msgid "A list of events being dispatched." msgstr "" -#: interactions.api.dispatch.Listener -#: interactions.api.dispatch.Listener.dispatch -#: interactions.api.dispatch.Listener.register of -msgid "Return type" -msgstr "" - #: interactions.api.dispatch.Listener.dispatch:1 of msgid "Dispatches an event given out by the gateway." msgstr "" @@ -83,3 +77,6 @@ msgstr "" #: interactions.api.dispatch.Listener.register:9 of msgid "The name to associate the coroutine with. Defaults to None." msgstr "" + +#~ msgid "Return type" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.gateway.po b/docs/locale/hi/LC_MESSAGES/api.gateway.po index aad9d8772..22e00a8ed 100644 --- a/docs/locale/hi/LC_MESSAGES/api.gateway.po +++ b/docs/locale/hi/LC_MESSAGES/api.gateway.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.gateway.rst:4 msgid "Gateway" @@ -36,121 +36,169 @@ msgid "" "WebSocket." msgstr "" +#: interactions.api.gateway.client.WebSocketClient:4 of +msgid "" +"The ``__heartbeat_event`` Event object is different from the one built in" +" to the Heartbeater object. The latter is used to trace heartbeat " +"acknowledgement." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient of msgid "Variables" msgstr "" -#: interactions.api.gateway.client.WebSocketClient:3 of +#: interactions.api.gateway.client.WebSocketClient:7 of msgid "The asynchronous event loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:4 of +#: interactions.api.gateway.client.WebSocketClient:8 of msgid "The built-in event dispatcher." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:5 of +#: interactions.api.gateway.client.WebSocketClient:9 of +msgid "The websocket ratelimiter object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:10 of msgid "The user-facing HTTP client." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:6 of +#: interactions.api.gateway.client.WebSocketClient:11 of msgid "The WebSocket data of the connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:7 of +#: interactions.api.gateway.client.WebSocketClient:12 of msgid "Whether the connection has been closed or not." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:8 of +#: interactions.api.gateway.client.WebSocketClient:13 of msgid "The connection options made during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:9 of +#: interactions.api.gateway.client.WebSocketClient:14 of msgid "The gateway intents used for connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:10 of +#: interactions.api.gateway.client.WebSocketClient:15 of msgid "The contents of the application returned when ready." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:11 of +#: interactions.api.gateway.client.WebSocketClient:16 of msgid "The context state of a \"heartbeat\" made to the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:12 of +#: interactions.api.gateway.client.WebSocketClient:17 of +msgid "The state of the overall heartbeat process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:18 of msgid "The shards used during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:13 of +#: interactions.api.gateway.client.WebSocketClient:19 of msgid "The presence used in connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:14 of +#: interactions.api.gateway.client.WebSocketClient:20 of msgid "The ready state of the client as an ``asyncio.Event``." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:15 of -msgid "The closing task for ending connections." +#: interactions.api.gateway.client.WebSocketClient:21 of +msgid "The task containing the heartbeat manager process." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:16 of +#: interactions.api.gateway.client.WebSocketClient:22 of msgid "Whether the client has started." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:17 of +#: interactions.api.gateway.client.WebSocketClient:23 of msgid "The ID of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:18 of +#: interactions.api.gateway.client.WebSocketClient:24 of msgid "The sequence identifier of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:19 of +#: interactions.api.gateway.client.WebSocketClient:25 of msgid "" "The latest time of the last send_packet function call since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:20 of +#: interactions.api.gateway.client.WebSocketClient:26 of msgid "" "The latest time of the last ``HEARTBEAT_ACK`` event since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:21 of -msgid "The latency of the connection, in seconds." +#: interactions.api.gateway.client.WebSocketClient:27 of +msgid "The Websocket ratelimit URL for resuming connections, if any." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:28 of +msgid "The Websocket URL for instantiating connections without resuming." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:29 of +msgid "The lock used for reconnecting the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:30 of +msgid "The lock used for closing the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:31 of +msgid "The task containing stopping the client, if any." msgstr "" #: interactions.api.gateway.client.WebSocketClient #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__identify +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache #: interactions.api.gateway.client.WebSocketClient.__option_type_context +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection +#: interactions.api.gateway.client.WebSocketClient._handle_stream +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence +#: interactions.api.gateway.client.WebSocketClient.request_guild_members #: interactions.api.gateway.heartbeat._Heartbeat of msgid "Parameters" msgstr "" -#: interactions.api.gateway.client.WebSocketClient +#: interactions.api.gateway.client.WebSocketClient.latency:1 of +msgid "The latency of the connection, in seconds." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat:1 of +msgid "" +"Controls the heartbeat manager. Do note that this shouldn't be executed " +"by outside processes." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__heartbeat #: interactions.api.gateway.client.WebSocketClient.__identify #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream -#: interactions.api.gateway.client.WebSocketClient.__restart +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__resume #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection #: interactions.api.gateway.client.WebSocketClient._manage_heartbeat +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence -#: interactions.api.gateway.client.WebSocketClient.wait_until_ready -#: interactions.api.gateway.heartbeat._Heartbeat of +#: interactions.api.gateway.client.WebSocketClient.close +#: interactions.api.gateway.client.WebSocketClient.request_guild_members +#: interactions.api.gateway.client.WebSocketClient.run +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat +#: interactions.api.gateway.client.WebSocketClient.wait_until_ready of msgid "Return type" msgstr "" @@ -158,29 +206,21 @@ msgstr "" msgid "Manages the heartbeat loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__restart:1 of -msgid "Restart the client's connection and heartbeat with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:1 of -msgid "Establishes a client connection with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:3 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:5 of -msgid "The shards to establish a connection with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient.run:1 of +msgid "Handles the client's connection with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._establish_connection:5 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:7 of -msgid "The presence to carry with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:1 of +msgid "" +"Parses raw stream data recieved from the Gateway, including Gateway " +"opcodes and events." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:1 of -msgid "Handles the client's connection with the Gateway." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:4 of +msgid "This should never be called directly." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:3 of +#: interactions.api.gateway.client.WebSocketClient._handle_stream:6 of msgid "The packet stream to handle." msgstr "" @@ -192,31 +232,68 @@ msgstr "" msgid "Dispatches an event from the Gateway." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:3 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:3 of msgid "The name of the event." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:5 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:5 of msgid "The data for the event." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of -msgid "" -"Takes raw data given back from the Gateway and gives \"context\" based " -"off of what it is." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:1 of +msgid "Gets an ID from object." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of -msgid "The data from the Gateway." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:5 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:7 of +msgid "The object of the event." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:7 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:5 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:9 of +msgid "The model of the event." msgstr "" #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context of msgid "Returns" msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:9 of +msgid "Object ID" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:1 of +msgid "Gets a list of ids of object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:7 of +msgid "Object IDs" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:1 of +msgid "Modifies guild cache." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of +msgid "" +"Takes raw data given back from the Gateway and gives \"context\" based " +"off of what it is." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of +msgid "The data from the Gateway." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize:6 of msgid "The context object." msgstr "" @@ -255,11 +332,15 @@ msgstr "" msgid "The option type context." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:1 of -msgid "Receives a stream of packets sent from the Gateway." +#: interactions.api.gateway.client.WebSocketClient._reconnect:1 of +msgid "Restarts the client's connection and heartbeat with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:3 of +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:1 of +msgid "Receives a stream of packets sent from the Gateway in an async process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:3 of msgid "The packet stream." msgstr "" @@ -311,6 +392,58 @@ msgid "" "disconnect." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:1 of +msgid "Sends an ``REQUEST_MEMBERS`` packet to the gateway." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:3 of +msgid "ID of the guild to get members for." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:5 of +msgid "" +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:7 of +msgid "String that username starts with." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.close:1 of +msgid "Closes the current connection." +msgstr "" + #: interactions.api.gateway.heartbeat._Heartbeat:1 of msgid "An internal class representing the heartbeat in a WebSocket connection." msgstr "" + +#~ msgid "The closing task for ending connections." +#~ msgstr "" + +#~ msgid "Restart the client's connection and heartbeat with the Gateway." +#~ msgstr "" + +#~ msgid "Establishes a client connection with the Gateway." +#~ msgstr "" + +#~ msgid "The shards to establish a connection with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "The presence to carry with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "Receives a stream of packets sent from the Gateway." +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.http.po b/docs/locale/hi/LC_MESSAGES/api.http.po index b141f2d87..fcab462c2 100644 --- a/docs/locale/hi/LC_MESSAGES/api.http.po +++ b/docs/locale/hi/LC_MESSAGES/api.http.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.http.rst:4 msgid "HTTP" @@ -55,10 +55,13 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag #: interactions.api.http.channel.ChannelRequest.delete_channel #: interactions.api.http.channel.ChannelRequest.delete_channel_permission #: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag #: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -75,6 +78,7 @@ msgstr "" #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template @@ -169,6 +173,7 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker #: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread #: interactions.api.http.thread.ThreadRequest.join_thread #: interactions.api.http.thread.ThreadRequest.leave_thread @@ -198,14 +203,19 @@ msgstr "" msgid "Parameters" msgstr "" -#: interactions.api.http.channel.ChannelRequest +#: interactions.api.http.route.Route.get_bucket:1 of +msgid "" +"Returns the route's bucket. If shared_bucket is None, returns the path " +"with major parameters. Otherwise, it relies on Discord's given bucket." +msgstr "" + +#: interactions.api.http.route.Route.get_bucket:4 of +msgid "The bucket that Discord provides, if available." +msgstr "" + #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance -#: interactions.api.http.channel.ChannelRequest.delete_channel -#: interactions.api.http.channel.ChannelRequest.delete_channel_permission -#: interactions.api.http.channel.ChannelRequest.delete_stage_instance -#: interactions.api.http.channel.ChannelRequest.edit_channel_permission #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -214,37 +224,21 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel -#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway -#: interactions.api.http.client.HTTPClient.get_current_authorisation_information -#: interactions.api.http.client.HTTPClient.get_current_bot_information -#: interactions.api.http.client.HTTPClient.get_gateway -#: interactions.api.http.client.HTTPClient.login -#: interactions.api.http.client.HTTPClient.logout -#: interactions.api.http.emoji.EmojiRequest #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji -#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji -#: interactions.api.http.guild.GuildRequest #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template -#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template -#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.delete_guild -#: interactions.api.http.guild.GuildRequest.delete_guild_integration -#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles -#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild -#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -255,28 +249,17 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings -#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild -#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget -#: interactions.api.http.guild.GuildRequest.modify_user_voice_state -#: interactions.api.http.guild.GuildRequest.remove_guild_ban -#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template -#: interactions.api.http.interaction.InteractionRequest -#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command -#: interactions.api.http.interaction.InteractionRequest.create_interaction_response -#: interactions.api.http.interaction.InteractionRequest.delete_application_command -#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -285,46 +268,22 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command -#: interactions.api.http.limiter.Limiter -#: interactions.api.http.member.MemberRequest -#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member -#: interactions.api.http.member.MemberRequest.remove_member_role -#: interactions.api.http.member.MemberRequest.search_guild_members -#: interactions.api.http.message.MessageRequest -#: interactions.api.http.message.MessageRequest.create_message -#: interactions.api.http.message.MessageRequest.delete_message -#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message -#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message -#: interactions.api.http.message.MessageRequest.send_message -#: interactions.api.http.message.MessageRequest.unpin_message -#: interactions.api.http.reaction.ReactionRequest -#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction -#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction -#: interactions.api.http.request._Request -#: interactions.api.http.request._Request._check_lock -#: interactions.api.http.request._Request._check_session -#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request -#: interactions.api.http.route.Route interactions.api.http.route.Route.endpoint +#: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket -#: interactions.api.http.scheduledEvent.ScheduledEventRequest #: interactions.api.http.scheduledEvent.ScheduledEventRequest.create_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.delete_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event_users #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events #: interactions.api.http.scheduledEvent.ScheduledEventRequest.modify_scheduled_event -#: interactions.api.http.sticker.StickerRequest #: interactions.api.http.sticker.StickerRequest.create_guild_sticker #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker #: interactions.api.http.sticker.StickerRequest.get_guild_sticker @@ -332,53 +291,44 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker -#: interactions.api.http.thread.ThreadRequest -#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread -#: interactions.api.http.thread.ThreadRequest.join_thread -#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members -#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread -#: interactions.api.http.user.UserRequest #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user -#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild -#: interactions.api.http.webhook.WebhookRequest #: interactions.api.http.webhook.WebhookRequest.create_webhook -#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message -#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks -#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Return type" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:1 of -msgid "" -"Returns the route's bucket. If shared_bucket is None, returns the path " -"with major parameters. Otherwise, it relies on Discord's given bucket." +msgid "Returns" msgstr "" -#: interactions.api.http.route.Route.get_bucket:4 of -msgid "The bucket that Discord provides, if available." +#: interactions.api.http.route.Route.get_bucket:7 of +msgid "The route bucket." msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag +#: interactions.api.http.channel.ChannelRequest.delete_channel +#: interactions.api.http.channel.ChannelRequest.delete_channel_permission +#: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag +#: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -387,20 +337,36 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel +#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway +#: interactions.api.http.client.HTTPClient.get_current_authorisation_information +#: interactions.api.http.client.HTTPClient.get_current_bot_information +#: interactions.api.http.client.HTTPClient.get_gateway +#: interactions.api.http.client.HTTPClient.login +#: interactions.api.http.client.HTTPClient.logout #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji +#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template +#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template +#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.delete_guild +#: interactions.api.http.guild.GuildRequest.delete_guild_integration +#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles +#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild +#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -411,17 +377,27 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings +#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild +#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget +#: interactions.api.http.guild.GuildRequest.modify_user_voice_state +#: interactions.api.http.guild.GuildRequest.remove_guild_ban +#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template +#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command +#: interactions.api.http.interaction.InteractionRequest.create_interaction_response +#: interactions.api.http.interaction.InteractionRequest.delete_application_command +#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -430,13 +406,30 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command +#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member +#: interactions.api.http.member.MemberRequest.remove_member_role +#: interactions.api.http.member.MemberRequest.search_guild_members +#: interactions.api.http.message.MessageRequest.create_message +#: interactions.api.http.message.MessageRequest.delete_message +#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message +#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message +#: interactions.api.http.message.MessageRequest.send_message +#: interactions.api.http.message.MessageRequest.unpin_message +#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction +#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction +#: interactions.api.http.request._Request._check_lock +#: interactions.api.http.request._Request._check_session +#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request #: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket @@ -453,31 +446,36 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker +#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread +#: interactions.api.http.thread.ThreadRequest.join_thread +#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members +#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user +#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild #: interactions.api.http.webhook.WebhookRequest.create_webhook +#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message +#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks +#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Returns" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:7 of -msgid "The route bucket." +msgid "Return type" msgstr "" #: interactions.api.http.route.Route.endpoint:1 of @@ -617,9 +615,12 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel_invite:6 #: interactions.api.http.channel.ChannelRequest.create_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.create_tag:7 #: interactions.api.http.channel.ChannelRequest.delete_channel_permission:3 #: interactions.api.http.channel.ChannelRequest.delete_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.delete_tag:3 #: interactions.api.http.channel.ChannelRequest.edit_channel_permission:3 +#: interactions.api.http.channel.ChannelRequest.edit_tag:7 #: interactions.api.http.channel.ChannelRequest.get_channel:3 #: interactions.api.http.channel.ChannelRequest.get_channel_invites:3 #: interactions.api.http.channel.ChannelRequest.get_channel_messages:6 @@ -919,6 +920,51 @@ msgstr "" msgid "Delete a stage instance." msgstr "" +#: interactions.api.http.channel.ChannelRequest.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:4 +#: interactions.api.http.channel.ChannelRequest.edit_tag:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:8 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:9 +#: interactions.api.http.channel.ChannelRequest.edit_tag:10 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:10 +#: interactions.api.http.channel.ChannelRequest.edit_tag:11 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:1 of +msgid "Update a tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:8 of +msgid "The ID of the tag to update." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:1 of +msgid "Delete a forum tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:4 of +msgid "The ID of the tag to delete" +msgstr "" + #: interactions.api.http.emoji.EmojiRequest.get_all_emoji:1 of msgid "Gets all emojis from a guild." msgstr "" @@ -1279,6 +1325,7 @@ msgstr "" msgid "Gets all roles from a Guild." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:3 #: interactions.api.http.guild.GuildRequest.create_guild_ban:3 #: interactions.api.http.guild.GuildRequest.create_guild_kick:3 #: interactions.api.http.guild.GuildRequest.get_all_roles:3 @@ -1374,7 +1421,9 @@ msgid "" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "" +"Number of seconds to delete messages for, between 0 and 604800. Default " +"to 0" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:6 of @@ -1467,20 +1516,36 @@ msgstr "" msgid "Reason to send to audit log, if any." msgstr "" -#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of -msgid "" -"Retrieves a dict from an API that results in how many members would be " -"pruned given the amount of days." +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:1 of +msgid "Begins a prune operation." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:4 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:4 of -msgid "Number of days to count. Defaults to ``7``." +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:5 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:6 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:5 of msgid "Role IDs to include, if given." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:7 of +msgid "A dict containing `{\"pruned\": int}` or `{\"pruned\": None}`" +msgstr "" + +#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of +msgid "" +"Retrieves a dict from an API that results in how many members would be " +"pruned given the amount of days." +msgstr "" + #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:6 of msgid "A dict denoting `{\"pruned\": int}`" msgstr "" @@ -1974,7 +2039,8 @@ msgid "Channel snowflake ID." msgstr "" #: interactions.api.http.message.MessageRequest.create_message:5 -#: interactions.api.http.message.MessageRequest.edit_message:6 of +#: interactions.api.http.message.MessageRequest.edit_message:6 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:9 of msgid "An optional list of files to send attached to the message." msgstr "" @@ -2178,11 +2244,8 @@ msgid "Guild Scheduled Event ID snowflake." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:5 -#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 #: of -msgid "" -"A boolean to include number of users subscribed to the associated event, " -"if given." +msgid "Whether the number of users subscribed to the events is returned." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:6 @@ -2195,6 +2258,13 @@ msgstr "" msgid "Gets all guild scheduled events in a guild." msgstr "" +#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 +#: of +msgid "" +"Whether the number of users subscribed to the associated event is " +"returned." +msgstr "" + #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:5 #: of msgid "" @@ -2307,22 +2377,25 @@ msgid "" "MANAGE_EMOJIS_AND_STICKERS permission." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 -#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of -msgid "the payload to send." +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 of +msgid "The payload to send." msgstr "" #: interactions.api.http.sticker.StickerRequest.create_guild_sticker:4 of +msgid "The file to send." +msgstr "" + +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 of msgid "The guild to create sticker at." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:5 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:6 of msgid "The reason for this action." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 of +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:7 of msgid "The new sticker data on success." msgstr "" @@ -2332,6 +2405,10 @@ msgid "" "permission." msgstr "" +#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of +msgid "the payload to send." +msgstr "" + #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:3 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:4 of msgid "The guild of the target sticker." @@ -2483,15 +2560,18 @@ msgid "" "with.." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:3 of +#: interactions.api.http.thread.ThreadRequest.create_thread:3 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:3 of msgid "The ID of the channel to create this thread in" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:4 of +#: interactions.api.http.thread.ThreadRequest.create_thread:4 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:4 of msgid "The name of the thread" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:5 of +#: interactions.api.http.thread.ThreadRequest.create_thread:5 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:5 of msgid "" "duration in minutes to automatically archive the thread after recent " "activity, can be set to: 60, 1440, 4320, 10080" @@ -2511,7 +2591,8 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:10 of +#: interactions.api.http.thread.ThreadRequest.create_thread:10 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:11 of msgid "An optional reason for the audit log" msgstr "" @@ -2519,6 +2600,28 @@ msgstr "" msgid "The created thread" msgstr "" +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:1 of +msgid "From a given Forum channel, create a Thread with a message to start with." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:7 of +msgid "The payload/dictionary contents of the first message in the forum thread." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:8 of +msgid "List of tag ids that can be applied to the forum, if any." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:10 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:12 of +msgid "Returns a Thread in a Forum object with a starting Message." +msgstr "" + #: interactions.api.http.user.UserRequest.get_self:1 of msgid "An alias to `get_user`, but only gets the current bot user." msgstr "" @@ -2743,3 +2846,15 @@ msgstr "" #: of msgid "Deletes the original message object sent." msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Number of days to count. Defaults to ``7``." +#~ msgstr "" + +#~ msgid "" +#~ "A boolean to include number of " +#~ "users subscribed to the associated " +#~ "event, if given." +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.models.audit_log.po b/docs/locale/hi/LC_MESSAGES/api.models.audit_log.po new file mode 100644 index 000000000..7ba1f1c2b --- /dev/null +++ b/docs/locale/hi/LC_MESSAGES/api.models.audit_log.po @@ -0,0 +1,413 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.audit_log.rst:4 +msgid "Audit-Log Models" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:1 of +msgid "A class object representing an AuditLogEntry." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange +#: interactions.api.models.audit_log.AuditLogEntry +#: interactions.api.models.audit_log.AuditLogEvents +#: interactions.api.models.audit_log.AuditLogs +#: interactions.api.models.audit_log.OptionalAuditEntryInfo of +msgid "Variables" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:3 of +msgid "ID of the affected entity (webhook, user, role, etc.)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:4 of +msgid "Changes made to the target_id" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:5 of +msgid "User or app that made the changes" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:6 of +msgid "ID of the entry" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:7 of +msgid "Type of action that occurred" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:8 of +msgid "Additional info for certain event types" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:9 of +msgid "Reason for the change (1-512 characters)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "A class object representing the different types of AuditLogEvents." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:3 of +msgid "1 - Server settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:4 of +msgid "10 - Channel was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:5 of +msgid "11 - Channel settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:6 of +msgid "12 - Channel was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:7 of +msgid "13 - Permission overwrite was added to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:8 of +msgid "14 - Permission overwrite was updated for a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:9 of +msgid "15 - Permission overwrite was deleted from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:10 of +msgid "20 - Member was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:11 of +msgid "21 - Members were pruned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:12 of +msgid "22 - Member was banned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:13 of +msgid "23 - Server ban was lifted for a member" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:14 of +msgid "24 - Member was updated in server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:15 of +msgid "25 - Member was added or removed from a role" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:16 of +msgid "26 - Member was moved to a different voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:17 of +msgid "27 - Member was disconnected from a voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:18 of +msgid "28 - Bot user was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:19 of +msgid "30 - Role was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:20 of +msgid "31 - Role was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:21 of +msgid "32 - Role was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:22 of +msgid "40 - Server invite was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:23 of +msgid "41 - Server invite was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:24 of +msgid "42 - Server invite was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:25 of +msgid "50 - Webhook was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:26 of +msgid "51 - Webhook properties or channel were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:27 of +msgid "52 - Webhook was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:28 of +msgid "60 - Emoji was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:29 of +msgid "61 - Emoji name was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:30 of +msgid "62 - Emoji was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:31 of +msgid "72 - Single message was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:32 of +msgid "73 - Multiple messages were deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:33 of +msgid "74 - Message was pinned to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:34 of +msgid "75 - Message was unpinned from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:35 of +msgid "80 - App was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:36 of +msgid "81 - App was updated (as an example, its scopes were updated)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:37 of +msgid "82 - App was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:38 of +msgid "83 - Stage instance was created (stage channel becomes live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:39 of +msgid "84 - Stage instance details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:40 of +msgid "85 - Stage instance was deleted (stage channel no longer live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:41 of +msgid "90 - Sticker was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:42 of +msgid "91 - Sticker details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:43 of +msgid "92 - Sticker was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:44 of +msgid "100 - Event was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:45 of +msgid "101 - Event was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:46 of +msgid "102 - Event was cancelled" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:47 of +msgid "110 - Thread was created in a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:48 of +msgid "111 - Thread was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:49 of +msgid "112 - Thread was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:50 of +msgid "121 - Permissions were updated for a command" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:51 of +msgid "140 - Auto Moderation rule was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:52 of +msgid "141 - Auto Moderation rule was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:53 of +msgid "142 - Auto Moderation rule was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:54 of +msgid "143 - Message was blocked by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:55 of +msgid "144 - Message was flagged by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:56 of +msgid "145 - Member was timed out by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents of +msgid "Member Type" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid ":py:class:`int`" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:1 of +msgid "A class object representing the audit logs of a guild." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:3 of +msgid "List of audit log entries, sorted from most to least recent." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:4 of +msgid "List of auto moderation rules referenced in the audit log." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:5 of +msgid "List of guild scheduled events referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:6 of +msgid "List of partial integration objects" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:7 of +msgid "List of threads referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:8 of +msgid "List of users referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:9 of +msgid "List of webhooks referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:1 of +msgid "A class object representing an AuditLogChange." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:3 of +msgid "New value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:4 of +msgid "Old value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:5 of +msgid "" +"Name of the changed entity, with a few " +"[exceptions](https://discord.com/developers/docs/resources/audit-log" +"#audit-log-change-object-audit-log-change-exceptions)" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:1 of +msgid "A class object representing OptionalAuditEntryInfo." +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:3 of +msgid "" +"ID of the app whose permissions were targeted. ``AuditLogEvents``-type: " +"121" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:4 of +msgid "" +"Channel in which the entities were targeted. ``AuditLogEvents``-types: " +"26, 74, 75, 72, 83, 84, 85" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:5 of +msgid "" +"Name of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:6 of +msgid "" +"Trigger type of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:7 of +msgid "" +"Number of entities that were targeted. ``AuditLogEvents``-types: 72, 73, " +"27, 26" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:8 of +msgid "" +"Number of days after which inactive members were kicked. " +"``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:9 of +msgid "ID of the overwritten entity. ``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:10 of +msgid "Number of members removed by the prune. ``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:11 of +msgid "ID of the message that was targeted. ``AuditLogEvents``-types: 74, 75" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:12 of +msgid "" +"Name of the role if type is \"0\" (not present if type is \"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:13 of +msgid "" +"Type of overwritten entity - role (\"0\") or member (\"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.models.channel.po b/docs/locale/hi/LC_MESSAGES/api.models.channel.po index 1ca5f1ac3..81a65bd8e 100644 --- a/docs/locale/hi/LC_MESSAGES/api.models.channel.po +++ b/docs/locale/hi/LC_MESSAGES/api.models.channel.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.channel.rst:4 msgid "Channel Models" @@ -39,22 +39,24 @@ msgid "Valid values are as follows:" msgstr "" #: interactions.api.models.channel.Thread:1 of -msgid "An object representing a thread." -msgstr "" - -#: interactions.api.models.channel.Thread:4 of -msgid "" -"This is a derivation of the base Channel, since a thread can be its own " -"event." +msgid "An object representing a thread. .. note::" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator +#: interactions.api.models.channel.AsyncTypingContextManager #: interactions.api.models.channel.Channel #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.modify #: interactions.api.models.channel.Channel.pin_message @@ -72,6 +74,9 @@ msgstr "" #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit #: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit #: interactions.api.models.channel.Thread #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of @@ -88,7 +93,7 @@ msgid "" "needed to be used directly." msgstr "" -#: interactions.api.models.channel.Channel +#: interactions.api.models.channel.Channel interactions.api.models.channel.Tags #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of msgid "Variables" @@ -183,33 +188,64 @@ msgid "The amount of members in the channel." msgstr "" #: interactions.api.models.channel.Channel:29 of -msgid "The thread metadata of the channel." +msgid "Boolean representing if a thread is created." msgstr "" #: interactions.api.models.channel.Channel:30 of -msgid "The member of the thread in the channel." +msgid "The thread metadata of the channel." msgstr "" #: interactions.api.models.channel.Channel:31 of +msgid "The member of the thread in the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:32 of msgid "" "The set auto-archive time for all threads to naturally follow in the " "channel." msgstr "" -#: interactions.api.models.channel.Channel:32 of +#: interactions.api.models.channel.Channel:33 of msgid "The permissions of the channel." msgstr "" -#: interactions.api.models.channel.Channel.mention:1 of -msgid "Returns a string that allows you to mention the given channel." +#: interactions.api.models.channel.Channel:34 of +msgid "The flags of the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:35 of +msgid "Number of messages ever sent in a thread." +msgstr "" + +#: interactions.api.models.channel.Channel:36 of +msgid "" +"The default slowmode delay in seconds for threads, if this channel is a " +"forum." +msgstr "" + +#: interactions.api.models.channel.Channel:37 of +msgid "Tags in a forum channel, if any." +msgstr "" + +#: interactions.api.models.channel.Channel:38 of +msgid "Default reaction emoji for threads created in a forum, if any." +msgstr "" + +#: interactions.api.models.channel.Channel.typing:1 of +msgid "Manages the typing of the channel. Use with `await` or `async with`" msgstr "" #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.mention #: interactions.api.models.channel.Channel.modify @@ -224,24 +260,33 @@ msgstr "" #: interactions.api.models.channel.Channel.set_position #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic -#: interactions.api.models.channel.Channel.set_user_limit of +#: interactions.api.models.channel.Channel.set_user_limit +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Tags.edit of msgid "Returns" msgstr "" -#: interactions.api.models.channel.Channel.mention:3 of -msgid "The string of the mentioned channel." +#: interactions.api.models.channel.Channel.typing:3 of +msgid "A manager for typing" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator.flatten #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread #: interactions.api.models.channel.Channel.delete +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages #: interactions.api.models.channel.Channel.get_webhooks +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.join #: interactions.api.models.channel.Channel.leave #: interactions.api.models.channel.Channel.lock @@ -261,10 +306,44 @@ msgstr "" #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit -#: interactions.api.models.channel.Channel.unpin_message of +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit of msgid "Return type" msgstr "" +#: interactions.api.models.channel.Channel.mention:1 of +msgid "Returns a string that allows you to mention the given channel." +msgstr "" + +#: interactions.api.models.channel.Channel.mention:3 of +msgid "The string of the mentioned channel." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:7 +#: interactions.api.models.channel.Channel.history:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:9 +#: interactions.api.models.channel.Channel.history:3 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:13 +#: interactions.api.models.channel.Channel.history:5 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.channel.Channel.history:7 of +msgid "A custom check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.Channel.history:10 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" + #: interactions.api.models.channel.Channel.send:1 of msgid "Sends a message in the channel." msgstr "" @@ -292,7 +371,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.channel.Channel.send:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.channel.Channel.send:15 of @@ -625,10 +704,12 @@ msgstr "" msgid "Creates a thread in the Channel." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:3 #: interactions.api.models.channel.Channel.create_thread:3 of msgid "The name of the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:5 #: interactions.api.models.channel.Channel.create_thread:5 of msgid "" "duration in minutes to automatically archive the thread after recent " @@ -649,6 +730,7 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:16 #: interactions.api.models.channel.Channel.create_thread:14 of msgid "An optional reason for the audit log" msgstr "" @@ -734,6 +816,109 @@ msgstr "" msgid "Add the bot to the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:4 +#: interactions.api.models.channel.Channel.edit_tag:4 +#: interactions.api.models.channel.Tags.edit:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:7 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:9 +#: interactions.api.models.channel.Channel.edit_tag:11 +#: interactions.api.models.channel.Tags.edit:11 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:11 +#: interactions.api.models.channel.Channel.edit_tag:13 +#: interactions.api.models.channel.Tags.edit:13 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:13 of +msgid "The create tag object" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:1 of +msgid "Edits a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:7 of +msgid "The ID of the tag to edit" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:9 +#: interactions.api.models.channel.Tags.edit:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:15 +#: interactions.api.models.channel.Tags.edit:15 of +msgid "The modified tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:1 of +msgid "Deletes a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:3 of +msgid "The ID of the Tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:1 of +msgid "Creates a new post inside a forum channel" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:8 of +msgid "The content to send as first message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:10 of +msgid "Tags to give to the created thread" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:12 of +msgid "An optional list of files to send attached to the message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:14 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:18 of +msgid "A channel of ChannelType 11 (THREAD)" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:1 of +msgid "Returns the permissions of the member in this specific channel." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:4 of +msgid "" +"The permissions returned by this function take into account role and user" +" overwrites that can be assigned to channels or categories. If you don't " +"need these overwrites, look into :meth:`.Member.get_guild_permissions`." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:8 of +msgid "The member to get the permissions from" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:10 of +msgid "Permissions of the member in this channel" +msgstr "" + #: interactions.api.models.channel.ThreadMember:1 of msgid "A class object representing a member in a thread." msgstr "" @@ -793,3 +978,83 @@ msgstr "" #: interactions.api.models.channel.ThreadMetadata:11 of msgid "The ability to invite users to the thread." msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:3 +#: interactions.api.models.channel.AsyncTypingContextManager:5 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:11 of +msgid "A check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:1 of +msgid "An async context manager for triggering typing." +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:3 of +msgid "The channel to trigger typing in." +msgstr "" + +#: interactions.api.models.channel.Tags:1 of +msgid "An object denoting a tag object within a forum channel." +msgstr "" + +#: interactions.api.models.channel.Tags:4 of +msgid "If the emoji is custom, it won't have name information." +msgstr "" + +#: interactions.api.models.channel.Tags:6 of +msgid "Name of the tag. The limit is up to 20 characters." +msgstr "" + +#: interactions.api.models.channel.Tags:7 of +msgid "ID of the tag. Can also be 0 if manually created." +msgstr "" + +#: interactions.api.models.channel.Tags:8 of +msgid "" +"A boolean denoting whether this tag can be removed/added by moderators " +"with ``manage_threads`` permissions." +msgstr "" + +#: interactions.api.models.channel.Tags:9 of +msgid "The emoji to represent the tag, if any." +msgstr "" + +#: interactions.api.models.channel.Tags.delete:1 of +msgid "Deletes this tag" +msgstr "" + +#: interactions.api.models.channel.Tags.delete:3 +#: interactions.api.models.channel.Tags.edit:7 of +msgid "The ID of the channel where the tag belongs to" +msgstr "" + +#: interactions.api.models.channel.Tags.edit:1 of +msgid "Edits this tag" +msgstr "" + +#~ msgid "An object representing a thread." +#~ msgstr "" + +#~ msgid "" +#~ "This is a derivation of the base" +#~ " Channel, since a thread can be " +#~ "its own event." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.models.emoji.po b/docs/locale/hi/LC_MESSAGES/api.models.emoji.po new file mode 100644 index 000000000..2809ce66e --- /dev/null +++ b/docs/locale/hi/LC_MESSAGES/api.models.emoji.po @@ -0,0 +1,139 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-29 13:24-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.emoji.rst:4 +msgid "Emoji Models" +msgstr "" + +#: interactions.api.models.emoji.Emoji:1 of +msgid "A class objecting representing an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji of +msgid "Variables" +msgstr "" + +#: interactions.api.models.emoji.Emoji:3 of +msgid "Emoji id" +msgstr "" + +#: interactions.api.models.emoji.Emoji:4 of +msgid "Emoji name." +msgstr "" + +#: interactions.api.models.emoji.Emoji:5 of +msgid "Roles allowed to use this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:6 of +msgid "User that created this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:7 of +msgid "Status denoting of this emoji must be wrapped in colons" +msgstr "" + +#: interactions.api.models.emoji.Emoji:8 of +msgid "Status denoting if this emoji is managed (by an integration)" +msgstr "" + +#: interactions.api.models.emoji.Emoji:9 of +msgid "Status denoting if this emoji is animated" +msgstr "" + +#: interactions.api.models.emoji.Emoji:10 of +msgid "" +"Status denoting if this emoji can be used. (Can be false via server " +"boosting)" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:1 of +msgid "Gets an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild of +msgid "Parameters" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:3 of +msgid "The id of the guild of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:5 of +msgid "The id of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:7 +#: interactions.api.models.emoji.Emoji.get_all_of_guild:5 of +msgid "The HTTPClient of your bot. Equals to ``bot._http``" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Returns" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:9 of +msgid "The Emoji as object" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Return type" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:1 of +msgid "Gets all emoji of a guild." +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:3 of +msgid "The id of the guild to get the emojis of" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:7 of +msgid "The Emoji as list" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:1 of +msgid "Deletes the emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:3 of +msgid "The guild id to delete the emoji from" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:5 of +msgid "The reason of the deletion" +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:1 of +msgid "Returns the emoji's URL." +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:3 of +msgid "URL of the emoji" +msgstr "" + +#~ msgid "Audit-Log Models" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.models.guild.po b/docs/locale/hi/LC_MESSAGES/api.models.guild.po index a233b694b..6a195d3a5 100644 --- a/docs/locale/hi/LC_MESSAGES/api.models.guild.po +++ b/docs/locale/hi/LC_MESSAGES/api.models.guild.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:25-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.guild.rst:4 msgid "Guild Models" @@ -85,6 +85,7 @@ msgstr "" msgid "The location of the event, if any." msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator #: interactions.api.models.guild.EventMetadata #: interactions.api.models.guild.Guild #: interactions.api.models.guild.Guild.add_member_role @@ -95,17 +96,25 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji #: interactions.api.models.guild.Guild.delete_role #: interactions.api.models.guild.Guild.delete_scheduled_event +#: interactions.api.models.guild.Guild.delete_sticker +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule @@ -115,6 +124,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -672,13 +683,26 @@ msgid "The id of the member to ban" msgstr "" #: interactions.api.models.guild.Guild.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.guild.Guild.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:13 of +msgid "The reason of the ban" msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator.flatten #: interactions.api.models.guild.Guild.add_member_role #: interactions.api.models.guild.Guild.ban #: interactions.api.models.guild.Guild.clone_channel @@ -687,6 +711,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji @@ -698,13 +723,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.leave #: interactions.api.models.guild.Guild.list_auto_moderation_rules @@ -716,6 +749,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -840,6 +875,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_channel #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.get_all_active_threads #: interactions.api.models.guild.Guild.get_all_bans @@ -847,13 +883,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule #: interactions.api.models.guild.Guild.modify_channel @@ -862,6 +906,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.search_members of msgid "Returns" msgstr "" @@ -1508,6 +1554,20 @@ msgstr "" msgid "The created event" msgstr "" +#: interactions.api.models.guild.Guild.get_scheduled_events:1 of +msgid "Gets all scheduled events of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:3 of +msgid "" +"A boolean to include number of users subscribed to the associated event, " +"if given." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:5 of +msgid "The sheduled events of the guild." +msgstr "" + #: interactions.api.models.guild.Guild.modify_scheduled_event:1 of msgid "Edits a scheduled event of the guild." msgstr "" @@ -1614,6 +1674,40 @@ msgstr "" msgid "Gets all bans of the guild." msgstr "" +#: interactions.api.models.guild.Guild.prune:1 of +msgid "Begins a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:3 +#: interactions.api.models.guild.Guild.prune:3 of +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:4 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:4 +#: interactions.api.models.guild.Guild.prune:5 of +msgid "Role IDs to include, if given." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:6 of +msgid "" +"The number of pruned members, if compute_prune_count is not false. " +"Otherwise returns None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:1 of +msgid "Returns the number of members that would be removed in a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:5 of +msgid "The number of members that would be pruned." +msgstr "" + #: interactions.api.models.guild.Guild.get_emoji:1 of msgid "Gets an emoji of the guild and returns it." msgstr "" @@ -1664,6 +1758,77 @@ msgstr "" msgid "The emoji or the id of the emoji to delete" msgstr "" +#: interactions.api.models.guild.Guild.get_stickers:1 of +msgid "Get the stickers for a guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_stickers:3 of +msgid "List of stickers of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:1 of +msgid "Gets the list of sticker packs available to Nitro subscribers." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:3 of +msgid "List of sticker packs." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:1 of +msgid "Creates a new sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:3 of +msgid "The file of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:5 of +msgid "The tags of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:7 +#: interactions.api.models.guild.Guild.modify_sticker:5 of +msgid "The name of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:9 +#: interactions.api.models.guild.Guild.modify_sticker:7 of +msgid "The description of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:11 of +msgid "The reason of the creation." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:13 of +msgid "Created sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:1 of +msgid "Modifies the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:3 +#: interactions.api.models.guild.Guild.modify_sticker:3 of +msgid "The sticker or ID of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:9 of +msgid "The reason of the modification." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:11 of +msgid "Modified sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:1 of +msgid "Deletes the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:5 of +msgid "The reason of the deletion." +msgstr "" + #: interactions.api.models.guild.Guild.get_list_of_members:1 of msgid "Lists the members of a guild." msgstr "" @@ -1710,6 +1875,23 @@ msgstr "" msgid "Returns a list of all members of the guild" msgstr "" +#: interactions.api.models.guild.Guild.get_members:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:11 +#: interactions.api.models.guild.Guild.get_members:3 of +msgid "A set maximum of members to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:5 of +msgid "A custom check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:8 of +msgid "An asynchronous iterator over the members of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.list_auto_moderation_rules:1 of msgid "Lists all AutoMod rules" msgstr "" @@ -1784,6 +1966,55 @@ msgstr "" msgid "The rule to modify" msgstr "" +#: interactions.api.models.guild.Guild.get_audit_logs:1 of +msgid "Gets the audit logs of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:3 of +msgid "How many entries to get, default 100" +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:5 +#: interactions.api.models.guild.Guild.get_full_audit_logs:3 of +msgid "User ID snowflake. filter the log for actions made by a user." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:7 of +msgid "The Type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:9 of +msgid "filter the log before a certain entry id." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:11 of +msgid "The guild audit logs" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:1 of +msgid "Gets the latest audit log action of either a user or an action type" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:3 of +msgid "The user, user id or action type to look for" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:5 of +msgid "The latest AuditLog action that applies to the ``of`` parameter" +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:1 of +msgid "Gets the full audit log of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:5 of +msgid "The type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:7 of +msgid "The full AuditLog of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.icon_url:1 of msgid "" "Returns the URL of the guild's icon. :return: URL of the guild's icon " @@ -1897,3 +2128,32 @@ msgstr "" #: interactions.api.models.guild.Invite.delete:1 of msgid "Deletes the invite" msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:3 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:5 of +msgid "The guild to get the members from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:7 of +msgid "" +"The member ID to start getting members from (gets all members after that " +"member)" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:9 of +msgid "A check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.models.gw.po b/docs/locale/hi/LC_MESSAGES/api.models.gw.po index fe823c232..88a920629 100644 --- a/docs/locale/hi/LC_MESSAGES/api.models.gw.po +++ b/docs/locale/hi/LC_MESSAGES/api.models.gw.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.gw.rst:4 msgid "Gateway-specific Event Models" @@ -42,10 +42,10 @@ msgstr "" #: interactions.api.models.gw.GuildScheduledEventUser #: interactions.api.models.gw.GuildStickers #: interactions.api.models.gw.Integration +#: interactions.api.models.gw.MessageDelete #: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList +#: interactions.api.models.gw.MessageReactionRemove +#: interactions.api.models.gw.Presence interactions.api.models.gw.ThreadList #: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks #: of msgid "Variables" @@ -93,36 +93,6 @@ msgstr "" msgid "The substring in content that triggered rule." msgstr "" -#: interactions.api.models.gw.ApplicationCommandPermissions -#: interactions.api.models.gw.AutoModerationAction -#: interactions.api.models.gw.AutoModerationRule -#: interactions.api.models.gw.ChannelPins -#: interactions.api.models.gw.EmbeddedActivity -#: interactions.api.models.gw.GuildBan interactions.api.models.gw.GuildEmojis -#: interactions.api.models.gw.GuildIntegrations -#: interactions.api.models.gw.GuildJoinRequest -#: interactions.api.models.gw.GuildMember -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send -#: interactions.api.models.gw.GuildMembers interactions.api.models.gw.GuildRole -#: interactions.api.models.gw.GuildScheduledEvent -#: interactions.api.models.gw.GuildScheduledEventUser -#: interactions.api.models.gw.GuildStickers -#: interactions.api.models.gw.Integration -#: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList -#: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks -#: of -msgid "Parameters" -msgstr "" - #: interactions.api.models.gw.AutoModerationRule:1 of msgid "" "A class object representing the gateway events " @@ -232,14 +202,14 @@ msgstr "" #: interactions.api.models.gw.GuildEmojis:3 #: interactions.api.models.gw.GuildIntegrations:3 #: interactions.api.models.gw.GuildJoinRequest:7 -#: interactions.api.models.gw.GuildMember:3 #: interactions.api.models.gw.GuildMembers:3 #: interactions.api.models.gw.GuildRole:3 #: interactions.api.models.gw.GuildStickers:3 #: interactions.api.models.gw.Integration:23 +#: interactions.api.models.gw.MessageDelete:5 #: interactions.api.models.gw.MessageReaction:6 +#: interactions.api.models.gw.MessageReactionRemove:10 #: interactions.api.models.gw.Presence:4 -#: interactions.api.models.gw.ReactionRemove:10 #: interactions.api.models.gw.ThreadList:3 #: interactions.api.models.gw.ThreadMembers:4 of msgid "The guild ID of the event." @@ -251,8 +221,9 @@ msgstr "" #: interactions.api.models.gw.ChannelPins:4 #: interactions.api.models.gw.EmbeddedActivity:9 +#: interactions.api.models.gw.MessageDelete:4 #: interactions.api.models.gw.MessageReaction:4 -#: interactions.api.models.gw.ReactionRemove:8 of +#: interactions.api.models.gw.MessageReactionRemove:8 of msgid "The channel ID of the event." msgstr "" @@ -312,7 +283,6 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildBan:4 -#: interactions.api.models.gw.GuildMember:5 #: interactions.api.models.gw.Integration:17 #: interactions.api.models.gw.Presence:3 of msgid "The user of the event." @@ -378,14 +348,21 @@ msgstr "" msgid "The members of the thread of the event." msgstr "" -#: interactions.api.models.gw.ReactionRemove:1 of +#: interactions.api.models.gw.MessageDelete:1 of +msgid "A class object representing the gateway event ``MESSAGE_DELETE_BULK``." +msgstr "" + +#: interactions.api.models.gw.MessageDelete:3 of +msgid "The message IDs of the event." +msgstr "" + +#: interactions.api.models.gw.MessageReactionRemove:1 of msgid "" "A class object representing the gateway events " -"``MESSAGE_REACTION_REMOVE``, ``MESSAGE_REACTION_REMOVE_ALL`` and " -"``MESSAGE_REACTION_REMOVE_EMOJI``." +"``MESSAGE_REACTION_REMOVE_ALL`` and ``MESSAGE_REACTION_REMOVE_EMOJI``." msgstr "" -#: interactions.api.models.gw.ReactionRemove:4 of +#: interactions.api.models.gw.MessageReactionRemove:4 of msgid "" "This class inherits the already existing attributes of " ":class:`interactions.api.models.gw.Reaction`. The main missing attribute " @@ -394,22 +371,24 @@ msgstr "" #: interactions.api.models.gw.GuildJoinRequest:6 #: interactions.api.models.gw.MessageReaction:3 -#: interactions.api.models.gw.ReactionRemove:7 of +#: interactions.api.models.gw.MessageReactionRemove:7 of msgid "The user ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:5 -#: interactions.api.models.gw.ReactionRemove:9 of +#: interactions.api.models.gw.MessageReactionRemove:9 of msgid "The message ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:8 -#: interactions.api.models.gw.ReactionRemove:11 of +#: interactions.api.models.gw.MessageReactionRemove:11 of msgid "The emoji of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:1 of -msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +msgid "" +"A class object representing the gateway event ``MESSAGE_REACTION_ADD`` " +"and ``MESSAGE_REACTION_REMOVE``." msgstr "" #: interactions.api.models.gw.MessageReaction:7 of @@ -473,204 +452,58 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildMember:4 of -msgid "The roles of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:6 of -msgid "The nickname of the user of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:7 of -msgid "The avatar URL of the user of the event." +msgid "" +"``pending`` and ``permissions`` only apply for members retroactively " +"requiring to verify rules via. membership screening or lack permissions " +"to speak." msgstr "" #: interactions.api.models.gw.GuildMember:8 of -msgid "The time that the user of the event joined at." +msgid "The guild ID." msgstr "" #: interactions.api.models.gw.GuildMember:9 of -msgid "The time that the user of the event has since had \"premium.\"" +msgid "The user of the guild." msgstr "" #: interactions.api.models.gw.GuildMember:10 of -msgid "Whether the member of the event is deafened or not." +msgid "The nickname of the member." msgstr "" #: interactions.api.models.gw.GuildMember:11 of -msgid "Whether the member of the event is muted or not." +msgid "The hash containing the user's guild avatar, if applicable." msgstr "" #: interactions.api.models.gw.GuildMember:12 of -msgid "" -"Whether the member of the event is still pending -- pass membership " -"screening -- or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:1 of -msgid "Returns the ID of the user." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.send of -msgid "Returns" -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:3 of -msgid "The ID of the user" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send of -msgid "Return type" -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:1 of -msgid "Returns the string of either the user's nickname or username." -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:3 of -msgid "The name of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:1 of -msgid "Returns a string that allows you to mention the given member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:3 of -msgid "The string of the mentioned member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:1 of -msgid "Bans the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:3 of -msgid "The reason of the ban" -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:1 of -msgid "Kicks the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:3 of -msgid "The reason for the kick" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:1 of -msgid "This method adds a role to a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:3 of -msgid "The role to add. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:5 of -msgid "The reason why the roles are added" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:1 of -msgid "This method removes a role from a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:3 of -msgid "The role to remove. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:5 of -msgid "The reason why the roles are removed" -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:1 of -msgid "Sends a DM to the member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:3 of -msgid "The contents of the message as a string or string-converted value." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:5 of -msgid "A component, or list of components for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:7 of -msgid "Whether the message utilizes the text-to-speech Discord programme or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:9 of -msgid "A file or list of files to be attached to the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:11 of -msgid "An embed, or list of embeds for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:13 of -msgid "The message interactions/mention limits that the message can refer to." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:15 of -msgid "The sent message as an object." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:1 of -msgid "Modifies the member of a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:3 of -msgid "The nickname of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:5 of -msgid "A list of all role ids the member has" +msgid "The list of roles of the member." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:7 of -msgid "whether the user is muted in voice channels" +#: interactions.api.models.gw.GuildMember:13 of +msgid "The timestamp the member joined the guild at." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:9 of -msgid "whether the user is deafened in voice channels" +#: interactions.api.models.gw.GuildMember:14 of +msgid "The timestamp the member has been a server booster since." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:11 of -msgid "id of channel to move user to (if they are connected to voice)" +#: interactions.api.models.gw.GuildMember:15 of +msgid "Whether the member is deafened." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:13 of -msgid "" -"when the user's timeout will expire and the user will be able to " -"communicate in the guild again (up to 28 days in the future)" +#: interactions.api.models.gw.GuildMember:16 of +msgid "Whether the member is muted." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:15 of -msgid "The reason of the modifying" +#: interactions.api.models.gw.GuildMember:17 of +msgid "Whether the member is pending to pass membership screening." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:17 of -msgid "The modified member object" +#: interactions.api.models.gw.GuildMember:18 of +msgid "Whether the member has permissions." msgstr "" -#: interactions.api.models.gw.GuildMember.add_to_thread:1 of -msgid "Adds the member to a thread." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_to_thread:3 of -msgid "The id of the thread to add the member to" +#: interactions.api.models.gw.GuildMember:19 of +msgid "How long until they're unmuted, if any." msgstr "" #: interactions.api.models.gw.GuildStickers:1 of @@ -823,3 +656,164 @@ msgstr "" #: interactions.api.models.gw.GuildRole:5 of msgid "The role ID of the event." msgstr "" + +#~ msgid "" +#~ "A class object representing the gateway" +#~ " events ``MESSAGE_REACTION_REMOVE``, " +#~ "``MESSAGE_REACTION_REMOVE_ALL`` and " +#~ "``MESSAGE_REACTION_REMOVE_EMOJI``." +#~ msgstr "" + +#~ msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +#~ msgstr "" + +#~ msgid "The roles of the event." +#~ msgstr "" + +#~ msgid "The nickname of the user of the event." +#~ msgstr "" + +#~ msgid "The avatar URL of the user of the event." +#~ msgstr "" + +#~ msgid "The time that the user of the event joined at." +#~ msgstr "" + +#~ msgid "The time that the user of the event has since had \"premium.\"" +#~ msgstr "" + +#~ msgid "Whether the member of the event is deafened or not." +#~ msgstr "" + +#~ msgid "Whether the member of the event is muted or not." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the member of the event is" +#~ " still pending -- pass membership " +#~ "screening -- or not." +#~ msgstr "" + +#~ msgid "Returns the ID of the user." +#~ msgstr "" + +#~ msgid "Returns" +#~ msgstr "" + +#~ msgid "The ID of the user" +#~ msgstr "" + +#~ msgid "Return type" +#~ msgstr "" + +#~ msgid "Returns the string of either the user's nickname or username." +#~ msgstr "" + +#~ msgid "The name of the member" +#~ msgstr "" + +#~ msgid "Returns a string that allows you to mention the given member." +#~ msgstr "" + +#~ msgid "The string of the mentioned member." +#~ msgstr "" + +#~ msgid "Bans the member from a guild." +#~ msgstr "" + +#~ msgid "The reason of the ban" +#~ msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Kicks the member from a guild." +#~ msgstr "" + +#~ msgid "The reason for the kick" +#~ msgstr "" + +#~ msgid "This method adds a role to a member." +#~ msgstr "" + +#~ msgid "The role to add. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are added" +#~ msgstr "" + +#~ msgid "This method removes a role from a member." +#~ msgstr "" + +#~ msgid "The role to remove. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are removed" +#~ msgstr "" + +#~ msgid "Sends a DM to the member." +#~ msgstr "" + +#~ msgid "The contents of the message as a string or string-converted value." +#~ msgstr "" + +#~ msgid "A component, or list of components for the message." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the message utilizes the " +#~ "text-to-speech Discord programme or " +#~ "not." +#~ msgstr "" + +#~ msgid "A file or list of files to be attached to the message." +#~ msgstr "" + +#~ msgid "An embed, or list of embeds for the message." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The sent message as an object." +#~ msgstr "" + +#~ msgid "Modifies the member of a guild." +#~ msgstr "" + +#~ msgid "The nickname of the member" +#~ msgstr "" + +#~ msgid "A list of all role ids the member has" +#~ msgstr "" + +#~ msgid "whether the user is muted in voice channels" +#~ msgstr "" + +#~ msgid "whether the user is deafened in voice channels" +#~ msgstr "" + +#~ msgid "id of channel to move user to (if they are connected to voice)" +#~ msgstr "" + +#~ msgid "" +#~ "when the user's timeout will expire " +#~ "and the user will be able to " +#~ "communicate in the guild again (up " +#~ "to 28 days in the future)" +#~ msgstr "" + +#~ msgid "The reason of the modifying" +#~ msgstr "" + +#~ msgid "The modified member object" +#~ msgstr "" + +#~ msgid "Adds the member to a thread." +#~ msgstr "" + +#~ msgid "The id of the thread to add the member to" +#~ msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.models.member.po b/docs/locale/hi/LC_MESSAGES/api.models.member.po index ce23f99ac..f5839f391 100644 --- a/docs/locale/hi/LC_MESSAGES/api.models.member.po +++ b/docs/locale/hi/LC_MESSAGES/api.models.member.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.member.rst:4 msgid "Member Models" @@ -86,6 +86,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.modify #: interactions.api.models.member.Member.remove_role @@ -93,10 +95,20 @@ msgstr "" msgid "Parameters" msgstr "" +#: interactions.api.models.member.Member.guild_id:1 of +msgid "" +"Attempts to get the guild ID the member is in. Only works then roles or " +"nick or joined at is present. :return: The ID of the guild this member " +"belongs to." +msgstr "" + #: interactions.api.models.member.Member.id:1 of msgid "Returns the ID of the user." msgstr "" +#: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.mention #: interactions.api.models.member.Member.modify @@ -113,6 +125,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.mention @@ -148,11 +162,23 @@ msgid "The id of the guild to ban the member from" msgstr "" #: interactions.api.models.member.Member.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.member.Member.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.member.Member.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.member.Member.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.member.Member.ban:13 of +msgid "The reason of the ban" msgstr "" #: interactions.api.models.member.Member.kick:1 of @@ -230,7 +256,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.member.Member.send:15 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.member.Member.send:17 of @@ -288,9 +314,83 @@ msgid "The id of the thread to add the member to" msgstr "" #: interactions.api.models.member.Member.get_avatar_url:1 of +msgid "Returns the URL of the member's avatar for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:3 of +msgid "The id of the guild to get the member's avatar from" +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:5 of +msgid "URL of the members's avatar (None will be returned if no avatar is set)" +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:1 of +msgid "Returns the permissions of the member for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:4 of msgid "" -"Returns the URL of the member's avatar for the specified guild. :param " -"guild_id: The id of the guild to get the member's avatar from :type " -"guild_id: Union[int, Snowflake, \"Guild\"] :return: URL of the members's " -"avatar (None will be returned if no avatar is set) :rtype: str" +"The permissions returned by this function will not take into account role" +" and user overwrites that can be assigned to channels or categories. If " +"you need these overwrites, look into " +":meth:`.Channel.get_permissions_for`." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:8 of +msgid "The guild of the member" msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:10 of +msgid "Base permissions of the member in the specified guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:1 of +msgid "Returns whether the member has the permissions passed." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:4 of +msgid "" +"If the channel argument is present, the function will look if the member " +"has the permissions in the specified channel. If the argument is missing," +" then it will only consider the member's guild permissions." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:7 of +msgid "The list of permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:9 of +msgid "The channel where to check for permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:11 of +msgid "The id of the guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:13 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:15 of +msgid "Whether the member has the permissions" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "" +#~ "Returns the URL of the member's " +#~ "avatar for the specified guild. :param" +#~ " guild_id: The id of the guild " +#~ "to get the member's avatar from " +#~ ":type guild_id: Union[int, Snowflake, " +#~ "\"Guild\"] :return: URL of the members's" +#~ " avatar (None will be returned if " +#~ "no avatar is set) :rtype: str" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.models.message.po b/docs/locale/hi/LC_MESSAGES/api.models.message.po index 5bcd77f9c..e1f033a87 100644 --- a/docs/locale/hi/LC_MESSAGES/api.models.message.po +++ b/docs/locale/hi/LC_MESSAGES/api.models.message.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.message.rst:4 msgid "Message Models" @@ -50,14 +50,14 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji #: interactions.api.models.message.Message #: interactions.api.models.message.MessageActivity #: interactions.api.models.message.MessageInteraction #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Variables" msgstr "" @@ -156,33 +156,33 @@ msgid "" msgstr "" #: interactions.api.models.message.Message:26 of -msgid "The allowed mentions of roles attached in the message." -msgstr "" - -#: interactions.api.models.message.Message:27 of msgid "Message flags" msgstr "" -#: interactions.api.models.message.Message:28 of +#: interactions.api.models.message.Message:27 of msgid "Message interaction object, if the message is sent by an interaction." msgstr "" -#: interactions.api.models.message.Message:29 of +#: interactions.api.models.message.Message:28 of msgid "" "The thread that started from this message, if any, with a thread member " "object embedded." msgstr "" +#: interactions.api.models.message.Message:29 of +msgid "Array of Action Rows associated with this message, if any." +msgstr "" + #: interactions.api.models.message.Message:30 of -msgid "Components associated with this message, if any." +msgid "An array of message sticker item objects, if sent with them." msgstr "" #: interactions.api.models.message.Message:31 of -msgid "An array of message sticker item objects, if sent with them." +msgid "Array of sticker objects sent with the message if any. Deprecated." msgstr "" #: interactions.api.models.message.Message:32 of -msgid "Array of sticker objects sent with the message if any. Deprecated." +msgid "The approximate position of the message in a thread." msgstr "" #: interactions.api.models.message.Attachment @@ -202,10 +202,6 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild #: interactions.api.models.message.Message #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread @@ -222,7 +218,8 @@ msgstr "" #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Parameters" msgstr "" @@ -230,6 +227,7 @@ msgstr "" msgid "Gets the channel where the message was sent." msgstr "" +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Embed.add_field #: interactions.api.models.message.Embed.clear_fields #: interactions.api.models.message.Embed.insert_field_at @@ -241,13 +239,10 @@ msgstr "" #: interactions.api.models.message.Embed.set_image #: interactions.api.models.message.Embed.set_thumbnail #: interactions.api.models.message.Embed.set_video -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread #: interactions.api.models.message.Message.delete +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_channel #: interactions.api.models.message.Message.get_from_url @@ -307,7 +302,7 @@ msgstr "" #: interactions.api.models.message.Message.edit:13 #: interactions.api.models.message.Message.reply:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.message.Message.edit:15 @@ -323,10 +318,9 @@ msgid "" "components will be removed" msgstr "" -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Message.create_thread +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_from_url #: interactions.api.models.message.Message.get_users_from_reaction @@ -466,6 +460,14 @@ msgstr "" msgid "The URL of said message" msgstr "" +#: interactions.api.models.message.Message.disable_all_components:1 of +msgid "Sets all components to disabled on this message." +msgstr "" + +#: interactions.api.models.message.Message.disable_all_components:3 of +msgid "The modified message." +msgstr "" + #: interactions.api.models.message.MessageReference:1 of msgid "A class object representing the \"referenced\"/replied message." msgstr "" @@ -654,20 +656,26 @@ msgstr "" msgid "Inserts a field in the embed at the specified index" msgstr "" -#: interactions.api.models.message.Embed.insert_field_at:3 -#: interactions.api.models.message.Embed.remove_field:3 -#: interactions.api.models.message.Embed.set_field_at:3 of -msgid "The new field's index" +#: interactions.api.models.message.Embed.insert_field_at:3 of +msgid "The field's index to insert" msgstr "" #: interactions.api.models.message.Embed.set_field_at:1 of msgid "Overwrites the field in the embed at the specified index" msgstr "" +#: interactions.api.models.message.Embed.set_field_at:3 of +msgid "The field's index to overwrite" +msgstr "" + #: interactions.api.models.message.Embed.remove_field:1 of msgid "Remove field at the specified index" msgstr "" +#: interactions.api.models.message.Embed.remove_field:3 of +msgid "The field's index to remove" +msgstr "" + #: interactions.api.models.message.Embed.remove_author:1 of msgid "Removes the embed's author" msgstr "" @@ -906,95 +914,12 @@ msgstr "" msgid "Whether the attachment is ephemeral." msgstr "" -#: interactions.api.models.message.Emoji:1 of -msgid "A class objecting representing an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji:3 of -msgid "Emoji id" -msgstr "" - -#: interactions.api.models.message.Emoji:4 of -msgid "Emoji name." -msgstr "" - -#: interactions.api.models.message.Emoji:5 of -msgid "Roles allowed to use this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:6 of -msgid "User that created this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:7 of -msgid "Status denoting of this emoji must be wrapped in colons" -msgstr "" - -#: interactions.api.models.message.Emoji:8 of -msgid "Status denoting if this emoji is managed (by an integration)" -msgstr "" - -#: interactions.api.models.message.Emoji:9 of -msgid "Status denoting if this emoji is animated" -msgstr "" - -#: interactions.api.models.message.Emoji:10 of -msgid "" -"Status denoting if this emoji can be used. (Can be false via server " -"boosting)" -msgstr "" - -#: interactions.api.models.message.Emoji.get:1 of -msgid "Gets an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.get:3 of -msgid "The id of the guild of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:5 of -msgid "The id of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:7 -#: interactions.api.models.message.Emoji.get_all_of_guild:5 of -msgid "The HTTPClient of your bot. Equals to ``bot._http``" -msgstr "" - -#: interactions.api.models.message.Emoji.get:9 of -msgid "The Emoji as object" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:1 of -msgid "Gets all emoji of a guild." +#: interactions.api.models.message.Attachment.download:1 of +msgid "Downloads the attachment." msgstr "" -#: interactions.api.models.message.Emoji.get_all_of_guild:3 of -msgid "The id of the guild to get the emojis of" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:7 of -msgid "The Emoji as list" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:1 of -msgid "Deletes the emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.delete:3 of -msgid "The guild id to delete the emoji from" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:5 of -msgid "The reason of the deletion" -msgstr "" - -#: interactions.api.models.message.Emoji.url:1 of -msgid "Returns the emoji's URL." -msgstr "" - -#: interactions.api.models.message.Emoji.url:3 of -msgid "URL of the emoji" +#: interactions.api.models.message.Attachment.download:3 of +msgid "The attachment's bytes as BytesIO object" msgstr "" #: interactions.api.models.message.EmbedFooter:1 of @@ -1093,3 +1018,116 @@ msgstr "" #: interactions.api.models.message.Sticker:14 of msgid "The standard sticker's sort order within its pack" msgstr "" + +#: interactions.api.models.message.StickerPack:1 of +msgid "A class objects representing a pack of stickers." +msgstr "" + +#: interactions.api.models.message.StickerPack:3 of +msgid "ID of the sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:4 of +msgid "The stickers in the pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:5 of +msgid "The name of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:6 of +msgid "ID of the pack's SKU." +msgstr "" + +#: interactions.api.models.message.StickerPack:7 of +msgid "ID of a sticker in the pack which is shown as the pack's icon." +msgstr "" + +#: interactions.api.models.message.StickerPack:8 of +msgid "The description of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:9 of +msgid "ID of the sticker pack's banner image." +msgstr "" + +#~ msgid "The allowed mentions of roles attached in the message." +#~ msgstr "" + +#~ msgid "Components associated with this message, if any." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The new field's index" +#~ msgstr "" + +#~ msgid "A class objecting representing an emoji." +#~ msgstr "" + +#~ msgid "Emoji id" +#~ msgstr "" + +#~ msgid "Emoji name." +#~ msgstr "" + +#~ msgid "Roles allowed to use this emoji" +#~ msgstr "" + +#~ msgid "User that created this emoji" +#~ msgstr "" + +#~ msgid "Status denoting of this emoji must be wrapped in colons" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is managed (by an integration)" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is animated" +#~ msgstr "" + +#~ msgid "" +#~ "Status denoting if this emoji can " +#~ "be used. (Can be false via server" +#~ " boosting)" +#~ msgstr "" + +#~ msgid "Gets an emoji." +#~ msgstr "" + +#~ msgid "The id of the guild of the emoji" +#~ msgstr "" + +#~ msgid "The id of the emoji" +#~ msgstr "" + +#~ msgid "The HTTPClient of your bot. Equals to ``bot._http``" +#~ msgstr "" + +#~ msgid "The Emoji as object" +#~ msgstr "" + +#~ msgid "Gets all emoji of a guild." +#~ msgstr "" + +#~ msgid "The id of the guild to get the emojis of" +#~ msgstr "" + +#~ msgid "The Emoji as list" +#~ msgstr "" + +#~ msgid "Deletes the emoji." +#~ msgstr "" + +#~ msgid "The guild id to delete the emoji from" +#~ msgstr "" + +#~ msgid "The reason of the deletion" +#~ msgstr "" + +#~ msgid "Returns the emoji's URL." +#~ msgstr "" + +#~ msgid "URL of the emoji" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.models.misc.po b/docs/locale/hi/LC_MESSAGES/api.models.misc.po index cfed122db..77ec620aa 100644 --- a/docs/locale/hi/LC_MESSAGES/api.models.misc.po +++ b/docs/locale/hi/LC_MESSAGES/api.models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.misc.rst:4 msgid "Miscellanous Models" @@ -27,6 +27,7 @@ msgstr "" msgid "An enumeration." msgstr "" +#: interactions.api.models.misc.AllowedMentionType #: interactions.api.models.misc.AutoModKeywordPresetTypes #: interactions.api.models.misc.AutoModTriggerType of msgid "Member Type" @@ -37,6 +38,7 @@ msgstr "" msgid ":py:class:`int`" msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 #: interactions.api.models.misc.AutoModKeywordPresetTypes:1 #: interactions.api.models.misc.AutoModTriggerType:1 of msgid "Valid values are as follows:" @@ -50,6 +52,7 @@ msgstr "" msgid "The maximum duration for duration_seconds is 2419200 seconds, aka 4 weeks." msgstr "" +#: interactions.api.models.misc.AllowedMentions #: interactions.api.models.misc.AutoModAction #: interactions.api.models.misc.AutoModMetaData #: interactions.api.models.misc.AutoModTriggerMetadata @@ -66,15 +69,6 @@ msgstr "" msgid "Timeout duration in seconds, if timed out." msgstr "" -#: interactions.api.models.misc.AutoModAction -#: interactions.api.models.misc.AutoModMetaData -#: interactions.api.models.misc.AutoModTriggerMetadata -#: interactions.api.models.misc.ClientStatus interactions.api.models.misc.File -#: interactions.api.models.misc.Image interactions.api.models.misc.Overwrite -#: interactions.api.models.misc.Snowflake of -msgid "Parameters" -msgstr "" - #: interactions.api.models.misc.AutoModAction:1 of msgid "" "A class object used for the ``AUTO_MODERATION_ACTION_EXECUTION`` event. " @@ -107,6 +101,53 @@ msgstr "" msgid "The internally pre-defined wordsets which will be searched for in content." msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "An enumerable object representing the allowed mention types" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:1 of +msgid "A class object representing the allowed mentions object" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:3 of +msgid "" +"Optional[List[AllowedMentionType]]: An array of allowed mention types to " +"parse from the content." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:4 of +msgid "Optional[List[int]]: An array of user ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:5 of +msgid "Optional[List[int]]: An array of role ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:6 of +msgid "" +"Optional[bool]: For replies, whether to mention the author of the message" +" being replied to." +msgstr "" + #: interactions.api.models.misc.Snowflake:1 of msgid "The Snowflake object." msgstr "" @@ -129,17 +170,6 @@ msgid "" "integer." msgstr "" -#: interactions.api.models.misc.Color.black -#: interactions.api.models.misc.Color.blurple -#: interactions.api.models.misc.Color.fuchsia -#: interactions.api.models.misc.Color.green -#: interactions.api.models.misc.Color.red -#: interactions.api.models.misc.Color.white -#: interactions.api.models.misc.Color.yellow -#: interactions.api.models.misc.Snowflake of -msgid "Return type" -msgstr "" - #: interactions.api.models.misc.Snowflake.increment:1 of msgid "" "This is the 'Increment' portion of the snowflake. This is incremented for" @@ -199,6 +229,16 @@ msgstr "" msgid "Returns a hexadecimal value of the blurple color." msgstr "" +#: interactions.api.models.misc.Color.black +#: interactions.api.models.misc.Color.blurple +#: interactions.api.models.misc.Color.fuchsia +#: interactions.api.models.misc.Color.green +#: interactions.api.models.misc.Color.red +#: interactions.api.models.misc.Color.white +#: interactions.api.models.misc.Color.yellow of +msgid "Return type" +msgstr "" + #: interactions.api.models.misc.Color.green:1 of msgid "Returns a hexadecimal value of the green color." msgstr "" @@ -287,3 +327,6 @@ msgstr "" #: interactions.api.models.misc.Overwrite:6 of msgid "Permission bit set." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.models.presence.po b/docs/locale/hi/LC_MESSAGES/api.models.presence.po index 347c24dbc..cfbae19fa 100644 --- a/docs/locale/hi/LC_MESSAGES/api.models.presence.po +++ b/docs/locale/hi/LC_MESSAGES/api.models.presence.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.presence.rst:4 msgid "Presence Models" @@ -43,15 +43,6 @@ msgstr "" msgid "An array denoting the party's current and max size" msgstr "" -#: interactions.api.models.presence.ClientPresence -#: interactions.api.models.presence.PresenceActivity -#: interactions.api.models.presence.PresenceAssets -#: interactions.api.models.presence.PresenceParty -#: interactions.api.models.presence.PresenceSecrets -#: interactions.api.models.presence.PresenceTimestamp of -msgid "Parameters" -msgstr "" - #: interactions.api.models.presence.PresenceAssets:1 of msgid "A class object representing the assets of a presence." msgstr "" @@ -231,3 +222,6 @@ msgstr "" #: interactions.api.models.presence.ClientPresence:6 of msgid "Whether the client is afk or not." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.models.role.po b/docs/locale/hi/LC_MESSAGES/api.models.role.po index c78eeec53..4828e3cfc 100644 --- a/docs/locale/hi/LC_MESSAGES/api.models.role.po +++ b/docs/locale/hi/LC_MESSAGES/api.models.role.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.role.rst:4 msgid "Role Models" @@ -130,6 +130,12 @@ msgstr "" msgid "RGB color value as integer, defaults to the current value of the role" msgstr "" +#: interactions.api.models.role.Role.modify:9 of +msgid "" +"Bitwise value of the enabled/disabled permissions, defaults to the " +"current value of the role" +msgstr "" + #: interactions.api.models.role.Role.modify:11 of msgid "" "Whether the role should be displayed separately in the sidebar, defaults " diff --git a/docs/locale/hi/LC_MESSAGES/api.models.team.po b/docs/locale/hi/LC_MESSAGES/api.models.team.po index 2958a4252..36accb3a5 100644 --- a/docs/locale/hi/LC_MESSAGES/api.models.team.po +++ b/docs/locale/hi/LC_MESSAGES/api.models.team.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.team.rst:4 msgid "Team Models" @@ -51,11 +51,6 @@ msgstr "" msgid "The User ID of the current team owner" msgstr "" -#: interactions.api.models.team.Application interactions.api.models.team.Team -#: interactions.api.models.team.TeamMember of -msgid "Parameters" -msgstr "" - #: interactions.api.models.team.TeamMember:1 of msgid "A class object representing the member of a team." msgstr "" @@ -183,3 +178,6 @@ msgstr "" #: interactions.api.models.team.Application.icon_url of msgid "Return type" msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.models.user.po b/docs/locale/hi/LC_MESSAGES/api.models.user.po index 5721c56da..00f10cc86 100644 --- a/docs/locale/hi/LC_MESSAGES/api.models.user.po +++ b/docs/locale/hi/LC_MESSAGES/api.models.user.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.user.rst:4 msgid "User Models" @@ -94,17 +94,14 @@ msgstr "" msgid "The user's public flags" msgstr "" -#: interactions.api.models.user.User of -msgid "Parameters" -msgstr "" - #: interactions.api.models.user.User.mention:1 of msgid "Returns a string that allows you to mention the given user." msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Returns" msgstr "" @@ -114,7 +111,8 @@ msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Return type" msgstr "" @@ -133,3 +131,14 @@ msgstr "" #: interactions.api.models.user.User.banner_url:3 of msgid "URL of the user's banner (None will be returned if no banner is set)" msgstr "" + +#: interactions.api.models.user.User.presence:1 of +msgid "Returns the presence of the user." +msgstr "" + +#: interactions.api.models.user.User.presence:3 of +msgid "Presence of the user (None will be returned if not cached)" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/api.models.webhook.po b/docs/locale/hi/LC_MESSAGES/api.models.webhook.po index be10a2fd1..906a172a9 100644 --- a/docs/locale/hi/LC_MESSAGES/api.models.webhook.po +++ b/docs/locale/hi/LC_MESSAGES/api.models.webhook.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.webhook.rst:4 msgid "Webhook Models" @@ -209,7 +209,7 @@ msgid "embedded ``rich`` content" msgstr "" #: interactions.api.models.webhook.Webhook.execute:18 of -msgid "allowed mentions for the message" +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.webhook.Webhook.execute:20 of @@ -257,3 +257,6 @@ msgstr "" #: interactions.api.models.webhook.WebhookType:1 of msgid "Valid values are as follows:" msgstr "" + +#~ msgid "allowed mentions for the message" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/client.po b/docs/locale/hi/LC_MESSAGES/client.po index 854019fc5..48424e61c 100644 --- a/docs/locale/hi/LC_MESSAGES/client.po +++ b/docs/locale/hi/LC_MESSAGES/client.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../client.rst:4 msgid "Bot Client" @@ -31,10 +31,6 @@ msgstr "" #: interactions.client.bot.Client #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence @@ -44,6 +40,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.user_command #: interactions.client.bot.Extension of msgid "Parameters" @@ -80,60 +77,73 @@ msgid "" "automatic or not." msgstr "" +#: interactions.client.bot.Client:15 of +msgid "" +"Set to ``True`` to enable debug logging or set to a log level to use a " +"specific level" +msgstr "" + #: interactions.client.bot.Client of msgid "Variables" msgstr "" -#: interactions.client.bot.Client:16 of +#: interactions.client.bot.Client:18 of msgid "The asynchronous event loop of the client." msgstr "" -#: interactions.client.bot.Client:17 of +#: interactions.client.bot.Client:19 of msgid "" "The user-facing HTTP connection to the Web API, as its own separate " "client." msgstr "" -#: interactions.client.bot.Client:18 of +#: interactions.client.bot.Client:20 of msgid "An object-orientation of a websocket server connection to the Gateway." msgstr "" -#: interactions.client.bot.Client:19 of +#: interactions.client.bot.Client:21 of msgid "The Gateway intents of the application. Defaults to ``Intents.DEFAULT``." msgstr "" -#: interactions.client.bot.Client:20 of +#: interactions.client.bot.Client:22 of msgid "The list of bucketed shards for the application's connection." msgstr "" -#: interactions.client.bot.Client:21 of +#: interactions.client.bot.Client:23 of msgid "The RPC-like presence shown on an application once connected." msgstr "" -#: interactions.client.bot.Client:22 of +#: interactions.client.bot.Client:24 of msgid "The token of the application used for authentication when connecting." msgstr "" -#: interactions.client.bot.Client:23 of +#: interactions.client.bot.Client:25 of msgid "The \"extensions\" or cog equivalence registered to the main client." msgstr "" -#: interactions.client.bot.Client:24 of +#: interactions.client.bot.Client:26 of msgid "The application representation of the client." msgstr "" -#: interactions.client.bot.Client +#: interactions.client.bot.Client.guilds:1 of +msgid "Returns a list of guilds the bot is in." +msgstr "" + +#: interactions.client.bot.Client.latency:1 of +msgid "Returns the connection latency in milliseconds." +msgstr "" + +#: interactions.client.bot.Client.start:1 of +msgid "Starts the client session." +msgstr "" + #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create -#: interactions.client.bot.Client.__register_events #: interactions.client.bot.Client.__resolve_commands #: interactions.client.bot.Client.__sync #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client._login interactions.client.bot.Client._ready +#: interactions.client.bot.Client._stop #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence #: interactions.client.bot.Client.command @@ -142,6 +152,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.start #: interactions.client.bot.Client.user_command #: interactions.client.bot.Client.wait_until_ready @@ -149,22 +160,6 @@ msgstr "" msgid "Return type" msgstr "" -#: interactions.client.bot.Client.guilds:1 of -msgid "Returns a list of guilds the bot is in." -msgstr "" - -#: interactions.client.bot.Client.latency:1 of -msgid "Returns the connection latency in milliseconds." -msgstr "" - -#: interactions.client.bot.Client.start:1 of -msgid "Starts the client session." -msgstr "" - -#: interactions.client.bot.Client.__register_events:1 of -msgid "Registers all raw gateway events to the known events." -msgstr "" - #: interactions.client.bot.Client.__compare_sync:1 of msgid "Compares an application command during the synchronization process." msgstr "" @@ -178,10 +173,6 @@ msgid "The \"pool\" or list of commands to compare from." msgstr "" #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.command @@ -204,6 +195,10 @@ msgid "" "conditions have been met in a chronological order:" msgstr "" +#: interactions.client.bot.Client._stop:1 of +msgid "Stops the websocket connection gracefully." +msgstr "" + #: interactions.client.bot.Client._login:1 of msgid "Makes a login with the Discord API." msgstr "" @@ -448,7 +443,7 @@ msgid "" msgstr "" #: interactions.client.bot.Client._find_command:3 of -msgid "The name of the command to match" +msgid "The name or ID of the command to match" msgstr "" #: interactions.client.bot.Client._find_command:5 of @@ -574,59 +569,34 @@ msgstr "" msgid "The modified User object" msgstr "" -#: interactions.client.bot.Client.__raw_socket_create:1 of -msgid "" -"This is an internal function that takes any gateway socket event and then" -" returns the data purely based off of what it does in the client " -"instantiation class." -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:5 of -msgid "The data that is returned" -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:7 of -msgid "A dictionary of raw data." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:1 of -msgid "" -"This is an internal function that caches the channel creates when " -"dispatched." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:3 of -msgid "The channel object data in question." +#: interactions.client.bot.Client.request_guild_members:1 of +msgid "Requests guild members via websocket." msgstr "" -#: interactions.client.bot.Client.__raw_channel_create:5 of -msgid "The channel as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:3 of +msgid "ID of the guild to get members for." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:1 of +#: interactions.client.bot.Client.request_guild_members:5 of msgid "" -"This is an internal function that caches the message creates when " -"dispatched." +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:3 of -msgid "The message object data in question." +#: interactions.client.bot.Client.request_guild_members:7 of +msgid "String that username starts with." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:5 of -msgid "The message as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:1 of -msgid "This is an internal function that caches the guild creates on ready." +#: interactions.client.bot.Client.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:3 of -msgid "The guild object data in question." -msgstr "" - -#: interactions.client.bot.Client.__raw_guild_create:5 of -msgid "The guild as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." msgstr "" #: interactions.client.bot.Extension:1 of @@ -639,3 +609,56 @@ msgstr "" #: interactions.client.bot.Extension:5 of msgid "The structure of an extension:" msgstr "" + +#~ msgid "Registers all raw gateway events to the known events." +#~ msgstr "" + +#~ msgid "The name of the command to match" +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "takes any gateway socket event and " +#~ "then returns the data purely based " +#~ "off of what it does in the " +#~ "client instantiation class." +#~ msgstr "" + +#~ msgid "The data that is returned" +#~ msgstr "" + +#~ msgid "A dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the channel creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The channel object data in question." +#~ msgstr "" + +#~ msgid "The channel as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the message creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The message object data in question." +#~ msgstr "" + +#~ msgid "The message as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "This is an internal function that caches the guild creates on ready." +#~ msgstr "" + +#~ msgid "The guild object data in question." +#~ msgstr "" + +#~ msgid "The guild as a dictionary of raw data." +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/context.po b/docs/locale/hi/LC_MESSAGES/context.po index 3917f5b73..8352a5d3e 100644 --- a/docs/locale/hi/LC_MESSAGES/context.po +++ b/docs/locale/hi/LC_MESSAGES/context.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../context.rst:4 msgid "Event Context" @@ -55,7 +55,6 @@ msgstr "" msgid "The guild data model." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update #: interactions.client.context.CommandContext #: interactions.client.context.CommandContext.defer #: interactions.client.context.CommandContext.edit @@ -63,12 +62,15 @@ msgstr "" #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context #: interactions.client.context._Context.edit +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup -#: interactions.client.context._Context.send of +#: interactions.client.context._Context.send +#: interactions.utils.attrs_utils.DictSerializerMixin.update of msgid "Parameters" msgstr "" @@ -79,11 +81,13 @@ msgstr "" #: interactions.client.context.CommandContext.edit #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.send of msgid "Returns" msgstr "" @@ -98,11 +102,13 @@ msgstr "" #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup #: interactions.client.context._Context.send of msgid "Return type" @@ -153,7 +159,7 @@ msgstr "" #: interactions.client.context.CommandContext.send:12 #: interactions.client.context.ComponentContext.send:12 #: interactions.client.context._Context.send:12 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.client.context.CommandContext.send:14 @@ -171,6 +177,12 @@ msgstr "" #: interactions.client.context.CommandContext.send:18 #: interactions.client.context.ComponentContext.send:18 #: interactions.client.context._Context.send:18 of +msgid "Whether embeds are not shown in the message." +msgstr "" + +#: interactions.client.context.CommandContext.send:20 +#: interactions.client.context.ComponentContext.send:20 +#: interactions.client.context._Context.send:20 of msgid "The sent message as an object." msgstr "" @@ -197,13 +209,39 @@ msgstr "" msgid "The components you wish to show." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:1 of +#: interactions.client.context._Context.has_permissions:1 of +msgid "" +"Returns whether the author of the interaction has the permissions in the " +"given context." +msgstr "" + +#: interactions.client.context._Context.has_permissions:3 of +msgid "The list of permissions" +msgstr "" + +#: interactions.client.context._Context.has_permissions:5 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.client.context._Context.has_permissions:7 of +msgid "Whether the author has the permissions" +msgstr "" + +#: ../../docstring interactions.client.context.CommandContext._extras:1 +#: interactions.client.context.ComponentContext._extras:1 +#: interactions.client.context._Context._extras:1 of +msgid "A dict containing values that were not serialized from Discord." +msgstr "" + +#: interactions.utils.attrs_utils.DictSerializerMixin.update:1 of msgid "" "Update an object with new attributes. All data will be converted, and any" " extra attributes will be put in _extras" msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:4 of +#: interactions.utils.attrs_utils.DictSerializerMixin.update:4 of msgid "The dictionary to update from" msgstr "" @@ -286,6 +324,18 @@ msgid "" " was sent from." msgstr "" +#: interactions.client.context.CommandContext:30 of +msgid "The client instance that the command belongs to." +msgstr "" + +#: interactions.client.context.CommandContext:31 of +msgid "The command object that is being invoked." +msgstr "" + +#: interactions.client.context.CommandContext:32 of +msgid "The extension the command belongs to." +msgstr "" + #: interactions.client.context.CommandContext.defer:1 of msgid "" "This \"defers\" an interaction response, allowing up to a 15-minute delay" @@ -342,3 +392,31 @@ msgstr "" #: interactions.client.context.ComponentContext.defer:6 of msgid "Whether you want to edit the original message or send a followup message" msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:1 of +msgid "Disables all components of the message." +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:3 of +msgid "" +"Whether the components should be disabled in an interaction response, " +"default True" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:5 of +msgid "" +"Additional keyword-arguments to pass to the edit method. This only works " +"when this method is used as interaction response and takes the same " +"arguments as :meth:`interactions.client.context._Context:edit()`" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:8 of +msgid "The modified Message" +msgstr "" + +#: interactions.client.context.ComponentContext.label:1 of +msgid "The label of the interacted button. :rtype: Optional[str]" +msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/events.po b/docs/locale/hi/LC_MESSAGES/events.po index b91a1dc02..7b4ecba7d 100644 --- a/docs/locale/hi/LC_MESSAGES/events.po +++ b/docs/locale/hi/LC_MESSAGES/events.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../events.rst:2 msgid "Event Documentation" @@ -98,99 +98,104 @@ msgid "``on_command``" msgstr "" #: ../../events.rst:57 -msgid "``on_component``" +msgid "``on_command_error``" msgstr "" #: ../../events.rst:58 -msgid "``on_autocomplete``" +msgid "``on_component``" msgstr "" #: ../../events.rst:59 +msgid "``on_autocomplete``" +msgstr "" + +#: ../../events.rst:60 msgid "``on_modal``" msgstr "" -#: ../../events.rst:61 +#: ../../events.rst:62 msgid "Lets now have a look at those events in detail:" msgstr "" -#: ../../events.rst:64 +#: ../../events.rst:65 msgid "Event: ``raw_socket_create``" msgstr "" -#: ../../events.rst:65 +#: ../../events.rst:66 msgid "" "This event fires on any event sent by Discord, including ``Typing Start``" " and ``Voice State Update``. ``Hello``, ``Resumed``, ``Reconnect`` and " "``Invalid Session`` still will not be dispatched." msgstr "" -#: ../../events.rst:68 +#: ../../events.rst:69 msgid "" -"The function handling the event should take in one argument, the type of " -"this argument is a ``dict``." +"A function handling an event should take two arguments, the first " +"argument is the name of the event, the second is the data of that event " +"with type ``dict``." msgstr "" -#: ../../events.rst:70 +#: ../../events.rst:72 msgid "" -"The value of the argument will be the *raw* data sent from Discord, so it" -" is not recommended to use that event as long as you don't absolutely " -"need it." +"The value of the second argument will be the *raw* data sent from " +"Discord, so it is not recommended to use that event as long as you don't " +"absolutely need it." msgstr "" -#: ../../events.rst:75 +#: ../../events.rst:77 msgid "Event: ``on_start``" msgstr "" -#: ../../events.rst:76 +#: ../../events.rst:78 msgid "This event fires only when the bot is started." msgstr "" -#: ../../events.rst:78 ../../events.rst:161 +#: ../../events.rst:80 ../../events.rst:173 msgid "This function takes no arguments." msgstr "" -#: ../../events.rst:81 +#: ../../events.rst:83 msgid "Unlike ``on_ready``, this event will never be dispatched more than once." msgstr "" -#: ../../events.rst:84 +#: ../../events.rst:86 msgid "Event: ``on_interaction``" msgstr "" -#: ../../events.rst:85 +#: ../../events.rst:87 msgid "" "This event fires on any interaction (commands, components, autocomplete " "and modals)." msgstr "" -#: ../../events.rst:87 +#: ../../events.rst:89 msgid "" "The function needs one argument. It will have the type ``CommandContext``" " or ``ComponentContext``." msgstr "" -#: ../../events.rst:89 +#: ../../events.rst:91 msgid "" "Because you will have to check for everything, from the " "``InteractionType`` to any data inside the context, we do not recommend " "using this event unless you have experience with it." msgstr "" -#: ../../events.rst:94 +#: ../../events.rst:96 msgid "Event: ``on_command``" msgstr "" -#: ../../events.rst:95 +#: ../../events.rst:97 msgid "" "This event fires on any Application Command (slash command + context menu" " command) used." msgstr "" -#: ../../events.rst:97 ../../events.rst:117 ../../events.rst:127 +#: ../../events.rst:99 ../../events.rst:129 ../../events.rst:139 msgid "The function takes in one argument of the type ``CommandContext``." msgstr "" -#: ../../events.rst:99 +#: ../../events.rst:101 msgid "" "Using this event, you will have to manually check everything, from name " "to whether the used commands have sub commands, options or anything else " @@ -198,138 +203,174 @@ msgid "" "it" msgstr "" -#: ../../events.rst:104 +#: ../../events.rst:106 +msgid "Event: ``on_command_error``" +msgstr "" + +#: ../../events.rst:107 +msgid "This event fires when the following conditions are met:" +msgstr "" + +#: ../../events.rst:109 +msgid "There is an error in the command (or subcommand within the command)" +msgstr "" + +#: ../../events.rst:110 +msgid "There is no error callback assigned to that command" +msgstr "" + +#: ../../events.rst:112 +msgid "" +"The function takes in two arguments, one of the type ``CommandContext``, " +"and the other contains the error." +msgstr "" + +#: ../../events.rst:116 msgid "Event: ``on_component``" msgstr "" -#: ../../events.rst:105 +#: ../../events.rst:117 msgid "" "This event fires on any Component used (for now, those are Buttons and " "Select Menus)." msgstr "" -#: ../../events.rst:107 +#: ../../events.rst:119 msgid "The function takes in one argument of the type ``ComponentContext``." msgstr "" -#: ../../events.rst:109 +#: ../../events.rst:121 msgid "" "Like ``on_command``, you will have to manually check for everything, i.e " "for custom id and component type. Also, you will have to look through the" " argument to find the selected choices, if you have a select menu." msgstr "" -#: ../../events.rst:114 +#: ../../events.rst:126 msgid "Event: ``on_autocomplete``" msgstr "" -#: ../../events.rst:115 +#: ../../events.rst:127 msgid "This event fires on any autocomplete triggered." msgstr "" -#: ../../events.rst:119 +#: ../../events.rst:131 msgid "" "As already in the events above, you will have to get the important values" " yourself. Those values are here the autocompleted option and the user " "input." msgstr "" -#: ../../events.rst:124 +#: ../../events.rst:136 msgid "Event: ``on_modal``" msgstr "" -#: ../../events.rst:125 +#: ../../events.rst:137 msgid "This event fires on every modal that is submitted." msgstr "" -#: ../../events.rst:129 +#: ../../events.rst:141 msgid "" "You will have to get all values yourself and check what modal was used " "when using this event." msgstr "" -#: ../../events.rst:132 +#: ../../events.rst:144 msgid "" "Additionally, if you struggle with getting the values, you can check " ":ref:`how it is handled internally `." msgstr "" -#: ../../events.rst:136 +#: ../../events.rst:148 msgid "After this, let us look at events from the Discord API." msgstr "" -#: ../../events.rst:139 +#: ../../events.rst:151 msgid "Discord API Events" msgstr "" -#: ../../events.rst:141 +#: ../../events.rst:153 msgid "" "Events in this section do not match the name needed to put into the " "function. Please check :ref:`above ` for how to get the correct name." msgstr "" -#: ../../events.rst:145 +#: ../../events.rst:157 msgid "" "There are a lot of events dispatched by the Discord API. All of those can" " be found `here`_." msgstr "" -#: ../../events.rst:147 +#: ../../events.rst:159 msgid "" "The events ``HELLO``, ``RESUMED``, ``RECONNECT``, ``INVALID SESSION`` and" " ``TYPING START`` are not dispatched by the library." msgstr "" -#: ../../events.rst:149 +#: ../../events.rst:161 msgid "" "``TYPING START`` will be included in the raw socket create event. You can" " also listen for it if you choose to subclass the WebSocketClient" msgstr "" -#: ../../events.rst:152 +#: ../../events.rst:164 msgid "" "The event ``VOICE STATE UPDATE`` can be only received with the voice " ":ref:`Extension `." msgstr "" -#: ../../events.rst:155 +#: ../../events.rst:167 msgid "Let's now have a look at a few events:" msgstr "" -#: ../../events.rst:158 +#: ../../events.rst:170 msgid "Event: ``READY``" msgstr "" -#: ../../events.rst:159 +#: ../../events.rst:171 msgid "" "This event fires whenever ``READY`` is dispatched by Discord. This " "happens when connecting to the web socket server." msgstr "" -#: ../../events.rst:164 +#: ../../events.rst:176 msgid "" "Due to the bot reconnecting during runtime, ``on_ready`` will be " "dispatched multiple times. If you rely on ``on_ready`` to do certain " "things once, check against a global variable as shown below:" msgstr "" -#: ../../events.rst:181 +#: ../../events.rst:193 msgid "Events: ``GUILD MEMBER UPDATE`` and ``GUILD MEMBER ADD``" msgstr "" -#: ../../events.rst:182 +#: ../../events.rst:194 msgid "" "These events fire whenever a member joins a guild or a member of a guild " "gets modified." msgstr "" -#: ../../events.rst:184 +#: ../../events.rst:196 msgid "The function takes in one argument of the type ``GuildMember``." msgstr "" -#: ../../events.rst:186 +#: ../../events.rst:198 msgid "" "The argument has the same methods as a normal ``Member`` object, except " "the methods *do not take in a guild id*. Please keep that in mind when " "using this event." msgstr "" + +#~ msgid "" +#~ "The function handling the event should" +#~ " take in one argument, the type " +#~ "of this argument is a ``dict``." +#~ msgstr "" + +#~ msgid "" +#~ "The value of the argument will be" +#~ " the *raw* data sent from Discord," +#~ " so it is not recommended to " +#~ "use that event as long as you " +#~ "don't absolutely need it." +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/faq.po b/docs/locale/hi/LC_MESSAGES/faq.po index 1bf421161..09e3ae8c9 100644 --- a/docs/locale/hi/LC_MESSAGES/faq.po +++ b/docs/locale/hi/LC_MESSAGES/faq.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../faq.rst:2 msgid "Frequently Asked Questions" @@ -283,12 +283,12 @@ msgstr "" #: ../../faq.rst:157 msgid "" -"A `voice client`_ - which is still WIP, but it is able to listen for the " +"`voice client`_ - which is still WIP, but it is able to listen for the " "``VOICE_STATE_UPDATE`` event." msgstr "" #: ../../faq.rst:158 -msgid "An `autosharder`_ for automatic sharding" +msgid "`autosharder`_ for automatic sharding" msgstr "" #: ../../faq.rst:159 @@ -310,146 +310,148 @@ msgid "`enhanced`_ which enhances the DX in general" msgstr "" #: ../../faq.rst:163 -msgid "A `paginator`_ for paginating embeds on messages using components" +msgid "`paginator`_ for paginating embeds on messages using components" msgstr "" #: ../../faq.rst:164 msgid "" -"`persistence`_ - for storing data inside your custom IDs (as an " -"alternative to ``wait_for``)" +"`persistence`_ for storing data inside your custom IDs (as an alternative" +" to ``wait_for``)" msgstr "" #: ../../faq.rst:165 -msgid "And a `boilerplate`_" +msgid "`lavalink`_ for voice sending and listening ``VOICE_STATE_UPDATE`` event" +msgstr "" + +#: ../../faq.rst:166 +msgid "`fastapi`_ for building own API" msgstr "" #: ../../faq.rst:167 +msgid "And a `boilerplate`_" +msgstr "" + +#: ../../faq.rst:169 msgid "" "Below are a few unofficial exts (for the time being) which implement some" " functionality similar to what d.py had:" msgstr "" -#: ../../faq.rst:169 +#: ../../faq.rst:171 msgid "`checks and cooldowns`_" msgstr "" -#: ../../faq.rst:170 +#: ../../faq.rst:172 msgid "`tasks`_" msgstr "" -#: ../../faq.rst:171 -msgid "" -"`get`_ for getting objects from the discord API (will be implemented into" -" the core library at a later time)" -msgstr "" - -#: ../../faq.rst:173 +#: ../../faq.rst:174 msgid "Usage examples can usually be found at the linked page" msgstr "" -#: ../../faq.rst:177 +#: ../../faq.rst:178 msgid "Can I make an Extension Library myself?" msgstr "" -#: ../../faq.rst:178 +#: ../../faq.rst:179 msgid "" "Yeah, you can! We have a special channel reserved for the development of " "external libraries! You can also read `this `_ for more information." msgstr "" -#: ../../faq.rst:183 +#: ../../faq.rst:184 msgid "" "I'm getting \"``AttributeError: HTTPClient not found!``\" when I try to " "execute helper methods!" msgstr "" -#: ../../faq.rst:184 +#: ../../faq.rst:185 msgid "Probably you are doing something like this:" msgstr "" -#: ../../faq.rst:191 +#: ../../faq.rst:192 msgid "" "And the error occurs in the line where you try to send something. You can" " fix this easy by adding one argument:" msgstr "" -#: ../../faq.rst:198 +#: ../../faq.rst:199 msgid "" "You have to add this extra argument for every object you instantiate by " "yourself if you want to use it's methods" msgstr "" -#: ../../faq.rst:202 +#: ../../faq.rst:203 msgid "" "Context and Messages don't have the ``Channel`` and ``Guild`` attributes!" " Why?" msgstr "" -#: ../../faq.rst:203 +#: ../../faq.rst:204 msgid "" "At the moment the Discord API does *not* include them into their " "responses. You can get those object via the ``get_channel()`` and " "``get_guild()`` methods of the Context and Message model." msgstr "" -#: ../../faq.rst:208 +#: ../../faq.rst:209 msgid "\"``ctx.send got an unexpected keyword argument: files``\"! Why?" msgstr "" -#: ../../faq.rst:209 +#: ../../faq.rst:210 msgid "" "It is not supported due to an decision of the core developer team. There " "are two ways to do it:" msgstr "" -#: ../../faq.rst:212 +#: ../../faq.rst:213 msgid "Using ``await channel.send`` instead" msgstr "" -#: ../../faq.rst:213 +#: ../../faq.rst:214 msgid "Using the `files`_ extension" msgstr "" -#: ../../faq.rst:217 +#: ../../faq.rst:218 msgid "\"``ctx.send got an unexpected keyword argument: embed``\"! Why?" msgstr "" -#: ../../faq.rst:218 +#: ../../faq.rst:219 msgid "" "This is quite simple: The argument ``embed`` got deprecated by Discord. " "The new naming is ``embeds``." msgstr "" -#: ../../faq.rst:222 +#: ../../faq.rst:223 msgid "How can I check what exception happened during a request?" msgstr "" -#: ../../faq.rst:223 +#: ../../faq.rst:224 msgid "We, unlike d.py, do not offer something like ``interactions.NotFound``." msgstr "" -#: ../../faq.rst:225 +#: ../../faq.rst:226 msgid "Instead you have to do it like this:" msgstr "" -#: ../../faq.rst:228 +#: ../../faq.rst:229 msgid "" "This feature will be implemented with version 4.3 and is currently only " "available on beta/unstable" msgstr "" -#: ../../faq.rst:242 +#: ../../faq.rst:243 msgid "" "You can additionally get the exact reason for why the exception occurred " "with ``e.message`` or ``e.lookup(e.code)``" msgstr "" -#: ../../faq.rst:246 +#: ../../faq.rst:247 msgid "My message content is always empty! How can I fix this?" msgstr "" -#: ../../faq.rst:247 +#: ../../faq.rst:248 msgid "" "This happens because you did not enable the intent for message content. " "Enable it on the developer portal and add it into the ``Client`` " @@ -459,11 +461,11 @@ msgid "" "``Intents.DEFAULT``, it can be any other intent(s) you need!" msgstr "" -#: ../../faq.rst:254 +#: ../../faq.rst:255 msgid "Is there something like ``Cogs``?" msgstr "" -#: ../../faq.rst:255 +#: ../../faq.rst:256 msgid "" "Yes! Although, we call them ``Extensions``. Yeah, like :ref:`Extension " "Libraries `. This is because an extension " @@ -471,39 +473,39 @@ msgid "" "how you create an extension for yourself:" msgstr "" -#: ../../faq.rst:283 +#: ../../faq.rst:284 msgid "It's nothing more than that." msgstr "" -#: ../../faq.rst:285 +#: ../../faq.rst:286 msgid "" "Since ``@bot.X`` decorators don't work in extensions, you have to use " "these:" msgstr "" -#: ../../faq.rst:287 +#: ../../faq.rst:288 msgid "For event listeners, use ``@interactions.extension_listener``" msgstr "" -#: ../../faq.rst:288 +#: ../../faq.rst:289 msgid "For component listeners, use ``@interactions.extension_component``" msgstr "" -#: ../../faq.rst:289 +#: ../../faq.rst:290 msgid "For modal listeners, use ``@interactions.extension_modal``" msgstr "" -#: ../../faq.rst:290 +#: ../../faq.rst:291 msgid "For autocomplete listeners, use ``@interactions.extension_autocomplete``" msgstr "" -#: ../../faq.rst:294 +#: ../../faq.rst:295 msgid "" "``channel.members`` does not exist, how do I get the people in a voice " "channel?" msgstr "" -#: ../../faq.rst:295 +#: ../../faq.rst:296 msgid "" "``channel.members`` actually does exist, but is reserved for threads. " "There is no attribute for people in a voice channel by the API. The only " @@ -512,12 +514,37 @@ msgid "" " updated when a member joins or leaves." msgstr "" -#: ../../faq.rst:301 +#: ../../faq.rst:302 msgid "My question is not answered on here!" msgstr "" -#: ../../faq.rst:302 +#: ../../faq.rst:303 msgid "" "Please join our `Discord Server`_ for any further support regarding our " "library and/or any integration code depending on it." msgstr "" + +#~ msgid "" +#~ "A `voice client`_ - which is still" +#~ " WIP, but it is able to listen" +#~ " for the ``VOICE_STATE_UPDATE`` event." +#~ msgstr "" + +#~ msgid "An `autosharder`_ for automatic sharding" +#~ msgstr "" + +#~ msgid "A `paginator`_ for paginating embeds on messages using components" +#~ msgstr "" + +#~ msgid "" +#~ "`persistence`_ - for storing data inside" +#~ " your custom IDs (as an alternative" +#~ " to ``wait_for``)" +#~ msgstr "" + +#~ msgid "" +#~ "`get`_ for getting objects from the " +#~ "discord API (will be implemented into" +#~ " the core library at a later " +#~ "time)" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/index.po b/docs/locale/hi/LC_MESSAGES/index.po index 91465f9df..d7a1d6841 100644 --- a/docs/locale/hi/LC_MESSAGES/index.po +++ b/docs/locale/hi/LC_MESSAGES/index.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../index.rst:47 msgid "Pages:" @@ -51,7 +51,7 @@ msgstr "" #: ../../index.rst:11 msgid "" "Look no more! The goal of this library is to make all three of these " -"questions go from possibilites to trivial matters." +"questions go from possibilities to trivial matters." msgstr "" #: ../../index.rst:14 @@ -181,7 +181,7 @@ msgid "**black** ``22.6.0``" msgstr "" #: ../../index.rst:66 -msgid "**flake8** ``4.0.1``" +msgid "**flake8** ``5.0.4``" msgstr "" #: ../../index.rst:67 @@ -190,7 +190,7 @@ msgstr "" #: ../../index.rst:69 msgid "" -"**Sphinx** ``4.4.0``: all of our documentation is powered off of " +"**Sphinx** ``5.1.1``: all of our documentation is powered off of " "autogenerated documentation of the Sphinx engine." msgstr "" @@ -247,3 +247,20 @@ msgstr "" #: ../../index.rst:88 msgid ":ref:`modindex`" msgstr "" + +#~ msgid "" +#~ "Look no more! The goal of this " +#~ "library is to make all three of" +#~ " these questions go from possibilites " +#~ "to trivial matters." +#~ msgstr "" + +#~ msgid "**flake8** ``4.0.1``" +#~ msgstr "" + +#~ msgid "" +#~ "**Sphinx** ``4.4.0``: all of our " +#~ "documentation is powered off of " +#~ "autogenerated documentation of the Sphinx " +#~ "engine." +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/migration.po b/docs/locale/hi/LC_MESSAGES/migration.po index 9f0d8e6aa..3546c747d 100644 --- a/docs/locale/hi/LC_MESSAGES/migration.po +++ b/docs/locale/hi/LC_MESSAGES/migration.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../migration.rst:2 msgid "Migration" @@ -126,7 +126,9 @@ msgid "" msgstr "" #: ../../migration.rst:99 -msgid "You can get more information by reading the `get-documentation`_." +msgid "" +"You can get more information by reading the " +":meth:`interactions.client.get.get`-documentation" msgstr "" #: ../../migration.rst:102 @@ -148,3 +150,6 @@ msgid "" "your argument in your function differently than your option name! " "Example:" msgstr "" + +#~ msgid "You can get more information by reading the `get-documentation`_." +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/models.command.po b/docs/locale/hi/LC_MESSAGES/models.command.po index 5c72da5b0..a7fca335f 100644 --- a/docs/locale/hi/LC_MESSAGES/models.command.po +++ b/docs/locale/hi/LC_MESSAGES/models.command.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.command.rst:4 msgid "Application Command Models" @@ -37,8 +37,10 @@ msgid "The structure for a choice:" msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission of msgid "Variables" @@ -56,13 +58,14 @@ msgstr "" #: interactions.client.models.command.Command:16 #: interactions.client.models.command.Command.group:28 #: interactions.client.models.command.Command.subcommand:33 -#: interactions.client.models.command.Option:34 of +#: interactions.client.models.command.Option:36 of msgid "" "The dictionary of localization for the ``name`` field. This enforces the " "same restrictions as the ``name`` field." msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command #: interactions.client.models.command.Command.__call @@ -72,6 +75,7 @@ msgstr "" #: interactions.client.models.command.Command.error #: interactions.client.models.command.Command.group #: interactions.client.models.command.Command.subcommand +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission #: interactions.client.models.command.option of @@ -100,8 +104,7 @@ msgstr "" msgid "The type of option." msgstr "" -#: interactions.client.models.command.Option:23 -#: interactions.client.models.command.option:14 of +#: interactions.client.models.command.Option:23 of msgid "The name of the option." msgstr "" @@ -142,19 +145,27 @@ msgid "The maximum value supported by the option." msgstr "" #: interactions.client.models.command.Option:33 of +msgid "The minimum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:34 of +msgid "The maximum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:35 of msgid "A status denoting whether this option is an autocomplete option." msgstr "" #: interactions.client.models.command.Command:17 #: interactions.client.models.command.Command.group:30 #: interactions.client.models.command.Command.subcommand:35 -#: interactions.client.models.command.Option:35 of +#: interactions.client.models.command.Option:37 of msgid "" "The dictionary of localization for the ``description`` field. This " "enforces the same restrictions as the ``description`` field." msgstr "" -#: interactions.client.models.command.Option:36 of +#: interactions.client.models.command.Option:38 of msgid "How the option value is passed to the function, if different than ``name``" msgstr "" @@ -248,18 +259,26 @@ msgid "A decorator for adding options to a command." msgstr "" #: interactions.client.models.command.option:3 of -msgid "The structure of an option:" +msgid "" +"The ``type`` and ``name`` of the option are defaulted to the parameter's " +"typehint and name." +msgstr "" + +#: interactions.client.models.command.option:5 of +msgid "" +"When the ``name`` of the option differs from the parameter name, the " +"``converter`` field will default to the name of the parameter." msgstr "" -#: interactions.client.models.command.option:12 of -msgid "The type of the option." +#: interactions.client.models.command.option:8 of +msgid "The structure of an option:" msgstr "" -#: interactions.client.models.command.option:16 of -msgid "The description of the option. Defaults to ``\"No description set\"``." +#: interactions.client.models.command.option:17 of +msgid "The description of the option. Defaults to \"No description set\"." msgstr "" -#: interactions.client.models.command.option:18 of +#: interactions.client.models.command.option:19 of msgid "The keyword arguments of the option, same as :class:`Option`." msgstr "" @@ -283,6 +302,8 @@ msgstr "" msgid "A class that when returned from a command, the command chain is stopped." msgstr "" +#: interactions.client.models.command.BaseResult:3 +#: interactions.client.models.command.GroupResult:3 #: interactions.client.models.command.StopCommand:3 of msgid "Usage:" msgstr "" @@ -291,6 +312,32 @@ msgstr "" msgid "This allows for custom checks that allow stopping the command chain." msgstr "" +#: interactions.client.models.command.BaseResult:1 +#: interactions.client.models.command.GroupResult:1 of +msgid "A class object representing the result of the base command." +msgstr "" + +#: interactions.client.models.command.BaseResult:17 of +msgid "" +"If the subcommand coroutine does not have enough parameters, the " +"``BaseResult`` will not be passed." +msgstr "" + +#: interactions.client.models.command.BaseResult:19 +#: interactions.client.models.command.GroupResult:25 of +msgid "The result of the base command." +msgstr "" + +#: interactions.client.models.command.GroupResult:23 of +msgid "" +"If the subcommand does not have enough arguments, the ``GroupResult`` " +"will not be passed." +msgstr "" + +#: interactions.client.models.command.GroupResult:26 of +msgid "The parent ``BaseResult``." +msgstr "" + #: interactions.client.models.command.Command:1 of msgid "A class object representing a command." msgstr "" @@ -364,6 +411,14 @@ msgstr "" msgid "The extension that the command belongs to, if any." msgstr "" +#: interactions.client.models.command.Command:26 of +msgid "The client that the command belongs to." +msgstr "" + +#: interactions.client.models.command.Command:27 of +msgid "The listener, used for dispatching command errors." +msgstr "" + #: interactions.client.models.command.Command.converters:1 of msgid "" "Returns a dictionary with all converters added to the options of the " @@ -525,3 +580,9 @@ msgid "" ":class:`interactions.client.bot.Extension` is passed to the coroutine, if" " any." msgstr "" + +#~ msgid "The type of the option." +#~ msgstr "" + +#~ msgid "The description of the option. Defaults to ``\"No description set\"``." +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/models.component.po b/docs/locale/hi/LC_MESSAGES/models.component.po index ae186054c..ce3834826 100644 --- a/docs/locale/hi/LC_MESSAGES/models.component.po +++ b/docs/locale/hi/LC_MESSAGES/models.component.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.component.rst:4 msgid "Component Models" @@ -257,36 +257,18 @@ msgid "The maximum length of the input." msgstr "" #: interactions.client.models.component.Modal:1 of -msgid "A class object representing a modal." +msgid "A class object representing a modal. The structure for a modal: ::" msgstr "" -#: interactions.client.models.component.Modal:8 of -msgid "The structure for a modal: ::" -msgstr "" - -#: interactions.client.models.component.Modal:6 of -msgid "interactions.Modal(" -msgstr "" - -#: interactions.client.models.component.Modal:5 of -msgid "" -"title=\"Application Form\", custom_id=\"mod_app_form\", " -"components=[interactions.TextInput(...)]," -msgstr "" - -#: interactions.client.models.component.Modal:8 of -msgid ")" -msgstr "" - -#: interactions.client.models.component.Modal:10 of +#: interactions.client.models.component.Modal:9 of msgid "The custom ID of the modal." msgstr "" -#: interactions.client.models.component.Modal:11 of +#: interactions.client.models.component.Modal:10 of msgid "The title of the modal." msgstr "" -#: interactions.client.models.component.Modal:12 of +#: interactions.client.models.component.Modal:11 of msgid "The components of the modal." msgstr "" @@ -302,22 +284,22 @@ msgid "" " also support only 1 text input component only." msgstr "" -#: interactions.client.models.component.ActionRow:13 of -msgid "The structure for an action row: ::" +#: interactions.client.models.component.ActionRow:8 of +msgid "The structure for an action row: ..code-block:: python" msgstr "" -#: interactions.client.models.component.ActionRow:9 of +#: interactions.client.models.component.ActionRow:10 of msgid "" "# \"...\" represents a component object. # Method 1: " "interactions.ActionRow(...) # Method 2: " "interactions.ActionRow(components=[...])" msgstr "" -#: interactions.client.models.component.ActionRow:15 of +#: interactions.client.models.component.ActionRow:16 of msgid "The type of component. Always defaults to ``1``." msgstr "" -#: interactions.client.models.component.ActionRow:16 of +#: interactions.client.models.component.ActionRow:17 of msgid "A list of components the ActionRow has, if any." msgstr "" @@ -340,3 +322,23 @@ msgstr "" #: interactions.client.models.component.ActionRow.new of msgid "Return type" msgstr "" + +#~ msgid "A class object representing a modal." +#~ msgstr "" + +#~ msgid "The structure for a modal: ::" +#~ msgstr "" + +#~ msgid "interactions.Modal(" +#~ msgstr "" + +#~ msgid "" +#~ "title=\"Application Form\", custom_id=\"mod_app_form\"," +#~ " components=[interactions.TextInput(...)]," +#~ msgstr "" + +#~ msgid ")" +#~ msgstr "" + +#~ msgid "The structure for an action row: ::" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/models.misc.po b/docs/locale/hi/LC_MESSAGES/models.misc.po index 9ea8f4346..31ef0b3e5 100644 --- a/docs/locale/hi/LC_MESSAGES/models.misc.po +++ b/docs/locale/hi/LC_MESSAGES/models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.misc.rst:4 msgid "Miscellaneous Models" @@ -56,12 +56,6 @@ msgstr "" msgid "The resolved attachments data." msgstr "" -#: interactions.client.models.misc.Interaction -#: interactions.client.models.misc.InteractionData -#: interactions.client.models.misc.InteractionResolvedData of -msgid "Parameters" -msgstr "" - #: interactions.client.models.misc.InteractionData:1 of msgid "A class object representing the data of an interaction." msgstr "" @@ -102,6 +96,10 @@ msgstr "" msgid "The targeted ID of the interaction." msgstr "" +#: interactions.client.models.misc.InteractionData:12 of +msgid "Array of Action Rows in modal." +msgstr "" + #: interactions.client.models.misc.Interaction:1 of msgid "A class object representing an interaction." msgstr "" @@ -149,3 +147,6 @@ msgstr "" #: interactions.client.models.misc.Interaction:13 of msgid "The message of the interaction." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/quickstart.po b/docs/locale/hi/LC_MESSAGES/quickstart.po index 89ed78f26..76b3670dc 100644 --- a/docs/locale/hi/LC_MESSAGES/quickstart.po +++ b/docs/locale/hi/LC_MESSAGES/quickstart.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:08-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../quickstart.rst:2 msgid "Quickstart" @@ -28,10 +28,11 @@ msgstr "" #: ../../quickstart.rst:7 msgid "" -"**discord-interactions** is a :ref:`Python library ` for the Discord Application Programming Interface. (API) A" -" library in Python has to be installed through the `pip` file. Run this " -"in your terminal/command line in order to install our library:" +"**discord-interactions** is a :ref:`Python library " +"` for the Discord Application Programming " +"Interface. (API) A library in Python has to be installed through the " +"`pip` file. Run this in your terminal/command line in order to install " +"our library:" msgstr "" #: ../../quickstart.rst:11 @@ -308,109 +309,116 @@ msgid "" msgstr "" #: ../../quickstart.rst:208 -msgid "" -"The first field in the ``@option()`` decorator is the type of the option." -" This is positional only and required. You can use integers, the default " -"Python types, the ``OptionType`` enum, or supported objects such as " -"``interactions.Channel``." +msgid "All arguments in the decorator are keyword arguments only." msgstr "" #: ../../quickstart.rst:209 -msgid "All other arguments in the decorator are keyword arguments only." +msgid "" +"The ``type`` and ``name`` fields default to the typehint and the name of " +"the parameter." msgstr "" #: ../../quickstart.rst:210 -msgid "The ``name`` field is required." +msgid "" +"The ``description`` field is optional and defaults to ``\"No description " +"set``." msgstr "" #: ../../quickstart.rst:211 msgid "" -"The ``description`` field is optional and defaults to ``\"No description " -"set``." +"The ``required`` field defaults to whether the default for the parameter " +"is empty." msgstr "" #: ../../quickstart.rst:212 msgid "" +"For typehinting or inputting the ``type`` field, you can use integers, " +"the default Python types, the ``OptionType`` enum, or supported objects " +"such as ``interactions.Channel``." +msgstr "" + +#: ../../quickstart.rst:213 +msgid "" "Any parameters from ``Option`` can be passed into the ``@option()`` " "decorator." msgstr "" -#: ../../quickstart.rst:215 +#: ../../quickstart.rst:216 msgid "The limit for options per command is 25." msgstr "" -#: ../../quickstart.rst:218 +#: ../../quickstart.rst:219 msgid "Nested commands: subcommands" msgstr "" -#: ../../quickstart.rst:220 +#: ../../quickstart.rst:221 msgid "" "Subcommands are options that are nested to create subcategories of " "commands." msgstr "" -#: ../../quickstart.rst:222 +#: ../../quickstart.rst:223 msgid "Here is the structure of a subcommand:" msgstr "" -#: ../../quickstart.rst:265 +#: ../../quickstart.rst:266 msgid "You can also create subcommands using the command system:" msgstr "" -#: ../../quickstart.rst:291 +#: ../../quickstart.rst:292 msgid "You can add a SUB_COMMAND_GROUP in between the base and command." msgstr "" -#: ../../quickstart.rst:294 +#: ../../quickstart.rst:295 msgid "Additional information about subcommands" msgstr "" -#: ../../quickstart.rst:296 +#: ../../quickstart.rst:297 msgid "" "Base commands are returned the :ref:`Command ` object. From this, you can utilize the following " "decorators:" msgstr "" -#: ../../quickstart.rst:299 +#: ../../quickstart.rst:300 msgid "" ":ref:`@subcommand() `: creates" " a subcommand." msgstr "" -#: ../../quickstart.rst:300 +#: ../../quickstart.rst:301 msgid "" ":ref:`@group() `: creates a " "group." msgstr "" -#: ../../quickstart.rst:301 +#: ../../quickstart.rst:302 msgid "" ":ref:`@error `: registers an " "error callback." msgstr "" -#: ../../quickstart.rst:303 +#: ../../quickstart.rst:304 msgid "Check the documentation for the parameters of each of these decorators." msgstr "" -#: ../../quickstart.rst:305 +#: ../../quickstart.rst:306 msgid "The following is an example of a base command:" msgstr "" -#: ../../quickstart.rst:313 +#: ../../quickstart.rst:314 msgid "The examples below will be using the base command above." msgstr "" -#: ../../quickstart.rst:315 +#: ../../quickstart.rst:316 msgid "The following is an example of a subcommand of the base command:" msgstr "" -#: ../../quickstart.rst:323 +#: ../../quickstart.rst:324 msgid "This code results in the following subcommand: `/base_command subcommand`." msgstr "" -#: ../../quickstart.rst:326 +#: ../../quickstart.rst:327 msgid "" "You can use the ``base_res`` parameter in groups and subcommands, and " "``group_res`` in subcommands inside groups to access the result of the " @@ -418,50 +426,50 @@ msgid "" "``ctx`` parameter." msgstr "" -#: ../../quickstart.rst:329 +#: ../../quickstart.rst:330 msgid "The following is an example of a group with subcommands:" msgstr "" -#: ../../quickstart.rst:341 +#: ../../quickstart.rst:342 msgid "" "You can have multiple groups, with multiple subcommands in each group. " "Subcommands and groups are options, so the same restrictions apply." msgstr "" -#: ../../quickstart.rst:344 +#: ../../quickstart.rst:345 msgid "Create any subcommands without groups *before* creating any groups." msgstr "" -#: ../../quickstart.rst:346 +#: ../../quickstart.rst:347 msgid "" "Since there are multiple coroutines involved that each get executed, you " "may be wondering how you can stop the chain. Luckily, there is a way:" msgstr "" -#: ../../quickstart.rst:360 +#: ../../quickstart.rst:361 msgid "This works on both groups and subcommands." msgstr "" -#: ../../quickstart.rst:362 +#: ../../quickstart.rst:363 msgid "The following is an example of an error callback:" msgstr "" -#: ../../quickstart.rst:378 +#: ../../quickstart.rst:379 msgid "" "The parameters ``ctx`` and ``error`` are required, but you can have more " "parameters, such as ``*args`` and ``**kwargs``, if you need to access " "options." msgstr "" -#: ../../quickstart.rst:382 +#: ../../quickstart.rst:383 msgid "You can have one error callback per command." msgstr "" -#: ../../quickstart.rst:385 +#: ../../quickstart.rst:386 msgid "Special type of commands: Context menus" msgstr "" -#: ../../quickstart.rst:387 +#: ../../quickstart.rst:388 msgid "" "While, granted that application commands are way more intuitive and " "easier to work with as both a bot developer and user from a UX approach, " @@ -472,39 +480,39 @@ msgid "" " right-click actions with menial effort." msgstr "" -#: ../../quickstart.rst:393 +#: ../../quickstart.rst:394 msgid "" "In order to create a menu-based command, all you need to do is simply add" " this one line into your ``@command`` decorator:" msgstr "" -#: ../../quickstart.rst:406 +#: ../../quickstart.rst:407 msgid "Here is an alternate way of creating a context menu:" msgstr "" -#: ../../quickstart.rst:415 +#: ../../quickstart.rst:416 msgid "" "The structure of a menu command differs significantly from that of a " "regular one:" msgstr "" -#: ../../quickstart.rst:417 +#: ../../quickstart.rst:418 msgid "You cannot have any options or choices." msgstr "" -#: ../../quickstart.rst:418 +#: ../../quickstart.rst:419 msgid "You cannot have a description." msgstr "" -#: ../../quickstart.rst:419 +#: ../../quickstart.rst:420 msgid "The ``name`` filter follows a different regex pattern." msgstr "" -#: ../../quickstart.rst:422 +#: ../../quickstart.rst:423 msgid "Creating and sending Components" msgstr "" -#: ../../quickstart.rst:424 +#: ../../quickstart.rst:425 msgid "" "Being able to run your own commands is very useful for a lot of " "automation-related purposes as a bot developer, however, we also have " @@ -513,14 +521,14 @@ msgid "" "components." msgstr "" -#: ../../quickstart.rst:429 +#: ../../quickstart.rst:430 msgid "" "Components are ways of being able to select pre-defined data, or define " "your own. They're very simple but quite powerful when put into practice " "This code block below shows a simplified implementation of a component:" msgstr "" -#: ../../quickstart.rst:455 +#: ../../quickstart.rst:456 msgid "" "This is a design that we ended up choosing to simplify responding to " "buttons when someone presses on one, and to allow bot developers to plug " @@ -530,11 +538,11 @@ msgid "" "modularity." msgstr "" -#: ../../quickstart.rst:462 +#: ../../quickstart.rst:463 msgid "What kinds of components are there?" msgstr "" -#: ../../quickstart.rst:464 +#: ../../quickstart.rst:465 msgid "" "As a bot developer, this may be fairly important for you to want to know." " Different components provide difference user experiences, interactions " @@ -543,18 +551,18 @@ msgid "" "able to `find these component types`_ here." msgstr "" -#: ../../quickstart.rst:471 +#: ../../quickstart.rst:472 msgid "How do I send components in a row?" msgstr "" -#: ../../quickstart.rst:473 +#: ../../quickstart.rst:474 msgid "" "You are also able to organize these components into rows, which are " "defined as ``ActionRow``'s. It is worth noting that you can have only a " "maximum of 5 per message that you send. This code block below shows how:" msgstr "" -#: ../../quickstart.rst:505 +#: ../../quickstart.rst:506 msgid "" "By default, the ``components`` keyword-argument field in the context " "sending method will always support ``ActionRow``-less sending: you only " @@ -563,57 +571,57 @@ msgid "" "class objects instead." msgstr "" -#: ../../quickstart.rst:511 +#: ../../quickstart.rst:512 msgid "" "You cannot use ``TextInput`` with the above shown method. Look :ref:`here" " ` how to create and send them." msgstr "" -#: ../../quickstart.rst:516 +#: ../../quickstart.rst:517 msgid "Creating a TextInput" msgstr "" -#: ../../quickstart.rst:517 +#: ../../quickstart.rst:518 msgid "You want to get a Text from a user? You can use ``TextInput`` for that." msgstr "" -#: ../../quickstart.rst:529 +#: ../../quickstart.rst:530 msgid "" "But how to send it? You can't use ``ctx.send`` for it. Take a look at " ":ref:`Modals ` for that." msgstr "" -#: ../../quickstart.rst:533 +#: ../../quickstart.rst:534 msgid "Modals" msgstr "" -#: ../../quickstart.rst:534 +#: ../../quickstart.rst:535 msgid "" "Modals are a new way to interact with a user. Currently only a " "``TextInput`` component is supported. You can have up to five " "``TextInput`` in a Modal." msgstr "" -#: ../../quickstart.rst:547 +#: ../../quickstart.rst:548 msgid "with the ``TextInput`` example from above we get:" msgstr "" -#: ../../quickstart.rst:552 +#: ../../quickstart.rst:553 msgid "Responding to a Modal interaction" msgstr "" -#: ../../quickstart.rst:560 +#: ../../quickstart.rst:561 msgid "" "You can respond to a modal the same way as you would respond to a normal " "``chat-input`` command, except your function has an extra argument for " "the text what was put into the modal." msgstr "" -#: ../../quickstart.rst:563 +#: ../../quickstart.rst:564 msgid "Adding v2 Permissions" msgstr "" -#: ../../quickstart.rst:565 +#: ../../quickstart.rst:566 msgid "" "v2 permissions consist of the ``default_member_permissions`` and " "``dm_permission`` keyword arguments. Similar to adding privileged " @@ -621,55 +629,87 @@ msgid "" "etc.) as follows:" msgstr "" -#: ../../quickstart.rst:604 +#: ../../quickstart.rst:605 msgid "" "Adding guild-only commands is easier as the only thing it takes is a " "boolean. Here's an example of a guild-only command:" msgstr "" -#: ../../quickstart.rst:623 +#: ../../quickstart.rst:624 msgid "" "Likewise, setting ``dm_permission`` to ``True`` makes it usable in DMs. " "Just to note that this argument's mainly used for global commands. Guild " "commands with this argument will have no effect." msgstr "" -#: ../../quickstart.rst:627 +#: ../../quickstart.rst:628 msgid "Utilities" msgstr "" -#: ../../quickstart.rst:629 +#: ../../quickstart.rst:630 msgid "You can use the following utilities to help you with your commands:" msgstr "" -#: ../../quickstart.rst:631 +#: ../../quickstart.rst:632 msgid "``ActionRow.new()``: Creates a new ``ActionRow`` object." msgstr "" -#: ../../quickstart.rst:632 +#: ../../quickstart.rst:633 msgid "``spread_to_rows()``: Spreads a list of components into a list of rows." msgstr "" -#: ../../quickstart.rst:633 +#: ../../quickstart.rst:634 msgid "" "``@autodefer()``: Automatically defers a command if it did not respond " "within the specified time." msgstr "" -#: ../../quickstart.rst:635 +#: ../../quickstart.rst:636 msgid "" -"Look at their documentation :ref:`here ` for " -"more information." +"Look at their documentation :ref:`here ` for more " +"information." msgstr "" -#: ../../quickstart.rst:637 +#: ../../quickstart.rst:638 msgid "Usage of ``ActionRow.new()``:" msgstr "" -#: ../../quickstart.rst:653 +#: ../../quickstart.rst:654 msgid "Usage of ``spread_to_rows()``:" msgstr "" -#: ../../quickstart.rst:675 +#: ../../quickstart.rst:676 msgid "Usage of ``@autodefer()``:" msgstr "" + +#~ msgid "" +#~ "**discord-interactions** is a :ref:`Python " +#~ "library ` for the" +#~ " Discord Application Programming Interface. " +#~ "(API) A library in Python has to" +#~ " be installed through the `pip` file." +#~ " Run this in your terminal/command " +#~ "line in order to install our " +#~ "library:" +#~ msgstr "" + +#~ msgid "" +#~ "The first field in the ``@option()`` " +#~ "decorator is the type of the " +#~ "option. This is positional only and " +#~ "required. You can use integers, the " +#~ "default Python types, the ``OptionType`` " +#~ "enum, or supported objects such as " +#~ "``interactions.Channel``." +#~ msgstr "" + +#~ msgid "All other arguments in the decorator are keyword arguments only." +#~ msgstr "" + +#~ msgid "The ``name`` field is required." +#~ msgstr "" + +#~ msgid "" +#~ "Look at their documentation :ref:`here " +#~ "` for more information." +#~ msgstr "" diff --git a/docs/locale/hi/LC_MESSAGES/utils.po b/docs/locale/hi/LC_MESSAGES/utils.po new file mode 100644 index 000000000..2968b6970 --- /dev/null +++ b/docs/locale/hi/LC_MESSAGES/utils.po @@ -0,0 +1,361 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../utils.rst:4 +msgid "The ``get`` utility method" +msgstr "" + +#: interactions.utils.get.get:1 of +msgid "Helper method to get an object." +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "This method can do the following:" +msgstr "" + +#: interactions.utils.get.get:6 of +msgid "Get a list of specific objects" +msgstr "" + +#: interactions.utils.get.get:5 interactions.utils.get.get:9 of +msgid "purely from cache" +msgstr "" + +#: interactions.utils.get.get:6 interactions.utils.get.get:10 of +msgid "purely from HTTP" +msgstr "" + +#: interactions.utils.get.get:7 of +msgid "" +"from cache and additionally from HTTP for every ID that was not found in " +"cache" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "Get a single specific object" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "from HTTP if not found in cache else from cache" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "The method has to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "You don't force anything" +msgstr "" + +#: interactions.utils.get.get:15 of +msgid "You force HTTP" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "The method doesn't have to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "You force cache" +msgstr "" + +#: interactions.utils.get.get:20 of +msgid "" +"Technically, there is no need for an ``await`` if there is an object " +"found in the cache. Because of the fact, that, as long as you don't " +"enforce the cache, the function will get the object from HTTP, if it is " +"not in the cache, you still have to await it. This has been done to " +"reduce confusion on whether the object origins from an HTTP call or a " +"cache result and to remove the extra step for you to check if the " +"returned object is an awaitable or not." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing:" +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing can be done via the ``force`` keyword argument." +msgstr "" + +#: interactions.utils.get.get:31 of +msgid "``force=\"cache\"`` or ``force=interactions.Force.CACHE``:" +msgstr "" + +#: interactions.utils.get.get:30 of +msgid "" +"This forces the method to only return from cache (if the object is not " +"found it will return ``None``). If you use this, you don't need to await " +"the method." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "``force=\"http\"`` or ``force=interactions.Force.HTTP``:" +msgstr "" + +#: interactions.utils.get.get:34 of +msgid "" +"This forces the method to make an HTTP request to the discord API and " +"return the result of it. If you use this, you have to await the method." +msgstr "" + +#: interactions.utils.get.get:38 of +msgid "" +"If you are a PyCharm user, please be aware of a bug that causes incorrect" +" suggestions to appear if using an enum. Even if PyCharm shows a normal " +"object as result, you have to await the method if you enforce HTTP. To " +"prevent this bug from happening it is suggested using ``force=\"http\"`` " +"instead of the enum." +msgstr "" + +#: interactions.utils.get.get:43 of +msgid "Getting an object:" +msgstr "" + +#: interactions.utils.get.get:45 of +msgid "" +"Here you will see two examples on how to get a single objects and the " +"variations of how the object can be gotten." +msgstr "" + +#: interactions.utils.get.get:48 of +msgid "Example 1/2: Getting a Channel:" +msgstr "" + +#: interactions.utils.get.get:65 of +msgid "Example 2/2: Getting a Member:" +msgstr "" + +#: interactions.utils.get.get:88 of +msgid "" +"Both examples should have given you a basic overview on how to get a " +"single object. Now we will move on with lists of objects." +msgstr "" + +#: interactions.utils.get.get:92 of +msgid "" +"The ``parent_id`` represents the channel or guild id that belongs to the " +"objects you want to get. It is called ``parent_id`` because " +"``guild_or_channel_id`` would be horrible to type out every time." +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "Getting a list of an object:" +msgstr "" + +#: interactions.utils.get.get:96 of +msgid "" +"Here you will see 1 example of how to get a list of objects. The " +"possibilities on how to force (and their results) are the same as in the " +"examples above." +msgstr "" + +#: interactions.utils.get.get:99 of +msgid "Example 1/1: Getting a list of members:" +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "" +"If you enforce cache when getting a list of objects, found objets will be" +" placed into the list and not found objects will be placed as ``None`` " +"into the list." +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Parameters" +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Return type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "An enumerable object representing the force types for the get method." +msgstr "" + +#: interactions.utils.get.Force of +msgid "Variables" +msgstr "" + +#: interactions.utils.get.Force:3 of +msgid "Enforce the usage of cache and block the usage of http" +msgstr "" + +#: interactions.utils.get.Force:4 of +msgid "Enforce the usage of http and block the usage of cache" +msgstr "" + +#: interactions.utils.get.Force of +msgid "Member Type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: ../../utils.rst:10 +msgid "Utilities" +msgstr "" + +#: interactions.utils.utils.autodefer:1 of +msgid "" +"A decorator that automatically defers a command if it did not respond " +"within ``delay`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:3 of +msgid "The structure of the decorator is:" +msgstr "" + +#: interactions.utils.utils.autodefer:13 of +msgid "" +"The amount of time in seconds to wait before defering the command. " +"Defaults to ``2`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:15 of +msgid "Whether the command is deferred ephemerally. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer:17 of +msgid "Whether the command is deferred on origin. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable of +msgid "Returns" +msgstr "" + +#: interactions.utils.utils.autodefer:19 of +msgid "The inner function, for decorating." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:1 of +msgid "A helper function that spreads components into :class:`ActionRow` s." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:3 of +msgid "Example:" +msgstr "" + +#: interactions.utils.utils.spread_to_rows:24 of +msgid "" +"You can only pass in :class:`ActionRow`s, :class:`Button`s, and " +":class:`SelectMenu`s, but in any order." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:26 of +msgid "The components to spread." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:28 of +msgid "The maximum number of components in a single row. Defaults to ``5``." +msgstr "" + +#: interactions.utils.utils.search_iterable:1 of +msgid "" +"Searches through an iterable for items that: - Are True for the check, if" +" one is given - Have attributes that match the keyword arguments (e.x. " +"passing `id=your_id` will only return objects with that id)" +msgstr "" + +#: interactions.utils.utils.search_iterable:5 of +msgid "The iterable to search through" +msgstr "" + +#: interactions.utils.utils.search_iterable:7 of +msgid "The check that items will be checked against" +msgstr "" + +#: interactions.utils.utils.search_iterable:9 of +msgid "Any attributes the items should have" +msgstr "" + +#: interactions.utils.utils.search_iterable:11 of +msgid "All items that match the check and keywords" +msgstr "" + +#: interactions.utils.utils.disable_components:1 of +msgid "Disables the given components." +msgstr "" + +#: interactions.utils.utils.disable_components:3 of +msgid "The components to disable" +msgstr "" + +#: interactions.utils.utils.get_channel_history:1 of +msgid "Gets the history of a channel." +msgstr "" + +#: interactions.utils.utils.get_channel_history:3 of +msgid "The HTTPClient of the bot or your bot instance" +msgstr "" + +#: interactions.utils.utils.get_channel_history:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:7 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:9 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.utils.utils.get_channel_history:11 of +msgid "A check to ignore specific messages" +msgstr "" + +#: interactions.utils.utils.get_channel_history:13 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.utils.utils.get_channel_history:16 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.dispatch.po b/docs/locale/it/LC_MESSAGES/api.dispatch.po index 2b020e27a..18a4ff864 100644 --- a/docs/locale/it/LC_MESSAGES/api.dispatch.po +++ b/docs/locale/it/LC_MESSAGES/api.dispatch.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.dispatch.rst:4 msgid "Dispatching" @@ -38,12 +38,6 @@ msgstr "" msgid "A list of events being dispatched." msgstr "" -#: interactions.api.dispatch.Listener -#: interactions.api.dispatch.Listener.dispatch -#: interactions.api.dispatch.Listener.register of -msgid "Return type" -msgstr "" - #: interactions.api.dispatch.Listener.dispatch:1 of msgid "Dispatches an event given out by the gateway." msgstr "" @@ -83,3 +77,6 @@ msgstr "" #: interactions.api.dispatch.Listener.register:9 of msgid "The name to associate the coroutine with. Defaults to None." msgstr "" + +#~ msgid "Return type" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.gateway.po b/docs/locale/it/LC_MESSAGES/api.gateway.po index aad9d8772..22e00a8ed 100644 --- a/docs/locale/it/LC_MESSAGES/api.gateway.po +++ b/docs/locale/it/LC_MESSAGES/api.gateway.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.gateway.rst:4 msgid "Gateway" @@ -36,121 +36,169 @@ msgid "" "WebSocket." msgstr "" +#: interactions.api.gateway.client.WebSocketClient:4 of +msgid "" +"The ``__heartbeat_event`` Event object is different from the one built in" +" to the Heartbeater object. The latter is used to trace heartbeat " +"acknowledgement." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient of msgid "Variables" msgstr "" -#: interactions.api.gateway.client.WebSocketClient:3 of +#: interactions.api.gateway.client.WebSocketClient:7 of msgid "The asynchronous event loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:4 of +#: interactions.api.gateway.client.WebSocketClient:8 of msgid "The built-in event dispatcher." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:5 of +#: interactions.api.gateway.client.WebSocketClient:9 of +msgid "The websocket ratelimiter object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:10 of msgid "The user-facing HTTP client." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:6 of +#: interactions.api.gateway.client.WebSocketClient:11 of msgid "The WebSocket data of the connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:7 of +#: interactions.api.gateway.client.WebSocketClient:12 of msgid "Whether the connection has been closed or not." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:8 of +#: interactions.api.gateway.client.WebSocketClient:13 of msgid "The connection options made during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:9 of +#: interactions.api.gateway.client.WebSocketClient:14 of msgid "The gateway intents used for connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:10 of +#: interactions.api.gateway.client.WebSocketClient:15 of msgid "The contents of the application returned when ready." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:11 of +#: interactions.api.gateway.client.WebSocketClient:16 of msgid "The context state of a \"heartbeat\" made to the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:12 of +#: interactions.api.gateway.client.WebSocketClient:17 of +msgid "The state of the overall heartbeat process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:18 of msgid "The shards used during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:13 of +#: interactions.api.gateway.client.WebSocketClient:19 of msgid "The presence used in connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:14 of +#: interactions.api.gateway.client.WebSocketClient:20 of msgid "The ready state of the client as an ``asyncio.Event``." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:15 of -msgid "The closing task for ending connections." +#: interactions.api.gateway.client.WebSocketClient:21 of +msgid "The task containing the heartbeat manager process." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:16 of +#: interactions.api.gateway.client.WebSocketClient:22 of msgid "Whether the client has started." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:17 of +#: interactions.api.gateway.client.WebSocketClient:23 of msgid "The ID of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:18 of +#: interactions.api.gateway.client.WebSocketClient:24 of msgid "The sequence identifier of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:19 of +#: interactions.api.gateway.client.WebSocketClient:25 of msgid "" "The latest time of the last send_packet function call since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:20 of +#: interactions.api.gateway.client.WebSocketClient:26 of msgid "" "The latest time of the last ``HEARTBEAT_ACK`` event since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:21 of -msgid "The latency of the connection, in seconds." +#: interactions.api.gateway.client.WebSocketClient:27 of +msgid "The Websocket ratelimit URL for resuming connections, if any." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:28 of +msgid "The Websocket URL for instantiating connections without resuming." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:29 of +msgid "The lock used for reconnecting the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:30 of +msgid "The lock used for closing the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:31 of +msgid "The task containing stopping the client, if any." msgstr "" #: interactions.api.gateway.client.WebSocketClient #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__identify +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache #: interactions.api.gateway.client.WebSocketClient.__option_type_context +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection +#: interactions.api.gateway.client.WebSocketClient._handle_stream +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence +#: interactions.api.gateway.client.WebSocketClient.request_guild_members #: interactions.api.gateway.heartbeat._Heartbeat of msgid "Parameters" msgstr "" -#: interactions.api.gateway.client.WebSocketClient +#: interactions.api.gateway.client.WebSocketClient.latency:1 of +msgid "The latency of the connection, in seconds." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat:1 of +msgid "" +"Controls the heartbeat manager. Do note that this shouldn't be executed " +"by outside processes." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__heartbeat #: interactions.api.gateway.client.WebSocketClient.__identify #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream -#: interactions.api.gateway.client.WebSocketClient.__restart +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__resume #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection #: interactions.api.gateway.client.WebSocketClient._manage_heartbeat +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence -#: interactions.api.gateway.client.WebSocketClient.wait_until_ready -#: interactions.api.gateway.heartbeat._Heartbeat of +#: interactions.api.gateway.client.WebSocketClient.close +#: interactions.api.gateway.client.WebSocketClient.request_guild_members +#: interactions.api.gateway.client.WebSocketClient.run +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat +#: interactions.api.gateway.client.WebSocketClient.wait_until_ready of msgid "Return type" msgstr "" @@ -158,29 +206,21 @@ msgstr "" msgid "Manages the heartbeat loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__restart:1 of -msgid "Restart the client's connection and heartbeat with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:1 of -msgid "Establishes a client connection with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:3 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:5 of -msgid "The shards to establish a connection with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient.run:1 of +msgid "Handles the client's connection with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._establish_connection:5 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:7 of -msgid "The presence to carry with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:1 of +msgid "" +"Parses raw stream data recieved from the Gateway, including Gateway " +"opcodes and events." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:1 of -msgid "Handles the client's connection with the Gateway." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:4 of +msgid "This should never be called directly." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:3 of +#: interactions.api.gateway.client.WebSocketClient._handle_stream:6 of msgid "The packet stream to handle." msgstr "" @@ -192,31 +232,68 @@ msgstr "" msgid "Dispatches an event from the Gateway." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:3 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:3 of msgid "The name of the event." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:5 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:5 of msgid "The data for the event." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of -msgid "" -"Takes raw data given back from the Gateway and gives \"context\" based " -"off of what it is." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:1 of +msgid "Gets an ID from object." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of -msgid "The data from the Gateway." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:5 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:7 of +msgid "The object of the event." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:7 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:5 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:9 of +msgid "The model of the event." msgstr "" #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context of msgid "Returns" msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:9 of +msgid "Object ID" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:1 of +msgid "Gets a list of ids of object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:7 of +msgid "Object IDs" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:1 of +msgid "Modifies guild cache." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of +msgid "" +"Takes raw data given back from the Gateway and gives \"context\" based " +"off of what it is." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of +msgid "The data from the Gateway." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize:6 of msgid "The context object." msgstr "" @@ -255,11 +332,15 @@ msgstr "" msgid "The option type context." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:1 of -msgid "Receives a stream of packets sent from the Gateway." +#: interactions.api.gateway.client.WebSocketClient._reconnect:1 of +msgid "Restarts the client's connection and heartbeat with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:3 of +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:1 of +msgid "Receives a stream of packets sent from the Gateway in an async process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:3 of msgid "The packet stream." msgstr "" @@ -311,6 +392,58 @@ msgid "" "disconnect." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:1 of +msgid "Sends an ``REQUEST_MEMBERS`` packet to the gateway." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:3 of +msgid "ID of the guild to get members for." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:5 of +msgid "" +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:7 of +msgid "String that username starts with." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.close:1 of +msgid "Closes the current connection." +msgstr "" + #: interactions.api.gateway.heartbeat._Heartbeat:1 of msgid "An internal class representing the heartbeat in a WebSocket connection." msgstr "" + +#~ msgid "The closing task for ending connections." +#~ msgstr "" + +#~ msgid "Restart the client's connection and heartbeat with the Gateway." +#~ msgstr "" + +#~ msgid "Establishes a client connection with the Gateway." +#~ msgstr "" + +#~ msgid "The shards to establish a connection with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "The presence to carry with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "Receives a stream of packets sent from the Gateway." +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.http.po b/docs/locale/it/LC_MESSAGES/api.http.po index b141f2d87..fcab462c2 100644 --- a/docs/locale/it/LC_MESSAGES/api.http.po +++ b/docs/locale/it/LC_MESSAGES/api.http.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.http.rst:4 msgid "HTTP" @@ -55,10 +55,13 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag #: interactions.api.http.channel.ChannelRequest.delete_channel #: interactions.api.http.channel.ChannelRequest.delete_channel_permission #: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag #: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -75,6 +78,7 @@ msgstr "" #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template @@ -169,6 +173,7 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker #: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread #: interactions.api.http.thread.ThreadRequest.join_thread #: interactions.api.http.thread.ThreadRequest.leave_thread @@ -198,14 +203,19 @@ msgstr "" msgid "Parameters" msgstr "" -#: interactions.api.http.channel.ChannelRequest +#: interactions.api.http.route.Route.get_bucket:1 of +msgid "" +"Returns the route's bucket. If shared_bucket is None, returns the path " +"with major parameters. Otherwise, it relies on Discord's given bucket." +msgstr "" + +#: interactions.api.http.route.Route.get_bucket:4 of +msgid "The bucket that Discord provides, if available." +msgstr "" + #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance -#: interactions.api.http.channel.ChannelRequest.delete_channel -#: interactions.api.http.channel.ChannelRequest.delete_channel_permission -#: interactions.api.http.channel.ChannelRequest.delete_stage_instance -#: interactions.api.http.channel.ChannelRequest.edit_channel_permission #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -214,37 +224,21 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel -#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway -#: interactions.api.http.client.HTTPClient.get_current_authorisation_information -#: interactions.api.http.client.HTTPClient.get_current_bot_information -#: interactions.api.http.client.HTTPClient.get_gateway -#: interactions.api.http.client.HTTPClient.login -#: interactions.api.http.client.HTTPClient.logout -#: interactions.api.http.emoji.EmojiRequest #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji -#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji -#: interactions.api.http.guild.GuildRequest #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template -#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template -#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.delete_guild -#: interactions.api.http.guild.GuildRequest.delete_guild_integration -#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles -#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild -#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -255,28 +249,17 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings -#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild -#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget -#: interactions.api.http.guild.GuildRequest.modify_user_voice_state -#: interactions.api.http.guild.GuildRequest.remove_guild_ban -#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template -#: interactions.api.http.interaction.InteractionRequest -#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command -#: interactions.api.http.interaction.InteractionRequest.create_interaction_response -#: interactions.api.http.interaction.InteractionRequest.delete_application_command -#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -285,46 +268,22 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command -#: interactions.api.http.limiter.Limiter -#: interactions.api.http.member.MemberRequest -#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member -#: interactions.api.http.member.MemberRequest.remove_member_role -#: interactions.api.http.member.MemberRequest.search_guild_members -#: interactions.api.http.message.MessageRequest -#: interactions.api.http.message.MessageRequest.create_message -#: interactions.api.http.message.MessageRequest.delete_message -#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message -#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message -#: interactions.api.http.message.MessageRequest.send_message -#: interactions.api.http.message.MessageRequest.unpin_message -#: interactions.api.http.reaction.ReactionRequest -#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction -#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction -#: interactions.api.http.request._Request -#: interactions.api.http.request._Request._check_lock -#: interactions.api.http.request._Request._check_session -#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request -#: interactions.api.http.route.Route interactions.api.http.route.Route.endpoint +#: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket -#: interactions.api.http.scheduledEvent.ScheduledEventRequest #: interactions.api.http.scheduledEvent.ScheduledEventRequest.create_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.delete_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event_users #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events #: interactions.api.http.scheduledEvent.ScheduledEventRequest.modify_scheduled_event -#: interactions.api.http.sticker.StickerRequest #: interactions.api.http.sticker.StickerRequest.create_guild_sticker #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker #: interactions.api.http.sticker.StickerRequest.get_guild_sticker @@ -332,53 +291,44 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker -#: interactions.api.http.thread.ThreadRequest -#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread -#: interactions.api.http.thread.ThreadRequest.join_thread -#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members -#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread -#: interactions.api.http.user.UserRequest #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user -#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild -#: interactions.api.http.webhook.WebhookRequest #: interactions.api.http.webhook.WebhookRequest.create_webhook -#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message -#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks -#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Return type" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:1 of -msgid "" -"Returns the route's bucket. If shared_bucket is None, returns the path " -"with major parameters. Otherwise, it relies on Discord's given bucket." +msgid "Returns" msgstr "" -#: interactions.api.http.route.Route.get_bucket:4 of -msgid "The bucket that Discord provides, if available." +#: interactions.api.http.route.Route.get_bucket:7 of +msgid "The route bucket." msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag +#: interactions.api.http.channel.ChannelRequest.delete_channel +#: interactions.api.http.channel.ChannelRequest.delete_channel_permission +#: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag +#: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -387,20 +337,36 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel +#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway +#: interactions.api.http.client.HTTPClient.get_current_authorisation_information +#: interactions.api.http.client.HTTPClient.get_current_bot_information +#: interactions.api.http.client.HTTPClient.get_gateway +#: interactions.api.http.client.HTTPClient.login +#: interactions.api.http.client.HTTPClient.logout #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji +#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template +#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template +#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.delete_guild +#: interactions.api.http.guild.GuildRequest.delete_guild_integration +#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles +#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild +#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -411,17 +377,27 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings +#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild +#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget +#: interactions.api.http.guild.GuildRequest.modify_user_voice_state +#: interactions.api.http.guild.GuildRequest.remove_guild_ban +#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template +#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command +#: interactions.api.http.interaction.InteractionRequest.create_interaction_response +#: interactions.api.http.interaction.InteractionRequest.delete_application_command +#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -430,13 +406,30 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command +#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member +#: interactions.api.http.member.MemberRequest.remove_member_role +#: interactions.api.http.member.MemberRequest.search_guild_members +#: interactions.api.http.message.MessageRequest.create_message +#: interactions.api.http.message.MessageRequest.delete_message +#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message +#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message +#: interactions.api.http.message.MessageRequest.send_message +#: interactions.api.http.message.MessageRequest.unpin_message +#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction +#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction +#: interactions.api.http.request._Request._check_lock +#: interactions.api.http.request._Request._check_session +#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request #: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket @@ -453,31 +446,36 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker +#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread +#: interactions.api.http.thread.ThreadRequest.join_thread +#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members +#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user +#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild #: interactions.api.http.webhook.WebhookRequest.create_webhook +#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message +#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks +#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Returns" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:7 of -msgid "The route bucket." +msgid "Return type" msgstr "" #: interactions.api.http.route.Route.endpoint:1 of @@ -617,9 +615,12 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel_invite:6 #: interactions.api.http.channel.ChannelRequest.create_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.create_tag:7 #: interactions.api.http.channel.ChannelRequest.delete_channel_permission:3 #: interactions.api.http.channel.ChannelRequest.delete_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.delete_tag:3 #: interactions.api.http.channel.ChannelRequest.edit_channel_permission:3 +#: interactions.api.http.channel.ChannelRequest.edit_tag:7 #: interactions.api.http.channel.ChannelRequest.get_channel:3 #: interactions.api.http.channel.ChannelRequest.get_channel_invites:3 #: interactions.api.http.channel.ChannelRequest.get_channel_messages:6 @@ -919,6 +920,51 @@ msgstr "" msgid "Delete a stage instance." msgstr "" +#: interactions.api.http.channel.ChannelRequest.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:4 +#: interactions.api.http.channel.ChannelRequest.edit_tag:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:8 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:9 +#: interactions.api.http.channel.ChannelRequest.edit_tag:10 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:10 +#: interactions.api.http.channel.ChannelRequest.edit_tag:11 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:1 of +msgid "Update a tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:8 of +msgid "The ID of the tag to update." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:1 of +msgid "Delete a forum tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:4 of +msgid "The ID of the tag to delete" +msgstr "" + #: interactions.api.http.emoji.EmojiRequest.get_all_emoji:1 of msgid "Gets all emojis from a guild." msgstr "" @@ -1279,6 +1325,7 @@ msgstr "" msgid "Gets all roles from a Guild." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:3 #: interactions.api.http.guild.GuildRequest.create_guild_ban:3 #: interactions.api.http.guild.GuildRequest.create_guild_kick:3 #: interactions.api.http.guild.GuildRequest.get_all_roles:3 @@ -1374,7 +1421,9 @@ msgid "" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "" +"Number of seconds to delete messages for, between 0 and 604800. Default " +"to 0" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:6 of @@ -1467,20 +1516,36 @@ msgstr "" msgid "Reason to send to audit log, if any." msgstr "" -#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of -msgid "" -"Retrieves a dict from an API that results in how many members would be " -"pruned given the amount of days." +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:1 of +msgid "Begins a prune operation." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:4 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:4 of -msgid "Number of days to count. Defaults to ``7``." +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:5 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:6 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:5 of msgid "Role IDs to include, if given." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:7 of +msgid "A dict containing `{\"pruned\": int}` or `{\"pruned\": None}`" +msgstr "" + +#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of +msgid "" +"Retrieves a dict from an API that results in how many members would be " +"pruned given the amount of days." +msgstr "" + #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:6 of msgid "A dict denoting `{\"pruned\": int}`" msgstr "" @@ -1974,7 +2039,8 @@ msgid "Channel snowflake ID." msgstr "" #: interactions.api.http.message.MessageRequest.create_message:5 -#: interactions.api.http.message.MessageRequest.edit_message:6 of +#: interactions.api.http.message.MessageRequest.edit_message:6 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:9 of msgid "An optional list of files to send attached to the message." msgstr "" @@ -2178,11 +2244,8 @@ msgid "Guild Scheduled Event ID snowflake." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:5 -#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 #: of -msgid "" -"A boolean to include number of users subscribed to the associated event, " -"if given." +msgid "Whether the number of users subscribed to the events is returned." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:6 @@ -2195,6 +2258,13 @@ msgstr "" msgid "Gets all guild scheduled events in a guild." msgstr "" +#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 +#: of +msgid "" +"Whether the number of users subscribed to the associated event is " +"returned." +msgstr "" + #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:5 #: of msgid "" @@ -2307,22 +2377,25 @@ msgid "" "MANAGE_EMOJIS_AND_STICKERS permission." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 -#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of -msgid "the payload to send." +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 of +msgid "The payload to send." msgstr "" #: interactions.api.http.sticker.StickerRequest.create_guild_sticker:4 of +msgid "The file to send." +msgstr "" + +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 of msgid "The guild to create sticker at." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:5 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:6 of msgid "The reason for this action." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 of +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:7 of msgid "The new sticker data on success." msgstr "" @@ -2332,6 +2405,10 @@ msgid "" "permission." msgstr "" +#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of +msgid "the payload to send." +msgstr "" + #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:3 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:4 of msgid "The guild of the target sticker." @@ -2483,15 +2560,18 @@ msgid "" "with.." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:3 of +#: interactions.api.http.thread.ThreadRequest.create_thread:3 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:3 of msgid "The ID of the channel to create this thread in" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:4 of +#: interactions.api.http.thread.ThreadRequest.create_thread:4 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:4 of msgid "The name of the thread" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:5 of +#: interactions.api.http.thread.ThreadRequest.create_thread:5 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:5 of msgid "" "duration in minutes to automatically archive the thread after recent " "activity, can be set to: 60, 1440, 4320, 10080" @@ -2511,7 +2591,8 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:10 of +#: interactions.api.http.thread.ThreadRequest.create_thread:10 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:11 of msgid "An optional reason for the audit log" msgstr "" @@ -2519,6 +2600,28 @@ msgstr "" msgid "The created thread" msgstr "" +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:1 of +msgid "From a given Forum channel, create a Thread with a message to start with." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:7 of +msgid "The payload/dictionary contents of the first message in the forum thread." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:8 of +msgid "List of tag ids that can be applied to the forum, if any." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:10 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:12 of +msgid "Returns a Thread in a Forum object with a starting Message." +msgstr "" + #: interactions.api.http.user.UserRequest.get_self:1 of msgid "An alias to `get_user`, but only gets the current bot user." msgstr "" @@ -2743,3 +2846,15 @@ msgstr "" #: of msgid "Deletes the original message object sent." msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Number of days to count. Defaults to ``7``." +#~ msgstr "" + +#~ msgid "" +#~ "A boolean to include number of " +#~ "users subscribed to the associated " +#~ "event, if given." +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.models.audit_log.po b/docs/locale/it/LC_MESSAGES/api.models.audit_log.po new file mode 100644 index 000000000..7ba1f1c2b --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/api.models.audit_log.po @@ -0,0 +1,413 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.audit_log.rst:4 +msgid "Audit-Log Models" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:1 of +msgid "A class object representing an AuditLogEntry." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange +#: interactions.api.models.audit_log.AuditLogEntry +#: interactions.api.models.audit_log.AuditLogEvents +#: interactions.api.models.audit_log.AuditLogs +#: interactions.api.models.audit_log.OptionalAuditEntryInfo of +msgid "Variables" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:3 of +msgid "ID of the affected entity (webhook, user, role, etc.)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:4 of +msgid "Changes made to the target_id" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:5 of +msgid "User or app that made the changes" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:6 of +msgid "ID of the entry" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:7 of +msgid "Type of action that occurred" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:8 of +msgid "Additional info for certain event types" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:9 of +msgid "Reason for the change (1-512 characters)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "A class object representing the different types of AuditLogEvents." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:3 of +msgid "1 - Server settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:4 of +msgid "10 - Channel was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:5 of +msgid "11 - Channel settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:6 of +msgid "12 - Channel was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:7 of +msgid "13 - Permission overwrite was added to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:8 of +msgid "14 - Permission overwrite was updated for a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:9 of +msgid "15 - Permission overwrite was deleted from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:10 of +msgid "20 - Member was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:11 of +msgid "21 - Members were pruned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:12 of +msgid "22 - Member was banned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:13 of +msgid "23 - Server ban was lifted for a member" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:14 of +msgid "24 - Member was updated in server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:15 of +msgid "25 - Member was added or removed from a role" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:16 of +msgid "26 - Member was moved to a different voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:17 of +msgid "27 - Member was disconnected from a voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:18 of +msgid "28 - Bot user was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:19 of +msgid "30 - Role was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:20 of +msgid "31 - Role was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:21 of +msgid "32 - Role was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:22 of +msgid "40 - Server invite was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:23 of +msgid "41 - Server invite was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:24 of +msgid "42 - Server invite was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:25 of +msgid "50 - Webhook was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:26 of +msgid "51 - Webhook properties or channel were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:27 of +msgid "52 - Webhook was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:28 of +msgid "60 - Emoji was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:29 of +msgid "61 - Emoji name was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:30 of +msgid "62 - Emoji was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:31 of +msgid "72 - Single message was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:32 of +msgid "73 - Multiple messages were deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:33 of +msgid "74 - Message was pinned to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:34 of +msgid "75 - Message was unpinned from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:35 of +msgid "80 - App was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:36 of +msgid "81 - App was updated (as an example, its scopes were updated)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:37 of +msgid "82 - App was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:38 of +msgid "83 - Stage instance was created (stage channel becomes live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:39 of +msgid "84 - Stage instance details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:40 of +msgid "85 - Stage instance was deleted (stage channel no longer live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:41 of +msgid "90 - Sticker was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:42 of +msgid "91 - Sticker details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:43 of +msgid "92 - Sticker was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:44 of +msgid "100 - Event was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:45 of +msgid "101 - Event was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:46 of +msgid "102 - Event was cancelled" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:47 of +msgid "110 - Thread was created in a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:48 of +msgid "111 - Thread was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:49 of +msgid "112 - Thread was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:50 of +msgid "121 - Permissions were updated for a command" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:51 of +msgid "140 - Auto Moderation rule was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:52 of +msgid "141 - Auto Moderation rule was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:53 of +msgid "142 - Auto Moderation rule was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:54 of +msgid "143 - Message was blocked by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:55 of +msgid "144 - Message was flagged by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:56 of +msgid "145 - Member was timed out by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents of +msgid "Member Type" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid ":py:class:`int`" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:1 of +msgid "A class object representing the audit logs of a guild." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:3 of +msgid "List of audit log entries, sorted from most to least recent." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:4 of +msgid "List of auto moderation rules referenced in the audit log." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:5 of +msgid "List of guild scheduled events referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:6 of +msgid "List of partial integration objects" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:7 of +msgid "List of threads referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:8 of +msgid "List of users referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:9 of +msgid "List of webhooks referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:1 of +msgid "A class object representing an AuditLogChange." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:3 of +msgid "New value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:4 of +msgid "Old value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:5 of +msgid "" +"Name of the changed entity, with a few " +"[exceptions](https://discord.com/developers/docs/resources/audit-log" +"#audit-log-change-object-audit-log-change-exceptions)" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:1 of +msgid "A class object representing OptionalAuditEntryInfo." +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:3 of +msgid "" +"ID of the app whose permissions were targeted. ``AuditLogEvents``-type: " +"121" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:4 of +msgid "" +"Channel in which the entities were targeted. ``AuditLogEvents``-types: " +"26, 74, 75, 72, 83, 84, 85" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:5 of +msgid "" +"Name of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:6 of +msgid "" +"Trigger type of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:7 of +msgid "" +"Number of entities that were targeted. ``AuditLogEvents``-types: 72, 73, " +"27, 26" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:8 of +msgid "" +"Number of days after which inactive members were kicked. " +"``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:9 of +msgid "ID of the overwritten entity. ``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:10 of +msgid "Number of members removed by the prune. ``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:11 of +msgid "ID of the message that was targeted. ``AuditLogEvents``-types: 74, 75" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:12 of +msgid "" +"Name of the role if type is \"0\" (not present if type is \"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:13 of +msgid "" +"Type of overwritten entity - role (\"0\") or member (\"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.models.channel.po b/docs/locale/it/LC_MESSAGES/api.models.channel.po index 1ca5f1ac3..81a65bd8e 100644 --- a/docs/locale/it/LC_MESSAGES/api.models.channel.po +++ b/docs/locale/it/LC_MESSAGES/api.models.channel.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.channel.rst:4 msgid "Channel Models" @@ -39,22 +39,24 @@ msgid "Valid values are as follows:" msgstr "" #: interactions.api.models.channel.Thread:1 of -msgid "An object representing a thread." -msgstr "" - -#: interactions.api.models.channel.Thread:4 of -msgid "" -"This is a derivation of the base Channel, since a thread can be its own " -"event." +msgid "An object representing a thread. .. note::" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator +#: interactions.api.models.channel.AsyncTypingContextManager #: interactions.api.models.channel.Channel #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.modify #: interactions.api.models.channel.Channel.pin_message @@ -72,6 +74,9 @@ msgstr "" #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit #: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit #: interactions.api.models.channel.Thread #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of @@ -88,7 +93,7 @@ msgid "" "needed to be used directly." msgstr "" -#: interactions.api.models.channel.Channel +#: interactions.api.models.channel.Channel interactions.api.models.channel.Tags #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of msgid "Variables" @@ -183,33 +188,64 @@ msgid "The amount of members in the channel." msgstr "" #: interactions.api.models.channel.Channel:29 of -msgid "The thread metadata of the channel." +msgid "Boolean representing if a thread is created." msgstr "" #: interactions.api.models.channel.Channel:30 of -msgid "The member of the thread in the channel." +msgid "The thread metadata of the channel." msgstr "" #: interactions.api.models.channel.Channel:31 of +msgid "The member of the thread in the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:32 of msgid "" "The set auto-archive time for all threads to naturally follow in the " "channel." msgstr "" -#: interactions.api.models.channel.Channel:32 of +#: interactions.api.models.channel.Channel:33 of msgid "The permissions of the channel." msgstr "" -#: interactions.api.models.channel.Channel.mention:1 of -msgid "Returns a string that allows you to mention the given channel." +#: interactions.api.models.channel.Channel:34 of +msgid "The flags of the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:35 of +msgid "Number of messages ever sent in a thread." +msgstr "" + +#: interactions.api.models.channel.Channel:36 of +msgid "" +"The default slowmode delay in seconds for threads, if this channel is a " +"forum." +msgstr "" + +#: interactions.api.models.channel.Channel:37 of +msgid "Tags in a forum channel, if any." +msgstr "" + +#: interactions.api.models.channel.Channel:38 of +msgid "Default reaction emoji for threads created in a forum, if any." +msgstr "" + +#: interactions.api.models.channel.Channel.typing:1 of +msgid "Manages the typing of the channel. Use with `await` or `async with`" msgstr "" #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.mention #: interactions.api.models.channel.Channel.modify @@ -224,24 +260,33 @@ msgstr "" #: interactions.api.models.channel.Channel.set_position #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic -#: interactions.api.models.channel.Channel.set_user_limit of +#: interactions.api.models.channel.Channel.set_user_limit +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Tags.edit of msgid "Returns" msgstr "" -#: interactions.api.models.channel.Channel.mention:3 of -msgid "The string of the mentioned channel." +#: interactions.api.models.channel.Channel.typing:3 of +msgid "A manager for typing" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator.flatten #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread #: interactions.api.models.channel.Channel.delete +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages #: interactions.api.models.channel.Channel.get_webhooks +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.join #: interactions.api.models.channel.Channel.leave #: interactions.api.models.channel.Channel.lock @@ -261,10 +306,44 @@ msgstr "" #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit -#: interactions.api.models.channel.Channel.unpin_message of +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit of msgid "Return type" msgstr "" +#: interactions.api.models.channel.Channel.mention:1 of +msgid "Returns a string that allows you to mention the given channel." +msgstr "" + +#: interactions.api.models.channel.Channel.mention:3 of +msgid "The string of the mentioned channel." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:7 +#: interactions.api.models.channel.Channel.history:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:9 +#: interactions.api.models.channel.Channel.history:3 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:13 +#: interactions.api.models.channel.Channel.history:5 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.channel.Channel.history:7 of +msgid "A custom check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.Channel.history:10 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" + #: interactions.api.models.channel.Channel.send:1 of msgid "Sends a message in the channel." msgstr "" @@ -292,7 +371,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.channel.Channel.send:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.channel.Channel.send:15 of @@ -625,10 +704,12 @@ msgstr "" msgid "Creates a thread in the Channel." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:3 #: interactions.api.models.channel.Channel.create_thread:3 of msgid "The name of the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:5 #: interactions.api.models.channel.Channel.create_thread:5 of msgid "" "duration in minutes to automatically archive the thread after recent " @@ -649,6 +730,7 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:16 #: interactions.api.models.channel.Channel.create_thread:14 of msgid "An optional reason for the audit log" msgstr "" @@ -734,6 +816,109 @@ msgstr "" msgid "Add the bot to the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:4 +#: interactions.api.models.channel.Channel.edit_tag:4 +#: interactions.api.models.channel.Tags.edit:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:7 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:9 +#: interactions.api.models.channel.Channel.edit_tag:11 +#: interactions.api.models.channel.Tags.edit:11 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:11 +#: interactions.api.models.channel.Channel.edit_tag:13 +#: interactions.api.models.channel.Tags.edit:13 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:13 of +msgid "The create tag object" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:1 of +msgid "Edits a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:7 of +msgid "The ID of the tag to edit" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:9 +#: interactions.api.models.channel.Tags.edit:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:15 +#: interactions.api.models.channel.Tags.edit:15 of +msgid "The modified tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:1 of +msgid "Deletes a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:3 of +msgid "The ID of the Tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:1 of +msgid "Creates a new post inside a forum channel" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:8 of +msgid "The content to send as first message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:10 of +msgid "Tags to give to the created thread" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:12 of +msgid "An optional list of files to send attached to the message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:14 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:18 of +msgid "A channel of ChannelType 11 (THREAD)" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:1 of +msgid "Returns the permissions of the member in this specific channel." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:4 of +msgid "" +"The permissions returned by this function take into account role and user" +" overwrites that can be assigned to channels or categories. If you don't " +"need these overwrites, look into :meth:`.Member.get_guild_permissions`." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:8 of +msgid "The member to get the permissions from" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:10 of +msgid "Permissions of the member in this channel" +msgstr "" + #: interactions.api.models.channel.ThreadMember:1 of msgid "A class object representing a member in a thread." msgstr "" @@ -793,3 +978,83 @@ msgstr "" #: interactions.api.models.channel.ThreadMetadata:11 of msgid "The ability to invite users to the thread." msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:3 +#: interactions.api.models.channel.AsyncTypingContextManager:5 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:11 of +msgid "A check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:1 of +msgid "An async context manager for triggering typing." +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:3 of +msgid "The channel to trigger typing in." +msgstr "" + +#: interactions.api.models.channel.Tags:1 of +msgid "An object denoting a tag object within a forum channel." +msgstr "" + +#: interactions.api.models.channel.Tags:4 of +msgid "If the emoji is custom, it won't have name information." +msgstr "" + +#: interactions.api.models.channel.Tags:6 of +msgid "Name of the tag. The limit is up to 20 characters." +msgstr "" + +#: interactions.api.models.channel.Tags:7 of +msgid "ID of the tag. Can also be 0 if manually created." +msgstr "" + +#: interactions.api.models.channel.Tags:8 of +msgid "" +"A boolean denoting whether this tag can be removed/added by moderators " +"with ``manage_threads`` permissions." +msgstr "" + +#: interactions.api.models.channel.Tags:9 of +msgid "The emoji to represent the tag, if any." +msgstr "" + +#: interactions.api.models.channel.Tags.delete:1 of +msgid "Deletes this tag" +msgstr "" + +#: interactions.api.models.channel.Tags.delete:3 +#: interactions.api.models.channel.Tags.edit:7 of +msgid "The ID of the channel where the tag belongs to" +msgstr "" + +#: interactions.api.models.channel.Tags.edit:1 of +msgid "Edits this tag" +msgstr "" + +#~ msgid "An object representing a thread." +#~ msgstr "" + +#~ msgid "" +#~ "This is a derivation of the base" +#~ " Channel, since a thread can be " +#~ "its own event." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.models.emoji.po b/docs/locale/it/LC_MESSAGES/api.models.emoji.po new file mode 100644 index 000000000..2809ce66e --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/api.models.emoji.po @@ -0,0 +1,139 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-29 13:24-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.emoji.rst:4 +msgid "Emoji Models" +msgstr "" + +#: interactions.api.models.emoji.Emoji:1 of +msgid "A class objecting representing an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji of +msgid "Variables" +msgstr "" + +#: interactions.api.models.emoji.Emoji:3 of +msgid "Emoji id" +msgstr "" + +#: interactions.api.models.emoji.Emoji:4 of +msgid "Emoji name." +msgstr "" + +#: interactions.api.models.emoji.Emoji:5 of +msgid "Roles allowed to use this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:6 of +msgid "User that created this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:7 of +msgid "Status denoting of this emoji must be wrapped in colons" +msgstr "" + +#: interactions.api.models.emoji.Emoji:8 of +msgid "Status denoting if this emoji is managed (by an integration)" +msgstr "" + +#: interactions.api.models.emoji.Emoji:9 of +msgid "Status denoting if this emoji is animated" +msgstr "" + +#: interactions.api.models.emoji.Emoji:10 of +msgid "" +"Status denoting if this emoji can be used. (Can be false via server " +"boosting)" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:1 of +msgid "Gets an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild of +msgid "Parameters" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:3 of +msgid "The id of the guild of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:5 of +msgid "The id of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:7 +#: interactions.api.models.emoji.Emoji.get_all_of_guild:5 of +msgid "The HTTPClient of your bot. Equals to ``bot._http``" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Returns" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:9 of +msgid "The Emoji as object" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Return type" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:1 of +msgid "Gets all emoji of a guild." +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:3 of +msgid "The id of the guild to get the emojis of" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:7 of +msgid "The Emoji as list" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:1 of +msgid "Deletes the emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:3 of +msgid "The guild id to delete the emoji from" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:5 of +msgid "The reason of the deletion" +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:1 of +msgid "Returns the emoji's URL." +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:3 of +msgid "URL of the emoji" +msgstr "" + +#~ msgid "Audit-Log Models" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.models.guild.po b/docs/locale/it/LC_MESSAGES/api.models.guild.po index a233b694b..6a195d3a5 100644 --- a/docs/locale/it/LC_MESSAGES/api.models.guild.po +++ b/docs/locale/it/LC_MESSAGES/api.models.guild.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:25-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.guild.rst:4 msgid "Guild Models" @@ -85,6 +85,7 @@ msgstr "" msgid "The location of the event, if any." msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator #: interactions.api.models.guild.EventMetadata #: interactions.api.models.guild.Guild #: interactions.api.models.guild.Guild.add_member_role @@ -95,17 +96,25 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji #: interactions.api.models.guild.Guild.delete_role #: interactions.api.models.guild.Guild.delete_scheduled_event +#: interactions.api.models.guild.Guild.delete_sticker +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule @@ -115,6 +124,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -672,13 +683,26 @@ msgid "The id of the member to ban" msgstr "" #: interactions.api.models.guild.Guild.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.guild.Guild.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:13 of +msgid "The reason of the ban" msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator.flatten #: interactions.api.models.guild.Guild.add_member_role #: interactions.api.models.guild.Guild.ban #: interactions.api.models.guild.Guild.clone_channel @@ -687,6 +711,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji @@ -698,13 +723,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.leave #: interactions.api.models.guild.Guild.list_auto_moderation_rules @@ -716,6 +749,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -840,6 +875,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_channel #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.get_all_active_threads #: interactions.api.models.guild.Guild.get_all_bans @@ -847,13 +883,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule #: interactions.api.models.guild.Guild.modify_channel @@ -862,6 +906,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.search_members of msgid "Returns" msgstr "" @@ -1508,6 +1554,20 @@ msgstr "" msgid "The created event" msgstr "" +#: interactions.api.models.guild.Guild.get_scheduled_events:1 of +msgid "Gets all scheduled events of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:3 of +msgid "" +"A boolean to include number of users subscribed to the associated event, " +"if given." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:5 of +msgid "The sheduled events of the guild." +msgstr "" + #: interactions.api.models.guild.Guild.modify_scheduled_event:1 of msgid "Edits a scheduled event of the guild." msgstr "" @@ -1614,6 +1674,40 @@ msgstr "" msgid "Gets all bans of the guild." msgstr "" +#: interactions.api.models.guild.Guild.prune:1 of +msgid "Begins a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:3 +#: interactions.api.models.guild.Guild.prune:3 of +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:4 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:4 +#: interactions.api.models.guild.Guild.prune:5 of +msgid "Role IDs to include, if given." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:6 of +msgid "" +"The number of pruned members, if compute_prune_count is not false. " +"Otherwise returns None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:1 of +msgid "Returns the number of members that would be removed in a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:5 of +msgid "The number of members that would be pruned." +msgstr "" + #: interactions.api.models.guild.Guild.get_emoji:1 of msgid "Gets an emoji of the guild and returns it." msgstr "" @@ -1664,6 +1758,77 @@ msgstr "" msgid "The emoji or the id of the emoji to delete" msgstr "" +#: interactions.api.models.guild.Guild.get_stickers:1 of +msgid "Get the stickers for a guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_stickers:3 of +msgid "List of stickers of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:1 of +msgid "Gets the list of sticker packs available to Nitro subscribers." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:3 of +msgid "List of sticker packs." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:1 of +msgid "Creates a new sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:3 of +msgid "The file of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:5 of +msgid "The tags of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:7 +#: interactions.api.models.guild.Guild.modify_sticker:5 of +msgid "The name of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:9 +#: interactions.api.models.guild.Guild.modify_sticker:7 of +msgid "The description of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:11 of +msgid "The reason of the creation." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:13 of +msgid "Created sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:1 of +msgid "Modifies the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:3 +#: interactions.api.models.guild.Guild.modify_sticker:3 of +msgid "The sticker or ID of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:9 of +msgid "The reason of the modification." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:11 of +msgid "Modified sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:1 of +msgid "Deletes the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:5 of +msgid "The reason of the deletion." +msgstr "" + #: interactions.api.models.guild.Guild.get_list_of_members:1 of msgid "Lists the members of a guild." msgstr "" @@ -1710,6 +1875,23 @@ msgstr "" msgid "Returns a list of all members of the guild" msgstr "" +#: interactions.api.models.guild.Guild.get_members:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:11 +#: interactions.api.models.guild.Guild.get_members:3 of +msgid "A set maximum of members to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:5 of +msgid "A custom check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:8 of +msgid "An asynchronous iterator over the members of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.list_auto_moderation_rules:1 of msgid "Lists all AutoMod rules" msgstr "" @@ -1784,6 +1966,55 @@ msgstr "" msgid "The rule to modify" msgstr "" +#: interactions.api.models.guild.Guild.get_audit_logs:1 of +msgid "Gets the audit logs of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:3 of +msgid "How many entries to get, default 100" +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:5 +#: interactions.api.models.guild.Guild.get_full_audit_logs:3 of +msgid "User ID snowflake. filter the log for actions made by a user." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:7 of +msgid "The Type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:9 of +msgid "filter the log before a certain entry id." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:11 of +msgid "The guild audit logs" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:1 of +msgid "Gets the latest audit log action of either a user or an action type" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:3 of +msgid "The user, user id or action type to look for" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:5 of +msgid "The latest AuditLog action that applies to the ``of`` parameter" +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:1 of +msgid "Gets the full audit log of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:5 of +msgid "The type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:7 of +msgid "The full AuditLog of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.icon_url:1 of msgid "" "Returns the URL of the guild's icon. :return: URL of the guild's icon " @@ -1897,3 +2128,32 @@ msgstr "" #: interactions.api.models.guild.Invite.delete:1 of msgid "Deletes the invite" msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:3 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:5 of +msgid "The guild to get the members from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:7 of +msgid "" +"The member ID to start getting members from (gets all members after that " +"member)" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:9 of +msgid "A check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.models.gw.po b/docs/locale/it/LC_MESSAGES/api.models.gw.po index fe823c232..88a920629 100644 --- a/docs/locale/it/LC_MESSAGES/api.models.gw.po +++ b/docs/locale/it/LC_MESSAGES/api.models.gw.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.gw.rst:4 msgid "Gateway-specific Event Models" @@ -42,10 +42,10 @@ msgstr "" #: interactions.api.models.gw.GuildScheduledEventUser #: interactions.api.models.gw.GuildStickers #: interactions.api.models.gw.Integration +#: interactions.api.models.gw.MessageDelete #: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList +#: interactions.api.models.gw.MessageReactionRemove +#: interactions.api.models.gw.Presence interactions.api.models.gw.ThreadList #: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks #: of msgid "Variables" @@ -93,36 +93,6 @@ msgstr "" msgid "The substring in content that triggered rule." msgstr "" -#: interactions.api.models.gw.ApplicationCommandPermissions -#: interactions.api.models.gw.AutoModerationAction -#: interactions.api.models.gw.AutoModerationRule -#: interactions.api.models.gw.ChannelPins -#: interactions.api.models.gw.EmbeddedActivity -#: interactions.api.models.gw.GuildBan interactions.api.models.gw.GuildEmojis -#: interactions.api.models.gw.GuildIntegrations -#: interactions.api.models.gw.GuildJoinRequest -#: interactions.api.models.gw.GuildMember -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send -#: interactions.api.models.gw.GuildMembers interactions.api.models.gw.GuildRole -#: interactions.api.models.gw.GuildScheduledEvent -#: interactions.api.models.gw.GuildScheduledEventUser -#: interactions.api.models.gw.GuildStickers -#: interactions.api.models.gw.Integration -#: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList -#: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks -#: of -msgid "Parameters" -msgstr "" - #: interactions.api.models.gw.AutoModerationRule:1 of msgid "" "A class object representing the gateway events " @@ -232,14 +202,14 @@ msgstr "" #: interactions.api.models.gw.GuildEmojis:3 #: interactions.api.models.gw.GuildIntegrations:3 #: interactions.api.models.gw.GuildJoinRequest:7 -#: interactions.api.models.gw.GuildMember:3 #: interactions.api.models.gw.GuildMembers:3 #: interactions.api.models.gw.GuildRole:3 #: interactions.api.models.gw.GuildStickers:3 #: interactions.api.models.gw.Integration:23 +#: interactions.api.models.gw.MessageDelete:5 #: interactions.api.models.gw.MessageReaction:6 +#: interactions.api.models.gw.MessageReactionRemove:10 #: interactions.api.models.gw.Presence:4 -#: interactions.api.models.gw.ReactionRemove:10 #: interactions.api.models.gw.ThreadList:3 #: interactions.api.models.gw.ThreadMembers:4 of msgid "The guild ID of the event." @@ -251,8 +221,9 @@ msgstr "" #: interactions.api.models.gw.ChannelPins:4 #: interactions.api.models.gw.EmbeddedActivity:9 +#: interactions.api.models.gw.MessageDelete:4 #: interactions.api.models.gw.MessageReaction:4 -#: interactions.api.models.gw.ReactionRemove:8 of +#: interactions.api.models.gw.MessageReactionRemove:8 of msgid "The channel ID of the event." msgstr "" @@ -312,7 +283,6 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildBan:4 -#: interactions.api.models.gw.GuildMember:5 #: interactions.api.models.gw.Integration:17 #: interactions.api.models.gw.Presence:3 of msgid "The user of the event." @@ -378,14 +348,21 @@ msgstr "" msgid "The members of the thread of the event." msgstr "" -#: interactions.api.models.gw.ReactionRemove:1 of +#: interactions.api.models.gw.MessageDelete:1 of +msgid "A class object representing the gateway event ``MESSAGE_DELETE_BULK``." +msgstr "" + +#: interactions.api.models.gw.MessageDelete:3 of +msgid "The message IDs of the event." +msgstr "" + +#: interactions.api.models.gw.MessageReactionRemove:1 of msgid "" "A class object representing the gateway events " -"``MESSAGE_REACTION_REMOVE``, ``MESSAGE_REACTION_REMOVE_ALL`` and " -"``MESSAGE_REACTION_REMOVE_EMOJI``." +"``MESSAGE_REACTION_REMOVE_ALL`` and ``MESSAGE_REACTION_REMOVE_EMOJI``." msgstr "" -#: interactions.api.models.gw.ReactionRemove:4 of +#: interactions.api.models.gw.MessageReactionRemove:4 of msgid "" "This class inherits the already existing attributes of " ":class:`interactions.api.models.gw.Reaction`. The main missing attribute " @@ -394,22 +371,24 @@ msgstr "" #: interactions.api.models.gw.GuildJoinRequest:6 #: interactions.api.models.gw.MessageReaction:3 -#: interactions.api.models.gw.ReactionRemove:7 of +#: interactions.api.models.gw.MessageReactionRemove:7 of msgid "The user ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:5 -#: interactions.api.models.gw.ReactionRemove:9 of +#: interactions.api.models.gw.MessageReactionRemove:9 of msgid "The message ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:8 -#: interactions.api.models.gw.ReactionRemove:11 of +#: interactions.api.models.gw.MessageReactionRemove:11 of msgid "The emoji of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:1 of -msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +msgid "" +"A class object representing the gateway event ``MESSAGE_REACTION_ADD`` " +"and ``MESSAGE_REACTION_REMOVE``." msgstr "" #: interactions.api.models.gw.MessageReaction:7 of @@ -473,204 +452,58 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildMember:4 of -msgid "The roles of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:6 of -msgid "The nickname of the user of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:7 of -msgid "The avatar URL of the user of the event." +msgid "" +"``pending`` and ``permissions`` only apply for members retroactively " +"requiring to verify rules via. membership screening or lack permissions " +"to speak." msgstr "" #: interactions.api.models.gw.GuildMember:8 of -msgid "The time that the user of the event joined at." +msgid "The guild ID." msgstr "" #: interactions.api.models.gw.GuildMember:9 of -msgid "The time that the user of the event has since had \"premium.\"" +msgid "The user of the guild." msgstr "" #: interactions.api.models.gw.GuildMember:10 of -msgid "Whether the member of the event is deafened or not." +msgid "The nickname of the member." msgstr "" #: interactions.api.models.gw.GuildMember:11 of -msgid "Whether the member of the event is muted or not." +msgid "The hash containing the user's guild avatar, if applicable." msgstr "" #: interactions.api.models.gw.GuildMember:12 of -msgid "" -"Whether the member of the event is still pending -- pass membership " -"screening -- or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:1 of -msgid "Returns the ID of the user." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.send of -msgid "Returns" -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:3 of -msgid "The ID of the user" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send of -msgid "Return type" -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:1 of -msgid "Returns the string of either the user's nickname or username." -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:3 of -msgid "The name of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:1 of -msgid "Returns a string that allows you to mention the given member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:3 of -msgid "The string of the mentioned member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:1 of -msgid "Bans the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:3 of -msgid "The reason of the ban" -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:1 of -msgid "Kicks the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:3 of -msgid "The reason for the kick" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:1 of -msgid "This method adds a role to a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:3 of -msgid "The role to add. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:5 of -msgid "The reason why the roles are added" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:1 of -msgid "This method removes a role from a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:3 of -msgid "The role to remove. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:5 of -msgid "The reason why the roles are removed" -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:1 of -msgid "Sends a DM to the member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:3 of -msgid "The contents of the message as a string or string-converted value." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:5 of -msgid "A component, or list of components for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:7 of -msgid "Whether the message utilizes the text-to-speech Discord programme or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:9 of -msgid "A file or list of files to be attached to the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:11 of -msgid "An embed, or list of embeds for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:13 of -msgid "The message interactions/mention limits that the message can refer to." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:15 of -msgid "The sent message as an object." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:1 of -msgid "Modifies the member of a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:3 of -msgid "The nickname of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:5 of -msgid "A list of all role ids the member has" +msgid "The list of roles of the member." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:7 of -msgid "whether the user is muted in voice channels" +#: interactions.api.models.gw.GuildMember:13 of +msgid "The timestamp the member joined the guild at." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:9 of -msgid "whether the user is deafened in voice channels" +#: interactions.api.models.gw.GuildMember:14 of +msgid "The timestamp the member has been a server booster since." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:11 of -msgid "id of channel to move user to (if they are connected to voice)" +#: interactions.api.models.gw.GuildMember:15 of +msgid "Whether the member is deafened." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:13 of -msgid "" -"when the user's timeout will expire and the user will be able to " -"communicate in the guild again (up to 28 days in the future)" +#: interactions.api.models.gw.GuildMember:16 of +msgid "Whether the member is muted." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:15 of -msgid "The reason of the modifying" +#: interactions.api.models.gw.GuildMember:17 of +msgid "Whether the member is pending to pass membership screening." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:17 of -msgid "The modified member object" +#: interactions.api.models.gw.GuildMember:18 of +msgid "Whether the member has permissions." msgstr "" -#: interactions.api.models.gw.GuildMember.add_to_thread:1 of -msgid "Adds the member to a thread." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_to_thread:3 of -msgid "The id of the thread to add the member to" +#: interactions.api.models.gw.GuildMember:19 of +msgid "How long until they're unmuted, if any." msgstr "" #: interactions.api.models.gw.GuildStickers:1 of @@ -823,3 +656,164 @@ msgstr "" #: interactions.api.models.gw.GuildRole:5 of msgid "The role ID of the event." msgstr "" + +#~ msgid "" +#~ "A class object representing the gateway" +#~ " events ``MESSAGE_REACTION_REMOVE``, " +#~ "``MESSAGE_REACTION_REMOVE_ALL`` and " +#~ "``MESSAGE_REACTION_REMOVE_EMOJI``." +#~ msgstr "" + +#~ msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +#~ msgstr "" + +#~ msgid "The roles of the event." +#~ msgstr "" + +#~ msgid "The nickname of the user of the event." +#~ msgstr "" + +#~ msgid "The avatar URL of the user of the event." +#~ msgstr "" + +#~ msgid "The time that the user of the event joined at." +#~ msgstr "" + +#~ msgid "The time that the user of the event has since had \"premium.\"" +#~ msgstr "" + +#~ msgid "Whether the member of the event is deafened or not." +#~ msgstr "" + +#~ msgid "Whether the member of the event is muted or not." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the member of the event is" +#~ " still pending -- pass membership " +#~ "screening -- or not." +#~ msgstr "" + +#~ msgid "Returns the ID of the user." +#~ msgstr "" + +#~ msgid "Returns" +#~ msgstr "" + +#~ msgid "The ID of the user" +#~ msgstr "" + +#~ msgid "Return type" +#~ msgstr "" + +#~ msgid "Returns the string of either the user's nickname or username." +#~ msgstr "" + +#~ msgid "The name of the member" +#~ msgstr "" + +#~ msgid "Returns a string that allows you to mention the given member." +#~ msgstr "" + +#~ msgid "The string of the mentioned member." +#~ msgstr "" + +#~ msgid "Bans the member from a guild." +#~ msgstr "" + +#~ msgid "The reason of the ban" +#~ msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Kicks the member from a guild." +#~ msgstr "" + +#~ msgid "The reason for the kick" +#~ msgstr "" + +#~ msgid "This method adds a role to a member." +#~ msgstr "" + +#~ msgid "The role to add. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are added" +#~ msgstr "" + +#~ msgid "This method removes a role from a member." +#~ msgstr "" + +#~ msgid "The role to remove. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are removed" +#~ msgstr "" + +#~ msgid "Sends a DM to the member." +#~ msgstr "" + +#~ msgid "The contents of the message as a string or string-converted value." +#~ msgstr "" + +#~ msgid "A component, or list of components for the message." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the message utilizes the " +#~ "text-to-speech Discord programme or " +#~ "not." +#~ msgstr "" + +#~ msgid "A file or list of files to be attached to the message." +#~ msgstr "" + +#~ msgid "An embed, or list of embeds for the message." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The sent message as an object." +#~ msgstr "" + +#~ msgid "Modifies the member of a guild." +#~ msgstr "" + +#~ msgid "The nickname of the member" +#~ msgstr "" + +#~ msgid "A list of all role ids the member has" +#~ msgstr "" + +#~ msgid "whether the user is muted in voice channels" +#~ msgstr "" + +#~ msgid "whether the user is deafened in voice channels" +#~ msgstr "" + +#~ msgid "id of channel to move user to (if they are connected to voice)" +#~ msgstr "" + +#~ msgid "" +#~ "when the user's timeout will expire " +#~ "and the user will be able to " +#~ "communicate in the guild again (up " +#~ "to 28 days in the future)" +#~ msgstr "" + +#~ msgid "The reason of the modifying" +#~ msgstr "" + +#~ msgid "The modified member object" +#~ msgstr "" + +#~ msgid "Adds the member to a thread." +#~ msgstr "" + +#~ msgid "The id of the thread to add the member to" +#~ msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.models.member.po b/docs/locale/it/LC_MESSAGES/api.models.member.po index ce23f99ac..f5839f391 100644 --- a/docs/locale/it/LC_MESSAGES/api.models.member.po +++ b/docs/locale/it/LC_MESSAGES/api.models.member.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.member.rst:4 msgid "Member Models" @@ -86,6 +86,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.modify #: interactions.api.models.member.Member.remove_role @@ -93,10 +95,20 @@ msgstr "" msgid "Parameters" msgstr "" +#: interactions.api.models.member.Member.guild_id:1 of +msgid "" +"Attempts to get the guild ID the member is in. Only works then roles or " +"nick or joined at is present. :return: The ID of the guild this member " +"belongs to." +msgstr "" + #: interactions.api.models.member.Member.id:1 of msgid "Returns the ID of the user." msgstr "" +#: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.mention #: interactions.api.models.member.Member.modify @@ -113,6 +125,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.mention @@ -148,11 +162,23 @@ msgid "The id of the guild to ban the member from" msgstr "" #: interactions.api.models.member.Member.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.member.Member.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.member.Member.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.member.Member.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.member.Member.ban:13 of +msgid "The reason of the ban" msgstr "" #: interactions.api.models.member.Member.kick:1 of @@ -230,7 +256,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.member.Member.send:15 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.member.Member.send:17 of @@ -288,9 +314,83 @@ msgid "The id of the thread to add the member to" msgstr "" #: interactions.api.models.member.Member.get_avatar_url:1 of +msgid "Returns the URL of the member's avatar for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:3 of +msgid "The id of the guild to get the member's avatar from" +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:5 of +msgid "URL of the members's avatar (None will be returned if no avatar is set)" +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:1 of +msgid "Returns the permissions of the member for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:4 of msgid "" -"Returns the URL of the member's avatar for the specified guild. :param " -"guild_id: The id of the guild to get the member's avatar from :type " -"guild_id: Union[int, Snowflake, \"Guild\"] :return: URL of the members's " -"avatar (None will be returned if no avatar is set) :rtype: str" +"The permissions returned by this function will not take into account role" +" and user overwrites that can be assigned to channels or categories. If " +"you need these overwrites, look into " +":meth:`.Channel.get_permissions_for`." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:8 of +msgid "The guild of the member" msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:10 of +msgid "Base permissions of the member in the specified guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:1 of +msgid "Returns whether the member has the permissions passed." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:4 of +msgid "" +"If the channel argument is present, the function will look if the member " +"has the permissions in the specified channel. If the argument is missing," +" then it will only consider the member's guild permissions." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:7 of +msgid "The list of permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:9 of +msgid "The channel where to check for permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:11 of +msgid "The id of the guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:13 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:15 of +msgid "Whether the member has the permissions" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "" +#~ "Returns the URL of the member's " +#~ "avatar for the specified guild. :param" +#~ " guild_id: The id of the guild " +#~ "to get the member's avatar from " +#~ ":type guild_id: Union[int, Snowflake, " +#~ "\"Guild\"] :return: URL of the members's" +#~ " avatar (None will be returned if " +#~ "no avatar is set) :rtype: str" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.models.message.po b/docs/locale/it/LC_MESSAGES/api.models.message.po index 5bcd77f9c..e1f033a87 100644 --- a/docs/locale/it/LC_MESSAGES/api.models.message.po +++ b/docs/locale/it/LC_MESSAGES/api.models.message.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.message.rst:4 msgid "Message Models" @@ -50,14 +50,14 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji #: interactions.api.models.message.Message #: interactions.api.models.message.MessageActivity #: interactions.api.models.message.MessageInteraction #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Variables" msgstr "" @@ -156,33 +156,33 @@ msgid "" msgstr "" #: interactions.api.models.message.Message:26 of -msgid "The allowed mentions of roles attached in the message." -msgstr "" - -#: interactions.api.models.message.Message:27 of msgid "Message flags" msgstr "" -#: interactions.api.models.message.Message:28 of +#: interactions.api.models.message.Message:27 of msgid "Message interaction object, if the message is sent by an interaction." msgstr "" -#: interactions.api.models.message.Message:29 of +#: interactions.api.models.message.Message:28 of msgid "" "The thread that started from this message, if any, with a thread member " "object embedded." msgstr "" +#: interactions.api.models.message.Message:29 of +msgid "Array of Action Rows associated with this message, if any." +msgstr "" + #: interactions.api.models.message.Message:30 of -msgid "Components associated with this message, if any." +msgid "An array of message sticker item objects, if sent with them." msgstr "" #: interactions.api.models.message.Message:31 of -msgid "An array of message sticker item objects, if sent with them." +msgid "Array of sticker objects sent with the message if any. Deprecated." msgstr "" #: interactions.api.models.message.Message:32 of -msgid "Array of sticker objects sent with the message if any. Deprecated." +msgid "The approximate position of the message in a thread." msgstr "" #: interactions.api.models.message.Attachment @@ -202,10 +202,6 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild #: interactions.api.models.message.Message #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread @@ -222,7 +218,8 @@ msgstr "" #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Parameters" msgstr "" @@ -230,6 +227,7 @@ msgstr "" msgid "Gets the channel where the message was sent." msgstr "" +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Embed.add_field #: interactions.api.models.message.Embed.clear_fields #: interactions.api.models.message.Embed.insert_field_at @@ -241,13 +239,10 @@ msgstr "" #: interactions.api.models.message.Embed.set_image #: interactions.api.models.message.Embed.set_thumbnail #: interactions.api.models.message.Embed.set_video -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread #: interactions.api.models.message.Message.delete +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_channel #: interactions.api.models.message.Message.get_from_url @@ -307,7 +302,7 @@ msgstr "" #: interactions.api.models.message.Message.edit:13 #: interactions.api.models.message.Message.reply:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.message.Message.edit:15 @@ -323,10 +318,9 @@ msgid "" "components will be removed" msgstr "" -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Message.create_thread +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_from_url #: interactions.api.models.message.Message.get_users_from_reaction @@ -466,6 +460,14 @@ msgstr "" msgid "The URL of said message" msgstr "" +#: interactions.api.models.message.Message.disable_all_components:1 of +msgid "Sets all components to disabled on this message." +msgstr "" + +#: interactions.api.models.message.Message.disable_all_components:3 of +msgid "The modified message." +msgstr "" + #: interactions.api.models.message.MessageReference:1 of msgid "A class object representing the \"referenced\"/replied message." msgstr "" @@ -654,20 +656,26 @@ msgstr "" msgid "Inserts a field in the embed at the specified index" msgstr "" -#: interactions.api.models.message.Embed.insert_field_at:3 -#: interactions.api.models.message.Embed.remove_field:3 -#: interactions.api.models.message.Embed.set_field_at:3 of -msgid "The new field's index" +#: interactions.api.models.message.Embed.insert_field_at:3 of +msgid "The field's index to insert" msgstr "" #: interactions.api.models.message.Embed.set_field_at:1 of msgid "Overwrites the field in the embed at the specified index" msgstr "" +#: interactions.api.models.message.Embed.set_field_at:3 of +msgid "The field's index to overwrite" +msgstr "" + #: interactions.api.models.message.Embed.remove_field:1 of msgid "Remove field at the specified index" msgstr "" +#: interactions.api.models.message.Embed.remove_field:3 of +msgid "The field's index to remove" +msgstr "" + #: interactions.api.models.message.Embed.remove_author:1 of msgid "Removes the embed's author" msgstr "" @@ -906,95 +914,12 @@ msgstr "" msgid "Whether the attachment is ephemeral." msgstr "" -#: interactions.api.models.message.Emoji:1 of -msgid "A class objecting representing an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji:3 of -msgid "Emoji id" -msgstr "" - -#: interactions.api.models.message.Emoji:4 of -msgid "Emoji name." -msgstr "" - -#: interactions.api.models.message.Emoji:5 of -msgid "Roles allowed to use this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:6 of -msgid "User that created this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:7 of -msgid "Status denoting of this emoji must be wrapped in colons" -msgstr "" - -#: interactions.api.models.message.Emoji:8 of -msgid "Status denoting if this emoji is managed (by an integration)" -msgstr "" - -#: interactions.api.models.message.Emoji:9 of -msgid "Status denoting if this emoji is animated" -msgstr "" - -#: interactions.api.models.message.Emoji:10 of -msgid "" -"Status denoting if this emoji can be used. (Can be false via server " -"boosting)" -msgstr "" - -#: interactions.api.models.message.Emoji.get:1 of -msgid "Gets an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.get:3 of -msgid "The id of the guild of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:5 of -msgid "The id of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:7 -#: interactions.api.models.message.Emoji.get_all_of_guild:5 of -msgid "The HTTPClient of your bot. Equals to ``bot._http``" -msgstr "" - -#: interactions.api.models.message.Emoji.get:9 of -msgid "The Emoji as object" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:1 of -msgid "Gets all emoji of a guild." +#: interactions.api.models.message.Attachment.download:1 of +msgid "Downloads the attachment." msgstr "" -#: interactions.api.models.message.Emoji.get_all_of_guild:3 of -msgid "The id of the guild to get the emojis of" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:7 of -msgid "The Emoji as list" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:1 of -msgid "Deletes the emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.delete:3 of -msgid "The guild id to delete the emoji from" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:5 of -msgid "The reason of the deletion" -msgstr "" - -#: interactions.api.models.message.Emoji.url:1 of -msgid "Returns the emoji's URL." -msgstr "" - -#: interactions.api.models.message.Emoji.url:3 of -msgid "URL of the emoji" +#: interactions.api.models.message.Attachment.download:3 of +msgid "The attachment's bytes as BytesIO object" msgstr "" #: interactions.api.models.message.EmbedFooter:1 of @@ -1093,3 +1018,116 @@ msgstr "" #: interactions.api.models.message.Sticker:14 of msgid "The standard sticker's sort order within its pack" msgstr "" + +#: interactions.api.models.message.StickerPack:1 of +msgid "A class objects representing a pack of stickers." +msgstr "" + +#: interactions.api.models.message.StickerPack:3 of +msgid "ID of the sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:4 of +msgid "The stickers in the pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:5 of +msgid "The name of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:6 of +msgid "ID of the pack's SKU." +msgstr "" + +#: interactions.api.models.message.StickerPack:7 of +msgid "ID of a sticker in the pack which is shown as the pack's icon." +msgstr "" + +#: interactions.api.models.message.StickerPack:8 of +msgid "The description of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:9 of +msgid "ID of the sticker pack's banner image." +msgstr "" + +#~ msgid "The allowed mentions of roles attached in the message." +#~ msgstr "" + +#~ msgid "Components associated with this message, if any." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The new field's index" +#~ msgstr "" + +#~ msgid "A class objecting representing an emoji." +#~ msgstr "" + +#~ msgid "Emoji id" +#~ msgstr "" + +#~ msgid "Emoji name." +#~ msgstr "" + +#~ msgid "Roles allowed to use this emoji" +#~ msgstr "" + +#~ msgid "User that created this emoji" +#~ msgstr "" + +#~ msgid "Status denoting of this emoji must be wrapped in colons" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is managed (by an integration)" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is animated" +#~ msgstr "" + +#~ msgid "" +#~ "Status denoting if this emoji can " +#~ "be used. (Can be false via server" +#~ " boosting)" +#~ msgstr "" + +#~ msgid "Gets an emoji." +#~ msgstr "" + +#~ msgid "The id of the guild of the emoji" +#~ msgstr "" + +#~ msgid "The id of the emoji" +#~ msgstr "" + +#~ msgid "The HTTPClient of your bot. Equals to ``bot._http``" +#~ msgstr "" + +#~ msgid "The Emoji as object" +#~ msgstr "" + +#~ msgid "Gets all emoji of a guild." +#~ msgstr "" + +#~ msgid "The id of the guild to get the emojis of" +#~ msgstr "" + +#~ msgid "The Emoji as list" +#~ msgstr "" + +#~ msgid "Deletes the emoji." +#~ msgstr "" + +#~ msgid "The guild id to delete the emoji from" +#~ msgstr "" + +#~ msgid "The reason of the deletion" +#~ msgstr "" + +#~ msgid "Returns the emoji's URL." +#~ msgstr "" + +#~ msgid "URL of the emoji" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.models.misc.po b/docs/locale/it/LC_MESSAGES/api.models.misc.po index cfed122db..77ec620aa 100644 --- a/docs/locale/it/LC_MESSAGES/api.models.misc.po +++ b/docs/locale/it/LC_MESSAGES/api.models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.misc.rst:4 msgid "Miscellanous Models" @@ -27,6 +27,7 @@ msgstr "" msgid "An enumeration." msgstr "" +#: interactions.api.models.misc.AllowedMentionType #: interactions.api.models.misc.AutoModKeywordPresetTypes #: interactions.api.models.misc.AutoModTriggerType of msgid "Member Type" @@ -37,6 +38,7 @@ msgstr "" msgid ":py:class:`int`" msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 #: interactions.api.models.misc.AutoModKeywordPresetTypes:1 #: interactions.api.models.misc.AutoModTriggerType:1 of msgid "Valid values are as follows:" @@ -50,6 +52,7 @@ msgstr "" msgid "The maximum duration for duration_seconds is 2419200 seconds, aka 4 weeks." msgstr "" +#: interactions.api.models.misc.AllowedMentions #: interactions.api.models.misc.AutoModAction #: interactions.api.models.misc.AutoModMetaData #: interactions.api.models.misc.AutoModTriggerMetadata @@ -66,15 +69,6 @@ msgstr "" msgid "Timeout duration in seconds, if timed out." msgstr "" -#: interactions.api.models.misc.AutoModAction -#: interactions.api.models.misc.AutoModMetaData -#: interactions.api.models.misc.AutoModTriggerMetadata -#: interactions.api.models.misc.ClientStatus interactions.api.models.misc.File -#: interactions.api.models.misc.Image interactions.api.models.misc.Overwrite -#: interactions.api.models.misc.Snowflake of -msgid "Parameters" -msgstr "" - #: interactions.api.models.misc.AutoModAction:1 of msgid "" "A class object used for the ``AUTO_MODERATION_ACTION_EXECUTION`` event. " @@ -107,6 +101,53 @@ msgstr "" msgid "The internally pre-defined wordsets which will be searched for in content." msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "An enumerable object representing the allowed mention types" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:1 of +msgid "A class object representing the allowed mentions object" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:3 of +msgid "" +"Optional[List[AllowedMentionType]]: An array of allowed mention types to " +"parse from the content." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:4 of +msgid "Optional[List[int]]: An array of user ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:5 of +msgid "Optional[List[int]]: An array of role ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:6 of +msgid "" +"Optional[bool]: For replies, whether to mention the author of the message" +" being replied to." +msgstr "" + #: interactions.api.models.misc.Snowflake:1 of msgid "The Snowflake object." msgstr "" @@ -129,17 +170,6 @@ msgid "" "integer." msgstr "" -#: interactions.api.models.misc.Color.black -#: interactions.api.models.misc.Color.blurple -#: interactions.api.models.misc.Color.fuchsia -#: interactions.api.models.misc.Color.green -#: interactions.api.models.misc.Color.red -#: interactions.api.models.misc.Color.white -#: interactions.api.models.misc.Color.yellow -#: interactions.api.models.misc.Snowflake of -msgid "Return type" -msgstr "" - #: interactions.api.models.misc.Snowflake.increment:1 of msgid "" "This is the 'Increment' portion of the snowflake. This is incremented for" @@ -199,6 +229,16 @@ msgstr "" msgid "Returns a hexadecimal value of the blurple color." msgstr "" +#: interactions.api.models.misc.Color.black +#: interactions.api.models.misc.Color.blurple +#: interactions.api.models.misc.Color.fuchsia +#: interactions.api.models.misc.Color.green +#: interactions.api.models.misc.Color.red +#: interactions.api.models.misc.Color.white +#: interactions.api.models.misc.Color.yellow of +msgid "Return type" +msgstr "" + #: interactions.api.models.misc.Color.green:1 of msgid "Returns a hexadecimal value of the green color." msgstr "" @@ -287,3 +327,6 @@ msgstr "" #: interactions.api.models.misc.Overwrite:6 of msgid "Permission bit set." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.models.presence.po b/docs/locale/it/LC_MESSAGES/api.models.presence.po index 347c24dbc..cfbae19fa 100644 --- a/docs/locale/it/LC_MESSAGES/api.models.presence.po +++ b/docs/locale/it/LC_MESSAGES/api.models.presence.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.presence.rst:4 msgid "Presence Models" @@ -43,15 +43,6 @@ msgstr "" msgid "An array denoting the party's current and max size" msgstr "" -#: interactions.api.models.presence.ClientPresence -#: interactions.api.models.presence.PresenceActivity -#: interactions.api.models.presence.PresenceAssets -#: interactions.api.models.presence.PresenceParty -#: interactions.api.models.presence.PresenceSecrets -#: interactions.api.models.presence.PresenceTimestamp of -msgid "Parameters" -msgstr "" - #: interactions.api.models.presence.PresenceAssets:1 of msgid "A class object representing the assets of a presence." msgstr "" @@ -231,3 +222,6 @@ msgstr "" #: interactions.api.models.presence.ClientPresence:6 of msgid "Whether the client is afk or not." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.models.role.po b/docs/locale/it/LC_MESSAGES/api.models.role.po index c78eeec53..4828e3cfc 100644 --- a/docs/locale/it/LC_MESSAGES/api.models.role.po +++ b/docs/locale/it/LC_MESSAGES/api.models.role.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.role.rst:4 msgid "Role Models" @@ -130,6 +130,12 @@ msgstr "" msgid "RGB color value as integer, defaults to the current value of the role" msgstr "" +#: interactions.api.models.role.Role.modify:9 of +msgid "" +"Bitwise value of the enabled/disabled permissions, defaults to the " +"current value of the role" +msgstr "" + #: interactions.api.models.role.Role.modify:11 of msgid "" "Whether the role should be displayed separately in the sidebar, defaults " diff --git a/docs/locale/it/LC_MESSAGES/api.models.team.po b/docs/locale/it/LC_MESSAGES/api.models.team.po index 2958a4252..36accb3a5 100644 --- a/docs/locale/it/LC_MESSAGES/api.models.team.po +++ b/docs/locale/it/LC_MESSAGES/api.models.team.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.team.rst:4 msgid "Team Models" @@ -51,11 +51,6 @@ msgstr "" msgid "The User ID of the current team owner" msgstr "" -#: interactions.api.models.team.Application interactions.api.models.team.Team -#: interactions.api.models.team.TeamMember of -msgid "Parameters" -msgstr "" - #: interactions.api.models.team.TeamMember:1 of msgid "A class object representing the member of a team." msgstr "" @@ -183,3 +178,6 @@ msgstr "" #: interactions.api.models.team.Application.icon_url of msgid "Return type" msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.models.user.po b/docs/locale/it/LC_MESSAGES/api.models.user.po index 5721c56da..00f10cc86 100644 --- a/docs/locale/it/LC_MESSAGES/api.models.user.po +++ b/docs/locale/it/LC_MESSAGES/api.models.user.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.user.rst:4 msgid "User Models" @@ -94,17 +94,14 @@ msgstr "" msgid "The user's public flags" msgstr "" -#: interactions.api.models.user.User of -msgid "Parameters" -msgstr "" - #: interactions.api.models.user.User.mention:1 of msgid "Returns a string that allows you to mention the given user." msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Returns" msgstr "" @@ -114,7 +111,8 @@ msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Return type" msgstr "" @@ -133,3 +131,14 @@ msgstr "" #: interactions.api.models.user.User.banner_url:3 of msgid "URL of the user's banner (None will be returned if no banner is set)" msgstr "" + +#: interactions.api.models.user.User.presence:1 of +msgid "Returns the presence of the user." +msgstr "" + +#: interactions.api.models.user.User.presence:3 of +msgid "Presence of the user (None will be returned if not cached)" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/api.models.webhook.po b/docs/locale/it/LC_MESSAGES/api.models.webhook.po index be10a2fd1..906a172a9 100644 --- a/docs/locale/it/LC_MESSAGES/api.models.webhook.po +++ b/docs/locale/it/LC_MESSAGES/api.models.webhook.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.webhook.rst:4 msgid "Webhook Models" @@ -209,7 +209,7 @@ msgid "embedded ``rich`` content" msgstr "" #: interactions.api.models.webhook.Webhook.execute:18 of -msgid "allowed mentions for the message" +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.webhook.Webhook.execute:20 of @@ -257,3 +257,6 @@ msgstr "" #: interactions.api.models.webhook.WebhookType:1 of msgid "Valid values are as follows:" msgstr "" + +#~ msgid "allowed mentions for the message" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/client.po b/docs/locale/it/LC_MESSAGES/client.po index 854019fc5..48424e61c 100644 --- a/docs/locale/it/LC_MESSAGES/client.po +++ b/docs/locale/it/LC_MESSAGES/client.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../client.rst:4 msgid "Bot Client" @@ -31,10 +31,6 @@ msgstr "" #: interactions.client.bot.Client #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence @@ -44,6 +40,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.user_command #: interactions.client.bot.Extension of msgid "Parameters" @@ -80,60 +77,73 @@ msgid "" "automatic or not." msgstr "" +#: interactions.client.bot.Client:15 of +msgid "" +"Set to ``True`` to enable debug logging or set to a log level to use a " +"specific level" +msgstr "" + #: interactions.client.bot.Client of msgid "Variables" msgstr "" -#: interactions.client.bot.Client:16 of +#: interactions.client.bot.Client:18 of msgid "The asynchronous event loop of the client." msgstr "" -#: interactions.client.bot.Client:17 of +#: interactions.client.bot.Client:19 of msgid "" "The user-facing HTTP connection to the Web API, as its own separate " "client." msgstr "" -#: interactions.client.bot.Client:18 of +#: interactions.client.bot.Client:20 of msgid "An object-orientation of a websocket server connection to the Gateway." msgstr "" -#: interactions.client.bot.Client:19 of +#: interactions.client.bot.Client:21 of msgid "The Gateway intents of the application. Defaults to ``Intents.DEFAULT``." msgstr "" -#: interactions.client.bot.Client:20 of +#: interactions.client.bot.Client:22 of msgid "The list of bucketed shards for the application's connection." msgstr "" -#: interactions.client.bot.Client:21 of +#: interactions.client.bot.Client:23 of msgid "The RPC-like presence shown on an application once connected." msgstr "" -#: interactions.client.bot.Client:22 of +#: interactions.client.bot.Client:24 of msgid "The token of the application used for authentication when connecting." msgstr "" -#: interactions.client.bot.Client:23 of +#: interactions.client.bot.Client:25 of msgid "The \"extensions\" or cog equivalence registered to the main client." msgstr "" -#: interactions.client.bot.Client:24 of +#: interactions.client.bot.Client:26 of msgid "The application representation of the client." msgstr "" -#: interactions.client.bot.Client +#: interactions.client.bot.Client.guilds:1 of +msgid "Returns a list of guilds the bot is in." +msgstr "" + +#: interactions.client.bot.Client.latency:1 of +msgid "Returns the connection latency in milliseconds." +msgstr "" + +#: interactions.client.bot.Client.start:1 of +msgid "Starts the client session." +msgstr "" + #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create -#: interactions.client.bot.Client.__register_events #: interactions.client.bot.Client.__resolve_commands #: interactions.client.bot.Client.__sync #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client._login interactions.client.bot.Client._ready +#: interactions.client.bot.Client._stop #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence #: interactions.client.bot.Client.command @@ -142,6 +152,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.start #: interactions.client.bot.Client.user_command #: interactions.client.bot.Client.wait_until_ready @@ -149,22 +160,6 @@ msgstr "" msgid "Return type" msgstr "" -#: interactions.client.bot.Client.guilds:1 of -msgid "Returns a list of guilds the bot is in." -msgstr "" - -#: interactions.client.bot.Client.latency:1 of -msgid "Returns the connection latency in milliseconds." -msgstr "" - -#: interactions.client.bot.Client.start:1 of -msgid "Starts the client session." -msgstr "" - -#: interactions.client.bot.Client.__register_events:1 of -msgid "Registers all raw gateway events to the known events." -msgstr "" - #: interactions.client.bot.Client.__compare_sync:1 of msgid "Compares an application command during the synchronization process." msgstr "" @@ -178,10 +173,6 @@ msgid "The \"pool\" or list of commands to compare from." msgstr "" #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.command @@ -204,6 +195,10 @@ msgid "" "conditions have been met in a chronological order:" msgstr "" +#: interactions.client.bot.Client._stop:1 of +msgid "Stops the websocket connection gracefully." +msgstr "" + #: interactions.client.bot.Client._login:1 of msgid "Makes a login with the Discord API." msgstr "" @@ -448,7 +443,7 @@ msgid "" msgstr "" #: interactions.client.bot.Client._find_command:3 of -msgid "The name of the command to match" +msgid "The name or ID of the command to match" msgstr "" #: interactions.client.bot.Client._find_command:5 of @@ -574,59 +569,34 @@ msgstr "" msgid "The modified User object" msgstr "" -#: interactions.client.bot.Client.__raw_socket_create:1 of -msgid "" -"This is an internal function that takes any gateway socket event and then" -" returns the data purely based off of what it does in the client " -"instantiation class." -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:5 of -msgid "The data that is returned" -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:7 of -msgid "A dictionary of raw data." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:1 of -msgid "" -"This is an internal function that caches the channel creates when " -"dispatched." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:3 of -msgid "The channel object data in question." +#: interactions.client.bot.Client.request_guild_members:1 of +msgid "Requests guild members via websocket." msgstr "" -#: interactions.client.bot.Client.__raw_channel_create:5 of -msgid "The channel as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:3 of +msgid "ID of the guild to get members for." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:1 of +#: interactions.client.bot.Client.request_guild_members:5 of msgid "" -"This is an internal function that caches the message creates when " -"dispatched." +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:3 of -msgid "The message object data in question." +#: interactions.client.bot.Client.request_guild_members:7 of +msgid "String that username starts with." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:5 of -msgid "The message as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:1 of -msgid "This is an internal function that caches the guild creates on ready." +#: interactions.client.bot.Client.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:3 of -msgid "The guild object data in question." -msgstr "" - -#: interactions.client.bot.Client.__raw_guild_create:5 of -msgid "The guild as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." msgstr "" #: interactions.client.bot.Extension:1 of @@ -639,3 +609,56 @@ msgstr "" #: interactions.client.bot.Extension:5 of msgid "The structure of an extension:" msgstr "" + +#~ msgid "Registers all raw gateway events to the known events." +#~ msgstr "" + +#~ msgid "The name of the command to match" +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "takes any gateway socket event and " +#~ "then returns the data purely based " +#~ "off of what it does in the " +#~ "client instantiation class." +#~ msgstr "" + +#~ msgid "The data that is returned" +#~ msgstr "" + +#~ msgid "A dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the channel creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The channel object data in question." +#~ msgstr "" + +#~ msgid "The channel as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the message creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The message object data in question." +#~ msgstr "" + +#~ msgid "The message as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "This is an internal function that caches the guild creates on ready." +#~ msgstr "" + +#~ msgid "The guild object data in question." +#~ msgstr "" + +#~ msgid "The guild as a dictionary of raw data." +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/context.po b/docs/locale/it/LC_MESSAGES/context.po index 3917f5b73..8352a5d3e 100644 --- a/docs/locale/it/LC_MESSAGES/context.po +++ b/docs/locale/it/LC_MESSAGES/context.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../context.rst:4 msgid "Event Context" @@ -55,7 +55,6 @@ msgstr "" msgid "The guild data model." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update #: interactions.client.context.CommandContext #: interactions.client.context.CommandContext.defer #: interactions.client.context.CommandContext.edit @@ -63,12 +62,15 @@ msgstr "" #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context #: interactions.client.context._Context.edit +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup -#: interactions.client.context._Context.send of +#: interactions.client.context._Context.send +#: interactions.utils.attrs_utils.DictSerializerMixin.update of msgid "Parameters" msgstr "" @@ -79,11 +81,13 @@ msgstr "" #: interactions.client.context.CommandContext.edit #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.send of msgid "Returns" msgstr "" @@ -98,11 +102,13 @@ msgstr "" #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup #: interactions.client.context._Context.send of msgid "Return type" @@ -153,7 +159,7 @@ msgstr "" #: interactions.client.context.CommandContext.send:12 #: interactions.client.context.ComponentContext.send:12 #: interactions.client.context._Context.send:12 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.client.context.CommandContext.send:14 @@ -171,6 +177,12 @@ msgstr "" #: interactions.client.context.CommandContext.send:18 #: interactions.client.context.ComponentContext.send:18 #: interactions.client.context._Context.send:18 of +msgid "Whether embeds are not shown in the message." +msgstr "" + +#: interactions.client.context.CommandContext.send:20 +#: interactions.client.context.ComponentContext.send:20 +#: interactions.client.context._Context.send:20 of msgid "The sent message as an object." msgstr "" @@ -197,13 +209,39 @@ msgstr "" msgid "The components you wish to show." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:1 of +#: interactions.client.context._Context.has_permissions:1 of +msgid "" +"Returns whether the author of the interaction has the permissions in the " +"given context." +msgstr "" + +#: interactions.client.context._Context.has_permissions:3 of +msgid "The list of permissions" +msgstr "" + +#: interactions.client.context._Context.has_permissions:5 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.client.context._Context.has_permissions:7 of +msgid "Whether the author has the permissions" +msgstr "" + +#: ../../docstring interactions.client.context.CommandContext._extras:1 +#: interactions.client.context.ComponentContext._extras:1 +#: interactions.client.context._Context._extras:1 of +msgid "A dict containing values that were not serialized from Discord." +msgstr "" + +#: interactions.utils.attrs_utils.DictSerializerMixin.update:1 of msgid "" "Update an object with new attributes. All data will be converted, and any" " extra attributes will be put in _extras" msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:4 of +#: interactions.utils.attrs_utils.DictSerializerMixin.update:4 of msgid "The dictionary to update from" msgstr "" @@ -286,6 +324,18 @@ msgid "" " was sent from." msgstr "" +#: interactions.client.context.CommandContext:30 of +msgid "The client instance that the command belongs to." +msgstr "" + +#: interactions.client.context.CommandContext:31 of +msgid "The command object that is being invoked." +msgstr "" + +#: interactions.client.context.CommandContext:32 of +msgid "The extension the command belongs to." +msgstr "" + #: interactions.client.context.CommandContext.defer:1 of msgid "" "This \"defers\" an interaction response, allowing up to a 15-minute delay" @@ -342,3 +392,31 @@ msgstr "" #: interactions.client.context.ComponentContext.defer:6 of msgid "Whether you want to edit the original message or send a followup message" msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:1 of +msgid "Disables all components of the message." +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:3 of +msgid "" +"Whether the components should be disabled in an interaction response, " +"default True" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:5 of +msgid "" +"Additional keyword-arguments to pass to the edit method. This only works " +"when this method is used as interaction response and takes the same " +"arguments as :meth:`interactions.client.context._Context:edit()`" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:8 of +msgid "The modified Message" +msgstr "" + +#: interactions.client.context.ComponentContext.label:1 of +msgid "The label of the interacted button. :rtype: Optional[str]" +msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/events.po b/docs/locale/it/LC_MESSAGES/events.po index b91a1dc02..7b4ecba7d 100644 --- a/docs/locale/it/LC_MESSAGES/events.po +++ b/docs/locale/it/LC_MESSAGES/events.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../events.rst:2 msgid "Event Documentation" @@ -98,99 +98,104 @@ msgid "``on_command``" msgstr "" #: ../../events.rst:57 -msgid "``on_component``" +msgid "``on_command_error``" msgstr "" #: ../../events.rst:58 -msgid "``on_autocomplete``" +msgid "``on_component``" msgstr "" #: ../../events.rst:59 +msgid "``on_autocomplete``" +msgstr "" + +#: ../../events.rst:60 msgid "``on_modal``" msgstr "" -#: ../../events.rst:61 +#: ../../events.rst:62 msgid "Lets now have a look at those events in detail:" msgstr "" -#: ../../events.rst:64 +#: ../../events.rst:65 msgid "Event: ``raw_socket_create``" msgstr "" -#: ../../events.rst:65 +#: ../../events.rst:66 msgid "" "This event fires on any event sent by Discord, including ``Typing Start``" " and ``Voice State Update``. ``Hello``, ``Resumed``, ``Reconnect`` and " "``Invalid Session`` still will not be dispatched." msgstr "" -#: ../../events.rst:68 +#: ../../events.rst:69 msgid "" -"The function handling the event should take in one argument, the type of " -"this argument is a ``dict``." +"A function handling an event should take two arguments, the first " +"argument is the name of the event, the second is the data of that event " +"with type ``dict``." msgstr "" -#: ../../events.rst:70 +#: ../../events.rst:72 msgid "" -"The value of the argument will be the *raw* data sent from Discord, so it" -" is not recommended to use that event as long as you don't absolutely " -"need it." +"The value of the second argument will be the *raw* data sent from " +"Discord, so it is not recommended to use that event as long as you don't " +"absolutely need it." msgstr "" -#: ../../events.rst:75 +#: ../../events.rst:77 msgid "Event: ``on_start``" msgstr "" -#: ../../events.rst:76 +#: ../../events.rst:78 msgid "This event fires only when the bot is started." msgstr "" -#: ../../events.rst:78 ../../events.rst:161 +#: ../../events.rst:80 ../../events.rst:173 msgid "This function takes no arguments." msgstr "" -#: ../../events.rst:81 +#: ../../events.rst:83 msgid "Unlike ``on_ready``, this event will never be dispatched more than once." msgstr "" -#: ../../events.rst:84 +#: ../../events.rst:86 msgid "Event: ``on_interaction``" msgstr "" -#: ../../events.rst:85 +#: ../../events.rst:87 msgid "" "This event fires on any interaction (commands, components, autocomplete " "and modals)." msgstr "" -#: ../../events.rst:87 +#: ../../events.rst:89 msgid "" "The function needs one argument. It will have the type ``CommandContext``" " or ``ComponentContext``." msgstr "" -#: ../../events.rst:89 +#: ../../events.rst:91 msgid "" "Because you will have to check for everything, from the " "``InteractionType`` to any data inside the context, we do not recommend " "using this event unless you have experience with it." msgstr "" -#: ../../events.rst:94 +#: ../../events.rst:96 msgid "Event: ``on_command``" msgstr "" -#: ../../events.rst:95 +#: ../../events.rst:97 msgid "" "This event fires on any Application Command (slash command + context menu" " command) used." msgstr "" -#: ../../events.rst:97 ../../events.rst:117 ../../events.rst:127 +#: ../../events.rst:99 ../../events.rst:129 ../../events.rst:139 msgid "The function takes in one argument of the type ``CommandContext``." msgstr "" -#: ../../events.rst:99 +#: ../../events.rst:101 msgid "" "Using this event, you will have to manually check everything, from name " "to whether the used commands have sub commands, options or anything else " @@ -198,138 +203,174 @@ msgid "" "it" msgstr "" -#: ../../events.rst:104 +#: ../../events.rst:106 +msgid "Event: ``on_command_error``" +msgstr "" + +#: ../../events.rst:107 +msgid "This event fires when the following conditions are met:" +msgstr "" + +#: ../../events.rst:109 +msgid "There is an error in the command (or subcommand within the command)" +msgstr "" + +#: ../../events.rst:110 +msgid "There is no error callback assigned to that command" +msgstr "" + +#: ../../events.rst:112 +msgid "" +"The function takes in two arguments, one of the type ``CommandContext``, " +"and the other contains the error." +msgstr "" + +#: ../../events.rst:116 msgid "Event: ``on_component``" msgstr "" -#: ../../events.rst:105 +#: ../../events.rst:117 msgid "" "This event fires on any Component used (for now, those are Buttons and " "Select Menus)." msgstr "" -#: ../../events.rst:107 +#: ../../events.rst:119 msgid "The function takes in one argument of the type ``ComponentContext``." msgstr "" -#: ../../events.rst:109 +#: ../../events.rst:121 msgid "" "Like ``on_command``, you will have to manually check for everything, i.e " "for custom id and component type. Also, you will have to look through the" " argument to find the selected choices, if you have a select menu." msgstr "" -#: ../../events.rst:114 +#: ../../events.rst:126 msgid "Event: ``on_autocomplete``" msgstr "" -#: ../../events.rst:115 +#: ../../events.rst:127 msgid "This event fires on any autocomplete triggered." msgstr "" -#: ../../events.rst:119 +#: ../../events.rst:131 msgid "" "As already in the events above, you will have to get the important values" " yourself. Those values are here the autocompleted option and the user " "input." msgstr "" -#: ../../events.rst:124 +#: ../../events.rst:136 msgid "Event: ``on_modal``" msgstr "" -#: ../../events.rst:125 +#: ../../events.rst:137 msgid "This event fires on every modal that is submitted." msgstr "" -#: ../../events.rst:129 +#: ../../events.rst:141 msgid "" "You will have to get all values yourself and check what modal was used " "when using this event." msgstr "" -#: ../../events.rst:132 +#: ../../events.rst:144 msgid "" "Additionally, if you struggle with getting the values, you can check " ":ref:`how it is handled internally `." msgstr "" -#: ../../events.rst:136 +#: ../../events.rst:148 msgid "After this, let us look at events from the Discord API." msgstr "" -#: ../../events.rst:139 +#: ../../events.rst:151 msgid "Discord API Events" msgstr "" -#: ../../events.rst:141 +#: ../../events.rst:153 msgid "" "Events in this section do not match the name needed to put into the " "function. Please check :ref:`above ` for how to get the correct name." msgstr "" -#: ../../events.rst:145 +#: ../../events.rst:157 msgid "" "There are a lot of events dispatched by the Discord API. All of those can" " be found `here`_." msgstr "" -#: ../../events.rst:147 +#: ../../events.rst:159 msgid "" "The events ``HELLO``, ``RESUMED``, ``RECONNECT``, ``INVALID SESSION`` and" " ``TYPING START`` are not dispatched by the library." msgstr "" -#: ../../events.rst:149 +#: ../../events.rst:161 msgid "" "``TYPING START`` will be included in the raw socket create event. You can" " also listen for it if you choose to subclass the WebSocketClient" msgstr "" -#: ../../events.rst:152 +#: ../../events.rst:164 msgid "" "The event ``VOICE STATE UPDATE`` can be only received with the voice " ":ref:`Extension `." msgstr "" -#: ../../events.rst:155 +#: ../../events.rst:167 msgid "Let's now have a look at a few events:" msgstr "" -#: ../../events.rst:158 +#: ../../events.rst:170 msgid "Event: ``READY``" msgstr "" -#: ../../events.rst:159 +#: ../../events.rst:171 msgid "" "This event fires whenever ``READY`` is dispatched by Discord. This " "happens when connecting to the web socket server." msgstr "" -#: ../../events.rst:164 +#: ../../events.rst:176 msgid "" "Due to the bot reconnecting during runtime, ``on_ready`` will be " "dispatched multiple times. If you rely on ``on_ready`` to do certain " "things once, check against a global variable as shown below:" msgstr "" -#: ../../events.rst:181 +#: ../../events.rst:193 msgid "Events: ``GUILD MEMBER UPDATE`` and ``GUILD MEMBER ADD``" msgstr "" -#: ../../events.rst:182 +#: ../../events.rst:194 msgid "" "These events fire whenever a member joins a guild or a member of a guild " "gets modified." msgstr "" -#: ../../events.rst:184 +#: ../../events.rst:196 msgid "The function takes in one argument of the type ``GuildMember``." msgstr "" -#: ../../events.rst:186 +#: ../../events.rst:198 msgid "" "The argument has the same methods as a normal ``Member`` object, except " "the methods *do not take in a guild id*. Please keep that in mind when " "using this event." msgstr "" + +#~ msgid "" +#~ "The function handling the event should" +#~ " take in one argument, the type " +#~ "of this argument is a ``dict``." +#~ msgstr "" + +#~ msgid "" +#~ "The value of the argument will be" +#~ " the *raw* data sent from Discord," +#~ " so it is not recommended to " +#~ "use that event as long as you " +#~ "don't absolutely need it." +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/faq.po b/docs/locale/it/LC_MESSAGES/faq.po index 1bf421161..09e3ae8c9 100644 --- a/docs/locale/it/LC_MESSAGES/faq.po +++ b/docs/locale/it/LC_MESSAGES/faq.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../faq.rst:2 msgid "Frequently Asked Questions" @@ -283,12 +283,12 @@ msgstr "" #: ../../faq.rst:157 msgid "" -"A `voice client`_ - which is still WIP, but it is able to listen for the " +"`voice client`_ - which is still WIP, but it is able to listen for the " "``VOICE_STATE_UPDATE`` event." msgstr "" #: ../../faq.rst:158 -msgid "An `autosharder`_ for automatic sharding" +msgid "`autosharder`_ for automatic sharding" msgstr "" #: ../../faq.rst:159 @@ -310,146 +310,148 @@ msgid "`enhanced`_ which enhances the DX in general" msgstr "" #: ../../faq.rst:163 -msgid "A `paginator`_ for paginating embeds on messages using components" +msgid "`paginator`_ for paginating embeds on messages using components" msgstr "" #: ../../faq.rst:164 msgid "" -"`persistence`_ - for storing data inside your custom IDs (as an " -"alternative to ``wait_for``)" +"`persistence`_ for storing data inside your custom IDs (as an alternative" +" to ``wait_for``)" msgstr "" #: ../../faq.rst:165 -msgid "And a `boilerplate`_" +msgid "`lavalink`_ for voice sending and listening ``VOICE_STATE_UPDATE`` event" +msgstr "" + +#: ../../faq.rst:166 +msgid "`fastapi`_ for building own API" msgstr "" #: ../../faq.rst:167 +msgid "And a `boilerplate`_" +msgstr "" + +#: ../../faq.rst:169 msgid "" "Below are a few unofficial exts (for the time being) which implement some" " functionality similar to what d.py had:" msgstr "" -#: ../../faq.rst:169 +#: ../../faq.rst:171 msgid "`checks and cooldowns`_" msgstr "" -#: ../../faq.rst:170 +#: ../../faq.rst:172 msgid "`tasks`_" msgstr "" -#: ../../faq.rst:171 -msgid "" -"`get`_ for getting objects from the discord API (will be implemented into" -" the core library at a later time)" -msgstr "" - -#: ../../faq.rst:173 +#: ../../faq.rst:174 msgid "Usage examples can usually be found at the linked page" msgstr "" -#: ../../faq.rst:177 +#: ../../faq.rst:178 msgid "Can I make an Extension Library myself?" msgstr "" -#: ../../faq.rst:178 +#: ../../faq.rst:179 msgid "" "Yeah, you can! We have a special channel reserved for the development of " "external libraries! You can also read `this `_ for more information." msgstr "" -#: ../../faq.rst:183 +#: ../../faq.rst:184 msgid "" "I'm getting \"``AttributeError: HTTPClient not found!``\" when I try to " "execute helper methods!" msgstr "" -#: ../../faq.rst:184 +#: ../../faq.rst:185 msgid "Probably you are doing something like this:" msgstr "" -#: ../../faq.rst:191 +#: ../../faq.rst:192 msgid "" "And the error occurs in the line where you try to send something. You can" " fix this easy by adding one argument:" msgstr "" -#: ../../faq.rst:198 +#: ../../faq.rst:199 msgid "" "You have to add this extra argument for every object you instantiate by " "yourself if you want to use it's methods" msgstr "" -#: ../../faq.rst:202 +#: ../../faq.rst:203 msgid "" "Context and Messages don't have the ``Channel`` and ``Guild`` attributes!" " Why?" msgstr "" -#: ../../faq.rst:203 +#: ../../faq.rst:204 msgid "" "At the moment the Discord API does *not* include them into their " "responses. You can get those object via the ``get_channel()`` and " "``get_guild()`` methods of the Context and Message model." msgstr "" -#: ../../faq.rst:208 +#: ../../faq.rst:209 msgid "\"``ctx.send got an unexpected keyword argument: files``\"! Why?" msgstr "" -#: ../../faq.rst:209 +#: ../../faq.rst:210 msgid "" "It is not supported due to an decision of the core developer team. There " "are two ways to do it:" msgstr "" -#: ../../faq.rst:212 +#: ../../faq.rst:213 msgid "Using ``await channel.send`` instead" msgstr "" -#: ../../faq.rst:213 +#: ../../faq.rst:214 msgid "Using the `files`_ extension" msgstr "" -#: ../../faq.rst:217 +#: ../../faq.rst:218 msgid "\"``ctx.send got an unexpected keyword argument: embed``\"! Why?" msgstr "" -#: ../../faq.rst:218 +#: ../../faq.rst:219 msgid "" "This is quite simple: The argument ``embed`` got deprecated by Discord. " "The new naming is ``embeds``." msgstr "" -#: ../../faq.rst:222 +#: ../../faq.rst:223 msgid "How can I check what exception happened during a request?" msgstr "" -#: ../../faq.rst:223 +#: ../../faq.rst:224 msgid "We, unlike d.py, do not offer something like ``interactions.NotFound``." msgstr "" -#: ../../faq.rst:225 +#: ../../faq.rst:226 msgid "Instead you have to do it like this:" msgstr "" -#: ../../faq.rst:228 +#: ../../faq.rst:229 msgid "" "This feature will be implemented with version 4.3 and is currently only " "available on beta/unstable" msgstr "" -#: ../../faq.rst:242 +#: ../../faq.rst:243 msgid "" "You can additionally get the exact reason for why the exception occurred " "with ``e.message`` or ``e.lookup(e.code)``" msgstr "" -#: ../../faq.rst:246 +#: ../../faq.rst:247 msgid "My message content is always empty! How can I fix this?" msgstr "" -#: ../../faq.rst:247 +#: ../../faq.rst:248 msgid "" "This happens because you did not enable the intent for message content. " "Enable it on the developer portal and add it into the ``Client`` " @@ -459,11 +461,11 @@ msgid "" "``Intents.DEFAULT``, it can be any other intent(s) you need!" msgstr "" -#: ../../faq.rst:254 +#: ../../faq.rst:255 msgid "Is there something like ``Cogs``?" msgstr "" -#: ../../faq.rst:255 +#: ../../faq.rst:256 msgid "" "Yes! Although, we call them ``Extensions``. Yeah, like :ref:`Extension " "Libraries `. This is because an extension " @@ -471,39 +473,39 @@ msgid "" "how you create an extension for yourself:" msgstr "" -#: ../../faq.rst:283 +#: ../../faq.rst:284 msgid "It's nothing more than that." msgstr "" -#: ../../faq.rst:285 +#: ../../faq.rst:286 msgid "" "Since ``@bot.X`` decorators don't work in extensions, you have to use " "these:" msgstr "" -#: ../../faq.rst:287 +#: ../../faq.rst:288 msgid "For event listeners, use ``@interactions.extension_listener``" msgstr "" -#: ../../faq.rst:288 +#: ../../faq.rst:289 msgid "For component listeners, use ``@interactions.extension_component``" msgstr "" -#: ../../faq.rst:289 +#: ../../faq.rst:290 msgid "For modal listeners, use ``@interactions.extension_modal``" msgstr "" -#: ../../faq.rst:290 +#: ../../faq.rst:291 msgid "For autocomplete listeners, use ``@interactions.extension_autocomplete``" msgstr "" -#: ../../faq.rst:294 +#: ../../faq.rst:295 msgid "" "``channel.members`` does not exist, how do I get the people in a voice " "channel?" msgstr "" -#: ../../faq.rst:295 +#: ../../faq.rst:296 msgid "" "``channel.members`` actually does exist, but is reserved for threads. " "There is no attribute for people in a voice channel by the API. The only " @@ -512,12 +514,37 @@ msgid "" " updated when a member joins or leaves." msgstr "" -#: ../../faq.rst:301 +#: ../../faq.rst:302 msgid "My question is not answered on here!" msgstr "" -#: ../../faq.rst:302 +#: ../../faq.rst:303 msgid "" "Please join our `Discord Server`_ for any further support regarding our " "library and/or any integration code depending on it." msgstr "" + +#~ msgid "" +#~ "A `voice client`_ - which is still" +#~ " WIP, but it is able to listen" +#~ " for the ``VOICE_STATE_UPDATE`` event." +#~ msgstr "" + +#~ msgid "An `autosharder`_ for automatic sharding" +#~ msgstr "" + +#~ msgid "A `paginator`_ for paginating embeds on messages using components" +#~ msgstr "" + +#~ msgid "" +#~ "`persistence`_ - for storing data inside" +#~ " your custom IDs (as an alternative" +#~ " to ``wait_for``)" +#~ msgstr "" + +#~ msgid "" +#~ "`get`_ for getting objects from the " +#~ "discord API (will be implemented into" +#~ " the core library at a later " +#~ "time)" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/index.po b/docs/locale/it/LC_MESSAGES/index.po index 91465f9df..d7a1d6841 100644 --- a/docs/locale/it/LC_MESSAGES/index.po +++ b/docs/locale/it/LC_MESSAGES/index.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../index.rst:47 msgid "Pages:" @@ -51,7 +51,7 @@ msgstr "" #: ../../index.rst:11 msgid "" "Look no more! The goal of this library is to make all three of these " -"questions go from possibilites to trivial matters." +"questions go from possibilities to trivial matters." msgstr "" #: ../../index.rst:14 @@ -181,7 +181,7 @@ msgid "**black** ``22.6.0``" msgstr "" #: ../../index.rst:66 -msgid "**flake8** ``4.0.1``" +msgid "**flake8** ``5.0.4``" msgstr "" #: ../../index.rst:67 @@ -190,7 +190,7 @@ msgstr "" #: ../../index.rst:69 msgid "" -"**Sphinx** ``4.4.0``: all of our documentation is powered off of " +"**Sphinx** ``5.1.1``: all of our documentation is powered off of " "autogenerated documentation of the Sphinx engine." msgstr "" @@ -247,3 +247,20 @@ msgstr "" #: ../../index.rst:88 msgid ":ref:`modindex`" msgstr "" + +#~ msgid "" +#~ "Look no more! The goal of this " +#~ "library is to make all three of" +#~ " these questions go from possibilites " +#~ "to trivial matters." +#~ msgstr "" + +#~ msgid "**flake8** ``4.0.1``" +#~ msgstr "" + +#~ msgid "" +#~ "**Sphinx** ``4.4.0``: all of our " +#~ "documentation is powered off of " +#~ "autogenerated documentation of the Sphinx " +#~ "engine." +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/migration.po b/docs/locale/it/LC_MESSAGES/migration.po index 9f0d8e6aa..3546c747d 100644 --- a/docs/locale/it/LC_MESSAGES/migration.po +++ b/docs/locale/it/LC_MESSAGES/migration.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../migration.rst:2 msgid "Migration" @@ -126,7 +126,9 @@ msgid "" msgstr "" #: ../../migration.rst:99 -msgid "You can get more information by reading the `get-documentation`_." +msgid "" +"You can get more information by reading the " +":meth:`interactions.client.get.get`-documentation" msgstr "" #: ../../migration.rst:102 @@ -148,3 +150,6 @@ msgid "" "your argument in your function differently than your option name! " "Example:" msgstr "" + +#~ msgid "You can get more information by reading the `get-documentation`_." +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/models.command.po b/docs/locale/it/LC_MESSAGES/models.command.po index 5c72da5b0..a7fca335f 100644 --- a/docs/locale/it/LC_MESSAGES/models.command.po +++ b/docs/locale/it/LC_MESSAGES/models.command.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.command.rst:4 msgid "Application Command Models" @@ -37,8 +37,10 @@ msgid "The structure for a choice:" msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission of msgid "Variables" @@ -56,13 +58,14 @@ msgstr "" #: interactions.client.models.command.Command:16 #: interactions.client.models.command.Command.group:28 #: interactions.client.models.command.Command.subcommand:33 -#: interactions.client.models.command.Option:34 of +#: interactions.client.models.command.Option:36 of msgid "" "The dictionary of localization for the ``name`` field. This enforces the " "same restrictions as the ``name`` field." msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command #: interactions.client.models.command.Command.__call @@ -72,6 +75,7 @@ msgstr "" #: interactions.client.models.command.Command.error #: interactions.client.models.command.Command.group #: interactions.client.models.command.Command.subcommand +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission #: interactions.client.models.command.option of @@ -100,8 +104,7 @@ msgstr "" msgid "The type of option." msgstr "" -#: interactions.client.models.command.Option:23 -#: interactions.client.models.command.option:14 of +#: interactions.client.models.command.Option:23 of msgid "The name of the option." msgstr "" @@ -142,19 +145,27 @@ msgid "The maximum value supported by the option." msgstr "" #: interactions.client.models.command.Option:33 of +msgid "The minimum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:34 of +msgid "The maximum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:35 of msgid "A status denoting whether this option is an autocomplete option." msgstr "" #: interactions.client.models.command.Command:17 #: interactions.client.models.command.Command.group:30 #: interactions.client.models.command.Command.subcommand:35 -#: interactions.client.models.command.Option:35 of +#: interactions.client.models.command.Option:37 of msgid "" "The dictionary of localization for the ``description`` field. This " "enforces the same restrictions as the ``description`` field." msgstr "" -#: interactions.client.models.command.Option:36 of +#: interactions.client.models.command.Option:38 of msgid "How the option value is passed to the function, if different than ``name``" msgstr "" @@ -248,18 +259,26 @@ msgid "A decorator for adding options to a command." msgstr "" #: interactions.client.models.command.option:3 of -msgid "The structure of an option:" +msgid "" +"The ``type`` and ``name`` of the option are defaulted to the parameter's " +"typehint and name." +msgstr "" + +#: interactions.client.models.command.option:5 of +msgid "" +"When the ``name`` of the option differs from the parameter name, the " +"``converter`` field will default to the name of the parameter." msgstr "" -#: interactions.client.models.command.option:12 of -msgid "The type of the option." +#: interactions.client.models.command.option:8 of +msgid "The structure of an option:" msgstr "" -#: interactions.client.models.command.option:16 of -msgid "The description of the option. Defaults to ``\"No description set\"``." +#: interactions.client.models.command.option:17 of +msgid "The description of the option. Defaults to \"No description set\"." msgstr "" -#: interactions.client.models.command.option:18 of +#: interactions.client.models.command.option:19 of msgid "The keyword arguments of the option, same as :class:`Option`." msgstr "" @@ -283,6 +302,8 @@ msgstr "" msgid "A class that when returned from a command, the command chain is stopped." msgstr "" +#: interactions.client.models.command.BaseResult:3 +#: interactions.client.models.command.GroupResult:3 #: interactions.client.models.command.StopCommand:3 of msgid "Usage:" msgstr "" @@ -291,6 +312,32 @@ msgstr "" msgid "This allows for custom checks that allow stopping the command chain." msgstr "" +#: interactions.client.models.command.BaseResult:1 +#: interactions.client.models.command.GroupResult:1 of +msgid "A class object representing the result of the base command." +msgstr "" + +#: interactions.client.models.command.BaseResult:17 of +msgid "" +"If the subcommand coroutine does not have enough parameters, the " +"``BaseResult`` will not be passed." +msgstr "" + +#: interactions.client.models.command.BaseResult:19 +#: interactions.client.models.command.GroupResult:25 of +msgid "The result of the base command." +msgstr "" + +#: interactions.client.models.command.GroupResult:23 of +msgid "" +"If the subcommand does not have enough arguments, the ``GroupResult`` " +"will not be passed." +msgstr "" + +#: interactions.client.models.command.GroupResult:26 of +msgid "The parent ``BaseResult``." +msgstr "" + #: interactions.client.models.command.Command:1 of msgid "A class object representing a command." msgstr "" @@ -364,6 +411,14 @@ msgstr "" msgid "The extension that the command belongs to, if any." msgstr "" +#: interactions.client.models.command.Command:26 of +msgid "The client that the command belongs to." +msgstr "" + +#: interactions.client.models.command.Command:27 of +msgid "The listener, used for dispatching command errors." +msgstr "" + #: interactions.client.models.command.Command.converters:1 of msgid "" "Returns a dictionary with all converters added to the options of the " @@ -525,3 +580,9 @@ msgid "" ":class:`interactions.client.bot.Extension` is passed to the coroutine, if" " any." msgstr "" + +#~ msgid "The type of the option." +#~ msgstr "" + +#~ msgid "The description of the option. Defaults to ``\"No description set\"``." +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/models.component.po b/docs/locale/it/LC_MESSAGES/models.component.po index ae186054c..ce3834826 100644 --- a/docs/locale/it/LC_MESSAGES/models.component.po +++ b/docs/locale/it/LC_MESSAGES/models.component.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.component.rst:4 msgid "Component Models" @@ -257,36 +257,18 @@ msgid "The maximum length of the input." msgstr "" #: interactions.client.models.component.Modal:1 of -msgid "A class object representing a modal." +msgid "A class object representing a modal. The structure for a modal: ::" msgstr "" -#: interactions.client.models.component.Modal:8 of -msgid "The structure for a modal: ::" -msgstr "" - -#: interactions.client.models.component.Modal:6 of -msgid "interactions.Modal(" -msgstr "" - -#: interactions.client.models.component.Modal:5 of -msgid "" -"title=\"Application Form\", custom_id=\"mod_app_form\", " -"components=[interactions.TextInput(...)]," -msgstr "" - -#: interactions.client.models.component.Modal:8 of -msgid ")" -msgstr "" - -#: interactions.client.models.component.Modal:10 of +#: interactions.client.models.component.Modal:9 of msgid "The custom ID of the modal." msgstr "" -#: interactions.client.models.component.Modal:11 of +#: interactions.client.models.component.Modal:10 of msgid "The title of the modal." msgstr "" -#: interactions.client.models.component.Modal:12 of +#: interactions.client.models.component.Modal:11 of msgid "The components of the modal." msgstr "" @@ -302,22 +284,22 @@ msgid "" " also support only 1 text input component only." msgstr "" -#: interactions.client.models.component.ActionRow:13 of -msgid "The structure for an action row: ::" +#: interactions.client.models.component.ActionRow:8 of +msgid "The structure for an action row: ..code-block:: python" msgstr "" -#: interactions.client.models.component.ActionRow:9 of +#: interactions.client.models.component.ActionRow:10 of msgid "" "# \"...\" represents a component object. # Method 1: " "interactions.ActionRow(...) # Method 2: " "interactions.ActionRow(components=[...])" msgstr "" -#: interactions.client.models.component.ActionRow:15 of +#: interactions.client.models.component.ActionRow:16 of msgid "The type of component. Always defaults to ``1``." msgstr "" -#: interactions.client.models.component.ActionRow:16 of +#: interactions.client.models.component.ActionRow:17 of msgid "A list of components the ActionRow has, if any." msgstr "" @@ -340,3 +322,23 @@ msgstr "" #: interactions.client.models.component.ActionRow.new of msgid "Return type" msgstr "" + +#~ msgid "A class object representing a modal." +#~ msgstr "" + +#~ msgid "The structure for a modal: ::" +#~ msgstr "" + +#~ msgid "interactions.Modal(" +#~ msgstr "" + +#~ msgid "" +#~ "title=\"Application Form\", custom_id=\"mod_app_form\"," +#~ " components=[interactions.TextInput(...)]," +#~ msgstr "" + +#~ msgid ")" +#~ msgstr "" + +#~ msgid "The structure for an action row: ::" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/models.misc.po b/docs/locale/it/LC_MESSAGES/models.misc.po index 9ea8f4346..31ef0b3e5 100644 --- a/docs/locale/it/LC_MESSAGES/models.misc.po +++ b/docs/locale/it/LC_MESSAGES/models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.misc.rst:4 msgid "Miscellaneous Models" @@ -56,12 +56,6 @@ msgstr "" msgid "The resolved attachments data." msgstr "" -#: interactions.client.models.misc.Interaction -#: interactions.client.models.misc.InteractionData -#: interactions.client.models.misc.InteractionResolvedData of -msgid "Parameters" -msgstr "" - #: interactions.client.models.misc.InteractionData:1 of msgid "A class object representing the data of an interaction." msgstr "" @@ -102,6 +96,10 @@ msgstr "" msgid "The targeted ID of the interaction." msgstr "" +#: interactions.client.models.misc.InteractionData:12 of +msgid "Array of Action Rows in modal." +msgstr "" + #: interactions.client.models.misc.Interaction:1 of msgid "A class object representing an interaction." msgstr "" @@ -149,3 +147,6 @@ msgstr "" #: interactions.client.models.misc.Interaction:13 of msgid "The message of the interaction." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/quickstart.po b/docs/locale/it/LC_MESSAGES/quickstart.po index 89ed78f26..76b3670dc 100644 --- a/docs/locale/it/LC_MESSAGES/quickstart.po +++ b/docs/locale/it/LC_MESSAGES/quickstart.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:08-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../quickstart.rst:2 msgid "Quickstart" @@ -28,10 +28,11 @@ msgstr "" #: ../../quickstart.rst:7 msgid "" -"**discord-interactions** is a :ref:`Python library ` for the Discord Application Programming Interface. (API) A" -" library in Python has to be installed through the `pip` file. Run this " -"in your terminal/command line in order to install our library:" +"**discord-interactions** is a :ref:`Python library " +"` for the Discord Application Programming " +"Interface. (API) A library in Python has to be installed through the " +"`pip` file. Run this in your terminal/command line in order to install " +"our library:" msgstr "" #: ../../quickstart.rst:11 @@ -308,109 +309,116 @@ msgid "" msgstr "" #: ../../quickstart.rst:208 -msgid "" -"The first field in the ``@option()`` decorator is the type of the option." -" This is positional only and required. You can use integers, the default " -"Python types, the ``OptionType`` enum, or supported objects such as " -"``interactions.Channel``." +msgid "All arguments in the decorator are keyword arguments only." msgstr "" #: ../../quickstart.rst:209 -msgid "All other arguments in the decorator are keyword arguments only." +msgid "" +"The ``type`` and ``name`` fields default to the typehint and the name of " +"the parameter." msgstr "" #: ../../quickstart.rst:210 -msgid "The ``name`` field is required." +msgid "" +"The ``description`` field is optional and defaults to ``\"No description " +"set``." msgstr "" #: ../../quickstart.rst:211 msgid "" -"The ``description`` field is optional and defaults to ``\"No description " -"set``." +"The ``required`` field defaults to whether the default for the parameter " +"is empty." msgstr "" #: ../../quickstart.rst:212 msgid "" +"For typehinting or inputting the ``type`` field, you can use integers, " +"the default Python types, the ``OptionType`` enum, or supported objects " +"such as ``interactions.Channel``." +msgstr "" + +#: ../../quickstart.rst:213 +msgid "" "Any parameters from ``Option`` can be passed into the ``@option()`` " "decorator." msgstr "" -#: ../../quickstart.rst:215 +#: ../../quickstart.rst:216 msgid "The limit for options per command is 25." msgstr "" -#: ../../quickstart.rst:218 +#: ../../quickstart.rst:219 msgid "Nested commands: subcommands" msgstr "" -#: ../../quickstart.rst:220 +#: ../../quickstart.rst:221 msgid "" "Subcommands are options that are nested to create subcategories of " "commands." msgstr "" -#: ../../quickstart.rst:222 +#: ../../quickstart.rst:223 msgid "Here is the structure of a subcommand:" msgstr "" -#: ../../quickstart.rst:265 +#: ../../quickstart.rst:266 msgid "You can also create subcommands using the command system:" msgstr "" -#: ../../quickstart.rst:291 +#: ../../quickstart.rst:292 msgid "You can add a SUB_COMMAND_GROUP in between the base and command." msgstr "" -#: ../../quickstart.rst:294 +#: ../../quickstart.rst:295 msgid "Additional information about subcommands" msgstr "" -#: ../../quickstart.rst:296 +#: ../../quickstart.rst:297 msgid "" "Base commands are returned the :ref:`Command ` object. From this, you can utilize the following " "decorators:" msgstr "" -#: ../../quickstart.rst:299 +#: ../../quickstart.rst:300 msgid "" ":ref:`@subcommand() `: creates" " a subcommand." msgstr "" -#: ../../quickstart.rst:300 +#: ../../quickstart.rst:301 msgid "" ":ref:`@group() `: creates a " "group." msgstr "" -#: ../../quickstart.rst:301 +#: ../../quickstart.rst:302 msgid "" ":ref:`@error `: registers an " "error callback." msgstr "" -#: ../../quickstart.rst:303 +#: ../../quickstart.rst:304 msgid "Check the documentation for the parameters of each of these decorators." msgstr "" -#: ../../quickstart.rst:305 +#: ../../quickstart.rst:306 msgid "The following is an example of a base command:" msgstr "" -#: ../../quickstart.rst:313 +#: ../../quickstart.rst:314 msgid "The examples below will be using the base command above." msgstr "" -#: ../../quickstart.rst:315 +#: ../../quickstart.rst:316 msgid "The following is an example of a subcommand of the base command:" msgstr "" -#: ../../quickstart.rst:323 +#: ../../quickstart.rst:324 msgid "This code results in the following subcommand: `/base_command subcommand`." msgstr "" -#: ../../quickstart.rst:326 +#: ../../quickstart.rst:327 msgid "" "You can use the ``base_res`` parameter in groups and subcommands, and " "``group_res`` in subcommands inside groups to access the result of the " @@ -418,50 +426,50 @@ msgid "" "``ctx`` parameter." msgstr "" -#: ../../quickstart.rst:329 +#: ../../quickstart.rst:330 msgid "The following is an example of a group with subcommands:" msgstr "" -#: ../../quickstart.rst:341 +#: ../../quickstart.rst:342 msgid "" "You can have multiple groups, with multiple subcommands in each group. " "Subcommands and groups are options, so the same restrictions apply." msgstr "" -#: ../../quickstart.rst:344 +#: ../../quickstart.rst:345 msgid "Create any subcommands without groups *before* creating any groups." msgstr "" -#: ../../quickstart.rst:346 +#: ../../quickstart.rst:347 msgid "" "Since there are multiple coroutines involved that each get executed, you " "may be wondering how you can stop the chain. Luckily, there is a way:" msgstr "" -#: ../../quickstart.rst:360 +#: ../../quickstart.rst:361 msgid "This works on both groups and subcommands." msgstr "" -#: ../../quickstart.rst:362 +#: ../../quickstart.rst:363 msgid "The following is an example of an error callback:" msgstr "" -#: ../../quickstart.rst:378 +#: ../../quickstart.rst:379 msgid "" "The parameters ``ctx`` and ``error`` are required, but you can have more " "parameters, such as ``*args`` and ``**kwargs``, if you need to access " "options." msgstr "" -#: ../../quickstart.rst:382 +#: ../../quickstart.rst:383 msgid "You can have one error callback per command." msgstr "" -#: ../../quickstart.rst:385 +#: ../../quickstart.rst:386 msgid "Special type of commands: Context menus" msgstr "" -#: ../../quickstart.rst:387 +#: ../../quickstart.rst:388 msgid "" "While, granted that application commands are way more intuitive and " "easier to work with as both a bot developer and user from a UX approach, " @@ -472,39 +480,39 @@ msgid "" " right-click actions with menial effort." msgstr "" -#: ../../quickstart.rst:393 +#: ../../quickstart.rst:394 msgid "" "In order to create a menu-based command, all you need to do is simply add" " this one line into your ``@command`` decorator:" msgstr "" -#: ../../quickstart.rst:406 +#: ../../quickstart.rst:407 msgid "Here is an alternate way of creating a context menu:" msgstr "" -#: ../../quickstart.rst:415 +#: ../../quickstart.rst:416 msgid "" "The structure of a menu command differs significantly from that of a " "regular one:" msgstr "" -#: ../../quickstart.rst:417 +#: ../../quickstart.rst:418 msgid "You cannot have any options or choices." msgstr "" -#: ../../quickstart.rst:418 +#: ../../quickstart.rst:419 msgid "You cannot have a description." msgstr "" -#: ../../quickstart.rst:419 +#: ../../quickstart.rst:420 msgid "The ``name`` filter follows a different regex pattern." msgstr "" -#: ../../quickstart.rst:422 +#: ../../quickstart.rst:423 msgid "Creating and sending Components" msgstr "" -#: ../../quickstart.rst:424 +#: ../../quickstart.rst:425 msgid "" "Being able to run your own commands is very useful for a lot of " "automation-related purposes as a bot developer, however, we also have " @@ -513,14 +521,14 @@ msgid "" "components." msgstr "" -#: ../../quickstart.rst:429 +#: ../../quickstart.rst:430 msgid "" "Components are ways of being able to select pre-defined data, or define " "your own. They're very simple but quite powerful when put into practice " "This code block below shows a simplified implementation of a component:" msgstr "" -#: ../../quickstart.rst:455 +#: ../../quickstart.rst:456 msgid "" "This is a design that we ended up choosing to simplify responding to " "buttons when someone presses on one, and to allow bot developers to plug " @@ -530,11 +538,11 @@ msgid "" "modularity." msgstr "" -#: ../../quickstart.rst:462 +#: ../../quickstart.rst:463 msgid "What kinds of components are there?" msgstr "" -#: ../../quickstart.rst:464 +#: ../../quickstart.rst:465 msgid "" "As a bot developer, this may be fairly important for you to want to know." " Different components provide difference user experiences, interactions " @@ -543,18 +551,18 @@ msgid "" "able to `find these component types`_ here." msgstr "" -#: ../../quickstart.rst:471 +#: ../../quickstart.rst:472 msgid "How do I send components in a row?" msgstr "" -#: ../../quickstart.rst:473 +#: ../../quickstart.rst:474 msgid "" "You are also able to organize these components into rows, which are " "defined as ``ActionRow``'s. It is worth noting that you can have only a " "maximum of 5 per message that you send. This code block below shows how:" msgstr "" -#: ../../quickstart.rst:505 +#: ../../quickstart.rst:506 msgid "" "By default, the ``components`` keyword-argument field in the context " "sending method will always support ``ActionRow``-less sending: you only " @@ -563,57 +571,57 @@ msgid "" "class objects instead." msgstr "" -#: ../../quickstart.rst:511 +#: ../../quickstart.rst:512 msgid "" "You cannot use ``TextInput`` with the above shown method. Look :ref:`here" " ` how to create and send them." msgstr "" -#: ../../quickstart.rst:516 +#: ../../quickstart.rst:517 msgid "Creating a TextInput" msgstr "" -#: ../../quickstart.rst:517 +#: ../../quickstart.rst:518 msgid "You want to get a Text from a user? You can use ``TextInput`` for that." msgstr "" -#: ../../quickstart.rst:529 +#: ../../quickstart.rst:530 msgid "" "But how to send it? You can't use ``ctx.send`` for it. Take a look at " ":ref:`Modals ` for that." msgstr "" -#: ../../quickstart.rst:533 +#: ../../quickstart.rst:534 msgid "Modals" msgstr "" -#: ../../quickstart.rst:534 +#: ../../quickstart.rst:535 msgid "" "Modals are a new way to interact with a user. Currently only a " "``TextInput`` component is supported. You can have up to five " "``TextInput`` in a Modal." msgstr "" -#: ../../quickstart.rst:547 +#: ../../quickstart.rst:548 msgid "with the ``TextInput`` example from above we get:" msgstr "" -#: ../../quickstart.rst:552 +#: ../../quickstart.rst:553 msgid "Responding to a Modal interaction" msgstr "" -#: ../../quickstart.rst:560 +#: ../../quickstart.rst:561 msgid "" "You can respond to a modal the same way as you would respond to a normal " "``chat-input`` command, except your function has an extra argument for " "the text what was put into the modal." msgstr "" -#: ../../quickstart.rst:563 +#: ../../quickstart.rst:564 msgid "Adding v2 Permissions" msgstr "" -#: ../../quickstart.rst:565 +#: ../../quickstart.rst:566 msgid "" "v2 permissions consist of the ``default_member_permissions`` and " "``dm_permission`` keyword arguments. Similar to adding privileged " @@ -621,55 +629,87 @@ msgid "" "etc.) as follows:" msgstr "" -#: ../../quickstart.rst:604 +#: ../../quickstart.rst:605 msgid "" "Adding guild-only commands is easier as the only thing it takes is a " "boolean. Here's an example of a guild-only command:" msgstr "" -#: ../../quickstart.rst:623 +#: ../../quickstart.rst:624 msgid "" "Likewise, setting ``dm_permission`` to ``True`` makes it usable in DMs. " "Just to note that this argument's mainly used for global commands. Guild " "commands with this argument will have no effect." msgstr "" -#: ../../quickstart.rst:627 +#: ../../quickstart.rst:628 msgid "Utilities" msgstr "" -#: ../../quickstart.rst:629 +#: ../../quickstart.rst:630 msgid "You can use the following utilities to help you with your commands:" msgstr "" -#: ../../quickstart.rst:631 +#: ../../quickstart.rst:632 msgid "``ActionRow.new()``: Creates a new ``ActionRow`` object." msgstr "" -#: ../../quickstart.rst:632 +#: ../../quickstart.rst:633 msgid "``spread_to_rows()``: Spreads a list of components into a list of rows." msgstr "" -#: ../../quickstart.rst:633 +#: ../../quickstart.rst:634 msgid "" "``@autodefer()``: Automatically defers a command if it did not respond " "within the specified time." msgstr "" -#: ../../quickstart.rst:635 +#: ../../quickstart.rst:636 msgid "" -"Look at their documentation :ref:`here ` for " -"more information." +"Look at their documentation :ref:`here ` for more " +"information." msgstr "" -#: ../../quickstart.rst:637 +#: ../../quickstart.rst:638 msgid "Usage of ``ActionRow.new()``:" msgstr "" -#: ../../quickstart.rst:653 +#: ../../quickstart.rst:654 msgid "Usage of ``spread_to_rows()``:" msgstr "" -#: ../../quickstart.rst:675 +#: ../../quickstart.rst:676 msgid "Usage of ``@autodefer()``:" msgstr "" + +#~ msgid "" +#~ "**discord-interactions** is a :ref:`Python " +#~ "library ` for the" +#~ " Discord Application Programming Interface. " +#~ "(API) A library in Python has to" +#~ " be installed through the `pip` file." +#~ " Run this in your terminal/command " +#~ "line in order to install our " +#~ "library:" +#~ msgstr "" + +#~ msgid "" +#~ "The first field in the ``@option()`` " +#~ "decorator is the type of the " +#~ "option. This is positional only and " +#~ "required. You can use integers, the " +#~ "default Python types, the ``OptionType`` " +#~ "enum, or supported objects such as " +#~ "``interactions.Channel``." +#~ msgstr "" + +#~ msgid "All other arguments in the decorator are keyword arguments only." +#~ msgstr "" + +#~ msgid "The ``name`` field is required." +#~ msgstr "" + +#~ msgid "" +#~ "Look at their documentation :ref:`here " +#~ "` for more information." +#~ msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/utils.po b/docs/locale/it/LC_MESSAGES/utils.po new file mode 100644 index 000000000..2968b6970 --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/utils.po @@ -0,0 +1,361 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../utils.rst:4 +msgid "The ``get`` utility method" +msgstr "" + +#: interactions.utils.get.get:1 of +msgid "Helper method to get an object." +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "This method can do the following:" +msgstr "" + +#: interactions.utils.get.get:6 of +msgid "Get a list of specific objects" +msgstr "" + +#: interactions.utils.get.get:5 interactions.utils.get.get:9 of +msgid "purely from cache" +msgstr "" + +#: interactions.utils.get.get:6 interactions.utils.get.get:10 of +msgid "purely from HTTP" +msgstr "" + +#: interactions.utils.get.get:7 of +msgid "" +"from cache and additionally from HTTP for every ID that was not found in " +"cache" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "Get a single specific object" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "from HTTP if not found in cache else from cache" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "The method has to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "You don't force anything" +msgstr "" + +#: interactions.utils.get.get:15 of +msgid "You force HTTP" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "The method doesn't have to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "You force cache" +msgstr "" + +#: interactions.utils.get.get:20 of +msgid "" +"Technically, there is no need for an ``await`` if there is an object " +"found in the cache. Because of the fact, that, as long as you don't " +"enforce the cache, the function will get the object from HTTP, if it is " +"not in the cache, you still have to await it. This has been done to " +"reduce confusion on whether the object origins from an HTTP call or a " +"cache result and to remove the extra step for you to check if the " +"returned object is an awaitable or not." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing:" +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing can be done via the ``force`` keyword argument." +msgstr "" + +#: interactions.utils.get.get:31 of +msgid "``force=\"cache\"`` or ``force=interactions.Force.CACHE``:" +msgstr "" + +#: interactions.utils.get.get:30 of +msgid "" +"This forces the method to only return from cache (if the object is not " +"found it will return ``None``). If you use this, you don't need to await " +"the method." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "``force=\"http\"`` or ``force=interactions.Force.HTTP``:" +msgstr "" + +#: interactions.utils.get.get:34 of +msgid "" +"This forces the method to make an HTTP request to the discord API and " +"return the result of it. If you use this, you have to await the method." +msgstr "" + +#: interactions.utils.get.get:38 of +msgid "" +"If you are a PyCharm user, please be aware of a bug that causes incorrect" +" suggestions to appear if using an enum. Even if PyCharm shows a normal " +"object as result, you have to await the method if you enforce HTTP. To " +"prevent this bug from happening it is suggested using ``force=\"http\"`` " +"instead of the enum." +msgstr "" + +#: interactions.utils.get.get:43 of +msgid "Getting an object:" +msgstr "" + +#: interactions.utils.get.get:45 of +msgid "" +"Here you will see two examples on how to get a single objects and the " +"variations of how the object can be gotten." +msgstr "" + +#: interactions.utils.get.get:48 of +msgid "Example 1/2: Getting a Channel:" +msgstr "" + +#: interactions.utils.get.get:65 of +msgid "Example 2/2: Getting a Member:" +msgstr "" + +#: interactions.utils.get.get:88 of +msgid "" +"Both examples should have given you a basic overview on how to get a " +"single object. Now we will move on with lists of objects." +msgstr "" + +#: interactions.utils.get.get:92 of +msgid "" +"The ``parent_id`` represents the channel or guild id that belongs to the " +"objects you want to get. It is called ``parent_id`` because " +"``guild_or_channel_id`` would be horrible to type out every time." +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "Getting a list of an object:" +msgstr "" + +#: interactions.utils.get.get:96 of +msgid "" +"Here you will see 1 example of how to get a list of objects. The " +"possibilities on how to force (and their results) are the same as in the " +"examples above." +msgstr "" + +#: interactions.utils.get.get:99 of +msgid "Example 1/1: Getting a list of members:" +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "" +"If you enforce cache when getting a list of objects, found objets will be" +" placed into the list and not found objects will be placed as ``None`` " +"into the list." +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Parameters" +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Return type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "An enumerable object representing the force types for the get method." +msgstr "" + +#: interactions.utils.get.Force of +msgid "Variables" +msgstr "" + +#: interactions.utils.get.Force:3 of +msgid "Enforce the usage of cache and block the usage of http" +msgstr "" + +#: interactions.utils.get.Force:4 of +msgid "Enforce the usage of http and block the usage of cache" +msgstr "" + +#: interactions.utils.get.Force of +msgid "Member Type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: ../../utils.rst:10 +msgid "Utilities" +msgstr "" + +#: interactions.utils.utils.autodefer:1 of +msgid "" +"A decorator that automatically defers a command if it did not respond " +"within ``delay`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:3 of +msgid "The structure of the decorator is:" +msgstr "" + +#: interactions.utils.utils.autodefer:13 of +msgid "" +"The amount of time in seconds to wait before defering the command. " +"Defaults to ``2`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:15 of +msgid "Whether the command is deferred ephemerally. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer:17 of +msgid "Whether the command is deferred on origin. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable of +msgid "Returns" +msgstr "" + +#: interactions.utils.utils.autodefer:19 of +msgid "The inner function, for decorating." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:1 of +msgid "A helper function that spreads components into :class:`ActionRow` s." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:3 of +msgid "Example:" +msgstr "" + +#: interactions.utils.utils.spread_to_rows:24 of +msgid "" +"You can only pass in :class:`ActionRow`s, :class:`Button`s, and " +":class:`SelectMenu`s, but in any order." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:26 of +msgid "The components to spread." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:28 of +msgid "The maximum number of components in a single row. Defaults to ``5``." +msgstr "" + +#: interactions.utils.utils.search_iterable:1 of +msgid "" +"Searches through an iterable for items that: - Are True for the check, if" +" one is given - Have attributes that match the keyword arguments (e.x. " +"passing `id=your_id` will only return objects with that id)" +msgstr "" + +#: interactions.utils.utils.search_iterable:5 of +msgid "The iterable to search through" +msgstr "" + +#: interactions.utils.utils.search_iterable:7 of +msgid "The check that items will be checked against" +msgstr "" + +#: interactions.utils.utils.search_iterable:9 of +msgid "Any attributes the items should have" +msgstr "" + +#: interactions.utils.utils.search_iterable:11 of +msgid "All items that match the check and keywords" +msgstr "" + +#: interactions.utils.utils.disable_components:1 of +msgid "Disables the given components." +msgstr "" + +#: interactions.utils.utils.disable_components:3 of +msgid "The components to disable" +msgstr "" + +#: interactions.utils.utils.get_channel_history:1 of +msgid "Gets the history of a channel." +msgstr "" + +#: interactions.utils.utils.get_channel_history:3 of +msgid "The HTTPClient of the bot or your bot instance" +msgstr "" + +#: interactions.utils.utils.get_channel_history:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:7 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:9 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.utils.utils.get_channel_history:11 of +msgid "A check to ignore specific messages" +msgstr "" + +#: interactions.utils.utils.get_channel_history:13 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.utils.utils.get_channel_history:16 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.dispatch.po b/docs/locale/pl/LC_MESSAGES/api.dispatch.po index 2b020e27a..18a4ff864 100644 --- a/docs/locale/pl/LC_MESSAGES/api.dispatch.po +++ b/docs/locale/pl/LC_MESSAGES/api.dispatch.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.dispatch.rst:4 msgid "Dispatching" @@ -38,12 +38,6 @@ msgstr "" msgid "A list of events being dispatched." msgstr "" -#: interactions.api.dispatch.Listener -#: interactions.api.dispatch.Listener.dispatch -#: interactions.api.dispatch.Listener.register of -msgid "Return type" -msgstr "" - #: interactions.api.dispatch.Listener.dispatch:1 of msgid "Dispatches an event given out by the gateway." msgstr "" @@ -83,3 +77,6 @@ msgstr "" #: interactions.api.dispatch.Listener.register:9 of msgid "The name to associate the coroutine with. Defaults to None." msgstr "" + +#~ msgid "Return type" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.gateway.po b/docs/locale/pl/LC_MESSAGES/api.gateway.po index aad9d8772..22e00a8ed 100644 --- a/docs/locale/pl/LC_MESSAGES/api.gateway.po +++ b/docs/locale/pl/LC_MESSAGES/api.gateway.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.gateway.rst:4 msgid "Gateway" @@ -36,121 +36,169 @@ msgid "" "WebSocket." msgstr "" +#: interactions.api.gateway.client.WebSocketClient:4 of +msgid "" +"The ``__heartbeat_event`` Event object is different from the one built in" +" to the Heartbeater object. The latter is used to trace heartbeat " +"acknowledgement." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient of msgid "Variables" msgstr "" -#: interactions.api.gateway.client.WebSocketClient:3 of +#: interactions.api.gateway.client.WebSocketClient:7 of msgid "The asynchronous event loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:4 of +#: interactions.api.gateway.client.WebSocketClient:8 of msgid "The built-in event dispatcher." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:5 of +#: interactions.api.gateway.client.WebSocketClient:9 of +msgid "The websocket ratelimiter object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:10 of msgid "The user-facing HTTP client." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:6 of +#: interactions.api.gateway.client.WebSocketClient:11 of msgid "The WebSocket data of the connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:7 of +#: interactions.api.gateway.client.WebSocketClient:12 of msgid "Whether the connection has been closed or not." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:8 of +#: interactions.api.gateway.client.WebSocketClient:13 of msgid "The connection options made during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:9 of +#: interactions.api.gateway.client.WebSocketClient:14 of msgid "The gateway intents used for connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:10 of +#: interactions.api.gateway.client.WebSocketClient:15 of msgid "The contents of the application returned when ready." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:11 of +#: interactions.api.gateway.client.WebSocketClient:16 of msgid "The context state of a \"heartbeat\" made to the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:12 of +#: interactions.api.gateway.client.WebSocketClient:17 of +msgid "The state of the overall heartbeat process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:18 of msgid "The shards used during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:13 of +#: interactions.api.gateway.client.WebSocketClient:19 of msgid "The presence used in connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:14 of +#: interactions.api.gateway.client.WebSocketClient:20 of msgid "The ready state of the client as an ``asyncio.Event``." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:15 of -msgid "The closing task for ending connections." +#: interactions.api.gateway.client.WebSocketClient:21 of +msgid "The task containing the heartbeat manager process." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:16 of +#: interactions.api.gateway.client.WebSocketClient:22 of msgid "Whether the client has started." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:17 of +#: interactions.api.gateway.client.WebSocketClient:23 of msgid "The ID of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:18 of +#: interactions.api.gateway.client.WebSocketClient:24 of msgid "The sequence identifier of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:19 of +#: interactions.api.gateway.client.WebSocketClient:25 of msgid "" "The latest time of the last send_packet function call since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:20 of +#: interactions.api.gateway.client.WebSocketClient:26 of msgid "" "The latest time of the last ``HEARTBEAT_ACK`` event since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:21 of -msgid "The latency of the connection, in seconds." +#: interactions.api.gateway.client.WebSocketClient:27 of +msgid "The Websocket ratelimit URL for resuming connections, if any." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:28 of +msgid "The Websocket URL for instantiating connections without resuming." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:29 of +msgid "The lock used for reconnecting the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:30 of +msgid "The lock used for closing the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:31 of +msgid "The task containing stopping the client, if any." msgstr "" #: interactions.api.gateway.client.WebSocketClient #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__identify +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache #: interactions.api.gateway.client.WebSocketClient.__option_type_context +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection +#: interactions.api.gateway.client.WebSocketClient._handle_stream +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence +#: interactions.api.gateway.client.WebSocketClient.request_guild_members #: interactions.api.gateway.heartbeat._Heartbeat of msgid "Parameters" msgstr "" -#: interactions.api.gateway.client.WebSocketClient +#: interactions.api.gateway.client.WebSocketClient.latency:1 of +msgid "The latency of the connection, in seconds." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat:1 of +msgid "" +"Controls the heartbeat manager. Do note that this shouldn't be executed " +"by outside processes." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__heartbeat #: interactions.api.gateway.client.WebSocketClient.__identify #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream -#: interactions.api.gateway.client.WebSocketClient.__restart +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__resume #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection #: interactions.api.gateway.client.WebSocketClient._manage_heartbeat +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence -#: interactions.api.gateway.client.WebSocketClient.wait_until_ready -#: interactions.api.gateway.heartbeat._Heartbeat of +#: interactions.api.gateway.client.WebSocketClient.close +#: interactions.api.gateway.client.WebSocketClient.request_guild_members +#: interactions.api.gateway.client.WebSocketClient.run +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat +#: interactions.api.gateway.client.WebSocketClient.wait_until_ready of msgid "Return type" msgstr "" @@ -158,29 +206,21 @@ msgstr "" msgid "Manages the heartbeat loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__restart:1 of -msgid "Restart the client's connection and heartbeat with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:1 of -msgid "Establishes a client connection with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:3 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:5 of -msgid "The shards to establish a connection with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient.run:1 of +msgid "Handles the client's connection with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._establish_connection:5 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:7 of -msgid "The presence to carry with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:1 of +msgid "" +"Parses raw stream data recieved from the Gateway, including Gateway " +"opcodes and events." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:1 of -msgid "Handles the client's connection with the Gateway." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:4 of +msgid "This should never be called directly." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:3 of +#: interactions.api.gateway.client.WebSocketClient._handle_stream:6 of msgid "The packet stream to handle." msgstr "" @@ -192,31 +232,68 @@ msgstr "" msgid "Dispatches an event from the Gateway." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:3 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:3 of msgid "The name of the event." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:5 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:5 of msgid "The data for the event." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of -msgid "" -"Takes raw data given back from the Gateway and gives \"context\" based " -"off of what it is." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:1 of +msgid "Gets an ID from object." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of -msgid "The data from the Gateway." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:5 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:7 of +msgid "The object of the event." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:7 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:5 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:9 of +msgid "The model of the event." msgstr "" #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context of msgid "Returns" msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:9 of +msgid "Object ID" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:1 of +msgid "Gets a list of ids of object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:7 of +msgid "Object IDs" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:1 of +msgid "Modifies guild cache." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of +msgid "" +"Takes raw data given back from the Gateway and gives \"context\" based " +"off of what it is." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of +msgid "The data from the Gateway." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize:6 of msgid "The context object." msgstr "" @@ -255,11 +332,15 @@ msgstr "" msgid "The option type context." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:1 of -msgid "Receives a stream of packets sent from the Gateway." +#: interactions.api.gateway.client.WebSocketClient._reconnect:1 of +msgid "Restarts the client's connection and heartbeat with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:3 of +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:1 of +msgid "Receives a stream of packets sent from the Gateway in an async process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:3 of msgid "The packet stream." msgstr "" @@ -311,6 +392,58 @@ msgid "" "disconnect." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:1 of +msgid "Sends an ``REQUEST_MEMBERS`` packet to the gateway." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:3 of +msgid "ID of the guild to get members for." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:5 of +msgid "" +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:7 of +msgid "String that username starts with." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.close:1 of +msgid "Closes the current connection." +msgstr "" + #: interactions.api.gateway.heartbeat._Heartbeat:1 of msgid "An internal class representing the heartbeat in a WebSocket connection." msgstr "" + +#~ msgid "The closing task for ending connections." +#~ msgstr "" + +#~ msgid "Restart the client's connection and heartbeat with the Gateway." +#~ msgstr "" + +#~ msgid "Establishes a client connection with the Gateway." +#~ msgstr "" + +#~ msgid "The shards to establish a connection with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "The presence to carry with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "Receives a stream of packets sent from the Gateway." +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.http.po b/docs/locale/pl/LC_MESSAGES/api.http.po index b141f2d87..fcab462c2 100644 --- a/docs/locale/pl/LC_MESSAGES/api.http.po +++ b/docs/locale/pl/LC_MESSAGES/api.http.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.http.rst:4 msgid "HTTP" @@ -55,10 +55,13 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag #: interactions.api.http.channel.ChannelRequest.delete_channel #: interactions.api.http.channel.ChannelRequest.delete_channel_permission #: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag #: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -75,6 +78,7 @@ msgstr "" #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template @@ -169,6 +173,7 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker #: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread #: interactions.api.http.thread.ThreadRequest.join_thread #: interactions.api.http.thread.ThreadRequest.leave_thread @@ -198,14 +203,19 @@ msgstr "" msgid "Parameters" msgstr "" -#: interactions.api.http.channel.ChannelRequest +#: interactions.api.http.route.Route.get_bucket:1 of +msgid "" +"Returns the route's bucket. If shared_bucket is None, returns the path " +"with major parameters. Otherwise, it relies on Discord's given bucket." +msgstr "" + +#: interactions.api.http.route.Route.get_bucket:4 of +msgid "The bucket that Discord provides, if available." +msgstr "" + #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance -#: interactions.api.http.channel.ChannelRequest.delete_channel -#: interactions.api.http.channel.ChannelRequest.delete_channel_permission -#: interactions.api.http.channel.ChannelRequest.delete_stage_instance -#: interactions.api.http.channel.ChannelRequest.edit_channel_permission #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -214,37 +224,21 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel -#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway -#: interactions.api.http.client.HTTPClient.get_current_authorisation_information -#: interactions.api.http.client.HTTPClient.get_current_bot_information -#: interactions.api.http.client.HTTPClient.get_gateway -#: interactions.api.http.client.HTTPClient.login -#: interactions.api.http.client.HTTPClient.logout -#: interactions.api.http.emoji.EmojiRequest #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji -#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji -#: interactions.api.http.guild.GuildRequest #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template -#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template -#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.delete_guild -#: interactions.api.http.guild.GuildRequest.delete_guild_integration -#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles -#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild -#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -255,28 +249,17 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings -#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild -#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget -#: interactions.api.http.guild.GuildRequest.modify_user_voice_state -#: interactions.api.http.guild.GuildRequest.remove_guild_ban -#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template -#: interactions.api.http.interaction.InteractionRequest -#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command -#: interactions.api.http.interaction.InteractionRequest.create_interaction_response -#: interactions.api.http.interaction.InteractionRequest.delete_application_command -#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -285,46 +268,22 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command -#: interactions.api.http.limiter.Limiter -#: interactions.api.http.member.MemberRequest -#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member -#: interactions.api.http.member.MemberRequest.remove_member_role -#: interactions.api.http.member.MemberRequest.search_guild_members -#: interactions.api.http.message.MessageRequest -#: interactions.api.http.message.MessageRequest.create_message -#: interactions.api.http.message.MessageRequest.delete_message -#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message -#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message -#: interactions.api.http.message.MessageRequest.send_message -#: interactions.api.http.message.MessageRequest.unpin_message -#: interactions.api.http.reaction.ReactionRequest -#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction -#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction -#: interactions.api.http.request._Request -#: interactions.api.http.request._Request._check_lock -#: interactions.api.http.request._Request._check_session -#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request -#: interactions.api.http.route.Route interactions.api.http.route.Route.endpoint +#: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket -#: interactions.api.http.scheduledEvent.ScheduledEventRequest #: interactions.api.http.scheduledEvent.ScheduledEventRequest.create_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.delete_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event_users #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events #: interactions.api.http.scheduledEvent.ScheduledEventRequest.modify_scheduled_event -#: interactions.api.http.sticker.StickerRequest #: interactions.api.http.sticker.StickerRequest.create_guild_sticker #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker #: interactions.api.http.sticker.StickerRequest.get_guild_sticker @@ -332,53 +291,44 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker -#: interactions.api.http.thread.ThreadRequest -#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread -#: interactions.api.http.thread.ThreadRequest.join_thread -#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members -#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread -#: interactions.api.http.user.UserRequest #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user -#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild -#: interactions.api.http.webhook.WebhookRequest #: interactions.api.http.webhook.WebhookRequest.create_webhook -#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message -#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks -#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Return type" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:1 of -msgid "" -"Returns the route's bucket. If shared_bucket is None, returns the path " -"with major parameters. Otherwise, it relies on Discord's given bucket." +msgid "Returns" msgstr "" -#: interactions.api.http.route.Route.get_bucket:4 of -msgid "The bucket that Discord provides, if available." +#: interactions.api.http.route.Route.get_bucket:7 of +msgid "The route bucket." msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag +#: interactions.api.http.channel.ChannelRequest.delete_channel +#: interactions.api.http.channel.ChannelRequest.delete_channel_permission +#: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag +#: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -387,20 +337,36 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel +#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway +#: interactions.api.http.client.HTTPClient.get_current_authorisation_information +#: interactions.api.http.client.HTTPClient.get_current_bot_information +#: interactions.api.http.client.HTTPClient.get_gateway +#: interactions.api.http.client.HTTPClient.login +#: interactions.api.http.client.HTTPClient.logout #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji +#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template +#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template +#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.delete_guild +#: interactions.api.http.guild.GuildRequest.delete_guild_integration +#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles +#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild +#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -411,17 +377,27 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings +#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild +#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget +#: interactions.api.http.guild.GuildRequest.modify_user_voice_state +#: interactions.api.http.guild.GuildRequest.remove_guild_ban +#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template +#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command +#: interactions.api.http.interaction.InteractionRequest.create_interaction_response +#: interactions.api.http.interaction.InteractionRequest.delete_application_command +#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -430,13 +406,30 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command +#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member +#: interactions.api.http.member.MemberRequest.remove_member_role +#: interactions.api.http.member.MemberRequest.search_guild_members +#: interactions.api.http.message.MessageRequest.create_message +#: interactions.api.http.message.MessageRequest.delete_message +#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message +#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message +#: interactions.api.http.message.MessageRequest.send_message +#: interactions.api.http.message.MessageRequest.unpin_message +#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction +#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction +#: interactions.api.http.request._Request._check_lock +#: interactions.api.http.request._Request._check_session +#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request #: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket @@ -453,31 +446,36 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker +#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread +#: interactions.api.http.thread.ThreadRequest.join_thread +#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members +#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user +#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild #: interactions.api.http.webhook.WebhookRequest.create_webhook +#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message +#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks +#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Returns" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:7 of -msgid "The route bucket." +msgid "Return type" msgstr "" #: interactions.api.http.route.Route.endpoint:1 of @@ -617,9 +615,12 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel_invite:6 #: interactions.api.http.channel.ChannelRequest.create_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.create_tag:7 #: interactions.api.http.channel.ChannelRequest.delete_channel_permission:3 #: interactions.api.http.channel.ChannelRequest.delete_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.delete_tag:3 #: interactions.api.http.channel.ChannelRequest.edit_channel_permission:3 +#: interactions.api.http.channel.ChannelRequest.edit_tag:7 #: interactions.api.http.channel.ChannelRequest.get_channel:3 #: interactions.api.http.channel.ChannelRequest.get_channel_invites:3 #: interactions.api.http.channel.ChannelRequest.get_channel_messages:6 @@ -919,6 +920,51 @@ msgstr "" msgid "Delete a stage instance." msgstr "" +#: interactions.api.http.channel.ChannelRequest.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:4 +#: interactions.api.http.channel.ChannelRequest.edit_tag:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:8 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:9 +#: interactions.api.http.channel.ChannelRequest.edit_tag:10 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:10 +#: interactions.api.http.channel.ChannelRequest.edit_tag:11 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:1 of +msgid "Update a tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:8 of +msgid "The ID of the tag to update." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:1 of +msgid "Delete a forum tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:4 of +msgid "The ID of the tag to delete" +msgstr "" + #: interactions.api.http.emoji.EmojiRequest.get_all_emoji:1 of msgid "Gets all emojis from a guild." msgstr "" @@ -1279,6 +1325,7 @@ msgstr "" msgid "Gets all roles from a Guild." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:3 #: interactions.api.http.guild.GuildRequest.create_guild_ban:3 #: interactions.api.http.guild.GuildRequest.create_guild_kick:3 #: interactions.api.http.guild.GuildRequest.get_all_roles:3 @@ -1374,7 +1421,9 @@ msgid "" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "" +"Number of seconds to delete messages for, between 0 and 604800. Default " +"to 0" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:6 of @@ -1467,20 +1516,36 @@ msgstr "" msgid "Reason to send to audit log, if any." msgstr "" -#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of -msgid "" -"Retrieves a dict from an API that results in how many members would be " -"pruned given the amount of days." +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:1 of +msgid "Begins a prune operation." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:4 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:4 of -msgid "Number of days to count. Defaults to ``7``." +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:5 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:6 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:5 of msgid "Role IDs to include, if given." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:7 of +msgid "A dict containing `{\"pruned\": int}` or `{\"pruned\": None}`" +msgstr "" + +#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of +msgid "" +"Retrieves a dict from an API that results in how many members would be " +"pruned given the amount of days." +msgstr "" + #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:6 of msgid "A dict denoting `{\"pruned\": int}`" msgstr "" @@ -1974,7 +2039,8 @@ msgid "Channel snowflake ID." msgstr "" #: interactions.api.http.message.MessageRequest.create_message:5 -#: interactions.api.http.message.MessageRequest.edit_message:6 of +#: interactions.api.http.message.MessageRequest.edit_message:6 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:9 of msgid "An optional list of files to send attached to the message." msgstr "" @@ -2178,11 +2244,8 @@ msgid "Guild Scheduled Event ID snowflake." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:5 -#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 #: of -msgid "" -"A boolean to include number of users subscribed to the associated event, " -"if given." +msgid "Whether the number of users subscribed to the events is returned." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:6 @@ -2195,6 +2258,13 @@ msgstr "" msgid "Gets all guild scheduled events in a guild." msgstr "" +#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 +#: of +msgid "" +"Whether the number of users subscribed to the associated event is " +"returned." +msgstr "" + #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:5 #: of msgid "" @@ -2307,22 +2377,25 @@ msgid "" "MANAGE_EMOJIS_AND_STICKERS permission." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 -#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of -msgid "the payload to send." +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 of +msgid "The payload to send." msgstr "" #: interactions.api.http.sticker.StickerRequest.create_guild_sticker:4 of +msgid "The file to send." +msgstr "" + +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 of msgid "The guild to create sticker at." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:5 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:6 of msgid "The reason for this action." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 of +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:7 of msgid "The new sticker data on success." msgstr "" @@ -2332,6 +2405,10 @@ msgid "" "permission." msgstr "" +#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of +msgid "the payload to send." +msgstr "" + #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:3 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:4 of msgid "The guild of the target sticker." @@ -2483,15 +2560,18 @@ msgid "" "with.." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:3 of +#: interactions.api.http.thread.ThreadRequest.create_thread:3 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:3 of msgid "The ID of the channel to create this thread in" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:4 of +#: interactions.api.http.thread.ThreadRequest.create_thread:4 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:4 of msgid "The name of the thread" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:5 of +#: interactions.api.http.thread.ThreadRequest.create_thread:5 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:5 of msgid "" "duration in minutes to automatically archive the thread after recent " "activity, can be set to: 60, 1440, 4320, 10080" @@ -2511,7 +2591,8 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:10 of +#: interactions.api.http.thread.ThreadRequest.create_thread:10 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:11 of msgid "An optional reason for the audit log" msgstr "" @@ -2519,6 +2600,28 @@ msgstr "" msgid "The created thread" msgstr "" +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:1 of +msgid "From a given Forum channel, create a Thread with a message to start with." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:7 of +msgid "The payload/dictionary contents of the first message in the forum thread." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:8 of +msgid "List of tag ids that can be applied to the forum, if any." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:10 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:12 of +msgid "Returns a Thread in a Forum object with a starting Message." +msgstr "" + #: interactions.api.http.user.UserRequest.get_self:1 of msgid "An alias to `get_user`, but only gets the current bot user." msgstr "" @@ -2743,3 +2846,15 @@ msgstr "" #: of msgid "Deletes the original message object sent." msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Number of days to count. Defaults to ``7``." +#~ msgstr "" + +#~ msgid "" +#~ "A boolean to include number of " +#~ "users subscribed to the associated " +#~ "event, if given." +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.models.audit_log.po b/docs/locale/pl/LC_MESSAGES/api.models.audit_log.po new file mode 100644 index 000000000..7ba1f1c2b --- /dev/null +++ b/docs/locale/pl/LC_MESSAGES/api.models.audit_log.po @@ -0,0 +1,413 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.audit_log.rst:4 +msgid "Audit-Log Models" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:1 of +msgid "A class object representing an AuditLogEntry." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange +#: interactions.api.models.audit_log.AuditLogEntry +#: interactions.api.models.audit_log.AuditLogEvents +#: interactions.api.models.audit_log.AuditLogs +#: interactions.api.models.audit_log.OptionalAuditEntryInfo of +msgid "Variables" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:3 of +msgid "ID of the affected entity (webhook, user, role, etc.)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:4 of +msgid "Changes made to the target_id" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:5 of +msgid "User or app that made the changes" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:6 of +msgid "ID of the entry" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:7 of +msgid "Type of action that occurred" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:8 of +msgid "Additional info for certain event types" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:9 of +msgid "Reason for the change (1-512 characters)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "A class object representing the different types of AuditLogEvents." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:3 of +msgid "1 - Server settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:4 of +msgid "10 - Channel was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:5 of +msgid "11 - Channel settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:6 of +msgid "12 - Channel was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:7 of +msgid "13 - Permission overwrite was added to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:8 of +msgid "14 - Permission overwrite was updated for a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:9 of +msgid "15 - Permission overwrite was deleted from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:10 of +msgid "20 - Member was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:11 of +msgid "21 - Members were pruned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:12 of +msgid "22 - Member was banned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:13 of +msgid "23 - Server ban was lifted for a member" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:14 of +msgid "24 - Member was updated in server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:15 of +msgid "25 - Member was added or removed from a role" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:16 of +msgid "26 - Member was moved to a different voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:17 of +msgid "27 - Member was disconnected from a voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:18 of +msgid "28 - Bot user was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:19 of +msgid "30 - Role was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:20 of +msgid "31 - Role was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:21 of +msgid "32 - Role was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:22 of +msgid "40 - Server invite was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:23 of +msgid "41 - Server invite was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:24 of +msgid "42 - Server invite was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:25 of +msgid "50 - Webhook was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:26 of +msgid "51 - Webhook properties or channel were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:27 of +msgid "52 - Webhook was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:28 of +msgid "60 - Emoji was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:29 of +msgid "61 - Emoji name was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:30 of +msgid "62 - Emoji was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:31 of +msgid "72 - Single message was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:32 of +msgid "73 - Multiple messages were deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:33 of +msgid "74 - Message was pinned to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:34 of +msgid "75 - Message was unpinned from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:35 of +msgid "80 - App was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:36 of +msgid "81 - App was updated (as an example, its scopes were updated)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:37 of +msgid "82 - App was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:38 of +msgid "83 - Stage instance was created (stage channel becomes live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:39 of +msgid "84 - Stage instance details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:40 of +msgid "85 - Stage instance was deleted (stage channel no longer live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:41 of +msgid "90 - Sticker was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:42 of +msgid "91 - Sticker details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:43 of +msgid "92 - Sticker was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:44 of +msgid "100 - Event was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:45 of +msgid "101 - Event was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:46 of +msgid "102 - Event was cancelled" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:47 of +msgid "110 - Thread was created in a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:48 of +msgid "111 - Thread was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:49 of +msgid "112 - Thread was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:50 of +msgid "121 - Permissions were updated for a command" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:51 of +msgid "140 - Auto Moderation rule was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:52 of +msgid "141 - Auto Moderation rule was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:53 of +msgid "142 - Auto Moderation rule was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:54 of +msgid "143 - Message was blocked by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:55 of +msgid "144 - Message was flagged by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:56 of +msgid "145 - Member was timed out by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents of +msgid "Member Type" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid ":py:class:`int`" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:1 of +msgid "A class object representing the audit logs of a guild." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:3 of +msgid "List of audit log entries, sorted from most to least recent." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:4 of +msgid "List of auto moderation rules referenced in the audit log." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:5 of +msgid "List of guild scheduled events referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:6 of +msgid "List of partial integration objects" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:7 of +msgid "List of threads referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:8 of +msgid "List of users referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:9 of +msgid "List of webhooks referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:1 of +msgid "A class object representing an AuditLogChange." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:3 of +msgid "New value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:4 of +msgid "Old value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:5 of +msgid "" +"Name of the changed entity, with a few " +"[exceptions](https://discord.com/developers/docs/resources/audit-log" +"#audit-log-change-object-audit-log-change-exceptions)" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:1 of +msgid "A class object representing OptionalAuditEntryInfo." +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:3 of +msgid "" +"ID of the app whose permissions were targeted. ``AuditLogEvents``-type: " +"121" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:4 of +msgid "" +"Channel in which the entities were targeted. ``AuditLogEvents``-types: " +"26, 74, 75, 72, 83, 84, 85" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:5 of +msgid "" +"Name of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:6 of +msgid "" +"Trigger type of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:7 of +msgid "" +"Number of entities that were targeted. ``AuditLogEvents``-types: 72, 73, " +"27, 26" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:8 of +msgid "" +"Number of days after which inactive members were kicked. " +"``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:9 of +msgid "ID of the overwritten entity. ``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:10 of +msgid "Number of members removed by the prune. ``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:11 of +msgid "ID of the message that was targeted. ``AuditLogEvents``-types: 74, 75" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:12 of +msgid "" +"Name of the role if type is \"0\" (not present if type is \"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:13 of +msgid "" +"Type of overwritten entity - role (\"0\") or member (\"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.models.channel.po b/docs/locale/pl/LC_MESSAGES/api.models.channel.po index 1ca5f1ac3..81a65bd8e 100644 --- a/docs/locale/pl/LC_MESSAGES/api.models.channel.po +++ b/docs/locale/pl/LC_MESSAGES/api.models.channel.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.channel.rst:4 msgid "Channel Models" @@ -39,22 +39,24 @@ msgid "Valid values are as follows:" msgstr "" #: interactions.api.models.channel.Thread:1 of -msgid "An object representing a thread." -msgstr "" - -#: interactions.api.models.channel.Thread:4 of -msgid "" -"This is a derivation of the base Channel, since a thread can be its own " -"event." +msgid "An object representing a thread. .. note::" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator +#: interactions.api.models.channel.AsyncTypingContextManager #: interactions.api.models.channel.Channel #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.modify #: interactions.api.models.channel.Channel.pin_message @@ -72,6 +74,9 @@ msgstr "" #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit #: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit #: interactions.api.models.channel.Thread #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of @@ -88,7 +93,7 @@ msgid "" "needed to be used directly." msgstr "" -#: interactions.api.models.channel.Channel +#: interactions.api.models.channel.Channel interactions.api.models.channel.Tags #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of msgid "Variables" @@ -183,33 +188,64 @@ msgid "The amount of members in the channel." msgstr "" #: interactions.api.models.channel.Channel:29 of -msgid "The thread metadata of the channel." +msgid "Boolean representing if a thread is created." msgstr "" #: interactions.api.models.channel.Channel:30 of -msgid "The member of the thread in the channel." +msgid "The thread metadata of the channel." msgstr "" #: interactions.api.models.channel.Channel:31 of +msgid "The member of the thread in the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:32 of msgid "" "The set auto-archive time for all threads to naturally follow in the " "channel." msgstr "" -#: interactions.api.models.channel.Channel:32 of +#: interactions.api.models.channel.Channel:33 of msgid "The permissions of the channel." msgstr "" -#: interactions.api.models.channel.Channel.mention:1 of -msgid "Returns a string that allows you to mention the given channel." +#: interactions.api.models.channel.Channel:34 of +msgid "The flags of the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:35 of +msgid "Number of messages ever sent in a thread." +msgstr "" + +#: interactions.api.models.channel.Channel:36 of +msgid "" +"The default slowmode delay in seconds for threads, if this channel is a " +"forum." +msgstr "" + +#: interactions.api.models.channel.Channel:37 of +msgid "Tags in a forum channel, if any." +msgstr "" + +#: interactions.api.models.channel.Channel:38 of +msgid "Default reaction emoji for threads created in a forum, if any." +msgstr "" + +#: interactions.api.models.channel.Channel.typing:1 of +msgid "Manages the typing of the channel. Use with `await` or `async with`" msgstr "" #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.mention #: interactions.api.models.channel.Channel.modify @@ -224,24 +260,33 @@ msgstr "" #: interactions.api.models.channel.Channel.set_position #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic -#: interactions.api.models.channel.Channel.set_user_limit of +#: interactions.api.models.channel.Channel.set_user_limit +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Tags.edit of msgid "Returns" msgstr "" -#: interactions.api.models.channel.Channel.mention:3 of -msgid "The string of the mentioned channel." +#: interactions.api.models.channel.Channel.typing:3 of +msgid "A manager for typing" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator.flatten #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread #: interactions.api.models.channel.Channel.delete +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages #: interactions.api.models.channel.Channel.get_webhooks +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.join #: interactions.api.models.channel.Channel.leave #: interactions.api.models.channel.Channel.lock @@ -261,10 +306,44 @@ msgstr "" #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit -#: interactions.api.models.channel.Channel.unpin_message of +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit of msgid "Return type" msgstr "" +#: interactions.api.models.channel.Channel.mention:1 of +msgid "Returns a string that allows you to mention the given channel." +msgstr "" + +#: interactions.api.models.channel.Channel.mention:3 of +msgid "The string of the mentioned channel." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:7 +#: interactions.api.models.channel.Channel.history:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:9 +#: interactions.api.models.channel.Channel.history:3 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:13 +#: interactions.api.models.channel.Channel.history:5 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.channel.Channel.history:7 of +msgid "A custom check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.Channel.history:10 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" + #: interactions.api.models.channel.Channel.send:1 of msgid "Sends a message in the channel." msgstr "" @@ -292,7 +371,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.channel.Channel.send:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.channel.Channel.send:15 of @@ -625,10 +704,12 @@ msgstr "" msgid "Creates a thread in the Channel." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:3 #: interactions.api.models.channel.Channel.create_thread:3 of msgid "The name of the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:5 #: interactions.api.models.channel.Channel.create_thread:5 of msgid "" "duration in minutes to automatically archive the thread after recent " @@ -649,6 +730,7 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:16 #: interactions.api.models.channel.Channel.create_thread:14 of msgid "An optional reason for the audit log" msgstr "" @@ -734,6 +816,109 @@ msgstr "" msgid "Add the bot to the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:4 +#: interactions.api.models.channel.Channel.edit_tag:4 +#: interactions.api.models.channel.Tags.edit:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:7 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:9 +#: interactions.api.models.channel.Channel.edit_tag:11 +#: interactions.api.models.channel.Tags.edit:11 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:11 +#: interactions.api.models.channel.Channel.edit_tag:13 +#: interactions.api.models.channel.Tags.edit:13 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:13 of +msgid "The create tag object" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:1 of +msgid "Edits a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:7 of +msgid "The ID of the tag to edit" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:9 +#: interactions.api.models.channel.Tags.edit:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:15 +#: interactions.api.models.channel.Tags.edit:15 of +msgid "The modified tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:1 of +msgid "Deletes a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:3 of +msgid "The ID of the Tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:1 of +msgid "Creates a new post inside a forum channel" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:8 of +msgid "The content to send as first message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:10 of +msgid "Tags to give to the created thread" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:12 of +msgid "An optional list of files to send attached to the message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:14 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:18 of +msgid "A channel of ChannelType 11 (THREAD)" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:1 of +msgid "Returns the permissions of the member in this specific channel." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:4 of +msgid "" +"The permissions returned by this function take into account role and user" +" overwrites that can be assigned to channels or categories. If you don't " +"need these overwrites, look into :meth:`.Member.get_guild_permissions`." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:8 of +msgid "The member to get the permissions from" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:10 of +msgid "Permissions of the member in this channel" +msgstr "" + #: interactions.api.models.channel.ThreadMember:1 of msgid "A class object representing a member in a thread." msgstr "" @@ -793,3 +978,83 @@ msgstr "" #: interactions.api.models.channel.ThreadMetadata:11 of msgid "The ability to invite users to the thread." msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:3 +#: interactions.api.models.channel.AsyncTypingContextManager:5 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:11 of +msgid "A check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:1 of +msgid "An async context manager for triggering typing." +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:3 of +msgid "The channel to trigger typing in." +msgstr "" + +#: interactions.api.models.channel.Tags:1 of +msgid "An object denoting a tag object within a forum channel." +msgstr "" + +#: interactions.api.models.channel.Tags:4 of +msgid "If the emoji is custom, it won't have name information." +msgstr "" + +#: interactions.api.models.channel.Tags:6 of +msgid "Name of the tag. The limit is up to 20 characters." +msgstr "" + +#: interactions.api.models.channel.Tags:7 of +msgid "ID of the tag. Can also be 0 if manually created." +msgstr "" + +#: interactions.api.models.channel.Tags:8 of +msgid "" +"A boolean denoting whether this tag can be removed/added by moderators " +"with ``manage_threads`` permissions." +msgstr "" + +#: interactions.api.models.channel.Tags:9 of +msgid "The emoji to represent the tag, if any." +msgstr "" + +#: interactions.api.models.channel.Tags.delete:1 of +msgid "Deletes this tag" +msgstr "" + +#: interactions.api.models.channel.Tags.delete:3 +#: interactions.api.models.channel.Tags.edit:7 of +msgid "The ID of the channel where the tag belongs to" +msgstr "" + +#: interactions.api.models.channel.Tags.edit:1 of +msgid "Edits this tag" +msgstr "" + +#~ msgid "An object representing a thread." +#~ msgstr "" + +#~ msgid "" +#~ "This is a derivation of the base" +#~ " Channel, since a thread can be " +#~ "its own event." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.models.emoji.po b/docs/locale/pl/LC_MESSAGES/api.models.emoji.po new file mode 100644 index 000000000..2809ce66e --- /dev/null +++ b/docs/locale/pl/LC_MESSAGES/api.models.emoji.po @@ -0,0 +1,139 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-29 13:24-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.emoji.rst:4 +msgid "Emoji Models" +msgstr "" + +#: interactions.api.models.emoji.Emoji:1 of +msgid "A class objecting representing an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji of +msgid "Variables" +msgstr "" + +#: interactions.api.models.emoji.Emoji:3 of +msgid "Emoji id" +msgstr "" + +#: interactions.api.models.emoji.Emoji:4 of +msgid "Emoji name." +msgstr "" + +#: interactions.api.models.emoji.Emoji:5 of +msgid "Roles allowed to use this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:6 of +msgid "User that created this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:7 of +msgid "Status denoting of this emoji must be wrapped in colons" +msgstr "" + +#: interactions.api.models.emoji.Emoji:8 of +msgid "Status denoting if this emoji is managed (by an integration)" +msgstr "" + +#: interactions.api.models.emoji.Emoji:9 of +msgid "Status denoting if this emoji is animated" +msgstr "" + +#: interactions.api.models.emoji.Emoji:10 of +msgid "" +"Status denoting if this emoji can be used. (Can be false via server " +"boosting)" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:1 of +msgid "Gets an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild of +msgid "Parameters" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:3 of +msgid "The id of the guild of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:5 of +msgid "The id of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:7 +#: interactions.api.models.emoji.Emoji.get_all_of_guild:5 of +msgid "The HTTPClient of your bot. Equals to ``bot._http``" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Returns" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:9 of +msgid "The Emoji as object" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Return type" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:1 of +msgid "Gets all emoji of a guild." +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:3 of +msgid "The id of the guild to get the emojis of" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:7 of +msgid "The Emoji as list" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:1 of +msgid "Deletes the emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:3 of +msgid "The guild id to delete the emoji from" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:5 of +msgid "The reason of the deletion" +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:1 of +msgid "Returns the emoji's URL." +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:3 of +msgid "URL of the emoji" +msgstr "" + +#~ msgid "Audit-Log Models" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.models.guild.po b/docs/locale/pl/LC_MESSAGES/api.models.guild.po index a233b694b..6a195d3a5 100644 --- a/docs/locale/pl/LC_MESSAGES/api.models.guild.po +++ b/docs/locale/pl/LC_MESSAGES/api.models.guild.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:25-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.guild.rst:4 msgid "Guild Models" @@ -85,6 +85,7 @@ msgstr "" msgid "The location of the event, if any." msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator #: interactions.api.models.guild.EventMetadata #: interactions.api.models.guild.Guild #: interactions.api.models.guild.Guild.add_member_role @@ -95,17 +96,25 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji #: interactions.api.models.guild.Guild.delete_role #: interactions.api.models.guild.Guild.delete_scheduled_event +#: interactions.api.models.guild.Guild.delete_sticker +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule @@ -115,6 +124,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -672,13 +683,26 @@ msgid "The id of the member to ban" msgstr "" #: interactions.api.models.guild.Guild.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.guild.Guild.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:13 of +msgid "The reason of the ban" msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator.flatten #: interactions.api.models.guild.Guild.add_member_role #: interactions.api.models.guild.Guild.ban #: interactions.api.models.guild.Guild.clone_channel @@ -687,6 +711,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji @@ -698,13 +723,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.leave #: interactions.api.models.guild.Guild.list_auto_moderation_rules @@ -716,6 +749,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -840,6 +875,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_channel #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.get_all_active_threads #: interactions.api.models.guild.Guild.get_all_bans @@ -847,13 +883,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule #: interactions.api.models.guild.Guild.modify_channel @@ -862,6 +906,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.search_members of msgid "Returns" msgstr "" @@ -1508,6 +1554,20 @@ msgstr "" msgid "The created event" msgstr "" +#: interactions.api.models.guild.Guild.get_scheduled_events:1 of +msgid "Gets all scheduled events of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:3 of +msgid "" +"A boolean to include number of users subscribed to the associated event, " +"if given." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:5 of +msgid "The sheduled events of the guild." +msgstr "" + #: interactions.api.models.guild.Guild.modify_scheduled_event:1 of msgid "Edits a scheduled event of the guild." msgstr "" @@ -1614,6 +1674,40 @@ msgstr "" msgid "Gets all bans of the guild." msgstr "" +#: interactions.api.models.guild.Guild.prune:1 of +msgid "Begins a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:3 +#: interactions.api.models.guild.Guild.prune:3 of +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:4 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:4 +#: interactions.api.models.guild.Guild.prune:5 of +msgid "Role IDs to include, if given." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:6 of +msgid "" +"The number of pruned members, if compute_prune_count is not false. " +"Otherwise returns None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:1 of +msgid "Returns the number of members that would be removed in a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:5 of +msgid "The number of members that would be pruned." +msgstr "" + #: interactions.api.models.guild.Guild.get_emoji:1 of msgid "Gets an emoji of the guild and returns it." msgstr "" @@ -1664,6 +1758,77 @@ msgstr "" msgid "The emoji or the id of the emoji to delete" msgstr "" +#: interactions.api.models.guild.Guild.get_stickers:1 of +msgid "Get the stickers for a guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_stickers:3 of +msgid "List of stickers of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:1 of +msgid "Gets the list of sticker packs available to Nitro subscribers." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:3 of +msgid "List of sticker packs." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:1 of +msgid "Creates a new sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:3 of +msgid "The file of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:5 of +msgid "The tags of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:7 +#: interactions.api.models.guild.Guild.modify_sticker:5 of +msgid "The name of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:9 +#: interactions.api.models.guild.Guild.modify_sticker:7 of +msgid "The description of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:11 of +msgid "The reason of the creation." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:13 of +msgid "Created sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:1 of +msgid "Modifies the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:3 +#: interactions.api.models.guild.Guild.modify_sticker:3 of +msgid "The sticker or ID of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:9 of +msgid "The reason of the modification." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:11 of +msgid "Modified sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:1 of +msgid "Deletes the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:5 of +msgid "The reason of the deletion." +msgstr "" + #: interactions.api.models.guild.Guild.get_list_of_members:1 of msgid "Lists the members of a guild." msgstr "" @@ -1710,6 +1875,23 @@ msgstr "" msgid "Returns a list of all members of the guild" msgstr "" +#: interactions.api.models.guild.Guild.get_members:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:11 +#: interactions.api.models.guild.Guild.get_members:3 of +msgid "A set maximum of members to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:5 of +msgid "A custom check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:8 of +msgid "An asynchronous iterator over the members of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.list_auto_moderation_rules:1 of msgid "Lists all AutoMod rules" msgstr "" @@ -1784,6 +1966,55 @@ msgstr "" msgid "The rule to modify" msgstr "" +#: interactions.api.models.guild.Guild.get_audit_logs:1 of +msgid "Gets the audit logs of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:3 of +msgid "How many entries to get, default 100" +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:5 +#: interactions.api.models.guild.Guild.get_full_audit_logs:3 of +msgid "User ID snowflake. filter the log for actions made by a user." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:7 of +msgid "The Type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:9 of +msgid "filter the log before a certain entry id." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:11 of +msgid "The guild audit logs" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:1 of +msgid "Gets the latest audit log action of either a user or an action type" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:3 of +msgid "The user, user id or action type to look for" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:5 of +msgid "The latest AuditLog action that applies to the ``of`` parameter" +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:1 of +msgid "Gets the full audit log of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:5 of +msgid "The type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:7 of +msgid "The full AuditLog of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.icon_url:1 of msgid "" "Returns the URL of the guild's icon. :return: URL of the guild's icon " @@ -1897,3 +2128,32 @@ msgstr "" #: interactions.api.models.guild.Invite.delete:1 of msgid "Deletes the invite" msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:3 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:5 of +msgid "The guild to get the members from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:7 of +msgid "" +"The member ID to start getting members from (gets all members after that " +"member)" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:9 of +msgid "A check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.models.gw.po b/docs/locale/pl/LC_MESSAGES/api.models.gw.po index fe823c232..88a920629 100644 --- a/docs/locale/pl/LC_MESSAGES/api.models.gw.po +++ b/docs/locale/pl/LC_MESSAGES/api.models.gw.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.gw.rst:4 msgid "Gateway-specific Event Models" @@ -42,10 +42,10 @@ msgstr "" #: interactions.api.models.gw.GuildScheduledEventUser #: interactions.api.models.gw.GuildStickers #: interactions.api.models.gw.Integration +#: interactions.api.models.gw.MessageDelete #: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList +#: interactions.api.models.gw.MessageReactionRemove +#: interactions.api.models.gw.Presence interactions.api.models.gw.ThreadList #: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks #: of msgid "Variables" @@ -93,36 +93,6 @@ msgstr "" msgid "The substring in content that triggered rule." msgstr "" -#: interactions.api.models.gw.ApplicationCommandPermissions -#: interactions.api.models.gw.AutoModerationAction -#: interactions.api.models.gw.AutoModerationRule -#: interactions.api.models.gw.ChannelPins -#: interactions.api.models.gw.EmbeddedActivity -#: interactions.api.models.gw.GuildBan interactions.api.models.gw.GuildEmojis -#: interactions.api.models.gw.GuildIntegrations -#: interactions.api.models.gw.GuildJoinRequest -#: interactions.api.models.gw.GuildMember -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send -#: interactions.api.models.gw.GuildMembers interactions.api.models.gw.GuildRole -#: interactions.api.models.gw.GuildScheduledEvent -#: interactions.api.models.gw.GuildScheduledEventUser -#: interactions.api.models.gw.GuildStickers -#: interactions.api.models.gw.Integration -#: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList -#: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks -#: of -msgid "Parameters" -msgstr "" - #: interactions.api.models.gw.AutoModerationRule:1 of msgid "" "A class object representing the gateway events " @@ -232,14 +202,14 @@ msgstr "" #: interactions.api.models.gw.GuildEmojis:3 #: interactions.api.models.gw.GuildIntegrations:3 #: interactions.api.models.gw.GuildJoinRequest:7 -#: interactions.api.models.gw.GuildMember:3 #: interactions.api.models.gw.GuildMembers:3 #: interactions.api.models.gw.GuildRole:3 #: interactions.api.models.gw.GuildStickers:3 #: interactions.api.models.gw.Integration:23 +#: interactions.api.models.gw.MessageDelete:5 #: interactions.api.models.gw.MessageReaction:6 +#: interactions.api.models.gw.MessageReactionRemove:10 #: interactions.api.models.gw.Presence:4 -#: interactions.api.models.gw.ReactionRemove:10 #: interactions.api.models.gw.ThreadList:3 #: interactions.api.models.gw.ThreadMembers:4 of msgid "The guild ID of the event." @@ -251,8 +221,9 @@ msgstr "" #: interactions.api.models.gw.ChannelPins:4 #: interactions.api.models.gw.EmbeddedActivity:9 +#: interactions.api.models.gw.MessageDelete:4 #: interactions.api.models.gw.MessageReaction:4 -#: interactions.api.models.gw.ReactionRemove:8 of +#: interactions.api.models.gw.MessageReactionRemove:8 of msgid "The channel ID of the event." msgstr "" @@ -312,7 +283,6 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildBan:4 -#: interactions.api.models.gw.GuildMember:5 #: interactions.api.models.gw.Integration:17 #: interactions.api.models.gw.Presence:3 of msgid "The user of the event." @@ -378,14 +348,21 @@ msgstr "" msgid "The members of the thread of the event." msgstr "" -#: interactions.api.models.gw.ReactionRemove:1 of +#: interactions.api.models.gw.MessageDelete:1 of +msgid "A class object representing the gateway event ``MESSAGE_DELETE_BULK``." +msgstr "" + +#: interactions.api.models.gw.MessageDelete:3 of +msgid "The message IDs of the event." +msgstr "" + +#: interactions.api.models.gw.MessageReactionRemove:1 of msgid "" "A class object representing the gateway events " -"``MESSAGE_REACTION_REMOVE``, ``MESSAGE_REACTION_REMOVE_ALL`` and " -"``MESSAGE_REACTION_REMOVE_EMOJI``." +"``MESSAGE_REACTION_REMOVE_ALL`` and ``MESSAGE_REACTION_REMOVE_EMOJI``." msgstr "" -#: interactions.api.models.gw.ReactionRemove:4 of +#: interactions.api.models.gw.MessageReactionRemove:4 of msgid "" "This class inherits the already existing attributes of " ":class:`interactions.api.models.gw.Reaction`. The main missing attribute " @@ -394,22 +371,24 @@ msgstr "" #: interactions.api.models.gw.GuildJoinRequest:6 #: interactions.api.models.gw.MessageReaction:3 -#: interactions.api.models.gw.ReactionRemove:7 of +#: interactions.api.models.gw.MessageReactionRemove:7 of msgid "The user ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:5 -#: interactions.api.models.gw.ReactionRemove:9 of +#: interactions.api.models.gw.MessageReactionRemove:9 of msgid "The message ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:8 -#: interactions.api.models.gw.ReactionRemove:11 of +#: interactions.api.models.gw.MessageReactionRemove:11 of msgid "The emoji of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:1 of -msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +msgid "" +"A class object representing the gateway event ``MESSAGE_REACTION_ADD`` " +"and ``MESSAGE_REACTION_REMOVE``." msgstr "" #: interactions.api.models.gw.MessageReaction:7 of @@ -473,204 +452,58 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildMember:4 of -msgid "The roles of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:6 of -msgid "The nickname of the user of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:7 of -msgid "The avatar URL of the user of the event." +msgid "" +"``pending`` and ``permissions`` only apply for members retroactively " +"requiring to verify rules via. membership screening or lack permissions " +"to speak." msgstr "" #: interactions.api.models.gw.GuildMember:8 of -msgid "The time that the user of the event joined at." +msgid "The guild ID." msgstr "" #: interactions.api.models.gw.GuildMember:9 of -msgid "The time that the user of the event has since had \"premium.\"" +msgid "The user of the guild." msgstr "" #: interactions.api.models.gw.GuildMember:10 of -msgid "Whether the member of the event is deafened or not." +msgid "The nickname of the member." msgstr "" #: interactions.api.models.gw.GuildMember:11 of -msgid "Whether the member of the event is muted or not." +msgid "The hash containing the user's guild avatar, if applicable." msgstr "" #: interactions.api.models.gw.GuildMember:12 of -msgid "" -"Whether the member of the event is still pending -- pass membership " -"screening -- or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:1 of -msgid "Returns the ID of the user." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.send of -msgid "Returns" -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:3 of -msgid "The ID of the user" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send of -msgid "Return type" -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:1 of -msgid "Returns the string of either the user's nickname or username." -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:3 of -msgid "The name of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:1 of -msgid "Returns a string that allows you to mention the given member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:3 of -msgid "The string of the mentioned member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:1 of -msgid "Bans the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:3 of -msgid "The reason of the ban" -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:1 of -msgid "Kicks the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:3 of -msgid "The reason for the kick" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:1 of -msgid "This method adds a role to a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:3 of -msgid "The role to add. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:5 of -msgid "The reason why the roles are added" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:1 of -msgid "This method removes a role from a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:3 of -msgid "The role to remove. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:5 of -msgid "The reason why the roles are removed" -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:1 of -msgid "Sends a DM to the member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:3 of -msgid "The contents of the message as a string or string-converted value." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:5 of -msgid "A component, or list of components for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:7 of -msgid "Whether the message utilizes the text-to-speech Discord programme or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:9 of -msgid "A file or list of files to be attached to the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:11 of -msgid "An embed, or list of embeds for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:13 of -msgid "The message interactions/mention limits that the message can refer to." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:15 of -msgid "The sent message as an object." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:1 of -msgid "Modifies the member of a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:3 of -msgid "The nickname of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:5 of -msgid "A list of all role ids the member has" +msgid "The list of roles of the member." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:7 of -msgid "whether the user is muted in voice channels" +#: interactions.api.models.gw.GuildMember:13 of +msgid "The timestamp the member joined the guild at." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:9 of -msgid "whether the user is deafened in voice channels" +#: interactions.api.models.gw.GuildMember:14 of +msgid "The timestamp the member has been a server booster since." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:11 of -msgid "id of channel to move user to (if they are connected to voice)" +#: interactions.api.models.gw.GuildMember:15 of +msgid "Whether the member is deafened." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:13 of -msgid "" -"when the user's timeout will expire and the user will be able to " -"communicate in the guild again (up to 28 days in the future)" +#: interactions.api.models.gw.GuildMember:16 of +msgid "Whether the member is muted." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:15 of -msgid "The reason of the modifying" +#: interactions.api.models.gw.GuildMember:17 of +msgid "Whether the member is pending to pass membership screening." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:17 of -msgid "The modified member object" +#: interactions.api.models.gw.GuildMember:18 of +msgid "Whether the member has permissions." msgstr "" -#: interactions.api.models.gw.GuildMember.add_to_thread:1 of -msgid "Adds the member to a thread." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_to_thread:3 of -msgid "The id of the thread to add the member to" +#: interactions.api.models.gw.GuildMember:19 of +msgid "How long until they're unmuted, if any." msgstr "" #: interactions.api.models.gw.GuildStickers:1 of @@ -823,3 +656,164 @@ msgstr "" #: interactions.api.models.gw.GuildRole:5 of msgid "The role ID of the event." msgstr "" + +#~ msgid "" +#~ "A class object representing the gateway" +#~ " events ``MESSAGE_REACTION_REMOVE``, " +#~ "``MESSAGE_REACTION_REMOVE_ALL`` and " +#~ "``MESSAGE_REACTION_REMOVE_EMOJI``." +#~ msgstr "" + +#~ msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +#~ msgstr "" + +#~ msgid "The roles of the event." +#~ msgstr "" + +#~ msgid "The nickname of the user of the event." +#~ msgstr "" + +#~ msgid "The avatar URL of the user of the event." +#~ msgstr "" + +#~ msgid "The time that the user of the event joined at." +#~ msgstr "" + +#~ msgid "The time that the user of the event has since had \"premium.\"" +#~ msgstr "" + +#~ msgid "Whether the member of the event is deafened or not." +#~ msgstr "" + +#~ msgid "Whether the member of the event is muted or not." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the member of the event is" +#~ " still pending -- pass membership " +#~ "screening -- or not." +#~ msgstr "" + +#~ msgid "Returns the ID of the user." +#~ msgstr "" + +#~ msgid "Returns" +#~ msgstr "" + +#~ msgid "The ID of the user" +#~ msgstr "" + +#~ msgid "Return type" +#~ msgstr "" + +#~ msgid "Returns the string of either the user's nickname or username." +#~ msgstr "" + +#~ msgid "The name of the member" +#~ msgstr "" + +#~ msgid "Returns a string that allows you to mention the given member." +#~ msgstr "" + +#~ msgid "The string of the mentioned member." +#~ msgstr "" + +#~ msgid "Bans the member from a guild." +#~ msgstr "" + +#~ msgid "The reason of the ban" +#~ msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Kicks the member from a guild." +#~ msgstr "" + +#~ msgid "The reason for the kick" +#~ msgstr "" + +#~ msgid "This method adds a role to a member." +#~ msgstr "" + +#~ msgid "The role to add. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are added" +#~ msgstr "" + +#~ msgid "This method removes a role from a member." +#~ msgstr "" + +#~ msgid "The role to remove. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are removed" +#~ msgstr "" + +#~ msgid "Sends a DM to the member." +#~ msgstr "" + +#~ msgid "The contents of the message as a string or string-converted value." +#~ msgstr "" + +#~ msgid "A component, or list of components for the message." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the message utilizes the " +#~ "text-to-speech Discord programme or " +#~ "not." +#~ msgstr "" + +#~ msgid "A file or list of files to be attached to the message." +#~ msgstr "" + +#~ msgid "An embed, or list of embeds for the message." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The sent message as an object." +#~ msgstr "" + +#~ msgid "Modifies the member of a guild." +#~ msgstr "" + +#~ msgid "The nickname of the member" +#~ msgstr "" + +#~ msgid "A list of all role ids the member has" +#~ msgstr "" + +#~ msgid "whether the user is muted in voice channels" +#~ msgstr "" + +#~ msgid "whether the user is deafened in voice channels" +#~ msgstr "" + +#~ msgid "id of channel to move user to (if they are connected to voice)" +#~ msgstr "" + +#~ msgid "" +#~ "when the user's timeout will expire " +#~ "and the user will be able to " +#~ "communicate in the guild again (up " +#~ "to 28 days in the future)" +#~ msgstr "" + +#~ msgid "The reason of the modifying" +#~ msgstr "" + +#~ msgid "The modified member object" +#~ msgstr "" + +#~ msgid "Adds the member to a thread." +#~ msgstr "" + +#~ msgid "The id of the thread to add the member to" +#~ msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.models.member.po b/docs/locale/pl/LC_MESSAGES/api.models.member.po index ce23f99ac..f5839f391 100644 --- a/docs/locale/pl/LC_MESSAGES/api.models.member.po +++ b/docs/locale/pl/LC_MESSAGES/api.models.member.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.member.rst:4 msgid "Member Models" @@ -86,6 +86,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.modify #: interactions.api.models.member.Member.remove_role @@ -93,10 +95,20 @@ msgstr "" msgid "Parameters" msgstr "" +#: interactions.api.models.member.Member.guild_id:1 of +msgid "" +"Attempts to get the guild ID the member is in. Only works then roles or " +"nick or joined at is present. :return: The ID of the guild this member " +"belongs to." +msgstr "" + #: interactions.api.models.member.Member.id:1 of msgid "Returns the ID of the user." msgstr "" +#: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.mention #: interactions.api.models.member.Member.modify @@ -113,6 +125,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.mention @@ -148,11 +162,23 @@ msgid "The id of the guild to ban the member from" msgstr "" #: interactions.api.models.member.Member.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.member.Member.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.member.Member.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.member.Member.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.member.Member.ban:13 of +msgid "The reason of the ban" msgstr "" #: interactions.api.models.member.Member.kick:1 of @@ -230,7 +256,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.member.Member.send:15 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.member.Member.send:17 of @@ -288,9 +314,83 @@ msgid "The id of the thread to add the member to" msgstr "" #: interactions.api.models.member.Member.get_avatar_url:1 of +msgid "Returns the URL of the member's avatar for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:3 of +msgid "The id of the guild to get the member's avatar from" +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:5 of +msgid "URL of the members's avatar (None will be returned if no avatar is set)" +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:1 of +msgid "Returns the permissions of the member for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:4 of msgid "" -"Returns the URL of the member's avatar for the specified guild. :param " -"guild_id: The id of the guild to get the member's avatar from :type " -"guild_id: Union[int, Snowflake, \"Guild\"] :return: URL of the members's " -"avatar (None will be returned if no avatar is set) :rtype: str" +"The permissions returned by this function will not take into account role" +" and user overwrites that can be assigned to channels or categories. If " +"you need these overwrites, look into " +":meth:`.Channel.get_permissions_for`." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:8 of +msgid "The guild of the member" msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:10 of +msgid "Base permissions of the member in the specified guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:1 of +msgid "Returns whether the member has the permissions passed." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:4 of +msgid "" +"If the channel argument is present, the function will look if the member " +"has the permissions in the specified channel. If the argument is missing," +" then it will only consider the member's guild permissions." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:7 of +msgid "The list of permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:9 of +msgid "The channel where to check for permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:11 of +msgid "The id of the guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:13 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:15 of +msgid "Whether the member has the permissions" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "" +#~ "Returns the URL of the member's " +#~ "avatar for the specified guild. :param" +#~ " guild_id: The id of the guild " +#~ "to get the member's avatar from " +#~ ":type guild_id: Union[int, Snowflake, " +#~ "\"Guild\"] :return: URL of the members's" +#~ " avatar (None will be returned if " +#~ "no avatar is set) :rtype: str" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.models.message.po b/docs/locale/pl/LC_MESSAGES/api.models.message.po index 5bcd77f9c..e1f033a87 100644 --- a/docs/locale/pl/LC_MESSAGES/api.models.message.po +++ b/docs/locale/pl/LC_MESSAGES/api.models.message.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.message.rst:4 msgid "Message Models" @@ -50,14 +50,14 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji #: interactions.api.models.message.Message #: interactions.api.models.message.MessageActivity #: interactions.api.models.message.MessageInteraction #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Variables" msgstr "" @@ -156,33 +156,33 @@ msgid "" msgstr "" #: interactions.api.models.message.Message:26 of -msgid "The allowed mentions of roles attached in the message." -msgstr "" - -#: interactions.api.models.message.Message:27 of msgid "Message flags" msgstr "" -#: interactions.api.models.message.Message:28 of +#: interactions.api.models.message.Message:27 of msgid "Message interaction object, if the message is sent by an interaction." msgstr "" -#: interactions.api.models.message.Message:29 of +#: interactions.api.models.message.Message:28 of msgid "" "The thread that started from this message, if any, with a thread member " "object embedded." msgstr "" +#: interactions.api.models.message.Message:29 of +msgid "Array of Action Rows associated with this message, if any." +msgstr "" + #: interactions.api.models.message.Message:30 of -msgid "Components associated with this message, if any." +msgid "An array of message sticker item objects, if sent with them." msgstr "" #: interactions.api.models.message.Message:31 of -msgid "An array of message sticker item objects, if sent with them." +msgid "Array of sticker objects sent with the message if any. Deprecated." msgstr "" #: interactions.api.models.message.Message:32 of -msgid "Array of sticker objects sent with the message if any. Deprecated." +msgid "The approximate position of the message in a thread." msgstr "" #: interactions.api.models.message.Attachment @@ -202,10 +202,6 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild #: interactions.api.models.message.Message #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread @@ -222,7 +218,8 @@ msgstr "" #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Parameters" msgstr "" @@ -230,6 +227,7 @@ msgstr "" msgid "Gets the channel where the message was sent." msgstr "" +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Embed.add_field #: interactions.api.models.message.Embed.clear_fields #: interactions.api.models.message.Embed.insert_field_at @@ -241,13 +239,10 @@ msgstr "" #: interactions.api.models.message.Embed.set_image #: interactions.api.models.message.Embed.set_thumbnail #: interactions.api.models.message.Embed.set_video -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread #: interactions.api.models.message.Message.delete +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_channel #: interactions.api.models.message.Message.get_from_url @@ -307,7 +302,7 @@ msgstr "" #: interactions.api.models.message.Message.edit:13 #: interactions.api.models.message.Message.reply:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.message.Message.edit:15 @@ -323,10 +318,9 @@ msgid "" "components will be removed" msgstr "" -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Message.create_thread +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_from_url #: interactions.api.models.message.Message.get_users_from_reaction @@ -466,6 +460,14 @@ msgstr "" msgid "The URL of said message" msgstr "" +#: interactions.api.models.message.Message.disable_all_components:1 of +msgid "Sets all components to disabled on this message." +msgstr "" + +#: interactions.api.models.message.Message.disable_all_components:3 of +msgid "The modified message." +msgstr "" + #: interactions.api.models.message.MessageReference:1 of msgid "A class object representing the \"referenced\"/replied message." msgstr "" @@ -654,20 +656,26 @@ msgstr "" msgid "Inserts a field in the embed at the specified index" msgstr "" -#: interactions.api.models.message.Embed.insert_field_at:3 -#: interactions.api.models.message.Embed.remove_field:3 -#: interactions.api.models.message.Embed.set_field_at:3 of -msgid "The new field's index" +#: interactions.api.models.message.Embed.insert_field_at:3 of +msgid "The field's index to insert" msgstr "" #: interactions.api.models.message.Embed.set_field_at:1 of msgid "Overwrites the field in the embed at the specified index" msgstr "" +#: interactions.api.models.message.Embed.set_field_at:3 of +msgid "The field's index to overwrite" +msgstr "" + #: interactions.api.models.message.Embed.remove_field:1 of msgid "Remove field at the specified index" msgstr "" +#: interactions.api.models.message.Embed.remove_field:3 of +msgid "The field's index to remove" +msgstr "" + #: interactions.api.models.message.Embed.remove_author:1 of msgid "Removes the embed's author" msgstr "" @@ -906,95 +914,12 @@ msgstr "" msgid "Whether the attachment is ephemeral." msgstr "" -#: interactions.api.models.message.Emoji:1 of -msgid "A class objecting representing an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji:3 of -msgid "Emoji id" -msgstr "" - -#: interactions.api.models.message.Emoji:4 of -msgid "Emoji name." -msgstr "" - -#: interactions.api.models.message.Emoji:5 of -msgid "Roles allowed to use this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:6 of -msgid "User that created this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:7 of -msgid "Status denoting of this emoji must be wrapped in colons" -msgstr "" - -#: interactions.api.models.message.Emoji:8 of -msgid "Status denoting if this emoji is managed (by an integration)" -msgstr "" - -#: interactions.api.models.message.Emoji:9 of -msgid "Status denoting if this emoji is animated" -msgstr "" - -#: interactions.api.models.message.Emoji:10 of -msgid "" -"Status denoting if this emoji can be used. (Can be false via server " -"boosting)" -msgstr "" - -#: interactions.api.models.message.Emoji.get:1 of -msgid "Gets an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.get:3 of -msgid "The id of the guild of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:5 of -msgid "The id of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:7 -#: interactions.api.models.message.Emoji.get_all_of_guild:5 of -msgid "The HTTPClient of your bot. Equals to ``bot._http``" -msgstr "" - -#: interactions.api.models.message.Emoji.get:9 of -msgid "The Emoji as object" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:1 of -msgid "Gets all emoji of a guild." +#: interactions.api.models.message.Attachment.download:1 of +msgid "Downloads the attachment." msgstr "" -#: interactions.api.models.message.Emoji.get_all_of_guild:3 of -msgid "The id of the guild to get the emojis of" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:7 of -msgid "The Emoji as list" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:1 of -msgid "Deletes the emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.delete:3 of -msgid "The guild id to delete the emoji from" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:5 of -msgid "The reason of the deletion" -msgstr "" - -#: interactions.api.models.message.Emoji.url:1 of -msgid "Returns the emoji's URL." -msgstr "" - -#: interactions.api.models.message.Emoji.url:3 of -msgid "URL of the emoji" +#: interactions.api.models.message.Attachment.download:3 of +msgid "The attachment's bytes as BytesIO object" msgstr "" #: interactions.api.models.message.EmbedFooter:1 of @@ -1093,3 +1018,116 @@ msgstr "" #: interactions.api.models.message.Sticker:14 of msgid "The standard sticker's sort order within its pack" msgstr "" + +#: interactions.api.models.message.StickerPack:1 of +msgid "A class objects representing a pack of stickers." +msgstr "" + +#: interactions.api.models.message.StickerPack:3 of +msgid "ID of the sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:4 of +msgid "The stickers in the pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:5 of +msgid "The name of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:6 of +msgid "ID of the pack's SKU." +msgstr "" + +#: interactions.api.models.message.StickerPack:7 of +msgid "ID of a sticker in the pack which is shown as the pack's icon." +msgstr "" + +#: interactions.api.models.message.StickerPack:8 of +msgid "The description of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:9 of +msgid "ID of the sticker pack's banner image." +msgstr "" + +#~ msgid "The allowed mentions of roles attached in the message." +#~ msgstr "" + +#~ msgid "Components associated with this message, if any." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The new field's index" +#~ msgstr "" + +#~ msgid "A class objecting representing an emoji." +#~ msgstr "" + +#~ msgid "Emoji id" +#~ msgstr "" + +#~ msgid "Emoji name." +#~ msgstr "" + +#~ msgid "Roles allowed to use this emoji" +#~ msgstr "" + +#~ msgid "User that created this emoji" +#~ msgstr "" + +#~ msgid "Status denoting of this emoji must be wrapped in colons" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is managed (by an integration)" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is animated" +#~ msgstr "" + +#~ msgid "" +#~ "Status denoting if this emoji can " +#~ "be used. (Can be false via server" +#~ " boosting)" +#~ msgstr "" + +#~ msgid "Gets an emoji." +#~ msgstr "" + +#~ msgid "The id of the guild of the emoji" +#~ msgstr "" + +#~ msgid "The id of the emoji" +#~ msgstr "" + +#~ msgid "The HTTPClient of your bot. Equals to ``bot._http``" +#~ msgstr "" + +#~ msgid "The Emoji as object" +#~ msgstr "" + +#~ msgid "Gets all emoji of a guild." +#~ msgstr "" + +#~ msgid "The id of the guild to get the emojis of" +#~ msgstr "" + +#~ msgid "The Emoji as list" +#~ msgstr "" + +#~ msgid "Deletes the emoji." +#~ msgstr "" + +#~ msgid "The guild id to delete the emoji from" +#~ msgstr "" + +#~ msgid "The reason of the deletion" +#~ msgstr "" + +#~ msgid "Returns the emoji's URL." +#~ msgstr "" + +#~ msgid "URL of the emoji" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.models.misc.po b/docs/locale/pl/LC_MESSAGES/api.models.misc.po index cfed122db..77ec620aa 100644 --- a/docs/locale/pl/LC_MESSAGES/api.models.misc.po +++ b/docs/locale/pl/LC_MESSAGES/api.models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.misc.rst:4 msgid "Miscellanous Models" @@ -27,6 +27,7 @@ msgstr "" msgid "An enumeration." msgstr "" +#: interactions.api.models.misc.AllowedMentionType #: interactions.api.models.misc.AutoModKeywordPresetTypes #: interactions.api.models.misc.AutoModTriggerType of msgid "Member Type" @@ -37,6 +38,7 @@ msgstr "" msgid ":py:class:`int`" msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 #: interactions.api.models.misc.AutoModKeywordPresetTypes:1 #: interactions.api.models.misc.AutoModTriggerType:1 of msgid "Valid values are as follows:" @@ -50,6 +52,7 @@ msgstr "" msgid "The maximum duration for duration_seconds is 2419200 seconds, aka 4 weeks." msgstr "" +#: interactions.api.models.misc.AllowedMentions #: interactions.api.models.misc.AutoModAction #: interactions.api.models.misc.AutoModMetaData #: interactions.api.models.misc.AutoModTriggerMetadata @@ -66,15 +69,6 @@ msgstr "" msgid "Timeout duration in seconds, if timed out." msgstr "" -#: interactions.api.models.misc.AutoModAction -#: interactions.api.models.misc.AutoModMetaData -#: interactions.api.models.misc.AutoModTriggerMetadata -#: interactions.api.models.misc.ClientStatus interactions.api.models.misc.File -#: interactions.api.models.misc.Image interactions.api.models.misc.Overwrite -#: interactions.api.models.misc.Snowflake of -msgid "Parameters" -msgstr "" - #: interactions.api.models.misc.AutoModAction:1 of msgid "" "A class object used for the ``AUTO_MODERATION_ACTION_EXECUTION`` event. " @@ -107,6 +101,53 @@ msgstr "" msgid "The internally pre-defined wordsets which will be searched for in content." msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "An enumerable object representing the allowed mention types" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:1 of +msgid "A class object representing the allowed mentions object" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:3 of +msgid "" +"Optional[List[AllowedMentionType]]: An array of allowed mention types to " +"parse from the content." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:4 of +msgid "Optional[List[int]]: An array of user ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:5 of +msgid "Optional[List[int]]: An array of role ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:6 of +msgid "" +"Optional[bool]: For replies, whether to mention the author of the message" +" being replied to." +msgstr "" + #: interactions.api.models.misc.Snowflake:1 of msgid "The Snowflake object." msgstr "" @@ -129,17 +170,6 @@ msgid "" "integer." msgstr "" -#: interactions.api.models.misc.Color.black -#: interactions.api.models.misc.Color.blurple -#: interactions.api.models.misc.Color.fuchsia -#: interactions.api.models.misc.Color.green -#: interactions.api.models.misc.Color.red -#: interactions.api.models.misc.Color.white -#: interactions.api.models.misc.Color.yellow -#: interactions.api.models.misc.Snowflake of -msgid "Return type" -msgstr "" - #: interactions.api.models.misc.Snowflake.increment:1 of msgid "" "This is the 'Increment' portion of the snowflake. This is incremented for" @@ -199,6 +229,16 @@ msgstr "" msgid "Returns a hexadecimal value of the blurple color." msgstr "" +#: interactions.api.models.misc.Color.black +#: interactions.api.models.misc.Color.blurple +#: interactions.api.models.misc.Color.fuchsia +#: interactions.api.models.misc.Color.green +#: interactions.api.models.misc.Color.red +#: interactions.api.models.misc.Color.white +#: interactions.api.models.misc.Color.yellow of +msgid "Return type" +msgstr "" + #: interactions.api.models.misc.Color.green:1 of msgid "Returns a hexadecimal value of the green color." msgstr "" @@ -287,3 +327,6 @@ msgstr "" #: interactions.api.models.misc.Overwrite:6 of msgid "Permission bit set." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.models.presence.po b/docs/locale/pl/LC_MESSAGES/api.models.presence.po index 347c24dbc..cfbae19fa 100644 --- a/docs/locale/pl/LC_MESSAGES/api.models.presence.po +++ b/docs/locale/pl/LC_MESSAGES/api.models.presence.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.presence.rst:4 msgid "Presence Models" @@ -43,15 +43,6 @@ msgstr "" msgid "An array denoting the party's current and max size" msgstr "" -#: interactions.api.models.presence.ClientPresence -#: interactions.api.models.presence.PresenceActivity -#: interactions.api.models.presence.PresenceAssets -#: interactions.api.models.presence.PresenceParty -#: interactions.api.models.presence.PresenceSecrets -#: interactions.api.models.presence.PresenceTimestamp of -msgid "Parameters" -msgstr "" - #: interactions.api.models.presence.PresenceAssets:1 of msgid "A class object representing the assets of a presence." msgstr "" @@ -231,3 +222,6 @@ msgstr "" #: interactions.api.models.presence.ClientPresence:6 of msgid "Whether the client is afk or not." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.models.role.po b/docs/locale/pl/LC_MESSAGES/api.models.role.po index c78eeec53..4828e3cfc 100644 --- a/docs/locale/pl/LC_MESSAGES/api.models.role.po +++ b/docs/locale/pl/LC_MESSAGES/api.models.role.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.role.rst:4 msgid "Role Models" @@ -130,6 +130,12 @@ msgstr "" msgid "RGB color value as integer, defaults to the current value of the role" msgstr "" +#: interactions.api.models.role.Role.modify:9 of +msgid "" +"Bitwise value of the enabled/disabled permissions, defaults to the " +"current value of the role" +msgstr "" + #: interactions.api.models.role.Role.modify:11 of msgid "" "Whether the role should be displayed separately in the sidebar, defaults " diff --git a/docs/locale/pl/LC_MESSAGES/api.models.team.po b/docs/locale/pl/LC_MESSAGES/api.models.team.po index 2958a4252..36accb3a5 100644 --- a/docs/locale/pl/LC_MESSAGES/api.models.team.po +++ b/docs/locale/pl/LC_MESSAGES/api.models.team.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.team.rst:4 msgid "Team Models" @@ -51,11 +51,6 @@ msgstr "" msgid "The User ID of the current team owner" msgstr "" -#: interactions.api.models.team.Application interactions.api.models.team.Team -#: interactions.api.models.team.TeamMember of -msgid "Parameters" -msgstr "" - #: interactions.api.models.team.TeamMember:1 of msgid "A class object representing the member of a team." msgstr "" @@ -183,3 +178,6 @@ msgstr "" #: interactions.api.models.team.Application.icon_url of msgid "Return type" msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.models.user.po b/docs/locale/pl/LC_MESSAGES/api.models.user.po index 5721c56da..00f10cc86 100644 --- a/docs/locale/pl/LC_MESSAGES/api.models.user.po +++ b/docs/locale/pl/LC_MESSAGES/api.models.user.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.user.rst:4 msgid "User Models" @@ -94,17 +94,14 @@ msgstr "" msgid "The user's public flags" msgstr "" -#: interactions.api.models.user.User of -msgid "Parameters" -msgstr "" - #: interactions.api.models.user.User.mention:1 of msgid "Returns a string that allows you to mention the given user." msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Returns" msgstr "" @@ -114,7 +111,8 @@ msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Return type" msgstr "" @@ -133,3 +131,14 @@ msgstr "" #: interactions.api.models.user.User.banner_url:3 of msgid "URL of the user's banner (None will be returned if no banner is set)" msgstr "" + +#: interactions.api.models.user.User.presence:1 of +msgid "Returns the presence of the user." +msgstr "" + +#: interactions.api.models.user.User.presence:3 of +msgid "Presence of the user (None will be returned if not cached)" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/api.models.webhook.po b/docs/locale/pl/LC_MESSAGES/api.models.webhook.po index be10a2fd1..906a172a9 100644 --- a/docs/locale/pl/LC_MESSAGES/api.models.webhook.po +++ b/docs/locale/pl/LC_MESSAGES/api.models.webhook.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.webhook.rst:4 msgid "Webhook Models" @@ -209,7 +209,7 @@ msgid "embedded ``rich`` content" msgstr "" #: interactions.api.models.webhook.Webhook.execute:18 of -msgid "allowed mentions for the message" +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.webhook.Webhook.execute:20 of @@ -257,3 +257,6 @@ msgstr "" #: interactions.api.models.webhook.WebhookType:1 of msgid "Valid values are as follows:" msgstr "" + +#~ msgid "allowed mentions for the message" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/client.po b/docs/locale/pl/LC_MESSAGES/client.po index 854019fc5..48424e61c 100644 --- a/docs/locale/pl/LC_MESSAGES/client.po +++ b/docs/locale/pl/LC_MESSAGES/client.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../client.rst:4 msgid "Bot Client" @@ -31,10 +31,6 @@ msgstr "" #: interactions.client.bot.Client #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence @@ -44,6 +40,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.user_command #: interactions.client.bot.Extension of msgid "Parameters" @@ -80,60 +77,73 @@ msgid "" "automatic or not." msgstr "" +#: interactions.client.bot.Client:15 of +msgid "" +"Set to ``True`` to enable debug logging or set to a log level to use a " +"specific level" +msgstr "" + #: interactions.client.bot.Client of msgid "Variables" msgstr "" -#: interactions.client.bot.Client:16 of +#: interactions.client.bot.Client:18 of msgid "The asynchronous event loop of the client." msgstr "" -#: interactions.client.bot.Client:17 of +#: interactions.client.bot.Client:19 of msgid "" "The user-facing HTTP connection to the Web API, as its own separate " "client." msgstr "" -#: interactions.client.bot.Client:18 of +#: interactions.client.bot.Client:20 of msgid "An object-orientation of a websocket server connection to the Gateway." msgstr "" -#: interactions.client.bot.Client:19 of +#: interactions.client.bot.Client:21 of msgid "The Gateway intents of the application. Defaults to ``Intents.DEFAULT``." msgstr "" -#: interactions.client.bot.Client:20 of +#: interactions.client.bot.Client:22 of msgid "The list of bucketed shards for the application's connection." msgstr "" -#: interactions.client.bot.Client:21 of +#: interactions.client.bot.Client:23 of msgid "The RPC-like presence shown on an application once connected." msgstr "" -#: interactions.client.bot.Client:22 of +#: interactions.client.bot.Client:24 of msgid "The token of the application used for authentication when connecting." msgstr "" -#: interactions.client.bot.Client:23 of +#: interactions.client.bot.Client:25 of msgid "The \"extensions\" or cog equivalence registered to the main client." msgstr "" -#: interactions.client.bot.Client:24 of +#: interactions.client.bot.Client:26 of msgid "The application representation of the client." msgstr "" -#: interactions.client.bot.Client +#: interactions.client.bot.Client.guilds:1 of +msgid "Returns a list of guilds the bot is in." +msgstr "" + +#: interactions.client.bot.Client.latency:1 of +msgid "Returns the connection latency in milliseconds." +msgstr "" + +#: interactions.client.bot.Client.start:1 of +msgid "Starts the client session." +msgstr "" + #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create -#: interactions.client.bot.Client.__register_events #: interactions.client.bot.Client.__resolve_commands #: interactions.client.bot.Client.__sync #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client._login interactions.client.bot.Client._ready +#: interactions.client.bot.Client._stop #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence #: interactions.client.bot.Client.command @@ -142,6 +152,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.start #: interactions.client.bot.Client.user_command #: interactions.client.bot.Client.wait_until_ready @@ -149,22 +160,6 @@ msgstr "" msgid "Return type" msgstr "" -#: interactions.client.bot.Client.guilds:1 of -msgid "Returns a list of guilds the bot is in." -msgstr "" - -#: interactions.client.bot.Client.latency:1 of -msgid "Returns the connection latency in milliseconds." -msgstr "" - -#: interactions.client.bot.Client.start:1 of -msgid "Starts the client session." -msgstr "" - -#: interactions.client.bot.Client.__register_events:1 of -msgid "Registers all raw gateway events to the known events." -msgstr "" - #: interactions.client.bot.Client.__compare_sync:1 of msgid "Compares an application command during the synchronization process." msgstr "" @@ -178,10 +173,6 @@ msgid "The \"pool\" or list of commands to compare from." msgstr "" #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.command @@ -204,6 +195,10 @@ msgid "" "conditions have been met in a chronological order:" msgstr "" +#: interactions.client.bot.Client._stop:1 of +msgid "Stops the websocket connection gracefully." +msgstr "" + #: interactions.client.bot.Client._login:1 of msgid "Makes a login with the Discord API." msgstr "" @@ -448,7 +443,7 @@ msgid "" msgstr "" #: interactions.client.bot.Client._find_command:3 of -msgid "The name of the command to match" +msgid "The name or ID of the command to match" msgstr "" #: interactions.client.bot.Client._find_command:5 of @@ -574,59 +569,34 @@ msgstr "" msgid "The modified User object" msgstr "" -#: interactions.client.bot.Client.__raw_socket_create:1 of -msgid "" -"This is an internal function that takes any gateway socket event and then" -" returns the data purely based off of what it does in the client " -"instantiation class." -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:5 of -msgid "The data that is returned" -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:7 of -msgid "A dictionary of raw data." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:1 of -msgid "" -"This is an internal function that caches the channel creates when " -"dispatched." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:3 of -msgid "The channel object data in question." +#: interactions.client.bot.Client.request_guild_members:1 of +msgid "Requests guild members via websocket." msgstr "" -#: interactions.client.bot.Client.__raw_channel_create:5 of -msgid "The channel as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:3 of +msgid "ID of the guild to get members for." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:1 of +#: interactions.client.bot.Client.request_guild_members:5 of msgid "" -"This is an internal function that caches the message creates when " -"dispatched." +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:3 of -msgid "The message object data in question." +#: interactions.client.bot.Client.request_guild_members:7 of +msgid "String that username starts with." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:5 of -msgid "The message as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:1 of -msgid "This is an internal function that caches the guild creates on ready." +#: interactions.client.bot.Client.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:3 of -msgid "The guild object data in question." -msgstr "" - -#: interactions.client.bot.Client.__raw_guild_create:5 of -msgid "The guild as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." msgstr "" #: interactions.client.bot.Extension:1 of @@ -639,3 +609,56 @@ msgstr "" #: interactions.client.bot.Extension:5 of msgid "The structure of an extension:" msgstr "" + +#~ msgid "Registers all raw gateway events to the known events." +#~ msgstr "" + +#~ msgid "The name of the command to match" +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "takes any gateway socket event and " +#~ "then returns the data purely based " +#~ "off of what it does in the " +#~ "client instantiation class." +#~ msgstr "" + +#~ msgid "The data that is returned" +#~ msgstr "" + +#~ msgid "A dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the channel creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The channel object data in question." +#~ msgstr "" + +#~ msgid "The channel as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the message creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The message object data in question." +#~ msgstr "" + +#~ msgid "The message as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "This is an internal function that caches the guild creates on ready." +#~ msgstr "" + +#~ msgid "The guild object data in question." +#~ msgstr "" + +#~ msgid "The guild as a dictionary of raw data." +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/context.po b/docs/locale/pl/LC_MESSAGES/context.po index 3917f5b73..8352a5d3e 100644 --- a/docs/locale/pl/LC_MESSAGES/context.po +++ b/docs/locale/pl/LC_MESSAGES/context.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../context.rst:4 msgid "Event Context" @@ -55,7 +55,6 @@ msgstr "" msgid "The guild data model." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update #: interactions.client.context.CommandContext #: interactions.client.context.CommandContext.defer #: interactions.client.context.CommandContext.edit @@ -63,12 +62,15 @@ msgstr "" #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context #: interactions.client.context._Context.edit +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup -#: interactions.client.context._Context.send of +#: interactions.client.context._Context.send +#: interactions.utils.attrs_utils.DictSerializerMixin.update of msgid "Parameters" msgstr "" @@ -79,11 +81,13 @@ msgstr "" #: interactions.client.context.CommandContext.edit #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.send of msgid "Returns" msgstr "" @@ -98,11 +102,13 @@ msgstr "" #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup #: interactions.client.context._Context.send of msgid "Return type" @@ -153,7 +159,7 @@ msgstr "" #: interactions.client.context.CommandContext.send:12 #: interactions.client.context.ComponentContext.send:12 #: interactions.client.context._Context.send:12 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.client.context.CommandContext.send:14 @@ -171,6 +177,12 @@ msgstr "" #: interactions.client.context.CommandContext.send:18 #: interactions.client.context.ComponentContext.send:18 #: interactions.client.context._Context.send:18 of +msgid "Whether embeds are not shown in the message." +msgstr "" + +#: interactions.client.context.CommandContext.send:20 +#: interactions.client.context.ComponentContext.send:20 +#: interactions.client.context._Context.send:20 of msgid "The sent message as an object." msgstr "" @@ -197,13 +209,39 @@ msgstr "" msgid "The components you wish to show." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:1 of +#: interactions.client.context._Context.has_permissions:1 of +msgid "" +"Returns whether the author of the interaction has the permissions in the " +"given context." +msgstr "" + +#: interactions.client.context._Context.has_permissions:3 of +msgid "The list of permissions" +msgstr "" + +#: interactions.client.context._Context.has_permissions:5 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.client.context._Context.has_permissions:7 of +msgid "Whether the author has the permissions" +msgstr "" + +#: ../../docstring interactions.client.context.CommandContext._extras:1 +#: interactions.client.context.ComponentContext._extras:1 +#: interactions.client.context._Context._extras:1 of +msgid "A dict containing values that were not serialized from Discord." +msgstr "" + +#: interactions.utils.attrs_utils.DictSerializerMixin.update:1 of msgid "" "Update an object with new attributes. All data will be converted, and any" " extra attributes will be put in _extras" msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:4 of +#: interactions.utils.attrs_utils.DictSerializerMixin.update:4 of msgid "The dictionary to update from" msgstr "" @@ -286,6 +324,18 @@ msgid "" " was sent from." msgstr "" +#: interactions.client.context.CommandContext:30 of +msgid "The client instance that the command belongs to." +msgstr "" + +#: interactions.client.context.CommandContext:31 of +msgid "The command object that is being invoked." +msgstr "" + +#: interactions.client.context.CommandContext:32 of +msgid "The extension the command belongs to." +msgstr "" + #: interactions.client.context.CommandContext.defer:1 of msgid "" "This \"defers\" an interaction response, allowing up to a 15-minute delay" @@ -342,3 +392,31 @@ msgstr "" #: interactions.client.context.ComponentContext.defer:6 of msgid "Whether you want to edit the original message or send a followup message" msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:1 of +msgid "Disables all components of the message." +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:3 of +msgid "" +"Whether the components should be disabled in an interaction response, " +"default True" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:5 of +msgid "" +"Additional keyword-arguments to pass to the edit method. This only works " +"when this method is used as interaction response and takes the same " +"arguments as :meth:`interactions.client.context._Context:edit()`" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:8 of +msgid "The modified Message" +msgstr "" + +#: interactions.client.context.ComponentContext.label:1 of +msgid "The label of the interacted button. :rtype: Optional[str]" +msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/events.po b/docs/locale/pl/LC_MESSAGES/events.po index b91a1dc02..7b4ecba7d 100644 --- a/docs/locale/pl/LC_MESSAGES/events.po +++ b/docs/locale/pl/LC_MESSAGES/events.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../events.rst:2 msgid "Event Documentation" @@ -98,99 +98,104 @@ msgid "``on_command``" msgstr "" #: ../../events.rst:57 -msgid "``on_component``" +msgid "``on_command_error``" msgstr "" #: ../../events.rst:58 -msgid "``on_autocomplete``" +msgid "``on_component``" msgstr "" #: ../../events.rst:59 +msgid "``on_autocomplete``" +msgstr "" + +#: ../../events.rst:60 msgid "``on_modal``" msgstr "" -#: ../../events.rst:61 +#: ../../events.rst:62 msgid "Lets now have a look at those events in detail:" msgstr "" -#: ../../events.rst:64 +#: ../../events.rst:65 msgid "Event: ``raw_socket_create``" msgstr "" -#: ../../events.rst:65 +#: ../../events.rst:66 msgid "" "This event fires on any event sent by Discord, including ``Typing Start``" " and ``Voice State Update``. ``Hello``, ``Resumed``, ``Reconnect`` and " "``Invalid Session`` still will not be dispatched." msgstr "" -#: ../../events.rst:68 +#: ../../events.rst:69 msgid "" -"The function handling the event should take in one argument, the type of " -"this argument is a ``dict``." +"A function handling an event should take two arguments, the first " +"argument is the name of the event, the second is the data of that event " +"with type ``dict``." msgstr "" -#: ../../events.rst:70 +#: ../../events.rst:72 msgid "" -"The value of the argument will be the *raw* data sent from Discord, so it" -" is not recommended to use that event as long as you don't absolutely " -"need it." +"The value of the second argument will be the *raw* data sent from " +"Discord, so it is not recommended to use that event as long as you don't " +"absolutely need it." msgstr "" -#: ../../events.rst:75 +#: ../../events.rst:77 msgid "Event: ``on_start``" msgstr "" -#: ../../events.rst:76 +#: ../../events.rst:78 msgid "This event fires only when the bot is started." msgstr "" -#: ../../events.rst:78 ../../events.rst:161 +#: ../../events.rst:80 ../../events.rst:173 msgid "This function takes no arguments." msgstr "" -#: ../../events.rst:81 +#: ../../events.rst:83 msgid "Unlike ``on_ready``, this event will never be dispatched more than once." msgstr "" -#: ../../events.rst:84 +#: ../../events.rst:86 msgid "Event: ``on_interaction``" msgstr "" -#: ../../events.rst:85 +#: ../../events.rst:87 msgid "" "This event fires on any interaction (commands, components, autocomplete " "and modals)." msgstr "" -#: ../../events.rst:87 +#: ../../events.rst:89 msgid "" "The function needs one argument. It will have the type ``CommandContext``" " or ``ComponentContext``." msgstr "" -#: ../../events.rst:89 +#: ../../events.rst:91 msgid "" "Because you will have to check for everything, from the " "``InteractionType`` to any data inside the context, we do not recommend " "using this event unless you have experience with it." msgstr "" -#: ../../events.rst:94 +#: ../../events.rst:96 msgid "Event: ``on_command``" msgstr "" -#: ../../events.rst:95 +#: ../../events.rst:97 msgid "" "This event fires on any Application Command (slash command + context menu" " command) used." msgstr "" -#: ../../events.rst:97 ../../events.rst:117 ../../events.rst:127 +#: ../../events.rst:99 ../../events.rst:129 ../../events.rst:139 msgid "The function takes in one argument of the type ``CommandContext``." msgstr "" -#: ../../events.rst:99 +#: ../../events.rst:101 msgid "" "Using this event, you will have to manually check everything, from name " "to whether the used commands have sub commands, options or anything else " @@ -198,138 +203,174 @@ msgid "" "it" msgstr "" -#: ../../events.rst:104 +#: ../../events.rst:106 +msgid "Event: ``on_command_error``" +msgstr "" + +#: ../../events.rst:107 +msgid "This event fires when the following conditions are met:" +msgstr "" + +#: ../../events.rst:109 +msgid "There is an error in the command (or subcommand within the command)" +msgstr "" + +#: ../../events.rst:110 +msgid "There is no error callback assigned to that command" +msgstr "" + +#: ../../events.rst:112 +msgid "" +"The function takes in two arguments, one of the type ``CommandContext``, " +"and the other contains the error." +msgstr "" + +#: ../../events.rst:116 msgid "Event: ``on_component``" msgstr "" -#: ../../events.rst:105 +#: ../../events.rst:117 msgid "" "This event fires on any Component used (for now, those are Buttons and " "Select Menus)." msgstr "" -#: ../../events.rst:107 +#: ../../events.rst:119 msgid "The function takes in one argument of the type ``ComponentContext``." msgstr "" -#: ../../events.rst:109 +#: ../../events.rst:121 msgid "" "Like ``on_command``, you will have to manually check for everything, i.e " "for custom id and component type. Also, you will have to look through the" " argument to find the selected choices, if you have a select menu." msgstr "" -#: ../../events.rst:114 +#: ../../events.rst:126 msgid "Event: ``on_autocomplete``" msgstr "" -#: ../../events.rst:115 +#: ../../events.rst:127 msgid "This event fires on any autocomplete triggered." msgstr "" -#: ../../events.rst:119 +#: ../../events.rst:131 msgid "" "As already in the events above, you will have to get the important values" " yourself. Those values are here the autocompleted option and the user " "input." msgstr "" -#: ../../events.rst:124 +#: ../../events.rst:136 msgid "Event: ``on_modal``" msgstr "" -#: ../../events.rst:125 +#: ../../events.rst:137 msgid "This event fires on every modal that is submitted." msgstr "" -#: ../../events.rst:129 +#: ../../events.rst:141 msgid "" "You will have to get all values yourself and check what modal was used " "when using this event." msgstr "" -#: ../../events.rst:132 +#: ../../events.rst:144 msgid "" "Additionally, if you struggle with getting the values, you can check " ":ref:`how it is handled internally `." msgstr "" -#: ../../events.rst:136 +#: ../../events.rst:148 msgid "After this, let us look at events from the Discord API." msgstr "" -#: ../../events.rst:139 +#: ../../events.rst:151 msgid "Discord API Events" msgstr "" -#: ../../events.rst:141 +#: ../../events.rst:153 msgid "" "Events in this section do not match the name needed to put into the " "function. Please check :ref:`above ` for how to get the correct name." msgstr "" -#: ../../events.rst:145 +#: ../../events.rst:157 msgid "" "There are a lot of events dispatched by the Discord API. All of those can" " be found `here`_." msgstr "" -#: ../../events.rst:147 +#: ../../events.rst:159 msgid "" "The events ``HELLO``, ``RESUMED``, ``RECONNECT``, ``INVALID SESSION`` and" " ``TYPING START`` are not dispatched by the library." msgstr "" -#: ../../events.rst:149 +#: ../../events.rst:161 msgid "" "``TYPING START`` will be included in the raw socket create event. You can" " also listen for it if you choose to subclass the WebSocketClient" msgstr "" -#: ../../events.rst:152 +#: ../../events.rst:164 msgid "" "The event ``VOICE STATE UPDATE`` can be only received with the voice " ":ref:`Extension `." msgstr "" -#: ../../events.rst:155 +#: ../../events.rst:167 msgid "Let's now have a look at a few events:" msgstr "" -#: ../../events.rst:158 +#: ../../events.rst:170 msgid "Event: ``READY``" msgstr "" -#: ../../events.rst:159 +#: ../../events.rst:171 msgid "" "This event fires whenever ``READY`` is dispatched by Discord. This " "happens when connecting to the web socket server." msgstr "" -#: ../../events.rst:164 +#: ../../events.rst:176 msgid "" "Due to the bot reconnecting during runtime, ``on_ready`` will be " "dispatched multiple times. If you rely on ``on_ready`` to do certain " "things once, check against a global variable as shown below:" msgstr "" -#: ../../events.rst:181 +#: ../../events.rst:193 msgid "Events: ``GUILD MEMBER UPDATE`` and ``GUILD MEMBER ADD``" msgstr "" -#: ../../events.rst:182 +#: ../../events.rst:194 msgid "" "These events fire whenever a member joins a guild or a member of a guild " "gets modified." msgstr "" -#: ../../events.rst:184 +#: ../../events.rst:196 msgid "The function takes in one argument of the type ``GuildMember``." msgstr "" -#: ../../events.rst:186 +#: ../../events.rst:198 msgid "" "The argument has the same methods as a normal ``Member`` object, except " "the methods *do not take in a guild id*. Please keep that in mind when " "using this event." msgstr "" + +#~ msgid "" +#~ "The function handling the event should" +#~ " take in one argument, the type " +#~ "of this argument is a ``dict``." +#~ msgstr "" + +#~ msgid "" +#~ "The value of the argument will be" +#~ " the *raw* data sent from Discord," +#~ " so it is not recommended to " +#~ "use that event as long as you " +#~ "don't absolutely need it." +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/faq.po b/docs/locale/pl/LC_MESSAGES/faq.po index 1bf421161..09e3ae8c9 100644 --- a/docs/locale/pl/LC_MESSAGES/faq.po +++ b/docs/locale/pl/LC_MESSAGES/faq.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../faq.rst:2 msgid "Frequently Asked Questions" @@ -283,12 +283,12 @@ msgstr "" #: ../../faq.rst:157 msgid "" -"A `voice client`_ - which is still WIP, but it is able to listen for the " +"`voice client`_ - which is still WIP, but it is able to listen for the " "``VOICE_STATE_UPDATE`` event." msgstr "" #: ../../faq.rst:158 -msgid "An `autosharder`_ for automatic sharding" +msgid "`autosharder`_ for automatic sharding" msgstr "" #: ../../faq.rst:159 @@ -310,146 +310,148 @@ msgid "`enhanced`_ which enhances the DX in general" msgstr "" #: ../../faq.rst:163 -msgid "A `paginator`_ for paginating embeds on messages using components" +msgid "`paginator`_ for paginating embeds on messages using components" msgstr "" #: ../../faq.rst:164 msgid "" -"`persistence`_ - for storing data inside your custom IDs (as an " -"alternative to ``wait_for``)" +"`persistence`_ for storing data inside your custom IDs (as an alternative" +" to ``wait_for``)" msgstr "" #: ../../faq.rst:165 -msgid "And a `boilerplate`_" +msgid "`lavalink`_ for voice sending and listening ``VOICE_STATE_UPDATE`` event" +msgstr "" + +#: ../../faq.rst:166 +msgid "`fastapi`_ for building own API" msgstr "" #: ../../faq.rst:167 +msgid "And a `boilerplate`_" +msgstr "" + +#: ../../faq.rst:169 msgid "" "Below are a few unofficial exts (for the time being) which implement some" " functionality similar to what d.py had:" msgstr "" -#: ../../faq.rst:169 +#: ../../faq.rst:171 msgid "`checks and cooldowns`_" msgstr "" -#: ../../faq.rst:170 +#: ../../faq.rst:172 msgid "`tasks`_" msgstr "" -#: ../../faq.rst:171 -msgid "" -"`get`_ for getting objects from the discord API (will be implemented into" -" the core library at a later time)" -msgstr "" - -#: ../../faq.rst:173 +#: ../../faq.rst:174 msgid "Usage examples can usually be found at the linked page" msgstr "" -#: ../../faq.rst:177 +#: ../../faq.rst:178 msgid "Can I make an Extension Library myself?" msgstr "" -#: ../../faq.rst:178 +#: ../../faq.rst:179 msgid "" "Yeah, you can! We have a special channel reserved for the development of " "external libraries! You can also read `this `_ for more information." msgstr "" -#: ../../faq.rst:183 +#: ../../faq.rst:184 msgid "" "I'm getting \"``AttributeError: HTTPClient not found!``\" when I try to " "execute helper methods!" msgstr "" -#: ../../faq.rst:184 +#: ../../faq.rst:185 msgid "Probably you are doing something like this:" msgstr "" -#: ../../faq.rst:191 +#: ../../faq.rst:192 msgid "" "And the error occurs in the line where you try to send something. You can" " fix this easy by adding one argument:" msgstr "" -#: ../../faq.rst:198 +#: ../../faq.rst:199 msgid "" "You have to add this extra argument for every object you instantiate by " "yourself if you want to use it's methods" msgstr "" -#: ../../faq.rst:202 +#: ../../faq.rst:203 msgid "" "Context and Messages don't have the ``Channel`` and ``Guild`` attributes!" " Why?" msgstr "" -#: ../../faq.rst:203 +#: ../../faq.rst:204 msgid "" "At the moment the Discord API does *not* include them into their " "responses. You can get those object via the ``get_channel()`` and " "``get_guild()`` methods of the Context and Message model." msgstr "" -#: ../../faq.rst:208 +#: ../../faq.rst:209 msgid "\"``ctx.send got an unexpected keyword argument: files``\"! Why?" msgstr "" -#: ../../faq.rst:209 +#: ../../faq.rst:210 msgid "" "It is not supported due to an decision of the core developer team. There " "are two ways to do it:" msgstr "" -#: ../../faq.rst:212 +#: ../../faq.rst:213 msgid "Using ``await channel.send`` instead" msgstr "" -#: ../../faq.rst:213 +#: ../../faq.rst:214 msgid "Using the `files`_ extension" msgstr "" -#: ../../faq.rst:217 +#: ../../faq.rst:218 msgid "\"``ctx.send got an unexpected keyword argument: embed``\"! Why?" msgstr "" -#: ../../faq.rst:218 +#: ../../faq.rst:219 msgid "" "This is quite simple: The argument ``embed`` got deprecated by Discord. " "The new naming is ``embeds``." msgstr "" -#: ../../faq.rst:222 +#: ../../faq.rst:223 msgid "How can I check what exception happened during a request?" msgstr "" -#: ../../faq.rst:223 +#: ../../faq.rst:224 msgid "We, unlike d.py, do not offer something like ``interactions.NotFound``." msgstr "" -#: ../../faq.rst:225 +#: ../../faq.rst:226 msgid "Instead you have to do it like this:" msgstr "" -#: ../../faq.rst:228 +#: ../../faq.rst:229 msgid "" "This feature will be implemented with version 4.3 and is currently only " "available on beta/unstable" msgstr "" -#: ../../faq.rst:242 +#: ../../faq.rst:243 msgid "" "You can additionally get the exact reason for why the exception occurred " "with ``e.message`` or ``e.lookup(e.code)``" msgstr "" -#: ../../faq.rst:246 +#: ../../faq.rst:247 msgid "My message content is always empty! How can I fix this?" msgstr "" -#: ../../faq.rst:247 +#: ../../faq.rst:248 msgid "" "This happens because you did not enable the intent for message content. " "Enable it on the developer portal and add it into the ``Client`` " @@ -459,11 +461,11 @@ msgid "" "``Intents.DEFAULT``, it can be any other intent(s) you need!" msgstr "" -#: ../../faq.rst:254 +#: ../../faq.rst:255 msgid "Is there something like ``Cogs``?" msgstr "" -#: ../../faq.rst:255 +#: ../../faq.rst:256 msgid "" "Yes! Although, we call them ``Extensions``. Yeah, like :ref:`Extension " "Libraries `. This is because an extension " @@ -471,39 +473,39 @@ msgid "" "how you create an extension for yourself:" msgstr "" -#: ../../faq.rst:283 +#: ../../faq.rst:284 msgid "It's nothing more than that." msgstr "" -#: ../../faq.rst:285 +#: ../../faq.rst:286 msgid "" "Since ``@bot.X`` decorators don't work in extensions, you have to use " "these:" msgstr "" -#: ../../faq.rst:287 +#: ../../faq.rst:288 msgid "For event listeners, use ``@interactions.extension_listener``" msgstr "" -#: ../../faq.rst:288 +#: ../../faq.rst:289 msgid "For component listeners, use ``@interactions.extension_component``" msgstr "" -#: ../../faq.rst:289 +#: ../../faq.rst:290 msgid "For modal listeners, use ``@interactions.extension_modal``" msgstr "" -#: ../../faq.rst:290 +#: ../../faq.rst:291 msgid "For autocomplete listeners, use ``@interactions.extension_autocomplete``" msgstr "" -#: ../../faq.rst:294 +#: ../../faq.rst:295 msgid "" "``channel.members`` does not exist, how do I get the people in a voice " "channel?" msgstr "" -#: ../../faq.rst:295 +#: ../../faq.rst:296 msgid "" "``channel.members`` actually does exist, but is reserved for threads. " "There is no attribute for people in a voice channel by the API. The only " @@ -512,12 +514,37 @@ msgid "" " updated when a member joins or leaves." msgstr "" -#: ../../faq.rst:301 +#: ../../faq.rst:302 msgid "My question is not answered on here!" msgstr "" -#: ../../faq.rst:302 +#: ../../faq.rst:303 msgid "" "Please join our `Discord Server`_ for any further support regarding our " "library and/or any integration code depending on it." msgstr "" + +#~ msgid "" +#~ "A `voice client`_ - which is still" +#~ " WIP, but it is able to listen" +#~ " for the ``VOICE_STATE_UPDATE`` event." +#~ msgstr "" + +#~ msgid "An `autosharder`_ for automatic sharding" +#~ msgstr "" + +#~ msgid "A `paginator`_ for paginating embeds on messages using components" +#~ msgstr "" + +#~ msgid "" +#~ "`persistence`_ - for storing data inside" +#~ " your custom IDs (as an alternative" +#~ " to ``wait_for``)" +#~ msgstr "" + +#~ msgid "" +#~ "`get`_ for getting objects from the " +#~ "discord API (will be implemented into" +#~ " the core library at a later " +#~ "time)" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/index.po b/docs/locale/pl/LC_MESSAGES/index.po index 91465f9df..d7a1d6841 100644 --- a/docs/locale/pl/LC_MESSAGES/index.po +++ b/docs/locale/pl/LC_MESSAGES/index.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../index.rst:47 msgid "Pages:" @@ -51,7 +51,7 @@ msgstr "" #: ../../index.rst:11 msgid "" "Look no more! The goal of this library is to make all three of these " -"questions go from possibilites to trivial matters." +"questions go from possibilities to trivial matters." msgstr "" #: ../../index.rst:14 @@ -181,7 +181,7 @@ msgid "**black** ``22.6.0``" msgstr "" #: ../../index.rst:66 -msgid "**flake8** ``4.0.1``" +msgid "**flake8** ``5.0.4``" msgstr "" #: ../../index.rst:67 @@ -190,7 +190,7 @@ msgstr "" #: ../../index.rst:69 msgid "" -"**Sphinx** ``4.4.0``: all of our documentation is powered off of " +"**Sphinx** ``5.1.1``: all of our documentation is powered off of " "autogenerated documentation of the Sphinx engine." msgstr "" @@ -247,3 +247,20 @@ msgstr "" #: ../../index.rst:88 msgid ":ref:`modindex`" msgstr "" + +#~ msgid "" +#~ "Look no more! The goal of this " +#~ "library is to make all three of" +#~ " these questions go from possibilites " +#~ "to trivial matters." +#~ msgstr "" + +#~ msgid "**flake8** ``4.0.1``" +#~ msgstr "" + +#~ msgid "" +#~ "**Sphinx** ``4.4.0``: all of our " +#~ "documentation is powered off of " +#~ "autogenerated documentation of the Sphinx " +#~ "engine." +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/migration.po b/docs/locale/pl/LC_MESSAGES/migration.po index 9f0d8e6aa..3546c747d 100644 --- a/docs/locale/pl/LC_MESSAGES/migration.po +++ b/docs/locale/pl/LC_MESSAGES/migration.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../migration.rst:2 msgid "Migration" @@ -126,7 +126,9 @@ msgid "" msgstr "" #: ../../migration.rst:99 -msgid "You can get more information by reading the `get-documentation`_." +msgid "" +"You can get more information by reading the " +":meth:`interactions.client.get.get`-documentation" msgstr "" #: ../../migration.rst:102 @@ -148,3 +150,6 @@ msgid "" "your argument in your function differently than your option name! " "Example:" msgstr "" + +#~ msgid "You can get more information by reading the `get-documentation`_." +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/models.command.po b/docs/locale/pl/LC_MESSAGES/models.command.po index 5c72da5b0..a7fca335f 100644 --- a/docs/locale/pl/LC_MESSAGES/models.command.po +++ b/docs/locale/pl/LC_MESSAGES/models.command.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.command.rst:4 msgid "Application Command Models" @@ -37,8 +37,10 @@ msgid "The structure for a choice:" msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission of msgid "Variables" @@ -56,13 +58,14 @@ msgstr "" #: interactions.client.models.command.Command:16 #: interactions.client.models.command.Command.group:28 #: interactions.client.models.command.Command.subcommand:33 -#: interactions.client.models.command.Option:34 of +#: interactions.client.models.command.Option:36 of msgid "" "The dictionary of localization for the ``name`` field. This enforces the " "same restrictions as the ``name`` field." msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command #: interactions.client.models.command.Command.__call @@ -72,6 +75,7 @@ msgstr "" #: interactions.client.models.command.Command.error #: interactions.client.models.command.Command.group #: interactions.client.models.command.Command.subcommand +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission #: interactions.client.models.command.option of @@ -100,8 +104,7 @@ msgstr "" msgid "The type of option." msgstr "" -#: interactions.client.models.command.Option:23 -#: interactions.client.models.command.option:14 of +#: interactions.client.models.command.Option:23 of msgid "The name of the option." msgstr "" @@ -142,19 +145,27 @@ msgid "The maximum value supported by the option." msgstr "" #: interactions.client.models.command.Option:33 of +msgid "The minimum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:34 of +msgid "The maximum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:35 of msgid "A status denoting whether this option is an autocomplete option." msgstr "" #: interactions.client.models.command.Command:17 #: interactions.client.models.command.Command.group:30 #: interactions.client.models.command.Command.subcommand:35 -#: interactions.client.models.command.Option:35 of +#: interactions.client.models.command.Option:37 of msgid "" "The dictionary of localization for the ``description`` field. This " "enforces the same restrictions as the ``description`` field." msgstr "" -#: interactions.client.models.command.Option:36 of +#: interactions.client.models.command.Option:38 of msgid "How the option value is passed to the function, if different than ``name``" msgstr "" @@ -248,18 +259,26 @@ msgid "A decorator for adding options to a command." msgstr "" #: interactions.client.models.command.option:3 of -msgid "The structure of an option:" +msgid "" +"The ``type`` and ``name`` of the option are defaulted to the parameter's " +"typehint and name." +msgstr "" + +#: interactions.client.models.command.option:5 of +msgid "" +"When the ``name`` of the option differs from the parameter name, the " +"``converter`` field will default to the name of the parameter." msgstr "" -#: interactions.client.models.command.option:12 of -msgid "The type of the option." +#: interactions.client.models.command.option:8 of +msgid "The structure of an option:" msgstr "" -#: interactions.client.models.command.option:16 of -msgid "The description of the option. Defaults to ``\"No description set\"``." +#: interactions.client.models.command.option:17 of +msgid "The description of the option. Defaults to \"No description set\"." msgstr "" -#: interactions.client.models.command.option:18 of +#: interactions.client.models.command.option:19 of msgid "The keyword arguments of the option, same as :class:`Option`." msgstr "" @@ -283,6 +302,8 @@ msgstr "" msgid "A class that when returned from a command, the command chain is stopped." msgstr "" +#: interactions.client.models.command.BaseResult:3 +#: interactions.client.models.command.GroupResult:3 #: interactions.client.models.command.StopCommand:3 of msgid "Usage:" msgstr "" @@ -291,6 +312,32 @@ msgstr "" msgid "This allows for custom checks that allow stopping the command chain." msgstr "" +#: interactions.client.models.command.BaseResult:1 +#: interactions.client.models.command.GroupResult:1 of +msgid "A class object representing the result of the base command." +msgstr "" + +#: interactions.client.models.command.BaseResult:17 of +msgid "" +"If the subcommand coroutine does not have enough parameters, the " +"``BaseResult`` will not be passed." +msgstr "" + +#: interactions.client.models.command.BaseResult:19 +#: interactions.client.models.command.GroupResult:25 of +msgid "The result of the base command." +msgstr "" + +#: interactions.client.models.command.GroupResult:23 of +msgid "" +"If the subcommand does not have enough arguments, the ``GroupResult`` " +"will not be passed." +msgstr "" + +#: interactions.client.models.command.GroupResult:26 of +msgid "The parent ``BaseResult``." +msgstr "" + #: interactions.client.models.command.Command:1 of msgid "A class object representing a command." msgstr "" @@ -364,6 +411,14 @@ msgstr "" msgid "The extension that the command belongs to, if any." msgstr "" +#: interactions.client.models.command.Command:26 of +msgid "The client that the command belongs to." +msgstr "" + +#: interactions.client.models.command.Command:27 of +msgid "The listener, used for dispatching command errors." +msgstr "" + #: interactions.client.models.command.Command.converters:1 of msgid "" "Returns a dictionary with all converters added to the options of the " @@ -525,3 +580,9 @@ msgid "" ":class:`interactions.client.bot.Extension` is passed to the coroutine, if" " any." msgstr "" + +#~ msgid "The type of the option." +#~ msgstr "" + +#~ msgid "The description of the option. Defaults to ``\"No description set\"``." +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/models.component.po b/docs/locale/pl/LC_MESSAGES/models.component.po index ae186054c..ce3834826 100644 --- a/docs/locale/pl/LC_MESSAGES/models.component.po +++ b/docs/locale/pl/LC_MESSAGES/models.component.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.component.rst:4 msgid "Component Models" @@ -257,36 +257,18 @@ msgid "The maximum length of the input." msgstr "" #: interactions.client.models.component.Modal:1 of -msgid "A class object representing a modal." +msgid "A class object representing a modal. The structure for a modal: ::" msgstr "" -#: interactions.client.models.component.Modal:8 of -msgid "The structure for a modal: ::" -msgstr "" - -#: interactions.client.models.component.Modal:6 of -msgid "interactions.Modal(" -msgstr "" - -#: interactions.client.models.component.Modal:5 of -msgid "" -"title=\"Application Form\", custom_id=\"mod_app_form\", " -"components=[interactions.TextInput(...)]," -msgstr "" - -#: interactions.client.models.component.Modal:8 of -msgid ")" -msgstr "" - -#: interactions.client.models.component.Modal:10 of +#: interactions.client.models.component.Modal:9 of msgid "The custom ID of the modal." msgstr "" -#: interactions.client.models.component.Modal:11 of +#: interactions.client.models.component.Modal:10 of msgid "The title of the modal." msgstr "" -#: interactions.client.models.component.Modal:12 of +#: interactions.client.models.component.Modal:11 of msgid "The components of the modal." msgstr "" @@ -302,22 +284,22 @@ msgid "" " also support only 1 text input component only." msgstr "" -#: interactions.client.models.component.ActionRow:13 of -msgid "The structure for an action row: ::" +#: interactions.client.models.component.ActionRow:8 of +msgid "The structure for an action row: ..code-block:: python" msgstr "" -#: interactions.client.models.component.ActionRow:9 of +#: interactions.client.models.component.ActionRow:10 of msgid "" "# \"...\" represents a component object. # Method 1: " "interactions.ActionRow(...) # Method 2: " "interactions.ActionRow(components=[...])" msgstr "" -#: interactions.client.models.component.ActionRow:15 of +#: interactions.client.models.component.ActionRow:16 of msgid "The type of component. Always defaults to ``1``." msgstr "" -#: interactions.client.models.component.ActionRow:16 of +#: interactions.client.models.component.ActionRow:17 of msgid "A list of components the ActionRow has, if any." msgstr "" @@ -340,3 +322,23 @@ msgstr "" #: interactions.client.models.component.ActionRow.new of msgid "Return type" msgstr "" + +#~ msgid "A class object representing a modal." +#~ msgstr "" + +#~ msgid "The structure for a modal: ::" +#~ msgstr "" + +#~ msgid "interactions.Modal(" +#~ msgstr "" + +#~ msgid "" +#~ "title=\"Application Form\", custom_id=\"mod_app_form\"," +#~ " components=[interactions.TextInput(...)]," +#~ msgstr "" + +#~ msgid ")" +#~ msgstr "" + +#~ msgid "The structure for an action row: ::" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/models.misc.po b/docs/locale/pl/LC_MESSAGES/models.misc.po index 9ea8f4346..31ef0b3e5 100644 --- a/docs/locale/pl/LC_MESSAGES/models.misc.po +++ b/docs/locale/pl/LC_MESSAGES/models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.misc.rst:4 msgid "Miscellaneous Models" @@ -56,12 +56,6 @@ msgstr "" msgid "The resolved attachments data." msgstr "" -#: interactions.client.models.misc.Interaction -#: interactions.client.models.misc.InteractionData -#: interactions.client.models.misc.InteractionResolvedData of -msgid "Parameters" -msgstr "" - #: interactions.client.models.misc.InteractionData:1 of msgid "A class object representing the data of an interaction." msgstr "" @@ -102,6 +96,10 @@ msgstr "" msgid "The targeted ID of the interaction." msgstr "" +#: interactions.client.models.misc.InteractionData:12 of +msgid "Array of Action Rows in modal." +msgstr "" + #: interactions.client.models.misc.Interaction:1 of msgid "A class object representing an interaction." msgstr "" @@ -149,3 +147,6 @@ msgstr "" #: interactions.client.models.misc.Interaction:13 of msgid "The message of the interaction." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/quickstart.po b/docs/locale/pl/LC_MESSAGES/quickstart.po index 89ed78f26..76b3670dc 100644 --- a/docs/locale/pl/LC_MESSAGES/quickstart.po +++ b/docs/locale/pl/LC_MESSAGES/quickstart.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:08-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../quickstart.rst:2 msgid "Quickstart" @@ -28,10 +28,11 @@ msgstr "" #: ../../quickstart.rst:7 msgid "" -"**discord-interactions** is a :ref:`Python library ` for the Discord Application Programming Interface. (API) A" -" library in Python has to be installed through the `pip` file. Run this " -"in your terminal/command line in order to install our library:" +"**discord-interactions** is a :ref:`Python library " +"` for the Discord Application Programming " +"Interface. (API) A library in Python has to be installed through the " +"`pip` file. Run this in your terminal/command line in order to install " +"our library:" msgstr "" #: ../../quickstart.rst:11 @@ -308,109 +309,116 @@ msgid "" msgstr "" #: ../../quickstart.rst:208 -msgid "" -"The first field in the ``@option()`` decorator is the type of the option." -" This is positional only and required. You can use integers, the default " -"Python types, the ``OptionType`` enum, or supported objects such as " -"``interactions.Channel``." +msgid "All arguments in the decorator are keyword arguments only." msgstr "" #: ../../quickstart.rst:209 -msgid "All other arguments in the decorator are keyword arguments only." +msgid "" +"The ``type`` and ``name`` fields default to the typehint and the name of " +"the parameter." msgstr "" #: ../../quickstart.rst:210 -msgid "The ``name`` field is required." +msgid "" +"The ``description`` field is optional and defaults to ``\"No description " +"set``." msgstr "" #: ../../quickstart.rst:211 msgid "" -"The ``description`` field is optional and defaults to ``\"No description " -"set``." +"The ``required`` field defaults to whether the default for the parameter " +"is empty." msgstr "" #: ../../quickstart.rst:212 msgid "" +"For typehinting or inputting the ``type`` field, you can use integers, " +"the default Python types, the ``OptionType`` enum, or supported objects " +"such as ``interactions.Channel``." +msgstr "" + +#: ../../quickstart.rst:213 +msgid "" "Any parameters from ``Option`` can be passed into the ``@option()`` " "decorator." msgstr "" -#: ../../quickstart.rst:215 +#: ../../quickstart.rst:216 msgid "The limit for options per command is 25." msgstr "" -#: ../../quickstart.rst:218 +#: ../../quickstart.rst:219 msgid "Nested commands: subcommands" msgstr "" -#: ../../quickstart.rst:220 +#: ../../quickstart.rst:221 msgid "" "Subcommands are options that are nested to create subcategories of " "commands." msgstr "" -#: ../../quickstart.rst:222 +#: ../../quickstart.rst:223 msgid "Here is the structure of a subcommand:" msgstr "" -#: ../../quickstart.rst:265 +#: ../../quickstart.rst:266 msgid "You can also create subcommands using the command system:" msgstr "" -#: ../../quickstart.rst:291 +#: ../../quickstart.rst:292 msgid "You can add a SUB_COMMAND_GROUP in between the base and command." msgstr "" -#: ../../quickstart.rst:294 +#: ../../quickstart.rst:295 msgid "Additional information about subcommands" msgstr "" -#: ../../quickstart.rst:296 +#: ../../quickstart.rst:297 msgid "" "Base commands are returned the :ref:`Command ` object. From this, you can utilize the following " "decorators:" msgstr "" -#: ../../quickstart.rst:299 +#: ../../quickstart.rst:300 msgid "" ":ref:`@subcommand() `: creates" " a subcommand." msgstr "" -#: ../../quickstart.rst:300 +#: ../../quickstart.rst:301 msgid "" ":ref:`@group() `: creates a " "group." msgstr "" -#: ../../quickstart.rst:301 +#: ../../quickstart.rst:302 msgid "" ":ref:`@error `: registers an " "error callback." msgstr "" -#: ../../quickstart.rst:303 +#: ../../quickstart.rst:304 msgid "Check the documentation for the parameters of each of these decorators." msgstr "" -#: ../../quickstart.rst:305 +#: ../../quickstart.rst:306 msgid "The following is an example of a base command:" msgstr "" -#: ../../quickstart.rst:313 +#: ../../quickstart.rst:314 msgid "The examples below will be using the base command above." msgstr "" -#: ../../quickstart.rst:315 +#: ../../quickstart.rst:316 msgid "The following is an example of a subcommand of the base command:" msgstr "" -#: ../../quickstart.rst:323 +#: ../../quickstart.rst:324 msgid "This code results in the following subcommand: `/base_command subcommand`." msgstr "" -#: ../../quickstart.rst:326 +#: ../../quickstart.rst:327 msgid "" "You can use the ``base_res`` parameter in groups and subcommands, and " "``group_res`` in subcommands inside groups to access the result of the " @@ -418,50 +426,50 @@ msgid "" "``ctx`` parameter." msgstr "" -#: ../../quickstart.rst:329 +#: ../../quickstart.rst:330 msgid "The following is an example of a group with subcommands:" msgstr "" -#: ../../quickstart.rst:341 +#: ../../quickstart.rst:342 msgid "" "You can have multiple groups, with multiple subcommands in each group. " "Subcommands and groups are options, so the same restrictions apply." msgstr "" -#: ../../quickstart.rst:344 +#: ../../quickstart.rst:345 msgid "Create any subcommands without groups *before* creating any groups." msgstr "" -#: ../../quickstart.rst:346 +#: ../../quickstart.rst:347 msgid "" "Since there are multiple coroutines involved that each get executed, you " "may be wondering how you can stop the chain. Luckily, there is a way:" msgstr "" -#: ../../quickstart.rst:360 +#: ../../quickstart.rst:361 msgid "This works on both groups and subcommands." msgstr "" -#: ../../quickstart.rst:362 +#: ../../quickstart.rst:363 msgid "The following is an example of an error callback:" msgstr "" -#: ../../quickstart.rst:378 +#: ../../quickstart.rst:379 msgid "" "The parameters ``ctx`` and ``error`` are required, but you can have more " "parameters, such as ``*args`` and ``**kwargs``, if you need to access " "options." msgstr "" -#: ../../quickstart.rst:382 +#: ../../quickstart.rst:383 msgid "You can have one error callback per command." msgstr "" -#: ../../quickstart.rst:385 +#: ../../quickstart.rst:386 msgid "Special type of commands: Context menus" msgstr "" -#: ../../quickstart.rst:387 +#: ../../quickstart.rst:388 msgid "" "While, granted that application commands are way more intuitive and " "easier to work with as both a bot developer and user from a UX approach, " @@ -472,39 +480,39 @@ msgid "" " right-click actions with menial effort." msgstr "" -#: ../../quickstart.rst:393 +#: ../../quickstart.rst:394 msgid "" "In order to create a menu-based command, all you need to do is simply add" " this one line into your ``@command`` decorator:" msgstr "" -#: ../../quickstart.rst:406 +#: ../../quickstart.rst:407 msgid "Here is an alternate way of creating a context menu:" msgstr "" -#: ../../quickstart.rst:415 +#: ../../quickstart.rst:416 msgid "" "The structure of a menu command differs significantly from that of a " "regular one:" msgstr "" -#: ../../quickstart.rst:417 +#: ../../quickstart.rst:418 msgid "You cannot have any options or choices." msgstr "" -#: ../../quickstart.rst:418 +#: ../../quickstart.rst:419 msgid "You cannot have a description." msgstr "" -#: ../../quickstart.rst:419 +#: ../../quickstart.rst:420 msgid "The ``name`` filter follows a different regex pattern." msgstr "" -#: ../../quickstart.rst:422 +#: ../../quickstart.rst:423 msgid "Creating and sending Components" msgstr "" -#: ../../quickstart.rst:424 +#: ../../quickstart.rst:425 msgid "" "Being able to run your own commands is very useful for a lot of " "automation-related purposes as a bot developer, however, we also have " @@ -513,14 +521,14 @@ msgid "" "components." msgstr "" -#: ../../quickstart.rst:429 +#: ../../quickstart.rst:430 msgid "" "Components are ways of being able to select pre-defined data, or define " "your own. They're very simple but quite powerful when put into practice " "This code block below shows a simplified implementation of a component:" msgstr "" -#: ../../quickstart.rst:455 +#: ../../quickstart.rst:456 msgid "" "This is a design that we ended up choosing to simplify responding to " "buttons when someone presses on one, and to allow bot developers to plug " @@ -530,11 +538,11 @@ msgid "" "modularity." msgstr "" -#: ../../quickstart.rst:462 +#: ../../quickstart.rst:463 msgid "What kinds of components are there?" msgstr "" -#: ../../quickstart.rst:464 +#: ../../quickstart.rst:465 msgid "" "As a bot developer, this may be fairly important for you to want to know." " Different components provide difference user experiences, interactions " @@ -543,18 +551,18 @@ msgid "" "able to `find these component types`_ here." msgstr "" -#: ../../quickstart.rst:471 +#: ../../quickstart.rst:472 msgid "How do I send components in a row?" msgstr "" -#: ../../quickstart.rst:473 +#: ../../quickstart.rst:474 msgid "" "You are also able to organize these components into rows, which are " "defined as ``ActionRow``'s. It is worth noting that you can have only a " "maximum of 5 per message that you send. This code block below shows how:" msgstr "" -#: ../../quickstart.rst:505 +#: ../../quickstart.rst:506 msgid "" "By default, the ``components`` keyword-argument field in the context " "sending method will always support ``ActionRow``-less sending: you only " @@ -563,57 +571,57 @@ msgid "" "class objects instead." msgstr "" -#: ../../quickstart.rst:511 +#: ../../quickstart.rst:512 msgid "" "You cannot use ``TextInput`` with the above shown method. Look :ref:`here" " ` how to create and send them." msgstr "" -#: ../../quickstart.rst:516 +#: ../../quickstart.rst:517 msgid "Creating a TextInput" msgstr "" -#: ../../quickstart.rst:517 +#: ../../quickstart.rst:518 msgid "You want to get a Text from a user? You can use ``TextInput`` for that." msgstr "" -#: ../../quickstart.rst:529 +#: ../../quickstart.rst:530 msgid "" "But how to send it? You can't use ``ctx.send`` for it. Take a look at " ":ref:`Modals ` for that." msgstr "" -#: ../../quickstart.rst:533 +#: ../../quickstart.rst:534 msgid "Modals" msgstr "" -#: ../../quickstart.rst:534 +#: ../../quickstart.rst:535 msgid "" "Modals are a new way to interact with a user. Currently only a " "``TextInput`` component is supported. You can have up to five " "``TextInput`` in a Modal." msgstr "" -#: ../../quickstart.rst:547 +#: ../../quickstart.rst:548 msgid "with the ``TextInput`` example from above we get:" msgstr "" -#: ../../quickstart.rst:552 +#: ../../quickstart.rst:553 msgid "Responding to a Modal interaction" msgstr "" -#: ../../quickstart.rst:560 +#: ../../quickstart.rst:561 msgid "" "You can respond to a modal the same way as you would respond to a normal " "``chat-input`` command, except your function has an extra argument for " "the text what was put into the modal." msgstr "" -#: ../../quickstart.rst:563 +#: ../../quickstart.rst:564 msgid "Adding v2 Permissions" msgstr "" -#: ../../quickstart.rst:565 +#: ../../quickstart.rst:566 msgid "" "v2 permissions consist of the ``default_member_permissions`` and " "``dm_permission`` keyword arguments. Similar to adding privileged " @@ -621,55 +629,87 @@ msgid "" "etc.) as follows:" msgstr "" -#: ../../quickstart.rst:604 +#: ../../quickstart.rst:605 msgid "" "Adding guild-only commands is easier as the only thing it takes is a " "boolean. Here's an example of a guild-only command:" msgstr "" -#: ../../quickstart.rst:623 +#: ../../quickstart.rst:624 msgid "" "Likewise, setting ``dm_permission`` to ``True`` makes it usable in DMs. " "Just to note that this argument's mainly used for global commands. Guild " "commands with this argument will have no effect." msgstr "" -#: ../../quickstart.rst:627 +#: ../../quickstart.rst:628 msgid "Utilities" msgstr "" -#: ../../quickstart.rst:629 +#: ../../quickstart.rst:630 msgid "You can use the following utilities to help you with your commands:" msgstr "" -#: ../../quickstart.rst:631 +#: ../../quickstart.rst:632 msgid "``ActionRow.new()``: Creates a new ``ActionRow`` object." msgstr "" -#: ../../quickstart.rst:632 +#: ../../quickstart.rst:633 msgid "``spread_to_rows()``: Spreads a list of components into a list of rows." msgstr "" -#: ../../quickstart.rst:633 +#: ../../quickstart.rst:634 msgid "" "``@autodefer()``: Automatically defers a command if it did not respond " "within the specified time." msgstr "" -#: ../../quickstart.rst:635 +#: ../../quickstart.rst:636 msgid "" -"Look at their documentation :ref:`here ` for " -"more information." +"Look at their documentation :ref:`here ` for more " +"information." msgstr "" -#: ../../quickstart.rst:637 +#: ../../quickstart.rst:638 msgid "Usage of ``ActionRow.new()``:" msgstr "" -#: ../../quickstart.rst:653 +#: ../../quickstart.rst:654 msgid "Usage of ``spread_to_rows()``:" msgstr "" -#: ../../quickstart.rst:675 +#: ../../quickstart.rst:676 msgid "Usage of ``@autodefer()``:" msgstr "" + +#~ msgid "" +#~ "**discord-interactions** is a :ref:`Python " +#~ "library ` for the" +#~ " Discord Application Programming Interface. " +#~ "(API) A library in Python has to" +#~ " be installed through the `pip` file." +#~ " Run this in your terminal/command " +#~ "line in order to install our " +#~ "library:" +#~ msgstr "" + +#~ msgid "" +#~ "The first field in the ``@option()`` " +#~ "decorator is the type of the " +#~ "option. This is positional only and " +#~ "required. You can use integers, the " +#~ "default Python types, the ``OptionType`` " +#~ "enum, or supported objects such as " +#~ "``interactions.Channel``." +#~ msgstr "" + +#~ msgid "All other arguments in the decorator are keyword arguments only." +#~ msgstr "" + +#~ msgid "The ``name`` field is required." +#~ msgstr "" + +#~ msgid "" +#~ "Look at their documentation :ref:`here " +#~ "` for more information." +#~ msgstr "" diff --git a/docs/locale/pl/LC_MESSAGES/utils.po b/docs/locale/pl/LC_MESSAGES/utils.po new file mode 100644 index 000000000..2968b6970 --- /dev/null +++ b/docs/locale/pl/LC_MESSAGES/utils.po @@ -0,0 +1,361 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../utils.rst:4 +msgid "The ``get`` utility method" +msgstr "" + +#: interactions.utils.get.get:1 of +msgid "Helper method to get an object." +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "This method can do the following:" +msgstr "" + +#: interactions.utils.get.get:6 of +msgid "Get a list of specific objects" +msgstr "" + +#: interactions.utils.get.get:5 interactions.utils.get.get:9 of +msgid "purely from cache" +msgstr "" + +#: interactions.utils.get.get:6 interactions.utils.get.get:10 of +msgid "purely from HTTP" +msgstr "" + +#: interactions.utils.get.get:7 of +msgid "" +"from cache and additionally from HTTP for every ID that was not found in " +"cache" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "Get a single specific object" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "from HTTP if not found in cache else from cache" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "The method has to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "You don't force anything" +msgstr "" + +#: interactions.utils.get.get:15 of +msgid "You force HTTP" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "The method doesn't have to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "You force cache" +msgstr "" + +#: interactions.utils.get.get:20 of +msgid "" +"Technically, there is no need for an ``await`` if there is an object " +"found in the cache. Because of the fact, that, as long as you don't " +"enforce the cache, the function will get the object from HTTP, if it is " +"not in the cache, you still have to await it. This has been done to " +"reduce confusion on whether the object origins from an HTTP call or a " +"cache result and to remove the extra step for you to check if the " +"returned object is an awaitable or not." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing:" +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing can be done via the ``force`` keyword argument." +msgstr "" + +#: interactions.utils.get.get:31 of +msgid "``force=\"cache\"`` or ``force=interactions.Force.CACHE``:" +msgstr "" + +#: interactions.utils.get.get:30 of +msgid "" +"This forces the method to only return from cache (if the object is not " +"found it will return ``None``). If you use this, you don't need to await " +"the method." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "``force=\"http\"`` or ``force=interactions.Force.HTTP``:" +msgstr "" + +#: interactions.utils.get.get:34 of +msgid "" +"This forces the method to make an HTTP request to the discord API and " +"return the result of it. If you use this, you have to await the method." +msgstr "" + +#: interactions.utils.get.get:38 of +msgid "" +"If you are a PyCharm user, please be aware of a bug that causes incorrect" +" suggestions to appear if using an enum. Even if PyCharm shows a normal " +"object as result, you have to await the method if you enforce HTTP. To " +"prevent this bug from happening it is suggested using ``force=\"http\"`` " +"instead of the enum." +msgstr "" + +#: interactions.utils.get.get:43 of +msgid "Getting an object:" +msgstr "" + +#: interactions.utils.get.get:45 of +msgid "" +"Here you will see two examples on how to get a single objects and the " +"variations of how the object can be gotten." +msgstr "" + +#: interactions.utils.get.get:48 of +msgid "Example 1/2: Getting a Channel:" +msgstr "" + +#: interactions.utils.get.get:65 of +msgid "Example 2/2: Getting a Member:" +msgstr "" + +#: interactions.utils.get.get:88 of +msgid "" +"Both examples should have given you a basic overview on how to get a " +"single object. Now we will move on with lists of objects." +msgstr "" + +#: interactions.utils.get.get:92 of +msgid "" +"The ``parent_id`` represents the channel or guild id that belongs to the " +"objects you want to get. It is called ``parent_id`` because " +"``guild_or_channel_id`` would be horrible to type out every time." +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "Getting a list of an object:" +msgstr "" + +#: interactions.utils.get.get:96 of +msgid "" +"Here you will see 1 example of how to get a list of objects. The " +"possibilities on how to force (and their results) are the same as in the " +"examples above." +msgstr "" + +#: interactions.utils.get.get:99 of +msgid "Example 1/1: Getting a list of members:" +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "" +"If you enforce cache when getting a list of objects, found objets will be" +" placed into the list and not found objects will be placed as ``None`` " +"into the list." +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Parameters" +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Return type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "An enumerable object representing the force types for the get method." +msgstr "" + +#: interactions.utils.get.Force of +msgid "Variables" +msgstr "" + +#: interactions.utils.get.Force:3 of +msgid "Enforce the usage of cache and block the usage of http" +msgstr "" + +#: interactions.utils.get.Force:4 of +msgid "Enforce the usage of http and block the usage of cache" +msgstr "" + +#: interactions.utils.get.Force of +msgid "Member Type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: ../../utils.rst:10 +msgid "Utilities" +msgstr "" + +#: interactions.utils.utils.autodefer:1 of +msgid "" +"A decorator that automatically defers a command if it did not respond " +"within ``delay`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:3 of +msgid "The structure of the decorator is:" +msgstr "" + +#: interactions.utils.utils.autodefer:13 of +msgid "" +"The amount of time in seconds to wait before defering the command. " +"Defaults to ``2`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:15 of +msgid "Whether the command is deferred ephemerally. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer:17 of +msgid "Whether the command is deferred on origin. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable of +msgid "Returns" +msgstr "" + +#: interactions.utils.utils.autodefer:19 of +msgid "The inner function, for decorating." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:1 of +msgid "A helper function that spreads components into :class:`ActionRow` s." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:3 of +msgid "Example:" +msgstr "" + +#: interactions.utils.utils.spread_to_rows:24 of +msgid "" +"You can only pass in :class:`ActionRow`s, :class:`Button`s, and " +":class:`SelectMenu`s, but in any order." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:26 of +msgid "The components to spread." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:28 of +msgid "The maximum number of components in a single row. Defaults to ``5``." +msgstr "" + +#: interactions.utils.utils.search_iterable:1 of +msgid "" +"Searches through an iterable for items that: - Are True for the check, if" +" one is given - Have attributes that match the keyword arguments (e.x. " +"passing `id=your_id` will only return objects with that id)" +msgstr "" + +#: interactions.utils.utils.search_iterable:5 of +msgid "The iterable to search through" +msgstr "" + +#: interactions.utils.utils.search_iterable:7 of +msgid "The check that items will be checked against" +msgstr "" + +#: interactions.utils.utils.search_iterable:9 of +msgid "Any attributes the items should have" +msgstr "" + +#: interactions.utils.utils.search_iterable:11 of +msgid "All items that match the check and keywords" +msgstr "" + +#: interactions.utils.utils.disable_components:1 of +msgid "Disables the given components." +msgstr "" + +#: interactions.utils.utils.disable_components:3 of +msgid "The components to disable" +msgstr "" + +#: interactions.utils.utils.get_channel_history:1 of +msgid "Gets the history of a channel." +msgstr "" + +#: interactions.utils.utils.get_channel_history:3 of +msgid "The HTTPClient of the bot or your bot instance" +msgstr "" + +#: interactions.utils.utils.get_channel_history:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:7 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:9 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.utils.utils.get_channel_history:11 of +msgid "A check to ignore specific messages" +msgstr "" + +#: interactions.utils.utils.get_channel_history:13 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.utils.utils.get_channel_history:16 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.dispatch.po b/docs/locale/ru/LC_MESSAGES/api.dispatch.po index 2b020e27a..18a4ff864 100644 --- a/docs/locale/ru/LC_MESSAGES/api.dispatch.po +++ b/docs/locale/ru/LC_MESSAGES/api.dispatch.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.dispatch.rst:4 msgid "Dispatching" @@ -38,12 +38,6 @@ msgstr "" msgid "A list of events being dispatched." msgstr "" -#: interactions.api.dispatch.Listener -#: interactions.api.dispatch.Listener.dispatch -#: interactions.api.dispatch.Listener.register of -msgid "Return type" -msgstr "" - #: interactions.api.dispatch.Listener.dispatch:1 of msgid "Dispatches an event given out by the gateway." msgstr "" @@ -83,3 +77,6 @@ msgstr "" #: interactions.api.dispatch.Listener.register:9 of msgid "The name to associate the coroutine with. Defaults to None." msgstr "" + +#~ msgid "Return type" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.gateway.po b/docs/locale/ru/LC_MESSAGES/api.gateway.po index aad9d8772..22e00a8ed 100644 --- a/docs/locale/ru/LC_MESSAGES/api.gateway.po +++ b/docs/locale/ru/LC_MESSAGES/api.gateway.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.gateway.rst:4 msgid "Gateway" @@ -36,121 +36,169 @@ msgid "" "WebSocket." msgstr "" +#: interactions.api.gateway.client.WebSocketClient:4 of +msgid "" +"The ``__heartbeat_event`` Event object is different from the one built in" +" to the Heartbeater object. The latter is used to trace heartbeat " +"acknowledgement." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient of msgid "Variables" msgstr "" -#: interactions.api.gateway.client.WebSocketClient:3 of +#: interactions.api.gateway.client.WebSocketClient:7 of msgid "The asynchronous event loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:4 of +#: interactions.api.gateway.client.WebSocketClient:8 of msgid "The built-in event dispatcher." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:5 of +#: interactions.api.gateway.client.WebSocketClient:9 of +msgid "The websocket ratelimiter object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:10 of msgid "The user-facing HTTP client." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:6 of +#: interactions.api.gateway.client.WebSocketClient:11 of msgid "The WebSocket data of the connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:7 of +#: interactions.api.gateway.client.WebSocketClient:12 of msgid "Whether the connection has been closed or not." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:8 of +#: interactions.api.gateway.client.WebSocketClient:13 of msgid "The connection options made during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:9 of +#: interactions.api.gateway.client.WebSocketClient:14 of msgid "The gateway intents used for connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:10 of +#: interactions.api.gateway.client.WebSocketClient:15 of msgid "The contents of the application returned when ready." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:11 of +#: interactions.api.gateway.client.WebSocketClient:16 of msgid "The context state of a \"heartbeat\" made to the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:12 of +#: interactions.api.gateway.client.WebSocketClient:17 of +msgid "The state of the overall heartbeat process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:18 of msgid "The shards used during connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:13 of +#: interactions.api.gateway.client.WebSocketClient:19 of msgid "The presence used in connection." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:14 of +#: interactions.api.gateway.client.WebSocketClient:20 of msgid "The ready state of the client as an ``asyncio.Event``." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:15 of -msgid "The closing task for ending connections." +#: interactions.api.gateway.client.WebSocketClient:21 of +msgid "The task containing the heartbeat manager process." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:16 of +#: interactions.api.gateway.client.WebSocketClient:22 of msgid "Whether the client has started." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:17 of +#: interactions.api.gateway.client.WebSocketClient:23 of msgid "The ID of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:18 of +#: interactions.api.gateway.client.WebSocketClient:24 of msgid "The sequence identifier of the ongoing session." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:19 of +#: interactions.api.gateway.client.WebSocketClient:25 of msgid "" "The latest time of the last send_packet function call since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:20 of +#: interactions.api.gateway.client.WebSocketClient:26 of msgid "" "The latest time of the last ``HEARTBEAT_ACK`` event since connection " "creation, in seconds." msgstr "" -#: interactions.api.gateway.client.WebSocketClient:21 of -msgid "The latency of the connection, in seconds." +#: interactions.api.gateway.client.WebSocketClient:27 of +msgid "The Websocket ratelimit URL for resuming connections, if any." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:28 of +msgid "The Websocket URL for instantiating connections without resuming." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:29 of +msgid "The lock used for reconnecting the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:30 of +msgid "The lock used for closing the client." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient:31 of +msgid "The task containing stopping the client, if any." msgstr "" #: interactions.api.gateway.client.WebSocketClient #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__identify +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache #: interactions.api.gateway.client.WebSocketClient.__option_type_context +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection +#: interactions.api.gateway.client.WebSocketClient._handle_stream +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence +#: interactions.api.gateway.client.WebSocketClient.request_guild_members #: interactions.api.gateway.heartbeat._Heartbeat of msgid "Parameters" msgstr "" -#: interactions.api.gateway.client.WebSocketClient +#: interactions.api.gateway.client.WebSocketClient.latency:1 of +msgid "The latency of the connection, in seconds." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat:1 of +msgid "" +"Controls the heartbeat manager. Do note that this shouldn't be executed " +"by outside processes." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__heartbeat #: interactions.api.gateway.client.WebSocketClient.__identify #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream -#: interactions.api.gateway.client.WebSocketClient.__restart +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__resume #: interactions.api.gateway.client.WebSocketClient.__sub_command_context #: interactions.api.gateway.client.WebSocketClient._dispatch_event -#: interactions.api.gateway.client.WebSocketClient._establish_connection -#: interactions.api.gateway.client.WebSocketClient._handle_connection #: interactions.api.gateway.client.WebSocketClient._manage_heartbeat +#: interactions.api.gateway.client.WebSocketClient._reconnect #: interactions.api.gateway.client.WebSocketClient._send_packet #: interactions.api.gateway.client.WebSocketClient._update_presence -#: interactions.api.gateway.client.WebSocketClient.wait_until_ready -#: interactions.api.gateway.heartbeat._Heartbeat of +#: interactions.api.gateway.client.WebSocketClient.close +#: interactions.api.gateway.client.WebSocketClient.request_guild_members +#: interactions.api.gateway.client.WebSocketClient.run +#: interactions.api.gateway.client.WebSocketClient.run_heartbeat +#: interactions.api.gateway.client.WebSocketClient.wait_until_ready of msgid "Return type" msgstr "" @@ -158,29 +206,21 @@ msgstr "" msgid "Manages the heartbeat loop." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__restart:1 of -msgid "Restart the client's connection and heartbeat with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:1 of -msgid "Establishes a client connection with the Gateway." -msgstr "" - -#: interactions.api.gateway.client.WebSocketClient._establish_connection:3 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:5 of -msgid "The shards to establish a connection with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient.run:1 of +msgid "Handles the client's connection with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._establish_connection:5 -#: interactions.api.gateway.client.WebSocketClient._handle_connection:7 of -msgid "The presence to carry with. Defaults to ``None``." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:1 of +msgid "" +"Parses raw stream data recieved from the Gateway, including Gateway " +"opcodes and events." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:1 of -msgid "Handles the client's connection with the Gateway." +#: interactions.api.gateway.client.WebSocketClient._handle_stream:4 of +msgid "This should never be called directly." msgstr "" -#: interactions.api.gateway.client.WebSocketClient._handle_connection:3 of +#: interactions.api.gateway.client.WebSocketClient._handle_stream:6 of msgid "The packet stream to handle." msgstr "" @@ -192,31 +232,68 @@ msgstr "" msgid "Dispatches an event from the Gateway." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:3 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:3 of msgid "The name of the event." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:5 #: interactions.api.gateway.client.WebSocketClient._dispatch_event:5 of msgid "The data for the event." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of -msgid "" -"Takes raw data given back from the Gateway and gives \"context\" based " -"off of what it is." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:1 of +msgid "Gets an ID from object." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of -msgid "The data from the Gateway." +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:5 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:3 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:7 of +msgid "The object of the event." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:7 +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:5 +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:9 of +msgid "The model of the event." msgstr "" #: interactions.api.gateway.client.WebSocketClient.__contextualize +#: interactions.api.gateway.client.WebSocketClient.__get_object_id +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids #: interactions.api.gateway.client.WebSocketClient.__option_type_context -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream +#: interactions.api.gateway.client.WebSocketClient.__receive_packet #: interactions.api.gateway.client.WebSocketClient.__sub_command_context of msgid "Returns" msgstr "" +#: interactions.api.gateway.client.WebSocketClient.__get_object_id:9 of +msgid "Object ID" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:1 of +msgid "Gets a list of ids of object." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__get_object_ids:7 of +msgid "Object IDs" +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__modify_guild_cache:1 of +msgid "Modifies guild cache." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:1 of +msgid "" +"Takes raw data given back from the Gateway and gives \"context\" based " +"off of what it is." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__contextualize:4 of +msgid "The data from the Gateway." +msgstr "" + #: interactions.api.gateway.client.WebSocketClient.__contextualize:6 of msgid "The context object." msgstr "" @@ -255,11 +332,15 @@ msgstr "" msgid "The option type context." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:1 of -msgid "Receives a stream of packets sent from the Gateway." +#: interactions.api.gateway.client.WebSocketClient._reconnect:1 of +msgid "Restarts the client's connection and heartbeat with the Gateway." msgstr "" -#: interactions.api.gateway.client.WebSocketClient.__receive_packet_stream:3 of +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:1 of +msgid "Receives a stream of packets sent from the Gateway in an async process." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.__receive_packet:3 of msgid "The packet stream." msgstr "" @@ -311,6 +392,58 @@ msgid "" "disconnect." msgstr "" +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:1 of +msgid "Sends an ``REQUEST_MEMBERS`` packet to the gateway." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:3 of +msgid "ID of the guild to get members for." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:5 of +msgid "" +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:7 of +msgid "String that username starts with." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." +msgstr "" + +#: interactions.api.gateway.client.WebSocketClient.close:1 of +msgid "Closes the current connection." +msgstr "" + #: interactions.api.gateway.heartbeat._Heartbeat:1 of msgid "An internal class representing the heartbeat in a WebSocket connection." msgstr "" + +#~ msgid "The closing task for ending connections." +#~ msgstr "" + +#~ msgid "Restart the client's connection and heartbeat with the Gateway." +#~ msgstr "" + +#~ msgid "Establishes a client connection with the Gateway." +#~ msgstr "" + +#~ msgid "The shards to establish a connection with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "The presence to carry with. Defaults to ``None``." +#~ msgstr "" + +#~ msgid "Receives a stream of packets sent from the Gateway." +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.http.po b/docs/locale/ru/LC_MESSAGES/api.http.po index b141f2d87..fcab462c2 100644 --- a/docs/locale/ru/LC_MESSAGES/api.http.po +++ b/docs/locale/ru/LC_MESSAGES/api.http.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.http.rst:4 msgid "HTTP" @@ -55,10 +55,13 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag #: interactions.api.http.channel.ChannelRequest.delete_channel #: interactions.api.http.channel.ChannelRequest.delete_channel_permission #: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag #: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -75,6 +78,7 @@ msgstr "" #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template @@ -169,6 +173,7 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker #: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread #: interactions.api.http.thread.ThreadRequest.join_thread #: interactions.api.http.thread.ThreadRequest.leave_thread @@ -198,14 +203,19 @@ msgstr "" msgid "Parameters" msgstr "" -#: interactions.api.http.channel.ChannelRequest +#: interactions.api.http.route.Route.get_bucket:1 of +msgid "" +"Returns the route's bucket. If shared_bucket is None, returns the path " +"with major parameters. Otherwise, it relies on Discord's given bucket." +msgstr "" + +#: interactions.api.http.route.Route.get_bucket:4 of +msgid "The bucket that Discord provides, if available." +msgstr "" + #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance -#: interactions.api.http.channel.ChannelRequest.delete_channel -#: interactions.api.http.channel.ChannelRequest.delete_channel_permission -#: interactions.api.http.channel.ChannelRequest.delete_stage_instance -#: interactions.api.http.channel.ChannelRequest.edit_channel_permission #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -214,37 +224,21 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel -#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway -#: interactions.api.http.client.HTTPClient.get_current_authorisation_information -#: interactions.api.http.client.HTTPClient.get_current_bot_information -#: interactions.api.http.client.HTTPClient.get_gateway -#: interactions.api.http.client.HTTPClient.login -#: interactions.api.http.client.HTTPClient.logout -#: interactions.api.http.emoji.EmojiRequest #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji -#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji -#: interactions.api.http.guild.GuildRequest #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template -#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template -#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.delete_guild -#: interactions.api.http.guild.GuildRequest.delete_guild_integration -#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles -#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild -#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -255,28 +249,17 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings -#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild -#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule -#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget -#: interactions.api.http.guild.GuildRequest.modify_user_voice_state -#: interactions.api.http.guild.GuildRequest.remove_guild_ban -#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template -#: interactions.api.http.interaction.InteractionRequest -#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command -#: interactions.api.http.interaction.InteractionRequest.create_interaction_response -#: interactions.api.http.interaction.InteractionRequest.delete_application_command -#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -285,46 +268,22 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command -#: interactions.api.http.limiter.Limiter -#: interactions.api.http.member.MemberRequest -#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member -#: interactions.api.http.member.MemberRequest.remove_member_role -#: interactions.api.http.member.MemberRequest.search_guild_members -#: interactions.api.http.message.MessageRequest -#: interactions.api.http.message.MessageRequest.create_message -#: interactions.api.http.message.MessageRequest.delete_message -#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message -#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message -#: interactions.api.http.message.MessageRequest.send_message -#: interactions.api.http.message.MessageRequest.unpin_message -#: interactions.api.http.reaction.ReactionRequest -#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions -#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji -#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction -#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction -#: interactions.api.http.request._Request -#: interactions.api.http.request._Request._check_lock -#: interactions.api.http.request._Request._check_session -#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request -#: interactions.api.http.route.Route interactions.api.http.route.Route.endpoint +#: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket -#: interactions.api.http.scheduledEvent.ScheduledEventRequest #: interactions.api.http.scheduledEvent.ScheduledEventRequest.create_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.delete_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event_users #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events #: interactions.api.http.scheduledEvent.ScheduledEventRequest.modify_scheduled_event -#: interactions.api.http.sticker.StickerRequest #: interactions.api.http.sticker.StickerRequest.create_guild_sticker #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker #: interactions.api.http.sticker.StickerRequest.get_guild_sticker @@ -332,53 +291,44 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker -#: interactions.api.http.thread.ThreadRequest -#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread -#: interactions.api.http.thread.ThreadRequest.join_thread -#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members -#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread -#: interactions.api.http.user.UserRequest #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user -#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild -#: interactions.api.http.webhook.WebhookRequest #: interactions.api.http.webhook.WebhookRequest.create_webhook -#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message -#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks -#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Return type" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:1 of -msgid "" -"Returns the route's bucket. If shared_bucket is None, returns the path " -"with major parameters. Otherwise, it relies on Discord's given bucket." +msgid "Returns" msgstr "" -#: interactions.api.http.route.Route.get_bucket:4 of -msgid "The bucket that Discord provides, if available." +#: interactions.api.http.route.Route.get_bucket:7 of +msgid "The route bucket." msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel #: interactions.api.http.channel.ChannelRequest.create_channel_invite #: interactions.api.http.channel.ChannelRequest.create_stage_instance +#: interactions.api.http.channel.ChannelRequest.create_tag +#: interactions.api.http.channel.ChannelRequest.delete_channel +#: interactions.api.http.channel.ChannelRequest.delete_channel_permission +#: interactions.api.http.channel.ChannelRequest.delete_stage_instance +#: interactions.api.http.channel.ChannelRequest.delete_tag +#: interactions.api.http.channel.ChannelRequest.edit_channel_permission +#: interactions.api.http.channel.ChannelRequest.edit_tag #: interactions.api.http.channel.ChannelRequest.get_channel #: interactions.api.http.channel.ChannelRequest.get_channel_invites #: interactions.api.http.channel.ChannelRequest.get_channel_messages @@ -387,20 +337,36 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.modify_channel #: interactions.api.http.channel.ChannelRequest.modify_stage_instance #: interactions.api.http.channel.ChannelRequest.move_channel +#: interactions.api.http.channel.ChannelRequest.trigger_typing #: interactions.api.http.client.HTTPClient.get_bot_gateway +#: interactions.api.http.client.HTTPClient.get_current_authorisation_information +#: interactions.api.http.client.HTTPClient.get_current_bot_information +#: interactions.api.http.client.HTTPClient.get_gateway +#: interactions.api.http.client.HTTPClient.login +#: interactions.api.http.client.HTTPClient.logout #: interactions.api.http.emoji.EmojiRequest.create_guild_emoji +#: interactions.api.http.emoji.EmojiRequest.delete_guild_emoji #: interactions.api.http.emoji.EmojiRequest.get_all_emoji #: interactions.api.http.emoji.EmojiRequest.get_guild_emoji #: interactions.api.http.emoji.EmojiRequest.modify_guild_emoji #: interactions.api.http.guild.GuildRequest.add_guild_member +#: interactions.api.http.guild.GuildRequest.begin_guild_prune #: interactions.api.http.guild.GuildRequest.create_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.create_guild_ban #: interactions.api.http.guild.GuildRequest.create_guild_from_guild_template +#: interactions.api.http.guild.GuildRequest.create_guild_kick #: interactions.api.http.guild.GuildRequest.create_guild_role #: interactions.api.http.guild.GuildRequest.create_guild_template +#: interactions.api.http.guild.GuildRequest.delete_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.delete_guild +#: interactions.api.http.guild.GuildRequest.delete_guild_integration +#: interactions.api.http.guild.GuildRequest.delete_guild_role #: interactions.api.http.guild.GuildRequest.delete_guild_template #: interactions.api.http.guild.GuildRequest.get_all_channels #: interactions.api.http.guild.GuildRequest.get_all_roles +#: interactions.api.http.guild.GuildRequest.get_auto_moderation_rule #: interactions.api.http.guild.GuildRequest.get_guild +#: interactions.api.http.guild.GuildRequest.get_guild_auditlog #: interactions.api.http.guild.GuildRequest.get_guild_bans #: interactions.api.http.guild.GuildRequest.get_guild_integrations #: interactions.api.http.guild.GuildRequest.get_guild_invites @@ -411,17 +377,27 @@ msgstr "" #: interactions.api.http.guild.GuildRequest.get_guild_widget #: interactions.api.http.guild.GuildRequest.get_guild_widget_image #: interactions.api.http.guild.GuildRequest.get_guild_widget_settings +#: interactions.api.http.guild.GuildRequest.get_self_guilds #: interactions.api.http.guild.GuildRequest.get_user_ban #: interactions.api.http.guild.GuildRequest.leave_guild +#: interactions.api.http.guild.GuildRequest.list_auto_moderation_rules #: interactions.api.http.guild.GuildRequest.modify_auto_moderation_rule +#: interactions.api.http.guild.GuildRequest.modify_current_user_voice_state #: interactions.api.http.guild.GuildRequest.modify_guild #: interactions.api.http.guild.GuildRequest.modify_guild_role #: interactions.api.http.guild.GuildRequest.modify_guild_role_positions #: interactions.api.http.guild.GuildRequest.modify_guild_template #: interactions.api.http.guild.GuildRequest.modify_guild_welcome_screen #: interactions.api.http.guild.GuildRequest.modify_guild_widget +#: interactions.api.http.guild.GuildRequest.modify_user_voice_state +#: interactions.api.http.guild.GuildRequest.remove_guild_ban +#: interactions.api.http.guild.GuildRequest.remove_guild_member #: interactions.api.http.guild.GuildRequest.sync_guild_template +#: interactions.api.http.interaction.InteractionRequest._post_followup #: interactions.api.http.interaction.InteractionRequest.create_application_command +#: interactions.api.http.interaction.InteractionRequest.create_interaction_response +#: interactions.api.http.interaction.InteractionRequest.delete_application_command +#: interactions.api.http.interaction.InteractionRequest.delete_interaction_response #: interactions.api.http.interaction.InteractionRequest.edit_application_command #: interactions.api.http.interaction.InteractionRequest.edit_application_command_permissions #: interactions.api.http.interaction.InteractionRequest.edit_interaction_response @@ -430,13 +406,30 @@ msgstr "" #: interactions.api.http.interaction.InteractionRequest.get_application_commands #: interactions.api.http.interaction.InteractionRequest.get_original_interaction_response #: interactions.api.http.interaction.InteractionRequest.overwrite_application_command +#: interactions.api.http.member.MemberRequest.add_member_role #: interactions.api.http.member.MemberRequest.get_list_of_members #: interactions.api.http.member.MemberRequest.get_member #: interactions.api.http.member.MemberRequest.modify_member +#: interactions.api.http.member.MemberRequest.remove_member_role +#: interactions.api.http.member.MemberRequest.search_guild_members +#: interactions.api.http.message.MessageRequest.create_message +#: interactions.api.http.message.MessageRequest.delete_message +#: interactions.api.http.message.MessageRequest.delete_messages #: interactions.api.http.message.MessageRequest.edit_message #: interactions.api.http.message.MessageRequest.get_message +#: interactions.api.http.message.MessageRequest.pin_message #: interactions.api.http.message.MessageRequest.publish_message +#: interactions.api.http.message.MessageRequest.send_message +#: interactions.api.http.message.MessageRequest.unpin_message +#: interactions.api.http.reaction.ReactionRequest.create_reaction #: interactions.api.http.reaction.ReactionRequest.get_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions +#: interactions.api.http.reaction.ReactionRequest.remove_all_reactions_of_emoji +#: interactions.api.http.reaction.ReactionRequest.remove_self_reaction +#: interactions.api.http.reaction.ReactionRequest.remove_user_reaction +#: interactions.api.http.request._Request._check_lock +#: interactions.api.http.request._Request._check_session +#: interactions.api.http.request._Request.close #: interactions.api.http.request._Request.request #: interactions.api.http.route.Route.endpoint #: interactions.api.http.route.Route.get_bucket @@ -453,31 +446,36 @@ msgstr "" #: interactions.api.http.sticker.StickerRequest.list_guild_stickers #: interactions.api.http.sticker.StickerRequest.list_nitro_sticker_packs #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker +#: interactions.api.http.thread.ThreadRequest.add_member_to_thread #: interactions.api.http.thread.ThreadRequest.create_thread +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum #: interactions.api.http.thread.ThreadRequest.get_member_from_thread +#: interactions.api.http.thread.ThreadRequest.join_thread +#: interactions.api.http.thread.ThreadRequest.leave_thread #: interactions.api.http.thread.ThreadRequest.list_active_threads #: interactions.api.http.thread.ThreadRequest.list_joined_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_private_archived_threads #: interactions.api.http.thread.ThreadRequest.list_public_archived_threads #: interactions.api.http.thread.ThreadRequest.list_thread_members +#: interactions.api.http.thread.ThreadRequest.remove_member_from_thread #: interactions.api.http.user.UserRequest.create_dm #: interactions.api.http.user.UserRequest.get_self #: interactions.api.http.user.UserRequest.get_user +#: interactions.api.http.user.UserRequest.modify_self #: interactions.api.http.user.UserRequest.modify_self_nick_in_guild #: interactions.api.http.webhook.WebhookRequest.create_webhook +#: interactions.api.http.webhook.WebhookRequest.delete_original_webhook_message +#: interactions.api.http.webhook.WebhookRequest.delete_webhook_message #: interactions.api.http.webhook.WebhookRequest.edit_webhook_message #: interactions.api.http.webhook.WebhookRequest.execute_github_webhook #: interactions.api.http.webhook.WebhookRequest.execute_slack_webhook #: interactions.api.http.webhook.WebhookRequest.execute_webhook #: interactions.api.http.webhook.WebhookRequest.get_channel_webhooks #: interactions.api.http.webhook.WebhookRequest.get_guild_webhooks +#: interactions.api.http.webhook.WebhookRequest.get_webhook #: interactions.api.http.webhook.WebhookRequest.get_webhook_message #: interactions.api.http.webhook.WebhookRequest.modify_webhook of -msgid "Returns" -msgstr "" - -#: interactions.api.http.route.Route.get_bucket:7 of -msgid "The route bucket." +msgid "Return type" msgstr "" #: interactions.api.http.route.Route.endpoint:1 of @@ -617,9 +615,12 @@ msgstr "" #: interactions.api.http.channel.ChannelRequest.create_channel_invite:6 #: interactions.api.http.channel.ChannelRequest.create_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.create_tag:7 #: interactions.api.http.channel.ChannelRequest.delete_channel_permission:3 #: interactions.api.http.channel.ChannelRequest.delete_stage_instance:3 +#: interactions.api.http.channel.ChannelRequest.delete_tag:3 #: interactions.api.http.channel.ChannelRequest.edit_channel_permission:3 +#: interactions.api.http.channel.ChannelRequest.edit_tag:7 #: interactions.api.http.channel.ChannelRequest.get_channel:3 #: interactions.api.http.channel.ChannelRequest.get_channel_invites:3 #: interactions.api.http.channel.ChannelRequest.get_channel_messages:6 @@ -919,6 +920,51 @@ msgstr "" msgid "Delete a stage instance." msgstr "" +#: interactions.api.http.channel.ChannelRequest.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:4 +#: interactions.api.http.channel.ChannelRequest.edit_tag:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:8 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:9 +#: interactions.api.http.channel.ChannelRequest.edit_tag:10 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.create_tag:10 +#: interactions.api.http.channel.ChannelRequest.edit_tag:11 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:1 of +msgid "Update a tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:8 of +msgid "The ID of the tag to update." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.edit_tag:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:1 of +msgid "Delete a forum tag." +msgstr "" + +#: interactions.api.http.channel.ChannelRequest.delete_tag:4 of +msgid "The ID of the tag to delete" +msgstr "" + #: interactions.api.http.emoji.EmojiRequest.get_all_emoji:1 of msgid "Gets all emojis from a guild." msgstr "" @@ -1279,6 +1325,7 @@ msgstr "" msgid "Gets all roles from a Guild." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:3 #: interactions.api.http.guild.GuildRequest.create_guild_ban:3 #: interactions.api.http.guild.GuildRequest.create_guild_kick:3 #: interactions.api.http.guild.GuildRequest.get_all_roles:3 @@ -1374,7 +1421,9 @@ msgid "" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "" +"Number of seconds to delete messages for, between 0 and 604800. Default " +"to 0" msgstr "" #: interactions.api.http.guild.GuildRequest.create_guild_ban:6 of @@ -1467,20 +1516,36 @@ msgstr "" msgid "Reason to send to audit log, if any." msgstr "" -#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of -msgid "" -"Retrieves a dict from an API that results in how many members would be " -"pruned given the amount of days." +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:1 of +msgid "Begins a prune operation." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:4 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:4 of -msgid "Number of days to count. Defaults to ``7``." +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:5 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:6 #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:5 of msgid "Role IDs to include, if given." msgstr "" +#: interactions.api.http.guild.GuildRequest.begin_guild_prune:7 of +msgid "A dict containing `{\"pruned\": int}` or `{\"pruned\": None}`" +msgstr "" + +#: interactions.api.http.guild.GuildRequest.get_guild_prune_count:1 of +msgid "" +"Retrieves a dict from an API that results in how many members would be " +"pruned given the amount of days." +msgstr "" + #: interactions.api.http.guild.GuildRequest.get_guild_prune_count:6 of msgid "A dict denoting `{\"pruned\": int}`" msgstr "" @@ -1974,7 +2039,8 @@ msgid "Channel snowflake ID." msgstr "" #: interactions.api.http.message.MessageRequest.create_message:5 -#: interactions.api.http.message.MessageRequest.edit_message:6 of +#: interactions.api.http.message.MessageRequest.edit_message:6 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:9 of msgid "An optional list of files to send attached to the message." msgstr "" @@ -2178,11 +2244,8 @@ msgid "Guild Scheduled Event ID snowflake." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:5 -#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 #: of -msgid "" -"A boolean to include number of users subscribed to the associated event, " -"if given." +msgid "Whether the number of users subscribed to the events is returned." msgstr "" #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_event:6 @@ -2195,6 +2258,13 @@ msgstr "" msgid "Gets all guild scheduled events in a guild." msgstr "" +#: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:4 +#: of +msgid "" +"Whether the number of users subscribed to the associated event is " +"returned." +msgstr "" + #: interactions.api.http.scheduledEvent.ScheduledEventRequest.get_scheduled_events:5 #: of msgid "" @@ -2307,22 +2377,25 @@ msgid "" "MANAGE_EMOJIS_AND_STICKERS permission." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 -#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of -msgid "the payload to send." +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:3 of +msgid "The payload to send." msgstr "" #: interactions.api.http.sticker.StickerRequest.create_guild_sticker:4 of +msgid "The file to send." +msgstr "" + +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 of msgid "The guild to create sticker at." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:5 +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:5 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:6 of msgid "The reason for this action." msgstr "" -#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:6 of +#: interactions.api.http.sticker.StickerRequest.create_guild_sticker:7 of msgid "The new sticker data on success." msgstr "" @@ -2332,6 +2405,10 @@ msgid "" "permission." msgstr "" +#: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:3 of +msgid "the payload to send." +msgstr "" + #: interactions.api.http.sticker.StickerRequest.delete_guild_sticker:3 #: interactions.api.http.sticker.StickerRequest.modify_guild_sticker:4 of msgid "The guild of the target sticker." @@ -2483,15 +2560,18 @@ msgid "" "with.." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:3 of +#: interactions.api.http.thread.ThreadRequest.create_thread:3 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:3 of msgid "The ID of the channel to create this thread in" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:4 of +#: interactions.api.http.thread.ThreadRequest.create_thread:4 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:4 of msgid "The name of the thread" msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:5 of +#: interactions.api.http.thread.ThreadRequest.create_thread:5 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:5 of msgid "" "duration in minutes to automatically archive the thread after recent " "activity, can be set to: 60, 1440, 4320, 10080" @@ -2511,7 +2591,8 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" -#: interactions.api.http.thread.ThreadRequest.create_thread:10 of +#: interactions.api.http.thread.ThreadRequest.create_thread:10 +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:11 of msgid "An optional reason for the audit log" msgstr "" @@ -2519,6 +2600,28 @@ msgstr "" msgid "The created thread" msgstr "" +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:1 of +msgid "From a given Forum channel, create a Thread with a message to start with." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:7 of +msgid "The payload/dictionary contents of the first message in the forum thread." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:8 of +msgid "List of tag ids that can be applied to the forum, if any." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:10 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.http.thread.ThreadRequest.create_thread_in_forum:12 of +msgid "Returns a Thread in a Forum object with a starting Message." +msgstr "" + #: interactions.api.http.user.UserRequest.get_self:1 of msgid "An alias to `get_user`, but only gets the current bot user." msgstr "" @@ -2743,3 +2846,15 @@ msgstr "" #: of msgid "Deletes the original message object sent." msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Number of days to count. Defaults to ``7``." +#~ msgstr "" + +#~ msgid "" +#~ "A boolean to include number of " +#~ "users subscribed to the associated " +#~ "event, if given." +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.models.audit_log.po b/docs/locale/ru/LC_MESSAGES/api.models.audit_log.po new file mode 100644 index 000000000..7ba1f1c2b --- /dev/null +++ b/docs/locale/ru/LC_MESSAGES/api.models.audit_log.po @@ -0,0 +1,413 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.audit_log.rst:4 +msgid "Audit-Log Models" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:1 of +msgid "A class object representing an AuditLogEntry." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange +#: interactions.api.models.audit_log.AuditLogEntry +#: interactions.api.models.audit_log.AuditLogEvents +#: interactions.api.models.audit_log.AuditLogs +#: interactions.api.models.audit_log.OptionalAuditEntryInfo of +msgid "Variables" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:3 of +msgid "ID of the affected entity (webhook, user, role, etc.)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:4 of +msgid "Changes made to the target_id" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:5 of +msgid "User or app that made the changes" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:6 of +msgid "ID of the entry" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:7 of +msgid "Type of action that occurred" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:8 of +msgid "Additional info for certain event types" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEntry:9 of +msgid "Reason for the change (1-512 characters)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "A class object representing the different types of AuditLogEvents." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:3 of +msgid "1 - Server settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:4 of +msgid "10 - Channel was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:5 of +msgid "11 - Channel settings were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:6 of +msgid "12 - Channel was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:7 of +msgid "13 - Permission overwrite was added to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:8 of +msgid "14 - Permission overwrite was updated for a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:9 of +msgid "15 - Permission overwrite was deleted from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:10 of +msgid "20 - Member was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:11 of +msgid "21 - Members were pruned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:12 of +msgid "22 - Member was banned from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:13 of +msgid "23 - Server ban was lifted for a member" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:14 of +msgid "24 - Member was updated in server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:15 of +msgid "25 - Member was added or removed from a role" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:16 of +msgid "26 - Member was moved to a different voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:17 of +msgid "27 - Member was disconnected from a voice channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:18 of +msgid "28 - Bot user was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:19 of +msgid "30 - Role was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:20 of +msgid "31 - Role was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:21 of +msgid "32 - Role was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:22 of +msgid "40 - Server invite was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:23 of +msgid "41 - Server invite was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:24 of +msgid "42 - Server invite was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:25 of +msgid "50 - Webhook was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:26 of +msgid "51 - Webhook properties or channel were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:27 of +msgid "52 - Webhook was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:28 of +msgid "60 - Emoji was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:29 of +msgid "61 - Emoji name was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:30 of +msgid "62 - Emoji was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:31 of +msgid "72 - Single message was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:32 of +msgid "73 - Multiple messages were deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:33 of +msgid "74 - Message was pinned to a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:34 of +msgid "75 - Message was unpinned from a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:35 of +msgid "80 - App was added to server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:36 of +msgid "81 - App was updated (as an example, its scopes were updated)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:37 of +msgid "82 - App was removed from server" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:38 of +msgid "83 - Stage instance was created (stage channel becomes live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:39 of +msgid "84 - Stage instance details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:40 of +msgid "85 - Stage instance was deleted (stage channel no longer live)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:41 of +msgid "90 - Sticker was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:42 of +msgid "91 - Sticker details were updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:43 of +msgid "92 - Sticker was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:44 of +msgid "100 - Event was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:45 of +msgid "101 - Event was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:46 of +msgid "102 - Event was cancelled" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:47 of +msgid "110 - Thread was created in a channel" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:48 of +msgid "111 - Thread was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:49 of +msgid "112 - Thread was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:50 of +msgid "121 - Permissions were updated for a command" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:51 of +msgid "140 - Auto Moderation rule was created" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:52 of +msgid "141 - Auto Moderation rule was updated" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:53 of +msgid "142 - Auto Moderation rule was deleted" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:54 of +msgid "143 - Message was blocked by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:55 of +msgid "144 - Message was flagged by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:56 of +msgid "145 - Member was timed out by AutoMod (according to a rule)" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents of +msgid "Member Type" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid ":py:class:`int`" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogEvents:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:1 of +msgid "A class object representing the audit logs of a guild." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:3 of +msgid "List of audit log entries, sorted from most to least recent." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:4 of +msgid "List of auto moderation rules referenced in the audit log." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:5 of +msgid "List of guild scheduled events referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:6 of +msgid "List of partial integration objects" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:7 of +msgid "List of threads referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:8 of +msgid "List of users referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogs:9 of +msgid "List of webhooks referenced in the audit log" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:1 of +msgid "A class object representing an AuditLogChange." +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:3 of +msgid "New value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:4 of +msgid "Old value of the key" +msgstr "" + +#: interactions.api.models.audit_log.AuditLogChange:5 of +msgid "" +"Name of the changed entity, with a few " +"[exceptions](https://discord.com/developers/docs/resources/audit-log" +"#audit-log-change-object-audit-log-change-exceptions)" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:1 of +msgid "A class object representing OptionalAuditEntryInfo." +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:3 of +msgid "" +"ID of the app whose permissions were targeted. ``AuditLogEvents``-type: " +"121" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:4 of +msgid "" +"Channel in which the entities were targeted. ``AuditLogEvents``-types: " +"26, 74, 75, 72, 83, 84, 85" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:5 of +msgid "" +"Name of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:6 of +msgid "" +"Trigger type of the Auto Moderation rule that was triggered. " +"``AuditLogEvents``-types: 143, 144, 145" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:7 of +msgid "" +"Number of entities that were targeted. ``AuditLogEvents``-types: 72, 73, " +"27, 26" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:8 of +msgid "" +"Number of days after which inactive members were kicked. " +"``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:9 of +msgid "ID of the overwritten entity. ``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:10 of +msgid "Number of members removed by the prune. ``AuditLogEvents``-types: 21" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:11 of +msgid "ID of the message that was targeted. ``AuditLogEvents``-types: 74, 75" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:12 of +msgid "" +"Name of the role if type is \"0\" (not present if type is \"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#: interactions.api.models.audit_log.OptionalAuditEntryInfo:13 of +msgid "" +"Type of overwritten entity - role (\"0\") or member (\"1\"). " +"``AuditLogEvents``-types: 13, 14, 15" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.models.channel.po b/docs/locale/ru/LC_MESSAGES/api.models.channel.po index 1ca5f1ac3..81a65bd8e 100644 --- a/docs/locale/ru/LC_MESSAGES/api.models.channel.po +++ b/docs/locale/ru/LC_MESSAGES/api.models.channel.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.channel.rst:4 msgid "Channel Models" @@ -39,22 +39,24 @@ msgid "Valid values are as follows:" msgstr "" #: interactions.api.models.channel.Thread:1 of -msgid "An object representing a thread." -msgstr "" - -#: interactions.api.models.channel.Thread:4 of -msgid "" -"This is a derivation of the base Channel, since a thread can be its own " -"event." +msgid "An object representing a thread. .. note::" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator +#: interactions.api.models.channel.AsyncTypingContextManager #: interactions.api.models.channel.Channel #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.modify #: interactions.api.models.channel.Channel.pin_message @@ -72,6 +74,9 @@ msgstr "" #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit #: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit #: interactions.api.models.channel.Thread #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of @@ -88,7 +93,7 @@ msgid "" "needed to be used directly." msgstr "" -#: interactions.api.models.channel.Channel +#: interactions.api.models.channel.Channel interactions.api.models.channel.Tags #: interactions.api.models.channel.ThreadMember #: interactions.api.models.channel.ThreadMetadata of msgid "Variables" @@ -183,33 +188,64 @@ msgid "The amount of members in the channel." msgstr "" #: interactions.api.models.channel.Channel:29 of -msgid "The thread metadata of the channel." +msgid "Boolean representing if a thread is created." msgstr "" #: interactions.api.models.channel.Channel:30 of -msgid "The member of the thread in the channel." +msgid "The thread metadata of the channel." msgstr "" #: interactions.api.models.channel.Channel:31 of +msgid "The member of the thread in the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:32 of msgid "" "The set auto-archive time for all threads to naturally follow in the " "channel." msgstr "" -#: interactions.api.models.channel.Channel:32 of +#: interactions.api.models.channel.Channel:33 of msgid "The permissions of the channel." msgstr "" -#: interactions.api.models.channel.Channel.mention:1 of -msgid "Returns a string that allows you to mention the given channel." +#: interactions.api.models.channel.Channel:34 of +msgid "The flags of the channel." +msgstr "" + +#: interactions.api.models.channel.Channel:35 of +msgid "Number of messages ever sent in a thread." +msgstr "" + +#: interactions.api.models.channel.Channel:36 of +msgid "" +"The default slowmode delay in seconds for threads, if this channel is a " +"forum." +msgstr "" + +#: interactions.api.models.channel.Channel:37 of +msgid "Tags in a forum channel, if any." +msgstr "" + +#: interactions.api.models.channel.Channel:38 of +msgid "Default reaction emoji for threads created in a forum, if any." +msgstr "" + +#: interactions.api.models.channel.Channel.typing:1 of +msgid "Manages the typing of the channel. Use with `await` or `async with`" msgstr "" #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.lock #: interactions.api.models.channel.Channel.mention #: interactions.api.models.channel.Channel.modify @@ -224,24 +260,33 @@ msgstr "" #: interactions.api.models.channel.Channel.set_position #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic -#: interactions.api.models.channel.Channel.set_user_limit of +#: interactions.api.models.channel.Channel.set_user_limit +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Tags.edit of msgid "Returns" msgstr "" -#: interactions.api.models.channel.Channel.mention:3 of -msgid "The string of the mentioned channel." +#: interactions.api.models.channel.Channel.typing:3 of +msgid "A manager for typing" msgstr "" +#: interactions.api.models.channel.AsyncHistoryIterator.flatten #: interactions.api.models.channel.Channel.add_member #: interactions.api.models.channel.Channel.archive +#: interactions.api.models.channel.Channel.create_forum_post #: interactions.api.models.channel.Channel.create_invite +#: interactions.api.models.channel.Channel.create_tag #: interactions.api.models.channel.Channel.create_thread #: interactions.api.models.channel.Channel.delete +#: interactions.api.models.channel.Channel.delete_tag +#: interactions.api.models.channel.Channel.edit_tag #: interactions.api.models.channel.Channel.get_history #: interactions.api.models.channel.Channel.get_members #: interactions.api.models.channel.Channel.get_message +#: interactions.api.models.channel.Channel.get_permissions_for #: interactions.api.models.channel.Channel.get_pinned_messages #: interactions.api.models.channel.Channel.get_webhooks +#: interactions.api.models.channel.Channel.history #: interactions.api.models.channel.Channel.join #: interactions.api.models.channel.Channel.leave #: interactions.api.models.channel.Channel.lock @@ -261,10 +306,44 @@ msgstr "" #: interactions.api.models.channel.Channel.set_rate_limit_per_user #: interactions.api.models.channel.Channel.set_topic #: interactions.api.models.channel.Channel.set_user_limit -#: interactions.api.models.channel.Channel.unpin_message of +#: interactions.api.models.channel.Channel.typing +#: interactions.api.models.channel.Channel.unpin_message +#: interactions.api.models.channel.Tags.delete +#: interactions.api.models.channel.Tags.edit of msgid "Return type" msgstr "" +#: interactions.api.models.channel.Channel.mention:1 of +msgid "Returns a string that allows you to mention the given channel." +msgstr "" + +#: interactions.api.models.channel.Channel.mention:3 of +msgid "The string of the mentioned channel." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:7 +#: interactions.api.models.channel.Channel.history:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:9 +#: interactions.api.models.channel.Channel.history:3 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:13 +#: interactions.api.models.channel.Channel.history:5 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.channel.Channel.history:7 of +msgid "A custom check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.Channel.history:10 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" + #: interactions.api.models.channel.Channel.send:1 of msgid "Sends a message in the channel." msgstr "" @@ -292,7 +371,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.channel.Channel.send:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.channel.Channel.send:15 of @@ -625,10 +704,12 @@ msgstr "" msgid "Creates a thread in the Channel." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:3 #: interactions.api.models.channel.Channel.create_thread:3 of msgid "The name of the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:5 #: interactions.api.models.channel.Channel.create_thread:5 of msgid "" "duration in minutes to automatically archive the thread after recent " @@ -649,6 +730,7 @@ msgstr "" msgid "An optional message to create a thread from." msgstr "" +#: interactions.api.models.channel.Channel.create_forum_post:16 #: interactions.api.models.channel.Channel.create_thread:14 of msgid "An optional reason for the audit log" msgstr "" @@ -734,6 +816,109 @@ msgstr "" msgid "Add the bot to the thread" msgstr "" +#: interactions.api.models.channel.Channel.create_tag:1 of +msgid "Create a new tag." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:4 +#: interactions.api.models.channel.Channel.edit_tag:4 +#: interactions.api.models.channel.Tags.edit:4 of +msgid "" +"Can either have an emoji_id or an emoji_name, but not both. emoji_id is " +"meant for custom emojis, emoji_name is meant for unicode emojis." +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:7 of +msgid "The name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:9 +#: interactions.api.models.channel.Channel.edit_tag:11 +#: interactions.api.models.channel.Tags.edit:11 of +msgid "The ID of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:11 +#: interactions.api.models.channel.Channel.edit_tag:13 +#: interactions.api.models.channel.Tags.edit:13 of +msgid "The name of the emoji to use for the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_tag:13 of +msgid "The create tag object" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:1 of +msgid "Edits a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:7 of +msgid "The ID of the tag to edit" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:9 +#: interactions.api.models.channel.Tags.edit:9 of +msgid "The new name of the tag" +msgstr "" + +#: interactions.api.models.channel.Channel.edit_tag:15 +#: interactions.api.models.channel.Tags.edit:15 of +msgid "The modified tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:1 of +msgid "Deletes a tag" +msgstr "" + +#: interactions.api.models.channel.Channel.delete_tag:3 of +msgid "The ID of the Tag" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:1 of +msgid "Creates a new post inside a forum channel" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:8 of +msgid "The content to send as first message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:10 of +msgid "Tags to give to the created thread" +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:12 of +msgid "An optional list of files to send attached to the message." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:14 of +msgid "" +"Seconds a user has to wait before sending another message (0 to 21600), " +"if given." +msgstr "" + +#: interactions.api.models.channel.Channel.create_forum_post:18 of +msgid "A channel of ChannelType 11 (THREAD)" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:1 of +msgid "Returns the permissions of the member in this specific channel." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:4 of +msgid "" +"The permissions returned by this function take into account role and user" +" overwrites that can be assigned to channels or categories. If you don't " +"need these overwrites, look into :meth:`.Member.get_guild_permissions`." +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:8 of +msgid "The member to get the permissions from" +msgstr "" + +#: interactions.api.models.channel.Channel.get_permissions_for:10 of +msgid "Permissions of the member in this channel" +msgstr "" + #: interactions.api.models.channel.ThreadMember:1 of msgid "A class object representing a member in a thread." msgstr "" @@ -793,3 +978,83 @@ msgstr "" #: interactions.api.models.channel.ThreadMetadata:11 of msgid "The ability to invite users to the thread." msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:3 +#: interactions.api.models.channel.AsyncTypingContextManager:5 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator:11 of +msgid "A check to ignore certain messages" +msgstr "" + +#: interactions.api.models.channel.AsyncHistoryIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:1 of +msgid "An async context manager for triggering typing." +msgstr "" + +#: interactions.api.models.channel.AsyncTypingContextManager:3 of +msgid "The channel to trigger typing in." +msgstr "" + +#: interactions.api.models.channel.Tags:1 of +msgid "An object denoting a tag object within a forum channel." +msgstr "" + +#: interactions.api.models.channel.Tags:4 of +msgid "If the emoji is custom, it won't have name information." +msgstr "" + +#: interactions.api.models.channel.Tags:6 of +msgid "Name of the tag. The limit is up to 20 characters." +msgstr "" + +#: interactions.api.models.channel.Tags:7 of +msgid "ID of the tag. Can also be 0 if manually created." +msgstr "" + +#: interactions.api.models.channel.Tags:8 of +msgid "" +"A boolean denoting whether this tag can be removed/added by moderators " +"with ``manage_threads`` permissions." +msgstr "" + +#: interactions.api.models.channel.Tags:9 of +msgid "The emoji to represent the tag, if any." +msgstr "" + +#: interactions.api.models.channel.Tags.delete:1 of +msgid "Deletes this tag" +msgstr "" + +#: interactions.api.models.channel.Tags.delete:3 +#: interactions.api.models.channel.Tags.edit:7 of +msgid "The ID of the channel where the tag belongs to" +msgstr "" + +#: interactions.api.models.channel.Tags.edit:1 of +msgid "Edits this tag" +msgstr "" + +#~ msgid "An object representing a thread." +#~ msgstr "" + +#~ msgid "" +#~ "This is a derivation of the base" +#~ " Channel, since a thread can be " +#~ "its own event." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.models.emoji.po b/docs/locale/ru/LC_MESSAGES/api.models.emoji.po new file mode 100644 index 000000000..2809ce66e --- /dev/null +++ b/docs/locale/ru/LC_MESSAGES/api.models.emoji.po @@ -0,0 +1,139 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-29 13:24-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../api.models.emoji.rst:4 +msgid "Emoji Models" +msgstr "" + +#: interactions.api.models.emoji.Emoji:1 of +msgid "A class objecting representing an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji of +msgid "Variables" +msgstr "" + +#: interactions.api.models.emoji.Emoji:3 of +msgid "Emoji id" +msgstr "" + +#: interactions.api.models.emoji.Emoji:4 of +msgid "Emoji name." +msgstr "" + +#: interactions.api.models.emoji.Emoji:5 of +msgid "Roles allowed to use this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:6 of +msgid "User that created this emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji:7 of +msgid "Status denoting of this emoji must be wrapped in colons" +msgstr "" + +#: interactions.api.models.emoji.Emoji:8 of +msgid "Status denoting if this emoji is managed (by an integration)" +msgstr "" + +#: interactions.api.models.emoji.Emoji:9 of +msgid "Status denoting if this emoji is animated" +msgstr "" + +#: interactions.api.models.emoji.Emoji:10 of +msgid "" +"Status denoting if this emoji can be used. (Can be false via server " +"boosting)" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:1 of +msgid "Gets an emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild of +msgid "Parameters" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:3 of +msgid "The id of the guild of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:5 of +msgid "The id of the emoji" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:7 +#: interactions.api.models.emoji.Emoji.get_all_of_guild:5 of +msgid "The HTTPClient of your bot. Equals to ``bot._http``" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Returns" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get:9 of +msgid "The Emoji as object" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get +#: interactions.api.models.emoji.Emoji.get_all_of_guild +#: interactions.api.models.emoji.Emoji.url of +msgid "Return type" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:1 of +msgid "Gets all emoji of a guild." +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:3 of +msgid "The id of the guild to get the emojis of" +msgstr "" + +#: interactions.api.models.emoji.Emoji.get_all_of_guild:7 of +msgid "The Emoji as list" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:1 of +msgid "Deletes the emoji." +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:3 of +msgid "The guild id to delete the emoji from" +msgstr "" + +#: interactions.api.models.emoji.Emoji.delete:5 of +msgid "The reason of the deletion" +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:1 of +msgid "Returns the emoji's URL." +msgstr "" + +#: interactions.api.models.emoji.Emoji.url:3 of +msgid "URL of the emoji" +msgstr "" + +#~ msgid "Audit-Log Models" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.models.guild.po b/docs/locale/ru/LC_MESSAGES/api.models.guild.po index a233b694b..6a195d3a5 100644 --- a/docs/locale/ru/LC_MESSAGES/api.models.guild.po +++ b/docs/locale/ru/LC_MESSAGES/api.models.guild.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:25-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.guild.rst:4 msgid "Guild Models" @@ -85,6 +85,7 @@ msgstr "" msgid "The location of the event, if any." msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator #: interactions.api.models.guild.EventMetadata #: interactions.api.models.guild.Guild #: interactions.api.models.guild.Guild.add_member_role @@ -95,17 +96,25 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji #: interactions.api.models.guild.Guild.delete_role #: interactions.api.models.guild.Guild.delete_scheduled_event +#: interactions.api.models.guild.Guild.delete_sticker +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule @@ -115,6 +124,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -672,13 +683,26 @@ msgid "The id of the member to ban" msgstr "" #: interactions.api.models.guild.Guild.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.guild.Guild.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.guild.Guild.ban:13 of +msgid "The reason of the ban" msgstr "" +#: interactions.api.models.guild.AsyncMembersIterator.flatten #: interactions.api.models.guild.Guild.add_member_role #: interactions.api.models.guild.Guild.ban #: interactions.api.models.guild.Guild.clone_channel @@ -687,6 +711,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_emoji #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.delete_channel #: interactions.api.models.guild.Guild.delete_emoji @@ -698,13 +723,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.kick #: interactions.api.models.guild.Guild.leave #: interactions.api.models.guild.Guild.list_auto_moderation_rules @@ -716,6 +749,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.remove_ban #: interactions.api.models.guild.Guild.remove_member_role #: interactions.api.models.guild.Guild.search_members @@ -840,6 +875,7 @@ msgstr "" #: interactions.api.models.guild.Guild.create_channel #: interactions.api.models.guild.Guild.create_role #: interactions.api.models.guild.Guild.create_scheduled_event +#: interactions.api.models.guild.Guild.create_sticker #: interactions.api.models.guild.Guild.create_thread #: interactions.api.models.guild.Guild.get_all_active_threads #: interactions.api.models.guild.Guild.get_all_bans @@ -847,13 +883,21 @@ msgstr "" #: interactions.api.models.guild.Guild.get_all_emoji #: interactions.api.models.guild.Guild.get_all_members #: interactions.api.models.guild.Guild.get_all_roles +#: interactions.api.models.guild.Guild.get_audit_logs #: interactions.api.models.guild.Guild.get_auto_moderation_rule #: interactions.api.models.guild.Guild.get_bans #: interactions.api.models.guild.Guild.get_emoji +#: interactions.api.models.guild.Guild.get_full_audit_logs +#: interactions.api.models.guild.Guild.get_latest_audit_log_action #: interactions.api.models.guild.Guild.get_list_of_members #: interactions.api.models.guild.Guild.get_member +#: interactions.api.models.guild.Guild.get_members +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs #: interactions.api.models.guild.Guild.get_preview +#: interactions.api.models.guild.Guild.get_prune_count #: interactions.api.models.guild.Guild.get_role +#: interactions.api.models.guild.Guild.get_scheduled_events +#: interactions.api.models.guild.Guild.get_stickers #: interactions.api.models.guild.Guild.modify #: interactions.api.models.guild.Guild.modify_auto_moderation_rule #: interactions.api.models.guild.Guild.modify_channel @@ -862,6 +906,8 @@ msgstr "" #: interactions.api.models.guild.Guild.modify_role_position #: interactions.api.models.guild.Guild.modify_role_positions #: interactions.api.models.guild.Guild.modify_scheduled_event +#: interactions.api.models.guild.Guild.modify_sticker +#: interactions.api.models.guild.Guild.prune #: interactions.api.models.guild.Guild.search_members of msgid "Returns" msgstr "" @@ -1508,6 +1554,20 @@ msgstr "" msgid "The created event" msgstr "" +#: interactions.api.models.guild.Guild.get_scheduled_events:1 of +msgid "Gets all scheduled events of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:3 of +msgid "" +"A boolean to include number of users subscribed to the associated event, " +"if given." +msgstr "" + +#: interactions.api.models.guild.Guild.get_scheduled_events:5 of +msgid "The sheduled events of the guild." +msgstr "" + #: interactions.api.models.guild.Guild.modify_scheduled_event:1 of msgid "Edits a scheduled event of the guild." msgstr "" @@ -1614,6 +1674,40 @@ msgstr "" msgid "Gets all bans of the guild." msgstr "" +#: interactions.api.models.guild.Guild.prune:1 of +msgid "Begins a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:3 +#: interactions.api.models.guild.Guild.prune:3 of +msgid "Number of days to count, minimum 1, maximum 30. Defaults to 7." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:4 of +msgid "" +"Whether the returned \"pruned\" dict contains the computed prune count or" +" None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:4 +#: interactions.api.models.guild.Guild.prune:5 of +msgid "Role IDs to include, if given." +msgstr "" + +#: interactions.api.models.guild.Guild.prune:6 of +msgid "" +"The number of pruned members, if compute_prune_count is not false. " +"Otherwise returns None." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:1 of +msgid "Returns the number of members that would be removed in a prune operation." +msgstr "" + +#: interactions.api.models.guild.Guild.get_prune_count:5 of +msgid "The number of members that would be pruned." +msgstr "" + #: interactions.api.models.guild.Guild.get_emoji:1 of msgid "Gets an emoji of the guild and returns it." msgstr "" @@ -1664,6 +1758,77 @@ msgstr "" msgid "The emoji or the id of the emoji to delete" msgstr "" +#: interactions.api.models.guild.Guild.get_stickers:1 of +msgid "Get the stickers for a guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_stickers:3 of +msgid "List of stickers of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:1 of +msgid "Gets the list of sticker packs available to Nitro subscribers." +msgstr "" + +#: interactions.api.models.guild.Guild.get_nitro_sticker_packs:3 of +msgid "List of sticker packs." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:1 of +msgid "Creates a new sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:3 of +msgid "The file of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:5 of +msgid "The tags of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:7 +#: interactions.api.models.guild.Guild.modify_sticker:5 of +msgid "The name of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:9 +#: interactions.api.models.guild.Guild.modify_sticker:7 of +msgid "The description of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:11 of +msgid "The reason of the creation." +msgstr "" + +#: interactions.api.models.guild.Guild.create_sticker:13 of +msgid "Created sticker for the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:1 of +msgid "Modifies the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:3 +#: interactions.api.models.guild.Guild.modify_sticker:3 of +msgid "The sticker or ID of the sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:9 of +msgid "The reason of the modification." +msgstr "" + +#: interactions.api.models.guild.Guild.modify_sticker:11 of +msgid "Modified sticker." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:1 of +msgid "Deletes the sticker of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.delete_sticker:5 of +msgid "The reason of the deletion." +msgstr "" + #: interactions.api.models.guild.Guild.get_list_of_members:1 of msgid "Lists the members of a guild." msgstr "" @@ -1710,6 +1875,23 @@ msgstr "" msgid "Returns a list of all members of the guild" msgstr "" +#: interactions.api.models.guild.Guild.get_members:1 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:11 +#: interactions.api.models.guild.Guild.get_members:3 of +msgid "A set maximum of members to get before stopping the iteration" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:5 of +msgid "A custom check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.Guild.get_members:8 of +msgid "An asynchronous iterator over the members of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.list_auto_moderation_rules:1 of msgid "Lists all AutoMod rules" msgstr "" @@ -1784,6 +1966,55 @@ msgstr "" msgid "The rule to modify" msgstr "" +#: interactions.api.models.guild.Guild.get_audit_logs:1 of +msgid "Gets the audit logs of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:3 of +msgid "How many entries to get, default 100" +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:5 +#: interactions.api.models.guild.Guild.get_full_audit_logs:3 of +msgid "User ID snowflake. filter the log for actions made by a user." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:7 of +msgid "The Type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:9 of +msgid "filter the log before a certain entry id." +msgstr "" + +#: interactions.api.models.guild.Guild.get_audit_logs:11 of +msgid "The guild audit logs" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:1 of +msgid "Gets the latest audit log action of either a user or an action type" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:3 of +msgid "The user, user id or action type to look for" +msgstr "" + +#: interactions.api.models.guild.Guild.get_latest_audit_log_action:5 of +msgid "The latest AuditLog action that applies to the ``of`` parameter" +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:1 of +msgid "Gets the full audit log of the guild." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:5 of +msgid "The type of the audit log action." +msgstr "" + +#: interactions.api.models.guild.Guild.get_full_audit_logs:7 of +msgid "The full AuditLog of the guild" +msgstr "" + #: interactions.api.models.guild.Guild.icon_url:1 of msgid "" "Returns the URL of the guild's icon. :return: URL of the guild's icon " @@ -1897,3 +2128,32 @@ msgstr "" #: interactions.api.models.guild.Invite.delete:1 of msgid "Deletes the invite" msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:1 of +msgid "A class object that allows iterating through a channel's history." +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:3 of +msgid "The HTTPClient of the bot" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:5 of +msgid "The guild to get the members from" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:7 of +msgid "" +"The member ID to start getting members from (gets all members after that " +"member)" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator:9 of +msgid "A check to ignore certain members" +msgstr "" + +#: interactions.api.models.guild.AsyncMembersIterator.flatten:1 of +msgid "returns all remaining items as list" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.models.gw.po b/docs/locale/ru/LC_MESSAGES/api.models.gw.po index fe823c232..88a920629 100644 --- a/docs/locale/ru/LC_MESSAGES/api.models.gw.po +++ b/docs/locale/ru/LC_MESSAGES/api.models.gw.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.gw.rst:4 msgid "Gateway-specific Event Models" @@ -42,10 +42,10 @@ msgstr "" #: interactions.api.models.gw.GuildScheduledEventUser #: interactions.api.models.gw.GuildStickers #: interactions.api.models.gw.Integration +#: interactions.api.models.gw.MessageDelete #: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList +#: interactions.api.models.gw.MessageReactionRemove +#: interactions.api.models.gw.Presence interactions.api.models.gw.ThreadList #: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks #: of msgid "Variables" @@ -93,36 +93,6 @@ msgstr "" msgid "The substring in content that triggered rule." msgstr "" -#: interactions.api.models.gw.ApplicationCommandPermissions -#: interactions.api.models.gw.AutoModerationAction -#: interactions.api.models.gw.AutoModerationRule -#: interactions.api.models.gw.ChannelPins -#: interactions.api.models.gw.EmbeddedActivity -#: interactions.api.models.gw.GuildBan interactions.api.models.gw.GuildEmojis -#: interactions.api.models.gw.GuildIntegrations -#: interactions.api.models.gw.GuildJoinRequest -#: interactions.api.models.gw.GuildMember -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send -#: interactions.api.models.gw.GuildMembers interactions.api.models.gw.GuildRole -#: interactions.api.models.gw.GuildScheduledEvent -#: interactions.api.models.gw.GuildScheduledEventUser -#: interactions.api.models.gw.GuildStickers -#: interactions.api.models.gw.Integration -#: interactions.api.models.gw.MessageReaction -#: interactions.api.models.gw.Presence -#: interactions.api.models.gw.ReactionRemove -#: interactions.api.models.gw.ThreadList -#: interactions.api.models.gw.ThreadMembers interactions.api.models.gw.Webhooks -#: of -msgid "Parameters" -msgstr "" - #: interactions.api.models.gw.AutoModerationRule:1 of msgid "" "A class object representing the gateway events " @@ -232,14 +202,14 @@ msgstr "" #: interactions.api.models.gw.GuildEmojis:3 #: interactions.api.models.gw.GuildIntegrations:3 #: interactions.api.models.gw.GuildJoinRequest:7 -#: interactions.api.models.gw.GuildMember:3 #: interactions.api.models.gw.GuildMembers:3 #: interactions.api.models.gw.GuildRole:3 #: interactions.api.models.gw.GuildStickers:3 #: interactions.api.models.gw.Integration:23 +#: interactions.api.models.gw.MessageDelete:5 #: interactions.api.models.gw.MessageReaction:6 +#: interactions.api.models.gw.MessageReactionRemove:10 #: interactions.api.models.gw.Presence:4 -#: interactions.api.models.gw.ReactionRemove:10 #: interactions.api.models.gw.ThreadList:3 #: interactions.api.models.gw.ThreadMembers:4 of msgid "The guild ID of the event." @@ -251,8 +221,9 @@ msgstr "" #: interactions.api.models.gw.ChannelPins:4 #: interactions.api.models.gw.EmbeddedActivity:9 +#: interactions.api.models.gw.MessageDelete:4 #: interactions.api.models.gw.MessageReaction:4 -#: interactions.api.models.gw.ReactionRemove:8 of +#: interactions.api.models.gw.MessageReactionRemove:8 of msgid "The channel ID of the event." msgstr "" @@ -312,7 +283,6 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildBan:4 -#: interactions.api.models.gw.GuildMember:5 #: interactions.api.models.gw.Integration:17 #: interactions.api.models.gw.Presence:3 of msgid "The user of the event." @@ -378,14 +348,21 @@ msgstr "" msgid "The members of the thread of the event." msgstr "" -#: interactions.api.models.gw.ReactionRemove:1 of +#: interactions.api.models.gw.MessageDelete:1 of +msgid "A class object representing the gateway event ``MESSAGE_DELETE_BULK``." +msgstr "" + +#: interactions.api.models.gw.MessageDelete:3 of +msgid "The message IDs of the event." +msgstr "" + +#: interactions.api.models.gw.MessageReactionRemove:1 of msgid "" "A class object representing the gateway events " -"``MESSAGE_REACTION_REMOVE``, ``MESSAGE_REACTION_REMOVE_ALL`` and " -"``MESSAGE_REACTION_REMOVE_EMOJI``." +"``MESSAGE_REACTION_REMOVE_ALL`` and ``MESSAGE_REACTION_REMOVE_EMOJI``." msgstr "" -#: interactions.api.models.gw.ReactionRemove:4 of +#: interactions.api.models.gw.MessageReactionRemove:4 of msgid "" "This class inherits the already existing attributes of " ":class:`interactions.api.models.gw.Reaction`. The main missing attribute " @@ -394,22 +371,24 @@ msgstr "" #: interactions.api.models.gw.GuildJoinRequest:6 #: interactions.api.models.gw.MessageReaction:3 -#: interactions.api.models.gw.ReactionRemove:7 of +#: interactions.api.models.gw.MessageReactionRemove:7 of msgid "The user ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:5 -#: interactions.api.models.gw.ReactionRemove:9 of +#: interactions.api.models.gw.MessageReactionRemove:9 of msgid "The message ID of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:8 -#: interactions.api.models.gw.ReactionRemove:11 of +#: interactions.api.models.gw.MessageReactionRemove:11 of msgid "The emoji of the event." msgstr "" #: interactions.api.models.gw.MessageReaction:1 of -msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +msgid "" +"A class object representing the gateway event ``MESSAGE_REACTION_ADD`` " +"and ``MESSAGE_REACTION_REMOVE``." msgstr "" #: interactions.api.models.gw.MessageReaction:7 of @@ -473,204 +452,58 @@ msgid "" msgstr "" #: interactions.api.models.gw.GuildMember:4 of -msgid "The roles of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:6 of -msgid "The nickname of the user of the event." -msgstr "" - -#: interactions.api.models.gw.GuildMember:7 of -msgid "The avatar URL of the user of the event." +msgid "" +"``pending`` and ``permissions`` only apply for members retroactively " +"requiring to verify rules via. membership screening or lack permissions " +"to speak." msgstr "" #: interactions.api.models.gw.GuildMember:8 of -msgid "The time that the user of the event joined at." +msgid "The guild ID." msgstr "" #: interactions.api.models.gw.GuildMember:9 of -msgid "The time that the user of the event has since had \"premium.\"" +msgid "The user of the guild." msgstr "" #: interactions.api.models.gw.GuildMember:10 of -msgid "Whether the member of the event is deafened or not." +msgid "The nickname of the member." msgstr "" #: interactions.api.models.gw.GuildMember:11 of -msgid "Whether the member of the event is muted or not." +msgid "The hash containing the user's guild avatar, if applicable." msgstr "" #: interactions.api.models.gw.GuildMember:12 of -msgid "" -"Whether the member of the event is still pending -- pass membership " -"screening -- or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:1 of -msgid "Returns the ID of the user." -msgstr "" - -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.send of -msgid "Returns" -msgstr "" - -#: interactions.api.models.gw.GuildMember.id:3 of -msgid "The ID of the user" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role -#: interactions.api.models.gw.GuildMember.add_to_thread -#: interactions.api.models.gw.GuildMember.ban -#: interactions.api.models.gw.GuildMember.id -#: interactions.api.models.gw.GuildMember.kick -#: interactions.api.models.gw.GuildMember.mention -#: interactions.api.models.gw.GuildMember.modify -#: interactions.api.models.gw.GuildMember.name -#: interactions.api.models.gw.GuildMember.remove_role -#: interactions.api.models.gw.GuildMember.send of -msgid "Return type" -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:1 of -msgid "Returns the string of either the user's nickname or username." -msgstr "" - -#: interactions.api.models.gw.GuildMember.name:3 of -msgid "The name of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:1 of -msgid "Returns a string that allows you to mention the given member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.mention:3 of -msgid "The string of the mentioned member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:1 of -msgid "Bans the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:3 of -msgid "The reason of the ban" -msgstr "" - -#: interactions.api.models.gw.GuildMember.ban:5 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:1 of -msgid "Kicks the member from a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.kick:3 of -msgid "The reason for the kick" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:1 of -msgid "This method adds a role to a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:3 of -msgid "The role to add. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_role:5 of -msgid "The reason why the roles are added" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:1 of -msgid "This method removes a role from a member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:3 of -msgid "The role to remove. Either ``Role`` object or role_id" -msgstr "" - -#: interactions.api.models.gw.GuildMember.remove_role:5 of -msgid "The reason why the roles are removed" -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:1 of -msgid "Sends a DM to the member." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:3 of -msgid "The contents of the message as a string or string-converted value." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:5 of -msgid "A component, or list of components for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:7 of -msgid "Whether the message utilizes the text-to-speech Discord programme or not." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:9 of -msgid "A file or list of files to be attached to the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:11 of -msgid "An embed, or list of embeds for the message." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:13 of -msgid "The message interactions/mention limits that the message can refer to." -msgstr "" - -#: interactions.api.models.gw.GuildMember.send:15 of -msgid "The sent message as an object." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:1 of -msgid "Modifies the member of a guild." -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:3 of -msgid "The nickname of the member" -msgstr "" - -#: interactions.api.models.gw.GuildMember.modify:5 of -msgid "A list of all role ids the member has" +msgid "The list of roles of the member." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:7 of -msgid "whether the user is muted in voice channels" +#: interactions.api.models.gw.GuildMember:13 of +msgid "The timestamp the member joined the guild at." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:9 of -msgid "whether the user is deafened in voice channels" +#: interactions.api.models.gw.GuildMember:14 of +msgid "The timestamp the member has been a server booster since." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:11 of -msgid "id of channel to move user to (if they are connected to voice)" +#: interactions.api.models.gw.GuildMember:15 of +msgid "Whether the member is deafened." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:13 of -msgid "" -"when the user's timeout will expire and the user will be able to " -"communicate in the guild again (up to 28 days in the future)" +#: interactions.api.models.gw.GuildMember:16 of +msgid "Whether the member is muted." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:15 of -msgid "The reason of the modifying" +#: interactions.api.models.gw.GuildMember:17 of +msgid "Whether the member is pending to pass membership screening." msgstr "" -#: interactions.api.models.gw.GuildMember.modify:17 of -msgid "The modified member object" +#: interactions.api.models.gw.GuildMember:18 of +msgid "Whether the member has permissions." msgstr "" -#: interactions.api.models.gw.GuildMember.add_to_thread:1 of -msgid "Adds the member to a thread." -msgstr "" - -#: interactions.api.models.gw.GuildMember.add_to_thread:3 of -msgid "The id of the thread to add the member to" +#: interactions.api.models.gw.GuildMember:19 of +msgid "How long until they're unmuted, if any." msgstr "" #: interactions.api.models.gw.GuildStickers:1 of @@ -823,3 +656,164 @@ msgstr "" #: interactions.api.models.gw.GuildRole:5 of msgid "The role ID of the event." msgstr "" + +#~ msgid "" +#~ "A class object representing the gateway" +#~ " events ``MESSAGE_REACTION_REMOVE``, " +#~ "``MESSAGE_REACTION_REMOVE_ALL`` and " +#~ "``MESSAGE_REACTION_REMOVE_EMOJI``." +#~ msgstr "" + +#~ msgid "A class object representing the gateway event ``MESSAGE_REACTION_ADD``." +#~ msgstr "" + +#~ msgid "The roles of the event." +#~ msgstr "" + +#~ msgid "The nickname of the user of the event." +#~ msgstr "" + +#~ msgid "The avatar URL of the user of the event." +#~ msgstr "" + +#~ msgid "The time that the user of the event joined at." +#~ msgstr "" + +#~ msgid "The time that the user of the event has since had \"premium.\"" +#~ msgstr "" + +#~ msgid "Whether the member of the event is deafened or not." +#~ msgstr "" + +#~ msgid "Whether the member of the event is muted or not." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the member of the event is" +#~ " still pending -- pass membership " +#~ "screening -- or not." +#~ msgstr "" + +#~ msgid "Returns the ID of the user." +#~ msgstr "" + +#~ msgid "Returns" +#~ msgstr "" + +#~ msgid "The ID of the user" +#~ msgstr "" + +#~ msgid "Return type" +#~ msgstr "" + +#~ msgid "Returns the string of either the user's nickname or username." +#~ msgstr "" + +#~ msgid "The name of the member" +#~ msgstr "" + +#~ msgid "Returns a string that allows you to mention the given member." +#~ msgstr "" + +#~ msgid "The string of the mentioned member." +#~ msgstr "" + +#~ msgid "Bans the member from a guild." +#~ msgstr "" + +#~ msgid "The reason of the ban" +#~ msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "Kicks the member from a guild." +#~ msgstr "" + +#~ msgid "The reason for the kick" +#~ msgstr "" + +#~ msgid "This method adds a role to a member." +#~ msgstr "" + +#~ msgid "The role to add. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are added" +#~ msgstr "" + +#~ msgid "This method removes a role from a member." +#~ msgstr "" + +#~ msgid "The role to remove. Either ``Role`` object or role_id" +#~ msgstr "" + +#~ msgid "The reason why the roles are removed" +#~ msgstr "" + +#~ msgid "Sends a DM to the member." +#~ msgstr "" + +#~ msgid "The contents of the message as a string or string-converted value." +#~ msgstr "" + +#~ msgid "A component, or list of components for the message." +#~ msgstr "" + +#~ msgid "" +#~ "Whether the message utilizes the " +#~ "text-to-speech Discord programme or " +#~ "not." +#~ msgstr "" + +#~ msgid "A file or list of files to be attached to the message." +#~ msgstr "" + +#~ msgid "An embed, or list of embeds for the message." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The sent message as an object." +#~ msgstr "" + +#~ msgid "Modifies the member of a guild." +#~ msgstr "" + +#~ msgid "The nickname of the member" +#~ msgstr "" + +#~ msgid "A list of all role ids the member has" +#~ msgstr "" + +#~ msgid "whether the user is muted in voice channels" +#~ msgstr "" + +#~ msgid "whether the user is deafened in voice channels" +#~ msgstr "" + +#~ msgid "id of channel to move user to (if they are connected to voice)" +#~ msgstr "" + +#~ msgid "" +#~ "when the user's timeout will expire " +#~ "and the user will be able to " +#~ "communicate in the guild again (up " +#~ "to 28 days in the future)" +#~ msgstr "" + +#~ msgid "The reason of the modifying" +#~ msgstr "" + +#~ msgid "The modified member object" +#~ msgstr "" + +#~ msgid "Adds the member to a thread." +#~ msgstr "" + +#~ msgid "The id of the thread to add the member to" +#~ msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.models.member.po b/docs/locale/ru/LC_MESSAGES/api.models.member.po index ce23f99ac..f5839f391 100644 --- a/docs/locale/ru/LC_MESSAGES/api.models.member.po +++ b/docs/locale/ru/LC_MESSAGES/api.models.member.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.member.rst:4 msgid "Member Models" @@ -86,6 +86,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.modify #: interactions.api.models.member.Member.remove_role @@ -93,10 +95,20 @@ msgstr "" msgid "Parameters" msgstr "" +#: interactions.api.models.member.Member.guild_id:1 of +msgid "" +"Attempts to get the guild ID the member is in. Only works then roles or " +"nick or joined at is present. :return: The ID of the guild this member " +"belongs to." +msgstr "" + #: interactions.api.models.member.Member.id:1 of msgid "Returns the ID of the user." msgstr "" +#: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.mention #: interactions.api.models.member.Member.modify @@ -113,6 +125,8 @@ msgstr "" #: interactions.api.models.member.Member.add_to_thread #: interactions.api.models.member.Member.ban #: interactions.api.models.member.Member.get_avatar_url +#: interactions.api.models.member.Member.get_guild_permissions +#: interactions.api.models.member.Member.has_permissions #: interactions.api.models.member.Member.id #: interactions.api.models.member.Member.kick #: interactions.api.models.member.Member.mention @@ -148,11 +162,23 @@ msgid "The id of the guild to ban the member from" msgstr "" #: interactions.api.models.member.Member.ban:5 of -msgid "The reason of the ban" +msgid "Number of seconds to delete messages, from 0 to 604800. Defaults to 0" msgstr "" #: interactions.api.models.member.Member.ban:7 of -msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +msgid "Number of minutes to delete messages, from 0 to 10080" +msgstr "" + +#: interactions.api.models.member.Member.ban:9 of +msgid "Number of hours to delete messages, from 0 to 168" +msgstr "" + +#: interactions.api.models.member.Member.ban:11 of +msgid "Number of days to delete messages, from 0 to 7" +msgstr "" + +#: interactions.api.models.member.Member.ban:13 of +msgid "The reason of the ban" msgstr "" #: interactions.api.models.member.Member.kick:1 of @@ -230,7 +256,7 @@ msgid "An embed, or list of embeds for the message." msgstr "" #: interactions.api.models.member.Member.send:15 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.member.Member.send:17 of @@ -288,9 +314,83 @@ msgid "The id of the thread to add the member to" msgstr "" #: interactions.api.models.member.Member.get_avatar_url:1 of +msgid "Returns the URL of the member's avatar for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:3 of +msgid "The id of the guild to get the member's avatar from" +msgstr "" + +#: interactions.api.models.member.Member.get_avatar_url:5 of +msgid "URL of the members's avatar (None will be returned if no avatar is set)" +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:1 of +msgid "Returns the permissions of the member for the specified guild." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:4 of msgid "" -"Returns the URL of the member's avatar for the specified guild. :param " -"guild_id: The id of the guild to get the member's avatar from :type " -"guild_id: Union[int, Snowflake, \"Guild\"] :return: URL of the members's " -"avatar (None will be returned if no avatar is set) :rtype: str" +"The permissions returned by this function will not take into account role" +" and user overwrites that can be assigned to channels or categories. If " +"you need these overwrites, look into " +":meth:`.Channel.get_permissions_for`." +msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:8 of +msgid "The guild of the member" msgstr "" + +#: interactions.api.models.member.Member.get_guild_permissions:10 of +msgid "Base permissions of the member in the specified guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:1 of +msgid "Returns whether the member has the permissions passed." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:4 of +msgid "" +"If the channel argument is present, the function will look if the member " +"has the permissions in the specified channel. If the argument is missing," +" then it will only consider the member's guild permissions." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:7 of +msgid "The list of permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:9 of +msgid "The channel where to check for permissions" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:11 of +msgid "The id of the guild" +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:13 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.api.models.member.Member.has_permissions:15 of +msgid "Whether the member has the permissions" +msgstr "" + +#~ msgid "Number of days to delete messages, from 0 to 7. Defaults to 0" +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "" +#~ "Returns the URL of the member's " +#~ "avatar for the specified guild. :param" +#~ " guild_id: The id of the guild " +#~ "to get the member's avatar from " +#~ ":type guild_id: Union[int, Snowflake, " +#~ "\"Guild\"] :return: URL of the members's" +#~ " avatar (None will be returned if " +#~ "no avatar is set) :rtype: str" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.models.message.po b/docs/locale/ru/LC_MESSAGES/api.models.message.po index 5bcd77f9c..e1f033a87 100644 --- a/docs/locale/ru/LC_MESSAGES/api.models.message.po +++ b/docs/locale/ru/LC_MESSAGES/api.models.message.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.message.rst:4 msgid "Message Models" @@ -50,14 +50,14 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji #: interactions.api.models.message.Message #: interactions.api.models.message.MessageActivity #: interactions.api.models.message.MessageInteraction #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Variables" msgstr "" @@ -156,33 +156,33 @@ msgid "" msgstr "" #: interactions.api.models.message.Message:26 of -msgid "The allowed mentions of roles attached in the message." -msgstr "" - -#: interactions.api.models.message.Message:27 of msgid "Message flags" msgstr "" -#: interactions.api.models.message.Message:28 of +#: interactions.api.models.message.Message:27 of msgid "Message interaction object, if the message is sent by an interaction." msgstr "" -#: interactions.api.models.message.Message:29 of +#: interactions.api.models.message.Message:28 of msgid "" "The thread that started from this message, if any, with a thread member " "object embedded." msgstr "" +#: interactions.api.models.message.Message:29 of +msgid "Array of Action Rows associated with this message, if any." +msgstr "" + #: interactions.api.models.message.Message:30 of -msgid "Components associated with this message, if any." +msgid "An array of message sticker item objects, if sent with them." msgstr "" #: interactions.api.models.message.Message:31 of -msgid "An array of message sticker item objects, if sent with them." +msgid "Array of sticker objects sent with the message if any. Deprecated." msgstr "" #: interactions.api.models.message.Message:32 of -msgid "Array of sticker objects sent with the message if any. Deprecated." +msgid "The approximate position of the message in a thread." msgstr "" #: interactions.api.models.message.Attachment @@ -202,10 +202,6 @@ msgstr "" #: interactions.api.models.message.EmbedFooter #: interactions.api.models.message.EmbedImageStruct #: interactions.api.models.message.EmbedProvider -#: interactions.api.models.message.Emoji -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild #: interactions.api.models.message.Message #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread @@ -222,7 +218,8 @@ msgstr "" #: interactions.api.models.message.MessageReference #: interactions.api.models.message.PartialSticker #: interactions.api.models.message.ReactionObject -#: interactions.api.models.message.Sticker of +#: interactions.api.models.message.Sticker +#: interactions.api.models.message.StickerPack of msgid "Parameters" msgstr "" @@ -230,6 +227,7 @@ msgstr "" msgid "Gets the channel where the message was sent." msgstr "" +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Embed.add_field #: interactions.api.models.message.Embed.clear_fields #: interactions.api.models.message.Embed.insert_field_at @@ -241,13 +239,10 @@ msgstr "" #: interactions.api.models.message.Embed.set_image #: interactions.api.models.message.Embed.set_thumbnail #: interactions.api.models.message.Embed.set_video -#: interactions.api.models.message.Emoji.delete -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url #: interactions.api.models.message.Message.create_reaction #: interactions.api.models.message.Message.create_thread #: interactions.api.models.message.Message.delete +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_channel #: interactions.api.models.message.Message.get_from_url @@ -307,7 +302,7 @@ msgstr "" #: interactions.api.models.message.Message.edit:13 #: interactions.api.models.message.Message.reply:13 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.message.Message.edit:15 @@ -323,10 +318,9 @@ msgid "" "components will be removed" msgstr "" -#: interactions.api.models.message.Emoji.get -#: interactions.api.models.message.Emoji.get_all_of_guild -#: interactions.api.models.message.Emoji.url +#: interactions.api.models.message.Attachment.download #: interactions.api.models.message.Message.create_thread +#: interactions.api.models.message.Message.disable_all_components #: interactions.api.models.message.Message.edit #: interactions.api.models.message.Message.get_from_url #: interactions.api.models.message.Message.get_users_from_reaction @@ -466,6 +460,14 @@ msgstr "" msgid "The URL of said message" msgstr "" +#: interactions.api.models.message.Message.disable_all_components:1 of +msgid "Sets all components to disabled on this message." +msgstr "" + +#: interactions.api.models.message.Message.disable_all_components:3 of +msgid "The modified message." +msgstr "" + #: interactions.api.models.message.MessageReference:1 of msgid "A class object representing the \"referenced\"/replied message." msgstr "" @@ -654,20 +656,26 @@ msgstr "" msgid "Inserts a field in the embed at the specified index" msgstr "" -#: interactions.api.models.message.Embed.insert_field_at:3 -#: interactions.api.models.message.Embed.remove_field:3 -#: interactions.api.models.message.Embed.set_field_at:3 of -msgid "The new field's index" +#: interactions.api.models.message.Embed.insert_field_at:3 of +msgid "The field's index to insert" msgstr "" #: interactions.api.models.message.Embed.set_field_at:1 of msgid "Overwrites the field in the embed at the specified index" msgstr "" +#: interactions.api.models.message.Embed.set_field_at:3 of +msgid "The field's index to overwrite" +msgstr "" + #: interactions.api.models.message.Embed.remove_field:1 of msgid "Remove field at the specified index" msgstr "" +#: interactions.api.models.message.Embed.remove_field:3 of +msgid "The field's index to remove" +msgstr "" + #: interactions.api.models.message.Embed.remove_author:1 of msgid "Removes the embed's author" msgstr "" @@ -906,95 +914,12 @@ msgstr "" msgid "Whether the attachment is ephemeral." msgstr "" -#: interactions.api.models.message.Emoji:1 of -msgid "A class objecting representing an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji:3 of -msgid "Emoji id" -msgstr "" - -#: interactions.api.models.message.Emoji:4 of -msgid "Emoji name." -msgstr "" - -#: interactions.api.models.message.Emoji:5 of -msgid "Roles allowed to use this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:6 of -msgid "User that created this emoji" -msgstr "" - -#: interactions.api.models.message.Emoji:7 of -msgid "Status denoting of this emoji must be wrapped in colons" -msgstr "" - -#: interactions.api.models.message.Emoji:8 of -msgid "Status denoting if this emoji is managed (by an integration)" -msgstr "" - -#: interactions.api.models.message.Emoji:9 of -msgid "Status denoting if this emoji is animated" -msgstr "" - -#: interactions.api.models.message.Emoji:10 of -msgid "" -"Status denoting if this emoji can be used. (Can be false via server " -"boosting)" -msgstr "" - -#: interactions.api.models.message.Emoji.get:1 of -msgid "Gets an emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.get:3 of -msgid "The id of the guild of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:5 of -msgid "The id of the emoji" -msgstr "" - -#: interactions.api.models.message.Emoji.get:7 -#: interactions.api.models.message.Emoji.get_all_of_guild:5 of -msgid "The HTTPClient of your bot. Equals to ``bot._http``" -msgstr "" - -#: interactions.api.models.message.Emoji.get:9 of -msgid "The Emoji as object" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:1 of -msgid "Gets all emoji of a guild." +#: interactions.api.models.message.Attachment.download:1 of +msgid "Downloads the attachment." msgstr "" -#: interactions.api.models.message.Emoji.get_all_of_guild:3 of -msgid "The id of the guild to get the emojis of" -msgstr "" - -#: interactions.api.models.message.Emoji.get_all_of_guild:7 of -msgid "The Emoji as list" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:1 of -msgid "Deletes the emoji." -msgstr "" - -#: interactions.api.models.message.Emoji.delete:3 of -msgid "The guild id to delete the emoji from" -msgstr "" - -#: interactions.api.models.message.Emoji.delete:5 of -msgid "The reason of the deletion" -msgstr "" - -#: interactions.api.models.message.Emoji.url:1 of -msgid "Returns the emoji's URL." -msgstr "" - -#: interactions.api.models.message.Emoji.url:3 of -msgid "URL of the emoji" +#: interactions.api.models.message.Attachment.download:3 of +msgid "The attachment's bytes as BytesIO object" msgstr "" #: interactions.api.models.message.EmbedFooter:1 of @@ -1093,3 +1018,116 @@ msgstr "" #: interactions.api.models.message.Sticker:14 of msgid "The standard sticker's sort order within its pack" msgstr "" + +#: interactions.api.models.message.StickerPack:1 of +msgid "A class objects representing a pack of stickers." +msgstr "" + +#: interactions.api.models.message.StickerPack:3 of +msgid "ID of the sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:4 of +msgid "The stickers in the pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:5 of +msgid "The name of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:6 of +msgid "ID of the pack's SKU." +msgstr "" + +#: interactions.api.models.message.StickerPack:7 of +msgid "ID of a sticker in the pack which is shown as the pack's icon." +msgstr "" + +#: interactions.api.models.message.StickerPack:8 of +msgid "The description of sticker pack." +msgstr "" + +#: interactions.api.models.message.StickerPack:9 of +msgid "ID of the sticker pack's banner image." +msgstr "" + +#~ msgid "The allowed mentions of roles attached in the message." +#~ msgstr "" + +#~ msgid "Components associated with this message, if any." +#~ msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" + +#~ msgid "The new field's index" +#~ msgstr "" + +#~ msgid "A class objecting representing an emoji." +#~ msgstr "" + +#~ msgid "Emoji id" +#~ msgstr "" + +#~ msgid "Emoji name." +#~ msgstr "" + +#~ msgid "Roles allowed to use this emoji" +#~ msgstr "" + +#~ msgid "User that created this emoji" +#~ msgstr "" + +#~ msgid "Status denoting of this emoji must be wrapped in colons" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is managed (by an integration)" +#~ msgstr "" + +#~ msgid "Status denoting if this emoji is animated" +#~ msgstr "" + +#~ msgid "" +#~ "Status denoting if this emoji can " +#~ "be used. (Can be false via server" +#~ " boosting)" +#~ msgstr "" + +#~ msgid "Gets an emoji." +#~ msgstr "" + +#~ msgid "The id of the guild of the emoji" +#~ msgstr "" + +#~ msgid "The id of the emoji" +#~ msgstr "" + +#~ msgid "The HTTPClient of your bot. Equals to ``bot._http``" +#~ msgstr "" + +#~ msgid "The Emoji as object" +#~ msgstr "" + +#~ msgid "Gets all emoji of a guild." +#~ msgstr "" + +#~ msgid "The id of the guild to get the emojis of" +#~ msgstr "" + +#~ msgid "The Emoji as list" +#~ msgstr "" + +#~ msgid "Deletes the emoji." +#~ msgstr "" + +#~ msgid "The guild id to delete the emoji from" +#~ msgstr "" + +#~ msgid "The reason of the deletion" +#~ msgstr "" + +#~ msgid "Returns the emoji's URL." +#~ msgstr "" + +#~ msgid "URL of the emoji" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.models.misc.po b/docs/locale/ru/LC_MESSAGES/api.models.misc.po index cfed122db..77ec620aa 100644 --- a/docs/locale/ru/LC_MESSAGES/api.models.misc.po +++ b/docs/locale/ru/LC_MESSAGES/api.models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.misc.rst:4 msgid "Miscellanous Models" @@ -27,6 +27,7 @@ msgstr "" msgid "An enumeration." msgstr "" +#: interactions.api.models.misc.AllowedMentionType #: interactions.api.models.misc.AutoModKeywordPresetTypes #: interactions.api.models.misc.AutoModTriggerType of msgid "Member Type" @@ -37,6 +38,7 @@ msgstr "" msgid ":py:class:`int`" msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 #: interactions.api.models.misc.AutoModKeywordPresetTypes:1 #: interactions.api.models.misc.AutoModTriggerType:1 of msgid "Valid values are as follows:" @@ -50,6 +52,7 @@ msgstr "" msgid "The maximum duration for duration_seconds is 2419200 seconds, aka 4 weeks." msgstr "" +#: interactions.api.models.misc.AllowedMentions #: interactions.api.models.misc.AutoModAction #: interactions.api.models.misc.AutoModMetaData #: interactions.api.models.misc.AutoModTriggerMetadata @@ -66,15 +69,6 @@ msgstr "" msgid "Timeout duration in seconds, if timed out." msgstr "" -#: interactions.api.models.misc.AutoModAction -#: interactions.api.models.misc.AutoModMetaData -#: interactions.api.models.misc.AutoModTriggerMetadata -#: interactions.api.models.misc.ClientStatus interactions.api.models.misc.File -#: interactions.api.models.misc.Image interactions.api.models.misc.Overwrite -#: interactions.api.models.misc.Snowflake of -msgid "Parameters" -msgstr "" - #: interactions.api.models.misc.AutoModAction:1 of msgid "" "A class object used for the ``AUTO_MODERATION_ACTION_EXECUTION`` event. " @@ -107,6 +101,53 @@ msgstr "" msgid "The internally pre-defined wordsets which will be searched for in content." msgstr "" +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "An enumerable object representing the allowed mention types" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.api.models.misc.AllowedMentionType:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:1 of +msgid "A class object representing the allowed mentions object" +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:3 of +msgid "" +"Optional[List[AllowedMentionType]]: An array of allowed mention types to " +"parse from the content." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:4 of +msgid "Optional[List[int]]: An array of user ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:5 of +msgid "Optional[List[int]]: An array of role ids to mention." +msgstr "" + +#: interactions.api.models.misc.AllowedMentions:6 of +msgid "" +"Optional[bool]: For replies, whether to mention the author of the message" +" being replied to." +msgstr "" + #: interactions.api.models.misc.Snowflake:1 of msgid "The Snowflake object." msgstr "" @@ -129,17 +170,6 @@ msgid "" "integer." msgstr "" -#: interactions.api.models.misc.Color.black -#: interactions.api.models.misc.Color.blurple -#: interactions.api.models.misc.Color.fuchsia -#: interactions.api.models.misc.Color.green -#: interactions.api.models.misc.Color.red -#: interactions.api.models.misc.Color.white -#: interactions.api.models.misc.Color.yellow -#: interactions.api.models.misc.Snowflake of -msgid "Return type" -msgstr "" - #: interactions.api.models.misc.Snowflake.increment:1 of msgid "" "This is the 'Increment' portion of the snowflake. This is incremented for" @@ -199,6 +229,16 @@ msgstr "" msgid "Returns a hexadecimal value of the blurple color." msgstr "" +#: interactions.api.models.misc.Color.black +#: interactions.api.models.misc.Color.blurple +#: interactions.api.models.misc.Color.fuchsia +#: interactions.api.models.misc.Color.green +#: interactions.api.models.misc.Color.red +#: interactions.api.models.misc.Color.white +#: interactions.api.models.misc.Color.yellow of +msgid "Return type" +msgstr "" + #: interactions.api.models.misc.Color.green:1 of msgid "Returns a hexadecimal value of the green color." msgstr "" @@ -287,3 +327,6 @@ msgstr "" #: interactions.api.models.misc.Overwrite:6 of msgid "Permission bit set." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.models.presence.po b/docs/locale/ru/LC_MESSAGES/api.models.presence.po index 347c24dbc..cfbae19fa 100644 --- a/docs/locale/ru/LC_MESSAGES/api.models.presence.po +++ b/docs/locale/ru/LC_MESSAGES/api.models.presence.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.presence.rst:4 msgid "Presence Models" @@ -43,15 +43,6 @@ msgstr "" msgid "An array denoting the party's current and max size" msgstr "" -#: interactions.api.models.presence.ClientPresence -#: interactions.api.models.presence.PresenceActivity -#: interactions.api.models.presence.PresenceAssets -#: interactions.api.models.presence.PresenceParty -#: interactions.api.models.presence.PresenceSecrets -#: interactions.api.models.presence.PresenceTimestamp of -msgid "Parameters" -msgstr "" - #: interactions.api.models.presence.PresenceAssets:1 of msgid "A class object representing the assets of a presence." msgstr "" @@ -231,3 +222,6 @@ msgstr "" #: interactions.api.models.presence.ClientPresence:6 of msgid "Whether the client is afk or not." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.models.role.po b/docs/locale/ru/LC_MESSAGES/api.models.role.po index c78eeec53..4828e3cfc 100644 --- a/docs/locale/ru/LC_MESSAGES/api.models.role.po +++ b/docs/locale/ru/LC_MESSAGES/api.models.role.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.role.rst:4 msgid "Role Models" @@ -130,6 +130,12 @@ msgstr "" msgid "RGB color value as integer, defaults to the current value of the role" msgstr "" +#: interactions.api.models.role.Role.modify:9 of +msgid "" +"Bitwise value of the enabled/disabled permissions, defaults to the " +"current value of the role" +msgstr "" + #: interactions.api.models.role.Role.modify:11 of msgid "" "Whether the role should be displayed separately in the sidebar, defaults " diff --git a/docs/locale/ru/LC_MESSAGES/api.models.team.po b/docs/locale/ru/LC_MESSAGES/api.models.team.po index 2958a4252..36accb3a5 100644 --- a/docs/locale/ru/LC_MESSAGES/api.models.team.po +++ b/docs/locale/ru/LC_MESSAGES/api.models.team.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.team.rst:4 msgid "Team Models" @@ -51,11 +51,6 @@ msgstr "" msgid "The User ID of the current team owner" msgstr "" -#: interactions.api.models.team.Application interactions.api.models.team.Team -#: interactions.api.models.team.TeamMember of -msgid "Parameters" -msgstr "" - #: interactions.api.models.team.TeamMember:1 of msgid "A class object representing the member of a team." msgstr "" @@ -183,3 +178,6 @@ msgstr "" #: interactions.api.models.team.Application.icon_url of msgid "Return type" msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.models.user.po b/docs/locale/ru/LC_MESSAGES/api.models.user.po index 5721c56da..00f10cc86 100644 --- a/docs/locale/ru/LC_MESSAGES/api.models.user.po +++ b/docs/locale/ru/LC_MESSAGES/api.models.user.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.user.rst:4 msgid "User Models" @@ -94,17 +94,14 @@ msgstr "" msgid "The user's public flags" msgstr "" -#: interactions.api.models.user.User of -msgid "Parameters" -msgstr "" - #: interactions.api.models.user.User.mention:1 of msgid "Returns a string that allows you to mention the given user." msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Returns" msgstr "" @@ -114,7 +111,8 @@ msgstr "" #: interactions.api.models.user.User.avatar_url #: interactions.api.models.user.User.banner_url -#: interactions.api.models.user.User.mention of +#: interactions.api.models.user.User.mention +#: interactions.api.models.user.User.presence of msgid "Return type" msgstr "" @@ -133,3 +131,14 @@ msgstr "" #: interactions.api.models.user.User.banner_url:3 of msgid "URL of the user's banner (None will be returned if no banner is set)" msgstr "" + +#: interactions.api.models.user.User.presence:1 of +msgid "Returns the presence of the user." +msgstr "" + +#: interactions.api.models.user.User.presence:3 of +msgid "Presence of the user (None will be returned if not cached)" +msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/api.models.webhook.po b/docs/locale/ru/LC_MESSAGES/api.models.webhook.po index be10a2fd1..906a172a9 100644 --- a/docs/locale/ru/LC_MESSAGES/api.models.webhook.po +++ b/docs/locale/ru/LC_MESSAGES/api.models.webhook.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../api.models.webhook.rst:4 msgid "Webhook Models" @@ -209,7 +209,7 @@ msgid "embedded ``rich`` content" msgstr "" #: interactions.api.models.webhook.Webhook.execute:18 of -msgid "allowed mentions for the message" +msgid "The allowed mentions for the message." msgstr "" #: interactions.api.models.webhook.Webhook.execute:20 of @@ -257,3 +257,6 @@ msgstr "" #: interactions.api.models.webhook.WebhookType:1 of msgid "Valid values are as follows:" msgstr "" + +#~ msgid "allowed mentions for the message" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/client.po b/docs/locale/ru/LC_MESSAGES/client.po index 854019fc5..48424e61c 100644 --- a/docs/locale/ru/LC_MESSAGES/client.po +++ b/docs/locale/ru/LC_MESSAGES/client.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../client.rst:4 msgid "Bot Client" @@ -31,10 +31,6 @@ msgstr "" #: interactions.client.bot.Client #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence @@ -44,6 +40,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.user_command #: interactions.client.bot.Extension of msgid "Parameters" @@ -80,60 +77,73 @@ msgid "" "automatic or not." msgstr "" +#: interactions.client.bot.Client:15 of +msgid "" +"Set to ``True`` to enable debug logging or set to a log level to use a " +"specific level" +msgstr "" + #: interactions.client.bot.Client of msgid "Variables" msgstr "" -#: interactions.client.bot.Client:16 of +#: interactions.client.bot.Client:18 of msgid "The asynchronous event loop of the client." msgstr "" -#: interactions.client.bot.Client:17 of +#: interactions.client.bot.Client:19 of msgid "" "The user-facing HTTP connection to the Web API, as its own separate " "client." msgstr "" -#: interactions.client.bot.Client:18 of +#: interactions.client.bot.Client:20 of msgid "An object-orientation of a websocket server connection to the Gateway." msgstr "" -#: interactions.client.bot.Client:19 of +#: interactions.client.bot.Client:21 of msgid "The Gateway intents of the application. Defaults to ``Intents.DEFAULT``." msgstr "" -#: interactions.client.bot.Client:20 of +#: interactions.client.bot.Client:22 of msgid "The list of bucketed shards for the application's connection." msgstr "" -#: interactions.client.bot.Client:21 of +#: interactions.client.bot.Client:23 of msgid "The RPC-like presence shown on an application once connected." msgstr "" -#: interactions.client.bot.Client:22 of +#: interactions.client.bot.Client:24 of msgid "The token of the application used for authentication when connecting." msgstr "" -#: interactions.client.bot.Client:23 of +#: interactions.client.bot.Client:25 of msgid "The \"extensions\" or cog equivalence registered to the main client." msgstr "" -#: interactions.client.bot.Client:24 of +#: interactions.client.bot.Client:26 of msgid "The application representation of the client." msgstr "" -#: interactions.client.bot.Client +#: interactions.client.bot.Client.guilds:1 of +msgid "Returns a list of guilds the bot is in." +msgstr "" + +#: interactions.client.bot.Client.latency:1 of +msgid "Returns the connection latency in milliseconds." +msgstr "" + +#: interactions.client.bot.Client.start:1 of +msgid "Starts the client session." +msgstr "" + #: interactions.client.bot.Client.__check_command #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create -#: interactions.client.bot.Client.__register_events #: interactions.client.bot.Client.__resolve_commands #: interactions.client.bot.Client.__sync #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client._login interactions.client.bot.Client._ready +#: interactions.client.bot.Client._stop #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.change_presence #: interactions.client.bot.Client.command @@ -142,6 +152,7 @@ msgstr "" #: interactions.client.bot.Client.message_command #: interactions.client.bot.Client.modal interactions.client.bot.Client.modify #: interactions.client.bot.Client.reload interactions.client.bot.Client.remove +#: interactions.client.bot.Client.request_guild_members #: interactions.client.bot.Client.start #: interactions.client.bot.Client.user_command #: interactions.client.bot.Client.wait_until_ready @@ -149,22 +160,6 @@ msgstr "" msgid "Return type" msgstr "" -#: interactions.client.bot.Client.guilds:1 of -msgid "Returns a list of guilds the bot is in." -msgstr "" - -#: interactions.client.bot.Client.latency:1 of -msgid "Returns the connection latency in milliseconds." -msgstr "" - -#: interactions.client.bot.Client.start:1 of -msgid "Starts the client session." -msgstr "" - -#: interactions.client.bot.Client.__register_events:1 of -msgid "Registers all raw gateway events to the known events." -msgstr "" - #: interactions.client.bot.Client.__compare_sync:1 of msgid "Compares an application command during the synchronization process." msgstr "" @@ -178,10 +173,6 @@ msgid "The \"pool\" or list of commands to compare from." msgstr "" #: interactions.client.bot.Client.__compare_sync -#: interactions.client.bot.Client.__raw_channel_create -#: interactions.client.bot.Client.__raw_guild_create -#: interactions.client.bot.Client.__raw_message_create -#: interactions.client.bot.Client.__raw_socket_create #: interactions.client.bot.Client._find_command #: interactions.client.bot.Client.autocomplete #: interactions.client.bot.Client.command @@ -204,6 +195,10 @@ msgid "" "conditions have been met in a chronological order:" msgstr "" +#: interactions.client.bot.Client._stop:1 of +msgid "Stops the websocket connection gracefully." +msgstr "" + #: interactions.client.bot.Client._login:1 of msgid "Makes a login with the Discord API." msgstr "" @@ -448,7 +443,7 @@ msgid "" msgstr "" #: interactions.client.bot.Client._find_command:3 of -msgid "The name of the command to match" +msgid "The name or ID of the command to match" msgstr "" #: interactions.client.bot.Client._find_command:5 of @@ -574,59 +569,34 @@ msgstr "" msgid "The modified User object" msgstr "" -#: interactions.client.bot.Client.__raw_socket_create:1 of -msgid "" -"This is an internal function that takes any gateway socket event and then" -" returns the data purely based off of what it does in the client " -"instantiation class." -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:5 of -msgid "The data that is returned" -msgstr "" - -#: interactions.client.bot.Client.__raw_socket_create:7 of -msgid "A dictionary of raw data." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:1 of -msgid "" -"This is an internal function that caches the channel creates when " -"dispatched." -msgstr "" - -#: interactions.client.bot.Client.__raw_channel_create:3 of -msgid "The channel object data in question." +#: interactions.client.bot.Client.request_guild_members:1 of +msgid "Requests guild members via websocket." msgstr "" -#: interactions.client.bot.Client.__raw_channel_create:5 of -msgid "The channel as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:3 of +msgid "ID of the guild to get members for." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:1 of +#: interactions.client.bot.Client.request_guild_members:5 of msgid "" -"This is an internal function that caches the message creates when " -"dispatched." +"Maximum number of members to send matching the 'query' parameter. " +"Required when specifying 'query'." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:3 of -msgid "The message object data in question." +#: interactions.client.bot.Client.request_guild_members:7 of +msgid "String that username starts with." msgstr "" -#: interactions.client.bot.Client.__raw_message_create:5 of -msgid "The message as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:9 of +msgid "Used to specify if we want the presences of the matched members." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:1 of -msgid "This is an internal function that caches the guild creates on ready." +#: interactions.client.bot.Client.request_guild_members:11 of +msgid "Used to specify which users you wish to fetch." msgstr "" -#: interactions.client.bot.Client.__raw_guild_create:3 of -msgid "The guild object data in question." -msgstr "" - -#: interactions.client.bot.Client.__raw_guild_create:5 of -msgid "The guild as a dictionary of raw data." +#: interactions.client.bot.Client.request_guild_members:13 of +msgid "Nonce to identify the Guild Members Chunk response." msgstr "" #: interactions.client.bot.Extension:1 of @@ -639,3 +609,56 @@ msgstr "" #: interactions.client.bot.Extension:5 of msgid "The structure of an extension:" msgstr "" + +#~ msgid "Registers all raw gateway events to the known events." +#~ msgstr "" + +#~ msgid "The name of the command to match" +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "takes any gateway socket event and " +#~ "then returns the data purely based " +#~ "off of what it does in the " +#~ "client instantiation class." +#~ msgstr "" + +#~ msgid "The data that is returned" +#~ msgstr "" + +#~ msgid "A dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the channel creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The channel object data in question." +#~ msgstr "" + +#~ msgid "The channel as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "" +#~ "This is an internal function that " +#~ "caches the message creates when " +#~ "dispatched." +#~ msgstr "" + +#~ msgid "The message object data in question." +#~ msgstr "" + +#~ msgid "The message as a dictionary of raw data." +#~ msgstr "" + +#~ msgid "This is an internal function that caches the guild creates on ready." +#~ msgstr "" + +#~ msgid "The guild object data in question." +#~ msgstr "" + +#~ msgid "The guild as a dictionary of raw data." +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/context.po b/docs/locale/ru/LC_MESSAGES/context.po index 3917f5b73..8352a5d3e 100644 --- a/docs/locale/ru/LC_MESSAGES/context.po +++ b/docs/locale/ru/LC_MESSAGES/context.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../context.rst:4 msgid "Event Context" @@ -55,7 +55,6 @@ msgstr "" msgid "The guild data model." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update #: interactions.client.context.CommandContext #: interactions.client.context.CommandContext.defer #: interactions.client.context.CommandContext.edit @@ -63,12 +62,15 @@ msgstr "" #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context #: interactions.client.context._Context.edit +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup -#: interactions.client.context._Context.send of +#: interactions.client.context._Context.send +#: interactions.utils.attrs_utils.DictSerializerMixin.update of msgid "Parameters" msgstr "" @@ -79,11 +81,13 @@ msgstr "" #: interactions.client.context.CommandContext.edit #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.send of msgid "Returns" msgstr "" @@ -98,11 +102,13 @@ msgstr "" #: interactions.client.context.CommandContext.populate #: interactions.client.context.CommandContext.send #: interactions.client.context.ComponentContext.defer +#: interactions.client.context.ComponentContext.disable_all_components #: interactions.client.context.ComponentContext.edit #: interactions.client.context.ComponentContext.send #: interactions.client.context._Context.edit #: interactions.client.context._Context.get_channel #: interactions.client.context._Context.get_guild +#: interactions.client.context._Context.has_permissions #: interactions.client.context._Context.popup #: interactions.client.context._Context.send of msgid "Return type" @@ -153,7 +159,7 @@ msgstr "" #: interactions.client.context.CommandContext.send:12 #: interactions.client.context.ComponentContext.send:12 #: interactions.client.context._Context.send:12 of -msgid "The message interactions/mention limits that the message can refer to." +msgid "The allowed mentions for the message." msgstr "" #: interactions.client.context.CommandContext.send:14 @@ -171,6 +177,12 @@ msgstr "" #: interactions.client.context.CommandContext.send:18 #: interactions.client.context.ComponentContext.send:18 #: interactions.client.context._Context.send:18 of +msgid "Whether embeds are not shown in the message." +msgstr "" + +#: interactions.client.context.CommandContext.send:20 +#: interactions.client.context.ComponentContext.send:20 +#: interactions.client.context._Context.send:20 of msgid "The sent message as an object." msgstr "" @@ -197,13 +209,39 @@ msgstr "" msgid "The components you wish to show." msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:1 of +#: interactions.client.context._Context.has_permissions:1 of +msgid "" +"Returns whether the author of the interaction has the permissions in the " +"given context." +msgstr "" + +#: interactions.client.context._Context.has_permissions:3 of +msgid "The list of permissions" +msgstr "" + +#: interactions.client.context._Context.has_permissions:5 of +msgid "" +"The operator to use to calculate permissions. Possible values: `and`, " +"`or`. Defaults to `and`." +msgstr "" + +#: interactions.client.context._Context.has_permissions:7 of +msgid "Whether the author has the permissions" +msgstr "" + +#: ../../docstring interactions.client.context.CommandContext._extras:1 +#: interactions.client.context.ComponentContext._extras:1 +#: interactions.client.context._Context._extras:1 of +msgid "A dict containing values that were not serialized from Discord." +msgstr "" + +#: interactions.utils.attrs_utils.DictSerializerMixin.update:1 of msgid "" "Update an object with new attributes. All data will be converted, and any" " extra attributes will be put in _extras" msgstr "" -#: interactions.api.models.attrs_utils.DictSerializerMixin.update:4 of +#: interactions.utils.attrs_utils.DictSerializerMixin.update:4 of msgid "The dictionary to update from" msgstr "" @@ -286,6 +324,18 @@ msgid "" " was sent from." msgstr "" +#: interactions.client.context.CommandContext:30 of +msgid "The client instance that the command belongs to." +msgstr "" + +#: interactions.client.context.CommandContext:31 of +msgid "The command object that is being invoked." +msgstr "" + +#: interactions.client.context.CommandContext:32 of +msgid "The extension the command belongs to." +msgstr "" + #: interactions.client.context.CommandContext.defer:1 of msgid "" "This \"defers\" an interaction response, allowing up to a 15-minute delay" @@ -342,3 +392,31 @@ msgstr "" #: interactions.client.context.ComponentContext.defer:6 of msgid "Whether you want to edit the original message or send a followup message" msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:1 of +msgid "Disables all components of the message." +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:3 of +msgid "" +"Whether the components should be disabled in an interaction response, " +"default True" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:5 of +msgid "" +"Additional keyword-arguments to pass to the edit method. This only works " +"when this method is used as interaction response and takes the same " +"arguments as :meth:`interactions.client.context._Context:edit()`" +msgstr "" + +#: interactions.client.context.ComponentContext.disable_all_components:8 of +msgid "The modified Message" +msgstr "" + +#: interactions.client.context.ComponentContext.label:1 of +msgid "The label of the interacted button. :rtype: Optional[str]" +msgstr "" + +#~ msgid "The message interactions/mention limits that the message can refer to." +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/events.po b/docs/locale/ru/LC_MESSAGES/events.po index b91a1dc02..7b4ecba7d 100644 --- a/docs/locale/ru/LC_MESSAGES/events.po +++ b/docs/locale/ru/LC_MESSAGES/events.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../events.rst:2 msgid "Event Documentation" @@ -98,99 +98,104 @@ msgid "``on_command``" msgstr "" #: ../../events.rst:57 -msgid "``on_component``" +msgid "``on_command_error``" msgstr "" #: ../../events.rst:58 -msgid "``on_autocomplete``" +msgid "``on_component``" msgstr "" #: ../../events.rst:59 +msgid "``on_autocomplete``" +msgstr "" + +#: ../../events.rst:60 msgid "``on_modal``" msgstr "" -#: ../../events.rst:61 +#: ../../events.rst:62 msgid "Lets now have a look at those events in detail:" msgstr "" -#: ../../events.rst:64 +#: ../../events.rst:65 msgid "Event: ``raw_socket_create``" msgstr "" -#: ../../events.rst:65 +#: ../../events.rst:66 msgid "" "This event fires on any event sent by Discord, including ``Typing Start``" " and ``Voice State Update``. ``Hello``, ``Resumed``, ``Reconnect`` and " "``Invalid Session`` still will not be dispatched." msgstr "" -#: ../../events.rst:68 +#: ../../events.rst:69 msgid "" -"The function handling the event should take in one argument, the type of " -"this argument is a ``dict``." +"A function handling an event should take two arguments, the first " +"argument is the name of the event, the second is the data of that event " +"with type ``dict``." msgstr "" -#: ../../events.rst:70 +#: ../../events.rst:72 msgid "" -"The value of the argument will be the *raw* data sent from Discord, so it" -" is not recommended to use that event as long as you don't absolutely " -"need it." +"The value of the second argument will be the *raw* data sent from " +"Discord, so it is not recommended to use that event as long as you don't " +"absolutely need it." msgstr "" -#: ../../events.rst:75 +#: ../../events.rst:77 msgid "Event: ``on_start``" msgstr "" -#: ../../events.rst:76 +#: ../../events.rst:78 msgid "This event fires only when the bot is started." msgstr "" -#: ../../events.rst:78 ../../events.rst:161 +#: ../../events.rst:80 ../../events.rst:173 msgid "This function takes no arguments." msgstr "" -#: ../../events.rst:81 +#: ../../events.rst:83 msgid "Unlike ``on_ready``, this event will never be dispatched more than once." msgstr "" -#: ../../events.rst:84 +#: ../../events.rst:86 msgid "Event: ``on_interaction``" msgstr "" -#: ../../events.rst:85 +#: ../../events.rst:87 msgid "" "This event fires on any interaction (commands, components, autocomplete " "and modals)." msgstr "" -#: ../../events.rst:87 +#: ../../events.rst:89 msgid "" "The function needs one argument. It will have the type ``CommandContext``" " or ``ComponentContext``." msgstr "" -#: ../../events.rst:89 +#: ../../events.rst:91 msgid "" "Because you will have to check for everything, from the " "``InteractionType`` to any data inside the context, we do not recommend " "using this event unless you have experience with it." msgstr "" -#: ../../events.rst:94 +#: ../../events.rst:96 msgid "Event: ``on_command``" msgstr "" -#: ../../events.rst:95 +#: ../../events.rst:97 msgid "" "This event fires on any Application Command (slash command + context menu" " command) used." msgstr "" -#: ../../events.rst:97 ../../events.rst:117 ../../events.rst:127 +#: ../../events.rst:99 ../../events.rst:129 ../../events.rst:139 msgid "The function takes in one argument of the type ``CommandContext``." msgstr "" -#: ../../events.rst:99 +#: ../../events.rst:101 msgid "" "Using this event, you will have to manually check everything, from name " "to whether the used commands have sub commands, options or anything else " @@ -198,138 +203,174 @@ msgid "" "it" msgstr "" -#: ../../events.rst:104 +#: ../../events.rst:106 +msgid "Event: ``on_command_error``" +msgstr "" + +#: ../../events.rst:107 +msgid "This event fires when the following conditions are met:" +msgstr "" + +#: ../../events.rst:109 +msgid "There is an error in the command (or subcommand within the command)" +msgstr "" + +#: ../../events.rst:110 +msgid "There is no error callback assigned to that command" +msgstr "" + +#: ../../events.rst:112 +msgid "" +"The function takes in two arguments, one of the type ``CommandContext``, " +"and the other contains the error." +msgstr "" + +#: ../../events.rst:116 msgid "Event: ``on_component``" msgstr "" -#: ../../events.rst:105 +#: ../../events.rst:117 msgid "" "This event fires on any Component used (for now, those are Buttons and " "Select Menus)." msgstr "" -#: ../../events.rst:107 +#: ../../events.rst:119 msgid "The function takes in one argument of the type ``ComponentContext``." msgstr "" -#: ../../events.rst:109 +#: ../../events.rst:121 msgid "" "Like ``on_command``, you will have to manually check for everything, i.e " "for custom id and component type. Also, you will have to look through the" " argument to find the selected choices, if you have a select menu." msgstr "" -#: ../../events.rst:114 +#: ../../events.rst:126 msgid "Event: ``on_autocomplete``" msgstr "" -#: ../../events.rst:115 +#: ../../events.rst:127 msgid "This event fires on any autocomplete triggered." msgstr "" -#: ../../events.rst:119 +#: ../../events.rst:131 msgid "" "As already in the events above, you will have to get the important values" " yourself. Those values are here the autocompleted option and the user " "input." msgstr "" -#: ../../events.rst:124 +#: ../../events.rst:136 msgid "Event: ``on_modal``" msgstr "" -#: ../../events.rst:125 +#: ../../events.rst:137 msgid "This event fires on every modal that is submitted." msgstr "" -#: ../../events.rst:129 +#: ../../events.rst:141 msgid "" "You will have to get all values yourself and check what modal was used " "when using this event." msgstr "" -#: ../../events.rst:132 +#: ../../events.rst:144 msgid "" "Additionally, if you struggle with getting the values, you can check " ":ref:`how it is handled internally `." msgstr "" -#: ../../events.rst:136 +#: ../../events.rst:148 msgid "After this, let us look at events from the Discord API." msgstr "" -#: ../../events.rst:139 +#: ../../events.rst:151 msgid "Discord API Events" msgstr "" -#: ../../events.rst:141 +#: ../../events.rst:153 msgid "" "Events in this section do not match the name needed to put into the " "function. Please check :ref:`above ` for how to get the correct name." msgstr "" -#: ../../events.rst:145 +#: ../../events.rst:157 msgid "" "There are a lot of events dispatched by the Discord API. All of those can" " be found `here`_." msgstr "" -#: ../../events.rst:147 +#: ../../events.rst:159 msgid "" "The events ``HELLO``, ``RESUMED``, ``RECONNECT``, ``INVALID SESSION`` and" " ``TYPING START`` are not dispatched by the library." msgstr "" -#: ../../events.rst:149 +#: ../../events.rst:161 msgid "" "``TYPING START`` will be included in the raw socket create event. You can" " also listen for it if you choose to subclass the WebSocketClient" msgstr "" -#: ../../events.rst:152 +#: ../../events.rst:164 msgid "" "The event ``VOICE STATE UPDATE`` can be only received with the voice " ":ref:`Extension `." msgstr "" -#: ../../events.rst:155 +#: ../../events.rst:167 msgid "Let's now have a look at a few events:" msgstr "" -#: ../../events.rst:158 +#: ../../events.rst:170 msgid "Event: ``READY``" msgstr "" -#: ../../events.rst:159 +#: ../../events.rst:171 msgid "" "This event fires whenever ``READY`` is dispatched by Discord. This " "happens when connecting to the web socket server." msgstr "" -#: ../../events.rst:164 +#: ../../events.rst:176 msgid "" "Due to the bot reconnecting during runtime, ``on_ready`` will be " "dispatched multiple times. If you rely on ``on_ready`` to do certain " "things once, check against a global variable as shown below:" msgstr "" -#: ../../events.rst:181 +#: ../../events.rst:193 msgid "Events: ``GUILD MEMBER UPDATE`` and ``GUILD MEMBER ADD``" msgstr "" -#: ../../events.rst:182 +#: ../../events.rst:194 msgid "" "These events fire whenever a member joins a guild or a member of a guild " "gets modified." msgstr "" -#: ../../events.rst:184 +#: ../../events.rst:196 msgid "The function takes in one argument of the type ``GuildMember``." msgstr "" -#: ../../events.rst:186 +#: ../../events.rst:198 msgid "" "The argument has the same methods as a normal ``Member`` object, except " "the methods *do not take in a guild id*. Please keep that in mind when " "using this event." msgstr "" + +#~ msgid "" +#~ "The function handling the event should" +#~ " take in one argument, the type " +#~ "of this argument is a ``dict``." +#~ msgstr "" + +#~ msgid "" +#~ "The value of the argument will be" +#~ " the *raw* data sent from Discord," +#~ " so it is not recommended to " +#~ "use that event as long as you " +#~ "don't absolutely need it." +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/faq.po b/docs/locale/ru/LC_MESSAGES/faq.po index 1bf421161..09e3ae8c9 100644 --- a/docs/locale/ru/LC_MESSAGES/faq.po +++ b/docs/locale/ru/LC_MESSAGES/faq.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../faq.rst:2 msgid "Frequently Asked Questions" @@ -283,12 +283,12 @@ msgstr "" #: ../../faq.rst:157 msgid "" -"A `voice client`_ - which is still WIP, but it is able to listen for the " +"`voice client`_ - which is still WIP, but it is able to listen for the " "``VOICE_STATE_UPDATE`` event." msgstr "" #: ../../faq.rst:158 -msgid "An `autosharder`_ for automatic sharding" +msgid "`autosharder`_ for automatic sharding" msgstr "" #: ../../faq.rst:159 @@ -310,146 +310,148 @@ msgid "`enhanced`_ which enhances the DX in general" msgstr "" #: ../../faq.rst:163 -msgid "A `paginator`_ for paginating embeds on messages using components" +msgid "`paginator`_ for paginating embeds on messages using components" msgstr "" #: ../../faq.rst:164 msgid "" -"`persistence`_ - for storing data inside your custom IDs (as an " -"alternative to ``wait_for``)" +"`persistence`_ for storing data inside your custom IDs (as an alternative" +" to ``wait_for``)" msgstr "" #: ../../faq.rst:165 -msgid "And a `boilerplate`_" +msgid "`lavalink`_ for voice sending and listening ``VOICE_STATE_UPDATE`` event" +msgstr "" + +#: ../../faq.rst:166 +msgid "`fastapi`_ for building own API" msgstr "" #: ../../faq.rst:167 +msgid "And a `boilerplate`_" +msgstr "" + +#: ../../faq.rst:169 msgid "" "Below are a few unofficial exts (for the time being) which implement some" " functionality similar to what d.py had:" msgstr "" -#: ../../faq.rst:169 +#: ../../faq.rst:171 msgid "`checks and cooldowns`_" msgstr "" -#: ../../faq.rst:170 +#: ../../faq.rst:172 msgid "`tasks`_" msgstr "" -#: ../../faq.rst:171 -msgid "" -"`get`_ for getting objects from the discord API (will be implemented into" -" the core library at a later time)" -msgstr "" - -#: ../../faq.rst:173 +#: ../../faq.rst:174 msgid "Usage examples can usually be found at the linked page" msgstr "" -#: ../../faq.rst:177 +#: ../../faq.rst:178 msgid "Can I make an Extension Library myself?" msgstr "" -#: ../../faq.rst:178 +#: ../../faq.rst:179 msgid "" "Yeah, you can! We have a special channel reserved for the development of " "external libraries! You can also read `this `_ for more information." msgstr "" -#: ../../faq.rst:183 +#: ../../faq.rst:184 msgid "" "I'm getting \"``AttributeError: HTTPClient not found!``\" when I try to " "execute helper methods!" msgstr "" -#: ../../faq.rst:184 +#: ../../faq.rst:185 msgid "Probably you are doing something like this:" msgstr "" -#: ../../faq.rst:191 +#: ../../faq.rst:192 msgid "" "And the error occurs in the line where you try to send something. You can" " fix this easy by adding one argument:" msgstr "" -#: ../../faq.rst:198 +#: ../../faq.rst:199 msgid "" "You have to add this extra argument for every object you instantiate by " "yourself if you want to use it's methods" msgstr "" -#: ../../faq.rst:202 +#: ../../faq.rst:203 msgid "" "Context and Messages don't have the ``Channel`` and ``Guild`` attributes!" " Why?" msgstr "" -#: ../../faq.rst:203 +#: ../../faq.rst:204 msgid "" "At the moment the Discord API does *not* include them into their " "responses. You can get those object via the ``get_channel()`` and " "``get_guild()`` methods of the Context and Message model." msgstr "" -#: ../../faq.rst:208 +#: ../../faq.rst:209 msgid "\"``ctx.send got an unexpected keyword argument: files``\"! Why?" msgstr "" -#: ../../faq.rst:209 +#: ../../faq.rst:210 msgid "" "It is not supported due to an decision of the core developer team. There " "are two ways to do it:" msgstr "" -#: ../../faq.rst:212 +#: ../../faq.rst:213 msgid "Using ``await channel.send`` instead" msgstr "" -#: ../../faq.rst:213 +#: ../../faq.rst:214 msgid "Using the `files`_ extension" msgstr "" -#: ../../faq.rst:217 +#: ../../faq.rst:218 msgid "\"``ctx.send got an unexpected keyword argument: embed``\"! Why?" msgstr "" -#: ../../faq.rst:218 +#: ../../faq.rst:219 msgid "" "This is quite simple: The argument ``embed`` got deprecated by Discord. " "The new naming is ``embeds``." msgstr "" -#: ../../faq.rst:222 +#: ../../faq.rst:223 msgid "How can I check what exception happened during a request?" msgstr "" -#: ../../faq.rst:223 +#: ../../faq.rst:224 msgid "We, unlike d.py, do not offer something like ``interactions.NotFound``." msgstr "" -#: ../../faq.rst:225 +#: ../../faq.rst:226 msgid "Instead you have to do it like this:" msgstr "" -#: ../../faq.rst:228 +#: ../../faq.rst:229 msgid "" "This feature will be implemented with version 4.3 and is currently only " "available on beta/unstable" msgstr "" -#: ../../faq.rst:242 +#: ../../faq.rst:243 msgid "" "You can additionally get the exact reason for why the exception occurred " "with ``e.message`` or ``e.lookup(e.code)``" msgstr "" -#: ../../faq.rst:246 +#: ../../faq.rst:247 msgid "My message content is always empty! How can I fix this?" msgstr "" -#: ../../faq.rst:247 +#: ../../faq.rst:248 msgid "" "This happens because you did not enable the intent for message content. " "Enable it on the developer portal and add it into the ``Client`` " @@ -459,11 +461,11 @@ msgid "" "``Intents.DEFAULT``, it can be any other intent(s) you need!" msgstr "" -#: ../../faq.rst:254 +#: ../../faq.rst:255 msgid "Is there something like ``Cogs``?" msgstr "" -#: ../../faq.rst:255 +#: ../../faq.rst:256 msgid "" "Yes! Although, we call them ``Extensions``. Yeah, like :ref:`Extension " "Libraries `. This is because an extension " @@ -471,39 +473,39 @@ msgid "" "how you create an extension for yourself:" msgstr "" -#: ../../faq.rst:283 +#: ../../faq.rst:284 msgid "It's nothing more than that." msgstr "" -#: ../../faq.rst:285 +#: ../../faq.rst:286 msgid "" "Since ``@bot.X`` decorators don't work in extensions, you have to use " "these:" msgstr "" -#: ../../faq.rst:287 +#: ../../faq.rst:288 msgid "For event listeners, use ``@interactions.extension_listener``" msgstr "" -#: ../../faq.rst:288 +#: ../../faq.rst:289 msgid "For component listeners, use ``@interactions.extension_component``" msgstr "" -#: ../../faq.rst:289 +#: ../../faq.rst:290 msgid "For modal listeners, use ``@interactions.extension_modal``" msgstr "" -#: ../../faq.rst:290 +#: ../../faq.rst:291 msgid "For autocomplete listeners, use ``@interactions.extension_autocomplete``" msgstr "" -#: ../../faq.rst:294 +#: ../../faq.rst:295 msgid "" "``channel.members`` does not exist, how do I get the people in a voice " "channel?" msgstr "" -#: ../../faq.rst:295 +#: ../../faq.rst:296 msgid "" "``channel.members`` actually does exist, but is reserved for threads. " "There is no attribute for people in a voice channel by the API. The only " @@ -512,12 +514,37 @@ msgid "" " updated when a member joins or leaves." msgstr "" -#: ../../faq.rst:301 +#: ../../faq.rst:302 msgid "My question is not answered on here!" msgstr "" -#: ../../faq.rst:302 +#: ../../faq.rst:303 msgid "" "Please join our `Discord Server`_ for any further support regarding our " "library and/or any integration code depending on it." msgstr "" + +#~ msgid "" +#~ "A `voice client`_ - which is still" +#~ " WIP, but it is able to listen" +#~ " for the ``VOICE_STATE_UPDATE`` event." +#~ msgstr "" + +#~ msgid "An `autosharder`_ for automatic sharding" +#~ msgstr "" + +#~ msgid "A `paginator`_ for paginating embeds on messages using components" +#~ msgstr "" + +#~ msgid "" +#~ "`persistence`_ - for storing data inside" +#~ " your custom IDs (as an alternative" +#~ " to ``wait_for``)" +#~ msgstr "" + +#~ msgid "" +#~ "`get`_ for getting objects from the " +#~ "discord API (will be implemented into" +#~ " the core library at a later " +#~ "time)" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/index.po b/docs/locale/ru/LC_MESSAGES/index.po index 91465f9df..d7a1d6841 100644 --- a/docs/locale/ru/LC_MESSAGES/index.po +++ b/docs/locale/ru/LC_MESSAGES/index.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../index.rst:47 msgid "Pages:" @@ -51,7 +51,7 @@ msgstr "" #: ../../index.rst:11 msgid "" "Look no more! The goal of this library is to make all three of these " -"questions go from possibilites to trivial matters." +"questions go from possibilities to trivial matters." msgstr "" #: ../../index.rst:14 @@ -181,7 +181,7 @@ msgid "**black** ``22.6.0``" msgstr "" #: ../../index.rst:66 -msgid "**flake8** ``4.0.1``" +msgid "**flake8** ``5.0.4``" msgstr "" #: ../../index.rst:67 @@ -190,7 +190,7 @@ msgstr "" #: ../../index.rst:69 msgid "" -"**Sphinx** ``4.4.0``: all of our documentation is powered off of " +"**Sphinx** ``5.1.1``: all of our documentation is powered off of " "autogenerated documentation of the Sphinx engine." msgstr "" @@ -247,3 +247,20 @@ msgstr "" #: ../../index.rst:88 msgid ":ref:`modindex`" msgstr "" + +#~ msgid "" +#~ "Look no more! The goal of this " +#~ "library is to make all three of" +#~ " these questions go from possibilites " +#~ "to trivial matters." +#~ msgstr "" + +#~ msgid "**flake8** ``4.0.1``" +#~ msgstr "" + +#~ msgid "" +#~ "**Sphinx** ``4.4.0``: all of our " +#~ "documentation is powered off of " +#~ "autogenerated documentation of the Sphinx " +#~ "engine." +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/migration.po b/docs/locale/ru/LC_MESSAGES/migration.po index 9f0d8e6aa..3546c747d 100644 --- a/docs/locale/ru/LC_MESSAGES/migration.po +++ b/docs/locale/ru/LC_MESSAGES/migration.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../migration.rst:2 msgid "Migration" @@ -126,7 +126,9 @@ msgid "" msgstr "" #: ../../migration.rst:99 -msgid "You can get more information by reading the `get-documentation`_." +msgid "" +"You can get more information by reading the " +":meth:`interactions.client.get.get`-documentation" msgstr "" #: ../../migration.rst:102 @@ -148,3 +150,6 @@ msgid "" "your argument in your function differently than your option name! " "Example:" msgstr "" + +#~ msgid "You can get more information by reading the `get-documentation`_." +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/models.command.po b/docs/locale/ru/LC_MESSAGES/models.command.po index 5c72da5b0..a7fca335f 100644 --- a/docs/locale/ru/LC_MESSAGES/models.command.po +++ b/docs/locale/ru/LC_MESSAGES/models.command.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.command.rst:4 msgid "Application Command Models" @@ -37,8 +37,10 @@ msgid "The structure for a choice:" msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission of msgid "Variables" @@ -56,13 +58,14 @@ msgstr "" #: interactions.client.models.command.Command:16 #: interactions.client.models.command.Command.group:28 #: interactions.client.models.command.Command.subcommand:33 -#: interactions.client.models.command.Option:34 of +#: interactions.client.models.command.Option:36 of msgid "" "The dictionary of localization for the ``name`` field. This enforces the " "same restrictions as the ``name`` field." msgstr "" #: interactions.client.models.command.ApplicationCommand +#: interactions.client.models.command.BaseResult #: interactions.client.models.command.Choice #: interactions.client.models.command.Command #: interactions.client.models.command.Command.__call @@ -72,6 +75,7 @@ msgstr "" #: interactions.client.models.command.Command.error #: interactions.client.models.command.Command.group #: interactions.client.models.command.Command.subcommand +#: interactions.client.models.command.GroupResult #: interactions.client.models.command.Option #: interactions.client.models.command.Permission #: interactions.client.models.command.option of @@ -100,8 +104,7 @@ msgstr "" msgid "The type of option." msgstr "" -#: interactions.client.models.command.Option:23 -#: interactions.client.models.command.option:14 of +#: interactions.client.models.command.Option:23 of msgid "The name of the option." msgstr "" @@ -142,19 +145,27 @@ msgid "The maximum value supported by the option." msgstr "" #: interactions.client.models.command.Option:33 of +msgid "The minimum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:34 of +msgid "The maximum length supported by the option." +msgstr "" + +#: interactions.client.models.command.Option:35 of msgid "A status denoting whether this option is an autocomplete option." msgstr "" #: interactions.client.models.command.Command:17 #: interactions.client.models.command.Command.group:30 #: interactions.client.models.command.Command.subcommand:35 -#: interactions.client.models.command.Option:35 of +#: interactions.client.models.command.Option:37 of msgid "" "The dictionary of localization for the ``description`` field. This " "enforces the same restrictions as the ``description`` field." msgstr "" -#: interactions.client.models.command.Option:36 of +#: interactions.client.models.command.Option:38 of msgid "How the option value is passed to the function, if different than ``name``" msgstr "" @@ -248,18 +259,26 @@ msgid "A decorator for adding options to a command." msgstr "" #: interactions.client.models.command.option:3 of -msgid "The structure of an option:" +msgid "" +"The ``type`` and ``name`` of the option are defaulted to the parameter's " +"typehint and name." +msgstr "" + +#: interactions.client.models.command.option:5 of +msgid "" +"When the ``name`` of the option differs from the parameter name, the " +"``converter`` field will default to the name of the parameter." msgstr "" -#: interactions.client.models.command.option:12 of -msgid "The type of the option." +#: interactions.client.models.command.option:8 of +msgid "The structure of an option:" msgstr "" -#: interactions.client.models.command.option:16 of -msgid "The description of the option. Defaults to ``\"No description set\"``." +#: interactions.client.models.command.option:17 of +msgid "The description of the option. Defaults to \"No description set\"." msgstr "" -#: interactions.client.models.command.option:18 of +#: interactions.client.models.command.option:19 of msgid "The keyword arguments of the option, same as :class:`Option`." msgstr "" @@ -283,6 +302,8 @@ msgstr "" msgid "A class that when returned from a command, the command chain is stopped." msgstr "" +#: interactions.client.models.command.BaseResult:3 +#: interactions.client.models.command.GroupResult:3 #: interactions.client.models.command.StopCommand:3 of msgid "Usage:" msgstr "" @@ -291,6 +312,32 @@ msgstr "" msgid "This allows for custom checks that allow stopping the command chain." msgstr "" +#: interactions.client.models.command.BaseResult:1 +#: interactions.client.models.command.GroupResult:1 of +msgid "A class object representing the result of the base command." +msgstr "" + +#: interactions.client.models.command.BaseResult:17 of +msgid "" +"If the subcommand coroutine does not have enough parameters, the " +"``BaseResult`` will not be passed." +msgstr "" + +#: interactions.client.models.command.BaseResult:19 +#: interactions.client.models.command.GroupResult:25 of +msgid "The result of the base command." +msgstr "" + +#: interactions.client.models.command.GroupResult:23 of +msgid "" +"If the subcommand does not have enough arguments, the ``GroupResult`` " +"will not be passed." +msgstr "" + +#: interactions.client.models.command.GroupResult:26 of +msgid "The parent ``BaseResult``." +msgstr "" + #: interactions.client.models.command.Command:1 of msgid "A class object representing a command." msgstr "" @@ -364,6 +411,14 @@ msgstr "" msgid "The extension that the command belongs to, if any." msgstr "" +#: interactions.client.models.command.Command:26 of +msgid "The client that the command belongs to." +msgstr "" + +#: interactions.client.models.command.Command:27 of +msgid "The listener, used for dispatching command errors." +msgstr "" + #: interactions.client.models.command.Command.converters:1 of msgid "" "Returns a dictionary with all converters added to the options of the " @@ -525,3 +580,9 @@ msgid "" ":class:`interactions.client.bot.Extension` is passed to the coroutine, if" " any." msgstr "" + +#~ msgid "The type of the option." +#~ msgstr "" + +#~ msgid "The description of the option. Defaults to ``\"No description set\"``." +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/models.component.po b/docs/locale/ru/LC_MESSAGES/models.component.po index ae186054c..ce3834826 100644 --- a/docs/locale/ru/LC_MESSAGES/models.component.po +++ b/docs/locale/ru/LC_MESSAGES/models.component.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.component.rst:4 msgid "Component Models" @@ -257,36 +257,18 @@ msgid "The maximum length of the input." msgstr "" #: interactions.client.models.component.Modal:1 of -msgid "A class object representing a modal." +msgid "A class object representing a modal. The structure for a modal: ::" msgstr "" -#: interactions.client.models.component.Modal:8 of -msgid "The structure for a modal: ::" -msgstr "" - -#: interactions.client.models.component.Modal:6 of -msgid "interactions.Modal(" -msgstr "" - -#: interactions.client.models.component.Modal:5 of -msgid "" -"title=\"Application Form\", custom_id=\"mod_app_form\", " -"components=[interactions.TextInput(...)]," -msgstr "" - -#: interactions.client.models.component.Modal:8 of -msgid ")" -msgstr "" - -#: interactions.client.models.component.Modal:10 of +#: interactions.client.models.component.Modal:9 of msgid "The custom ID of the modal." msgstr "" -#: interactions.client.models.component.Modal:11 of +#: interactions.client.models.component.Modal:10 of msgid "The title of the modal." msgstr "" -#: interactions.client.models.component.Modal:12 of +#: interactions.client.models.component.Modal:11 of msgid "The components of the modal." msgstr "" @@ -302,22 +284,22 @@ msgid "" " also support only 1 text input component only." msgstr "" -#: interactions.client.models.component.ActionRow:13 of -msgid "The structure for an action row: ::" +#: interactions.client.models.component.ActionRow:8 of +msgid "The structure for an action row: ..code-block:: python" msgstr "" -#: interactions.client.models.component.ActionRow:9 of +#: interactions.client.models.component.ActionRow:10 of msgid "" "# \"...\" represents a component object. # Method 1: " "interactions.ActionRow(...) # Method 2: " "interactions.ActionRow(components=[...])" msgstr "" -#: interactions.client.models.component.ActionRow:15 of +#: interactions.client.models.component.ActionRow:16 of msgid "The type of component. Always defaults to ``1``." msgstr "" -#: interactions.client.models.component.ActionRow:16 of +#: interactions.client.models.component.ActionRow:17 of msgid "A list of components the ActionRow has, if any." msgstr "" @@ -340,3 +322,23 @@ msgstr "" #: interactions.client.models.component.ActionRow.new of msgid "Return type" msgstr "" + +#~ msgid "A class object representing a modal." +#~ msgstr "" + +#~ msgid "The structure for a modal: ::" +#~ msgstr "" + +#~ msgid "interactions.Modal(" +#~ msgstr "" + +#~ msgid "" +#~ "title=\"Application Form\", custom_id=\"mod_app_form\"," +#~ " components=[interactions.TextInput(...)]," +#~ msgstr "" + +#~ msgid ")" +#~ msgstr "" + +#~ msgid "The structure for an action row: ::" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/models.misc.po b/docs/locale/ru/LC_MESSAGES/models.misc.po index 9ea8f4346..31ef0b3e5 100644 --- a/docs/locale/ru/LC_MESSAGES/models.misc.po +++ b/docs/locale/ru/LC_MESSAGES/models.misc.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-17 16:00-0400\n" +"POT-Creation-Date: 2022-09-26 12:28-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../models.misc.rst:4 msgid "Miscellaneous Models" @@ -56,12 +56,6 @@ msgstr "" msgid "The resolved attachments data." msgstr "" -#: interactions.client.models.misc.Interaction -#: interactions.client.models.misc.InteractionData -#: interactions.client.models.misc.InteractionResolvedData of -msgid "Parameters" -msgstr "" - #: interactions.client.models.misc.InteractionData:1 of msgid "A class object representing the data of an interaction." msgstr "" @@ -102,6 +96,10 @@ msgstr "" msgid "The targeted ID of the interaction." msgstr "" +#: interactions.client.models.misc.InteractionData:12 of +msgid "Array of Action Rows in modal." +msgstr "" + #: interactions.client.models.misc.Interaction:1 of msgid "A class object representing an interaction." msgstr "" @@ -149,3 +147,6 @@ msgstr "" #: interactions.client.models.misc.Interaction:13 of msgid "The message of the interaction." msgstr "" + +#~ msgid "Parameters" +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/quickstart.po b/docs/locale/ru/LC_MESSAGES/quickstart.po index 89ed78f26..76b3670dc 100644 --- a/docs/locale/ru/LC_MESSAGES/quickstart.po +++ b/docs/locale/ru/LC_MESSAGES/quickstart.po @@ -9,14 +9,14 @@ msgid "" msgstr "" "Project-Id-Version: interactions.py 4.3\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-07-16 17:02-0400\n" +"POT-Creation-Date: 2022-09-26 11:08-0400\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.9.1\n" +"Generated-By: Babel 2.10.3\n" #: ../../quickstart.rst:2 msgid "Quickstart" @@ -28,10 +28,11 @@ msgstr "" #: ../../quickstart.rst:7 msgid "" -"**discord-interactions** is a :ref:`Python library ` for the Discord Application Programming Interface. (API) A" -" library in Python has to be installed through the `pip` file. Run this " -"in your terminal/command line in order to install our library:" +"**discord-interactions** is a :ref:`Python library " +"` for the Discord Application Programming " +"Interface. (API) A library in Python has to be installed through the " +"`pip` file. Run this in your terminal/command line in order to install " +"our library:" msgstr "" #: ../../quickstart.rst:11 @@ -308,109 +309,116 @@ msgid "" msgstr "" #: ../../quickstart.rst:208 -msgid "" -"The first field in the ``@option()`` decorator is the type of the option." -" This is positional only and required. You can use integers, the default " -"Python types, the ``OptionType`` enum, or supported objects such as " -"``interactions.Channel``." +msgid "All arguments in the decorator are keyword arguments only." msgstr "" #: ../../quickstart.rst:209 -msgid "All other arguments in the decorator are keyword arguments only." +msgid "" +"The ``type`` and ``name`` fields default to the typehint and the name of " +"the parameter." msgstr "" #: ../../quickstart.rst:210 -msgid "The ``name`` field is required." +msgid "" +"The ``description`` field is optional and defaults to ``\"No description " +"set``." msgstr "" #: ../../quickstart.rst:211 msgid "" -"The ``description`` field is optional and defaults to ``\"No description " -"set``." +"The ``required`` field defaults to whether the default for the parameter " +"is empty." msgstr "" #: ../../quickstart.rst:212 msgid "" +"For typehinting or inputting the ``type`` field, you can use integers, " +"the default Python types, the ``OptionType`` enum, or supported objects " +"such as ``interactions.Channel``." +msgstr "" + +#: ../../quickstart.rst:213 +msgid "" "Any parameters from ``Option`` can be passed into the ``@option()`` " "decorator." msgstr "" -#: ../../quickstart.rst:215 +#: ../../quickstart.rst:216 msgid "The limit for options per command is 25." msgstr "" -#: ../../quickstart.rst:218 +#: ../../quickstart.rst:219 msgid "Nested commands: subcommands" msgstr "" -#: ../../quickstart.rst:220 +#: ../../quickstart.rst:221 msgid "" "Subcommands are options that are nested to create subcategories of " "commands." msgstr "" -#: ../../quickstart.rst:222 +#: ../../quickstart.rst:223 msgid "Here is the structure of a subcommand:" msgstr "" -#: ../../quickstart.rst:265 +#: ../../quickstart.rst:266 msgid "You can also create subcommands using the command system:" msgstr "" -#: ../../quickstart.rst:291 +#: ../../quickstart.rst:292 msgid "You can add a SUB_COMMAND_GROUP in between the base and command." msgstr "" -#: ../../quickstart.rst:294 +#: ../../quickstart.rst:295 msgid "Additional information about subcommands" msgstr "" -#: ../../quickstart.rst:296 +#: ../../quickstart.rst:297 msgid "" "Base commands are returned the :ref:`Command ` object. From this, you can utilize the following " "decorators:" msgstr "" -#: ../../quickstart.rst:299 +#: ../../quickstart.rst:300 msgid "" ":ref:`@subcommand() `: creates" " a subcommand." msgstr "" -#: ../../quickstart.rst:300 +#: ../../quickstart.rst:301 msgid "" ":ref:`@group() `: creates a " "group." msgstr "" -#: ../../quickstart.rst:301 +#: ../../quickstart.rst:302 msgid "" ":ref:`@error `: registers an " "error callback." msgstr "" -#: ../../quickstart.rst:303 +#: ../../quickstart.rst:304 msgid "Check the documentation for the parameters of each of these decorators." msgstr "" -#: ../../quickstart.rst:305 +#: ../../quickstart.rst:306 msgid "The following is an example of a base command:" msgstr "" -#: ../../quickstart.rst:313 +#: ../../quickstart.rst:314 msgid "The examples below will be using the base command above." msgstr "" -#: ../../quickstart.rst:315 +#: ../../quickstart.rst:316 msgid "The following is an example of a subcommand of the base command:" msgstr "" -#: ../../quickstart.rst:323 +#: ../../quickstart.rst:324 msgid "This code results in the following subcommand: `/base_command subcommand`." msgstr "" -#: ../../quickstart.rst:326 +#: ../../quickstart.rst:327 msgid "" "You can use the ``base_res`` parameter in groups and subcommands, and " "``group_res`` in subcommands inside groups to access the result of the " @@ -418,50 +426,50 @@ msgid "" "``ctx`` parameter." msgstr "" -#: ../../quickstart.rst:329 +#: ../../quickstart.rst:330 msgid "The following is an example of a group with subcommands:" msgstr "" -#: ../../quickstart.rst:341 +#: ../../quickstart.rst:342 msgid "" "You can have multiple groups, with multiple subcommands in each group. " "Subcommands and groups are options, so the same restrictions apply." msgstr "" -#: ../../quickstart.rst:344 +#: ../../quickstart.rst:345 msgid "Create any subcommands without groups *before* creating any groups." msgstr "" -#: ../../quickstart.rst:346 +#: ../../quickstart.rst:347 msgid "" "Since there are multiple coroutines involved that each get executed, you " "may be wondering how you can stop the chain. Luckily, there is a way:" msgstr "" -#: ../../quickstart.rst:360 +#: ../../quickstart.rst:361 msgid "This works on both groups and subcommands." msgstr "" -#: ../../quickstart.rst:362 +#: ../../quickstart.rst:363 msgid "The following is an example of an error callback:" msgstr "" -#: ../../quickstart.rst:378 +#: ../../quickstart.rst:379 msgid "" "The parameters ``ctx`` and ``error`` are required, but you can have more " "parameters, such as ``*args`` and ``**kwargs``, if you need to access " "options." msgstr "" -#: ../../quickstart.rst:382 +#: ../../quickstart.rst:383 msgid "You can have one error callback per command." msgstr "" -#: ../../quickstart.rst:385 +#: ../../quickstart.rst:386 msgid "Special type of commands: Context menus" msgstr "" -#: ../../quickstart.rst:387 +#: ../../quickstart.rst:388 msgid "" "While, granted that application commands are way more intuitive and " "easier to work with as both a bot developer and user from a UX approach, " @@ -472,39 +480,39 @@ msgid "" " right-click actions with menial effort." msgstr "" -#: ../../quickstart.rst:393 +#: ../../quickstart.rst:394 msgid "" "In order to create a menu-based command, all you need to do is simply add" " this one line into your ``@command`` decorator:" msgstr "" -#: ../../quickstart.rst:406 +#: ../../quickstart.rst:407 msgid "Here is an alternate way of creating a context menu:" msgstr "" -#: ../../quickstart.rst:415 +#: ../../quickstart.rst:416 msgid "" "The structure of a menu command differs significantly from that of a " "regular one:" msgstr "" -#: ../../quickstart.rst:417 +#: ../../quickstart.rst:418 msgid "You cannot have any options or choices." msgstr "" -#: ../../quickstart.rst:418 +#: ../../quickstart.rst:419 msgid "You cannot have a description." msgstr "" -#: ../../quickstart.rst:419 +#: ../../quickstart.rst:420 msgid "The ``name`` filter follows a different regex pattern." msgstr "" -#: ../../quickstart.rst:422 +#: ../../quickstart.rst:423 msgid "Creating and sending Components" msgstr "" -#: ../../quickstart.rst:424 +#: ../../quickstart.rst:425 msgid "" "Being able to run your own commands is very useful for a lot of " "automation-related purposes as a bot developer, however, we also have " @@ -513,14 +521,14 @@ msgid "" "components." msgstr "" -#: ../../quickstart.rst:429 +#: ../../quickstart.rst:430 msgid "" "Components are ways of being able to select pre-defined data, or define " "your own. They're very simple but quite powerful when put into practice " "This code block below shows a simplified implementation of a component:" msgstr "" -#: ../../quickstart.rst:455 +#: ../../quickstart.rst:456 msgid "" "This is a design that we ended up choosing to simplify responding to " "buttons when someone presses on one, and to allow bot developers to plug " @@ -530,11 +538,11 @@ msgid "" "modularity." msgstr "" -#: ../../quickstart.rst:462 +#: ../../quickstart.rst:463 msgid "What kinds of components are there?" msgstr "" -#: ../../quickstart.rst:464 +#: ../../quickstart.rst:465 msgid "" "As a bot developer, this may be fairly important for you to want to know." " Different components provide difference user experiences, interactions " @@ -543,18 +551,18 @@ msgid "" "able to `find these component types`_ here." msgstr "" -#: ../../quickstart.rst:471 +#: ../../quickstart.rst:472 msgid "How do I send components in a row?" msgstr "" -#: ../../quickstart.rst:473 +#: ../../quickstart.rst:474 msgid "" "You are also able to organize these components into rows, which are " "defined as ``ActionRow``'s. It is worth noting that you can have only a " "maximum of 5 per message that you send. This code block below shows how:" msgstr "" -#: ../../quickstart.rst:505 +#: ../../quickstart.rst:506 msgid "" "By default, the ``components`` keyword-argument field in the context " "sending method will always support ``ActionRow``-less sending: you only " @@ -563,57 +571,57 @@ msgid "" "class objects instead." msgstr "" -#: ../../quickstart.rst:511 +#: ../../quickstart.rst:512 msgid "" "You cannot use ``TextInput`` with the above shown method. Look :ref:`here" " ` how to create and send them." msgstr "" -#: ../../quickstart.rst:516 +#: ../../quickstart.rst:517 msgid "Creating a TextInput" msgstr "" -#: ../../quickstart.rst:517 +#: ../../quickstart.rst:518 msgid "You want to get a Text from a user? You can use ``TextInput`` for that." msgstr "" -#: ../../quickstart.rst:529 +#: ../../quickstart.rst:530 msgid "" "But how to send it? You can't use ``ctx.send`` for it. Take a look at " ":ref:`Modals ` for that." msgstr "" -#: ../../quickstart.rst:533 +#: ../../quickstart.rst:534 msgid "Modals" msgstr "" -#: ../../quickstart.rst:534 +#: ../../quickstart.rst:535 msgid "" "Modals are a new way to interact with a user. Currently only a " "``TextInput`` component is supported. You can have up to five " "``TextInput`` in a Modal." msgstr "" -#: ../../quickstart.rst:547 +#: ../../quickstart.rst:548 msgid "with the ``TextInput`` example from above we get:" msgstr "" -#: ../../quickstart.rst:552 +#: ../../quickstart.rst:553 msgid "Responding to a Modal interaction" msgstr "" -#: ../../quickstart.rst:560 +#: ../../quickstart.rst:561 msgid "" "You can respond to a modal the same way as you would respond to a normal " "``chat-input`` command, except your function has an extra argument for " "the text what was put into the modal." msgstr "" -#: ../../quickstart.rst:563 +#: ../../quickstart.rst:564 msgid "Adding v2 Permissions" msgstr "" -#: ../../quickstart.rst:565 +#: ../../quickstart.rst:566 msgid "" "v2 permissions consist of the ``default_member_permissions`` and " "``dm_permission`` keyword arguments. Similar to adding privileged " @@ -621,55 +629,87 @@ msgid "" "etc.) as follows:" msgstr "" -#: ../../quickstart.rst:604 +#: ../../quickstart.rst:605 msgid "" "Adding guild-only commands is easier as the only thing it takes is a " "boolean. Here's an example of a guild-only command:" msgstr "" -#: ../../quickstart.rst:623 +#: ../../quickstart.rst:624 msgid "" "Likewise, setting ``dm_permission`` to ``True`` makes it usable in DMs. " "Just to note that this argument's mainly used for global commands. Guild " "commands with this argument will have no effect." msgstr "" -#: ../../quickstart.rst:627 +#: ../../quickstart.rst:628 msgid "Utilities" msgstr "" -#: ../../quickstart.rst:629 +#: ../../quickstart.rst:630 msgid "You can use the following utilities to help you with your commands:" msgstr "" -#: ../../quickstart.rst:631 +#: ../../quickstart.rst:632 msgid "``ActionRow.new()``: Creates a new ``ActionRow`` object." msgstr "" -#: ../../quickstart.rst:632 +#: ../../quickstart.rst:633 msgid "``spread_to_rows()``: Spreads a list of components into a list of rows." msgstr "" -#: ../../quickstart.rst:633 +#: ../../quickstart.rst:634 msgid "" "``@autodefer()``: Automatically defers a command if it did not respond " "within the specified time." msgstr "" -#: ../../quickstart.rst:635 +#: ../../quickstart.rst:636 msgid "" -"Look at their documentation :ref:`here ` for " -"more information." +"Look at their documentation :ref:`here ` for more " +"information." msgstr "" -#: ../../quickstart.rst:637 +#: ../../quickstart.rst:638 msgid "Usage of ``ActionRow.new()``:" msgstr "" -#: ../../quickstart.rst:653 +#: ../../quickstart.rst:654 msgid "Usage of ``spread_to_rows()``:" msgstr "" -#: ../../quickstart.rst:675 +#: ../../quickstart.rst:676 msgid "Usage of ``@autodefer()``:" msgstr "" + +#~ msgid "" +#~ "**discord-interactions** is a :ref:`Python " +#~ "library ` for the" +#~ " Discord Application Programming Interface. " +#~ "(API) A library in Python has to" +#~ " be installed through the `pip` file." +#~ " Run this in your terminal/command " +#~ "line in order to install our " +#~ "library:" +#~ msgstr "" + +#~ msgid "" +#~ "The first field in the ``@option()`` " +#~ "decorator is the type of the " +#~ "option. This is positional only and " +#~ "required. You can use integers, the " +#~ "default Python types, the ``OptionType`` " +#~ "enum, or supported objects such as " +#~ "``interactions.Channel``." +#~ msgstr "" + +#~ msgid "All other arguments in the decorator are keyword arguments only." +#~ msgstr "" + +#~ msgid "The ``name`` field is required." +#~ msgstr "" + +#~ msgid "" +#~ "Look at their documentation :ref:`here " +#~ "` for more information." +#~ msgstr "" diff --git a/docs/locale/ru/LC_MESSAGES/utils.po b/docs/locale/ru/LC_MESSAGES/utils.po new file mode 100644 index 000000000..2968b6970 --- /dev/null +++ b/docs/locale/ru/LC_MESSAGES/utils.po @@ -0,0 +1,361 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022, goverfl0w +# This file is distributed under the same license as the interactions.py +# package. +# FIRST AUTHOR , 2022. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: interactions.py 4.3\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-09-26 11:03-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.10.3\n" + +#: ../../utils.rst:4 +msgid "The ``get`` utility method" +msgstr "" + +#: interactions.utils.get.get:1 of +msgid "Helper method to get an object." +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "This method can do the following:" +msgstr "" + +#: interactions.utils.get.get:6 of +msgid "Get a list of specific objects" +msgstr "" + +#: interactions.utils.get.get:5 interactions.utils.get.get:9 of +msgid "purely from cache" +msgstr "" + +#: interactions.utils.get.get:6 interactions.utils.get.get:10 of +msgid "purely from HTTP" +msgstr "" + +#: interactions.utils.get.get:7 of +msgid "" +"from cache and additionally from HTTP for every ID that was not found in " +"cache" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "Get a single specific object" +msgstr "" + +#: interactions.utils.get.get:11 of +msgid "from HTTP if not found in cache else from cache" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "The method has to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:14 of +msgid "You don't force anything" +msgstr "" + +#: interactions.utils.get.get:15 of +msgid "You force HTTP" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "The method doesn't have to be awaited when:" +msgstr "" + +#: interactions.utils.get.get:17 of +msgid "You force cache" +msgstr "" + +#: interactions.utils.get.get:20 of +msgid "" +"Technically, there is no need for an ``await`` if there is an object " +"found in the cache. Because of the fact, that, as long as you don't " +"enforce the cache, the function will get the object from HTTP, if it is " +"not in the cache, you still have to await it. This has been done to " +"reduce confusion on whether the object origins from an HTTP call or a " +"cache result and to remove the extra step for you to check if the " +"returned object is an awaitable or not." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing:" +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "Forcing can be done via the ``force`` keyword argument." +msgstr "" + +#: interactions.utils.get.get:31 of +msgid "``force=\"cache\"`` or ``force=interactions.Force.CACHE``:" +msgstr "" + +#: interactions.utils.get.get:30 of +msgid "" +"This forces the method to only return from cache (if the object is not " +"found it will return ``None``). If you use this, you don't need to await " +"the method." +msgstr "" + +#: interactions.utils.get.get:41 of +msgid "``force=\"http\"`` or ``force=interactions.Force.HTTP``:" +msgstr "" + +#: interactions.utils.get.get:34 of +msgid "" +"This forces the method to make an HTTP request to the discord API and " +"return the result of it. If you use this, you have to await the method." +msgstr "" + +#: interactions.utils.get.get:38 of +msgid "" +"If you are a PyCharm user, please be aware of a bug that causes incorrect" +" suggestions to appear if using an enum. Even if PyCharm shows a normal " +"object as result, you have to await the method if you enforce HTTP. To " +"prevent this bug from happening it is suggested using ``force=\"http\"`` " +"instead of the enum." +msgstr "" + +#: interactions.utils.get.get:43 of +msgid "Getting an object:" +msgstr "" + +#: interactions.utils.get.get:45 of +msgid "" +"Here you will see two examples on how to get a single objects and the " +"variations of how the object can be gotten." +msgstr "" + +#: interactions.utils.get.get:48 of +msgid "Example 1/2: Getting a Channel:" +msgstr "" + +#: interactions.utils.get.get:65 of +msgid "Example 2/2: Getting a Member:" +msgstr "" + +#: interactions.utils.get.get:88 of +msgid "" +"Both examples should have given you a basic overview on how to get a " +"single object. Now we will move on with lists of objects." +msgstr "" + +#: interactions.utils.get.get:92 of +msgid "" +"The ``parent_id`` represents the channel or guild id that belongs to the " +"objects you want to get. It is called ``parent_id`` because " +"``guild_or_channel_id`` would be horrible to type out every time." +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "Getting a list of an object:" +msgstr "" + +#: interactions.utils.get.get:96 of +msgid "" +"Here you will see 1 example of how to get a list of objects. The " +"possibilities on how to force (and their results) are the same as in the " +"examples above." +msgstr "" + +#: interactions.utils.get.get:99 of +msgid "Example 1/1: Getting a list of members:" +msgstr "" + +#: interactions.utils.get.get:115 of +msgid "" +"If you enforce cache when getting a list of objects, found objets will be" +" placed into the list and not found objects will be placed as ``None`` " +"into the list." +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Parameters" +msgstr "" + +#: interactions.utils.get.get interactions.utils.utils.autodefer +#: interactions.utils.utils.disable_components +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable +#: interactions.utils.utils.spread_to_rows of +msgid "Return type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "An enumerable object representing the force types for the get method." +msgstr "" + +#: interactions.utils.get.Force of +msgid "Variables" +msgstr "" + +#: interactions.utils.get.Force:3 of +msgid "Enforce the usage of cache and block the usage of http" +msgstr "" + +#: interactions.utils.get.Force:4 of +msgid "Enforce the usage of http and block the usage of cache" +msgstr "" + +#: interactions.utils.get.Force of +msgid "Member Type" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid ":py:class:`str`" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "Valid values are as follows:" +msgstr "" + +#: interactions.utils.get.Force:1 of +msgid "The :class:`~enum.Enum` and its members also have the following methods:" +msgstr "" + +#: enum.Enum._generate_next_value_:1 of +msgid "Generate the next value when not given." +msgstr "" + +#: enum.Enum._generate_next_value_:3 of +msgid "" +"name: the name of the member start: the initial start value or None " +"count: the number of existing members last_value: the last value assigned" +" or None" +msgstr "" + +#: ../../utils.rst:10 +msgid "Utilities" +msgstr "" + +#: interactions.utils.utils.autodefer:1 of +msgid "" +"A decorator that automatically defers a command if it did not respond " +"within ``delay`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:3 of +msgid "The structure of the decorator is:" +msgstr "" + +#: interactions.utils.utils.autodefer:13 of +msgid "" +"The amount of time in seconds to wait before defering the command. " +"Defaults to ``2`` seconds." +msgstr "" + +#: interactions.utils.utils.autodefer:15 of +msgid "Whether the command is deferred ephemerally. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer:17 of +msgid "Whether the command is deferred on origin. Defaults to ``False``." +msgstr "" + +#: interactions.utils.utils.autodefer +#: interactions.utils.utils.get_channel_history +#: interactions.utils.utils.search_iterable of +msgid "Returns" +msgstr "" + +#: interactions.utils.utils.autodefer:19 of +msgid "The inner function, for decorating." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:1 of +msgid "A helper function that spreads components into :class:`ActionRow` s." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:3 of +msgid "Example:" +msgstr "" + +#: interactions.utils.utils.spread_to_rows:24 of +msgid "" +"You can only pass in :class:`ActionRow`s, :class:`Button`s, and " +":class:`SelectMenu`s, but in any order." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:26 of +msgid "The components to spread." +msgstr "" + +#: interactions.utils.utils.spread_to_rows:28 of +msgid "The maximum number of components in a single row. Defaults to ``5``." +msgstr "" + +#: interactions.utils.utils.search_iterable:1 of +msgid "" +"Searches through an iterable for items that: - Are True for the check, if" +" one is given - Have attributes that match the keyword arguments (e.x. " +"passing `id=your_id` will only return objects with that id)" +msgstr "" + +#: interactions.utils.utils.search_iterable:5 of +msgid "The iterable to search through" +msgstr "" + +#: interactions.utils.utils.search_iterable:7 of +msgid "The check that items will be checked against" +msgstr "" + +#: interactions.utils.utils.search_iterable:9 of +msgid "Any attributes the items should have" +msgstr "" + +#: interactions.utils.utils.search_iterable:11 of +msgid "All items that match the check and keywords" +msgstr "" + +#: interactions.utils.utils.disable_components:1 of +msgid "Disables the given components." +msgstr "" + +#: interactions.utils.utils.disable_components:3 of +msgid "The components to disable" +msgstr "" + +#: interactions.utils.utils.get_channel_history:1 of +msgid "Gets the history of a channel." +msgstr "" + +#: interactions.utils.utils.get_channel_history:3 of +msgid "The HTTPClient of the bot or your bot instance" +msgstr "" + +#: interactions.utils.utils.get_channel_history:5 of +msgid "The channel to get the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:7 of +msgid "The message to begin getting the history from" +msgstr "" + +#: interactions.utils.utils.get_channel_history:9 of +msgid "Whether to only get newer message. Default False" +msgstr "" + +#: interactions.utils.utils.get_channel_history:11 of +msgid "A check to ignore specific messages" +msgstr "" + +#: interactions.utils.utils.get_channel_history:13 of +msgid "A set maximum of messages to get before stopping the iteration" +msgstr "" + +#: interactions.utils.utils.get_channel_history:16 of +msgid "An asynchronous iterator over the history of the channel" +msgstr "" diff --git a/docs/models.rst b/docs/models.rst index 73d017149..949fdd220 100644 --- a/docs/models.rst +++ b/docs/models.rst @@ -9,4 +9,3 @@ Interaction Models models.command.rst models.component.rst models.misc.rst - models.utils.rst diff --git a/docs/models.utils.rst b/docs/models.utils.rst deleted file mode 100644 index 1601d1b7e..000000000 --- a/docs/models.utils.rst +++ /dev/null @@ -1,7 +0,0 @@ -.. currentmodule:: interactions - -Utilities -========================== - -.. automodule:: interactions.client.models.utils - :members: diff --git a/docs/quickstart.rst b/docs/quickstart.rst index 240700507..79cc69380 100644 --- a/docs/quickstart.rst +++ b/docs/quickstart.rst @@ -4,7 +4,7 @@ Quickstart Installing ********** -**discord-interactions** is a :ref:`Python library ` for the Discord Application Programming Interface. (API) +**discord-interactions** is a :ref:`Python library ` for the Discord Application Programming Interface. (API) A library in Python has to be installed through the `pip` file. Run this in your terminal/command line in order to install our library: @@ -633,7 +633,7 @@ You can use the following utilities to help you with your commands: * ``spread_to_rows()``: Spreads a list of components into a list of rows. * ``@autodefer()``: Automatically defers a command if it did not respond within the specified time. -Look at their documentation :ref:`here ` for more information. +Look at their documentation :ref:`here ` for more information. Usage of ``ActionRow.new()``: @@ -686,6 +686,6 @@ Usage of ``@autodefer()``: await asyncio.sleep(5) await ctx.send("I'm awake now!") -.. _Client: https://interactionspy.rtfd.io/en/stable/client.html -.. _find these component types: https://interactionspy.readthedocs.io/en/stable/models.component.html +.. _Client: https://interactionspy.rtfd.io/en/latest/client.html +.. _find these component types: https://interactionspy.readthedocs.io/en/latest/models.component.html .. _discord applications page: https://discord.com/developers/applications diff --git a/docs/utils.rst b/docs/utils.rst new file mode 100644 index 000000000..c450ac2e7 --- /dev/null +++ b/docs/utils.rst @@ -0,0 +1,13 @@ +.. currentmodule:: interactions + +The ``get`` utility method +================ + +.. automodule:: interactions.utils.get + :members: + +Utilities +========================== + +.. automodule:: interactions.utils.utils + :members: diff --git a/interactions/__init__.py b/interactions/__init__.py index c89a22d5c..b7a36d328 100644 --- a/interactions/__init__.py +++ b/interactions/__init__.py @@ -12,3 +12,4 @@ from .client import * # noqa: F401 F403 isort: skip from .api import * # noqa: F401 F403 from .base import * # noqa: F401 F403 +from .utils import * # noqa: F401 F403 diff --git a/interactions/api/error.py b/interactions/api/error.py index 1f22d66ab..ea1be79ff 100644 --- a/interactions/api/error.py +++ b/interactions/api/error.py @@ -91,6 +91,7 @@ def lookup(code: int) -> str: 11: "Error creating your command.", 12: "Invalid set of arguments specified.", 13: "No HTTPClient set!", + 14: "Fatal conflict between object and attempted action.", # HTTP errors 400: "Bad Request. The request was improperly formatted, or the server couldn't understand it.", 401: "Not authorized. Double check your token to see if it's valid.", @@ -241,8 +242,7 @@ def lookup(code: int) -> str: 50028: "Invalid role", 50033: "Invalid Recipient(s)", 50034: "A message provided was too old to bulk delete", - 50035: "Invalid form body (returned for both application/json and multipart/form-data bodies)," - " or invalid Content-Type provided", + 50035: "Invalid form body or invalid Content-Type provided", 50036: "An invite was accepted to a guild the application's bot is not in", 50041: "Invalid API version provided", 50045: "File uploaded exceeds the maximum size", @@ -309,12 +309,29 @@ def __init__(self, code: int = 0, message: str = None, severity: int = 0, **kwar self.log(self.message) if _fmt_error: + + _flag: bool = ( + self.message.lower() in self.lookup(self.code).lower() + ) # creativity is hard + + _fmt = "\n".join( + [ + f"Error at {e[2]}: {e[0]} - {e[1] if e[1].endswith('.') else f'{e[1]}.'}" + for e in _fmt_error + ] + ) + super().__init__( - f"{self.message} (code: {self.code}, severity {self.severity})\n" - + "\n".join([f"Error at {e[2]}: {e[0]} - {e[1]}" for e in _fmt_error]) + "\n" + f" Error {self.code} | {self.message if _flag else self.lookup(self.code)}\n" + f" {_fmt if _flag else self.message}\n" + f" {f'Severity {self.severity}.' if _flag else _fmt}\n" + f" {'' if _flag else f'Severity {self.severity}.'}" ) else: super().__init__( - f"An error occurred:\n" - f"{self.message}, with code '{self.code}' and severity '{self.severity}'" + "\n" + f" Error {self.code} | {self.lookup(self.code)}:\n" + f" {self.message}{'' if self.message.endswith('.') else '.'}\n" + f" Severity {self.severity}." ) diff --git a/interactions/api/gateway/__init__.py b/interactions/api/gateway/__init__.py index 3f0423487..903f17955 100644 --- a/interactions/api/gateway/__init__.py +++ b/interactions/api/gateway/__init__.py @@ -6,3 +6,4 @@ """ from .client import * # noqa: F401 F403 from .heartbeat import * # noqa: F401 F403 +from .ratelimit import * # noqa: F401 F403 diff --git a/interactions/api/gateway/client.py b/interactions/api/gateway/client.py index 0c557284d..e9fd15579 100644 --- a/interactions/api/gateway/client.py +++ b/interactions/api/gateway/client.py @@ -4,39 +4,48 @@ from json import dumps, loads from asyncio import ( + FIRST_COMPLETED, Event, + Lock, Task, - ensure_future, + TimeoutError, + create_task, get_event_loop, get_running_loop, new_event_loop, - sleep, + wait, + wait_for, ) from sys import platform, version_info from time import perf_counter from typing import TYPE_CHECKING, Any, Dict, List, Optional, Tuple, Type, Union +from zlib import decompressobj from aiohttp import ClientWebSocketResponse, WSMessage, WSMsgType -from aiohttp.http import WS_CLOSED_MESSAGE, WS_CLOSING_MESSAGE -from ...base import get_logger +from ...base import __version__, get_logger from ...client.enums import InteractionType, OptionType from ...client.models import Option +from ...utils.missing import MISSING from ..dispatch import Listener from ..enums import OpCodeType from ..error import LibraryException from ..http.client import HTTPClient -from ..models.attrs_utils import MISSING from ..models.flags import Intents from ..models.guild import Guild +from ..models.gw import GuildMember, GuildRole from ..models.member import Member +from ..models.message import Message from ..models.misc import Snowflake from ..models.presence import ClientPresence +from ..models.role import Role from .heartbeat import _Heartbeat +from .ratelimit import WSRateLimit if TYPE_CHECKING: from ...client.context import _Context from ..cache import Storage + from ..models.gw import GuildMembers log = get_logger("gateway") @@ -47,47 +56,64 @@ class WebSocketClient: """ A class representing the client's connection to the Gateway via. WebSocket. + .. note :: + The ``__heartbeat_event`` Event object is different from the one built in to the Heartbeater object. + The latter is used to trace heartbeat acknowledgement. + :ivar AbstractEventLoop _loop: The asynchronous event loop. :ivar Listener _dispatch: The built-in event dispatcher. + :ivar WSRateLimit _ratelimiter: The websocket ratelimiter object. :ivar HTTPClient _http: The user-facing HTTP client. :ivar ClientWebSocketResponse _client: The WebSocket data of the connection. - :ivar bool _closed: Whether the connection has been closed or not. + :ivar Event __closed: Whether the connection has been closed or not. :ivar dict _options: The connection options made during connection. :ivar Intents _intents: The gateway intents used for connection. :ivar dict _ready: The contents of the application returned when ready. :ivar _Heartbeat __heartbeater: The context state of a "heartbeat" made to the Gateway. + :ivar Event __heartbeat_event: The state of the overall heartbeat process. :ivar Optional[List[Tuple[int]]] __shard: The shards used during connection. :ivar Optional[ClientPresence] __presence: The presence used in connection. :ivar Event ready: The ready state of the client as an ``asyncio.Event``. - :ivar Task __task: The closing task for ending connections. + :ivar Task _task: The task containing the heartbeat manager process. :ivar bool __started: Whether the client has started. :ivar Optional[str] session_id: The ID of the ongoing session. :ivar Optional[int] sequence: The sequence identifier of the ongoing session. :ivar float _last_send: The latest time of the last send_packet function call since connection creation, in seconds. :ivar float _last_ack: The latest time of the last ``HEARTBEAT_ACK`` event since connection creation, in seconds. - :ivar float latency: The latency of the connection, in seconds. + :ivar Optional[str] resume_url: The Websocket ratelimit URL for resuming connections, if any. + :ivar Optional[str] ws_url: The Websocket URL for instantiating connections without resuming. + :ivar Lock reconnect_lock: The lock used for reconnecting the client. + :ivar Lock _closing_lock: The lock used for closing the client. + :ivar Optional[Task] __stopping: The task containing stopping the client, if any. """ __slots__ = ( "_loop", "_dispatch", + "_ratelimiter", "_http", "_client", - "_closed", + "__closed", # placeholder to work with variables atm. its event variant of "_closed" "_options", "_intents", "_ready", "__heartbeater", "__shard", "__presence", - "__task", + "_zlib", + "_task", + "__heartbeat_event", "__started", "session_id", "sequence", "ready", "_last_send", "_last_ack", - "latency", + "resume_url", + "ws_url", + "reconnect_lock", + "_closing_lock", + "__stopping", ) def __init__( @@ -112,160 +138,190 @@ def __init__( except RuntimeError: self._loop = new_event_loop() self._dispatch: Listener = Listener() - self._http: HTTPClient = HTTPClient(token) + + self._ratelimiter = ( + WSRateLimit(loop=self._loop) if version_info < (3, 10) else WSRateLimit() + ) + self.__heartbeater: _Heartbeat = _Heartbeat( + loop=self._loop if version_info < (3, 10) else None + ) + self._http: HTTPClient = token + self._client: Optional["ClientWebSocketResponse"] = None - self._closed: bool = False + + self.__closed: Event = Event(loop=self._loop) if version_info < (3, 10) else Event() self._options: dict = { - "max_msg_size": 1024**2, + "max_msg_size": 0, "timeout": 60, "autoclose": False, "compress": 0, + "headers": { + "User-Agent": f"DiscordBot (https://github.com/interactions-py/library {__version__}) " + }, } + self._intents: Intents = intents - self.__heartbeater: _Heartbeat = _Heartbeat( - loop=self._loop if version_info < (3, 10) else None - ) self.__shard: Optional[List[Tuple[int]]] = None self.__presence: Optional[ClientPresence] = None - self.__task: Optional[Task] = None + + self._task: Optional[Task] = None + self.__heartbeat_event = Event(loop=self._loop) if version_info < (3, 10) else Event() self.__started: bool = False + self.session_id: Optional[str] = None if session_id is MISSING else session_id self.sequence: Optional[str] = None if sequence is MISSING else sequence self.ready: Event = Event(loop=self._loop) if version_info < (3, 10) else Event() self._last_send: float = perf_counter() self._last_ack: float = perf_counter() - self.latency: float = float("nan") # noqa: F821 - # self.latency has to be noqa, this is valid in python but not in Flake8. + + self.resume_url: Optional[str] = None + self.ws_url: Optional[str] = None + self.reconnect_lock = Lock(loop=self._loop) if version_info < (3, 10) else Lock() + + self._closing_lock = Event(loop=self._loop) if version_info < (3, 10) else Event() + + self.__stopping: Optional[Task] = None + + self._zlib = decompressobj() + + @property + def latency(self) -> float: + """ + The latency of the connection, in seconds. + """ + return self._last_ack - self._last_send + + async def run_heartbeat(self) -> None: + """Controls the heartbeat manager. Do note that this shouldn't be executed by outside processes.""" + + if self.__heartbeat_event.is_set(): # resets task of heartbeat event mgr loop + # Because we're hardresetting the process every instance its called, also helps with recursion + self.__heartbeat_event.clear() + + if not self.__heartbeater.event.is_set(): # resets task of heartbeat ack event + self.__heartbeater.event.set() + + try: + await self._manage_heartbeat() + except Exception: + self._closing_lock.set() + log.exception("Heartbeater exception.") async def _manage_heartbeat(self) -> None: """Manages the heartbeat loop.""" - while True: - if self._closed: - await self.__restart() - if self.__heartbeater.event.is_set(): - await self.__heartbeat() - self.__heartbeater.event.clear() - await sleep(self.__heartbeater.delay / 1000) - else: + log.debug(f"Sending heartbeat every {self.__heartbeater.delay / 1000} seconds...") + while not self.__heartbeat_event.is_set(): + + log.debug("Sending heartbeat...") + if not self.__heartbeater.event.is_set(): log.debug("HEARTBEAT_ACK missing, reconnecting...") - await self.__restart() - break - - async def __restart(self) -> None: - """Restart the client's connection and heartbeat with the Gateway.""" - if self.__task: - self.__task.cancel() - self._client = None # clear pending waits - self.__heartbeater.event.clear() - await self._establish_connection(self.__shard, self.__presence) - - async def _establish_connection( - self, - shard: Optional[List[Tuple[int]]] = MISSING, - presence: Optional[ClientPresence] = MISSING, - ) -> None: - """ - Establishes a client connection with the Gateway. + await self._reconnect(True) # resume here. - :param shard?: The shards to establish a connection with. Defaults to ``None``. - :type shard?: Optional[List[Tuple[int]]] - :param presence: The presence to carry with. Defaults to ``None``. - :type presence: Optional[ClientPresence] + self.__heartbeater.event.clear() + await self.__heartbeat() + + try: + # wait for next iteration, accounting for latency + await wait_for( + self.__heartbeat_event.wait(), timeout=self.__heartbeater.delay / 1000 + ) + except TimeoutError: + continue # Then we can check heartbeat ack this way and then like it autorestarts. + else: + return # break loop because something went wrong. + + async def run(self) -> None: """ - self._client = None - self.__heartbeater.delay = 0.0 - self._closed = False - self._options["headers"] = {"User-Agent": self._http._req._headers["User-Agent"]} + Handles the client's connection with the Gateway. + """ + + if isinstance(self._http, str): + self._http = HTTPClient(self._http) + url = await self._http.get_gateway() + self.ws_url = url + self._client = await self._http._req._session.ws_connect(url, **self._options) - async with self._http._req._session.ws_connect(url, **self._options) as self._client: - self._closed = self._client.closed + data = await self.__receive_packet(True) # First data is the hello packet. - if self._closed: - await self._establish_connection(self.__shard, self.__presence) + self.__heartbeater.delay = data["d"]["heartbeat_interval"] - while not self._closed: - stream = await self.__receive_packet_stream + self._task = create_task(self.run_heartbeat()) - if stream is None: - continue - if self._client is None or stream == WS_CLOSED_MESSAGE or stream == WSMsgType.CLOSE: - await self._establish_connection(self.__shard, self.__presence) - break + await self.__identify(self.__shard, self.__presence) - if self._client.close_code in range(4010, 4014) or self._client.close_code == 4004: - raise LibraryException(self._client.close_code) + self.__closed.set() + self.__heartbeater.event.set() - await self._handle_connection(stream, shard, presence) + while True: + if self.__stopping is None: + self.__stopping = create_task(self._closing_lock.wait()) + _receive = create_task(self.__receive_packet()) - async def _handle_connection( - self, - stream: Dict[str, Any], - shard: Optional[List[Tuple[int]]] = MISSING, - presence: Optional[ClientPresence] = MISSING, - ) -> None: + done, _ = await wait({self.__stopping, _receive}, return_when=FIRST_COMPLETED) + # Using asyncio.wait to find which one reaches first, when its *closed* or when a message is + # *received* + + if _receive in done: + msg = await _receive + else: + await self.__stopping + _receive.cancel() + return + + if msg is not None: # this can happen + await self._handle_stream(msg) + + async def _handle_stream(self, stream: Dict[str, Any]): """ - Handles the client's connection with the Gateway. + Parses raw stream data recieved from the Gateway, including Gateway opcodes and events. + + .. note :: + This should never be called directly. :param stream: The packet stream to handle. :type stream: Dict[str, Any] - :param shard?: The shards to establish a connection with. Defaults to ``None``. - :type shard?: Optional[List[Tuple[int]]] - :param presence: The presence to carry with. Defaults to ``None``. - :type presence: Optional[ClientPresence] """ op: Optional[int] = stream.get("op") event: Optional[str] = stream.get("t") data: Optional[Dict[str, Any]] = stream.get("d") + seq: Optional[str] = stream.get("s") + if seq: + self.sequence = seq + if op != OpCodeType.DISPATCH: log.debug(data) - if op == OpCodeType.HELLO: - self.__heartbeater.delay = data["heartbeat_interval"] - self.__heartbeater.event.set() - - if self.__task: - self.__task.cancel() # so we can reduce redundant heartbeat bg tasks. - - self.__task = ensure_future(self._manage_heartbeat()) - - if not self.session_id: - await self.__identify(shard, presence) - else: - await self.__resume() if op == OpCodeType.HEARTBEAT: await self.__heartbeat() if op == OpCodeType.HEARTBEAT_ACK: self._last_ack = perf_counter() log.debug("HEARTBEAT_ACK") self.__heartbeater.event.set() - self.latency = self._last_ack - self._last_send - if op in (OpCodeType.INVALIDATE_SESSION, OpCodeType.RECONNECT): - log.debug("INVALID_SESSION/RECONNECT") - # if data and op != OpCodeType.RECONNECT: - # self.session_id = None - # self.sequence = None - # self._closed = True + if op == OpCodeType.INVALIDATE_SESSION: + log.debug("INVALID_SESSION") + self.ready.clear() + await self._reconnect(bool(data)) - if not bool(data) and op == OpCodeType.INVALIDATE_SESSION: - self.session_id = None + if op == OpCodeType.RECONNECT: + log.debug("RECONNECT") + await self._reconnect(True) - await self.__restart() elif event == "RESUMED": log.debug(f"RESUMED (session_id: {self.session_id}, seq: {self.sequence})") elif event == "READY": + self.ready.set() + self._dispatch.dispatch("on_ready") self._ready = data self.session_id = data["session_id"] - self.sequence = stream["s"] - self._dispatch.dispatch("on_ready") + self.resume_url = data["resume_gateway_url"] if not self.__started: self.__started = True self._dispatch.dispatch("on_start") log.debug(f"READY (session_id: {self.session_id}, seq: {self.sequence})") - self.ready.set() else: log.debug(f"{event}: {str(data).encode('utf-8')}") self._dispatch_event(event, data) @@ -283,7 +339,7 @@ def _dispatch_event(self, event: str, data: dict) -> None: :param data: The data for the event. :type data: dict """ - self._dispatch.dispatch("raw_socket_create", data) + self._dispatch.dispatch("raw_socket_create", event, data) path: str = "interactions" path += ".models" if event == "INTERACTION_CREATE" else ".api.models" if event == "INTERACTION_CREATE": @@ -321,7 +377,7 @@ def _dispatch_event(self, event: str, data: dict) -> None: self._dispatch.dispatch("on_component", _context) elif data["type"] == InteractionType.APPLICATION_COMMAND_AUTOCOMPLETE: - _name = f"autocomplete_{_context.data.id}" + _name = f"autocomplete_{_context.data.name}" if _context.data._json.get("options"): for option in _context.data.options: @@ -389,85 +445,64 @@ def _dispatch_event(self, event: str, data: dict) -> None: elif event not in {"TYPING_START", "VOICE_STATE_UPDATE", "VOICE_SERVER_UPDATE"}: name: str = event.lower() try: + data["_client"] = self._http _event_path: list = [section.capitalize() for section in name.split("_")] _name: str = _event_path[0] if len(_event_path) < 3 else "".join(_event_path[:-1]) model = getattr(__import__(path), _name) - - data["_client"] = self._http obj = model(**data) - _cache: "Storage" = self._http.cache[model] + guild_obj = guild_model = None + if model is GuildRole: + guild_obj = Role(**role_data) if (role_data := data.get("role")) else None + guild_model = Role + elif model is GuildMember: + guild_obj = Member(**data) + guild_model = Member - if isinstance(obj, Member): - id = (Snowflake(data["guild_id"]), obj.id) - else: - id = getattr(obj, "id", None) + _cache: "Storage" = self._http.cache[model] + _guild_cache: "Storage" = self._http.cache[guild_model] + ids = None + id = self.__get_object_id(data, obj, model) if id is None: - if model.__name__ == "GuildScheduledEventUser": - id = model.guild_scheduled_event_id - elif model.__name__ in [ - "Invite", - "GuildBan", - "ChannelPins", - "MessageReaction", - "MessageReactionRemove", - "MessageDelete", - # Extend this for everything that should not be cached - ]: - id = None - elif model.__name__.startswith("Guild"): - model_name = model.__name__[5:] - if _data := getattr(obj, model_name, None): - id = ( - getattr(_data, "id") - if not isinstance(_data, dict) - else Snowflake(_data["id"]) - ) - elif hasattr(obj, f"{model_name}_id"): - id = getattr(obj, f"{model_name}_id", None) - - def __modify_guild_cache(): - if not ( - (guild_id := data.get("guild_id")) - and not isinstance(obj, Guild) - and "message" not in name - and id is not None - ): - return - if guild := self._http.cache[Guild].get(Snowflake(guild_id)): - model_name: str = model.__name__ - if "guild" in model_name: - model_name = model_name[5:] - elif model_name == "threadmembers": - return - _obj = getattr(guild, f"{model_name.lower()}s", None) - if _obj is not None and isinstance(_obj, list): - if "_create" in name or "_add" in name: - _obj.append(obj) - for index, __obj in enumerate(_obj): - if __obj.id == id: - if "_remove" in name or "_delete" in name: - _obj.remove(__obj) - - elif "_update" in name and hasattr(obj, "id"): - _obj[index] = obj - break - setattr(guild, f"{model_name}s", _obj) - self._http.cache[Guild].add(guild) + ids = self.__get_object_ids(obj, model) if "_create" in name or "_add" in name: + self._dispatch.dispatch(f"on_{name}", obj) + if id: _cache.merge(obj, id) - self._dispatch.dispatch(f"on_{name}", obj) - __modify_guild_cache() + if guild_obj: + _guild_cache.add(guild_obj, id) + + self.__modify_guild_cache( + name, data, guild_model or model, guild_obj or obj, id, ids + ) elif "_update" in name: self._dispatch.dispatch(f"on_raw_{name}", obj) - if not id: + + if not id and ids is None: + return self._dispatch.dispatch(f"on_{name}", obj) + + self.__modify_guild_cache( + name, data, guild_model or model, guild_obj or obj, id, ids + ) + if ids is not None: + # Not cached but it needed for guild_emojis_update and guild_stickers_update events + return self._dispatch.dispatch(f"on_{name}", obj) + if id is None: return - old_obj = self._http.cache[model].get(id) + + if guild_obj: + old_guild_obj = _guild_cache.get(id) + if old_guild_obj: + old_guild_obj.update(**guild_obj._json) + else: + _guild_cache.add(guild_obj, id) + + old_obj = _cache.get(id) if old_obj: before = model(**old_obj._json) old_obj.update(**obj._json) @@ -476,20 +511,41 @@ def __modify_guild_cache(): old_obj = obj _cache.add(old_obj, id) - __modify_guild_cache() - self._dispatch.dispatch( f"on_{name}", before, old_obj ) # give previously stored and new one elif "_remove" in name or "_delete" in name: - self._dispatch.dispatch(f"on_raw_{name}", obj) - __modify_guild_cache() + self._dispatch.dispatch( + f"on_raw_{name}", obj + ) # Deprecated. Remove this in the future. + + old_obj = None if id: + _guild_cache.pop(id) + self.__modify_guild_cache( + name, data, guild_model or model, guild_obj or obj, id, ids + ) old_obj = _cache.pop(id) - self._dispatch.dispatch(f"on_{name}", old_obj) - elif "_delete_bulk" in name: - self._dispatch.dispatch(f"on_{name}", obj) + + elif ids is not None and "message" in name: + # currently only message has '_delete_bulk' event but ig better keep this condition for future. + _message_cache: "Storage" = self._http.cache[Message] + for message_id in ids: + _message_cache.pop(message_id) + + self._dispatch.dispatch(f"on_{name}", old_obj or obj) + + elif "guild_members_chunk" in name: + self.__modify_guild_cache(name, data, model, obj, ids=ids) + + _member_cache: "Storage" = self._http.cache[Member] + obj: GuildMembers + for member in obj.members: + member._guild_id = obj.guild_id + _member_cache.add(member, (obj.guild_id, member.id)) + + self._dispatch.dispatch(f"on_{name}", obj) else: self._dispatch.dispatch(f"on_{name}", obj) @@ -497,6 +553,140 @@ def __modify_guild_cache(): except AttributeError as error: log.warning(f"An error occurred dispatching {name}: {error}") + def __get_object_id( + self, data: dict, obj: Any, model: type + ) -> Optional[Union[Snowflake, Tuple[Snowflake, Snowflake]]]: + """ + Gets an ID from object. + + :param data: The data for the event. + :type data: dict + :param obj: The object of the event. + :type obj: Any + :param model: The model of the event. + :type model: type + :return: Object ID + :rtype: Optional[Union[Snowflake, Tuple[Snowflake, Snowflake]]] + """ + if isinstance(obj, (Member, GuildMember)): + id = (Snowflake(data["guild_id"]), obj.id) + else: + id = getattr(obj, "id", None) + if id is not None: + return id + + if model.__name__ == "GuildScheduledEventUser": + id = obj.guild_scheduled_event_id + elif model.__name__ == "Presence": + id = obj.user.id + elif model.__name__ in [ + "GuildBan", + # Extend this for everything that starts with 'Guild' and should not be cached + ]: + id = None + elif model.__name__.startswith("Guild"): + model_name = model.__name__[5:].lower() + if (_data := getattr(obj, model_name, None)) and not isinstance(_data, list): + id = getattr(_data, "id") if not isinstance(_data, dict) else Snowflake(_data["id"]) + elif hasattr(obj, f"{model_name}_id"): + id = getattr(obj, f"{model_name}_id", None) + + return id + + def __get_object_ids(self, obj: Any, model: type) -> Optional[List[Snowflake]]: + """ + Gets a list of ids of object. + + :param obj: The object of the event. + :type obj: Any + :param model: The model of the event. + :type model: type + :return: Object IDs + :rtype: Optional[Union[Snowflake, Tuple[Snowflake, Snowflake]]] + """ + ids = getattr(obj, "ids", None) + if ids is not None: + return ids + + if model.__name__.startswith("Guild"): + model_name = model.__name__[5:].lower() + if (_data := getattr(obj, model_name, None)) is not None: + ids = [ + getattr(_obj, "id") if not isinstance(_obj, dict) else Snowflake(_obj["id"]) + for _obj in _data + ] + + return ids + + def __modify_guild_cache( + self, + name: str, + data: dict, + model: Any, + obj: Any, + id: Optional[Snowflake] = None, + ids: Optional[List[Snowflake]] = None, + ): + """ + Modifies guild cache. + + :param event: The name of the event. + :type event: str + :param data: The data for the event. + :type data: dict + :param obj: The object of the event. + :type obj: Any + :param model: The model of the event. + :type model: Any + """ + if not ( + (guild_id := data.get("guild_id")) + and not isinstance(obj, Guild) + and "message" not in name + and (id is not None or ids is not None) + and (guild := self._http.cache[Guild].get(Snowflake(guild_id))) + ): + return + + attr: str = model.__name__.lower() + + if attr.startswith("guild"): + attr = attr[5:] + if attr == "threadmembers": # TODO: Figure out why this here + return + if not attr.endswith("s"): + attr = f"{attr}s" + iterable = getattr(guild, attr, None) + if iterable is not None and isinstance(iterable, list): + if "_create" in name or "_add" in name: + iterable.append(obj) + elif id: + _id = id[1] if isinstance(id, tuple) else id + for index, __obj in enumerate(iterable): + if __obj.id == _id: + if "_remove" in name or "_delete" in name: + iterable.remove(__obj) + + elif "_update" in name and hasattr(obj, "id"): + iterable[index] = obj + break + elif ids is not None and (objs := getattr(obj, attr, None)) is not None: + if "_update" in name: + iterable.clear() + iterable.extend(objs) + elif "_chunk" in name: + for _obj in objs: + for index, __obj in enumerate(iterable): + if __obj.id == _obj.id: + iterable[index] = _obj + break + else: + iterable.append(_obj) + + setattr(guild, attr, iterable) + + self._http.cache[Guild].add(guild) + def __contextualize(self, data: dict) -> "_Context": """ Takes raw data given back from the Gateway @@ -646,32 +836,139 @@ def __option_type_context(self, context: "_Context", type: int) -> dict: } return _resolved - async def restart(self) -> None: - await self.__restart() + async def _reconnect(self, to_resume: bool, code: Optional[int] = 1012) -> None: + """ + Restarts the client's connection and heartbeat with the Gateway. + """ + + self.ready.clear() - @property - async def __receive_packet_stream(self) -> Optional[Union[Dict[str, Any], WSMessage]]: + async with self.reconnect_lock: + self.__closed.clear() + + if self._client is not None: + await self._client.close(code=code) + + self._client = None + + self._zlib = decompressobj() + + # We need to check about existing heartbeater tasks for edge cases. + + if self._task: + self._task.cancel() + if self.__heartbeat_event.is_set(): + self.__heartbeat_event.clear() # Because we're hardresetting the process + + if not to_resume: + url = self.ws_url if self.ws_url else await self._http.get_gateway() + else: + url = f"{self.resume_url}?v=10&encoding=json&compress=zlib-stream" + + self._client = await self._http._req._session.ws_connect(url, **self._options) + + data = await self.__receive_packet(True) # First data is the hello packet. + + self.__heartbeater.delay = data["d"]["heartbeat_interval"] + + self._task = create_task(self.run_heartbeat()) + + if not to_resume: + await self.__identify(self.__shard, self.__presence) + else: + await self.__resume() + + self.__closed.set() + self.__heartbeat_event.set() + + async def __receive_packet(self, ignore_lock: bool = False) -> Optional[Dict[str, Any]]: """ - Receives a stream of packets sent from the Gateway. + Receives a stream of packets sent from the Gateway in an async process. :return: The packet stream. :rtype: Optional[Dict[str, Any]] """ - packet: WSMessage = await self._client.receive() + buffer = bytearray() - if packet == WSMsgType.CLOSE: - await self._client.close() - return packet + while True: - elif packet == WS_CLOSED_MESSAGE: - return packet + if not ignore_lock: + # meaning if we're reconnecting or something because of tasks + await self.__closed.wait() - elif packet == WS_CLOSING_MESSAGE: - await self._client.close() - return WS_CLOSED_MESSAGE + packet: WSMessage = await self._client.receive() + + if packet.type == WSMsgType.CLOSE: + log.debug(f"Disconnecting from gateway = {packet.data}::{packet.extra}") + + if packet.data >= 4000: + # This means that the error code is 4000+, which may signify Discord-provided error codes. + + raise LibraryException(packet.data) + + if ignore_lock: + raise LibraryException( + message="Discord unexpectedly wants to close the WS on receiving by force.", + severity=50, + ) + + await self._reconnect(packet.data != 1000, packet.data) + continue + + elif packet.type == WSMsgType.CLOSED: + # We need to wait/reconnect depending about other event holders. + + if ignore_lock: + raise LibraryException( + message="Discord unexpectedly closed on receiving by force.", severity=50 + ) + + if not self.__closed.is_set(): + await self.__closed.wait() + + # Edge case on force reconnecting if we dont + else: + await self._reconnect(True) + + elif packet.type == WSMsgType.CLOSING: + + if ignore_lock: + raise LibraryException( + message="Discord unexpectedly closing on receiving by force.", severity=50 + ) + + await self.__closed.wait() + continue + + if packet.data is None: + continue # We just loop it over because it could just be processing something. + + if isinstance(packet.data, bytes): + buffer.extend(packet.data) + + if len(packet.data) < 4 or packet.data[-4:] != b"\x00\x00\xff\xff": + # buffer isn't done we need to wait + continue - return loads(packet.data) if packet and isinstance(packet.data, str) else None + msg = self._zlib.decompress(buffer) + msg = msg.decode("utf-8") + else: + msg = packet.data + + try: + _msg = loads(msg) + except Exception as e: + import traceback + + log.debug( + f'Error serialising message: {"".join(traceback.format_exception(type(e), e, e.__traceback__))}.' + ) + # There's an edge case when the packet's None... or some other deserialisation error. + # Instead of raising an exception, we just log it to debug, so it doesn't annoy end user's console logs. + _msg = None + + return _msg async def _send_packet(self, data: Dict[str, Any]) -> None: """ @@ -680,12 +977,30 @@ async def _send_packet(self, data: Dict[str, Any]) -> None: :param data: The data to send to the Gateway. :type data: Dict[str, Any] """ - self._last_send = perf_counter() _data = dumps(data) if isinstance(data, dict) else data packet: str = _data.decode("utf-8") if isinstance(_data, bytes) else _data - await self._client.send_str(packet) log.debug(packet) + if data["op"] in {OpCodeType.IDENTIFY.value, OpCodeType.RESUME.value}: + # This can't use the reconnect lock *because* its already referenced in + # self._reconnect(), hence an infinite hang. + + if self._client is not None: + self._last_send = perf_counter() + + await self._client.send_str(packet) + else: + async with self.reconnect_lock: # needs to lock while it reconnects. + + if data["op"] != OpCodeType.HEARTBEAT.value: + # This is because the ratelimiter limits already accounts for this. + await self._ratelimiter.block() + + if self._client is not None: # this mitigates against another edge case. + self._last_send = perf_counter() + + await self._client.send_str(packet) + async def __identify( self, shard: Optional[List[Tuple[int]]] = None, presence: Optional[ClientPresence] = None ) -> None: @@ -700,15 +1015,16 @@ async def __identify( self.__shard = shard self.__presence = presence payload: dict = { - "op": OpCodeType.IDENTIFY, + "op": OpCodeType.IDENTIFY.value, "d": { "token": self._http.token, "intents": self._intents.value, "properties": { - "$os": platform, - "$browser": "interactions.py", - "$device": "interactions.py", + "os": platform, + "browser": "interactions.py", + "device": "interactions.py", }, + "compress": True, }, } @@ -724,7 +1040,7 @@ async def __identify( async def __resume(self) -> None: """Sends a ``RESUME`` packet to the gateway.""" payload: dict = { - "op": OpCodeType.RESUME, + "op": OpCodeType.RESUME.value, "d": {"token": self._http.token, "seq": self.sequence, "session_id": self.session_id}, } log.debug(f"RESUMING: {payload}") @@ -733,7 +1049,7 @@ async def __resume(self) -> None: async def __heartbeat(self) -> None: """Sends a ``HEARTBEAT`` packet to the gateway.""" - payload: dict = {"op": OpCodeType.HEARTBEAT, "d": self.sequence} + payload: dict = {"op": OpCodeType.HEARTBEAT.value, "d": self.sequence} await self._send_packet(payload) log.debug("HEARTBEAT") @@ -759,7 +1075,51 @@ async def _update_presence(self, presence: ClientPresence) -> None: :param presence: The presence to change the bot to on identify. :type presence: ClientPresence """ - payload: dict = {"op": OpCodeType.PRESENCE, "d": presence._json} + payload: dict = {"op": OpCodeType.PRESENCE.value, "d": presence._json} await self._send_packet(payload) log.debug(f"UPDATE_PRESENCE: {presence._json}") self.__presence = presence + + async def request_guild_members( + self, + guild_id: int, + limit: int, + query: Optional[str] = None, + presences: Optional[bool] = None, + user_ids: Optional[Union[int, List[int]]] = None, + nonce: Optional[str] = None, + ) -> None: + """Sends an ``REQUEST_MEMBERS`` packet to the gateway. + + :param guild_id: ID of the guild to get members for. + :type guild_id: int + :param limit: Maximum number of members to send matching the 'query' parameter. Required when specifying 'query'. + :type limit: int + :param query: String that username starts with. + :type query: Optional[str] + :param presences: Used to specify if we want the presences of the matched members. + :type presences: Optional[bool] + :param user_ids: Used to specify which users you wish to fetch. + :type user_ids: Optional[Union[int, List[int]]] + :param nonce: Nonce to identify the Guild Members Chunk response. + :type nonce: Optional[str] + """ + _data: dict = {"guild_id": guild_id, "query": query or "", "limit": limit} + if presences is not None: + _data["presences"] = presences + if user_ids is not None: + _data["user_ids"] = user_ids + if nonce is not None: + _data["nonce"] = nonce + payload: dict = {"op": OpCodeType.REQUEST_MEMBERS.value, "d": _data} + + await self._send_packet(payload) + log.debug(f"REQUEST_MEMBERS: {payload}") + + async def close(self) -> None: + """ + Closes the current connection. + """ + if self._client: + await self._client.close() + self.__closed.set() diff --git a/interactions/api/gateway/ratelimit.py b/interactions/api/gateway/ratelimit.py new file mode 100644 index 000000000..01e30466f --- /dev/null +++ b/interactions/api/gateway/ratelimit.py @@ -0,0 +1,79 @@ +import asyncio +import logging +from sys import version_info +from time import time +from typing import Optional + +log = logging.getLogger("gateway.ratelimit") + + +class WSRateLimit: + """ + A class that controls Gateway ratelimits using locking and a timer. + + .. note :: + While the docs state that the Gateway ratelimits are 120/60 (120 requests per 60 seconds), + this ratelimit offsets to 115 instead of 120 for room. + + :ivar Lock lock: The gateway Lock object. + :ivar int max: The upper limit of the ratelimit in seconds. Defaults to `115`. + :ivar int remaining: How many requests are left per ``per_second``. This is automatically decremented and reset. + :ivar float current_limit: When this cooldown session began. This is defined automatically. + :ivar float per_second: A constant denoting how many requests can be done per unit of seconds. (i.e., per 60 seconds, per 45, etc.) + """ + + def __init__(self, loop: Optional[asyncio.AbstractEventLoop] = None): + self.lock = asyncio.Lock(loop=loop) if version_info < (3, 10) else asyncio.Lock() + # To conserve timings, we need to do 115/60 + # Also, credit to d.py for their ratelimiter inspiration + + self.max = self.remaining = 115 + self.per_second = 60.0 + self.current_limit = 0.0 + + @property + def ratelimited(self) -> bool: + """ + An attribute that reflects whenever the websocket ratelimiter is rate-limited. + + :return: Whether it's rate-limited or not. + :rtype: bool + """ + current = time() + if current > self.current_limit + self.per_second: + return False + return self.remaining == 0 + + @property + def delay(self) -> float: + """ + An attribute that reflects how long we need to wait for ratelimit to pass, if any. + + :return: How long to wait in seconds, if any. Defaults to ``0.0``. + :rtype: float + """ + current = time() + + if current > self.current_limit + self.per_second: + self.remaining = self.max + + if self.remaining == self.max: + self.current_limit = current + + if self.remaining == 0: + return self.per_second - (current - self.current_limit) + + self.remaining -= 1 + if self.remaining == 0: + self.current_limit = current + + return 0.0 + + async def block(self) -> None: + """ + A function that uses the internal Lock to check for rate-limits and cooldown whenever necessary. + """ + async with self.lock: + if delta := self.delay: + log.warning(f"We are rate-limited. Please wait {round(delta, 2)} seconds...") + await asyncio.sleep(delta) diff --git a/interactions/api/http/channel.py b/interactions/api/http/channel.py index 67ddfa17e..dd0a40899 100644 --- a/interactions/api/http/channel.py +++ b/interactions/api/http/channel.py @@ -307,3 +307,72 @@ async def delete_stage_instance(self, channel_id: int, reason: Optional[str] = N return await self._req.request( Route("DELETE", f"/stage-instances/{channel_id}"), reason=reason ) + + async def create_tag( + self, + channel_id: int, + name: str, + emoji_id: Optional[int] = None, + emoji_name: Optional[str] = None, + ) -> dict: + """ + Create a new tag. + + .. note:: + Can either have an emoji_id or an emoji_name, but not both. + emoji_id is meant for custom emojis, emoji_name is meant for unicode emojis. + + :param channel_id: Channel ID snowflake. + :param name: The name of the tag + :param emoji_id: The ID of the emoji to use for the tag + :param emoji_name: The name of the emoji to use for the tag + """ + + _dct = {"name": name} + if emoji_id: + _dct["emoji_id"] = emoji_id + if emoji_name: + _dct["emoji_name"] = emoji_name + + return await self._req.request(Route("POST", f"/channels/{channel_id}/tags"), json=_dct) + + async def edit_tag( + self, + channel_id: int, + tag_id: int, + name: str, + emoji_id: Optional[int] = None, + emoji_name: Optional[str] = None, + ) -> dict: + """ + Update a tag. + + .. note:: + Can either have an emoji_id or an emoji_name, but not both. + emoji_id is meant for custom emojis, emoji_name is meant for unicode emojis. + + :param channel_id: Channel ID snowflake. + :param tag_id: The ID of the tag to update. + :param name: The new name of the tag + :param emoji_id: The ID of the emoji to use for the tag + :param emoji_name: The name of the emoji to use for the tag + """ + + _dct = {"name": name} + if emoji_id: + _dct["emoji_id"] = emoji_id + if emoji_name: + _dct["emoji_name"] = emoji_name + + return await self._req.request( + Route("PUT", f"/channels/{channel_id}/tags/{tag_id}"), json=_dct + ) + + async def delete_tag(self, channel_id: int, tag_id: int) -> None: # wha? + """ + Delete a forum tag. + + :param channel_id: Channel ID snowflake. + :param tag_id: The ID of the tag to delete + """ + return await self._req.request(Route("DELETE", f"/channels/{channel_id}/tags/{tag_id}")) diff --git a/interactions/api/http/client.py b/interactions/api/http/client.py index ec8efed4d..557968876 100644 --- a/interactions/api/http/client.py +++ b/interactions/api/http/client.py @@ -81,9 +81,9 @@ async def get_gateway(self) -> str: Route("GET", "/gateway") ) # typehinting Any because pycharm yells try: - _url = f'{url["url"]}?v=10&encoding=json' + _url = f'{url["url"]}?v=10&encoding=json&compress=zlib-stream' except TypeError: # seen a few times - _url = "wss://gateway.discord.gg?v=10&encoding=json" + _url = "wss://gateway.discord.gg?v=10&encoding=json&compress=zlib-stream" return _url async def get_bot_gateway(self) -> Tuple[int, str]: @@ -95,9 +95,9 @@ async def get_bot_gateway(self) -> Tuple[int, str]: data: Any = await self._req.request(Route("GET", "/gateway/bot")) try: - _url = f'{data["url"]}?v=10&encoding=json' + _url = f'{data["url"]}?v=10&encoding=json&compress=zlib-stream' except TypeError: # seen a few times - _url = "wss://gateway.discord.gg?v=10&encoding=json" + _url = "wss://gateway.discord.gg?v=10&encoding=json&compress=zlib-stream" return data["shards"], _url async def login(self) -> Optional[dict]: diff --git a/interactions/api/http/guild.py b/interactions/api/http/guild.py index 816f3694d..b085dcfd7 100644 --- a/interactions/api/http/guild.py +++ b/interactions/api/http/guild.py @@ -473,7 +473,7 @@ async def create_guild_ban( self, guild_id: int, user_id: int, - delete_message_days: Optional[int] = 0, + delete_message_seconds: Optional[int] = 0, reason: Optional[str] = None, ) -> None: """ @@ -481,13 +481,13 @@ async def create_guild_ban( :param guild_id: Guild ID snowflake :param user_id: User ID snowflake - :param delete_message_days: Number of days to delete messages, from 0 to 7. Defaults to 0 + :param delete_message_seconds: Number of seconds to delete messages for, between 0 and 604800. Default to 0 :param reason: Optional reason to ban. """ return await self._req.request( Route("PUT", f"/guilds/{guild_id}/bans/{user_id}"), - json={"delete_message_days": delete_message_days}, + json={"delete_message_seconds": delete_message_seconds}, reason=reason, ) @@ -601,6 +601,32 @@ async def remove_guild_member( Route("DELETE", f"/guilds/{guild_id}/members/{user_id}"), reason=reason ) + async def begin_guild_prune( + self, + guild_id: int, + days: int = 7, + compute_prune_count: bool = True, + include_roles: Optional[List[int]] = None, + ) -> dict: + """ + Begins a prune operation. + + :param guild_id: Guild ID snowflake + :param days: Number of days to count, minimum 1, maximum 30. Defaults to 7. + :param compute_prune_count: Whether the returned "pruned" dict contains the computed prune count or None. + :param include_roles: Role IDs to include, if given. + :return: A dict containing `{"pruned": int}` or `{"pruned": None}` + """ + + payload = { + "days": days, + "compute_prune_count": compute_prune_count, + } + if include_roles: + payload["include_roles"] = ", ".join(str(x) for x in include_roles) + + return await self._req.request(Route("POST", f"/guilds/{guild_id}/prune"), json=payload) + async def get_guild_prune_count( self, guild_id: int, days: int = 7, include_roles: Optional[List[int]] = None ) -> dict: @@ -608,7 +634,7 @@ async def get_guild_prune_count( Retrieves a dict from an API that results in how many members would be pruned given the amount of days. :param guild_id: Guild ID snowflake. - :param days: Number of days to count. Defaults to ``7``. + :param days: Number of days to count, minimum 1, maximum 30. Defaults to 7. :param include_roles: Role IDs to include, if given. :return: A dict denoting `{"pruned": int}` """ diff --git a/interactions/api/http/limiter.py b/interactions/api/http/limiter.py index 7b2f3f334..dc2e174e5 100644 --- a/interactions/api/http/limiter.py +++ b/interactions/api/http/limiter.py @@ -1,7 +1,7 @@ from asyncio import Lock from typing import Optional -from ..models.attrs_utils import MISSING +from ...utils.missing import MISSING __all__ = ("Limiter",) diff --git a/interactions/api/http/member.py b/interactions/api/http/member.py index 493c82613..49ed9026e 100644 --- a/interactions/api/http/member.py +++ b/interactions/api/http/member.py @@ -35,7 +35,7 @@ async def get_member(self, guild_id: int, member_id: int) -> Optional[dict]: ) ) - member = Member(**res, _client=self) + member = Member(**res, _client=self, guild_id=Snowflake(guild_id)) guild = self.cache[Guild].get(Snowflake(guild_id)) if guild.members is None: guild.members = [member] @@ -68,9 +68,13 @@ async def get_list_of_members( res = await self._req.request(Route("GET", f"/guilds/{guild_id}/members"), params=payload) guild = self.cache[Guild].get(Snowflake(guild_id)) if guild.members is None: - guild.members = [Member(**_res, _client=self) for _res in res] + guild.members = [ + Member(**_res, _client=self, guild_id=Snowflake(guild_id)) for _res in res + ] else: - for member in [Member(**_res, _client=self) for _res in res]: + for member in [ + Member(**_res, _client=self, guild_id=Snowflake(guild_id)) for _res in res + ]: for index, _member in enumerate(guild.members): if _member.id == member.id: guild.members[index] = member diff --git a/interactions/api/http/message.py b/interactions/api/http/message.py index 1a2e9b369..30f4abaae 100644 --- a/interactions/api/http/message.py +++ b/interactions/api/http/message.py @@ -3,9 +3,9 @@ from aiohttp import MultipartWriter from ...api.cache import Cache -from ..models.attrs_utils import MISSING -from ..models.message import Embed, Message, MessageInteraction, Sticker -from ..models.misc import File, Snowflake +from ...utils.missing import MISSING +from ..models.message import Embed, Message, Sticker +from ..models.misc import AllowedMentions, File, Snowflake from .request import _Request from .route import Route @@ -26,7 +26,7 @@ async def send_message( tts: bool = False, embeds: Optional[List[Embed]] = None, nonce: Union[int, str] = None, - allowed_mentions: Optional[MessageInteraction] = None, # don't know type + allowed_mentions: Optional[Union[AllowedMentions, dict]] = None, message_reference: Optional[Message] = None, stickers: Optional[List[Sticker]] = None, ) -> dict: @@ -49,7 +49,11 @@ async def send_message( payload["nonce"] = nonce if allowed_mentions: - payload["allowed_mentions"] = allowed_mentions + payload["allowed_mentions"] = ( + allowed_mentions._json + if isinstance(allowed_mentions, AllowedMentions) + else allowed_mentions + ) if message_reference: payload["message_reference"] = message_reference diff --git a/interactions/api/http/request.py b/interactions/api/http/request.py index 8552ea4ee..39dc3d5d0 100644 --- a/interactions/api/http/request.py +++ b/interactions/api/http/request.py @@ -18,7 +18,6 @@ __all__ = ("_Request",) log: Logger = get_logger("http") -_session: ClientSession = ClientSession() class _Request: @@ -48,7 +47,6 @@ class _Request: ratelimits: Dict[str, Limiter] # bucket: Limiter buckets: Dict[str, str] # endpoint: shared_bucket _headers: dict - _session: ClientSession _global_lock: Limiter def __init__(self, token: str) -> None: @@ -69,7 +67,7 @@ def __init__(self, token: str) -> None: f"Python/{version_info[0]}.{version_info[1]} " f"aiohttp/{http_version}", } - self._session = _session + self._session = ClientSession() self._global_lock = ( Limiter(lock=Lock(loop=self._loop)) if version_info < (3, 10) else Limiter(lock=Lock()) ) diff --git a/interactions/api/http/scheduledEvent.py b/interactions/api/http/scheduledEvent.py index 2ed3d6917..2258474ba 100644 --- a/interactions/api/http/scheduledEvent.py +++ b/interactions/api/http/scheduledEvent.py @@ -1,7 +1,6 @@ from typing import List from ...api.cache import Cache -from ..models import Snowflake from .request import _Request from .route import Route @@ -16,7 +15,7 @@ class ScheduledEventRequest: def __init__(self) -> None: pass - async def create_scheduled_event(self, guild_id: Snowflake, payload: dict) -> dict: + async def create_scheduled_event(self, guild_id: int, payload: dict) -> dict: """ Creates a scheduled event. @@ -24,7 +23,6 @@ async def create_scheduled_event(self, guild_id: Snowflake, payload: dict) -> di :param payload: The dictionary containing the parameters and values to edit the associated event. :return: A dictionary containing the new guild scheduled event object on success. """ - guild_id = int(guild_id) valid_keys = ( "channel_id", "name", @@ -42,50 +40,42 @@ async def create_scheduled_event(self, guild_id: Snowflake, payload: dict) -> di ) async def get_scheduled_event( - self, guild_id: Snowflake, guild_scheduled_event_id: Snowflake, with_user_count: bool + self, guild_id: int, guild_scheduled_event_id: int, with_user_count: bool ) -> dict: """ Gets a guild scheduled event. :param guild_id: Guild ID snowflake. :param guild_scheduled_event_id: Guild Scheduled Event ID snowflake. - :param with_user_count: A boolean to include number of users subscribed to the associated event, if given. + :param with_user_count: Whether the number of users subscribed to the events is returned. :return: A dictionary containing the guild scheduled event object on success. """ - guild_id, event_id = int(guild_id), int(guild_scheduled_event_id) - params = {} - if with_user_count: - params["with_user_count"] = str(with_user_count) return await self._req.request( Route( "GET", "/guilds/{guild_id}/scheduled-events/{event_id}", guild_id=guild_id, - event_id=event_id, + event_id=guild_scheduled_event_id, ), - params=params, + params={"with_user_count": str(with_user_count).lower()}, ) - async def get_scheduled_events(self, guild_id: Snowflake, with_user_count: bool) -> List[dict]: + async def get_scheduled_events(self, guild_id: int, with_user_count: bool) -> List[dict]: """ Gets all guild scheduled events in a guild. :param guild_id: Guild ID snowflake. - :param with_user_count: A boolean to include number of users subscribed to the associated event, if given. + :param with_user_count: Whether the number of users subscribed to the associated event is returned. :return: A List of a dictionary containing the guild scheduled event objects on success. """ - guild_id = int(guild_id) - params = {} - if with_user_count: - params["with_user_count"] = with_user_count - return await self._req.request( - Route("GET", "/guilds/{guild_id}/scheduled-events", guild_id=guild_id), params=params + Route("GET", "/guilds/{guild_id}/scheduled-events", guild_id=guild_id), + params={"with_user_count": str(with_user_count).lower()}, ) async def modify_scheduled_event( - self, guild_id: Snowflake, guild_scheduled_event_id: Snowflake, payload: dict + self, guild_id: int, guild_scheduled_event_id: int, payload: dict ) -> dict: """ Modifies a scheduled event. @@ -95,7 +85,6 @@ async def modify_scheduled_event( :param payload: The dictionary containing the parameters and values to edit the associated event. :return: A dictionary containing the updated guild scheduled event object on success. """ - guild_id, event_id = int(guild_id), int(guild_scheduled_event_id) valid_keys = ( "channel_id", "name", @@ -112,14 +101,12 @@ async def modify_scheduled_event( "PATCH", "/guilds/{guild_id}/scheduled-events/{event_id}", guild_id=guild_id, - event_id=event_id, + event_id=guild_scheduled_event_id, ), json=data, ) - async def delete_scheduled_event( - self, guild_id: Snowflake, guild_scheduled_event_id: Snowflake - ) -> None: + async def delete_scheduled_event(self, guild_id: int, guild_scheduled_event_id: int) -> None: """ Deletes a guild scheduled event. @@ -127,25 +114,24 @@ async def delete_scheduled_event( :param guild_scheduled_event_id: Guild Scheduled Event ID snowflake. :return: Nothing on success. """ - guild_id, event_id = int(guild_id), int(guild_scheduled_event_id) return await self._req.request( Route( "DELETE", "/guilds/{guild_id}/scheduled-events/{event_id}", guild_id=guild_id, - event_id=event_id, + event_id=guild_scheduled_event_id, ) ) async def get_scheduled_event_users( self, - guild_id: Snowflake, - guild_scheduled_event_id: Snowflake, + guild_id: int, + guild_scheduled_event_id: int, limit: int = 100, with_member: bool = False, - before: Snowflake = None, - after: Snowflake = None, + before: int = None, + after: int = None, ) -> dict: """ Get the registered users of a scheduled event. @@ -158,22 +144,21 @@ async def get_scheduled_event_users( :param after: Considers only users after given user ID snowflake. Defaults to None. :return: Returns a list of guild scheduled event user objects on success. """ - guild_id, event_id = int(guild_id), int(guild_scheduled_event_id) params = { "limit": limit, "with_member": with_member, } if before: - params["before"] = int(before) + params["before"] = before if after: - params["after"] = int(after) + params["after"] = after return await self._req.request( Route( "GET", "/guilds/{guild_id}/scheduled-events/{event_id}/users", guild_id=guild_id, - event_id=event_id, + event_id=guild_scheduled_event_id, ), params=params, ) diff --git a/interactions/api/http/sticker.py b/interactions/api/http/sticker.py index 34b69323c..c1c013fc9 100644 --- a/interactions/api/http/sticker.py +++ b/interactions/api/http/sticker.py @@ -3,6 +3,7 @@ from aiohttp import FormData from ...api.cache import Cache +from ..models.misc import File from .request import _Request from .route import Route @@ -54,18 +55,24 @@ async def get_guild_sticker(self, guild_id: int, sticker_id: int) -> dict: return await self._req.request(Route("GET", f"/guilds/{guild_id}/stickers/{sticker_id}")) async def create_guild_sticker( - self, payload: FormData, guild_id: int, reason: Optional[str] = None + self, payload: dict, file: File, guild_id: int, reason: Optional[str] = None ) -> dict: """ Create a new sticker for the guild. Requires the MANAGE_EMOJIS_AND_STICKERS permission. - :param payload: the payload to send. + :param payload: The payload to send. + :param file: The file to send. :param guild_id: The guild to create sticker at. :param reason: The reason for this action. :return: The new sticker data on success. """ + data = FormData() + data.add_field("file", file._fp, filename=file._filename) + for key, value in payload.items(): + data.add_field(key, value) + return await self._req.request( - Route("POST", f"/guilds/{guild_id}/stickers"), json=payload, reason=reason + Route("POST", f"/guilds/{guild_id}/stickers"), data=data, reason=reason ) async def modify_guild_sticker( diff --git a/interactions/api/http/thread.py b/interactions/api/http/thread.py index 6523e187c..a56dcf1d2 100644 --- a/interactions/api/http/thread.py +++ b/interactions/api/http/thread.py @@ -1,7 +1,11 @@ from typing import Dict, List, Optional +from aiohttp import MultipartWriter + from ...api.cache import Cache +from ...utils.missing import MISSING from ..models.channel import Channel +from ..models.misc import File from .request import _Request from .route import Route @@ -189,3 +193,62 @@ async def create_thread( self.cache[Channel].add(Channel(**request)) return request + + async def create_thread_in_forum( + self, + channel_id: int, + name: str, + auto_archive_duration: int, + message: dict, + applied_tags: List[str] = None, + files: Optional[List[File]] = MISSING, + rate_limit_per_user: Optional[int] = None, + reason: Optional[str] = None, + ) -> dict: + """ + From a given Forum channel, create a Thread with a message to start with. + + :param channel_id: The ID of the channel to create this thread in + :param name: The name of the thread + :param auto_archive_duration: duration in minutes to automatically archive the thread after recent activity, + can be set to: 60, 1440, 4320, 10080 + :param message_payload: The payload/dictionary contents of the first message in the forum thread. + :param applied_tags: List of tag ids that can be applied to the forum, if any. + :param files: An optional list of files to send attached to the message. + :param rate_limit_per_user: Seconds a user has to wait before sending another message (0 to 21600), if given. + :param reason: An optional reason for the audit log + :return: Returns a Thread in a Forum object with a starting Message. + """ + query = {"use_nested_fields": 1} + + payload = {"name": name, "auto_archive_duration": auto_archive_duration, "message": message} + if rate_limit_per_user: + payload["rate_limit_per_user"] = rate_limit_per_user + if applied_tags: + payload["applied_tags"] = applied_tags + + data = None + if files is not MISSING and files and len(files) > 0: # edge case `None` + + data = MultipartWriter("form-data") + part = data.append_json(payload) + part.set_content_disposition("form-data", name="payload_json") + payload = None + + for id, file in enumerate(files): + part = data.append( + file._fp, + ) + part.set_content_disposition( + "form-data", name=f"files[{str(id)}]", filename=file._filename + ) + else: + payload.update(message) + + return await self._req.request( + Route("POST", f"/channels/{channel_id}/threads"), + json=payload, + data=data, + params=query, + reason=reason, + ) diff --git a/interactions/api/http/webhook.py b/interactions/api/http/webhook.py index e6dbd793c..467c83f39 100644 --- a/interactions/api/http/webhook.py +++ b/interactions/api/http/webhook.py @@ -3,7 +3,7 @@ from aiohttp import MultipartWriter from ...api.cache import Cache -from ..models.attrs_utils import MISSING +from ...utils.missing import MISSING from ..models.misc import File from .request import _Request from .route import Route diff --git a/interactions/api/models/__init__.py b/interactions/api/models/__init__.py index 72dcb63c7..6cf9987d1 100644 --- a/interactions/api/models/__init__.py +++ b/interactions/api/models/__init__.py @@ -5,7 +5,6 @@ and stores all of the data defining models for dispatched Gateway events. """ -from .attrs_utils import * # noqa: F401 F403 from .audit_log import * # noqa: F401 F403 from .channel import * # noqa: F401 F403 from .emoji import * # noqa: F401 F403 diff --git a/interactions/api/models/audit_log.py b/interactions/api/models/audit_log.py index 20f01dd78..a94827d05 100644 --- a/interactions/api/models/audit_log.py +++ b/interactions/api/models/audit_log.py @@ -1,7 +1,7 @@ from enum import IntEnum from typing import TYPE_CHECKING, List, Optional, TypeVar -from .attrs_utils import DictSerializerMixin, convert_list, define, field +from ...utils.attrs_utils import DictSerializerMixin, convert_list, define, field from .channel import Channel from .misc import Snowflake from .user import User @@ -79,6 +79,8 @@ class AuditLogEvents(IntEnum): :ivar int AUTO_MODERATION_RULE_UPDATE: 141 - Auto Moderation rule was updated :ivar int AUTO_MODERATION_RULE_DELETE: 142 - Auto Moderation rule was deleted :ivar int AUTO_MODERATION_BLOCK_MESSAGE: 143 - Message was blocked by AutoMod (according to a rule) + :ivar int AUTO_MODERATION_FLAG_TO_CHANNEL: 144 - Message was flagged by AutoMod (according to a rule) + :ivar int AUTO_MODERATION_USER_COMMUNICATION_DISABLED: 145 - Member was timed out by AutoMod (according to a rule) """ # guild related @@ -162,6 +164,8 @@ class AuditLogEvents(IntEnum): AUTO_MODERATION_RULE_UPDATE = 141 AUTO_MODERATION_RULE_DELETE = 142 AUTO_MODERATION_BLOCK_MESSAGE = 143 + AUTO_MODERATION_FLAG_TO_CHANNEL = 144 + AUTO_MODERATION_USER_COMMUNICATION_DISABLED = 145 @define() @@ -186,6 +190,8 @@ class OptionalAuditEntryInfo(DictSerializerMixin): :ivar Snowflake application_id: ID of the app whose permissions were targeted. ``AuditLogEvents``-type: 121 :ivar Snowflake channel_id: Channel in which the entities were targeted. ``AuditLogEvents``-types: 26, 74, 75, 72, 83, 84, 85 + :ivar str auto_moderation_rule_name: Name of the Auto Moderation rule that was triggered. ``AuditLogEvents``-types: 143, 144, 145 + :ivar str auto_moderation_rule_trigger_type: Trigger type of the Auto Moderation rule that was triggered. ``AuditLogEvents``-types: 143, 144, 145 :ivar str count: Number of entities that were targeted. ``AuditLogEvents``-types: 72, 73, 27, 26 :ivar str delete_member_days: Number of days after which inactive members were kicked. ``AuditLogEvents``-types: 21 :ivar Snowflake id: ID of the overwritten entity. ``AuditLogEvents``-types: 13, 14, 15 @@ -197,6 +203,8 @@ class OptionalAuditEntryInfo(DictSerializerMixin): application_id: Snowflake = field(converter=Snowflake) channel_id: Snowflake = field(converter=Snowflake) + auto_moderation_rule_name: str = field() + auto_moderation_rule_trigger_type: str = field() count: str = field() delete_member_days: str = field() id: Snowflake = field(converter=Snowflake) diff --git a/interactions/api/models/channel.py b/interactions/api/models/channel.py index e943a7c92..4c5144efa 100644 --- a/interactions/api/models/channel.py +++ b/interactions/api/models/channel.py @@ -1,26 +1,34 @@ +from asyncio import Task, create_task, get_running_loop, sleep from datetime import datetime, timedelta, timezone from enum import IntEnum -from typing import TYPE_CHECKING, Any, Callable, List, Optional, Union - -from ..error import LibraryException -from .attrs_utils import ( - MISSING, +from inspect import isawaitable +from math import inf +from typing import TYPE_CHECKING, Any, Awaitable, Callable, ContextManager, List, Optional, Union +from warnings import warn + +from ...utils.abc.base_context_managers import BaseAsyncContextManager +from ...utils.abc.base_iterators import DiscordPaginationIterator +from ...utils.attrs_utils import ( ClientSerializerMixin, DictSerializerMixin, convert_list, define, field, ) +from ...utils.missing import MISSING +from ..error import LibraryException +from .emoji import Emoji from .flags import Permissions -from .misc import File, IDMixin, Overwrite, Snowflake +from .misc import AllowedMentions, File, IDMixin, Overwrite, Snowflake from .user import User from .webhook import Webhook if TYPE_CHECKING: from ...client.models.component import ActionRow, Button, SelectMenu + from ..http.client import HTTPClient from .guild import Invite, InviteTargetType from .member import Member - from .message import Attachment, Embed, Message, MessageInteraction, Sticker + from .message import Attachment, Embed, Message, Sticker __all__ = ( "ChannelType", @@ -28,6 +36,9 @@ "Channel", "ThreadMember", "ThreadMetadata", + "AsyncHistoryIterator", + "AsyncTypingContextManager", + "Tags", ) @@ -39,12 +50,13 @@ class ChannelType(IntEnum): GUILD_VOICE = 2 GROUP_DM = 3 GUILD_CATEGORY = 4 - GUILD_NEWS = 5 + GUILD_ANNOUNCEMENT = 5 GUILD_STORE = 6 - GUILD_NEWS_THREAD = 10 - GUILD_PUBLIC_THREAD = 11 - GUILD_PRIVATE_THREAD = 12 + ANNOUNCEMENT_THREAD = 10 + PUBLIC_THREAD = 11 + PRIVATE_THREAD = 12 GUILD_STAGE_VOICE = 13 + GUILD_DIRECTORY = 14 GUILD_FORUM = 15 @@ -66,7 +78,7 @@ class ThreadMetadata(DictSerializerMixin): archived: bool = field() auto_archive_duration: int = field() - archive_timestamp: datetime.timestamp = field(converter=datetime.fromisoformat) + archive_timestamp: datetime = field(converter=datetime.fromisoformat, repr=False) locked: bool = field() invitable: Optional[bool] = field(default=None) @@ -87,12 +99,282 @@ class ThreadMember(ClientSerializerMixin): :ivar bool muted: Whether the member is muted or not. """ - id: Optional[Snowflake] = field(converter=Snowflake, default=None) + id: Optional[Snowflake] = field(converter=Snowflake, default=None, repr=False) user_id: Optional[Snowflake] = field(converter=Snowflake, default=None) - join_timestamp: datetime.timestamp = field(converter=datetime.fromisoformat) - flags: int = field() + join_timestamp: datetime = field(converter=datetime.fromisoformat, repr=False) + flags: int = field(repr=False) muted: bool = field() - mute_config: Optional[Any] = field(default=None) # todo explore this, it isn't in the ddev docs + mute_config: Optional[Any] = field( + default=None, repr=False + ) # todo explore this, it isn't in the ddev docs + + +class AsyncHistoryIterator(DiscordPaginationIterator): + """ + A class object that allows iterating through a channel's history. + + :param _client: The HTTPClient of the bot + :type _client: HTTPClient + :param obj: The channel to get the history from + :type obj: Union[int, str, Snowflake, Channel] + :param start_at?: The message to begin getting the history from + :type start_at?: Optional[Union[int, str, Snowflake, Message]] + :param reverse?: Whether to only get newer message. Default False + :type reverse?: Optional[bool] + :param check?: A check to ignore certain messages + :type check?: Optional[Callable[[Member], bool]] + :param maximum?: A set maximum of messages to get before stopping the iteration + :type maximum?: Optional[int] + """ + + def __init__( + self, + _client: "HTTPClient", + obj: Union[int, str, Snowflake, "Channel"], + maximum: Optional[int] = inf, + start_at: Optional[Union[int, str, Snowflake, "Message"]] = MISSING, + check: Optional[Callable[["Message"], bool]] = None, + reverse: Optional[bool] = False, + ): + super().__init__(obj, _client, maximum=maximum, start_at=start_at, check=check) + + from .message import Message + + if reverse and start_at is MISSING: + raise LibraryException( + code=12, + message="A message to start from is required to go through the channel in reverse.", + ) + + if reverse: + self.before = MISSING + self.after = self.start_at + else: + self.before = self.start_at + self.after = MISSING + + self.objects: Optional[List[Message]] + + async def get_first_objects(self) -> None: + from .message import Message + + limit = min(self.maximum, 100) + + if self.maximum == limit: + self.__stop = True + + if self.after is not MISSING: + msgs = await self._client.get_channel_messages( + channel_id=self.object_id, after=self.after, limit=limit + ) + msgs.reverse() + self.after = int(msgs[-1]["id"]) + else: + msgs = await self._client.get_channel_messages( + channel_id=self.object_id, before=self.before, limit=limit + ) + self.before = int(msgs[-1]["id"]) + + if len(msgs) < 100: + # already all messages resolved with one operation + self.__stop = True + + self.object_count += limit + + self.objects = [Message(**msg, _client=self._client) for msg in msgs] + + async def flatten(self) -> List["Message"]: + """returns all remaining items as list""" + return [item async for item in self] + + async def get_objects(self) -> None: + from .message import Message + + limit = min(50, self.maximum - self.object_count) + + if self.after is not MISSING: + msgs = await self._client.get_channel_messages( + channel_id=self.object_id, after=self.after, limit=limit + ) + msgs.reverse() + self.after = int(msgs[-1]["id"]) + else: + msgs = await self._client.get_channel_messages( + channel_id=self.object_id, before=self.before, limit=limit + ) + self.before = int(msgs[-1]["id"]) + + if len(msgs) < limit or limit == self.maximum - self.object_count: + # end of messages reached again + self.__stop = True + + self.object_count += limit + + self.objects.extend([Message(**msg, _client=self._client) for msg in msgs]) + + async def __anext__(self) -> "Message": + if self.objects is None: + await self.get_first_objects() + + try: + obj = self.objects.pop(0) + + if self.check: + + res = self.check(obj) + _res = await res if isawaitable(res) else res + while not _res: + if ( + not self.__stop + and len(self.objects) < 5 + and self.object_count >= self.maximum + ): + await self.get_objects() + + self.object_count -= 1 + obj = self.objects.pop(0) + + _res = self.check(obj) + + if not self.__stop and len(self.objects) < 5 and self.object_count <= self.maximum: + await self.get_objects() + except IndexError: + raise StopAsyncIteration + else: + return obj + + +class AsyncTypingContextManager(BaseAsyncContextManager): + """ + An async context manager for triggering typing. + + :param obj: The channel to trigger typing in. + :type obj: Union[int, str, Snowflake, Channel] + :param _client: The HTTPClient of the bot + :type _client: HTTPClient + """ + + def __init__( + self, + obj: Union[int, str, "Snowflake", "Channel"], + _client: "HTTPClient", + ): + + try: + self.loop = get_running_loop() + except RuntimeError as e: + raise RuntimeError("No running event loop detected!") from e + + self.object_id = None if not obj else int(obj) if not hasattr(obj, "id") else int(obj.id) + self._client = _client + self.__task: Optional[Task] = None + + def __await__(self): + return self._client.trigger_typing(self.object_id).__await__() + + async def do_action(self): + while True: + await self._client.trigger_typing(self.object_id) + await sleep(8) + + async def __aenter__(self): + self.__task = create_task(self.do_action()) + + async def __aexit__(self, exc_type, exc_val, exc_tb): + self.__task.cancel() + + +@define() +class Tags(ClientSerializerMixin): # helpers, hehe :D + """ + An object denoting a tag object within a forum channel. + + .. note:: + If the emoji is custom, it won't have name information. + + :ivar str name: Name of the tag. The limit is up to 20 characters. + :ivar int id: ID of the tag. Can also be 0 if manually created. + :ivar bool moderated: A boolean denoting whether this tag can be removed/added by moderators with ``manage_threads`` permissions. + :ivar Optional[Emoji] emoji?: The emoji to represent the tag, if any. + + """ + + # TODO: Rename these to discord-docs + name: str = field() + id: int = field() + moderated: bool = field() + emoji: Optional[Emoji] = field(converter=Emoji, default=None) + + # Maybe on post_attrs_init replace emoji object with one from cache for name population? + + async def delete( + self, channel_id: Union[int, str, Snowflake, "Channel"] # discord, why :hollow: + ) -> None: + """ + Deletes this tag + + :param channel_id: The ID of the channel where the tag belongs to + :type channel_id: Union[int, str, Snowflake, Channel] + """ + if isinstance(channel_id, Channel) and channel_id.type != ChannelType.GUILD_FORUM: + raise LibraryException(code=14, message="Can only manage tags on a forum channel") + + if not self._client: + raise LibraryException(code=13) + + _channel_id = int(channel_id.id) if isinstance(channel_id, Channel) else int(channel_id) + + return await self._client.delete_tag(_channel_id, int(self.id)) + + async def edit( + self, + channel_id: Union[int, str, Snowflake, "Channel"], # discord, why :hollow: + name: str, + emoji_name: Optional[str] = MISSING, + emoji_id: Optional[int] = MISSING, + ) -> "Tags": + """ + Edits this tag + + .. note:: + Can either have an emoji_id or an emoji_name, but not both. + emoji_id is meant for custom emojis, emoji_name is meant for unicode emojis. + + :param channel_id: The ID of the channel where the tag belongs to + :type channel_id: Union[int, str, Snowflake, Channel] + :param name: The new name of the tag + :type name: str + :param emoji_id: The ID of the emoji to use for the tag + :type emoji_id: Optional[int] + :param emoji_name: The name of the emoji to use for the tag + :type emoji_name: Optional[int] + :return: The modified tag + :rtype: Tags + """ + + if isinstance(channel_id, Channel) and channel_id.type != ChannelType.GUILD_FORUM: + raise LibraryException(code=14, message="Can only manage tags on a forum channel") + + if not self._client: + raise LibraryException(code=13) + + _channel_id = int(channel_id.id) if isinstance(channel_id, Channel) else int(channel_id) + + payload = {"name": name} + + if emoji_id is not MISSING and emoji_id and emoji_name and emoji_name is not MISSING: + raise LibraryException( + code=12, message="emoji_id and emoji_name are mutually exclusive" + ) + + if emoji_id is not MISSING: + payload["emoji_id"] = emoji_id + if emoji_name is not MISSING: + payload["emoji_name"] = emoji_name + + data = await self._client.edit_tag(_channel_id, int(self.id), **payload) + + return Tags(**data) @define() @@ -126,14 +408,20 @@ class Channel(ClientSerializerMixin, IDMixin): :ivar Optional[int] video_quality_mode?: The set quality mode for video streaming in the channel. :ivar int message_count: The amount of messages in the channel. :ivar Optional[int] member_count?: The amount of members in the channel. + :ivar Optional[bool] newly_created?: Boolean representing if a thread is created. :ivar Optional[ThreadMetadata] thread_metadata?: The thread metadata of the channel. :ivar Optional[ThreadMember] member?: The member of the thread in the channel. :ivar Optional[int] default_auto_archive_duration?: The set auto-archive time for all threads to naturally follow in the channel. :ivar Optional[str] permissions?: The permissions of the channel. :ivar Optional[int] flags?: The flags of the channel. :ivar Optional[int] total_message_sent?: Number of messages ever sent in a thread. + :ivar Optional[int] default_thread_slowmode_delay?: The default slowmode delay in seconds for threads, if this channel is a forum. + :ivar Optional[List[Tags]] available_tags: Tags in a forum channel, if any. + :ivar Optional[Emoji] default_reaction_emoji: Default reaction emoji for threads created in a forum, if any. """ + # Template attribute isn't live/documented, this line exists as a placeholder 'TODO' of sorts + __slots__ = ( # TODO: Document banner when Discord officially documents them. "banner", @@ -150,26 +438,36 @@ class Channel(ClientSerializerMixin, IDMixin): name: str = field(factory=str) topic: Optional[str] = field(default=None) nsfw: Optional[bool] = field(default=None) - last_message_id: Optional[Snowflake] = field(converter=Snowflake, default=None) - bitrate: Optional[int] = field(default=None) + last_message_id: Optional[Snowflake] = field(converter=Snowflake, default=None, repr=False) + bitrate: Optional[int] = field(default=None, repr=False) user_limit: Optional[int] = field(default=None) rate_limit_per_user: Optional[int] = field(default=None) - recipients: Optional[List[User]] = field(converter=convert_list(User), default=None) - icon: Optional[str] = field(default=None) + recipients: Optional[List[User]] = field(converter=convert_list(User), default=None, repr=False) + icon: Optional[str] = field(default=None, repr=False) owner_id: Optional[Snowflake] = field(converter=Snowflake, default=None) - application_id: Optional[Snowflake] = field(converter=Snowflake, default=None) + application_id: Optional[Snowflake] = field(converter=Snowflake, default=None, repr=False) parent_id: Optional[Snowflake] = field(converter=Snowflake, default=None) - last_pin_timestamp: Optional[datetime] = field(converter=datetime.fromisoformat, default=None) - rtc_region: Optional[str] = field(default=None) - video_quality_mode: Optional[int] = field(default=None) - message_count: Optional[int] = field(default=None) - member_count: Optional[int] = field(default=None) + last_pin_timestamp: Optional[datetime] = field( + converter=datetime.fromisoformat, default=None, repr=False + ) + rtc_region: Optional[str] = field(default=None, repr=False) + video_quality_mode: Optional[int] = field(default=None, repr=False) + message_count: Optional[int] = field(default=None, repr=False) + member_count: Optional[int] = field(default=None, repr=False) + newly_created: Optional[int] = field(default=None, repr=False) thread_metadata: Optional[ThreadMetadata] = field(converter=ThreadMetadata, default=None) - member: Optional[ThreadMember] = field(converter=ThreadMember, default=None, add_client=True) + member: Optional[ThreadMember] = field( + converter=ThreadMember, default=None, add_client=True, repr=False + ) default_auto_archive_duration: Optional[int] = field(default=None) - permissions: Optional[str] = field(default=None) - flags: Optional[int] = field(default=None) - total_message_sent: Optional[int] = field(default=None) + permissions: Optional[str] = field(default=None, repr=False) + flags: Optional[int] = field(default=None, repr=False) + total_message_sent: Optional[int] = field(default=None, repr=False) + default_thread_slowmode_delay: Optional[int] = field(default=None, repr=False) + available_tags: Optional[List[Tags]] = field( + converter=convert_list(Tags), default=None, add_client=True + ) # eh? + default_reaction_emoji: Optional[Emoji] = field(converter=Emoji, default=None) def __attrs_post_init__(self): # sourcery skip: last-if-guard if self._client: @@ -180,6 +478,16 @@ def __attrs_post_init__(self): # sourcery skip: last-if-guard def __repr__(self) -> str: return self.name + @property + def typing(self) -> Union[Awaitable, ContextManager]: + """ + Manages the typing of the channel. Use with `await` or `async with` + + :return: A manager for typing + :rtype: AsyncTypingContextManager + """ + return AsyncTypingContextManager(self, self._client) + @property def mention(self) -> str: """ @@ -190,6 +498,33 @@ def mention(self) -> str: """ return f"<#{self.id}>" + def history( + self, + start_at: Optional[Union[int, str, Snowflake, "Message"]] = MISSING, + reverse: Optional[bool] = False, + maximum: Optional[int] = inf, + check: Optional[Callable[["Message"], bool]] = None, + ) -> AsyncHistoryIterator: + """ + :param start_at?: The message to begin getting the history from + :type start_at?: Optional[Union[int, str, Snowflake, Message]] + :param reverse?: Whether to only get newer message. Default False + :type reverse?: Optional[bool] + :param maximum?: A set maximum of messages to get before stopping the iteration + :type maximum?: Optional[int] + :param check?: A custom check to ignore certain messages + :type check?: Optional[Callable[[Message], bool]] + + :return: An asynchronous iterator over the history of the channel + :rtype: AsyncHistoryIterator + """ + if not self._client: + raise LibraryException(code=13) + + return AsyncHistoryIterator( + self._client, self, start_at=start_at, reverse=reverse, maximum=maximum, check=check + ) + async def send( self, content: Optional[str] = MISSING, @@ -198,7 +533,7 @@ async def send( attachments: Optional[List["Attachment"]] = MISSING, files: Optional[Union[File, List[File]]] = MISSING, embeds: Optional[Union["Embed", List["Embed"]]] = MISSING, - allowed_mentions: Optional["MessageInteraction"] = MISSING, + allowed_mentions: Optional[Union[AllowedMentions, dict]] = MISSING, stickers: Optional[List["Sticker"]] = MISSING, components: Optional[ Union[ @@ -224,8 +559,8 @@ async def send( :type attachments?: Optional[List[Attachment]] :param embeds?: An embed, or list of embeds for the message. :type embeds?: Optional[Union[Embed, List[Embed]]] - :param allowed_mentions?: The message interactions/mention limits that the message can refer to. - :type allowed_mentions?: Optional[MessageInteraction] + :param allowed_mentions?: The allowed mentions for the message. + :type allowed_mentions?: Optional[Union[AllowedMentions, dict]] :param stickers?: A list of stickers to send with your message. You can send up to 3 stickers per message. :type stickers?: Optional[List[Sticker]] :param components?: A component, or list of components for the message. @@ -233,6 +568,10 @@ async def send( :return: The sent message as an object. :rtype: Message """ + + if self.type == ChannelType.GUILD_FORUM: + raise LibraryException(code=14, message="Cannot message a forum channel!") + if not self._client: raise LibraryException(code=13) from ...client.models.component import _build_components @@ -241,7 +580,13 @@ async def send( _content: str = "" if content is MISSING else content _tts: bool = False if tts is MISSING else tts _attachments = [] if attachments is MISSING else [a._json for a in attachments] - _allowed_mentions: dict = {} if allowed_mentions is MISSING else allowed_mentions + _allowed_mentions: dict = ( + {} + if allowed_mentions is MISSING + else allowed_mentions._json + if isinstance(allowed_mentions, AllowedMentions) + else allowed_mentions + ) _sticker_ids: list = ( [] if stickers is MISSING else [str(sticker.id) for sticker in stickers] ) @@ -966,7 +1311,7 @@ def check_pinned(message): async def create_thread( self, name: str, - type: Optional[ChannelType] = ChannelType.GUILD_PUBLIC_THREAD, + type: Optional[ChannelType] = ChannelType.PUBLIC_THREAD, auto_archive_duration: Optional[int] = MISSING, invitable: Optional[bool] = MISSING, message_id: Optional[Union[int, Snowflake, "Message"]] = MISSING, # noqa @@ -994,9 +1339,9 @@ async def create_thread( if not self._client: raise LibraryException(code=13) if type not in [ - ChannelType.GUILD_NEWS_THREAD, - ChannelType.GUILD_PUBLIC_THREAD, - ChannelType.GUILD_PRIVATE_THREAD, + ChannelType.ANNOUNCEMENT_THREAD, + ChannelType.PUBLIC_THREAD, + ChannelType.PRIVATE_THREAD, ]: raise LibraryException(message="type must be a thread type!", code=12) @@ -1116,6 +1461,10 @@ async def get_history(self, limit: int = 100) -> Optional[List["Message"]]: :rtype: List[Message] """ + warn( + "This method has been deprecated in favour of the 'history' method.", DeprecationWarning + ) + if not self._client: raise LibraryException(code=13) @@ -1208,6 +1557,266 @@ async def join(self) -> None: await self._client.join_thread(int(self.id)) + async def create_tag( + self, + name: str, + emoji_id: Optional[int] = MISSING, + emoji_name: Optional[str] = MISSING, + ) -> Tags: + """ + Create a new tag. + + .. note:: + Can either have an emoji_id or an emoji_name, but not both. + emoji_id is meant for custom emojis, emoji_name is meant for unicode emojis. + + :param name: The name of the tag + :type name: str + :param emoji_id: The ID of the emoji to use for the tag + :type emoji_id: Optional[int] + :param emoji_name: The name of the emoji to use for the tag + :type emoji_name: Optional[str] + :return: The create tag object + :rtype: Tags + """ + + if not self._client: + raise LibraryException(code=13) + + if self.type != ChannelType.GUILD_FORUM: + raise LibraryException(code=14, message="Tags can only be created in forum channels!") + + if emoji_id is not MISSING and emoji_id and emoji_name and emoji_name is not MISSING: + raise LibraryException( + code=12, message="emoji_id and emoji_name are mutually exclusive" + ) + + payload = {"name": name} + + if emoji_id is not MISSING: + payload["emoji_id"] = emoji_id + if emoji_name is not MISSING: + payload["emoji_name"] = emoji_name + + data = await self._client.create_tag(int(self.id), **payload) + + return Tags(**data) + + async def edit_tag( + self, + tag_id: Union[int, str, Snowflake, Tags], # discord, why :hollow: + name: str, + emoji_name: Optional[str] = MISSING, + emoji_id: Optional[int] = MISSING, + ) -> "Tags": + """ + Edits a tag + + .. note:: + Can either have an emoji_id or an emoji_name, but not both. + emoji_id is meant for custom emojis, emoji_name is meant for unicode emojis. + + :param tag_id: The ID of the tag to edit + :type tag_id: Union[int, str, Snowflake, Tag] + :param name: The new name of the tag + :type name: str + :param emoji_id: The ID of the emoji to use for the tag + :type emoji_id: Optional[int] + :param emoji_name: The name of the emoji to use for the tag + :type emoji_name: Optional[int] + :return: The modified tag + :rtype: Tags + """ + _tag_id = int(tag_id.id) if isinstance(tag_id, Tags) else int(tag_id) + + if emoji_id is not MISSING and emoji_id and emoji_name and emoji_name is not MISSING: + raise LibraryException( + code=12, message="emoji_id and emoji_name are mutually exclusive" + ) + + if self.type != ChannelType.GUILD_FORUM: + raise LibraryException(code=14, message="Tags can only be created in forum channels!") + + payload = {"name": name} + + if emoji_id is not MISSING: + payload["emoji_id"] = emoji_id + if emoji_name is not MISSING: + payload["emoji_name"] = emoji_name + + data = await self._client.edit_tag(int(self.id), _tag_id, **payload) + + return Tags(**data) + + async def delete_tag( + self, tag_id: Union[int, str, Snowflake, Tags] # discord, why :hollow: + ) -> None: + """ + Deletes a tag + + :param tag_id: The ID of the Tag + :type tag_id: Union[int, str, Snowflake, Tags] + """ + if self.type != ChannelType.GUILD_FORUM: + raise LibraryException(code=14, message="Tags can only be created in forum channels!") + + _tag_id = int(tag_id.id) if isinstance(tag_id, Tags) else int(tag_id) + + return await self._client.delete_tag(int(self.id), _tag_id) + + async def create_forum_post( + self, + name: str, + content: Union[ + dict, "Message", str, "Attachment", List["Attachment"] + ], # overkill but why not + auto_archive_duration: Optional[int] = MISSING, + applied_tags: Union[List[str], List[int], List[Tags], int, str, Tags] = MISSING, + files: Optional[List[File]] = MISSING, + rate_limit_per_user: Optional[int] = MISSING, + reason: Optional[str] = None, + ) -> "Channel": + """ + Creates a new post inside a forum channel + + :param name: The name of the thread + :type name: str + :param auto_archive_duration: duration in minutes to automatically archive the thread after recent activity, + can be set to: 60, 1440, 4320, 10080 + :type auto_archive_duration: Optional[int] + :param content: The content to send as first message. + :type content: Union[dict, "Message", str, "Attachment", List["Attachment"]] + :param applied_tags: Tags to give to the created thread + :type applied_tags: Union[List[str], List[int], List[Tags], int, str, Tags] + :param files: An optional list of files to send attached to the message. + :type files: Optional[List[File]] + :param rate_limit_per_user: Seconds a user has to wait before sending another message (0 to 21600), if given. + :type rate_limit_per_user: Optional[int] + :param reason: An optional reason for the audit log + :type reason: Optional[str] + :returns: A channel of ChannelType 11 (THREAD) + :rtype: Channel + """ + + if self.type != ChannelType.GUILD_FORUM: + raise LibraryException(code=14, message="Cannot create a post outside a forum channel") + + if not self._client: + raise LibraryException(code=13) + + from .message import Attachment + + _top_payload: dict = { + "name": name, + "reason": reason, + "rate_limit_per_user": rate_limit_per_user + if rate_limit_per_user is not MISSING + else None, + "auto_archive_duration": auto_archive_duration + if auto_archive_duration is not MISSING + else None, + } + + from .message import Message + + __files = [] if files is MISSING else files + + if isinstance(content, dict): # just assume they know what they're doing + _content = content + + elif isinstance(content, Message): + if content.attachments and any(attach.id is None for attach in content.attachments): + del content._json["attachments"] + + for attach in content.attachments: + _data = await attach.download() + + __files.append(File(attach.filename, _data)) + + if not __files or __files is MISSING: + _files = [] + elif isinstance(__files, list): + _files = [file._json_payload(id) for id, file in enumerate(__files)] + else: + _files = [__files._json_payload(0)] + __files = [__files] + + content._json["attachments"] = _files + + _content = content._json + + elif isinstance(content, Attachment): + if content.id: + _content: dict = {"attachments": [content._json]} + else: + data = await content.download() + + __files.append(File(content.name, data)) + + if not __files or __files is MISSING: + _files = [] + elif isinstance(__files, list): + _files = [file._json_payload(id) for id, file in enumerate(__files)] + else: + _files = [__files._json_payload(0)] + __files = [__files] + + _content: dict = {"attachments": [_files]} + + elif isinstance(content, list): + _content = {"attachments": []} + if any(not isinstance(item, Attachment) for item in content): + raise LibraryException(code=12) + + attach: Attachment + for attach in content: + if attach.id: + _content["attachments"].append(attach._json) + + else: + + _data = await attach.download() + + __files.append(File(attach.filename, _data)) + + if not __files or __files is MISSING: + _files = [] + elif isinstance(__files, list): + _files = [file._json_payload(id) for id, file in enumerate(__files)] + else: + _files = [__files._json_payload(0)] + __files = [__files] + + _content["attachments"].extend(_files) + + else: + _content: dict = {"content": content} + + _top_payload["files"] = __files + _top_payload["message"] = _content + + if applied_tags is not MISSING: + _tags = [] + if isinstance(applied_tags, list): + for tag in applied_tags: + if isinstance(tag, Tags): + _tags.append(str(tag.id)) + else: + _tags.append(str(tag)) + + elif isinstance(applied_tags, Tags): + _tags.append(str(applied_tags.id)) + else: + _tags.append(str(applied_tags)) + else: + applied_tags = [] + + _top_payload["applied_tags"] = applied_tags + + data = await self._client.create_thread_in_forum(int(self.id), **_top_payload) + + return Channel(**data) + async def get_permissions_for(self, member: "Member") -> Permissions: """ Returns the permissions of the member in this specific channel. @@ -1225,32 +1834,26 @@ async def get_permissions_for(self, member: "Member") -> Permissions: if not self.guild_id: return Permissions.DEFAULT - from .guild import Guild - - guild = Guild(**await self._client.get_guild(int(self.guild_id)), _client=self._client) + permissions = await member.get_guild_permissions(self.guild_id) - permissions = await member.get_guild_permissions(guild) - - if permissions & Permissions.ADMINISTRATOR == Permissions.ADMINISTRATOR: + if Permissions.ADMINISTRATOR in permissions: return Permissions.ALL # @everyone role overwrites - from ...client.models.utils import search_iterable + from interactions.utils.utils import search_iterable - overwrite_everyone = search_iterable( + if overwrite_everyone := search_iterable( self.permission_overwrites, lambda overwrite: int(overwrite.id) == int(self.guild_id) - ) - if overwrite_everyone: + ): permissions &= ~int(overwrite_everyone[0].deny) permissions |= int(overwrite_everyone[0].allow) # Apply role specific overwrites allow, deny = 0, 0 for role_id in member.roles: - overwrite_role = search_iterable( + if overwrite_role := search_iterable( self.permission_overwrites, lambda overwrite: int(overwrite.id) == int(role_id) - ) - if overwrite_role: + ): allow |= int(overwrite_role[0].allow) deny |= int(overwrite_role[0].deny) @@ -1260,10 +1863,9 @@ async def get_permissions_for(self, member: "Member") -> Permissions: permissions |= allow # Apply member specific overwrites - overwrite_member = search_iterable( + if overwrite_member := search_iterable( # sourcery self.permission_overwrites, lambda overwrite: int(overwrite.id) == int(member.id) - ) - if overwrite_member: + ): permissions &= ~int(overwrite_member[0].deny) permissions |= int(overwrite_member[0].allow) @@ -1273,7 +1875,6 @@ async def get_permissions_for(self, member: "Member") -> Permissions: @define() class Thread(Channel): """An object representing a thread. - .. note:: This is a derivation of the base Channel, since a thread can be its own event. diff --git a/interactions/api/models/emoji.py b/interactions/api/models/emoji.py index 625d9d9c3..317a80b19 100644 --- a/interactions/api/models/emoji.py +++ b/interactions/api/models/emoji.py @@ -1,7 +1,7 @@ from typing import TYPE_CHECKING, List, Optional, Union +from ...utils.attrs_utils import ClientSerializerMixin, convert_list, define, field from ..error import LibraryException -from .attrs_utils import ClientSerializerMixin, convert_list, define, field from .misc import Snowflake from .user import User @@ -12,7 +12,7 @@ __all__ = ("Emoji",) -@define() +@define(repr=False) class Emoji(ClientSerializerMixin): """ A class objecting representing an emoji. @@ -36,7 +36,7 @@ class Emoji(ClientSerializerMixin): animated: Optional[bool] = field(default=None) available: Optional[bool] = field(default=None) - def __str__(self): + def __repr__(self): return ( f"<{'a' if self.animated else ''}:{self.name}:{self.id}>" if self.id is not None diff --git a/interactions/api/models/flags.py b/interactions/api/models/flags.py index 577e7a651..2d0429f62 100644 --- a/interactions/api/models/flags.py +++ b/interactions/api/models/flags.py @@ -172,6 +172,7 @@ class AppFlags(IntFlag): EMBEDDED = 1 << 17 GATEWAY_MESSAGE_CONTENT = 1 << 18 GATEWAY_MESSAGE_CONTENT_LIMITED = 1 << 19 + APPLICATION_COMMAND_BADGE = 1 << 23 class StatusType(str, Enum): diff --git a/interactions/api/models/guild.py b/interactions/api/models/guild.py index 856b77bed..5bd09847e 100644 --- a/interactions/api/models/guild.py +++ b/interactions/api/models/guild.py @@ -1,25 +1,30 @@ from datetime import datetime from enum import Enum, IntEnum -from typing import TYPE_CHECKING, Any, Dict, List, Optional, Tuple, Union +from inspect import isawaitable +from math import inf +from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Tuple, Union +from warnings import warn -from ..error import LibraryException -from .attrs_utils import ( - MISSING, +from ...utils.abc.base_iterators import DiscordPaginationIterator +from ...utils.attrs_utils import ( ClientSerializerMixin, DictSerializerMixin, convert_list, define, field, ) +from ...utils.missing import MISSING +from ..error import LibraryException from .audit_log import AuditLogEvents, AuditLogs from .channel import Channel, ChannelType, Thread, ThreadMember from .emoji import Emoji from .member import Member -from .message import Sticker +from .message import Sticker, StickerPack from .misc import ( AutoModAction, AutoModTriggerMetadata, AutoModTriggerType, + File, IDMixin, Image, Overwrite, @@ -32,6 +37,7 @@ from .webhook import Webhook if TYPE_CHECKING: + from ..http.client import HTTPClient from .gw import AutoModerationRule from .message import Message @@ -53,6 +59,7 @@ "Guild", "GuildPreview", "Invite", + "AsyncMembersIterator", ) @@ -210,6 +217,108 @@ class UnavailableGuild(DictSerializerMixin, IDMixin): unavailable: bool = field() +class AsyncMembersIterator(DiscordPaginationIterator): + """ + A class object that allows iterating through a channel's history. + + :param _client: The HTTPClient of the bot + :type _client: HTTPClient + :param obj: The guild to get the members from + :type obj: Union[int, str, Snowflake, Guild] + :param start_at?: The member ID to start getting members from (gets all members after that member) + :type start_at?: Optional[Union[int, str, Snowflake, Member]] + :param check?: A check to ignore certain members + :type check?: Optional[Callable[[Member], bool]] + :param maximum?: A set maximum of members to get before stopping the iteration + :type maximum?: Optional[int] + """ + + def __init__( + self, + _client: "HTTPClient", + obj: Union[int, str, Snowflake, "Guild"], + maximum: Optional[int] = inf, + start_at: Optional[Union[int, str, Snowflake, Member]] = MISSING, + check: Optional[Callable[[Member], bool]] = None, + ): + super().__init__(obj, _client, maximum=maximum, start_at=start_at, check=check) + + self.after = self.start_at + + self.objects: Optional[List[Member]] + + async def get_first_objects(self) -> None: + + limit = min(self.maximum, 1000) + + if self.maximum == limit: + self.__stop = True + + members = await self._client.get_list_of_members( + guild_id=self.object_id, after=self.after, limit=limit + ) + self.after = int(members[-1]["user"]["id"]) + + if len(members) < 1000: + # already all messages resolved with one operation + self.__stop = True + + self.object_count += limit + + self.objects = [Member(**member, _client=self._client) for member in members] + + async def get_objects(self) -> None: + + limit = min(500, self.maximum - self.object_count) + members = await self._client.get_list_of_members( + guild_id=self.object_id, after=self.after, limit=limit + ) + self.after = int(members[-1]["user"]["id"]) + + if len(members) < limit or limit == self.maximum - self.object_count: + # end of messages reached again + self.__stop = True + + self.object_count += limit + + self.objects.extend([Member(**member, _client=self._client) for member in members]) + + async def flatten(self) -> List[Member]: + """returns all remaining items as list""" + return [item async for item in self] + + async def __anext__(self) -> Member: + if self.objects is None: + await self.get_first_objects() + + try: + obj = self.objects.pop(0) + + if self.check: + + res = self.check(obj) + _res = await res if isawaitable(res) else res + while not _res: + if ( + not self.__stop + and len(self.objects) < 5 + and self.object_count >= self.maximum + ): + await self.get_objects() + + self.object_count -= 1 + obj = self.objects.pop(0) + + _res = self.check(obj) + + if not self.__stop and len(self.objects) < 5 and self.object_count <= self.maximum: + await self.get_objects() + except IndexError: + raise StopAsyncIteration + else: + return obj + + @define() class Guild(ClientSerializerMixin, IDMixin): """ @@ -273,24 +382,24 @@ class Guild(ClientSerializerMixin, IDMixin): id: Snowflake = field(converter=Snowflake) name: str = field() - icon: Optional[str] = field(default=None) - icon_hash: Optional[str] = field(default=None) - splash: Optional[str] = field(default=None) - discovery_splash: Optional[str] = field(default=None) + icon: Optional[str] = field(default=None, repr=False) + icon_hash: Optional[str] = field(default=None, repr=False) + splash: Optional[str] = field(default=None, repr=False) + discovery_splash: Optional[str] = field(default=None, repr=False) owner: Optional[bool] = field(default=None) owner_id: Snowflake = field(converter=Snowflake, default=None) - permissions: Optional[str] = field(default=None) - region: Optional[str] = field(default=None) # None, we don't do Voices. + permissions: Optional[str] = field(default=None, repr=False) + region: Optional[str] = field(default=None, repr=False) # None, we don't do Voices. afk_channel_id: Optional[Snowflake] = field(converter=Snowflake, default=None) afk_timeout: Optional[int] = field(default=None) - widget_enabled: Optional[bool] = field(default=None) - widget_channel_id: Optional[Snowflake] = field(converter=Snowflake, default=None) - verification_level: int = 0 - default_message_notifications: int = 0 - explicit_content_filter: int = 0 + widget_enabled: Optional[bool] = field(default=None, repr=False) + widget_channel_id: Optional[Snowflake] = field(converter=Snowflake, default=None, repr=False) + verification_level: int = field(default=0) + default_message_notifications: int = field(default=0) + explicit_content_filter: int = field(default=0) roles: List[Role] = field(converter=convert_list(Role), factory=list, add_client=True) emojis: List[Emoji] = field(converter=convert_list(Emoji), factory=list, add_client=True) - mfa_level: int = 0 + mfa_level: int = field(default=0) application_id: Optional[Snowflake] = field(converter=Snowflake, default=None) system_channel_id: Optional[Snowflake] = field(converter=Snowflake, default=None) system_channel_flags: int = field(default=None) @@ -315,16 +424,18 @@ class Guild(ClientSerializerMixin, IDMixin): max_members: Optional[int] = field(default=None) vanity_url_code: Optional[str] = field(default=None) description: Optional[str] = field(default=None) - banner: Optional[str] = field(default=None) - premium_tier: int = 0 - premium_subscription_count: Optional[int] = field(default=None) + banner: Optional[str] = field(default=None, repr=False) + premium_tier: int = field(default=0) + premium_subscription_count: Optional[int] = field(default=None, repr=False) preferred_locale: str = field(default=None) public_updates_channel_id: Optional[Snowflake] = field(converter=Snowflake, default=None) - max_video_channel_users: Optional[int] = field(default=None) + max_video_channel_users: Optional[int] = field(default=None, repr=False) approximate_member_count: Optional[int] = field(default=None) approximate_presence_count: Optional[int] = field(default=None) - welcome_screen: Optional[WelcomeScreen] = field(converter=WelcomeScreen, default=None) - nsfw_level: int = 0 + welcome_screen: Optional[WelcomeScreen] = field( + converter=WelcomeScreen, default=None, repr=False + ) + nsfw_level: int = field(default=0) stage_instances: Optional[List[StageInstance]] = field( converter=convert_list(StageInstance), default=None ) @@ -360,6 +471,13 @@ def __attrs_post_init__(self): # sourcery skip: last-if-guard self.member_count = guild.member_count if not self.presences: self.presences = guild.presences + if not self.emojis: + self.emojis = guild.emojis + + if self.members: + for member in self.members: + if not member._extras.get("guild_id"): + member._extras["guild_id"] = self.id def __repr__(self) -> str: return self.name @@ -367,28 +485,50 @@ def __repr__(self) -> str: async def ban( self, member_id: Union[int, Member, Snowflake], + seconds: Optional[int] = 0, + minutes: Optional[int] = MISSING, + hours: Optional[int] = MISSING, + days: Optional[int] = MISSING, reason: Optional[str] = None, - delete_message_days: Optional[int] = 0, ) -> None: """ Bans a member from the guild. :param member_id: The id of the member to ban :type member_id: Union[int, Member, Snowflake] + :param seconds?: Number of seconds to delete messages, from 0 to 604800. Defaults to 0 + :type seconds?: Optional[int] + :param minutes?: Number of minutes to delete messages, from 0 to 10080 + :type minutes?: Optional[int] + :param hours?: Number of hours to delete messages, from 0 to 168 + :type hours?: Optional[int] + :param days?: Number of days to delete messages, from 0 to 7 + :type days?: Optional[int] :param reason?: The reason of the ban :type reason?: Optional[str] - :param delete_message_days?: Number of days to delete messages, from 0 to 7. Defaults to 0 - :type delete_message_days?: Optional[int] """ if not self._client: raise LibraryException(code=13) + if days is not MISSING: + seconds += days * 24 * 3600 + if hours is not MISSING: + seconds += hours * 3600 + if minutes is not MISSING: + seconds += minutes * 60 + + if seconds > 604800: + raise LibraryException( + code=12, + message="The amount of total seconds to delete messages exceeds the limit Discord provides (604800)", + ) + _member_id = int(member_id.id) if isinstance(member_id, Member) else int(member_id) await self._client.create_guild_ban( guild_id=int(self.id), user_id=_member_id, reason=reason, - delete_message_days=delete_message_days, + delete_message_seconds=seconds, ) if not self.members: @@ -578,7 +718,7 @@ async def get_member( guild_id=int(self.id), member_id=int(member_id), ) - member = Member(**res, _client=self._client) + member = Member(**res, _client=self._client, guild_id=self.id) if self.members is None: self.members = [] for index, _member in enumerate(self.members): @@ -724,7 +864,7 @@ async def create_thread( self, name: str, channel_id: Union[int, Snowflake, Channel], - type: Optional[ChannelType] = ChannelType.GUILD_PUBLIC_THREAD, + type: Optional[ChannelType] = ChannelType.PUBLIC_THREAD, auto_archive_duration: Optional[int] = MISSING, invitable: Optional[bool] = MISSING, message_id: Optional[Union[int, Snowflake, "Message"]] = MISSING, @@ -754,9 +894,9 @@ async def create_thread( if not self._client: raise LibraryException(code=13) if type not in [ - ChannelType.GUILD_NEWS_THREAD, - ChannelType.GUILD_PUBLIC_THREAD, - ChannelType.GUILD_PRIVATE_THREAD, + ChannelType.ANNOUNCEMENT_THREAD, + ChannelType.PUBLIC_THREAD, + ChannelType.PRIVATE_THREAD, ]: raise LibraryException(message="type must be a thread type!", code=12) @@ -838,9 +978,9 @@ async def create_channel( ) if type in [ - ChannelType.GUILD_NEWS_THREAD, - ChannelType.GUILD_PUBLIC_THREAD, - ChannelType.GUILD_PRIVATE_THREAD, + ChannelType.ANNOUNCEMENT_THREAD, + ChannelType.PUBLIC_THREAD, + ChannelType.PRIVATE_THREAD, ]: raise LibraryException( message="Please use `create_thread` for creating threads!", code=12 @@ -1098,7 +1238,7 @@ async def modify_member( reason=reason, ) - _member = Member(**res, _client=self._client) + _member = Member(**res, _client=self._client, guild_id=self.id) if self.members is None: self.members = [] for index, member in enumerate(self.members): @@ -1615,6 +1755,22 @@ async def create_scheduled_event( ) return ScheduledEvents(**res) + async def get_scheduled_events(self, with_user_count: bool) -> List["ScheduledEvents"]: + """ + Gets all scheduled events of the guild. + + :param with_user_count: A boolean to include number of users subscribed to the associated event, if given. + :type with_user_count: bool + :return: The sheduled events of the guild. + :rtype: List[ScheduledEvents] + """ + if not self._client: + raise LibraryException(code=13) + res = await self._client.get_scheduled_events( + guild_id=self.id, with_user_count=with_user_count + ) + return [ScheduledEvents(**scheduled_event) for scheduled_event in res] if res else [] + async def modify_scheduled_event( self, event_id: Union[int, "ScheduledEvents", Snowflake], @@ -1900,6 +2056,71 @@ async def get_all_bans(self) -> List[Dict[str, User]]: return res + async def prune( + self, + days: int = 7, + compute_prune_count: bool = True, + include_roles: Optional[Union[List[Role], List[int], List[Snowflake], List[str]]] = MISSING, + ) -> Optional[int]: + """ + Begins a prune operation. + + :param days: Number of days to count, minimum 1, maximum 30. Defaults to 7. + :param compute_prune_count: Whether the returned "pruned" dict contains the computed prune count or None. + :param include_roles: Role IDs to include, if given. + :return: The number of pruned members, if compute_prune_count is not false. Otherwise returns None. + :rtype: Optional[int] + """ + if not self._client: + raise LibraryException(code=13) + + if include_roles is not MISSING: + _roles = [ + int(role.id) if isinstance(role, Role) else int(role) for role in include_roles + ] + else: + _roles = None + + res: dict = await self._client.begin_guild_prune( + guild_id=int(self.id), + days=days, + compute_prune_count=compute_prune_count, + include_roles=_roles, + ) + + return res.get("pruned") + + async def get_prune_count( + self, + days: int = 7, + include_roles: Optional[Union[List[Role], List[int], List[Snowflake], List[str]]] = MISSING, + ) -> int: + """ + Returns the number of members that would be removed in a prune operation. + + :param days: Number of days to count, minimum 1, maximum 30. Defaults to 7. + :param include_roles: Role IDs to include, if given. + :return: The number of members that would be pruned. + :rtype: int + """ + if not self._client: + raise LibraryException(code=13) + + if include_roles is not MISSING: + _roles = [ + int(role.id) if isinstance(role, Role) else int(role) for role in include_roles + ] + else: + _roles = None + + res: dict = await self._client.get_guild_prune_count( + guild_id=int(self.id), + days=days, + include_roles=_roles, + ) + + return res.get("pruned") + async def get_emoji( self, emoji_id: int, @@ -2014,6 +2235,158 @@ async def delete_emoji( if int(item.id) == int(emoji_id): return self.emojis.remove(item) + async def get_stickers(self) -> Optional[List[Sticker]]: + """ + Get the stickers for a guild. + + :return: List of stickers of the guild. + :rtype: Optional[List[Sticker]] + """ + if not self._client: + raise LibraryException(code=13) + + res = await self._client.list_guild_stickers(guild_id=int(self.id)) + + stickers = [Sticker(**sticker) for sticker in res] + self.stickers = stickers + + return self.stickers + + async def get_nitro_sticker_packs(self) -> List[StickerPack]: + """ + Gets the list of sticker packs available to Nitro subscribers. + + :return: List of sticker packs. + :rtype: List[StickerPack] + """ + if not self._client: + raise LibraryException(code=13) + + res = await self._client.list_nitro_sticker_packs() + + return [StickerPack(**sticker_pack) for sticker_pack in res["sticker_packs"]] + + async def create_sticker( + self, + file: File, + tags: str, + name: Optional[str] = MISSING, + description: Optional[str] = MISSING, + reason: Optional[str] = None, + ) -> Sticker: + """ + Creates a new sticker for the guild. + + :param file: The file of the sticker. + :type file: File + :param tags: The tags of the sticker. + :type tags: str + :param name?: The name of the sticker. + :type name?: Optional[str] + :param description?: The description of the sticker. + :type description?: Optional[str] + :param reason?: The reason of the creation. + :type reason?: Optional[str] + :return: Created sticker for the guild. + :rtype: Sticker + """ + if not self._client: + raise LibraryException(code=13) + + _name = name if name is not MISSING else file._filename + + payload: dict = { + "name": _name, + "tags": tags, + "description": description if description is not MISSING else None, + } + + res = await self._client.create_guild_sticker( + payload=payload, file=file, guild_id=int(self.id), reason=reason + ) + + if self.stickers is None: + self.stickers = [] + + _sticker = Sticker(**res) + self.stickers.append(_sticker) + return _sticker + + async def modify_sticker( + self, + sticker_id: Union[Sticker, Snowflake, int, str], + name: Optional[str] = MISSING, + description: Optional[str] = MISSING, + reason: Optional[str] = None, + ) -> Sticker: + """ + Modifies the sticker of the guild. + + :param sticker_id: The sticker or ID of the sticker. + :type sticker_id: Union[Sticker, Snowflake, int] + :param name?: The name of the sticker. + :type name?: Optional[str] + :param description?: The description of the sticker. + :type description?: Optional[str] + :param reason?: The reason of the modification. + :type reason?: Optional[str] + :return: Modified sticker. + :rtype: Sticker + """ + if not self._client: + raise LibraryException(code=13) + + _id = int(sticker_id.id) if isinstance(sticker_id, Sticker) else int(sticker_id) + + payload: dict = {} + + if name is not MISSING: + payload["name"] = name + if description is not MISSING: + payload["description"] = description + + res = await self._client.modify_guild_sticker( + payload=payload, guild_id=int(self.id), sticker_id=_id, reason=reason + ) + _sticker = Sticker(**res) + + if not self.stickers: + self.stickers = [_sticker] + return _sticker + + for sticker in self.stickers: + if sticker.id == _sticker.id: + sticker.update(res) + return sticker + + async def delete_sticker( + self, + sticker_id: Union[Sticker, Snowflake, int, str], + reason: Optional[str] = None, + ): + """Deletes the sticker of the guild. + + :param sticker_id: The sticker or ID of the sticker. + :type sticker_id: Union[Sticker, Snowflake, int] + :param reason?: The reason of the deletion. + :type reason?: Optional[str] + """ + if not self._client: + raise LibraryException(code=13) + + _id = int(sticker_id.id) if isinstance(sticker_id, Sticker) else int(sticker_id) + + await self._client.delete_guild_sticker( + guild_id=int(self.id), sticker_id=_id, reason=reason + ) + + if not self.stickers: + return + for sticker in self.stickers: + if int(sticker.id) == _id: + self.stickers.remove(sticker) + break + async def get_list_of_members( self, limit: Optional[int] = 1, @@ -2038,7 +2411,7 @@ async def get_list_of_members( res = await self._client.get_list_of_members( guild_id=int(self.id), limit=limit, after=_after ) - _members = [Member(**member, _client=self._client) for member in res] + _members = [Member(**member, _client=self._client, guild_id=self.id) for member in res] if self.members is None: self.members = [] for member in _members: @@ -2062,7 +2435,7 @@ async def search_members(self, query: str, limit: Optional[int] = 1) -> List[Mem res = await self._client.search_guild_members( guild_id=int(self.id), query=query, limit=limit ) - return [Member(**member, _client=self._client) for member in res] + return [Member(**member, _client=self._client, guild_id=self.id) for member in res] async def get_all_members(self) -> List[Member]: """ @@ -2073,6 +2446,11 @@ async def get_all_members(self) -> List[Member]: :return: Returns a list of all members of the guild :rtype: List[Member] """ + warn( + "This method has been deprecated in favour of the 'get_members' method.", + DeprecationWarning, + ) + if not self._client: raise LibraryException(code=13) @@ -2089,9 +2467,33 @@ async def get_all_members(self) -> List[Member]: guild_id=int(self.id), limit=100, after=int(_last_member.id) ) _all_members.extend(_members) - self.members = [Member(**_, _client=self._client) for _ in _all_members] + self.members = [Member(**_, _client=self._client, guild_id=self.id) for _ in _all_members] return self.members + def get_members( + self, + start_at: Optional[Union[int, str, Snowflake, "Message"]] = MISSING, + maximum: Optional[int] = inf, + check: Optional[Callable[[Member], bool]] = None, + ) -> AsyncMembersIterator: + """ + :param start_at?: The message to begin getting the history from + :type start_at?: Optional[Union[int, str, Snowflake, Member]] + :param maximum?: A set maximum of members to get before stopping the iteration + :type maximum?: Optional[int] + :param check?: A custom check to ignore certain members + :type check?: Optional[Callable[[Message], bool]] + + :return: An asynchronous iterator over the members of the guild + :rtype: AsyncMembersIterator + """ + if not self._client: + raise LibraryException(code=13) + + return AsyncMembersIterator( + self._client, self, maximum=maximum, start_at=start_at, check=check + ) + async def get_webhooks(self) -> List[Webhook]: if not self._client: raise LibraryException(code=13) @@ -2320,14 +2722,14 @@ async def get_latest_audit_log_action( AuditLogEvents, int, Member, - Tuple[Union[User, Member, Snowflake, int], Union[AuditLogs, int]], + Tuple[Union[User, Member, Snowflake, int], Union[AuditLogEvents, int]], ], ) -> AuditLogs: """ Gets the latest audit log action of either a user or an action type :param of: The user, user id or action type to look for - :type of: Union[User, Snowflake, AuditLogEvents, int, Tuple[Union[User, Snowflake, int], Union[AuditLogs, int]]] + :type of: Union[User, Snowflake, AuditLogEvents, int, Tuple[Union[User, Snowflake, int], Union[AuditLogEvents, int]]] :return: The latest AuditLog action that applies to the ``of`` parameter :rtype: AuditLogs """ @@ -2626,7 +3028,7 @@ class ScheduledEvents(DictSerializerMixin, IDMixin): creator_id: Optional[Snowflake] = field(converter=Snowflake, default=None) name: str = field() description: str = field() - scheduled_start_time: Optional[datetime] = field(converter=datetime.isoformat, default=None) + scheduled_start_time: Optional[datetime] = field(converter=datetime.fromisoformat, default=None) scheduled_end_time: Optional[datetime] = field(converter=datetime.fromisoformat, default=None) privacy_level: int = field() entity_type: int = field() diff --git a/interactions/api/models/gw.py b/interactions/api/models/gw.py index 61c09f1e3..52eb94f89 100644 --- a/interactions/api/models/gw.py +++ b/interactions/api/models/gw.py @@ -1,10 +1,7 @@ from datetime import datetime -from typing import Any, List, Optional, Union +from typing import Any, List, Optional -from ...client.models.component import ActionRow, Button, SelectMenu, _build_components -from ..error import LibraryException -from .attrs_utils import ( - MISSING, +from ...utils.attrs_utils import ( ClientSerializerMixin, DictSerializerMixin, convert_list, @@ -15,13 +12,12 @@ from .emoji import Emoji from .guild import EventMetadata from .member import Member -from .message import Embed, Message, MessageInteraction, Sticker +from .message import Sticker from .misc import ( AutoModAction, AutoModTriggerMetadata, AutoModTriggerType, ClientStatus, - File, IDMixin, Snowflake, ) @@ -234,329 +230,30 @@ class GuildJoinRequest(DictSerializerMixin): @define() -class GuildMember(ClientSerializerMixin): +class GuildMember(Member): """ A class object representing the gateway events ``GUILD_MEMBER_ADD``, ``GUILD_MEMBER_UPDATE`` and ``GUILD_MEMBER_REMOVE``. - :ivar Snowflake guild_id: The guild ID of the event. - :ivar Optional[List[Role]] roles?: The roles of the event. - :ivar Optional[User] user?: The user of the event. - :ivar Optional[str] nick?: The nickname of the user of the event. - :ivar Optional[str] avatar?: The avatar URL of the user of the event. - :ivar Optional[datetime] joined_at?: The time that the user of the event joined at. - :ivar Optional[datetime] premium_since?: The time that the user of the event has since had "premium." - :ivar Optional[bool] deaf?: Whether the member of the event is deafened or not. - :ivar Optional[bool] mute?: Whether the member of the event is muted or not. - :ivar Optional[bool] pending?: Whether the member of the event is still pending -- pass membership screening -- or not. - :ivat Optional[datetime.isoformat] communication_disabled_until?: when the user's timeout will expire and the user will be able to communicate in the guild again, null or a time in the past if the user is not timed out. - """ + .. note:: + ``pending`` and ``permissions`` only apply for members retroactively + requiring to verify rules via. membership screening or lack permissions + to speak. - guild_id: Snowflake = field(converter=Snowflake) - roles: Optional[List[str]] = field(default=None) - user: Optional[User] = field(converter=User, default=None, add_client=True) - nick: Optional[str] = field(default=None) - _avatar: Optional[str] = field(default=None, discord_name="avatar") - joined_at: Optional[datetime] = field(converter=datetime.fromisoformat, default=None) - premium_since: Optional[datetime] = field(converter=datetime.fromisoformat, default=None) - deaf: Optional[bool] = field(default=None) - mute: Optional[bool] = field(default=None) - pending: Optional[bool] = field(default=None) - communication_disabled_until: Optional[datetime.isoformat] = field( - converter=datetime.fromisoformat, default=None - ) + :ivar Snowflake guild_id: The guild ID. + :ivar User user: The user of the guild. + :ivar str nick: The nickname of the member. + :ivar Optional[str] avatar?: The hash containing the user's guild avatar, if applicable. + :ivar List[int] roles: The list of roles of the member. + :ivar datetime joined_at: The timestamp the member joined the guild at. + :ivar datetime premium_since: The timestamp the member has been a server booster since. + :ivar bool deaf: Whether the member is deafened. + :ivar bool mute: Whether the member is muted. + :ivar Optional[bool] pending?: Whether the member is pending to pass membership screening. + :ivar Optional[Permissions] permissions?: Whether the member has permissions. + :ivar Optional[str] communication_disabled_until?: How long until they're unmuted, if any. + """ - def __str__(self) -> str: - return self.name or "" - - @property - def avatar(self) -> Optional[str]: - return self._avatar or getattr(self.user, "avatar", None) - - @property - def id(self) -> Optional[Snowflake]: - """ - Returns the ID of the user. - - :return: The ID of the user - :rtype: Snowflake - """ - return self.user.id if self.user else None - - @property - def name(self) -> Optional[str]: - """ - Returns the string of either the user's nickname or username. - - :return: The name of the member - :rtype: str - """ - return self.nick or (self.user.username if self.user else None) - - @property - def mention(self) -> str: - """ - Returns a string that allows you to mention the given member. - - :return: The string of the mentioned member. - :rtype: str - """ - return f"<@!{self.user.id}>" if self.nick else f"<@{self.user.id}>" - - async def ban( - self, - reason: Optional[str] = None, - delete_message_days: Optional[int] = 0, - ) -> None: - """ - Bans the member from a guild. - - :param reason?: The reason of the ban - :type reason?: Optional[str] - :param delete_message_days?: Number of days to delete messages, from 0 to 7. Defaults to 0 - :type delete_message_days?: Optional[int] - """ - await self._client.create_guild_ban( - guild_id=int(self.guild_id), - user_id=int(self.user.id), - reason=reason, - delete_message_days=delete_message_days, - ) - - async def kick( - self, - reason: Optional[str] = None, - ) -> None: - """ - Kicks the member from a guild. - - :param reason?: The reason for the kick - :type reason?: Optional[str] - """ - if not self._client: - raise LibraryException(code=13) - await self._client.create_guild_kick( - guild_id=int(self.guild_id), - user_id=int(self.user.id), - reason=reason, - ) - - async def add_role( - self, - role: Union[Role, int], - reason: Optional[str] = None, - ) -> None: - """ - This method adds a role to a member. - - :param role: The role to add. Either ``Role`` object or role_id - :type role: Union[Role, int] - :param reason?: The reason why the roles are added - :type reason?: Optional[str] - """ - if not self._client: - raise LibraryException(code=13) - if isinstance(role, Role): - await self._client.add_member_role( - guild_id=int(self.guild_id), - user_id=int(self.user.id), - role_id=int(role.id), - reason=reason, - ) - else: - await self._client.add_member_role( - guild_id=int(self.guild_id), - user_id=int(self.user.id), - role_id=role, - reason=reason, - ) - - async def remove_role( - self, - role: Union[Role, int], - reason: Optional[str] = None, - ) -> None: - """ - This method removes a role from a member. - - :param role: The role to remove. Either ``Role`` object or role_id - :type role: Union[Role, int] - :param reason?: The reason why the roles are removed - :type reason?: Optional[str] - """ - if not self._client: - raise LibraryException(code=13) - if isinstance(role, Role): - await self._client.remove_member_role( - guild_id=int(self.guild_id), - user_id=int(self.user.id), - role_id=int(role.id), - reason=reason, - ) - else: - await self._client.remove_member_role( - guild_id=int(self.guild_id), - user_id=int(self.user.id), - role_id=role, - reason=reason, - ) - - async def send( - self, - content: Optional[str] = MISSING, - *, - components: Optional[ - Union[ - ActionRow, - Button, - SelectMenu, - List[ActionRow], - List[Button], - List[SelectMenu], - ] - ] = MISSING, - tts: Optional[bool] = MISSING, - files: Optional[Union[File, List[File]]] = MISSING, - embeds: Optional[Union[Embed, List[Embed]]] = MISSING, - allowed_mentions: Optional[MessageInteraction] = MISSING, - ) -> Message: - """ - Sends a DM to the member. - - :param content?: The contents of the message as a string or string-converted value. - :type content?: Optional[str] - :param components?: A component, or list of components for the message. - :type components?: Optional[Union[ActionRow, Button, SelectMenu, List[Actionrow], List[Button], List[SelectMenu]]] - :param tts?: Whether the message utilizes the text-to-speech Discord programme or not. - :type tts?: Optional[bool] - :param files?: A file or list of files to be attached to the message. - :type files?: Optional[Union[File, List[File]]] - :param embeds?: An embed, or list of embeds for the message. - :type embeds?: Optional[Union[Embed, List[Embed]]] - :param allowed_mentions?: The message interactions/mention limits that the message can refer to. - :type allowed_mentions?: Optional[MessageInteraction] - :return: The sent message as an object. - :rtype: Message - """ - if not self._client: - raise LibraryException(code=13) - - _content: str = "" if content is MISSING else content - _tts: bool = False if tts is MISSING else tts - # _file = None if file is None else file - # _attachments = [] if attachments else None - _embeds: list = ( - [] - if not embeds or embeds is MISSING - else ([embed._json for embed in embeds] if isinstance(embeds, list) else [embeds._json]) - ) - _allowed_mentions: dict = {} if allowed_mentions is MISSING else allowed_mentions - if not components or components is MISSING: - _components = [] - else: - _components = _build_components(components=components) - - if not files or files is MISSING: - _files = [] - elif isinstance(files, list): - _files = [file._json_payload(id) for id, file in enumerate(files)] - else: - _files = [files._json_payload(0)] - files = [files] - - payload = dict( - content=_content, - tts=_tts, - attachments=_files, - embeds=_embeds, - components=_components, - allowed_mentions=_allowed_mentions, - ) - - channel = Channel( - **await self._client.create_dm(recipient_id=int(self.user.id)), _client=self._client - ) - res = await self._client.create_message( - channel_id=int(channel.id), payload=payload, files=files - ) - - return Message(**res, _client=self._client) - - async def modify( - self, - nick: Optional[str] = MISSING, - roles: Optional[List[int]] = MISSING, - mute: Optional[bool] = MISSING, - deaf: Optional[bool] = MISSING, - channel_id: Optional[int] = MISSING, - communication_disabled_until: Optional[datetime.isoformat] = MISSING, - reason: Optional[str] = None, - ) -> "GuildMember": - """ - Modifies the member of a guild. - - :param nick?: The nickname of the member - :type nick?: Optional[str] - :param roles?: A list of all role ids the member has - :type roles?: Optional[List[int]] - :param mute?: whether the user is muted in voice channels - :type mute?: Optional[bool] - :param deaf?: whether the user is deafened in voice channels - :type deaf?: Optional[bool] - :param channel_id?: id of channel to move user to (if they are connected to voice) - :type channel_id?: Optional[int] - :param communication_disabled_until?: when the user's timeout will expire and the user will be able to communicate in the guild again (up to 28 days in the future) - :type communication_disabled_until?: Optional[datetime.isoformat] - :param reason?: The reason of the modifying - :type reason?: Optional[str] - :return: The modified member object - :rtype: Member - """ - if not self._client: - raise LibraryException(code=13) - payload = {} - if nick is not MISSING: - payload["nick"] = nick - - if roles is not MISSING: - payload["roles"] = roles - - if channel_id is not MISSING: - payload["channel_id"] = channel_id - - if mute is not MISSING: - payload["mute"] = mute - - if deaf is not MISSING: - payload["deaf"] = deaf - - if communication_disabled_until is not MISSING: - payload["communication_disabled_until"] = communication_disabled_until - - res = await self._client.modify_member( - user_id=int(self.user.id), - guild_id=int(self.guild_id), - payload=payload, - reason=reason, - ) - self.update(res) - return GuildMember(**res, _client=self._client, guild_id=self.guild_id) - - async def add_to_thread( - self, - thread_id: int, - ) -> None: - """ - Adds the member to a thread. - - :param thread_id: The id of the thread to add the member to - :type thread_id: int - """ - if not self._client: - raise LibraryException(code=13) - await self._client.add_member_to_thread( - user_id=int(self.user.id), - thread_id=thread_id, - ) + _guild_id: Snowflake = field(converter=Snowflake, discord_name="guild_id") @define() @@ -565,7 +262,7 @@ class GuildMembers(DictSerializerMixin): A class object representing the gateway event ``GUILD_MEMBERS_CHUNK``. :ivar Snowflake guild_id: The guild ID of the event. - :ivar List[GuildMember] members: The members of the event. + :ivar List[Member] members: The members of the event. :ivar int chunk_index: The current chunk index of the event. :ivar int chunk_count: The total chunk count of the event. :ivar list not_found: A list of not found members in the event if an invalid request was made. @@ -574,7 +271,7 @@ class GuildMembers(DictSerializerMixin): """ guild_id: Snowflake = field(converter=Snowflake) - members: List[GuildMember] = field(converter=convert_list(GuildMember)) + members: List[Member] = field(converter=convert_list(Member), add_client=True) chunk_index: int = field() chunk_count: int = field() not_found: Optional[list] = field(default=None) @@ -796,6 +493,11 @@ class MessageReaction(ClientSerializerMixin): member: Optional[Member] = field(converter=Member, default=None, add_client=True) emoji: Optional[Emoji] = field(converter=Emoji, default=None) + def __attrs_post_init__(self): + if self.member: + if self.guild_id: + self.member._extras["guild_id"] = self.guild_id + class MessageReactionRemove(MessageReaction): """ @@ -815,6 +517,10 @@ class MessageReactionRemove(MessageReaction): # todo see if the missing member attribute affects anything +# Thread object typically used for ``THREAD_X`` is found in the channel models instead, as its identical. +# and all attributes of Thread are in Channel. + + @define() class ThreadList(DictSerializerMixin): """ diff --git a/interactions/api/models/member.py b/interactions/api/models/member.py index 99bf4b22c..febd5e813 100644 --- a/interactions/api/models/member.py +++ b/interactions/api/models/member.py @@ -1,18 +1,20 @@ from datetime import datetime from typing import TYPE_CHECKING, Any, List, Optional, Union +from ...utils.attrs_utils import ClientSerializerMixin, convert_int, convert_list, define, field +from ...utils.missing import MISSING +from ...utils.utils import search_iterable from ..error import LibraryException -from .attrs_utils import MISSING, ClientSerializerMixin, convert_int, convert_list, define, field from .channel import Channel from .flags import Permissions -from .misc import File, IDMixin, Snowflake +from .misc import AllowedMentions, File, IDMixin, Snowflake from .role import Role from .user import User if TYPE_CHECKING: from ...client.models.component import ActionRow, Button, SelectMenu from .guild import Guild - from .message import Attachment, Embed, Message, MessageInteraction + from .message import Attachment, Embed, Message __all__ = ("Member",) @@ -40,28 +42,92 @@ class Member(ClientSerializerMixin, IDMixin): :ivar Optional[str] communication_disabled_until?: How long until they're unmuted, if any. """ - user: Optional[User] = field(converter=User, default=None, add_client=True, repr=True) - nick: Optional[str] = field(default=None, repr=True) - _avatar: Optional[str] = field(default=None, discord_name="avatar") + user: Optional[User] = field(converter=User, default=None, add_client=True) + nick: Optional[str] = field(default=None) + _avatar: Optional[str] = field(default=None, discord_name="avatar", repr=False) roles: List[int] = field(converter=convert_list(int)) - joined_at: datetime = field(converter=datetime.fromisoformat) - premium_since: Optional[datetime] = field(converter=datetime.fromisoformat, default=None) + joined_at: datetime = field(converter=datetime.fromisoformat, repr=False) + premium_since: Optional[datetime] = field( + converter=datetime.fromisoformat, default=None, repr=False + ) deaf: bool = field() mute: bool = field() - is_pending: Optional[bool] = field(default=None) - pending: Optional[bool] = field(default=None) - permissions: Optional[Permissions] = field(converter=convert_int(Permissions), default=None) + is_pending: Optional[bool] = field(default=None, repr=False) + pending: Optional[bool] = field(default=None, repr=False) + permissions: Optional[Permissions] = field( + converter=convert_int(Permissions), default=None, repr=False + ) communication_disabled_until: Optional[datetime.isoformat] = field( converter=datetime.fromisoformat, default=None ) hoisted_role: Optional[Any] = field( - default=None + default=None, repr=False ) # TODO: Investigate what this is for when documented by Discord. - flags: int = field() # TODO: Investigate what this is for when documented by Discord. + flags: int = field(repr=False) # TODO: Investigate what this is for when documented by Discord. def __str__(self) -> str: return self.name or "" + def __getattr__(self, name): + # Forward any attributes the user has to make it easier for devs + try: + return getattr(self.user, name) + except AttributeError as e: + raise AttributeError(f"Neither `User` nor `Member` have attribute {name}") from e + + @property + def guild_id(self) -> Optional[Union[Snowflake, LibraryException]]: + """ + Attempts to get the guild ID the member is in. + Only works then roles or nick or joined at is present. + :return: The ID of the guild this member belongs to. + """ + + if hasattr(self, "_guild_id"): + return self._guild_id + + elif _id := self._extras.get("guild_id"): + return Snowflake(_id) + + if not self._client: + raise LibraryException(code=13) + + if self.roles: + for guild in self._client.cache[Guild].values.values(): + for role in guild.roles: + if role.id in self.roles: + self._extras["guild_id"] = int(guild.id) + return guild.id + + possible_guilds: List[Guild] = [] + + if self.nick: + + def check(_member: Member): + return _member.nick == self.nick and _member.id == self.id + + for guild in self._client.cache[Guild].values.values(): + if len(search_iterable(guild.members, check=check)) > 0: + possible_guilds.append(guild) + + if len(possible_guilds) == 1: + self._extras["guild_id"] = int(possible_guilds[0].id) + return possible_guilds[0].id + + elif len(possible_guilds) == 0: + possible_guilds = list(self._client.cache[Guild].values.values()) + + for guild in possible_guilds: + for member in guild.members: + if member.joined_at == self.joined_at: + self._extras["guild_id"] = int(guild.id) + return guild.id + + else: + return LibraryException( + code=12, message="the guild_id could not be retrieved, please insert one!" + ) + @property def avatar(self) -> Optional[str]: return self._avatar or getattr(self.user, "avatar", None) @@ -84,7 +150,7 @@ def mention(self) -> str: :return: The string of the mentioned member. :rtype: str """ - return f"<@!{self.user.id}>" if self.nick else f"<@{self.user.id}>" + return f"<@{'!' if self.nick else ''}{self.id}>" @property def name(self) -> str: @@ -98,47 +164,86 @@ def name(self) -> str: async def ban( self, - guild_id: Union[int, Snowflake, "Guild"], + guild_id: Optional[Union[int, Snowflake, "Guild"]] = MISSING, + seconds: Optional[int] = 0, + minutes: Optional[int] = MISSING, + hours: Optional[int] = MISSING, + days: Optional[int] = MISSING, reason: Optional[str] = None, - delete_message_days: Optional[int] = 0, ) -> None: """ Bans the member from a guild. :param guild_id: The id of the guild to ban the member from - :type guild_id: Union[int, Snowflake, "Guild"] + :type guild_id: Optional[Union[int, Snowflake, "Guild"]] + :param seconds?: Number of seconds to delete messages, from 0 to 604800. Defaults to 0 + :type seconds?: Optional[int] + :param minutes?: Number of minutes to delete messages, from 0 to 10080 + :type minutes?: Optional[int] + :param hours?: Number of hours to delete messages, from 0 to 168 + :type hours?: Optional[int] + :param days?: Number of days to delete messages, from 0 to 7 + :type days?: Optional[int] :param reason?: The reason of the ban :type reason?: Optional[str] - :param delete_message_days?: Number of days to delete messages, from 0 to 7. Defaults to 0 - :type delete_message_days?: Optional[int] """ - _guild_id = int(guild_id) if isinstance(guild_id, (Snowflake, int)) else int(guild_id.id) + if guild_id is MISSING: + _guild_id = self.guild_id + if isinstance(_guild_id, LibraryException): + raise _guild_id + + else: + _guild_id = ( + int(guild_id) if isinstance(guild_id, (Snowflake, int)) else int(guild_id.id) + ) + + if days is not MISSING: + seconds += days * 24 * 3600 + if hours is not MISSING: + seconds += hours * 3600 + if minutes is not MISSING: + seconds += minutes * 60 + + if seconds > 604800: + raise LibraryException( + code=12, + message="The amount of total seconds to delete messages exceeds the limit Discord provides (604800)", + ) await self._client.create_guild_ban( guild_id=_guild_id, user_id=int(self.user.id), reason=reason, - delete_message_days=delete_message_days, + delete_message_seconds=seconds, ) async def kick( self, - guild_id: Union[int, Snowflake, "Guild"], + guild_id: Optional[Union[int, Snowflake, "Guild"]] = MISSING, reason: Optional[str] = None, ) -> None: """ Kicks the member from a guild. :param guild_id: The id of the guild to kick the member from - :type guild_id: Union[int, Snowflake, "Guild"] + :type guild_id: Optional[Union[int, Snowflake, "Guild"]] :param reason?: The reason for the kick :type reason?: Optional[str] """ if not self._client: raise LibraryException(code=13) - _guild_id = int(guild_id) if isinstance(guild_id, (Snowflake, int)) else int(guild_id.id) + if guild_id is MISSING: + _guild_id = self.guild_id + + if isinstance(_guild_id, LibraryException): + raise _guild_id + + else: + _guild_id = ( + int(guild_id) if isinstance(guild_id, (Snowflake, int)) else int(guild_id.id) + ) await self._client.create_guild_kick( guild_id=_guild_id, @@ -149,7 +254,7 @@ async def kick( async def add_role( self, role: Union[Role, int, Snowflake], - guild_id: Union[int, Snowflake, "Guild"], + guild_id: Optional[Union[int, Snowflake, "Guild"]] = MISSING, reason: Optional[str] = None, ) -> None: """ @@ -158,7 +263,7 @@ async def add_role( :param role: The role to add. Either ``Role`` object or role_id :type role: Union[Role, int, Snowflake] :param guild_id: The id of the guild to add the roles to the member - :type guild_id: Union[int, Snowflake, "Guild"] + :type guild_id: Optional[Union[int, Snowflake, "Guild"]] :param reason?: The reason why the roles are added :type reason?: Optional[str] """ @@ -166,7 +271,15 @@ async def add_role( raise LibraryException(code=13) _role = int(role.id) if isinstance(role, Role) else int(role) - _guild_id = int(guild_id) if isinstance(guild_id, (Snowflake, int)) else int(guild_id.id) + if guild_id is MISSING: + _guild_id = self.guild_id + if isinstance(_guild_id, LibraryException): + raise _guild_id + + else: + _guild_id = ( + int(guild_id) if isinstance(guild_id, (Snowflake, int)) else int(guild_id.id) + ) await self._client.add_member_role( guild_id=_guild_id, @@ -178,7 +291,7 @@ async def add_role( async def remove_role( self, role: Union[Role, int], - guild_id: Union[int, Snowflake, "Guild"], + guild_id: Optional[Union[int, Snowflake, "Guild"]] = MISSING, reason: Optional[str] = None, ) -> None: """ @@ -187,14 +300,22 @@ async def remove_role( :param role: The role to remove. Either ``Role`` object or role_id :type role: Union[Role, int] :param guild_id: The id of the guild to remove the roles of the member - :type guild_id: Union[int, Snowflake, "Guild"] + :type guild_id: Optional[Union[int, Snowflake, "Guild"]] :param reason?: The reason why the roles are removed :type reason?: Optional[str] """ if not self._client: raise LibraryException(code=13) - _guild_id = int(guild_id) if isinstance(guild_id, (Snowflake, int)) else int(guild_id.id) + if guild_id is MISSING: + _guild_id = self.guild_id + if isinstance(_guild_id, LibraryException): + raise _guild_id + + else: + _guild_id = ( + int(guild_id) if isinstance(guild_id, (Snowflake, int)) else int(guild_id.id) + ) _role = int(role.id) if isinstance(role, Role) else int(role) await self._client.remove_member_role( @@ -222,7 +343,7 @@ async def send( attachments: Optional[List["Attachment"]] = MISSING, files: Optional[Union[File, List[File]]] = MISSING, embeds: Optional[Union["Embed", List["Embed"]]] = MISSING, - allowed_mentions: Optional["MessageInteraction"] = MISSING, + allowed_mentions: Optional[Union[AllowedMentions, dict]] = MISSING, ) -> "Message": """ Sends a DM to the member. @@ -239,8 +360,8 @@ async def send( :type files?: Optional[Union[File, List[File]]] :param embeds?: An embed, or list of embeds for the message. :type embeds?: Optional[Union[Embed, List[Embed]]] - :param allowed_mentions?: The message interactions/mention limits that the message can refer to. - :type allowed_mentions?: Optional[MessageInteraction] + :param allowed_mentions?: The allowed mentions for the message. + :type allowed_mentions?: Optional[Union[AllowedMentions, dict]] :return: The sent message as an object. :rtype: Message """ @@ -257,7 +378,13 @@ async def send( if not embeds or embeds is MISSING else ([embed._json for embed in embeds] if isinstance(embeds, list) else [embeds._json]) ) - _allowed_mentions: dict = {} if allowed_mentions is MISSING else allowed_mentions + _allowed_mentions: dict = ( + {} + if allowed_mentions is MISSING + else allowed_mentions._json + if isinstance(allowed_mentions, AllowedMentions) + else allowed_mentions + ) if not components or components is MISSING: _components = [] else: @@ -290,7 +417,7 @@ async def send( async def modify( self, - guild_id: Union[int, Snowflake, "Guild"], + guild_id: Optional[Union[int, Snowflake, "Guild"]] = MISSING, nick: Optional[str] = MISSING, roles: Optional[List[int]] = MISSING, mute: Optional[bool] = MISSING, @@ -303,7 +430,7 @@ async def modify( Modifies the member of a guild. :param guild_id: The id of the guild to modify the member on - :type guild_id: Union[int, Snowflake, "Guild"] + :type guild_id: Optional[Union[int, Snowflake, "Guild"]] :param nick?: The nickname of the member :type nick?: Optional[str] :param roles?: A list of all role ids the member has @@ -324,7 +451,15 @@ async def modify( if not self._client: raise LibraryException(code=13) - _guild_id = int(guild_id) if isinstance(guild_id, (int, Snowflake)) else int(guild_id.id) + if guild_id is MISSING: + _guild_id = self.guild_id + if isinstance(_guild_id, LibraryException): + raise _guild_id + + else: + _guild_id = ( + int(guild_id) if isinstance(guild_id, (int, Snowflake)) else int(guild_id.id) + ) payload = {} if nick is not MISSING: @@ -377,25 +512,37 @@ async def add_to_thread( thread_id=_thread_id, ) - def get_avatar_url(self, guild_id: Union[int, Snowflake, "Guild"]) -> Optional[str]: + def get_avatar_url( + self, guild_id: Optional[Union[int, Snowflake, "Guild"]] = MISSING + ) -> Optional[str]: """ Returns the URL of the member's avatar for the specified guild. :param guild_id: The id of the guild to get the member's avatar from - :type guild_id: Union[int, Snowflake, "Guild"] + :type guild_id: Optional[Union[int, Snowflake, "Guild"]] :return: URL of the members's avatar (None will be returned if no avatar is set) :rtype: str """ - if not self.avatar: + if not self.avatar or self.avatar == self.user.avatar: return None - _guild_id = int(guild_id) if isinstance(guild_id, (int, Snowflake)) else int(guild_id.id) + if guild_id is MISSING: + _guild_id = self.guild_id + if isinstance(_guild_id, LibraryException): + raise _guild_id + + else: + _guild_id = ( + int(guild_id) if isinstance(guild_id, (int, Snowflake)) else int(guild_id.id) + ) url = f"https://cdn.discordapp.com/guilds/{_guild_id}/users/{int(self.user.id)}/avatars/{self.avatar}" url += ".gif" if self.avatar.startswith("a_") else ".png" return url - async def get_guild_permissions(self, guild: "Guild") -> Permissions: + async def get_guild_permissions( + self, guild_id: Optional[Union[int, Snowflake, "Guild"]] = MISSING + ) -> Permissions: """ Returns the permissions of the member for the specified guild. @@ -409,6 +556,18 @@ async def get_guild_permissions(self, guild: "Guild") -> Permissions: :return: Base permissions of the member in the specified guild :rtype: Permissions """ + from .guild import Guild + + if guild_id is MISSING: + _guild_id = self.guild_id + if isinstance(_guild_id, LibraryException): + raise _guild_id + + else: + _guild_id = int(guild_id) if not isinstance(guild_id, Guild) else int(guild_id.id) + + guild = Guild(**await self._client.get_guild(int(_guild_id)), _client=self._client) + if int(guild.owner_id) == int(self.id): return Permissions.ALL @@ -419,7 +578,49 @@ async def get_guild_permissions(self, guild: "Guild") -> Permissions: role = await guild.get_role(role_id) permissions |= int(role.permissions) - if permissions & Permissions.ADMINISTRATOR == Permissions.ADMINISTRATOR: + if Permissions.ADMINISTRATOR in Permissions(permissions): return Permissions.ALL return Permissions(permissions) + + async def has_permissions( + self, + *permissions: Union[int, Permissions], + channel: Optional[Channel] = MISSING, + guild_id: Optional[Union[int, Snowflake, "Guild"]] = MISSING, + operator: str = "and", + ) -> bool: + """ + Returns whether the member has the permissions passed. + + .. note:: + If the channel argument is present, the function will look if the member has the permissions in the specified channel. + If the argument is missing, then it will only consider the member's guild permissions. + + :param *permissions: The list of permissions + :type *permissions: Union[int, Permissions] + :param channel: The channel where to check for permissions + :type channel: Channel + :param guild_id: The id of the guild + :type guild_id: Optional[Union[int, Snowflake, Guild]] + :param operator: The operator to use to calculate permissions. Possible values: `and`, `or`. Defaults to `and`. + :type operator: str + :return: Whether the member has the permissions + :rtype: bool + """ + perms = ( + await self.get_guild_permissions(guild_id) + if channel is MISSING + else await channel.get_permissions_for(self) + ) + + if operator == "and": + for perm in permissions: + if perm not in perms: + return False + return True + else: + for perm in permissions: + if perm in perms: + return True + return False diff --git a/interactions/api/models/message.py b/interactions/api/models/message.py index ad10e27d1..aa7611022 100644 --- a/interactions/api/models/message.py +++ b/interactions/api/models/message.py @@ -1,12 +1,11 @@ import contextlib from datetime import datetime from enum import IntEnum +from io import BytesIO from typing import TYPE_CHECKING, List, Optional, Union from ...client.models.component import ActionRow, Button, SelectMenu -from ..error import LibraryException -from .attrs_utils import ( - MISSING, +from ...utils.attrs_utils import ( ClientSerializerMixin, DictSerializerMixin, convert_list, @@ -15,10 +14,12 @@ define, field, ) +from ...utils.missing import MISSING +from ..error import LibraryException from .channel import Channel from .emoji import Emoji from .member import Member -from .misc import File, IDMixin, Snowflake +from .misc import AllowedMentions, File, IDMixin, Snowflake from .team import Application from .user import User @@ -42,6 +43,7 @@ "ReactionObject", "PartialSticker", "Sticker", + "StickerPack", ) @@ -148,6 +150,22 @@ class Attachment(ClientSerializerMixin, IDMixin): width: Optional[int] = field(default=None) ephemeral: Optional[bool] = field(default=None) + async def download(self) -> BytesIO: + """ + Downloads the attachment. + + :returns: The attachment's bytes as BytesIO object + :rtype: BytesIO + """ + + if not self._client: + raise LibraryException(code=13) + + async with self._client._req._session.get(self.url) as response: + _bytes: bytes = await response.content.read() + + return BytesIO(_bytes) + @define() class MessageInteraction(ClientSerializerMixin, IDMixin): @@ -460,7 +478,7 @@ def insert_field_at( """ Inserts a field in the embed at the specified index - :param index: The new field's index + :param index: The field's index to insert :type index: int :param name: The name of the field :type name: str @@ -484,7 +502,7 @@ def set_field_at( """ Overwrites the field in the embed at the specified index - :param index: The new field's index + :param index: The field's index to overwrite :type index: int :param name: The name of the field :type name: str @@ -495,7 +513,9 @@ def set_field_at( """ try: - self.fields[index] = EmbedField(name=name, value=value, inline=inline) + fields = self.fields + fields[index] = EmbedField(name=name, value=value, inline=inline) + self.fields = fields except AttributeError as e: raise AttributeError("No fields found in Embed") from e @@ -507,7 +527,7 @@ def remove_field(self, index: int) -> None: """ Remove field at the specified index - :param index: The new field's index + :param index: The field's index to remove :type index: int """ @@ -685,6 +705,29 @@ class Sticker(PartialSticker, IDMixin): sort_value: Optional[int] = field(default=None) +@define() +class StickerPack(DictSerializerMixin, IDMixin): + """ + A class objects representing a pack of stickers. + + :ivar Snowflake id: ID of the sticker pack. + :ivar List[Sticker] stickers: The stickers in the pack. + :ivar str name: The name of sticker pack. + :ivar Snowflake sku_id: ID of the pack's SKU. + :ivar Optional[Snowflake] cover_sticker_id?: ID of a sticker in the pack which is shown as the pack's icon. + :ivar str description: The description of sticker pack. + :ivar Optional[Snowflake] banned_asset_id?: ID of the sticker pack's banner image. + """ + + id: Snowflake = field(converter=Snowflake) + stickers: List[Sticker] = field(converter=convert_list(Sticker)) + name: str = field() + sku_id: Snowflake = field(converter=Snowflake) + cover_sticker_id: Optional[Snowflake] = field(converter=Snowflake, default=None) + description: str = field() + banned_asset_id: Optional[Snowflake] = field(converter=Snowflake, default=None) + + @define() class ReactionObject(DictSerializerMixin): """The reaction object. @@ -727,7 +770,6 @@ class Message(ClientSerializerMixin, IDMixin): :ivar Optional[MessageActivity] activity?: Message activity object that's sent by Rich Presence :ivar Optional[Application] application?: Application object that's sent by Rich Presence :ivar Optional[MessageReference] message_reference?: Data showing the source of a message (crosspost, channel follow, add, pin, or replied message) - :ivar Optional[Any] allowed_mentions: The allowed mentions of roles attached in the message. :ivar int flags: Message flags :ivar Optional[MessageInteraction] interaction?: Message interaction object, if the message is sent by an interaction. :ivar Optional[Channel] thread?: The thread that started from this message, if any, with a thread member object embedded. @@ -760,7 +802,7 @@ class Message(ClientSerializerMixin, IDMixin): reactions: Optional[List[ReactionObject]] = field( converter=convert_list(ReactionObject), default=None ) - nonce: Optional[Union[int, str]] = field(default=None) + nonce: Optional[Union[int, str]] = field(default=None, repr=False) pinned: bool = field(default=None) webhook_id: Optional[Snowflake] = field(converter=Snowflake, default=None) type: MessageType = field(converter=MessageType, default=None) @@ -771,7 +813,7 @@ class Message(ClientSerializerMixin, IDMixin): flags: int = field(default=None) referenced_message: Optional[MessageReference] = field(converter=MessageReference, default=None) interaction: Optional[MessageInteraction] = field( - converter=MessageInteraction, default=None, add_client=True + converter=MessageInteraction, default=None, add_client=True, repr=False ) thread: Optional[Channel] = field(converter=Channel, default=None, add_client=True) @@ -782,7 +824,12 @@ class Message(ClientSerializerMixin, IDMixin): stickers: Optional[List[Sticker]] = field( converter=convert_list(Sticker), default=None ) # deprecated - position: Optional[int] = field(default=None) + position: Optional[int] = field(default=None, repr=False) + + def __attrs_post_init__(self): + if self.member: + if self.guild_id: + self.member._extras["guild_id"] = self.guild_id async def get_channel(self) -> Channel: """ @@ -829,7 +876,7 @@ async def edit( files: Optional[Union[File, List[File]]] = MISSING, embeds: Optional[Union["Embed", List["Embed"]]] = MISSING, suppress_embeds: Optional[bool] = MISSING, - allowed_mentions: Optional["MessageInteraction"] = MISSING, + allowed_mentions: Optional[Union[AllowedMentions, dict]] = MISSING, message_reference: Optional[MessageReference] = MISSING, attachments: Optional[List["Attachment"]] = MISSING, components: Optional[ @@ -856,8 +903,8 @@ async def edit( :type embeds?: Optional[Union[Embed, List[Embed]]] :param suppress_embeds?: Whether to suppress embeds in the message. :type suppress_embeds?: Optional[bool] - :param allowed_mentions?: The message interactions/mention limits that the message can refer to. - :type allowed_mentions?: Optional[MessageInteraction] + :param allowed_mentions?: The allowed mentions for the message. + :type allowed_mentions?: Optional[Union[AllowedMentions, dict]] :param attachments?: The attachments to attach to the message. Needs to be uploaded to the CDN first :type attachments?: Optional[List[Attachment]] :param components?: A component, or list of components for the message. If `[]` the components will be removed @@ -905,7 +952,13 @@ async def edit( else [] ) - _allowed_mentions: dict = {} if allowed_mentions is MISSING else allowed_mentions + _allowed_mentions: dict = ( + {} + if allowed_mentions is MISSING + else allowed_mentions._json + if isinstance(allowed_mentions, AllowedMentions) + else allowed_mentions + ) _message_reference: dict = {} if message_reference is MISSING else message_reference._json if not components: _components = [] @@ -944,7 +997,7 @@ async def reply( embeds: Optional[Union["Embed", List["Embed"]]] = MISSING, files: Optional[Union[File, List[File]]] = MISSING, attachments: Optional[List["Attachment"]] = MISSING, - allowed_mentions: Optional["MessageInteraction"] = MISSING, + allowed_mentions: Optional[Union[AllowedMentions, dict]] = MISSING, stickers: Optional[List["Sticker"]] = MISSING, components: Optional[ Union[ @@ -970,8 +1023,8 @@ async def reply( :type files?: Optional[Union[File, List[File]]] :param embeds?: An embed, or list of embeds for the message. :type embeds?: Optional[Union[Embed, List[Embed]]] - :param allowed_mentions?: The message interactions/mention limits that the message can refer to. - :type allowed_mentions?: Optional[MessageInteraction] + :param allowed_mentions?: The allowed mentions for the message. + :type allowed_mentions?: Optional[Union[AllowedMentions, dict]] :param components?: A component, or list of components for the message. :type components?: Optional[Union[ActionRow, Button, SelectMenu, List[ActionRow], List[Button], List[SelectMenu]]] :param stickers?: A list of stickers to send with your message. You can send up to 3 stickers per message. @@ -992,7 +1045,13 @@ async def reply( if not embeds or embeds is MISSING else ([embed._json for embed in embeds] if isinstance(embeds, list) else [embeds._json]) ) - _allowed_mentions: dict = {} if allowed_mentions is MISSING else allowed_mentions + _allowed_mentions: dict = ( + {} + if allowed_mentions is MISSING + else allowed_mentions._json + if isinstance(allowed_mentions, AllowedMentions) + else allowed_mentions + ) _message_reference = MessageReference(message_id=int(self.id))._json _attachments = [] if attachments is MISSING else [a._json for a in attachments] if not components or components is MISSING: @@ -1276,3 +1335,29 @@ def url(self) -> str: """ guild = self.guild_id or "@me" return f"https://discord.com/channels/{guild}/{self.channel_id}/{self.id}" + + async def disable_all_components(self) -> "Message": + """ + Sets all components to disabled on this message. + + :return: The modified message. + :rtype: Message + """ + if not self._client: + raise LibraryException(code=13) + + if not self.components: + return self + + for components in self.components: + for component in components.components: + component.disabled = True + + return Message( + **await self._client.edit_message( + int(self.channel_id), + int(self.id), + payload={"components": [component._json for component in self.components]}, + ), + _client=self._client, + ) diff --git a/interactions/api/models/misc.py b/interactions/api/models/misc.py index ec3ced211..34e15e208 100644 --- a/interactions/api/models/misc.py +++ b/interactions/api/models/misc.py @@ -7,7 +7,7 @@ import datetime from base64 import b64encode -from enum import IntEnum +from enum import Enum, IntEnum from io import FileIO, IOBase from logging import Logger from math import floor @@ -15,8 +15,10 @@ from typing import List, Optional, Union from ...base import get_logger +from ...utils.attrs_utils import DictSerializerMixin, convert_list, define, field +from ...utils.missing import MISSING from ..error import LibraryException -from .attrs_utils import MISSING, DictSerializerMixin, define, field +from .flags import Permissions __all__ = ( "AutoModKeywordPresetTypes", @@ -24,6 +26,8 @@ "AutoModMetaData", "AutoModAction", "AutoModTriggerMetadata", + "AllowedMentionType", + "AllowedMentions", "Snowflake", "Color", "ClientStatus", @@ -43,14 +47,14 @@ class Overwrite(DictSerializerMixin): :ivar str id: Role or User ID :ivar int type: Type that corresponds ot the ID; 0 for role and 1 for member. - :ivar str allow: Permission bit set. - :ivar str deny: Permission bit set. + :ivar Union[Permissions, int, str] allow: Permission bit set. + :ivar Union[Permissions, int, str] deny: Permission bit set. """ id: int = field() type: int = field() - allow: str = field() - deny: str = field() + allow: Union[Permissions, int, str] = field() + deny: Union[Permissions, int, str] = field() @define() @@ -370,3 +374,32 @@ def filename(self) -> str: Returns the name of the file. """ return self._name.split("/")[-1].split(".")[0] + + +class AllowedMentionType(str, Enum): + """ + An enumerable object representing the allowed mention types + """ + + EVERYONE = "everyone" + USERS = "users" + ROLES = "roles" + + +@define() +class AllowedMentions(DictSerializerMixin): + """ + A class object representing the allowed mentions object + + :ivar parse?: Optional[List[AllowedMentionType]]: An array of allowed mention types to parse from the content. + :ivar users?: Optional[List[int]]: An array of user ids to mention. + :ivar roles?: Optional[List[int]]: An array of role ids to mention. + :ivar replied_user?: Optional[bool]: For replies, whether to mention the author of the message being replied to. + """ + + parse: Optional[List[AllowedMentionType]] = field( + converter=convert_list(AllowedMentionType), default=None + ) + users: Optional[List[int]] = field(default=None) + roles: Optional[List[int]] = field(default=None) + replied_user: Optional[bool] = field(default=None) diff --git a/interactions/api/models/presence.py b/interactions/api/models/presence.py index 9ca3d1fc5..c116ee701 100644 --- a/interactions/api/models/presence.py +++ b/interactions/api/models/presence.py @@ -2,7 +2,7 @@ from enum import IntEnum from typing import Any, List, Optional -from .attrs_utils import DictSerializerMixin, convert_list, define, field +from ...utils.attrs_utils import DictSerializerMixin, convert_list, define, field from .emoji import Emoji from .flags import StatusType from .misc import Snowflake @@ -181,3 +181,7 @@ def __attrs_post_init__(self): # If since is not provided by the developer... self.since = int(time.time() * 1000) if self.status == "idle" else 0 self._json["since"] = self.since + if not self._json.get("afk"): + self.afk = self._json["afk"] = False + if not self._json.get("activities"): + self.activities = self._json["activities"] = [] diff --git a/interactions/api/models/role.py b/interactions/api/models/role.py index cb0bfbd41..cb1b7bf78 100644 --- a/interactions/api/models/role.py +++ b/interactions/api/models/role.py @@ -1,7 +1,8 @@ from typing import TYPE_CHECKING, Any, List, Optional, Union +from ...utils.attrs_utils import ClientSerializerMixin, DictSerializerMixin, define, field +from ...utils.missing import MISSING from ..error import LibraryException -from .attrs_utils import MISSING, ClientSerializerMixin, DictSerializerMixin, define, field from .misc import IDMixin, Image, Snowflake if TYPE_CHECKING: @@ -52,7 +53,7 @@ class Role(ClientSerializerMixin, IDMixin): name: str = field() color: int = field() hoist: bool = field() - icon: Optional[str] = field(default=None) + icon: Optional[str] = field(default=None, repr=False) unicode_emoji: Optional[str] = field(default=None) position: int = field() permissions: str = field() diff --git a/interactions/api/models/team.py b/interactions/api/models/team.py index e4bf3a827..10beecce5 100644 --- a/interactions/api/models/team.py +++ b/interactions/api/models/team.py @@ -1,6 +1,6 @@ from typing import Any, List, Optional -from .attrs_utils import ClientSerializerMixin, convert_list, define, field +from ...utils.attrs_utils import ClientSerializerMixin, convert_list, define, field from .flags import AppFlags from .misc import IDMixin, Snowflake from .user import User @@ -82,7 +82,7 @@ class Application(ClientSerializerMixin, IDMixin): id: Snowflake = field(converter=Snowflake) name: str = field() - icon: Optional[str] = field(default=None) + icon: Optional[str] = field(default=None, repr=False) description: str = field() rpc_origins: Optional[List[str]] = field(default=None) bot_public: bool = field() @@ -96,7 +96,7 @@ class Application(ClientSerializerMixin, IDMixin): guild_id: Optional[Snowflake] = field(converter=Snowflake, default=None) primary_sku_id: Optional[Snowflake] = field(converter=Snowflake, default=None) slug: Optional[str] = field(default=None) - cover_image: Optional[str] = field(default=None) + cover_image: Optional[str] = field(default=None, repr=False) flags: Optional[AppFlags] = field(converter=AppFlags, default=None) type: Optional[Any] = field(default=None) hook: Optional[Any] = field(default=None) diff --git a/interactions/api/models/user.py b/interactions/api/models/user.py index 84e608ded..97a5b87cf 100644 --- a/interactions/api/models/user.py +++ b/interactions/api/models/user.py @@ -1,8 +1,15 @@ -from typing import Optional, Union +from typing import TYPE_CHECKING, List, Optional, Union -from .attrs_utils import ClientSerializerMixin, define, field +from ...utils.attrs_utils import ClientSerializerMixin, define, field +from ...utils.missing import MISSING +from ..error import LibraryException from .flags import UserFlags -from .misc import IDMixin, Snowflake +from .misc import AllowedMentions, File, IDMixin, Snowflake + +if TYPE_CHECKING: + from ...client.models.component import ActionRow, Button, SelectMenu + from .gw import Presence + from .message import Attachment, Embed, Message __all__ = ("User",) @@ -30,22 +37,22 @@ class User(ClientSerializerMixin, IDMixin): :ivar Optional[UserFlags] public_flags?: The user's public flags """ - id: Snowflake = field(converter=Snowflake, repr=True) + id: Snowflake = field(converter=Snowflake) username: str = field(repr=True) discriminator: str = field(repr=True) - avatar: Optional[str] = field(default=None) - bot: Optional[bool] = field(default=None, repr=True) - system: Optional[bool] = field(default=None) + avatar: Optional[str] = field(default=None, repr=False) + bot: Optional[bool] = field(default=None) + system: Optional[bool] = field(default=None, repr=False) mfa_enabled: Optional[bool] = field(default=None) - banner: Optional[str] = field(default=None) - accent_color: Optional[int] = field(default=None) - banner_color: Optional[str] = field(default=None) + banner: Optional[str] = field(default=None, repr=False) + accent_color: Optional[int] = field(default=None, repr=False) + banner_color: Optional[str] = field(default=None, repr=False) locale: Optional[str] = field(default=None) verified: Optional[bool] = field(default=None) email: Optional[str] = field(default=None) - flags: Optional[UserFlags] = field(converter=UserFlags, default=None) - premium_type: Optional[int] = field(default=None) - public_flags: Optional[UserFlags] = field(converter=UserFlags, default=None) + flags: Optional[UserFlags] = field(converter=UserFlags, default=None, repr=False) + premium_type: Optional[int] = field(default=None, repr=False) + public_flags: Optional[UserFlags] = field(converter=UserFlags, default=None, repr=False) bio: Optional[str] = field(default=None) def __str__(self) -> str: @@ -96,3 +103,105 @@ def banner_url(self) -> Optional[str]: url = f"https://cdn.discordapp.com/banners/{int(self.id)}/{self.banner}" url += ".gif" if self.banner.startswith("a_") else ".png" return url + + @property + def presence(self) -> Optional["Presence"]: + """ + Returns the presence of the user. + + :return: Presence of the user (None will be returned if not cached) + :rtype: Optional[Presence] + """ + from .gw import Presence + + return self._client.cache[Presence].get(self.id) + + async def send( + self, + content: Optional[str] = MISSING, + *, + components: Optional[ + Union[ + "ActionRow", + "Button", + "SelectMenu", + List["ActionRow"], + List["Button"], + List["SelectMenu"], + ] + ] = MISSING, + tts: Optional[bool] = MISSING, + attachments: Optional[List["Attachment"]] = MISSING, + files: Optional[Union[File, List[File]]] = MISSING, + embeds: Optional[Union["Embed", List["Embed"]]] = MISSING, + allowed_mentions: Optional[Union[AllowedMentions, dict]] = MISSING, + ) -> "Message": + """ + Sends a DM to the user. + + :param content?: The contents of the message as a string or string-converted value. + :type content?: Optional[str] + :param components?: A component, or list of components for the message. + :type components?: Optional[Union[ActionRow, Button, SelectMenu, List[ActionRow], List[Button], List[SelectMenu]]] + :param tts?: Whether the message utilizes the text-to-speech Discord programme or not. + :type tts?: Optional[bool] + :param attachments?: The attachments to attach to the message. Needs to be uploaded to the CDN first + :type attachments?: Optional[List[Attachment]] + :param files?: A file or list of files to be attached to the message. + :type files?: Optional[Union[File, List[File]]] + :param embeds?: An embed, or list of embeds for the message. + :type embeds?: Optional[Union[Embed, List[Embed]]] + :param allowed_mentions?: The allowed mentions for the message. + :type allowed_mentions?: Optional[Union[AllowedMentions, dict]] + :return: The sent message as an object. + :rtype: Message + """ + if not self._client: + raise LibraryException(code=13) + from ...client.models.component import _build_components + from .message import Message + + _content: str = "" if content is MISSING else content + _tts: bool = False if tts is MISSING else tts + _attachments = [] if attachments is MISSING else [a._json for a in attachments] + _embeds: list = ( + [] + if not embeds or embeds is MISSING + else ([embed._json for embed in embeds] if isinstance(embeds, list) else [embeds._json]) + ) + _allowed_mentions: dict = ( + {} + if allowed_mentions is MISSING + else allowed_mentions._json + if isinstance(allowed_mentions, AllowedMentions) + else allowed_mentions + ) + if not components or components is MISSING: + _components = [] + else: + _components = _build_components(components=components) + + if not files or files is MISSING: + _files = [] + elif isinstance(files, list): + _files = [file._json_payload(id) for id, file in enumerate(files)] + else: + _files = [files._json_payload(0)] + files = [files] + + _files.extend(_attachments) + + payload = dict( + content=_content, + tts=_tts, + attachments=_files, + embeds=_embeds, + components=_components, + allowed_mentions=_allowed_mentions, + ) + channel = await self._client.create_dm(recipient_id=int(self.id)) + res = await self._client.create_message( + channel_id=int(channel["id"]), payload=payload, files=files + ) + + return Message(**res, _client=self._client) diff --git a/interactions/api/models/webhook.py b/interactions/api/models/webhook.py index 4cc1b3411..4b8898ca4 100644 --- a/interactions/api/models/webhook.py +++ b/interactions/api/models/webhook.py @@ -1,9 +1,10 @@ from enum import IntEnum from typing import TYPE_CHECKING, Any, List, Optional, Union +from ...utils.attrs_utils import ClientSerializerMixin, define, field +from ...utils.missing import MISSING from ..error import LibraryException -from .attrs_utils import MISSING, ClientSerializerMixin, define, field -from .misc import File, IDMixin, Image, Snowflake +from .misc import AllowedMentions, File, IDMixin, Image, Snowflake from .user import User if TYPE_CHECKING: @@ -48,7 +49,7 @@ class Webhook(ClientSerializerMixin, IDMixin): channel_id: Optional[Snowflake] = field(converter=Snowflake, default=None) user: Optional[User] = field(converter=User, default=None, add_client=True) name: str = field() - avatar: str = field() + avatar: str = field(repr=False) token: Optional[str] = field(default=None) application_id: Snowflake = field(converter=Snowflake) source_guild: Optional[Any] = field(default=None) @@ -180,7 +181,7 @@ async def execute( avatar_url: Optional[str] = MISSING, tts: Optional[bool] = MISSING, embeds: Optional[Union["Embed", List["Embed"]]] = MISSING, - allowed_mentions: Any = MISSING, + allowed_mentions: Optional[Union[AllowedMentions, dict]] = MISSING, attachments: Optional[List["Attachment"]] = MISSING, components: Optional[ Union[ @@ -213,8 +214,8 @@ async def execute( :type attachments?: Optional[List[Attachment]] :param embeds: embedded ``rich`` content :type embeds: Union[Embed, List[Embed]] - :param allowed_mentions: allowed mentions for the message - :type allowed_mentions: dict + :param allowed_mentions?: The allowed mentions for the message. + :type allowed_mentions?: Optional[Union[AllowedMentions, dict]] :param components: the components to include with the message :type components: Union[ActionRow, Button, SelectMenu, List[ActionRow], List[Button], List[SelectMenu]] :param files: The files to attach to the message @@ -240,7 +241,13 @@ async def execute( if not embeds or embeds is MISSING else ([embed._json for embed in embeds] if isinstance(embeds, list) else [embeds._json]) ) - _allowed_mentions: dict = {} if allowed_mentions is MISSING else allowed_mentions + _allowed_mentions: dict = ( + {} + if allowed_mentions is MISSING + else allowed_mentions._json + if isinstance(allowed_mentions, AllowedMentions) + else allowed_mentions + ) if not components or components is MISSING: _components = [] diff --git a/interactions/base.py b/interactions/base.py index afc7b9c13..6f96725a7 100644 --- a/interactions/base.py +++ b/interactions/base.py @@ -6,7 +6,7 @@ "__authors__", ) -__version__ = "4.3.1" +__version__ = "4.3.2" __authors__ = { "current": [ @@ -14,6 +14,7 @@ {"name": "EdVraz<@EdVraz>", "status": "Developer"}, {"name": "Astrea<@Astrea49>", "status": "Developer"}, {"name": "Toricane<@Toricane>", "status": "Developer"}, + {"name": "Catalyst<@Catalyst4222>", "status": "Developer"}, ], "old": [ {"name": "James Walston<@jameswalston>"}, diff --git a/interactions/client/__init__.py b/interactions/client/__init__.py index 4e66cfab0..5d0b8cdba 100644 --- a/interactions/client/__init__.py +++ b/interactions/client/__init__.py @@ -8,5 +8,4 @@ from .context import * # noqa: F401 F403 from .decor import * # noqa: F401 F403 from .enums import * # noqa: F401 F403 -from .get import * # noqa: F401 F403 from .models import * # noqa: F401 F403 diff --git a/interactions/client/bot.py b/interactions/client/bot.py index 6161b659b..fa74e4bd8 100644 --- a/interactions/client/bot.py +++ b/interactions/client/bot.py @@ -1,4 +1,5 @@ import contextlib +import logging import re import sys from asyncio import AbstractEventLoop, CancelledError, get_event_loop, iscoroutinefunction @@ -6,29 +7,27 @@ from importlib import import_module from importlib.util import resolve_name from inspect import getmembers -from logging import Logger from types import ModuleType from typing import Any, Callable, Coroutine, Dict, List, Optional, Tuple, Union from ..api import WebSocketClient as WSClient from ..api.error import LibraryException from ..api.http.client import HTTPClient -from ..api.models.attrs_utils import MISSING, convert_list -from ..api.models.channel import Channel from ..api.models.flags import Intents, Permissions from ..api.models.guild import Guild -from ..api.models.message import Message from ..api.models.misc import Image, Snowflake from ..api.models.presence import ClientPresence from ..api.models.team import Application from ..api.models.user import User from ..base import get_logger +from ..utils.attrs_utils import convert_list +from ..utils.missing import MISSING from .decor import component as _component from .enums import ApplicationCommandType, Locale, OptionType from .models.command import ApplicationCommand, Choice, Command, Option from .models.component import Button, Modal, SelectMenu -log: Logger = get_logger("client") +log: logging.Logger = get_logger("client") __all__ = ( "Client", @@ -59,6 +58,8 @@ class Client: :type default_scope?: Optional[Union[int, Guild, List[int], List[Guild]]] :param disable_sync?: Controls whether synchronization in the user-facing API should be automatic or not. :type disable_sync?: Optional[bool] + :param logging?: Set to ``True`` to enable debug logging or set to a log level to use a specific level + :type logging?: Optional[Union[bool, logging.DEBUG, logging.INFO, logging.NOTSET, logging.WARNING, logging.ERROR, logging.CRITICAL]] :ivar AbstractEventLoop _loop: The asynchronous event loop of the client. :ivar HTTPClient _http: The user-facing HTTP connection to the Web API, as its own separate client. @@ -68,7 +69,7 @@ class Client: :ivar Optional[ClientPresence] _presence: The RPC-like presence shown on an application once connected. :ivar str _token: The token of the application used for authentication when connecting. :ivar Optional[Dict[str, ModuleType]] _extensions: The "extensions" or cog equivalence registered to the main client. - :ivar Application me: The application representation of the client. + :ivar Application me?: The application representation of the client. """ def __init__( @@ -77,7 +78,7 @@ def __init__( **kwargs, ) -> None: self._loop: AbstractEventLoop = get_event_loop() - self._http: HTTPClient = HTTPClient(token=token) + self._http: HTTPClient = token self._intents: Intents = kwargs.get("intents", Intents.DEFAULT) self._websocket: WSClient = WSClient(token=token, intents=self._intents) self._shards: List[Tuple[int]] = kwargs.get("shards", []) @@ -90,9 +91,9 @@ def __init__( self.__command_coroutines = [] self.__global_commands = {} self.__guild_commands = {} - self.__name_autocomplete = {} - self.me = None + self.me: Optional[Application] = None + self.__id_autocomplete = {} if self._default_scope: if not isinstance(self._default_scope, list): self._default_scope = [self._default_scope] @@ -103,6 +104,21 @@ def __init__( ] self._default_scope = convert_list(int)(self._default_scope) + if _logging := kwargs.get("logging"): + + # thx i0 for posting this on the retux Discord + + if _logging is True: + _logging = logging.DEBUG + + _format = ( + "%(asctime)s [%(levelname)s] - .%(funcName)s(): %(message)s" + if _logging == logging.DEBUG + else "%(asctime)s [%(levelname)s] - %(message)s" + ) + + logging.basicConfig(format=_format, level=_logging) + if kwargs.get("disable_sync"): self._automate_sync = False log.warning( @@ -111,9 +127,6 @@ def __init__( else: self._automate_sync = True - data = self._loop.run_until_complete(self._http.get_current_bot_information()) - self.me = Application(**data, _client=self._http) - @property def guilds(self) -> List[Guild]: """Returns a list of guilds the bot is in.""" @@ -128,30 +141,35 @@ def latency(self) -> float: def start(self) -> None: """Starts the client session.""" + try: self._loop.run_until_complete(self._ready()) except (CancelledError, Exception) as e: + self._loop.run_until_complete(self._logout()) raise e from e except KeyboardInterrupt: log.error("KeyboardInterrupt detected, shutting down the bot.") - - def __register_events(self) -> None: - """Registers all raw gateway events to the known events.""" - self._websocket._dispatch.register(self.__raw_socket_create) - self._websocket._dispatch.register(self.__raw_channel_create, "on_channel_create") - self._websocket._dispatch.register(self.__raw_message_create, "on_message_create") - self._websocket._dispatch.register(self.__raw_guild_create, "on_guild_create") - - async def __register_name_autocomplete(self) -> None: - for key in self.__name_autocomplete.keys(): - _command_obj = self._find_command(key) - _command: Union[Snowflake, int] = int(_command_obj.id) - for _ in self.__name_autocomplete[key]: - # _ contains {"coro" : coro, "name": } - self.event( - _["coro"], - name=f"autocomplete_{_command}_{_['name']}", - ) + finally: + self._loop.run_until_complete(self._logout()) + + async def __register_id_autocomplete(self) -> None: # TODO: make this use ID and not name + for key in self.__id_autocomplete.keys(): + if isinstance(key, str): # compatibility with the decorator from the Command obj + for _ in self.__id_autocomplete[key]: + # _ contains {"coro" : coro, "name": } + self.event( + _["coro"], + name=f"autocomplete_{key}_{_['name']}", + ) + else: + _command_obj = self._find_command(key) + _command: str = _command_obj.name + for _ in self.__id_autocomplete[key]: + # _ contains {"coro" : coro, "name": } + self.event( + _["coro"], + name=f"autocomplete_{_command}_{_['name']}", + ) @staticmethod async def __compare_sync( @@ -194,7 +212,7 @@ def __check_options(command, data): if any(option not in _command_option_names for option in _data_option_names) or len( _data_option_names ) != len(_command_option_names): - return False, command + return False for option in command.get("options"): for _option in data.get("options"): @@ -206,7 +224,7 @@ def __check_options(command, data): or not option.get(option_attr) and _option.get(option_attr) ): - return False, command + return False elif option_attr == "choices": if not option.get("choices") or not _option.get("choices"): continue @@ -221,7 +239,7 @@ def __check_options(command, data): if any( _ not in _option_choice_names for _ in _data_choice_names ) or len(_data_choice_names) != len(_option_choice_names): - return False, command + return False for choice in option.get("choices"): for _choice in _option.get("choices"): @@ -233,17 +251,17 @@ def __check_options(command, data): or not choice.get(choice_attr) and _choice.get(choice_attr) ): - return False, command + return False elif choice.get(choice_attr) != _choice.get( choice_attr ): - return False, command + return False else: continue for i, __name in enumerate(_option_choice_names): if _data_choice_names[i] != __name: - return False, command + return False elif option_attr == "required": if ( @@ -256,22 +274,21 @@ def __check_options(command, data): elif option_attr == "options": if not option.get(option_attr) and not _option.get("options"): continue - _clean, _command = __check_options(option, _option) + _clean = __check_options(option, _option) if not _clean: - return _clean, _command + return _clean elif option.get(option_attr) != _option.get(option_attr): - return False, command + return False else: continue - return next( ( - (False, command) + False for i, __name in enumerate(_command_option_names) if _data_option_names[i] != __name ), - (True, command), + True, ) for command in pool: @@ -301,7 +318,7 @@ def __check_options(command, data): elif command.get("options") and data.get("options"): - clean, _command = __check_options(command, data) + clean = __check_options(command, data) if not clean: return clean, _command @@ -352,6 +369,12 @@ async def _ready(self) -> None: """ ready: bool = False + if isinstance(self._http, str): + self._http = HTTPClient(self._http) + + data = await self._http.get_current_bot_information() + self.me = Application(**data, _client=self._http) + try: if self.me.flags is not None: # This can be None. @@ -373,14 +396,13 @@ async def _ready(self) -> None: elif self._intents.value != Intents.DEFAULT.value: raise RuntimeError("Client not authorised for any privileged intents.") - self.__register_events() self.__resolve_commands() if self._automate_sync: await self.__sync() else: await self.__get_all_commands() - await self.__register_name_autocomplete() + await self.__register_id_autocomplete() ready = True except Exception: @@ -390,10 +412,42 @@ async def _ready(self) -> None: log.debug("Client is now ready.") await self._login() + async def _stop(self) -> None: + """Stops the websocket connection gracefully.""" + + log.debug("Shutting down the client....") + self._websocket.ready.clear() # Clears ready state. + self._websocket._closing_lock.set() # Toggles the "ready-to-shutdown" state for the bot. + # And subsequently, the processes will close itself. + + await self._http._req._session.close() # Closes the HTTP session associated with the client. + async def _login(self) -> None: """Makes a login with the Discord API.""" - while not self._websocket._closed: - await self._websocket._establish_connection(self._shards, self._presence) + + try: + await self._websocket.run() + except Exception: + log.exception("Websocket have raised an exception, closing.") + + if self._websocket._closing_lock.is_set(): + # signal for closing. + + try: + if self._websocket._task is not None: + self._websocket.__heartbeat_event.set() + try: + # Wait for the keep-alive handler to finish so we can discard it gracefully + await self._websocket._task + finally: + self._websocket._task = None + finally: # then the overall WS client + if self._websocket._client is not None: + # This needs to be properly closed + try: + await self._websocket._client.close(code=1000) + finally: + self._websocket._client = None async def wait_until_ready(self) -> None: """Helper method that waits until the websocket is ready.""" @@ -423,13 +477,13 @@ async def __get_all_commands(self) -> None: # responsible for checking if a command is in the cache but not a coro -> allowing removal for _id in _guild_ids: - _cmds = await self._http.get_application_commands( - application_id=self.me.id, guild_id=_id, with_localizations=True - ) - - if isinstance(_cmds, dict) and _cmds.get("code"): - if int(_cmds.get("code")) != 50001: - raise LibraryException(_cmds["code"], message=f'{_cmds["message"]} |') + try: + _cmds = await self._http.get_application_commands( + application_id=self.me.id, guild_id=_id, with_localizations=True + ) + except LibraryException as e: + if int(e.code) != 50001: + raise LibraryException(code=e.code, message=e.message) log.warning( f"Your bot is missing access to guild with corresponding id {_id}! " @@ -474,7 +528,7 @@ def __resolve_commands(self) -> None: ) if cmd.autocompletions: - self.__name_autocomplete.update(cmd.autocompletions) + self.__id_autocomplete.update(cmd.autocompletions) coro = coro.__func__ if hasattr(coro, "__func__") else coro @@ -802,7 +856,7 @@ def __check_options(_option: Option, _names: list, _sub_command: Option = MISSIN if not re.fullmatch(reg, _option.name): raise LibraryException( 11, - message=f"The option name does not match the regex for valid names ('{regex}')", + message=f"The option name ('{_option.name}') does not match the regex for valid names ('{regex}').", ) if _option.description is MISSING or not _option.description: raise LibraryException( @@ -864,7 +918,8 @@ def __check_coro(): and command.type == ApplicationCommandType.CHAT_INPUT ): raise LibraryException( - 11, message=f"Your command does not match the regex for valid names ('{regex}')" + 11, + message=f"Your command name ('{command.name}') does not match the regex for valid names ('{regex}').", ) elif command.type == ApplicationCommandType.CHAT_INPUT and ( command.description is MISSING or not command.description @@ -1000,6 +1055,7 @@ def decorator(coro: Callable[..., Coroutine]) -> Command: description_localizations=description_localizations, default_scope=default_scope, ) + cmd.client = self self._commands.append(cmd) return cmd @@ -1163,21 +1219,22 @@ def decorator(coro: Callable[..., Coroutine]) -> Callable[..., Coroutine]: return decorator - def _find_command(self, command: str) -> ApplicationCommand: + def _find_command(self, command: Union[str, int]) -> ApplicationCommand: """ Iterates over `commands` and returns an :class:`ApplicationCommand` if it matches the name from `command` - :param command: The name of the command to match - :type command: str + :param command: The name or ID of the command to match + :type command: Union[str, int] :return: An ApplicationCommand model :rtype: ApplicationCommand """ + key = "name" if isinstance(command, str) else "id" _command: Dict _command_obj = next( ( ApplicationCommand(**_command) for _command in self.__global_commands["commands"] - if _command["name"] == command + if str(_command[key]) == str(command) ), None, ) @@ -1188,7 +1245,7 @@ def _find_command(self, command: str) -> ApplicationCommand: ( ApplicationCommand(**_command) for _command in self.__guild_commands[scope]["commands"] - if _command["name"] == command + if str(_command[key]) == str(command) ), None, ) @@ -1232,10 +1289,10 @@ async def autocomplete_choice_list(ctx, user_input: str = ""): """ if isinstance(command, ApplicationCommand): - _command: Union[Snowflake, int] = command.id + _command: str = command.name elif isinstance(command, str): _command: str = command - elif isinstance(command, int) or isinstance(command, Snowflake): + elif isinstance(command, (int, Snowflake)): _command: Union[Snowflake, int] = int(command) else: raise LibraryException( @@ -1244,10 +1301,10 @@ async def autocomplete_choice_list(ctx, user_input: str = ""): ) def decorator(coro: Callable[..., Coroutine]) -> Callable[..., Coroutine]: - if isinstance(_command, str): - curr_autocomplete = self.__name_autocomplete.get(_command, []) + if isinstance(_command, (int, Snowflake)): + curr_autocomplete = self.__id_autocomplete.get(_command, []) curr_autocomplete.append({"coro": coro, "name": name}) - self.__name_autocomplete[_command] = curr_autocomplete + self.__id_autocomplete[_command] = curr_autocomplete return coro return self.event(coro, name=f"autocomplete_{_command}_{name}") @@ -1433,63 +1490,52 @@ async def modify( :return: The modified User object :rtype: User """ - payload: dict = {"username": username, "avatar": avatar.data} + payload: dict = {} + if avatar is not MISSING: + payload["avatar"] = avatar.data + if username is not MISSING: + payload["username"] = username data: dict = await self._http.modify_self(payload=payload) return User(**data) - async def __raw_socket_create(self, data: Dict[Any, Any]) -> Dict[Any, Any]: - """ - This is an internal function that takes any gateway socket event - and then returns the data purely based off of what it does in - the client instantiation class. - - :param data: The data that is returned - :type data: Dict[Any, Any] - :return: A dictionary of raw data. - :rtype: Dict[Any, Any] - """ - - return data - - async def __raw_channel_create(self, channel) -> dict: - """ - This is an internal function that caches the channel creates when dispatched. - - :param channel: The channel object data in question. - :type channel: Channel - :return: The channel as a dictionary of raw data. - :rtype: dict - """ - self._http.cache[Channel].add(channel) - - return channel._json - - async def __raw_message_create(self, message) -> dict: - """ - This is an internal function that caches the message creates when dispatched. - - :param message: The message object data in question. - :type message: Message - :return: The message as a dictionary of raw data. - :rtype: dict - """ - self._http.cache[Message].add(message) - - return message._json - - async def __raw_guild_create(self, guild) -> dict: + async def request_guild_members( + self, + guild_id: Union[Guild, Snowflake, int, str], + limit: Optional[int] = MISSING, + query: Optional[str] = MISSING, + presences: Optional[bool] = MISSING, + user_ids: Optional[Union[Snowflake, List[Snowflake]]] = MISSING, + nonce: Optional[str] = MISSING, + ) -> None: """ - This is an internal function that caches the guild creates on ready. - - :param guild: The guild object data in question. - :type guild: Guild - :return: The guild as a dictionary of raw data. - :rtype: dict + Requests guild members via websocket. + + :param guild_id: ID of the guild to get members for. + :type guild_id: Union[Guild, Snowflake, int, str] + :param limit: Maximum number of members to send matching the 'query' parameter. Required when specifying 'query'. + :type limit: Optional[int] + :param query: String that username starts with. + :type query: Optional[str] + :param presences: Used to specify if we want the presences of the matched members. + :type presences: Optional[bool] + :param user_ids: Used to specify which users you wish to fetch. + :type user_ids: Optional[Union[Snowflake, List[Snowflake]]] + :param nonce: Nonce to identify the Guild Members Chunk response. + :type nonce: Optional[str] """ - self._http.cache[Guild].add(guild) + await self._websocket.request_guild_members( + guild_id=int(guild_id.id) if isinstance(guild_id, Guild) else int(guild_id), + limit=limit if limit is not MISSING else 0, + query=query if query is not MISSING else None, + presences=presences if presences is not MISSING else None, + user_ids=user_ids if user_ids is not MISSING else None, + nonce=nonce if nonce is not MISSING else None, + ) - return guild._json + async def _logout(self) -> None: + await self._websocket.close() + await self._http._req.close() # TODO: Implement the rest of cog behaviour when possible. @@ -1596,6 +1642,7 @@ def __new__(cls, client: Client, *args, **kwargs) -> "Extension": continue cmd.extension = self + cmd.client = self.client self.client._commands.append(cmd) commands = self._commands.get(cmd.name, []) diff --git a/interactions/client/context.py b/interactions/client/context.py index 5244cb917..eb4a52246 100644 --- a/interactions/client/context.py +++ b/interactions/client/context.py @@ -1,22 +1,26 @@ from logging import Logger -from typing import List, Optional, Union +from typing import TYPE_CHECKING, List, Optional, Union from ..api.error import LibraryException -from ..api.http.client import HTTPClient -from ..api.models.attrs_utils import MISSING, ClientSerializerMixin, convert_int, define, field from ..api.models.channel import Channel from ..api.models.flags import Permissions from ..api.models.guild import Guild from ..api.models.member import Member -from ..api.models.message import Attachment, Embed, Message, MessageInteraction, MessageReference -from ..api.models.misc import Snowflake +from ..api.models.message import Attachment, Embed, Message, MessageReference +from ..api.models.misc import AllowedMentions, Snowflake from ..api.models.user import User from ..base import get_logger -from .enums import InteractionCallbackType, InteractionType +from ..utils.attrs_utils import ClientSerializerMixin, convert_int, define, field +from ..utils.missing import MISSING +from .enums import ComponentType, InteractionCallbackType, InteractionType from .models.command import Choice from .models.component import ActionRow, Button, Modal, SelectMenu, _build_components from .models.misc import InteractionData +if TYPE_CHECKING: + from .bot import Client, Extension + from .models.command import Command + log: Logger = get_logger("context") __all__ = ( @@ -42,7 +46,6 @@ class _Context(ClientSerializerMixin): :ivar Optional[Guild] guild: The guild data model. """ - client: HTTPClient = field(default=None) message: Optional[Message] = field(converter=Message, default=None, add_client=True) author: Member = field(converter=Member, default=None, add_client=True) member: Member = field(converter=Member, add_client=True) @@ -65,8 +68,10 @@ class _Context(ClientSerializerMixin): app_permissions: Permissions = field(converter=convert_int(Permissions), default=None) def __attrs_post_init__(self) -> None: - # backwards compatibility - self.client = self._client + if self.member: + if self.guild_id: + self.member._extras["guild_id"] = self.guild_id + self.author = self.member if self.user is None: @@ -109,11 +114,12 @@ async def send( tts: Optional[bool] = MISSING, attachments: Optional[List[Attachment]] = MISSING, embeds: Optional[Union[Embed, List[Embed]]] = MISSING, - allowed_mentions: Optional[MessageInteraction] = MISSING, + allowed_mentions: Optional[Union[AllowedMentions, dict]] = MISSING, components: Optional[ Union[ActionRow, Button, SelectMenu, List[ActionRow], List[Button], List[SelectMenu]] ] = MISSING, ephemeral: Optional[bool] = False, + suppress_embeds: bool = False, ) -> dict: """ This allows the invocation state described in the "context" @@ -127,12 +133,14 @@ async def send( :type attachments?: Optional[List[Attachment]] :param embeds?: An embed, or list of embeds for the message. :type embeds?: Optional[Union[Embed, List[Embed]]] - :param allowed_mentions?: The message interactions/mention limits that the message can refer to. - :type allowed_mentions?: Optional[MessageInteraction] + :param allowed_mentions?: The allowed mentions for the message. + :type allowed_mentions?: Optional[Union[AllowedMentions, dict]] :param components?: A component, or list of components for the message. :type components?: Optional[Union[ActionRow, Button, SelectMenu, List[Union[ActionRow, Button, SelectMenu]]]] :param ephemeral?: Whether the response is hidden or not. :type ephemeral?: Optional[bool] + :param suppress_embeds: Whether embeds are not shown in the message. + :type suppress_embeds: bool :return: The sent message as an object. :rtype: Message """ @@ -157,7 +165,13 @@ async def send( if not embeds or embeds is MISSING else ([embed._json for embed in embeds] if isinstance(embeds, list) else [embeds._json]) ) - _allowed_mentions: dict = {} if allowed_mentions is MISSING else allowed_mentions + _allowed_mentions: dict = ( + {} + if allowed_mentions is MISSING + else allowed_mentions._json + if isinstance(allowed_mentions, AllowedMentions) + else allowed_mentions + ) if components is not MISSING and components: # components could be not missing but an empty list @@ -177,7 +191,9 @@ async def send( else: _components = [] - _ephemeral: int = (1 << 6) if ephemeral else 0 + _flags: int = (1 << 6) if ephemeral else 0 + if suppress_embeds: + _flags += 1 << 2 _attachments = [] if attachments is MISSING else [a._json for a in attachments] @@ -188,7 +204,7 @@ async def send( allowed_mentions=_allowed_mentions, components=_components, attachments=_attachments, - flags=_ephemeral, + flags=_flags, ) async def edit( @@ -198,7 +214,7 @@ async def edit( tts: Optional[bool] = MISSING, attachments: Optional[List[Attachment]] = MISSING, embeds: Optional[Union[Embed, List[Embed]]] = MISSING, - allowed_mentions: Optional[MessageInteraction] = MISSING, + allowed_mentions: Optional[Union[AllowedMentions, dict]] = MISSING, message_reference: Optional[MessageReference] = MISSING, components: Optional[ Union[ActionRow, Button, SelectMenu, List[ActionRow], List[Button], List[SelectMenu]] @@ -247,7 +263,13 @@ async def edit( payload["attachments"] = _attachments - _allowed_mentions: dict = {} if allowed_mentions is MISSING else allowed_mentions + _allowed_mentions: dict = ( + {} + if allowed_mentions is MISSING + else allowed_mentions._json + if isinstance(allowed_mentions, AllowedMentions) + else allowed_mentions + ) _message_reference: dict = {} if message_reference is MISSING else message_reference._json payload["allowed_mentions"] = _allowed_mentions @@ -265,7 +287,7 @@ async def edit( return payload - async def popup(self, modal: Modal) -> None: + async def popup(self, modal: Modal) -> dict: """ This "pops up" a modal to present information back to the user. @@ -292,6 +314,30 @@ async def popup(self, modal: Modal) -> None: return payload + async def has_permissions( + self, *permissions: Union[int, Permissions], operator: str = "and" + ) -> bool: + """ + Returns whether the author of the interaction has the permissions in the given context. + + :param *permissions: The list of permissions + :type *permissions: Union[int, Permissions] + :param operator: The operator to use to calculate permissions. Possible values: `and`, `or`. Defaults to `and`. + :type operator: str + :return: Whether the author has the permissions + :rtype: bool + """ + if operator == "and": + for perm in permissions: + if perm not in self.author.permissions: + return False + return True + else: + for perm in permissions: + if perm in self.author.permissions: + return True + return False + @define() class CommandContext(_Context): @@ -325,10 +371,17 @@ class CommandContext(_Context): :ivar str locale?: The selected language of the user invoking the interaction. :ivar str guild_locale?: The guild's preferred language, if invoked in a guild. :ivar str app_permissions?: Bitwise set of permissions the bot has within the channel the interaction was sent from. + :ivar Client client: The client instance that the command belongs to. + :ivar Command command: The command object that is being invoked. + :ivar Extension extension: The extension the command belongs to. """ target: Optional[Union[Message, Member, User]] = field(default=None) + client: "Client" = field(default=None, init=False) + command: "Command" = field(default=None, init=False) + extension: "Extension" = field(default=None, init=False) + def __attrs_post_init__(self) -> None: super().__attrs_post_init__() @@ -346,6 +399,8 @@ def __attrs_post_init__(self) -> None: elif self.data.type == 3: self.target = self.data.resolved.messages[target] + self.target._client = self._client + async def edit(self, content: Optional[str] = MISSING, **kwargs) -> Message: payload = await super().edit(content, **kwargs) @@ -654,13 +709,54 @@ async def defer( self.responded = True + async def disable_all_components( + self, respond_to_interaction: Optional[bool] = True, **other_kwargs: Optional[dict] + ) -> Message: + r""" + Disables all components of the message. + + :param respond_to_interaction?: Whether the components should be disabled in an interaction response, default True + :type respond_to_interaction?: Optional[bool] + :param \**other_kwargs?: Additional keyword-arguments to pass to the edit method. This only works when this method is used as interaction response and takes the same arguments as :meth:`interactions.client.context._Context:edit()` + :type \**other_kwargs?: Optional[dict] + + :return: The modified Message + :rtype: Message + """ + + if not respond_to_interaction: + return await self.message.disable_all_components() + + else: + for components in self.message.components: + for component in components.components: + component.disabled = True + + if other_kwargs.get("components"): + raise LibraryException( + 12, "You must not specify the `components` argument in this method." + ) + + other_kwargs["components"] = self.message.components + return await self.edit(**other_kwargs) + @property def custom_id(self) -> Optional[str]: return self.data.custom_id @property def label(self) -> Optional[str]: + """ + The label of the interacted button. + :rtype: Optional[str] + """ + if not self.data.component_type == ComponentType.BUTTON: + return + if self.message is None: + return + if self.message.components is None: + return for action_row in self.message.components: - for component in action_row["components"]: - if component["custom_id"] == self.custom_id and component["type"] == 2: - return component.get("label") + for component in action_row.components: + if component.custom_id == self.custom_id: + return component.label diff --git a/interactions/client/decor.py b/interactions/client/decor.py index e3063fe4b..1cb876ce1 100644 --- a/interactions/client/decor.py +++ b/interactions/client/decor.py @@ -1,8 +1,8 @@ from typing import Any, Dict, List, Optional, Union -from ..api.models.attrs_utils import MISSING from ..api.models.flags import Permissions from ..api.models.guild import Guild +from ..utils.missing import MISSING from .enums import ApplicationCommandType, Locale from .models.command import ApplicationCommand, Option from .models.component import Button, Component, SelectMenu diff --git a/interactions/client/models/__init__.py b/interactions/client/models/__init__.py index 940e80a30..27e80b668 100644 --- a/interactions/client/models/__init__.py +++ b/interactions/client/models/__init__.py @@ -8,4 +8,3 @@ from .command import * # noqa: F401 F403 from .component import * # noqa: F401 F403 from .misc import * # noqa: F401 F403 -from .utils import * # noqa: F401 F403 diff --git a/interactions/client/models/command.py b/interactions/client/models/command.py index 8f29d7bbb..c92d3cabf 100644 --- a/interactions/client/models/command.py +++ b/interactions/client/models/command.py @@ -4,7 +4,6 @@ from typing import TYPE_CHECKING, Any, Awaitable, Callable, Coroutine, Dict, List, Optional, Union from ...api.error import LibraryException -from ...api.models.attrs_utils import MISSING, DictSerializerMixin, convert_list, define, field from ...api.models.channel import Channel, ChannelType from ...api.models.guild import Guild from ...api.models.member import Member @@ -12,11 +11,13 @@ from ...api.models.misc import Snowflake from ...api.models.role import Role from ...api.models.user import User +from ...utils.attrs_utils import DictSerializerMixin, convert_list, define, field +from ...utils.missing import MISSING from ..enums import ApplicationCommandType, Locale, OptionType, PermissionType if TYPE_CHECKING: from ...api.dispatch import Listener - from ..bot import Extension + from ..bot import Client, Extension from ..context import CommandContext __all__ = ( @@ -412,6 +413,7 @@ class Command(DictSerializerMixin): :ivar Optional[str] recent_group: The name of the group most recently utilized. :ivar bool resolved: Whether the command is synced. Defaults to ``False``. :ivar Optional[Extension] extension: The extension that the command belongs to, if any. + :ivar Client client: The client that the command belongs to. :ivar Optional[Listener] listener: The listener, used for dispatching command errors. """ @@ -436,6 +438,7 @@ class Command(DictSerializerMixin): error_callback: Optional[Callable[..., Awaitable]] = field(default=None, init=False) resolved: bool = field(default=False, init=False) extension: Optional["Extension"] = field(default=None, init=False) + client: "Client" = field(default=None, init=False) listener: Optional["Listener"] = field(default=None, init=False) def __attrs_post_init__(self) -> None: @@ -816,59 +819,83 @@ async def command_error(ctx, error): message=f"Your command needs at least {'three parameters to return self, context, and the' if self.extension else 'two parameter to return context and'} error.", ) - self.error_callback = self.__wrap_coro(coro) + self.error_callback = self.__wrap_coro(coro, error_callback=True) return coro async def __call( self, coro: Callable[..., Awaitable], ctx: "CommandContext", - *args, + *args, # empty for now since all parameters are dispatched as kwargs _name: Optional[str] = None, _res: Optional[Union[BaseResult, GroupResult]] = None, **kwargs, ) -> Optional[Any]: """Handles calling the coroutine based on parameter count.""" - param_len = len(signature(coro).parameters) - opt_len = self.num_options.get(_name, len(args) + len(kwargs)) + params = signature(coro).parameters + param_len = len(params) + opt_len = self.num_options.get(_name, len(args) + len(kwargs)) # options of slash command + last = params[list(params)[-1]] # last parameter + has_args = any(param.kind == param.VAR_POSITIONAL for param in params.values()) # any *args + index_of_var_pos = next( + (i for i, param in enumerate(params.values()) if param.kind == param.VAR_POSITIONAL), + param_len, + ) # index of *args + par_opts = list(params.keys())[ + (num := 2 if self.extension else 1) : ( + -1 if last.kind in (last.VAR_POSITIONAL, last.VAR_KEYWORD) else index_of_var_pos + ) + ] # parameters that are before *args and **kwargs + keyword_only_args = list(params.keys())[index_of_var_pos:] # parameters after *args try: _coro = coro if hasattr(coro, "_wrapped") else self.__wrap_coro(coro) - if param_len < (2 if self.extension else 1): + if last.kind == last.VAR_KEYWORD: # foo(ctx, ..., **kwargs) + return await _coro(ctx, *args, **kwargs) + if last.kind == last.VAR_POSITIONAL: # foo(ctx, ..., *args) + return await _coro( + ctx, + *(kwargs[opt] for opt in par_opts if opt in kwargs), + *args, + ) + if has_args: # foo(ctx, ..., *args, ..., **kwargs) OR foo(ctx, *args, ...) + return await _coro( + ctx, + *(kwargs[opt] for opt in par_opts if opt in kwargs), # pos before *args + *args, + *( + kwargs[opt] + for opt in kwargs + if opt not in par_opts and opt not in keyword_only_args + ), # additional args + **{ + opt: kwargs[opt] + for opt in kwargs + if opt not in par_opts and opt in keyword_only_args + }, # kwargs after *args + ) + + if param_len < num: + inner_msg: str = f"{num} parameter{'s' if num > 1 else ''} to return" + ( + " self and" if self.extension else "" + ) raise LibraryException( - code=11, - message=f"Your command needs at least {'two parameters to return self and' if self.extension else 'one parameter to return'} context.", + code=11, message=f"Your command needs at least {inner_msg} context." ) - if param_len == (2 if self.extension else 1): + if param_len == num: return await _coro(ctx) if _res: - if param_len - opt_len == (2 if self.extension else 1): + if param_len - opt_len == num: return await _coro(ctx, *args, **kwargs) - elif param_len - opt_len == (3 if self.extension else 2): + elif param_len - opt_len == num + 1: return await _coro(ctx, _res, *args, **kwargs) return await _coro(ctx, *args, **kwargs) except CancelledError: pass - except Exception as e: - if self.error_callback: - num_params = len(signature(self.error_callback).parameters) - - if num_params == (3 if self.extension else 2): - await self.error_callback(ctx, e) - elif num_params == (4 if self.extension else 3): - await self.error_callback(ctx, e, _res) - else: - await self.error_callback(ctx, e, _res, *args, **kwargs) - elif self.listener and "on_command_error" in self.listener.events: - self.listener.dispatch("on_command_error", ctx, e) - else: - raise e - - return StopCommand def __check_command(self, command_type: str) -> None: """Checks if subcommands, groups, or autocompletions are created on context menus.""" @@ -895,11 +922,17 @@ async def __no_group(self, *args, **kwargs) -> None: """This is the coroutine used when no group coroutine is provided.""" pass - def __wrap_coro(self, coro: Callable[..., Awaitable]) -> Callable[..., Awaitable]: + def __wrap_coro( + self, coro: Callable[..., Awaitable], /, *, error_callback: bool = False + ) -> Callable[..., Awaitable]: """Wraps a coroutine to make sure the :class:`interactions.client.bot.Extension` is passed to the coroutine, if any.""" @wraps(coro) async def wrapper(ctx: "CommandContext", *args, **kwargs): + ctx.client = self.client + ctx.command = self + ctx.extension = self.extension + try: if self.extension: return await coro(self.extension, ctx, *args, **kwargs) @@ -907,11 +940,28 @@ async def wrapper(ctx: "CommandContext", *args, **kwargs): except CancelledError: pass except Exception as e: + if error_callback: + raise e if self.error_callback: - num_params = len(signature(self.error_callback).parameters) - - if num_params == (3 if self.extension else 2): + params = signature(self.error_callback).parameters + num_params = len(params) + last = params[list(params)[-1]] + num = 2 if self.extension else 1 + + if num_params == num: + await self.error_callback(ctx) + elif num_params == num + 1: await self.error_callback(ctx, e) + elif last.kind == last.VAR_KEYWORD: + if num_params == num + 2: + await self.error_callback(ctx, e, **kwargs) + elif num_params >= num + 3: + await self.error_callback(ctx, e, *args, **kwargs) + elif last.kind == last.VAR_POSITIONAL: + if num_params == num + 2: + await self.error_callback(ctx, e, *args) + elif num_params >= num + 3: + await self.error_callback(ctx, e, *args, **kwargs) else: await self.error_callback(ctx, e, *args, **kwargs) elif self.listener and "on_command_error" in self.listener.events: diff --git a/interactions/client/models/component.py b/interactions/client/models/component.py index 2d59978ab..c7ff13809 100644 --- a/interactions/client/models/component.py +++ b/interactions/client/models/component.py @@ -2,8 +2,9 @@ from typing import List, Optional, Union from ...api.error import LibraryException -from ...api.models.attrs_utils import MISSING, DictSerializerMixin, convert_list, define, field from ...api.models.emoji import Emoji +from ...utils.attrs_utils import DictSerializerMixin, convert_list, define, field +from ...utils.missing import MISSING from ..enums import ButtonStyle, ComponentType, TextStyleType __all__ = ( @@ -242,7 +243,7 @@ class Modal(ComponentMixin): """ custom_id: str = field() - title: str = field + title: str = field() components: List[Component] = field(converter=convert_list(Component)) def __attrs_post_init__(self): diff --git a/interactions/client/models/misc.py b/interactions/client/models/misc.py index 7106e7ec1..62f4aa9c8 100644 --- a/interactions/client/models/misc.py +++ b/interactions/client/models/misc.py @@ -1,12 +1,12 @@ from typing import Dict, List, Optional -from ...api.models.attrs_utils import DictSerializerMixin, convert_dict, convert_list, define, field from ...api.models.channel import Channel from ...api.models.member import Member from ...api.models.message import Attachment, Message from ...api.models.misc import Snowflake from ...api.models.role import Role from ...api.models.user import User +from ...utils.attrs_utils import DictSerializerMixin, convert_dict, convert_list, define, field from ..enums import ApplicationCommandType, ComponentType, InteractionType, PermissionType from ..models.command import Option from .component import ActionRow @@ -103,6 +103,11 @@ class Interaction(DictSerializerMixin): version: int = field() message: Optional[Message] = field(converter=Message, default=None, add_client=True) + def __attrs_post_init__(self): + if self.member: + if self.guild_id: + self.member._extras["guild_id"] = self.guild_id + @define() class Permission(DictSerializerMixin): diff --git a/interactions/client/models/utils.py b/interactions/client/models/utils.py deleted file mode 100644 index 81b1d6be1..000000000 --- a/interactions/client/models/utils.py +++ /dev/null @@ -1,170 +0,0 @@ -from asyncio import Task, get_running_loop, sleep -from functools import wraps -from typing import TYPE_CHECKING, Awaitable, Callable, Iterable, List, Optional, TypeVar, Union - -from ...api.error import LibraryException -from .component import ActionRow, Button, SelectMenu - -if TYPE_CHECKING: - from ..context import CommandContext - -__all__ = ("autodefer", "spread_to_rows", "search_iterable") - -_T = TypeVar("_T") - - -def autodefer( - delay: Union[float, int] = 2, - ephemeral: bool = False, - edit_origin: bool = False, -) -> Callable[[Callable[..., Awaitable]], Callable[..., Awaitable]]: - """ - A decorator that automatically defers a command if it did not respond within ``delay`` seconds. - - The structure of the decorator is: - - .. code-block:: python - - @bot.command() - @autodefer() # configurable - async def command(ctx): - await asyncio.sleep(5) - await ctx.send("I'm awake now!") - - :param delay?: The amount of time in seconds to wait before defering the command. Defaults to ``2`` seconds. - :type delay?: Union[float, int] - :param ephemeral?: Whether the command is deferred ephemerally. Defaults to ``False``. - :type ephemeral?: bool - :param edit_origin?: Whether the command is deferred on origin. Defaults to ``False``. - :type edit_origin?: bool - :return: The inner function, for decorating. - :rtype: - """ - - def decorator(coro: Callable[..., Awaitable]) -> Callable[..., Awaitable]: - from ..context import ComponentContext - - @wraps(coro) - async def deferring_func(ctx: Union["CommandContext", "ComponentContext"], *args, **kwargs): - try: - loop = get_running_loop() - except RuntimeError as e: - raise RuntimeError("No running event loop detected!") from e - task: Task = loop.create_task(coro(ctx, *args, **kwargs)) - - await sleep(delay) - - if task.done(): - return task.result() - - if not (ctx.deferred or ctx.responded): - if isinstance(ctx, ComponentContext): - await ctx.defer(ephemeral=ephemeral, edit_origin=edit_origin) - else: - await ctx.defer(ephemeral=ephemeral) - - return await task - - return deferring_func - - return decorator - - -def spread_to_rows( - *components: Union[ActionRow, Button, SelectMenu], max_in_row: int = 5 -) -> List[ActionRow]: - r""" - A helper function that spreads components into :class:`ActionRow` s. - - Example: - - .. code-block:: python - - @bot.command() - async def command(ctx): - b1 = Button(style=1, custom_id="b1", label="b1") - b2 = Button(style=1, custom_id="b2", label="b2") - s1 = SelectMenu( - custom_id="s1", - options=[ - SelectOption(label="1", value="1"), - SelectOption(label="2", value="2"), - ], - ) - b3 = Button(style=1, custom_id="b3", label="b3") - b4 = Button(style=1, custom_id="b4", label="b4") - - await ctx.send("Components:", components=spread_to_rows(b1, b2, s1, b3, b4)) - - .. note:: - You can only pass in :class:`ActionRow`s, :class:`Button`s, and :class:`SelectMenu`s, but in any order. - - :param \*components: The components to spread. - :type \*components: Union[ActionRow, Button, SelectMenu] - :param max_in_row?: The maximum number of components in a single row. Defaults to ``5``. - :type max_in_row?: int - """ - if not components or len(components) > 25: - raise LibraryException(code=12, message="Number of components should be between 1 and 25.") - if not 1 <= max_in_row <= 5: - raise LibraryException(code=12, message="max_in_row should be between 1 and 5.") - - rows: List[ActionRow] = [] - action_row: List[Union[Button, SelectMenu]] = [] - - for component in list(components): - if component is not None and isinstance(component, Button): - action_row.append(component) - - if len(action_row) == max_in_row: - rows.append(ActionRow(components=action_row)) - action_row = [] - - continue - - if action_row: - rows.append(ActionRow(components=action_row)) - action_row = [] - - if component is not None: - if isinstance(component, ActionRow): - rows.append(component) - elif isinstance(component, SelectMenu): - rows.append(ActionRow(components=[component])) - - if action_row: - rows.append(ActionRow(components=action_row)) - - if len(rows) > 5: - raise LibraryException(code=12, message="Number of rows exceeds 5.") - - return rows - - -def search_iterable( - iterable: Iterable[_T], check: Optional[Callable[[_T], bool]] = None, /, **kwargs -) -> List[_T]: - """ - Searches through an iterable for items that: - - Are True for the check, if one is given - - Have attributes that match the keyword arguments (e.x. passing `id=your_id` will only return objects with that id) - - :param iterable: The iterable to search through - :type iterable: Iterable - :param check: The check that items will be checked against - :type check: Callable[[Any], bool] - :param kwargs: Any attributes the items should have - :type kwargs: Any - :return: All items that match the check and keywords - :rtype: list - """ - if check: - iterable = filter(check, iterable) - - if kwargs: - iterable = filter( - lambda item: all(getattr(item, attr) == value for attr, value in kwargs.items()), - iterable, - ) - - return list(iterable) diff --git a/interactions/utils/__init__.py b/interactions/utils/__init__.py new file mode 100644 index 000000000..6c2e0f853 --- /dev/null +++ b/interactions/utils/__init__.py @@ -0,0 +1,4 @@ +from .attrs_utils import * # noqa: F401 F403 +from .get import * # noqa: F401 F403 +from .missing import * # noqa: F401 F403 +from .utils import * # noqa: F401 F403 diff --git a/interactions/utils/abc/__init__.py b/interactions/utils/abc/__init__.py new file mode 100644 index 000000000..915c0bf4d --- /dev/null +++ b/interactions/utils/abc/__init__.py @@ -0,0 +1,2 @@ +from .base_context_managers import * # noqa: F401 F403 +from .base_iterators import * # noqa: F401 F403 diff --git a/interactions/utils/abc/base_context_managers.py b/interactions/utils/abc/base_context_managers.py new file mode 100644 index 000000000..fe5856672 --- /dev/null +++ b/interactions/utils/abc/base_context_managers.py @@ -0,0 +1,38 @@ +from abc import ABCMeta, abstractmethod +from typing import TypeVar + +_T = TypeVar("_T") + +__all__ = ("BaseAsyncContextManager", "BaseContextManager") + + +class BaseAsyncContextManager(metaclass=ABCMeta): + """A base class for async iterators.""" + + # I don't want to make it subclass the BaseContextManager since it forces implementation of __enter__ and __exit__ + + @abstractmethod + def __init__(self): + raise NotImplementedError + + @abstractmethod + async def __aenter__(self): + raise NotImplementedError + + @abstractmethod + async def __aexit__(self, exc_type, exc_val, exc_tb): + raise NotImplementedError + + +class BaseContextManager(metaclass=ABCMeta): + @abstractmethod + def __init__(self): + raise NotImplementedError + + @abstractmethod + def __enter__(self): + raise NotImplementedError + + @abstractmethod + def __exit__(self, exc_type, exc_val, exc_tb): + raise NotImplementedError diff --git a/interactions/utils/abc/base_iterators.py b/interactions/utils/abc/base_iterators.py new file mode 100644 index 000000000..67443c8f6 --- /dev/null +++ b/interactions/utils/abc/base_iterators.py @@ -0,0 +1,78 @@ +from abc import ABCMeta, abstractmethod +from math import inf +from typing import TYPE_CHECKING, Callable, List, Optional, TypeVar, Union + +from ..missing import MISSING + +_T = TypeVar("_T") +_O = TypeVar("_O") + +__all__ = ("BaseAsyncIterator", "BaseIterator", "DiscordPaginationIterator") + +if TYPE_CHECKING: + from ...api.http.client import HTTPClient + from ...api.models.misc import Snowflake + + +class BaseAsyncIterator(metaclass=ABCMeta): + """A base class for async iterators.""" + + # I don't want to make it subclass the BaseIterator since it forces implementation of __next__ and __iter__ + + @abstractmethod + def __init__(self): + raise NotImplementedError + + def __aiter__(self): + return self + + async def flatten(self): + return [item async for item in self] + + @abstractmethod + async def __anext__(self) -> _O: + raise NotImplementedError + + +class DiscordPaginationIterator(BaseAsyncIterator, metaclass=ABCMeta): + def __init__( + self, + obj: Union[int, str, "Snowflake", _T] = None, + _client: Optional["HTTPClient"] = None, + maximum: Optional[int] = inf, + start_at: Optional[Union[int, str, "Snowflake", _O]] = MISSING, + check: Optional[Callable[[_O], bool]] = None, + ): + + self.object_id = None if not obj else int(obj) if not hasattr(obj, "id") else int(obj.id) + self.maximum = maximum + self.check = check + self._client = _client + self.object_count: int = 0 + self.start_at = ( + None + if start_at is MISSING + else int(start_at) + if not hasattr(start_at, "id") + else int(start_at.id) + ) + self.__stop: bool = False + self.objects: Optional[List[_O]] = None + + +class BaseIterator(metaclass=ABCMeta): + """A base class for iterators""" + + @abstractmethod + def __init__(self): + raise NotImplementedError + + def __iter__(self): + return self + + def flatten(self): + return [item for item in self] + + @abstractmethod + def __next__(self) -> _O: + raise NotImplementedError diff --git a/interactions/api/models/attrs_utils.py b/interactions/utils/attrs_utils.py similarity index 96% rename from interactions/api/models/attrs_utils.py rename to interactions/utils/attrs_utils.py index 5f241b647..d1dd9e75f 100644 --- a/interactions/api/models/attrs_utils.py +++ b/interactions/utils/attrs_utils.py @@ -4,13 +4,12 @@ import attrs -__all__ = ("MISSING", "DictSerializerMixin", "ClientSerializerMixin") +from .missing import MISSING - -class MISSING: - """A pseudosentinel based from an empty object. This does violate PEP, but, I don't care.""" - - ... +__all__ = ( + "DictSerializerMixin", + "ClientSerializerMixin", +) @attrs.define(eq=False, init=False, on_setattr=attrs.setters.NO_OP) @@ -74,7 +73,7 @@ def __init__(self, kwargs_dict: dict = None, /, **other_kwargs): passed_kwargs[attrib_name] = value - elif attrib.default: + elif attrib.default is not attrs.NOTHING: # handle defaults like attrs does default = attrib.default if isinstance(default, attrs.Factory): # type: ignore @@ -223,7 +222,7 @@ def define(**kwargs): def field( converter=None, default=attrs.NOTHING, - repr=False, + repr=True, add_client: bool = False, discord_name: str = None, **kwargs, diff --git a/interactions/api/models/attrs_utils.pyi b/interactions/utils/attrs_utils.pyi similarity index 95% rename from interactions/api/models/attrs_utils.pyi rename to interactions/utils/attrs_utils.pyi index 9712ebaca..7845f3c9a 100644 --- a/interactions/api/models/attrs_utils.pyi +++ b/interactions/utils/attrs_utils.pyi @@ -8,10 +8,6 @@ from interactions.api.http.client import HTTPClient _T = TypeVar("_T") _P = TypeVar("_P") -class MISSING: - """A pseudosentinel based from an empty object. This does violate PEP, but, I don't care.""" - - ... @attrs.define(eq=False, init=False, on_setattr=attrs.setters.NO_OP) class DictSerializerMixin: @@ -20,8 +16,10 @@ class DictSerializerMixin: """A dict containing values that were not serialized from Discord.""" __deepcopy_kwargs__: bool = attrs.field(init=False) """Should the kwargs be deepcopied or not?""" + def __init__(self, kwargs_dict: dict = None, /, **other_kwargs): ... + @attrs.define(eq=False, init=False, on_setattr=attrs.setters.NO_OP) class ClientSerializerMixin(DictSerializerMixin): _client: HTTPClient = attrs.field(init=False) diff --git a/interactions/client/get.py b/interactions/utils/get.py similarity index 93% rename from interactions/client/get.py rename to interactions/utils/get.py index ff64a6fa2..857038725 100644 --- a/interactions/client/get.py +++ b/interactions/utils/get.py @@ -2,7 +2,7 @@ from enum import Enum from inspect import isawaitable from logging import getLogger -from typing import Coroutine, List, Optional, Type, TypeVar, Union, get_args +from typing import TYPE_CHECKING, Coroutine, List, Optional, Type, TypeVar, Union, get_args try: from typing import _GenericAlias @@ -13,19 +13,20 @@ from sys import version_info from ..api.error import LibraryException -from ..api.http.client import HTTPClient from ..api.models.emoji import Emoji -from ..api.models.guild import Guild from ..api.models.member import Member from ..api.models.message import Message from ..api.models.misc import Snowflake from ..api.models.role import Role -from .bot import Client log = getLogger("get") _T = TypeVar("_T") +if TYPE_CHECKING: + from ..api.http.client import HTTPClient + from ..client.bot import Client + __all__ = ( "get", "Force", @@ -44,7 +45,7 @@ class Force(str, Enum): HTTP = "http" -def get(client: Client, obj: Type[_T], **kwargs) -> Optional[_T]: +def get(client: "Client", obj: Type[_T], **kwargs) -> Optional[_T]: """ Helper method to get an object. @@ -163,8 +164,6 @@ def get(client: Client, obj: Type[_T], **kwargs) -> Optional[_T]: If you enforce cache when getting a list of objects, found objets will be placed into the list and not found objects will be placed as ``None`` into the list. - - """ if version_info >= (3, 9): @@ -182,20 +181,21 @@ def _check(): return False if not isinstance(obj, type) and not isinstance(obj, _GenericAlias): - client: Client - obj: Union[Type[_T], Type[List[_T]]] raise LibraryException(message="The object must not be an instance of a class!", code=12) + client: "Client" + obj: Union[Type[_T], Type[List[_T]]] kwargs = _resolve_kwargs(obj, **kwargs) - http_name = f"get_{obj.__name__.lower()}" - kwarg_name = f"{obj.__name__.lower()}_id" + + force_arg = kwargs.pop("force", None) + force_cache = force_arg == "cache" + force_http = force_arg == "http" + if isinstance(obj, _GenericAlias) or _check(): _obj: Type[_T] = get_args(obj)[0] + http_name = f"get_{_obj.__name__.lower()}" + kwarg_name = f"{_obj.__name__.lower()}_ids" _objects: List[Union[_obj, Coroutine]] = [] - kwarg_name += "s" - - force_cache = kwargs.pop("force", None) == "cache" - force_http = kwargs.pop("force", None) == "http" if not force_http: _objects = _get_cache(_obj, client, kwarg_name, _list=True, **kwargs) @@ -210,7 +210,7 @@ def _check(): _objects.clear() _func = getattr(client._http, http_name) for _id in kwargs.get(kwarg_name): - _kwargs = kwargs + _kwargs = kwargs.copy() _kwargs.pop(kwarg_name) _kwargs[kwarg_name[:-1]] = _id _objects.append(_func(**_kwargs)) @@ -221,17 +221,18 @@ def _check(): for _index, __obj in enumerate(_objects): if __obj is None: _id = kwargs.get(kwarg_name)[_index] - _kwargs = kwargs + _kwargs = kwargs.copy() _kwargs.pop(kwarg_name) _kwargs[kwarg_name[:-1]] = _id _request = _func(**_kwargs) _objects[_index] = _request return _http_request(_obj, http=client._http, request=_objects) + http_name = f"get_{obj.__name__.lower()}" + kwarg_name = f"{obj.__name__.lower()}_id" + _obj: Optional[_T] = None - force_cache = kwargs.pop("force", None) == "cache" - force_http = kwargs.pop("force", None) == "http" if not force_http: _obj = _get_cache(obj, client, kwarg_name, **kwargs) @@ -247,13 +248,15 @@ def _check(): async def _http_request( obj: Type[_T], - http: HTTPClient, + http: "HTTPClient", request: Union[Coroutine, List[Union[_T, Coroutine]], List[Coroutine]] = None, _name: str = None, **kwargs, ) -> Union[_T, List[_T]]: if not request: if obj in (Role, Emoji): + from ..api.models.guild import Guild + _guild = Guild(**await http.get_guild(kwargs.pop("guild_id")), _client=http) _func = getattr(_guild, _name) return await _func(**kwargs) @@ -276,7 +279,7 @@ async def _return_cache( def _get_cache( - _object: Type[_T], client: Client, kwarg_name: str, _list: bool = False, **kwargs + _object: Type[_T], client: "Client", kwarg_name: str, _list: bool = False, **kwargs ) -> Union[Optional[_T], List[Optional[_T]]]: if _list: _obj = [] diff --git a/interactions/client/get.pyi b/interactions/utils/get.pyi similarity index 100% rename from interactions/client/get.pyi rename to interactions/utils/get.pyi diff --git a/interactions/utils/missing.py b/interactions/utils/missing.py new file mode 100644 index 000000000..3f5b61aa4 --- /dev/null +++ b/interactions/utils/missing.py @@ -0,0 +1,29 @@ +from typing import ClassVar + +__all__ = ("MISSING",) + + +class _Missing: + """A sentinel object for places where None is a valid value""" + + _instance: ClassVar["_Missing"] = None + + def __new__(cls): + if not isinstance(cls._instance, cls): + cls._instance = object.__new__(cls) + return cls._instance + + def __eq__(self, other): + return self.__class__ is other.__class__ + + def __repr__(self): + return "" + + def __hash__(self): + return 0 + + def __bool__(self): + return False + + +MISSING = _Missing() diff --git a/interactions/utils/utils.py b/interactions/utils/utils.py new file mode 100644 index 000000000..912782015 --- /dev/null +++ b/interactions/utils/utils.py @@ -0,0 +1,321 @@ +from asyncio import Task, get_running_loop, sleep +from functools import wraps +from math import inf +from typing import ( + TYPE_CHECKING, + Awaitable, + Callable, + Coroutine, + Iterable, + List, + Optional, + TypeVar, + Union, +) + +from ..api.error import LibraryException +from ..client.models.component import ActionRow, Button, Component, SelectMenu +from .missing import MISSING + +if TYPE_CHECKING: + from ..api.http.client import HTTPClient + from ..api.models.channel import AsyncHistoryIterator, Channel + from ..api.models.guild import AsyncMembersIterator, Guild + from ..api.models.member import Member + from ..api.models.message import Message + from ..api.models.misc import Snowflake + from ..client.bot import Client, Extension + from ..client.context import CommandContext # noqa F401 + +__all__ = ( + "autodefer", + "spread_to_rows", + "search_iterable", + "disable_components", + "get_channel_history", +) + +_T = TypeVar("_T") + + +def autodefer( + delay: Union[float, int] = 2, + ephemeral: bool = False, + edit_origin: bool = False, +) -> Callable[[Callable[..., Union[Awaitable, Coroutine]]], Callable[..., Awaitable]]: + """ + A decorator that automatically defers a command if it did not respond within ``delay`` seconds. + + The structure of the decorator is: + + .. code-block:: python + + @bot.command() + @autodefer() # configurable + async def command(ctx): + await asyncio.sleep(5) + await ctx.send("I'm awake now!") + + :param delay?: The amount of time in seconds to wait before defering the command. Defaults to ``2`` seconds. + :type delay?: Union[float, int] + :param ephemeral?: Whether the command is deferred ephemerally. Defaults to ``False``. + :type ephemeral?: bool + :param edit_origin?: Whether the command is deferred on origin. Defaults to ``False``. + :type edit_origin?: bool + :return: The inner function, for decorating. + :rtype: + """ + + def decorator(coro: Callable[..., Union[Awaitable, Coroutine]]) -> Callable[..., Awaitable]: + from ..client.context import CommandContext, ComponentContext # noqa F811 + + @wraps(coro) + async def deferring_func( + ctx: Union["CommandContext", "ComponentContext", "Extension"], *args, **kwargs + ): + try: + loop = get_running_loop() + except RuntimeError as e: + raise RuntimeError("No running event loop detected!") from e + + if args and isinstance(args[0], (ComponentContext, CommandContext)): + self = ctx + args = list(args) + ctx = args.pop(0) + + task: Task = loop.create_task(coro(self, ctx, *args, **kwargs)) + else: + task: Task = loop.create_task(coro(ctx, *args, **kwargs)) + + await sleep(delay) + + if task.done(): + return task.result() + + if not (ctx.deferred or ctx.responded): + if isinstance(ctx, ComponentContext): + await ctx.defer(ephemeral=ephemeral, edit_origin=edit_origin) + else: + await ctx.defer(ephemeral=ephemeral) + + return await task + + return deferring_func + + return decorator + + +def spread_to_rows( + *components: Union[ActionRow, Button, SelectMenu], max_in_row: int = 5 +) -> List[ActionRow]: + r""" + A helper function that spreads components into :class:`ActionRow` s. + + Example: + + .. code-block:: python + + @bot.command() + async def command(ctx): + b1 = Button(style=1, custom_id="b1", label="b1") + b2 = Button(style=1, custom_id="b2", label="b2") + s1 = SelectMenu( + custom_id="s1", + options=[ + SelectOption(label="1", value="1"), + SelectOption(label="2", value="2"), + ], + ) + b3 = Button(style=1, custom_id="b3", label="b3") + b4 = Button(style=1, custom_id="b4", label="b4") + + await ctx.send("Components:", components=spread_to_rows(b1, b2, s1, b3, b4)) + + .. note:: + You can only pass in :class:`ActionRow`s, :class:`Button`s, and :class:`SelectMenu`s, but in any order. + + :param \*components: The components to spread. + :type \*components: Union[ActionRow, Button, SelectMenu] + :param max_in_row?: The maximum number of components in a single row. Defaults to ``5``. + :type max_in_row?: int + """ + if not components or len(components) > 25: + raise LibraryException(code=12, message="Number of components should be between 1 and 25.") + if not 1 <= max_in_row <= 5: + raise LibraryException(code=12, message="max_in_row should be between 1 and 5.") + + rows: List[ActionRow] = [] + action_row: List[Union[Button, SelectMenu]] = [] + + for component in list(components): + if component is not None and isinstance(component, Button): + action_row.append(component) + + if len(action_row) == max_in_row: + rows.append(ActionRow(components=action_row)) + action_row = [] + + continue + + if action_row: + rows.append(ActionRow(components=action_row)) + action_row = [] + + if component is not None: + if isinstance(component, ActionRow): + rows.append(component) + elif isinstance(component, SelectMenu): + rows.append(ActionRow(components=[component])) + + if action_row: + rows.append(ActionRow(components=action_row)) + + if len(rows) > 5: + raise LibraryException(code=12, message="Number of rows exceeds 5.") + + return rows + + +def search_iterable( + iterable: Iterable[_T], check: Optional[Callable[[_T], bool]] = None, /, **kwargs +) -> List[_T]: + """ + Searches through an iterable for items that: + - Are True for the check, if one is given + - Have attributes that match the keyword arguments (e.x. passing `id=your_id` will only return objects with that id) + + :param iterable: The iterable to search through + :type iterable: Iterable + :param check: The check that items will be checked against + :type check: Callable[[Any], bool] + :param kwargs: Any attributes the items should have + :type kwargs: Any + :return: All items that match the check and keywords + :rtype: list + """ + if check: + iterable = filter(check, iterable) + + if kwargs: + iterable = filter( + lambda item: all(getattr(item, attr) == value for attr, value in kwargs.items()), + iterable, + ) + + return list(iterable) + + +def disable_components( + components: Union[ + List[Component], + List[ActionRow], + List[Button], + List[SelectMenu], + ActionRow, + Component, + Button, + SelectMenu, + ] +) -> None: + """ + Disables the given components. + + :param components: The components to disable + :type components: Union[List[Component], List[ActionRow], List[Button], List[SelectMenu], ActionRow, Component, Button, SelectMenu] + """ + if isinstance(components, (Component, ActionRow)): + for component in components.components: + component.disabled = True + elif isinstance(components, (Button, SelectMenu)): + components.disabled = True + elif isinstance(components, list): + if not all( + isinstance(component, (Button, SelectMenu)) for component in components + ) or not all(isinstance(component, (ActionRow, Component)) for component in components): + raise LibraryException( + 12, + "You must only specify lists of 'Buttons' and 'SelectMenus' or 'ActionRow' and 'Component'", + ) + if isinstance(components[0], (Button, SelectMenu)): + for component in components: + component.disabled = True + + elif isinstance(components[0], (ActionRow, Component)): + components: List[ActionRow, Component] + for _components in components: + for component in _components.components: + component.disabled = True + + +def get_channel_history( + http: Union["HTTPClient", "Client"], + channel: Union[int, str, "Snowflake", "Channel"], + start_at: Optional[Union[int, str, "Snowflake", "Message"]] = MISSING, + reverse: Optional[bool] = False, + check: Optional[Callable[["Message"], bool]] = None, + maximum: Optional[int] = inf, +) -> "AsyncHistoryIterator": + """ + Gets the history of a channel. + + :param http: The HTTPClient of the bot or your bot instance + :type http: Union[HTTPClient, Client] + :param channel: The channel to get the history from + :type channel: Union[int, str, Snowflake, Channel] + :param start_at?: The message to begin getting the history from + :type start_at?: Optional[Union[int, str, Snowflake, Message]] + :param reverse?: Whether to only get newer message. Default False + :type reverse?: Optional[bool] + :param check?: A check to ignore specific messages + :type check?: Optional[Callable[[Message], bool]] + :param maximum?: A set maximum of messages to get before stopping the iteration + :type maximum?: Optional[int] + + :return: An asynchronous iterator over the history of the channel + :rtype: AsyncHistoryIterator + """ + from ..api.models.channel import AsyncHistoryIterator + + return AsyncHistoryIterator( + http if not hasattr(http, "_http") else http._http, + channel, + start_at=start_at, + reverse=reverse, + check=check, + maximum=maximum, + ) + + +def get_guild_members( + http: Union["HTTPClient", "Client"], + guild: Union[int, str, "Snowflake", "Guild"], + start_at: Optional[Union[int, str, "Snowflake", "Member"]] = MISSING, + check: Optional[Callable[["Member"], bool]] = None, + maximum: Optional[int] = inf, +) -> "AsyncMembersIterator": + """ + Gets the members of a guild + + :param http: The HTTPClient of the bot or your bot instance + :type http: Union[HTTPClient, Client] + :param guild: The channel to get the history from + :type guild: Union[int, str, Snowflake, Guild] + :param start_at?: The message to begin getting the history from + :type start_at?: Optional[Union[int, str, Snowflake, Member]] + :param check?: A check to ignore specific messages + :type check?: Optional[Callable[[Member], bool]] + :param maximum?: A set maximum of members to get before stopping the iteration + :type maximum?: Optional[int] + + :return: An asynchronous iterator over the history of the channel + :rtype: AsyncMembersIterator + """ + from ..api.models.guild import AsyncMembersIterator + + return AsyncMembersIterator( + http if not hasattr(http, "_http") else http._http, + guild, + start_at=start_at, + maximum=maximum, + check=check, + )