discorb 0.17.1 → 0.19.0

data/lib/discorb/color.rb

@@ -85,7 +85,11 @@ module Discorb
     # @return [Hash{:r, :g, :b => Integer}] A RGB hash.
     #
     def to_rgb_hash
-      [@value / (256 * 256), @value / 256 % 256, @value % 256]
+      {
+        r: @value / (256 * 256),
+        g: @value / 256 % 256,
+        b: @value % 256,
+      }
     end
 
     alias deconstruct_keys to_rgb_hash
@@ -131,65 +135,38 @@ module Discorb
     # Create a color from a Discord's color.
     # Currently these colors are supported:
     #
-    # | Color Name | Hexadecimal |
-    # |------------|------------|
-    # | `:teal` | `#1abc9c` |
-    # | `:dark_teal` | `#11806a` |
-    # | `:green` | `#2ecc71` |
-    # | `:dark_green` | `#1f8b4c` |
-    # | `:blue` | `#3498db` |
-    # | `:dark_blue` | `#206694` |
-    # | `:purple` | `#9b59b6` |
-    # | `:dark_purple` | `#71368a` |
-    # | `:magenta` | `#e91e63` |
-    # | `:dark_magenta` | `#ad1457` |
-    # | `:gold` | `#f1c40f` |
-    # | `:dark_gold` | `#c27c0e` |
-    # | `:orange` | `#e67e22` |
-    # | `:dark_orange` | `#a84300` |
-    # | `:red` | `#e74c3c` |
-    # | `:dark_red` | `#992d22` |
-    # | `:lighter_grey` | `#95a5a6` |
-    # | `:lighter_gray` | `#95a5a6` |
-    # | `:dark_grey` | `#607d8b` |
-    # | `:dark_gray` | `#607d8b` |
-    # | `:light_grey` | `#979c9f` |
-    # | `:light_gray` | `#979c9f` |
-    # | `:darker_grey` | `#546e7a` |
-    # | `:darker_gray` | `#546e7a` |
-    # | `:og_blurple` | `#7289da` |
-    # | `:blurple` | `#5865f2` |
-    # | `:greyple` | `#99aab5` |
-    # | `:dark_theme` | `#36393f` |
-    # | `:fuchsia` | `#eb459e` |
-    # | `:dark_teal` | `#11806a` |
-    # | `:green` | `#2ecc71` |
-    # | `:dark_green` | `#1f8b4c` |
-    # | `:blue` | `#3498db` |
-    # | `:dark_blue` | `#206694` |
-    # | `:purple` | `#9b59b6` |
-    # | `:dark_purple` | `#71368a` |
-    # | `:magenta` | `#e91e63` |
-    # | `:dark_magenta` | `#ad1457` |
-    # | `:gold` | `#f1c40f` |
-    # | `:dark_gold` | `#c27c0e` |
-    # | `:orange` | `#e67e22` |
-    # | `:dark_orange` | `#a84300` |
-    # | `:red` | `#e74c3c` |
-    # | `:dark_red` | `#992d22` |
-    # | `:lighter_grey` | `#95a5a6` |
-    # | `:lighter_gray` | `#95a5a6` |
-    # | `:dark_grey` | `#607d8b` |
-    # | `:dark_gray` | `#607d8b` |
-    # | `:light_grey` | `#979c9f` |
-    # | `:light_gray` | `#979c9f` |
-    # | `:darker_grey` | `#546e7a` |
-    # | `:darker_gray` | `#546e7a` |
-    # | `:og_blurple` | `#7289da` |
-    # | `:blurple` | `#5865f2` |
-    # | `:greyple` | `#99aab5` |
-    # | `:dark_theme` | `#36393f` |
-    # | `:fuchsia` | `#eb459e` |
+    # | Color name      | Color code |
+    # |-----------------|------------|
+    # | `:teal`         | `#1abc9c`  |
+    # | `:dark_teal`    | `#11806a`  |
+    # | `:green`        | `#2ecc71`  |
+    # | `:dark_green`   | `#1f8b4c`  |
+    # | `:blue`         | `#3498db`  |
+    # | `:dark_blue`    | `#206694`  |
+    # | `:purple`       | `#9b59b6`  |
+    # | `:dark_purple`  | `#71368a`  |
+    # | `:magenta`      | `#e91e63`  |
+    # | `:dark_magenta` | `#ad1457`  |
+    # | `:gold`         | `#f1c40f`  |
+    # | `:dark_gold`    | `#c27c0e`  |
+    # | `:orange`       | `#e67e22`  |
+    # | `:dark_orange`  | `#a84300`  |
+    # | `:red`          | `#e74c3c`  |
+    # | `:dark_red`     | `#992d22`  |
+    # | `:lighter_grey` | `#95a5a6`  |
+    # | `:lighter_gray` | `#95a5a6`  |
+    # | `:dark_grey`    | `#607d8b`  |
+    # | `:dark_gray`    | `#607d8b`  |
+    # | `:light_grey`   | `#979c9f`  |
+    # | `:light_gray`   | `#979c9f`  |
+    # | `:darker_grey`  | `#546e7a`  |
+    # | `:darker_gray`  | `#546e7a`  |
+    # | `:og_blurple`   | `#7289da`  |
+    # | `:blurple`      | `#5865f2`  |
+    # | `:greyple`      | `#99aab5`  |
+    # | `:dark_theme`   | `#36393f`  |
+    # | `:fuchsia`      | `#eb459e`  |
+    # | `:yellow`       | `#fee75c`  |
     #
     # @param [Symbol] color A Discord color name.
     #

data/lib/discorb/common.rb

@@ -4,7 +4,7 @@ module Discorb
   # @return [String] The API base URL.
   API_BASE_URL = "https://discord.com/api/v10"
   # @return [String] The version of discorb.
-  VERSION = "0.17.1"
+  VERSION = "0.19.0"
   # @return [Array<Integer>] The version array of discorb.
   VERSION_ARRAY = VERSION.split(".").map(&:to_i).freeze
   # @return [String] The user agent for the bot.

data/lib/discorb/dictionary.rb

@@ -34,7 +34,7 @@ module Discorb
       @cache[id.to_s] = body
       @cache = @cache.sort_by(&@sort).to_h if @sort
       @cache.delete(@cache.keys[0]) if !@limit.nil? && @cache.size > @limit
-      body
+      self
     end
 
     #

data/lib/discorb/embed.rb

@@ -35,7 +35,7 @@ module Discorb
     #
     # @param [String] title The title of embed.
     # @param [String] description The description of embed.
-    # @param [Discorb::Color] color The color of embed.
+    # @param [Discorb::Color, Integer] color The color of embed.
     # @param [String] url The url of embed.
     # @param [Time] timestamp The timestamp of embed.
     # @param [Discorb::Embed::Author] author The author field of embed.
@@ -60,13 +60,13 @@ module Discorb
       @description = description
       @url = url
       @timestamp = timestamp
-      @color = color
+      @color = color && (color.is_a?(Color) ? color : Color.new(color))
       @author = author
       @fields = fields || []
       @footer = footer
       @image = image && (image.is_a?(String) ? Image.new(image) : image)
       @thumbnail = thumbnail && (thumbnail.is_a?(String) ? Thumbnail.new(thumbnail) : thumbnail)
-      @type = "rich"
+      @type = :rich
     end
 
     #
@@ -113,6 +113,7 @@ module Discorb
     # @return [Hash] Converted embed.
     #
     def to_hash
+      # @type var ret: Hash[untyped, untyped]
       ret = { type: "rich" }
       ret[:title] = @title if @title
       ret[:description] = @description if @description
@@ -123,7 +124,7 @@ module Discorb
       ret[:image] = @image&.to_hash if @image
       ret[:thumbnail] = @thumbnail&.to_hash if @thumbnail
       ret[:author] = @author&.to_hash if @author
-      ret[:fields] = @fields&.map { |f| f.to_hash } if @fields.any?
+      ret[:fields] = @fields&.map(&:to_hash) if @fields.any?
       ret
     end
 

data/lib/discorb/emoji.rb

@@ -29,7 +29,7 @@ module Discorb
     attr_reader :roles
     # @return [Discorb::User] The user that created this emoji.
     attr_reader :user
-    # @return [Boolean] Whether the emoji requires colons.
+    # @return [Discorb::Guild] The guild that owns this emoji.
     attr_reader :guild
     # @return [Boolean] whether the emoji is managed by integration (ex: Twitch).
     attr_reader :managed
@@ -121,7 +121,7 @@ module Discorb
     #
     # @return [Async::Task<self>] The deleted emoji.
     #
-    def delete!(reason: nil)
+    def delete(reason: nil)
       Async do
         @client.http.request(
           Route.new("/guilds/#{@guild.id}/emojis/#{@id}", "//guilds/:guild_id/emojis/:emoji_id",
@@ -132,7 +132,7 @@ module Discorb
       end
     end
 
-    alias destroy! delete!
+    alias destroy delete
 
     #
     # Converts the object to a hash.
@@ -247,7 +247,7 @@ module Discorb
         end
         raise ArgumentError, "Invalid skin tone: #{tone}" unless @skin_tone
 
-        @name = EmojiTable::UNICODE_TO_DISCORD[name2]
+        @name = EmojiTable::UNICODE_TO_DISCORD[name2].first
         @value = name
       else
         raise ArgumentError, "No such emoji: #{name}"

data/lib/discorb/event.rb

@@ -224,14 +224,14 @@ module Discorb
     #
     # @return [Async::Task<void>] The task.
     #
-    def delete!
+    def delete
       Async do
         @client.http.request(Route.new("/guilds/#{@guild_id}/scheduled-events/#{@id}",
                                        "//guilds/:guild_id/scheduled-events/:scheduled_event_id", :delete)).wait
       end
     end
 
-    alias destroy! delete!
+    alias destroy delete
 
     #
     # Fetches the event users.

data/lib/discorb/exe/about.rb

@@ -13,5 +13,5 @@ informations = {
 }
 
 informations.each do |key, value|
-  puts "\e[90m#{key.rjust(informations.keys.map(&:size).max)}:\e[m #{value}"
+  puts "\e[90m#{key.rjust(informations.keys.map(&:length).max)}:\e[m #{value}"
 end

data/lib/discorb/exe/new.rb

@@ -220,11 +220,7 @@ def git_init
   create_file(".gitignore")
   iputs "Initializing git repository..."
   system "git init", chdir: $path
-  system "git add .", chdir: $path
-  system "git commit -m \"Initial commit\"", chdir: $path
-  sputs "Initialized repository, use " \
-        "\e[32mgit commit --amend -m '...'\e[92m" \
-        " to change commit message of initial commit.\n"
+  sputs "Initialized repository.\n"
 end
 
 # @private

data/lib/discorb/extension.rb

@@ -45,8 +45,6 @@ module Discorb
       # @param [Symbol] id The id of the event. Used to delete the event.
       # @param [Hash] metadata Other metadata.
       #
-      # @return [Discorb::EventHandler] The event.
-      #
       def event(event_name, id: nil, **metadata, &block)
         raise ArgumentError, "Event name must be a symbol" unless event_name.is_a?(Symbol)
         raise ArgumentError, "block must be given" unless block_given?
@@ -64,8 +62,6 @@ module Discorb
       # @param [Hash] metadata Other metadata.
       # @param [Proc] block The block to execute when the event is triggered.
       #
-      # @return [Discorb::EventHandler] The event.
-      #
       def once_event(event_name, id: nil, **metadata, &block)
         event(event_name, id: id, once: true, **metadata, &block)
       end

data/lib/discorb/flag.rb

@@ -21,7 +21,7 @@ module Discorb
     def initialize(value)
       @value = value
       @values = {}
-      self.class.bits.each_with_index do |(bn, bv), _i|
+      self.class.bits.each do |bn, bv|
         @values[bn] = value & (1 << bv) != 0
       end
     end
@@ -29,7 +29,7 @@ module Discorb
     #
     # Returns the value of the flag.
     #
-    def method_missing(name, args = nil)
+    def method_missing(name, *_args, **_kwargs)
       if @values.key?(name.to_s.delete_suffix("?").to_sym)
         @values[name.to_s.delete_suffix("?").to_sym]
       else