discorb 0.13.4 → 0.15.1

data/lib/discorb/voice_state.rb

@@ -1,6 +1,9 @@
 # frozen_string_literal: true
 
 module Discorb
+  #
+  # Represents a state of user in voice channel.
+  #
   class VoiceState < DiscordModel
     # @return [Discorb::Member] The member associated with this voice state.
     attr_reader :member
@@ -43,7 +46,13 @@ module Discorb
     #   @macro client_cache
     #   @return [Discorb::User] The user this voice state is for.
 
+    #
+    # Initialize a new voice state.
     # @private
+    #
+    # @param [Discorb::Client] client The client this voice state belongs to.
+    # @param [Hash] data The data of the voice state.
+    #
     def initialize(client, data)
       @client = client
       _set_data(data)
@@ -132,7 +141,14 @@ module Discorb
       2 => :guild_only,
     }
 
+    #
+    # Initialize a new instance of the StageInstance class.
     # @private
+    #
+    # @param [Discorb::Client] client The client.
+    # @param [Hash] data The data of the stage instance.
+    # @param [Boolean] no_cache Whether to disable caching.
+    #
     def initialize(client, data, no_cache: false)
       @client = client
       @data = data
@@ -179,7 +195,7 @@ module Discorb
       Async do
         payload = {}
         payload[:topic] = topic if topic != Discorb::Unset
-        payload[:privacy_level] = self.class.privacy_level.key(privacy_level) if privacy_level != Discorb::Unset
+        payload[:privacy_level] = PRIVACY_LEVEL.key(privacy_level) if privacy_level != Discorb::Unset
         @client.http.request(
           Route.new("/stage-instances/#{@channel_id}", "//stage-instances/:channel_id", :patch), payload, audit_log_reason: reason,
         ).wait
@@ -213,7 +229,7 @@ module Discorb
       @guild_id = Snowflake.new(data[:guild_id])
       @channel_id = Snowflake.new(data[:channel_id])
       @topic = data[:topic]
-      @privacy_level = self.class.privacy_level[data[:privacy_level]]
+      @privacy_level = PRIVACY_LEVEL[data[:privacy_level]]
       @discoverable_disabled = data[:discoverable_disabled]
     end
 
@@ -243,7 +259,12 @@ module Discorb
     attr_reader :custom
     alias custom? custom
 
+    #
+    # Initialize a new instance of the VoiceRegion class.
     # @private
+    #
+    # @param [Hash] data The data of the voice region.
+    #
     def initialize(data)
       @id = data[:id]
       @name = data[:name]

data/lib/discorb/webhook.rb

@@ -22,7 +22,13 @@ module Discorb
     # @return [String] The URL of the webhook.
     attr_reader :token
 
+    #
+    # Initializes a webhook.
     # @private
+    #
+    # @param [Discorb::Client] client The client.
+    # @param [Hash] data The data of the webhook.
+    #
     def initialize(client, data)
       @name = data[:name]
       @guild_id = data[:guild_id] && Snowflake.new(data[:guild_id])
@@ -151,7 +157,7 @@ module Discorb
         payload[:attachments] = attachments.map(&:to_hash) if attachments != Discorb::Unset
         payload[:allowed_mentions] = allowed_mentions if allowed_mentions != Discorb::Unset
         files = [file] if file != Discorb::Unset
-        _resp, data = @http.multipart_request(Route.new("#{url}/messages/#{Utils.try(message, :id)}", "//webhooks/:webhook_id/:token/messages/:message_id", :patch), payload, headers: headers).wait
+        _resp, data = @http.multipart_request(Route.new("#{url}/messages/#{Utils.try(message, :id)}", "//webhooks/:webhook_id/:token/messages/:message_id", :patch), payload, files).wait
         message.send(:_set_data, data)
         message
       end
@@ -200,7 +206,13 @@ module Discorb
       # @!attribute [r] url
       #   @return [String] The URL of the webhook.
 
+      #
+      # Initializes the incoming webhook.
       # @private
+      #
+      # @param [Discorb::Client] client The client.
+      # @param [String] url The URL of the webhook.
+      #
       def initialize(client, data)
         super
         @token = data[:token]
@@ -222,7 +234,13 @@ module Discorb
       #   Represents a source channel of follower webhook.
       #   @return [Discorb::Channel, Discorb::Webhook::FollowerWebhook::Channel] The source channel of follower webhook.
 
+      #
+      # Initializes the follower webhook.
       # @private
+      #
+      # @param [Discorb::Client] client The client.
+      # @param [Hash] data The data of the follower webhook.
+      #
       def initialize(client, data)
         super
         @source_guild = FollowerWebhook::Guild.new(data[:source_guild])
@@ -248,12 +266,21 @@ module Discorb
         # @return [Discorb::Asset] The icon of the guild.
         attr_reader :icon
 
+        #
+        # Initialize a new guild.
         # @private
+        #
+        # @param [Hash] data The data of the guild.
+        #
         def initialize(data)
           @id = Snowflake.new(data[:id])
           @name = data[:name]
           @icon = Asset.new(self, data[:icon])
         end
+
+        def inspect
+          "#<#{self.class.name} #{@id}: #{@name}>"
+        end
       end
 
       #
@@ -265,11 +292,20 @@ module Discorb
         # @return [String] The name of the channel.
         attr_reader :name
 
+        #
+        # Initialize a new channel.
         # @private
+        #
+        # @param [Hash] data The data of the channel.
+        #
         def initialize(data)
           @id = Snowflake.new(data[:id])
           @name = data[:name]
         end
+
+        def inspect
+          "#<#{self.class.name} #{@id}: #{@name}>"
+        end
       end
     end
 
@@ -290,7 +326,13 @@ module Discorb
       # @return [Discorb::Snowflake] The ID of the guild.
       attr_reader :guild_id
 
+      #
+      # Initializes the message.
       # @private
+      #
+      # @param [Discorb::Webhook] webhook The webhook.
+      # @param [Hash] data The data of the message.
+      # @param [Discorb::Client] client The client. This will be nil if it's created from {URLWebhook}.
       def initialize(webhook, data, client = nil)
         @client = client
         @webhook = webhook
@@ -329,12 +371,12 @@ module Discorb
 
       def _set_data(data)
         @id = Snowflake.new(data[:id])
-        @type = Discorb::Message.message_type[data[:type]]
+        @type = Discorb::Message::MESSAGE_TYPE[data[:type]]
         @content = data[:content]
         @channel_id = Snowflake.new(data[:channel_id])
         @author = Author.new(data[:author])
         @attachments = data[:attachments].map { |a| Attachment.new(a) }
-        @embeds = data[:embeds] ? data[:embeds].map { |e| Embed.new(data: e) } : []
+        @embeds = data[:embeds] ? data[:embeds].map { |e| Embed.from_hash(e) } : []
         @mentions = data[:mentions].map { |m| Mention.new(m) }
         @mention_roles = data[:mention_roles].map { |m| Snowflake.new(m) }
         @mention_everyone = data[:mention_everyone]
@@ -364,7 +406,12 @@ module Discorb
         # @return [String] The discriminator of the author.
         attr_reader :discriminator
 
+        #
+        # Initializes the author.
         # @private
+        #
+        # @param [Hash] data The data of the author.
+        #
         def initialize(data)
           @data = data
           @bot = data[:bot]
@@ -384,6 +431,10 @@ module Discorb
         end
 
         alias to_s_user to_s
+
+        def inspect
+          "#<#{self.class.name} #{self}>"
+        end
       end
     end
 

data/lib/discorb.rb

@@ -4,7 +4,10 @@
 #
 # @author sevenc-nanashi
 module Discorb
+  #
+  # Method to define a macro for YARD.
   # @private
+  #
   # @!macro [new] async
   #   @note This is an asynchronous method, it will return a `Async::Task` object. Use `Async::Task#wait` to get the result.
   #
@@ -23,7 +26,6 @@ module Discorb
   #   @raise [Discorb::HTTPError] HTTP request failed.
   #
   def macro
-    # NOTE: this method is only for YARD.
     puts "Wow, You found the easter egg!\n"
     red = "\e[31m"
     reset = "\e[m"
@@ -40,9 +42,10 @@ module Discorb
 end
 
 require_order = %w[common flag dictionary error rate_limit http intents emoji_table modules] +
+                %w[message_meta allowed_mentions] +
                 %w[user member guild emoji channel embed message] +
                 %w[application audit_logs color components event event_handler] +
-                %w[file guild_template image integration interaction invite log permission] +
+                %w[attachment guild_template image integration interaction invite log permission] +
                 %w[presence reaction role sticker utils voice_state webhook] +
                 %w[gateway_requests gateway app_command] +
                 %w[asset extension client extend]