discorb 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d1b87a672806fd34b5a1a3308bd96db493c13a645a2f4ae7cd6a3b9622cf7a01
-  data.tar.gz: fc1b8e0b433489e1390b958b7b4ebeb9c39c1f2d38ff80c05334dda5f19f3bd8
+  metadata.gz: 3c80c426387c9e5ba44589c5851e7c1a4d54a5de99c82d5b3571c4200dcaf135
+  data.tar.gz: 2aa6db0900cafe2120793b295b68e5de357e97e0797cd416a06caca9491b09e1
 SHA512:
-  metadata.gz: 4c666466d4c10d93e974ecd843d14d9e92b424c18e6fab784dba54ff8c0caf9c5f54feaaa7c03e32f640a237af4ee6795e653691035c3e80e3c7a4af79740143
-  data.tar.gz: 344ecd871e7c1e98a1ad2b68f75f988ee2aabfbe78e24ecf4e8a58da069e04b8e3327f5348414c33a619381c520ea7dbb4fb173cbea6fa153cb2dd5b07b9f9e2
+  metadata.gz: afe14b35796820b8b7af5baaab6a79a5a770c55d11d30d25b2a9647034658e27346e918be42fb8d4a30edbf27873bd367cf3551cf1b091e82c49150c886ef03e
+  data.tar.gz: 9c817738b2a4b3763d94182e2b47f583aaa7129a8769cdc9b8f7fc7e10f0656f43183f0d416d72aa20112b6b34addfdd38e36b7710c6405d2f29f658cb238c4c

data/Changelog.md

@@ -2,8 +2,37 @@
 
 # Changelog
 
+## v0.11
+
+### v0.11.0
+
+- Add: Improve documents
+- Add: Implement global rate limits
+- Add: Add support autocomplete
+- Add: Add role icon editting
+- Change: Use `include Discorb::Extension` instead of `< Discorb::Extension`
+- Fix: Fix role operation
+
 ## v0.10
 
+### v0.10.3
+
+- Add: Support role icons
+- Fix: Fix version order
+- Change: Use `exec` instead of `system` in `discorb run`
+- Add: Add `Extension.loaded`
+
+### v0.10.2
+
+- Change: `discorb init` is now `discorb new`
+- Add: Add `:channel_types` parameter to `ApplicationCommand::Handler#slash` and some
+
+### v0.10.1
+
+- Add: Add `Client#extensions`
+- Change: `Client#load_extension` allows instance of `Extension`
+- Add: Add `-b` option to `discorb run`
+
 ### v0.10.0
 
 - Change: Sort versions

data/Rakefile

@@ -156,7 +156,7 @@ namespace :document do
     Rake::Task["document:replace:html"].execute
     Rake::Task["document:replace:css"].execute
     Rake::Task["document:replace:eol"].execute
-    tags = `git tag`.force_encoding("utf-8").split("\n")
+    tags = `git tag`.force_encoding("utf-8").split("\n").sort_by { |t| t[1..].split(".").map(&:to_i) }
     tags.each do |tag|
       sh "git checkout #{tag} -f"
       iputs "Building #{tag}"

data/docs/application_command.md

@@ -68,6 +68,8 @@ In `options`, hash should be like this:
 | `:type` | `Object` | Type of the option. |
 | `:choice` | `Hash{String => String, Integer, Float}` | Type of the option. |
 | `:default` | `Object` | Default value of the option. |
+| `:channel_types` | `Array<Class<Discorb::Channel>>` | Type of the channel option. |
+| `:autocomplete` | `Proc` | Autocomplete function. |
 
 `choices` should be unspecified if you don't want to use it.
 `choices` is hash like this:
@@ -106,7 +108,7 @@ In `type`, You must use one of the following:
 | `:channel` | Channel argument. | None |
 | `:role` | Role argument. | None |
 
-### Group Slash Commands
+#### Group Slash Commands
 
 To register a group of slash commands, use {Discorb::ApplicationCommand::Handler#slash_group}.
 
@@ -238,6 +240,31 @@ end
 
 Same as above, you can use block for register commands since v0.5.1.
 
+#### Use Auto Completing
+
+Since v0.11.0, you can use auto completion by setting Proc to `:autocomplete` in options.
+The proc will be called with interaction object and the argument.
+The proc should return an hash of the autocomplete result.
+
+```ruby
+client.slash("hello2", "Greet for you", {
+  "target" => {
+    type: :string,
+    description: "Person to greet",
+    autocomplete: ->(interaction, target) {
+      {
+        "You" => interaction.target.to_s
+      }
+    },
+  },
+}) do |interaction, target|
+  interaction.post("Hello, #{target}!")
+end
+```
+
+In the above example, `You` will be displayed in the user menu.
+Due to the limitation of Discord API, the proc must return the result in less than 3 second.
+
 ### Register User Context Menu Command
 
 ```ruby

data/docs/cli/init.md

@@ -1,13 +1,13 @@
-# @title CLI: discorb init
+# @title CLI: discorb new
 
-# discorb init
+# discorb new
 
 This command will create a new project in the directory.
 
 ## Usage
 
 ```bash
-discorb init [options] [dir]
+discorb new [options] [dir]
 ```
 
 ## Options

data/docs/cli/run.md

@@ -53,4 +53,8 @@ Whether to setup application commands.
 
 #### `-e`, `--env`
 
-The name of the environment variable to use for token, or just `-t` or `--token` for intractive prompt.
+The name of the environment variable to use for token, or just `-t` or `--token` for intractive prompt.
+
+#### `-b`, `--bundler`
+
+Whether to use bundler to load the script.

data/docs/extension.md

@@ -2,16 +2,18 @@
 
 # Extension
 
-Extension allows you to seperate your code from the main application.
+Extension allows you to seperate events.
 
 # @since 
 
 ## Make a new extension
 
-Make a new class that extends Extension.
+Make a new class that includes Extension.
 
 ```ruby
-class MyExtension < Discorb::Extension
+class MyExtension
+  include Discorb::Extension
+
   # ...
 end
 ```
@@ -21,7 +23,9 @@ end
 Use {Discorb::Extension.event} to register event, or {Discorb::Extension.once_event} to register event only once.
 
 ```ruby
-class MyExtension < Discorb::Extension
+class MyExtension
+  include Discorb::Extension
+
   event :message do |message|
     # ...
   end
@@ -39,7 +43,9 @@ Note block will be binded to the extension instance.
 Use `Discorb::Extension.command` to register command, see {Discorb::ApplicationCommand::Handler} for more information.
 
 ```ruby
-class MyExtension < Discorb::Extension
+class MyExtension
+  include Discorb::Extension
+
   slash("command", "Command") do |interaction|
     # ...
   end
@@ -64,7 +70,9 @@ end
 Use {Discorb::Client#load_extension} to load extension.
 
 ```ruby
-class MyExtension < Discorb::Extension
+class MyExtension
+  include Discorb::Extension
+
   event :message do |message|
     # ...
   end
@@ -78,9 +86,45 @@ client.load_extension(MyExtension)
 You can access {Discorb::Client} from extension with `@client`.
 
 ```ruby
-class MyExtension < Discorb::Extension
+class MyExtension
+  include Discorb::Extension
+
   event :standby do |message|
     puts "Logged in as #{@client.user}"
   end
 end
 ```
+
+## Receiving Arguments on load
+
+You can receive arguments by adding some arguments to `#initialize`.
+
+```ruby
+class MyExtension
+  include Discorb::Extension
+
+  def initialize(client, arg1, arg2)
+    super(client)
+    # @client = client will also work, but it's not recommended.
+    @arg1 = arg1
+    @arg2 = arg2
+  end
+end
+
+client.load_extension(MyExtension, "arg1", "arg2")
+
+```
+
+## Do something on load
+
+You can do something on load by overriding `.loaded`. Client and arguments will be passed to it.
+
+```ruby
+class MyExtension
+  include Discorb::Extension
+
+  def self.loaded(client)
+    puts "This extension is loaded to #{client}"
+  end
+end
+```

data/docs/faq.md

@@ -2,13 +2,25 @@
 
 # Fequently asked questions
 
-## What is `Async::Task`?
+## What is ...?
+
+### What is `Async::Task`?
 
 Async::Task is a object for asynchronous tasks.
 
 https://socketry.github.io/async/ for more information.
 
-## How do I do something with sent messages?
+### What is `Guild`?
+
+It means a `server` of Discord.
+
+### What is difference between `User` and `Member`?
+
+`User` is a object for account, `Member` is a object for user in guild.
+
+## How can I ...?
+
+### How can I do something with sent messages?
 
 Use `Async::Task#wait` method.
 
@@ -22,11 +34,12 @@ message = channel.post("Hello world!").wait  # => Message
 message.pin
 ```
 
-## How can I send DM to a user?
+
+### How can I send DM to a user?
 
 Use {Discorb::User#post} method, {Discorb::User} includes {Discorb::Messageable}.
 
-## How can I edit status?
+### How can I edit status?
 
 Use {Discorb::Client#update_presence} method.
 
@@ -47,7 +60,7 @@ client.on :ready do
 end
 ```
 
-## How can I send files?
+### How can I send files?
 
 Use {Discorb::File} class.
 
@@ -62,6 +75,15 @@ message.channel.post "File!", files: [Discorb::File.new(File.open("./README.md")
 message.channel.post file: Discorb::File.from_string("Hello world!", "hello.txt")
 ```
 
+### How can I add reactions?
+
+Use {Discorb::Message#add_reaction} method.
+
+```ruby
+message.add_reaction Discorb::UnicodeEmoji["🤔"]
+message.add_reaction Discorb::UnicodeEmoji["thinking"]
+```
+
 # Not fequently asked questions
 
 ## How can I pronounce `discorb`?

data/docs/tutorial.md

@@ -2,7 +2,8 @@
 
 # Tutorial
 
-Welcome to discorb! This lib allows you to create a discord bot with ease. So, let's get started!
+Welcome to discorb! This lib allows you to create a discord bot with Ruby.
+Let's get started!
 
 ## Requirements
 
@@ -22,6 +23,7 @@ Welcome to discorb! This lib allows you to create a discord bot with ease. So, l
     - [Sublime Text](https://www.sublimetext.com/)
     - [Brackets](https://brackets.io/)
     - [Notepad++](https://notepad-plus-plus.org/)
+    - [Vim](https://www.vim.org/)
 - Git
 - Bundler
 
@@ -74,7 +76,7 @@ Create a new directory and go to it.
 Open terminal and type:
 
 ```
-discorb init
+discorb new
 ```
 
 Specify `--git` if you want to use git.

data/examples/extension/message_expander.rb

@@ -1,6 +1,8 @@
 require "discorb"
 
-class MessageExpander < Discorb::Extension
+class MessageExpander
+  include Discorb::Extension
+
   @@message_regex = Regexp.new(
     '(?!<)https://(?:ptb\.|canary\.)?discord(?:app)?\.com/channels/' \
     "(?<guild>[0-9]{18})/(?<channel>[0-9]{18})/(?<message>[0-9]{18})(?!>)"

data/lib/discorb/app_command.rb

@@ -25,6 +25,8 @@ module Discorb
       #   | `:type` | `Object` | Type of the option. |
       #   | `:choice` | `Hash{String => String, Integer, Float}` | Type of the option. |
       #   | `:default` | `Object` | Default value of the option. |
+      #   | `:channel_types` | `Array<Class<Discorb::Channel>>` | Type of the channel option. |
+      #   | `:autocomplete` | `Proc` | Autocomplete function. |
       #
       # @param [Array<#to_s>, false, nil] guild_ids Guild IDs to set the command to. `false` to global command, `nil` to use default.
       # @param [Proc] block Command block.
@@ -235,9 +237,12 @@ module Discorb
               description: value[:description],
               required: value[:required].nil? ? !value[:optional] : value[:required],
             }
-            if value[:choices]
-              ret[:choices] = value[:choices].map { |t| { name: t[0], value: t[1] } }
-            end
+
+            ret[:choices] = value[:choices].map { |t| { name: t[0], value: t[1] } } if value[:choices]
+
+            ret[:channel_types] = value[:channel_types].map(&:channel_type) if value[:channel_types]
+
+            ret[:autocomplete] = !!value[:autocomplete] if value[:autocomplete]
             ret
           end
           {

data/lib/discorb/client.rb

@@ -52,6 +52,8 @@ module Discorb
     attr_reader :status
     # @return [Integer] The session ID of connection.
     attr_reader :session_id
+    # @return [Hash{String => Discorb::Extension}] The loaded extensions.
+    attr_reader :extensions
     # @private
     attr_reader :bottom_commands
 
@@ -97,6 +99,7 @@ module Discorb
       @status = :initialized
       @fetch_member = fetch_member
       @title = title
+      @extensions = {}
       set_default_events
     end
 
@@ -369,12 +372,19 @@ module Discorb
     #
     # Load the extension.
     #
-    # @param [Class] ext The extension to load.
+    # @param [Class, Discorb::Extension] ext The extension to load.
     # @param [Object] ... The arguments to pass to the `ext#initialize`.
     #
     def load_extension(ext, ...)
-      raise ArgumentError, "#{ext} is not a extension" unless ext.is_a?(Class) && ext < Discorb::Extension
-      ins = ext.new(self, ...)
+      if ext.is_a?(Class)
+        raise ArgumentError, "#{ext} is not a extension" unless ext < Discorb::Extension
+        ins = ext.new(self, ...)
+      elsif ext.is_a?(Discorb::Extension)
+        ins = ext
+      else
+        raise ArgumentError, "#{ext} is not a extension"
+      end
+
       @events.each_value do |event|
         event.delete_if { |c| c.metadata[:extension] == ins.class.name }
       end
@@ -391,7 +401,11 @@ module Discorb
         cmd.define_singleton_method(:extension) { ins.name }
         @commands << cmd
       end
+
+      cls = ins.class
+      cls.loaded(self, ...) if cls.respond_to? :loaded
       @bottom_commands += ins.class.bottom_commands
+      @extensions[ins.class.name] = ins
       ins
     end
 

data/lib/discorb/common.rb

@@ -4,7 +4,7 @@ module Discorb
   # @return [String] The API base URL.
   API_BASE_URL = "https://discord.com/api/v9"
   # @return [String] The version of discorb.
-  VERSION = "0.10.0"
+  VERSION = "0.11.0"
   # @return [String] The user agent for the bot.
   USER_AGENT = "DiscordBot (https://discorb-lib.github.io #{VERSION}) Ruby/#{RUBY_VERSION}"
 

data/lib/discorb/components.rb

@@ -214,6 +214,7 @@ module Discorb
         placeholder: @placeholder,
         min_values: @min_values,
         max_values: @max_values,
+        disabled: @disabled,
       }
     end
 

data/lib/discorb/exe/{init.rb → new.rb}

@@ -178,7 +178,7 @@ end
 opt = OptionParser.new <<~BANNER
                          A tool to make a new project.
 
-                         Usage: discorb init [options] [dir]
+                         Usage: discorb new [options] [dir]
 
                                    dir                        The directory to make the files in.
                        BANNER

data/lib/discorb/exe/run.rb

@@ -22,6 +22,7 @@ options = {
   log_color: nil,
   setup: nil,
   token: false,
+  bundler: :default,
 }
 opt.on("-l", "--log-level LEVEL", "Log level.") do |v|
   unless LOG_LEVELS.include? v.downcase
@@ -36,6 +37,7 @@ opt.on("-c", "--[no-]log-color", "Whether to colorize log output.") { |v| option
 opt.on("-s", "--setup", "Whether to setup application commands.") { |v| options[:setup] = v }
 opt.on("-e", "--env [ENV]", "The name of the environment variable to use for token, or just `-e` or `--env` for intractive prompt.") { |v| options[:token] = v }
 opt.on("-t", "--title TITLE", "The title of process.") { |v| options[:title] = v }
+opt.on("-b", "--[no-]bundler", "Whether to use bundler. Default to true if Gemfile exists, otherwise false.") { |v| options[:bundler] = v }
 opt.parse!(ARGV)
 
 script = ARGV[0]
@@ -54,10 +56,25 @@ elsif options[:token].nil? || options[:token] == "-"
   puts ""
 end
 
+if options[:bundler] == :default
+  dir = Dir.pwd.split("/")
+  options[:bundler] = false
+  dir.length.times.reverse_each do |i|
+    if File.exist? "#{dir[0..i].join("/")}/Gemfile"
+      options[:bundler] = true
+      break
+    end
+  end
+end
+
 ENV["DISCORB_CLI_TITLE"] = options[:title]
 
-begin
-  load script
-rescue LoadError
+if File.exist? script
+  if options[:bundler]
+    exec "bundle exec ruby #{script}"
+  else
+    exec "ruby #{script}"
+  end
+else
   eputs "Could not load script: \e[31m#{script}\e[91m"
 end

data/lib/discorb/extension.rb

@@ -3,15 +3,11 @@
 module Discorb
   #
   # Abstract class to make extension.
-  # Inherit from this class to make your own extension.
+  # Include from this module to make your own extension.
   # @see file:docs/extension.md
   # @abstract
   #
-  class Extension
-    extend Discorb::ApplicationCommand::Handler
-
-    @events = {}
-
+  module Extension
     def initialize(client)
       @client = client
     end
@@ -27,7 +23,12 @@ module Discorb
       @events = ret
     end
 
-    class << self
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods
+      include Discorb::ApplicationCommand::Handler
       undef setup_commands
 
       #
@@ -69,7 +70,7 @@ module Discorb
       # @private
       attr_reader :bottom_commands
 
-      def inherited(klass)
+      def self.extended(klass)
         klass.instance_variable_set(:@commands, [])
         klass.instance_variable_set(:@bottom_commands, [])
         klass.instance_variable_set(:@events, {})

data/lib/discorb/http.rb

@@ -36,13 +36,7 @@ module Discorb
         resp = http.get(get_path(path), get_headers(headers, "", audit_log_reason), **kwargs)
         data = get_response_data(resp)
         @ratelimit_handler.save("GET", path, resp)
-        test_error(if resp.code == "429"
-          @client.log.warn "Ratelimit exceeded for #{path}, trying again in #{data[:retry_after]} seconds."
-          task.sleep(data[:retry_after])
-          get(path, headers: headers, audit_log_reason: audit_log_reason, **kwargs).wait
-        else
-          [resp, data]
-        end)
+        handle_response(:patch, resp, data, path, nil, headers, audit_log_reason, kwargs)
       end
     end
 
@@ -67,12 +61,7 @@ module Discorb
         resp = http.post(get_path(path), get_body(body), get_headers(headers, body, audit_log_reason), **kwargs)
         data = get_response_data(resp)
         @ratelimit_handler.save("POST", path, resp)
-        test_error(if resp.code == "429"
-          task.sleep(data[:retry_after])
-          post(path, body, headers: headers, audit_log_reason: audit_log_reason, **kwargs).wait
-        else
-          [resp, data]
-        end)
+        handle_response(:post, resp, data, path, body, headers, audit_log_reason, kwargs)
       end
     end
 
@@ -97,12 +86,7 @@ module Discorb
         resp = http.patch(get_path(path), get_body(body), get_headers(headers, body, audit_log_reason), **kwargs)
         data = get_response_data(resp)
         @ratelimit_handler.save("PATCH", path, resp)
-        test_error(if resp.code == "429"
-          task.sleep(data[:retry_after])
-          patch(path, body, headers: headers, audit_log_reason: audit_log_reason, **kwargs).wait
-        else
-          [resp, data]
-        end)
+        handle_response(:patch, resp, data, path, body, headers, audit_log_reason, kwargs)
       end
     end
 
@@ -127,12 +111,7 @@ module Discorb
         resp = http.put(get_path(path), get_body(body), get_headers(headers, body, audit_log_reason), **kwargs)
         data = get_response_data(resp)
         @ratelimit_handler.save("PUT", path, resp)
-        test_error(if resp.code == "429"
-          task.sleep(data[:retry_after])
-          put(path, body, headers: headers, audit_log_reason: audit_log_reason, **kwargs).wait
-        else
-          [resp, data]
-        end)
+        handle_response(:put, resp, data, path, body, headers, audit_log_reason, kwargs)
       end
     end
 
@@ -151,17 +130,12 @@ module Discorb
     # @raise [Discorb::HTTPError] The request was failed.
     #
     def delete(path, headers: nil, audit_log_reason: nil, **kwargs)
-      Async do |task|
+      Async do
         @ratelimit_handler.wait("DELETE", path)
         resp = http.delete(get_path(path), get_headers(headers, "", audit_log_reason))
         data = get_response_data(resp)
         @ratelimit_handler.save("DELETE", path, resp)
-        test_error(if resp.code == "429"
-          task.sleep(data[:retry_after])
-          delete(path, headers: headers, audit_log_reason: audit_log_reason, **kwargs).wait
-        else
-          [resp, data]
-        end)
+        handle_response(:delete, resp, data, path, nil, headers, audit_log_reason, kwargs)
       end
     end
 
@@ -198,9 +172,15 @@ module Discorb
 
     private
 
-    def test_error(ary)
-      resp, data = *ary
+    def handle_response(method, resp, data, path, body, headers, audit_log_reason, kwargs)
       case resp.code
+      when "429"
+        sleep(data[:retry_after])
+        if body
+          __send__(method, path, body, headers: headers, audit_log_reason: audit_log_reason, **kwargs).wait
+        else
+          __send__(method, path, headers: headers, audit_log_reason: audit_log_reason, **kwargs).wait
+        end
       when "400"
         raise BadRequestError.new(resp, data)
       when "401"

data/lib/discorb/integration.rb

@@ -63,7 +63,7 @@ module Discorb
     #
     def delete!(reason: nil)
       Async do
-        @client.http.delete("/guilds/#{@guild}/integrations/#{@id}", reason: reason).wait
+        @client.http.delete("/guilds/#{@guild}/integrations/#{@id}", audit_log_reason: reason).wait
       end
     end
 

data/lib/discorb/interaction.rb

@@ -364,7 +364,7 @@ module Discorb
           end
 
           unless (command = @client.bottom_commands.find { |c| c.to_s == name && c.type_raw == 1 })
-            @client.log.warn "Unknown command name #{name}, ignoreing"
+            @client.log.warn "Unknown command name #{name}, ignoring"
             next
           end
 
@@ -451,6 +451,87 @@ module Discorb
     end
   end
 
+  #
+  # Represents auto complete interaction.
+  #
+  class AutoComplete < Interaction
+    @interaction_type = 4
+    @interaction_name = :auto_complete
+
+    def _set_data(data)
+      super
+      Sync do
+        name = data[:name]
+        options = nil
+        if (option = data[:options]&.first)
+          case option[:type]
+          when 1
+            name += " #{option[:name]}"
+            options = option[:options]
+          when 2
+            name += " #{option[:name]}"
+            if (option_sub = option[:options]&.first)
+              if option_sub[:type] == 1
+                name += " #{option_sub[:name]}"
+                options = option_sub[:options]
+              else
+                options = option[:options]
+              end
+            end
+          else
+            options = data[:options]
+          end
+        end
+
+        unless (command = @client.bottom_commands.find { |c| c.to_s == name && c.type_raw == 1 })
+          @client.log.warn "Unknown command name #{name}, ignoring"
+          next
+        end
+
+        option_map = command.options.map { |k, v| [k.to_s, v[:default]] }.to_h
+        options ||= []
+        options.each_with_index do |option|
+          val = case option[:type]
+            when 3, 4, 5, 10
+              option[:value]
+            when 6
+              guild.members[option[:value]] || guild.fetch_member(option[:value]).wait
+            when 7
+              guild.channels[option[:value]] || guild.fetch_channels.wait.find { |channel| channel.id == option[:value] }
+            when 8
+              guild.roles[option[:value]] || guild.fetch_roles.wait.find { |role| role.id == option[:value] }
+            when 9
+              guild.members[option[:value]] || guild.roles[option[:value]] || guild.fetch_member(option[:value]).wait || guild.fetch_roles.wait.find { |role| role.id == option[:value] }
+            end
+          option_map[option[:name]] = val
+        end
+        focused_index = options.find_index { |o| o[:focused] }
+        val = command.options.values[focused_index][:autocomplete]&.call(self, *command.options.map { |k, v| option_map[k.to_s] })
+        send_complete_result(val)
+      end
+    end
+
+    def send_complete_result(val)
+      @client.http.post("/interactions/#{@id}/#{@token}/callback", {
+        type: 8,
+        data: {
+          choices: val.map do |vk, vv|
+            {
+              name: vk,
+              value: vv,
+            }
+          end,
+        },
+      }).wait
+    rescue Discorb::NotFoundError
+      @client.log.warn "Failed to send auto complete result, This may be caused by the suggestion is taking too long (over 3 seconds) to respond", fallback: $stderr
+    end
+
+    class << self
+      alias make_interaction new
+    end
+  end
+
   #
   # Represents a message component interaction.
   # @abstract

data/lib/discorb/member.rb

@@ -71,21 +71,12 @@ module Discorb
       _set_data(user_data, member_data)
     end
 
-    #
-    # Format the member to `@name` style.
-    #
-    # @return [String] The formatted member.
-    #
-    def to_s
-      "@#{name}"
-    end
-
     #
     # Format the member to `Username#Discriminator` style.
     #
     # @return [String] The formatted member.
     #
-    def to_s_user
+    def to_s
       "#{username}##{discriminator}"
     end
 

data/lib/discorb/modules.rb

@@ -94,7 +94,7 @@ module Discorb
     #
     def delete_message!(message_id, reason: nil)
       Async do
-        @client.http.delete("/channels/#{channel_id.wait}/messages/#{message_id}", reason: reason).wait
+        @client.http.delete("/channels/#{channel_id.wait}/messages/#{message_id}", audit_log_reason: reason).wait
       end
     end
 

data/lib/discorb/rate_limit.rb

@@ -11,6 +11,7 @@ module Discorb
       @client = client
       @ratelimit_hash = {}
       @path_ratelimit_hash = {}
+      @global = false
     end
 
     #
@@ -22,6 +23,14 @@ module Discorb
     def wait(method, path)
       return if path.start_with?("https://")
 
+      if @global
+        time = b[:reset_at] - Time.now.to_i
+        @client.log.info("Global ratelimit reached, waiting #{time} seconds")
+        sleep(time)
+        @global = false
+        
+      end
+
       return unless hash = @path_ratelimit_hash[method + path]
 
       return unless b = @ratelimit_hash[hash]
@@ -32,8 +41,9 @@ module Discorb
       end
       return if b[:remaining] > 0
 
-      @client.log.info("Ratelimit reached, waiting for #{b[:reset_at] - Time.now.to_i} seconds")
-      sleep(b[:reset_at] - Time.now.to_i)
+      time = b[:reset_at] - Time.now.to_i
+      @client.log.info("Ratelimit reached, waiting #{time} seconds")
+      sleep(time)
     end
 
     #
@@ -44,6 +54,9 @@ module Discorb
     # @param [Net::HTTPResponse] resp The response.
     #
     def save(method, path, resp)
+      if resp["X-Ratelimit-Global"] == "true"
+        @global = Time.now.to_i + JSON.parse(resp.body, symbolize_names: true)[:retry_after]
+      end
       return unless resp["X-RateLimit-Remaining"]
 
       @path_ratelimit_hash[method + path] = resp["X-RateLimit-Bucket"]

data/lib/discorb/role.rb

@@ -26,6 +26,10 @@ module Discorb
     # @return [Boolean] Whether the role is a default role.
     attr_reader :mentionable
     alias mentionable? mentionable
+    # @return [Discorb::Asset, nil] The icon of the role.
+    attr_reader :custom_icon
+    # @return [Discorb::Emoji, nil] The emoji of the role.
+    attr_reader :emoji
 
     # @!attribute [r] mention
     #   @return [String] The mention of the role.
@@ -33,6 +37,8 @@ module Discorb
     #   @return [Boolean] Whether the role has a color.
     # @!attribute [r] tag
     #   @return [Discorb::Role::Tag] The tag of the role.
+    # @!attribute [r] icon
+    #   @return [Discorb::Asset, Discorb::Emoji] The icon of the role.
 
     include Comparable
 
@@ -44,6 +50,10 @@ module Discorb
       _set_data(data)
     end
 
+    def icon
+      @custom_icon || @emoji
+    end
+
     #
     # Compares two roles by their position.
     #
@@ -88,7 +98,7 @@ module Discorb
     #
     def move(position, reason: nil)
       Async do
-        @client.http.patch("/guilds/#{@guild_id}/roles", { id: @id, position: position }, reason: reason).wait
+        @client.http.patch("/guilds/#{@guild.id}/roles", { id: @id, position: position }, audit_log_reason: reason).wait
       end
     end
 
@@ -103,9 +113,10 @@ module Discorb
     # @param [Discorb::Color] color The new color of the role.
     # @param [Boolean] hoist Whether the role should be hoisted.
     # @param [Boolean] mentionable Whether the role should be mentionable.
+    # @param [Discorb::Image, Discorb::UnicodeEmoji] icon The new icon or emoji of the role.
     # @param [String] reason The reason for editing the role.
     #
-    def edit(name: :unset, position: :unset, color: :unset, hoist: :unset, mentionable: :unset, reason: nil)
+    def edit(name: :unset, position: :unset, color: :unset, hoist: :unset, mentionable: :unset, icon: :unset, reason: nil)
       Async do
         payload = {}
         payload[:name] = name if name != :unset
@@ -113,7 +124,14 @@ module Discorb
         payload[:color] = color.to_i if color != :unset
         payload[:hoist] = hoist if hoist != :unset
         payload[:mentionable] = mentionable if mentionable != :unset
-        @client.http.patch("/guilds/#{@guild_id}/roles/#{@id}", payload, reason: reason).wait
+        if icon != :unset
+          if icon.is_a?(Discorb::Image)
+            payload[:icon] = icon.to_s
+          else
+            payload[:unicode_emoji] = icon.to_s
+          end
+        end
+        @client.http.patch("/guilds/#{@guild.id}/roles/#{@id}", payload, audit_log_reason: reason).wait
       end
     end
 
@@ -126,7 +144,7 @@ module Discorb
     #
     def delete!(reason: nil)
       Async do
-        @client.http.delete("/guilds/#{@guild_id}/roles/#{@id}", reason: reason).wait
+        @client.http.delete("/guilds/#{@guild.id}/roles/#{@id}", audit_log_reason: reason).wait
       end
     end
 
@@ -182,6 +200,8 @@ module Discorb
       @managed = data[:managed]
       @mentionable = data[:mentionable]
       @tags = data[:tags] || {}
+      @custom_icon = data[:icon] ? Asset.new(self, data[:icon], path: "role-icons/#{@id}") : nil
+      @emoji = data[:unicode_emoji] ? UnicodeEmoji.new(data[:unicode_emoji]) : nil
       @guild.roles[@id] = self unless data[:no_cache]
       @data.update(data)
     end

data/lib/discorb/voice_state.rb

@@ -193,7 +193,7 @@ module Discorb
     #
     def delete!(reason: nil)
       Async do
-        @client.http.delete("/stage-instances/#{@channel_id}", reason: reason).wait
+        @client.http.delete("/stage-instances/#{@channel_id}", audit_log_reason: reason).wait
         self
       end
     end

data/template-replace/scripts/version.rb

@@ -4,7 +4,12 @@ def build_version_sidebar(dir, version)
   raw.gsub!(template, "")
   res = +""
   i = 0
-  `git tag`.force_encoding("utf-8").split("\n").reverse.each.with_index do |tag|
+  `git tag`
+    .force_encoding("utf-8")
+    .split("\n")
+    .sort_by { |v| Gem::Version.new(v[1..]) }
+    .reverse
+    .each.with_index do |tag|
     i += 1
     sha = `git rev-parse #{tag}`.force_encoding("utf-8").strip
     tag_version = tag.delete_prefix("v")
@@ -32,7 +37,7 @@ def build_version_sidebar(dir, version)
   cls = i % 2 == 0 ? "even" : "odd"
   res.insert 0, template
                .gsub("!version!", "Latest")
-               .gsub("!path!", "/")
+               .gsub("!path!", "")
                .gsub("!class!", cls)
                .gsub("!sha!", "Latest on RubyGems")
   File.write(dir + "/version_list.html", raw.gsub("<!--replace-->", res))

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: discorb
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
 platform: ruby
 authors:
 - sevenc-nanashi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-10-02 00:00:00.000000000 Z
+date: 2021-10-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -142,8 +142,8 @@ files:
 - lib/discorb/error.rb
 - lib/discorb/event.rb
 - lib/discorb/exe/about.rb
-- lib/discorb/exe/init.rb
 - lib/discorb/exe/irb.rb
+- lib/discorb/exe/new.rb
 - lib/discorb/exe/run.rb
 - lib/discorb/exe/setup.rb
 - lib/discorb/exe/show.rb