discorb 0.15.0 → 0.17.0

data/lib/discorb/guild.rb

@@ -21,7 +21,8 @@ module Discorb
     attr_reader :afk_timeout
     # @return [Discorb::Dictionary{Discorb::Snowflake => Discorb::Role}] A dictionary of roles in the guild.
     attr_reader :roles
-    # @return [Discorb::Dictionary{Discorb::Snowflake => Discorb::CustomEmoji}] A dictionary of custom emojis in the guild.
+    # @return [Discorb::Dictionary{Discorb::Snowflake => Discorb::CustomEmoji}]
+    #   A dictionary of custom emojis in the guild.
     attr_reader :emojis
     # @return [Array<Symbol>] features that are enabled in the guild.
     # @see https://discord.com/developers/docs/resources/guild#guild-object-guild-features Official Discord API docs
@@ -76,7 +77,8 @@ module Discorb
     attr_reader :welcome_screen
     # @return [:default, :explicit, :safe, :age_restricted] The nsfw level of the guild.
     attr_reader :nsfw_level
-    # @return [Discorb::Dictionary{Discorb::Snowflake => Discorb::StageInstance}] A dictionary of stage instances in the guild.
+    # @return [Discorb::Dictionary{Discorb::Snowflake => Discorb::StageInstance}]
+    #   A dictionary of stage instances in the guild.
     attr_reader :stage_instances
     # @return [:none, :low, :medium, :high, :very_high] The verification level of the guild.
     attr_reader :verification_level
@@ -100,6 +102,8 @@ module Discorb
     attr_reader :scheduled_events
     alias events scheduled_events
 
+    include Discorb::ChannelContainer
+
     # @!attribute [r] afk_channel
     #   @return [Discorb::VoiceChannel] The AFK channel for this guild.
     #   @macro client_cache
@@ -115,27 +119,36 @@ module Discorb
     # @!attribute [r] me
     #   @return [Discorb::Member] The client's member in the guild.
 
-    @mfa_levels = %i[none elevated].freeze
-    @nsfw_levels = %i[default explicit safe age_restricted].freeze
-    @verification_levels = %i[none low medium high very_high].freeze
-    @default_message_notifications = %i[all_messages only_mentions].freeze
-    @explicit_content_filter = %i[disabled_in_text members_without_roles all_members].freeze
+    # @private
+    # @return [Array<Symbol>] The mapping of mfa_level.
+    MFA_LEVELS = %i[none elevated].freeze
+    # @private
+    # @return [Array<Symbol>] The mapping of nsfw_level.
+    NSFW_LEVELS = %i[default explicit safe age_restricted].freeze
+    # @private
+    # @return [Array<Symbol>] The mapping of verification_level.
+    VERIFICATION_LEVELS = %i[none low medium high very_high].freeze
+    # @private
+    # @return [Array<Symbol>] The mapping of default_message_notifications.
+    DEFAULT_MESSAGE_NOTIFICATIONS = %i[all_messages only_mentions].freeze
+    # @private
+    # @return [Array<Symbol>] The mapping of explicit_content_filter.
+    EXPLICIT_CONTENT_FILTER = %i[disabled_in_text members_without_roles all_members].freeze
 
+    #
+    # Creates a new guild object.
     # @private
+    #
+    # @param [Discorb::Client] client The client that owns this guild.
+    # @param [Hash] data The data of the guild.
+    # @param [Boolean] is_create_event Whether the guild is created by a `GUILD_CREATE` event.
+    #
     def initialize(client, data, is_create_event)
       @client = client
       @data = {}
       _set_data(data, is_create_event)
     end
 
-    # @private
-    def update!
-      Async do
-        _, data = @client.get("/guilds/#{@id}").wait
-        _set_data(data, false)
-      end
-    end
-
     def afk_channel
       @client.channels[@afk_channel_id]
     end
@@ -184,7 +197,13 @@ module Discorb
     #
     def fetch_scheduled_events(with_user_count: true)
       Async do
-        _resp, events = @client.http.request(Route.new("/guilds/#{@id}/scheduled-events?with_user_count=#{with_user_count}", "//guilds/:guild_id/scheduled-events", :get)).wait
+        _resp, events = @client.http.request(
+          Route.new(
+            "/guilds/#{@id}/scheduled-events?with_user_count=#{with_user_count}",
+            "//guilds/:guild_id/scheduled-events",
+            :get
+          )
+        ).wait
         @scheduled_events = events.map { |e| ScheduledEvent.new(@client, e) }
       end
     end
@@ -200,7 +219,13 @@ module Discorb
     #
     def fetch_scheduled_event(id)
       Async do
-        _resp, event = @client.http.request(Route.new("/guilds/#{@id}/scheduled-events/#{id}", "//guilds/:guild_id/scheduled-events/:scheduled_event_id", :get)).wait
+        _resp, event = @client.http.request(
+          Route.new(
+            "/guilds/#{@id}/scheduled-events/#{id}",
+            "//guilds/:guild_id/scheduled-events/:scheduled_event_id",
+            :get
+          )
+        ).wait
       rescue Discorb::NotFoundError
         return nil
       else
@@ -237,36 +262,39 @@ module Discorb
         payload = case type
           when :stage_instance
             raise ArgumentError, "channel must be provided for stage_instance events" unless channel
+
             {
               name: name,
               description: description,
               scheduled_start_time: start_time.iso8601,
               scheduled_end_time: end_time&.iso8601,
-              privacy_level: Discorb::ScheduledEvent.privacy_level.key(privacy_level),
+              privacy_level: Discorb::ScheduledEvent::PRIVACY_LEVEL.key(privacy_level),
               channel_id: channel&.id,
-              entity_type: Discorb::ScheduledEvent.entity_type.key(:stage_instance),
+              entity_type: Discorb::ScheduledEvent::ENTITY_TYPE.key(:stage_instance),
             }
           when :voice
             raise ArgumentError, "channel must be provided for voice events" unless channel
+
             {
               name: name,
               description: description,
               scheduled_start_time: start_time.iso8601,
               scheduled_end_time: end_time&.iso8601,
-              privacy_level: Discorb::ScheduledEvent.privacy_level.key(privacy_level),
+              privacy_level: Discorb::ScheduledEvent::PRIVACY_LEVEL.key(privacy_level),
               channel_id: channel&.id,
-              entity_type: Discorb::ScheduledEvent.entity_type.key(:voice),
+              entity_type: Discorb::ScheduledEvent::ENTITY_TYPE.key(:voice),
             }
           when :external
             raise ArgumentError, "location must be provided for external events" unless location
             raise ArgumentError, "end_time must be provided for external events" unless end_time
+
             {
               name: name,
               description: description,
               scheduled_start_time: start_time.iso8601,
               scheduled_end_time: end_time.iso8601,
-              privacy_level: Discorb::ScheduledEvent.privacy_level.key(privacy_level),
-              entity_type: Discorb::ScheduledEvent.entity_type.key(:external),
+              privacy_level: Discorb::ScheduledEvent::PRIVACY_LEVEL.key(privacy_level),
+              entity_type: Discorb::ScheduledEvent::ENTITY_TYPE.key(:external),
               entity_metadata: {
                 location: location,
               },
@@ -274,7 +302,9 @@ module Discorb
           else
             raise ArgumentError, "Invalid scheduled event type: #{type}"
           end
-        _resp, event = @client.http.request(Route.new("/guilds/#{@id}/scheduled-events", "//guilds/:guild_id/scheduled-events", :post), payload).wait
+        _resp, event = @client.http.request(
+          Route.new("/guilds/#{@id}/scheduled-events", "//guilds/:guild_id/scheduled-events", :post), payload
+        ).wait
         Discorb::ScheduledEvent.new(@client, event)
       end
     end
@@ -284,7 +314,8 @@ module Discorb
     # @async
     # @note This querys the API every time. We recommend using {#emojis} instead.
     #
-    # @return [Async::Task<Discorb::Dictionary{Discorb::Snowflake => Discorb::CustomEmoji}>] A dictionary of emoji in the guild.
+    # @return [Async::Task<Discorb::Dictionary{Discorb::Snowflake => Discorb::CustomEmoji}>]
+    #   A dictionary of emoji in the guild.
     #
     def fetch_emoji_list
       Async do
@@ -312,7 +343,8 @@ module Discorb
     # @return [Async::Task<Discorb::CustomEmoji>] The emoji with the given id.
     #
     def fetch_emoji(id)
-      _resp, data = @client.http.request(Route.new("/guilds/#{@id}/emojis/#{id}", "//guilds/:guild_id/emojis/:emoji_id", :get)).wait
+      _resp, data = @client.http.request(Route.new("/guilds/#{@id}/emojis/#{id}",
+                                                   "//guilds/:guild_id/emojis/:emoji_id", :get)).wait
       @emojis[e[:id]] = CustomEmoji.new(@client, self, data)
     end
 
@@ -329,10 +361,10 @@ module Discorb
     def create_emoji(name, image, roles: [])
       _resp, data = @client.http.request(Route.new("/guilds/#{@id}/emojis", "//guilds/:guild_id/emojis", :post),
                                          {
-        name: name,
-        image: image.to_s,
-        roles: roles.map { |r| Discorb::Utils.try(r, :id) },
-      }).wait
+                                           name: name,
+                                           image: image.to_s,
+                                           roles: roles.map { |r| Discorb::Utils.try(r, :id) },
+                                         }).wait
       @emojis[data[:id]] = CustomEmoji.new(@client, self, data)
     end
 
@@ -344,7 +376,8 @@ module Discorb
     #
     def fetch_webhooks
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/webhooks", "//guilds/:guild_id/webhooks", :get)).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/webhooks", "//guilds/:guild_id/webhooks",
+                                                     :get)).wait
         data.map { |webhook| Webhook.new([@client, webhook]) }
       end
     end
@@ -357,7 +390,8 @@ module Discorb
     #
     def fetch_audit_log
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/audit-logs", "//guilds/:guild_id/audit-logs", :get)).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/audit-logs", "//guilds/:guild_id/audit-logs",
+                                                     :get)).wait
         AuditLog.new(@client, data, self)
       end
     end
@@ -370,7 +404,8 @@ module Discorb
     #
     def fetch_channels
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/channels", "//guilds/:guild_id/channels", :get)).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/channels", "//guilds/:guild_id/channels",
+                                                     :get)).wait
         data.map { |c| Channel.make_channel(@client, c) }
       end
     end
@@ -385,14 +420,23 @@ module Discorb
     # @param [Integer] slowmode Alias for `rate_limit_per_user`.
     # @param [Integer] position The position of the channel.
     # @param [Boolean] nsfw Whether the channel is nsfw.
-    # @param [Hash{Discorb::Role, Discorb::Member => Discorb::PermissionOverwrite}] permission_overwrites A list of permission overwrites.
+    # @param [Hash{Discorb::Role, Discorb::Member => Discorb::PermissionOverwrite}] permission_overwrites
+    #   A list of permission overwrites.
     # @param [Discorb::CategoryChannel] parent The parent of the channel.
     # @param [String] reason The reason for creating the channel.
     #
     # @return [Async::Task<Discorb::TextChannel>] The created text channel.
     #
     def create_text_channel(
-      name, topic: nil, rate_limit_per_user: nil, slowmode: nil, position: nil, nsfw: nil, permission_overwrites: nil, parent: nil, reason: nil
+      name,
+      topic: nil,
+      rate_limit_per_user: nil,
+      slowmode: nil,
+      position: nil,
+      nsfw: nil,
+      permission_overwrites: nil,
+      parent: nil,
+      reason: nil
     )
       Async do
         payload = { type: TextChannel.channel_type }
@@ -413,7 +457,8 @@ module Discorb
           end
         end
         payload[:parent_id] = parent.id if parent
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/channels", "//guilds/:guild_id/channels", :post), payload, audit_log_reason: reason).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/channels", "//guilds/:guild_id/channels", :post),
+                                           payload, audit_log_reason: reason).wait
         payload[:parent_id] = parent&.id
         Channel.make_channel(@client, data)
       end
@@ -427,7 +472,8 @@ module Discorb
     # @param [Integer] bitrate The bitrate of the channel.
     # @param [Integer] user_limit The user limit of the channel.
     # @param [Integer] position The position of the channel.
-    # @param [Hash{Discorb::Role, Discorb::Member => Discorb::PermissionOverwrite}] permission_overwrites A list of permission overwrites.
+    # @param [Hash{Discorb::Role, Discorb::Member => Discorb::PermissionOverwrite}] permission_overwrites
+    #   A list of permission overwrites.
     # @param [Discorb::CategoryChannel] parent The parent of the channel.
     # @param [String] reason The reason for creating the channel.
     #
@@ -453,7 +499,8 @@ module Discorb
           end
         end
         payload[:parent_id] = parent.id if parent
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/channels", "//guilds/:guild_id/channels", :post), payload, audit_log_reason: reason).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/channels", "//guilds/:guild_id/channels", :post),
+                                           payload, audit_log_reason: reason).wait
         payload[:parent_id] = parent&.id
         Channel.make_channel(@client, data)
       end
@@ -464,7 +511,8 @@ module Discorb
     #
     # @param [String] name The name of the channel.
     # @param [Integer] position The position of the channel.
-    # @param [Hash{Discorb::Role, Discorb::Member => Discorb::PermissionOverwrite}] permission_overwrites A list of permission overwrites.
+    # @param [Hash{Discorb::Role, Discorb::Member => Discorb::PermissionOverwrite}] permission_overwrites
+    #  A list of permission overwrites.
     # @param [Discorb::CategoryChannel] parent The parent of the channel.
     # @param [String] reason The reason for creating the channel.
     #
@@ -486,7 +534,8 @@ module Discorb
           end
         end
         payload[:parent_id] = parent&.id
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/channels", "//guilds/:guild_id/channels", :post), payload, audit_log_reason: reason).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/channels", "//guilds/:guild_id/channels", :post),
+                                           payload, audit_log_reason: reason).wait
         Channel.make_channel(@client, data)
       end
     end
@@ -500,7 +549,8 @@ module Discorb
     # @param [String] name The name of the channel.
     # @param [Integer] bitrate The bitrate of the channel.
     # @param [Integer] position The position of the channel.
-    # @param [Hash{Discorb::Role, Discorb::Member => Discorb::PermissionOverwrite}] permission_overwrites A list of permission overwrites.
+    # @param [Hash{Discorb::Role, Discorb::Member => Discorb::PermissionOverwrite}] permission_overwrites
+    #   A list of permission overwrites.
     # @param [Discorb::CategoryChannel] parent The parent of the channel.
     # @param [String] reason The reason for creating the channel.
     #
@@ -523,7 +573,8 @@ module Discorb
           end
         end
         payload[:parent_id] = parent&.id
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/channels", "//guilds/:guild_id/channels", :post), payload, audit_log_reason: reason).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/channels", "//guilds/:guild_id/channels", :post),
+                                           payload, audit_log_reason: reason).wait
         Channel.make_channel(@client, data)
       end
     end
@@ -538,14 +589,23 @@ module Discorb
     # @param [Integer] slowmode Alias for `rate_limit_per_user`.
     # @param [Integer] position The position of the channel.
     # @param [Boolean] nsfw Whether the channel is nsfw.
-    # @param [Hash{Discorb::Role, Discorb::Member => Discorb::PermissionOverwrite}] permission_overwrites A list of permission overwrites.
+    # @param [Hash{Discorb::Role, Discorb::Member => Discorb::PermissionOverwrite}] permission_overwrites
+    #   A list of permission overwrites.
     # @param [Discorb::CategoryChannel] parent The parent of the channel.
     # @param [String] reason The reason for creating the channel.
     #
     # @return [Async::Task<Discorb::NewsChannel>] The created news channel.
     #
     def create_news_channel(
-      name, topic: nil, rate_limit_per_user: nil, slowmode: nil, position: nil, nsfw: nil, permission_overwrites: nil, parent: nil, reason: nil
+      name,
+      topic: nil,
+      rate_limit_per_user: nil,
+      slowmode: nil,
+      position: nil,
+      nsfw: nil,
+      permission_overwrites: nil,
+      parent: nil,
+      reason: nil
     )
       Async do
         payload = { type: NewsChannel.channel_type }
@@ -566,7 +626,8 @@ module Discorb
         end
         payload[:nsfw] = nsfw unless nsfw.nil?
         payload[:parent_id] = parent&.id
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/channels", "//guilds/:guild_id/channels", :post), payload, audit_log_reason: reason).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/channels", "//guilds/:guild_id/channels", :post),
+                                           payload, audit_log_reason: reason).wait
         Channel.make_channel(@client, data)
       end
     end
@@ -579,7 +640,8 @@ module Discorb
     #
     def fetch_active_threads
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/threads/active", "//guilds/:guild_id/threads/active", :get)).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/threads/active",
+                                                     "//guilds/:guild_id/threads/active", :get)).wait
         data[:threads].map { |t| Channel.make_thread(@client, t) }
       end
     end
@@ -595,7 +657,8 @@ module Discorb
     #
     def fetch_member(id)
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/members/#{id}", "//guilds/:guild_id/members/:user_id", :get)).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/members/#{id}",
+                                                     "//guilds/:guild_id/members/:user_id", :get)).wait
       rescue Discorb::NotFoundError
         nil
       else
@@ -615,14 +678,24 @@ module Discorb
     def fetch_members(limit: 0, after: nil)
       Async do
         unless limit.zero?
-          _resp, data = @client.http.request(Route.new("/guilds/#{@id}/members?#{URI.encode_www_form({ after: after, limit: limit })}", "//guilds/:guild_id/members", :get)).wait
+          _resp, data = @client.http.request(
+            Route.new(
+              "/guilds/#{@id}/members?#{URI.encode_www_form(
+                {
+                  after: after,
+                  limit: limit,
+                }
+              )}", "//guilds/:guild_id/members", :get
+            )
+          ).wait
           next data[:members].map { |m| Member.new(@client, @id, m[:user], m) }
         end
         ret = []
         after = 0
         loop do
           params = { after: after, limit: 100 }
-          _resp, data = @client.http.request(Route.new("/guilds/#{@id}/members?#{URI.encode_www_form(params)}", "//guilds/:guild_id/members", :get)).wait
+          _resp, data = @client.http.request(Route.new("/guilds/#{@id}/members?#{URI.encode_www_form(params)}",
+                                                       "//guilds/:guild_id/members", :get)).wait
           ret += data.map { |m| Member.new(@client, @id, m[:user], m) }
           after = data.last[:user][:id]
           break if data.length != 1000
@@ -644,7 +717,16 @@ module Discorb
     #
     def fetch_members_named(name, limit: 1)
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/members/search?#{URI.encode_www_form({ query: name, limit: limit })}", "//guilds/:guild_id/members/search", :get)).wait
+        _resp, data = @client.http.request(
+          Route.new(
+            "/guilds/#{@id}/members/search?#{URI.encode_www_form(
+              {
+                query: name,
+                limit: limit,
+              }
+            )}", "//guilds/:guild_id/members/search", :get
+          )
+        ).wait
         data.map { |d| Member.new(@client, @id, d[:user], d) }
       end
     end
@@ -673,7 +755,10 @@ module Discorb
     #
     def edit_nickname(nickname, reason: nil)
       Async do
-        @client.http.request(Route.new("/guilds/#{@id}/members/@me/nick", "//guilds/:guild_id/members/@me/nick", :patch), { nick: nickname }, audit_log_reason: reason).wait
+        @client.http.request(
+          Route.new("/guilds/#{@id}/members/@me/nick", "//guilds/:guild_id/members/@me/nick",
+                    :patch), { nick: nickname }, audit_log_reason: reason,
+        ).wait
       end
     end
 
@@ -692,7 +777,10 @@ module Discorb
     #
     def kick_member(member, reason: nil)
       Async do
-        @client.http.request(Route.new("/guilds/#{@id}/members/#{member.id}", "//guilds/:guild_id/members/:user_id", :delete), audit_log_reason: reason).wait
+        @client.http.request(
+          Route.new("/guilds/#{@id}/members/#{member.id}", "//guilds/:guild_id/members/:user_id",
+                    :delete), {}, audit_log_reason: reason,
+        ).wait
       end
     end
 
@@ -700,12 +788,24 @@ module Discorb
     # Fetch a list of bans in the guild.
     # @async
     #
+    # @param [Integer] limit The number of bans to fetch.
+    # @param [Discorb::Snowflake] before The ID of the ban to fetch before.
+    # @param [Discorb::Snowflake] after The ID of the ban to fetch after.
+    # @param [Discorb::Snowflake] around The ID of the ban to fetch around.
+    #
     # @return [Async::Task<Array<Discorb::Guild::Ban>>] The list of bans.
     #
-    def fetch_bans
+    def fetch_bans(limit = 50, before: nil, after: nil, around: nil)
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/bans", "//guilds/:guild_id/bans", :get)).wait
-        data.map { |d| Ban.new(@client, self, d) }
+        params = {
+          limit: limit,
+          before: Discorb::Utils.try(after, :id),
+          after: Discorb::Utils.try(around, :id),
+          around: Discorb::Utils.try(before, :id),
+        }.filter { |_k, v| !v.nil? }.to_h
+        _resp, bans = @client.http.request(Route.new("/guilds/#{@id}/bans?#{URI.encode_www_form(params)}",
+                                                     "//guilds/:guild_id/bans", :get)).wait
+        bans.map { |d| Ban.new(@client, self, d) }
       end
     end
 
@@ -720,7 +820,8 @@ module Discorb
     #
     def fetch_ban(user)
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/bans/#{user.id}", "//guilds/:guild_id/bans/:user_id", :get)).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/bans/#{user.id}",
+                                                     "//guilds/:guild_id/bans/:user_id", :get)).wait
       rescue Discorb::NotFoundError
         nil
       else
@@ -754,7 +855,15 @@ module Discorb
     #
     def ban_member(member, delete_message_days: 0, reason: nil)
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/bans", "//guilds/:guild_id/bans", :post), { user: member.id, delete_message_days: delete_message_days }, audit_log_reason: reason).wait
+        _resp, data = @client.http.request(
+          Route.new("/guilds/#{@id}/bans",
+                    "//guilds/:guild_id/bans",
+                    :post),
+          {
+            user: member.id,
+            delete_message_days: delete_message_days,
+          }, audit_log_reason: reason,
+        ).wait
         Ban.new(@client, self, data)
       end
     end
@@ -770,7 +879,8 @@ module Discorb
     #
     def unban_user(user, reason: nil)
       Async do
-        @client.http.request(Route.new("/guilds/#{@id}/bans/#{user.id}", "//guilds/:guild_id/bans/:user_id", :delete), audit_log_reason: reason).wait
+        @client.http.request(Route.new("/guilds/#{@id}/bans/#{user.id}", "//guilds/:guild_id/bans/:user_id", :delete),
+                             {}, audit_log_reason: reason).wait
       end
     end
 
@@ -806,7 +916,8 @@ module Discorb
         payload[:color] = color.to_i if color
         payload[:hoist] = hoist if hoist
         payload[:mentionable] = mentionable if mentionable
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/roles", "//guilds/:guild_id/roles", :post), payload, audit_log_reason: reason).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/roles", "//guilds/:guild_id/roles", :post),
+                                           payload, audit_log_reason: reason).wait
         Role.new(@client, self, data)
       end
     end
@@ -827,7 +938,8 @@ module Discorb
           include_roles: @id.to_s,
         }
         param[:include_roles] = roles.map(&:id).map(&:to_s).join(";") if roles.any?
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/prune?#{URI.encode_www_form(params)}", "//guilds/:guild_id/prune", :get)).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/prune?#{URI.encode_www_form(params)}",
+                                                     "//guilds/:guild_id/prune", :get)).wait
         data[:pruned]
       end
     end
@@ -844,7 +956,8 @@ module Discorb
     #
     def prune(days = 7, roles: [], reason: nil)
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/prune", "//guilds/:guild_id/prune", :post), { days: days, roles: roles.map(&:id) }, audit_log_reason: reason).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/prune", "//guilds/:guild_id/prune", :post),
+                                           { days: days, roles: roles.map(&:id) }, audit_log_reason: reason).wait
         data[:pruned]
       end
     end
@@ -858,7 +971,7 @@ module Discorb
     def fetch_voice_regions
       Async do
         _resp, data = @client.http.request(Route.new("/guilds/#{@id}/voice", "//guilds/:guild_id/voice", :get)).wait
-        data.map { |d| VoiceRegion.new(@client, d) }
+        data.map { |d| VoiceRegion.new(d) }
       end
     end
 
@@ -871,7 +984,7 @@ module Discorb
     def fetch_invites
       Async do
         _resp, data = @client.http.request(Route.new("/guilds/#{@id}/invites", "//guilds/:guild_id/invites", :get)).wait
-        data.map { |d| Invite.new(@client, d) }
+        data.map { |d| Invite.new(@client, d, false) }
       end
     end
 
@@ -883,8 +996,9 @@ module Discorb
     #
     def fetch_integrations
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/integrations", "//guilds/:guild_id/integrations", :get)).wait
-        data.map { |d| Integration.new(@client, d) }
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/integrations", "//guilds/:guild_id/integrations",
+                                                     :get)).wait
+        data.map { |d| Integration.new(@client, d, @id) }
       end
     end
 
@@ -909,7 +1023,8 @@ module Discorb
     #
     def fetch_vanity_invite
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/vanity-url", "//guilds/:guild_id/vanity-url", :get)).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/vanity-url", "//guilds/:guild_id/vanity-url",
+                                                     :get)).wait
         VanityInvite.new(@client, self, data)
       end
     end
@@ -922,7 +1037,8 @@ module Discorb
     #
     def fetch_welcome_screen
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/welcome-screen", "//guilds/:guild_id/welcome-screen", :get)).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/welcome-screen",
+                                                     "//guilds/:guild_id/welcome-screen", :get)).wait
         WelcomeScreen.new(@client, self, data)
       end
     end
@@ -935,7 +1051,8 @@ module Discorb
     #
     def fetch_stickers
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/stickers", "//guilds/:guild_id/stickers", :get)).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/stickers", "//guilds/:guild_id/stickers",
+                                                     :get)).wait
         data.map { |d| Sticker::GuildSticker.new(@client, d) }
       end
     end
@@ -951,7 +1068,8 @@ module Discorb
     #
     def fetch_sticker(id)
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/stickers/#{id}", "//guilds/:guild_id/stickers/:sticker_id", :get)).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/stickers/#{id}",
+                                                     "//guilds/:guild_id/stickers/:sticker_id", :get)).wait
       rescue Discorb::NotFoundError
         nil
       else
@@ -967,7 +1085,8 @@ module Discorb
     #
     def fetch_templates
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/templates", "//guilds/:guild_id/templates", :get)).wait
+        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/templates", "//guilds/:guild_id/templates",
+                                                     :get)).wait
         data.map { |d| GuildTemplate.new(@client, d) }
       end
     end
@@ -995,7 +1114,10 @@ module Discorb
     #
     def create_template(name, description = nil, reason: nil)
       Async do
-        _resp, data = @client.http.request(Route.new("/guilds/#{@id}/templates", "//guilds/:guild_id/templates", :post), { name: name, description: description }, audit_log_reason: reason).wait
+        _resp, data = @client.http.request(
+          Route.new("/guilds/#{@id}/templates", "//guilds/:guild_id/templates",
+                    :post), { name: name, description: description }, audit_log_reason: reason,
+        ).wait
         GuildTemplate.new(@client, data)
       end
     end
@@ -1012,7 +1134,14 @@ module Discorb
       # @!attribute [r] url
       #   @return [String] The vanity URL.
 
+      #
+      # Initialize a new instance of the {VanityInvite} class.
       # @private
+      #
+      # @param [Discorb::Client] client The client.
+      # @param [Discorb::Guild] guild The guild.
+      # @param [Hash] data The data of the invite.
+      #
       def initialize(client, guild, data)
         @client = client
         @guild = guild
@@ -1047,7 +1176,14 @@ module Discorb
       # @!attribute [r] json_url
       #   @return [String] The JSON URL.
 
+      #
+      # Initialize a new instance of the {Widget} class.
       # @private
+      #
+      # @param [Discorb::Client] client The client.
+      # @param [Discorb::Snowflake] guild_id The guild ID.
+      # @param [Hash] data The data from Discord.
+      #
       def initialize(client, guild_id, data)
         @client = client
         @enabled = data[:enabled]
@@ -1075,7 +1211,8 @@ module Discorb
           payload = {}
           payload[:enabled] = enabled unless enabled.nil?
           payload[:channel_id] = channel.id if channel_id
-          @client.http.request(Route.new("/guilds/#{@guild_id}/widget", "//guilds/:guild_id/widget", :patch), payload, audit_log_reason: reason).wait
+          @client.http.request(Route.new("/guilds/#{@guild_id}/widget", "//guilds/:guild_id/widget", :patch), payload,
+                               audit_log_reason: reason).wait
         end
       end
 
@@ -1095,10 +1232,12 @@ module Discorb
       # @return [String] The iframe HTML.
       #
       def iframe(theme: "dark", width: 350, height: 500)
+        # rubocop:disable Layout/LineLength
         [
           %(<iframe src="https://canary.discord.com/widget?id=#{@guild_id}&theme=#{theme}" width="#{width}" height="#{height}"),
-          %(allowtransparency="true" frameborder="0" sandbox="allow-popups allow-popups-to-escape-sandbox allow-same-origin allow-scripts"></iframe>)
+          %(allowtransparency="true" frameborder="0" sandbox="allow-popups allow-popups-to-escape-sandbox allow-same-origin allow-scripts"></iframe>),
         ].join
+        # rubocop:enable Layout/LineLength
       end
     end
 
@@ -1111,19 +1250,27 @@ module Discorb
       # @return [String] The reason for the ban.
       attr_reader :reason
 
+      #
+      # Initialize a new instance of the {Ban} class.
       # @private
+      #
+      # @param [Discorb::Client] client The client.
+      # @param [Discorb::Guild] guild The guild.
+      # @param [Hash] data The data from Discord.
+      #
       def initialize(client, guild, data)
         @client = client
         @guild = guild
         @reason = data[:reason]
         @user = @client.users[data[:user][:id]] || User.new(@client, data[:user])
       end
+
+      def inspect
+        "<#{self.class.name} #{@user}>"
+      end
     end
 
     class << self
-      # @private
-      attr_reader :nsfw_levels, :mfa_levels, :verification_levels, :default_message_notifications, :explicit_content_filter
-
       #
       # Returns a banner url from the guild's ID.
       #
@@ -1151,10 +1298,11 @@ module Discorb
       @name = data[:name]
       @members = Discorb::Dictionary.new
       data[:members]&.each do |m|
-          Member.new(@client, @id, m[:user], m)
-        end
+        Member.new(@client, @id, m[:user], m)
+      end
       @splash = data[:splash] && Asset.new(self, data[:splash], path: "splashes/#{@id}")
-      @discovery_splash = data[:discovery_splash] && Asset.new(self, data[:discovery_splash], path: "discovery-splashes/#{@id}")
+      @discovery_splash = data[:discovery_splash] && Asset.new(self, data[:discovery_splash],
+                                                               path: "discovery-splashes/#{@id}")
       @owner_id = data[:owner_id]
       @permissions = Permission.new(data[:permissions].to_i)
       @afk_channel_id = data[:afk_channel_id]
@@ -1170,10 +1318,10 @@ module Discorb
         @emojis[e[:id]] = CustomEmoji.new(@client, self, e)
       end
       @features = data[:features].map { |f| f.downcase.to_sym }
-      @mfa_level = self.class.mfa_levels[data[:mfa_level]]
-      @verification_level = self.class.verification_levels[data[:verification_level]]
-      @default_message_notifications = self.class.default_message_notifications[data[:default_message_notifications]]
-      @explicit_content_filter = self.class.explicit_content_filter[data[:explicit_content_filter]]
+      @mfa_level = MFA_LEVELS[data[:mfa_level]]
+      @verification_level = VERIFICATION_LEVELS[data[:verification_level]]
+      @default_message_notifications = DEFAULT_MESSAGE_NOTIFICATIONS[data[:default_message_notifications]]
+      @explicit_content_filter = EXPLICIT_CONTENT_FILTER[data[:explicit_content_filter]]
       @system_channel_id = data[:system_channel_id]
       @system_channel_flag = SystemChannelFlag.new(0b111 - data[:system_channel_flags])
       @rules_channel_id = data[:rules_channel_id]
@@ -1188,7 +1336,7 @@ module Discorb
       @approximate_member_count = data[:approximate_member_count]
       @approximate_presence_count = data[:approximate_presence_count]
       @welcome_screen = data[:welcome_screen].nil? ? nil : WelcomeScreen.new(@client, self, data[:welcome_screen])
-      @nsfw_level = self.class.nsfw_levels[data[:nsfw_level]]
+      @nsfw_level = NSFW_LEVELS[data[:nsfw_level]]
       return unless is_create_event
 
       @stickers = data[:stickers].nil? ? [] : data[:stickers].map { |s| Sticker::GuildSticker.new(self, s) }
@@ -1199,12 +1347,20 @@ module Discorb
         Channel.make_channel(@client, c.merge({ guild_id: @id }))
       end
       @channels = Dictionary.new(tmp_channels.to_h { |c| [c.id, c] }, sort: ->(c) { c[1].position })
-      @voice_states = Dictionary.new(data[:voice_states].to_h { |v| [Snowflake.new(v[:user_id]), VoiceState.new(@client, v.merge({ guild_id: @id }))] })
+      @voice_states = Dictionary.new(data[:voice_states].to_h do |v|
+        [Snowflake.new(v[:user_id]), VoiceState.new(@client, v.merge({ guild_id: @id }))]
+      end)
       @threads = data[:threads] ? data[:threads].map { |t| Channel.make_channel(@client, t) } : []
-      @presences = Dictionary.new(data[:presences].to_h { |pr| [Snowflake.new(pr[:user][:id]), Presence.new(@client, pr)] })
+      @presences = Dictionary.new(data[:presences].to_h do |pr|
+        [Snowflake.new(pr[:user][:id]), Presence.new(@client, pr)]
+      end)
       @max_presences = data[:max_presences]
-      @stage_instances = Dictionary.new(data[:stage_instances].to_h { |s| [Snowflake.new(s[:id]), StageInstance.new(@client, s)] })
-      @scheduled_events = Dictionary.new(data[:guild_scheduled_events].to_h { |s| [Snowflake.new(s[:id]), ScheduledEvent.new(@client, s)] })
+      @stage_instances = Dictionary.new(data[:stage_instances].to_h do |s|
+        [Snowflake.new(s[:id]), StageInstance.new(@client, s)]
+      end)
+      @scheduled_events = Dictionary.new(data[:guild_scheduled_events].to_h do |s|
+        [Snowflake.new(s[:id]), ScheduledEvent.new(@client, s)]
+      end)
       @data.update(data)
     end
   end
@@ -1239,7 +1395,14 @@ module Discorb
     # @return [Discorb::Guild] The guild the welcome screen belongs to.
     attr_reader :guild
 
+    #
+    # Initializes the welcome screen.
     # @private
+    #
+    # @param [Discorb::Client] client The client.
+    # @param [Discorb::Guild] guild The guild the welcome screen belongs to.
+    # @param [Hash] data The data of the welcome screen.
+    #
     def initialize(client, guild, data)
       @client = client
       @description = data[:description]
@@ -1333,7 +1496,10 @@ module Discorb
           payload[:enabled] = enabled unless enabled == Discorb::Unset
           payload[:welcome_channels] = channels.map(&:to_hash) unless channels == Discorb::Unset
           payload[:description] = description unless description == Discorb::Unset
-          @client.http.request(Route.new("/guilds/#{@guild.id}/welcome-screen", "//guilds/:guild_id/welcome-screen", :patch), payload, audit_log_reason: reason).wait
+          @client.http.request(
+            Route.new("/guilds/#{@guild.id}/welcome-screen", "//guilds/:guild_id/welcome-screen",
+                      :patch), payload, audit_log_reason: reason,
+          ).wait
         end
       end
     end