discorb 0.5.4 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62a9092a32b87c1edbb193c7b3de777b499257a9b08f92f88a741506ecef58fe
-  data.tar.gz: 3df9d14c6c7ec041d9887b3479af2417295e17b148c1aea780230e84b5c0d799
+  metadata.gz: 4d2ef47227e1e5895bdcaf6a67641d22319909c0f6a461d72ab35be1e0c9a42b
+  data.tar.gz: 688a952b571421e8c43ca53b10f9404f6ba2abf8b9071222c35d3a10e34c5b7e
 SHA512:
-  metadata.gz: f26088e7ce6f9a4bd5877263cc716722ca3523047df3623e49a082940251d3a97cea81c289239a3c9f0b456f9a21ee637f1adcd8e804084550b6af10c2aea02b
-  data.tar.gz: bda9f44c79c089e7cf55eeef4e774c20e3891baf09e0eb73fd2faa6e9337e5abca02b66c0e5e2c2db386d136144441f34afdf306bb427b3fcf40fa8f85f875ae
+  metadata.gz: 9fd5eb78a1acda90e3c673a8745a2a9954ff8b8817c38210c5c609e6a85b16e4074b59bf8ae7bcc7725f7f45f22dfd785fb5edd321e9f61994bb071e4aa25a43
+  data.tar.gz: 4bee75498af33d4716e033f51103382d8931c079495d27234cf07cf5e5b288891b40fb7e00902d3c1d7150249d0c820701d9962130890005bea5378e46af5ac8

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,57 @@
+---
+name: Bug Report
+about: A bug report for discorb.
+labels:
+- bug
+---
+
+<!--
+Before submitting a bug report, please check that it is not already being, or has been, reported.
+Don't forget to find closed issues and check if the bug is already fixed.
+-->
+
+## What is the bug?
+
+<!--
+Please describe the bug in detail.
+Ex:
+  I want to sleep, but I can't.
+-->
+
+## What steps did you take to reproduce the bug?
+
+<!--
+Please describe the steps you took to reproduce the bug.
+Ex:
+  1. Go to bed
+  2. Count sheeps
+  3. Observe
+-->
+
+## What did you expect to see?
+
+<!--
+Please describe what you expected to see.
+Ex:
+  I can sleep.
+-->
+
+## What did you see instead?
+
+<!--
+Please describe what you saw instead.
+Ex:
+  I can't sleep.
+-->
+
+## Environment information
+
+<!--
+Use `discorb show` to get the current machine.
+-->
+
+## Other information
+
+<!--
+Please describe any other information you want to include as such as the screenshots you took, or the logs you generated.
+-->

data/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Documentation
+    url: https://discorb-lib.github.io/
+    about: Read the documentation first.
+  - name: Official Guild
+    url: https://discord.gg/hCP6zq8Vpj
+    about: Join the official Guild.

data/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,38 @@
+---
+name: Feature Request
+labels:
+- Feature Request
+- Enhancement
+about: Feature request for discorb's future.
+---
+<!--
+Before submitting a feature request, please check there is no existing feature request for the feature you are requesting.
+-->
+
+
+## What is the feature you are requesting?
+
+<!--
+Please describe the feature you are requesting.
+Ex: Create discorb-chan
+-->
+
+## Why do you need the feature?
+
+<!--
+Please describe the reason for the feature you are requesting.
+Ex: She's cute.
+-->
+
+## Alternative considerations?
+
+<!--
+Please describe alternative considerations for the feature you are requesting.
+Ex: Add discorb-kun
+-->
+
+## Additional context
+
+<!--
+Please describe any additional context you have for the feature you are requesting.
+-->

data/Changelog.md

@@ -127,4 +127,26 @@
 
 ## 0.5.4
 
-- Fix: Fix issue of receiving component events
+- Fix: Fix issue of receiving component events
+
+## 0.5.5
+
+- Fix: Fix some bugs
+
+## 0.5.6
+
+- Add: Raise error when intents are invalid
+- Fix: Fix Emoji#==
+
+## 0.6.0
+
+- Fix: Fix issue with client with no guilds
+- Add: Add rbs (experimental)
+- Add: Add `-t`, `--token` option to `discorb run`
+- Add: Add `-g`, `--guild` option to `discorb setup`
+- Change: Use `Async::Task<R>` instead of `R` in return value
+
+## 0.6.1
+
+- Change: Rename `Event#discriminator` to `Event#metadata`
+- Add: Add `:override` to `Client#on`

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    discorb (0.5.4)
+    discorb (0.6.1)
       async (~> 1.30.1)
       async-http (~> 0.56.5)
       async-websocket (~> 0.19.0)

data/docs/application_command.md

@@ -11,9 +11,9 @@ From: [Discord API docs](https://discord.com/developers/docs/interactions/applic
 ## How do I register an application command?
 
 Write to a your script:
-- {Discorb::Command::Handler.slash}, {Discorb::Command::Handler.slash_group} for slash commands,
-- {Discorb::Command::Handler.user_command} for user menu commands,
-- {Discorb::Command::Handler.message_command} for message menu commands.
+- {Discorb::ApplicationCommand::Handler.slash}, {Discorb::ApplicationCommand::Handler.slash_group} for slash commands,
+- {Discorb::ApplicationCommand::Handler.user_command} for user menu commands,
+- {Discorb::ApplicationCommand::Handler.message_command} for message menu commands.
 
 And then run `discorb setup` to register your application commands.
 {file:docs/cli/setup.md Learn more about `discorb setup`}. 
@@ -39,7 +39,7 @@ end
 client.run(ENV["DISCORD_BOT_TOKEN"])
 ```
 
-{Discorb::Command::Handler#slash} takes 5 arguments:
+{Discorb::ApplicationCommand::Handler#slash} takes 5 arguments:
 
 | Argument | Description |
 |---------|-------------|
@@ -107,7 +107,7 @@ In `type`, You must use one of the following:
 
 ### Group Slash Commands
 
-To register a group of slash commands, use {Discorb::Command::Handler#slash_group}.
+To register a group of slash commands, use {Discorb::ApplicationCommand::Handler#slash_group}.
 
 ```ruby
 group = client.slash_group("settings", "Set settings of bot.")
@@ -156,7 +156,7 @@ client.slash_group("settings", "Set settings of bot.") do
 end
 ```
 
-You can make subcommand group by using {Discorb::Command::Command::GroupCommand#group}.
+You can make subcommand group by using {Discorb::ApplicationCommand::Command::GroupCommand#group}.
 
 ```ruby
 group = client.slash_group("permission", "Set/Get command permissions.")
@@ -244,7 +244,7 @@ client.user_command("hello") do |interaction, user|
   interaction.post("Hello, #{user.name}!")
 end
 ```
-{Discorb::Command::Handler.user_command} takes 3 arguments:
+{Discorb::ApplicationCommand::Handler.user_command} takes 3 arguments:
 
 | Parameter | Description |
 | --- | --- |
@@ -268,7 +268,7 @@ client.message_command("Bookmark") do |interaction, message|
 end
 ```
 
-{Discorb::Command::Handler.message_command} takes 3 arguments:
+{Discorb::ApplicationCommand::Handler.message_command} takes 3 arguments:
 
 | Parameter | Description |
 | --- | --- |

data/docs/cli/run.md

@@ -17,6 +17,8 @@ discorb run [options] [script]
 
 The script to run. Defaults to `main.rb`.
 
+### Options
+
 #### `-d`, `--deamon`
 
 Run the client in deamon mode.
@@ -43,4 +45,12 @@ You can use `stdout` to write to the standard output, and `stderr` to write to t
 Whether to colorize the log output.
 If not specified, the default will be:
 - `true` if the file to write logs to is `stdout` or `stderr`.
-- `false` otherwise.
+- `false` otherwise.
+
+#### `-s`, `--setup`
+
+Whether to setup application commands.
+
+#### `-t`, `--token`
+
+The name of the environment variable to use for token, or just `-t` or `--token` for intractive prompt.

data/docs/cli/setup.md

@@ -7,7 +7,7 @@ This command will setup application commands.
 ## Usage
 
 ```
-discorb setup [script]
+discorb setup [options] [script]
 ```
 
 ### Arguments
@@ -15,3 +15,9 @@ discorb setup [script]
 #### `script`
 
 The script to setup. Defaults to `main.rb`.
+
+### Options
+
+#### `-g`, `--guild`
+
+Guild IDs to use as default. Can be specified multiple IDs by using `,` as delimiter.

data/docs/events.md

@@ -30,6 +30,35 @@ end
 
 If you want to seperate event handlers from the client, consider using {Discorb::Extension}. {file:docs/extension.md Learn more about extensions}.
 
+Since v0.6.1, you can set `:override` to `true` to register overridable event handlers.
+
+```ruby
+client.on :message, override: true do |event|
+  puts "This event handler is overrideable!"
+end
+
+client.on :message do |event|
+  puts "Override!"
+end
+```
+
+This example will print `Override!`, but not `This event handler is overrideable!`.
+This is useful for registering event handlers for default behaviour on errors.
+
+```ruby
+# In the library...
+
+client.on :command_error, override: true do |event, error|
+  $stderr.puts "Command error:\n#{error.full_message}"
+end
+
+# In your code...
+
+client.on :command_error do |event, error|
+  event.message.reply "An error occurred while executing that command!\n#{error.full_message}"
+end
+```
+
 ## Event reference
 
 ### Client events

data/docs/extension.md

@@ -36,7 +36,7 @@ end
 
 ## Register Command
 
-Since v0.5.2, {Discorb::Extension} includes {Discorb::Command::Handler} module, so you can register command with {Discorb::Command::Handler#slash} and {Discorb::Command::Handler#slash_group}.
+Since v0.5.2, {Discorb::Extension} includes {Discorb::ApplicationCommand::Handler} module, so you can register command with {Discorb::ApplicationCommand::Handler#slash} and {Discorb::ApplicationCommand::Handler#slash_group}.
 
 ```ruby
 module MyExtension

data/lib/discorb/{command.rb → app_command.rb}

@@ -4,9 +4,9 @@ module Discorb
   #
   # Handles application commands.
   #
-  module Command
+  module ApplicationCommand
     #
-    # Module to handle commands.
+    # Module to handle application commands.
     #
     module Handler
       #
@@ -24,15 +24,16 @@ module Discorb
       #   | `:type` | `Object` | Type of the option. |
       #   | `:choice` | `Hash{String => String, Integer, Float}` | Type of the option. |
       #
-      # @param [Array<#to_s>] guild_ids Guild IDs to restrict the command to.
+      # @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.
       #
-      # @return [Discorb::Command::Command::SlashCommand]
+      # @return [Discorb::ApplicationCommand::Command::SlashCommand] Command object.
       #
       # @see file:docs/application_command.md#register-slash-command
+      # @see file:docs/cli/setup.md
       #
-      def slash(command_name, description, options = {}, guild_ids: [], &block)
-        command = Discorb::Command::Command::SlashCommand.new(command_name, description, options, guild_ids, block, 1, "")
+      def slash(command_name, description, options = {}, guild_ids: nil, &block)
+        command = Discorb::ApplicationCommand::Command::SlashCommand.new(command_name, description, options, guild_ids, block, 1, "")
         @commands << command
         @bottom_commands << command
         command
@@ -43,17 +44,18 @@ module Discorb
       #
       # @param [String] command_name Command name.
       # @param [String] description Command description.
-      # @param [Array<#to_s>] guild_ids Guild IDs to restrict the command to.
+      # @param [Array<#to_s>, false, nil] guild_ids Guild IDs to set the command to. `false` to global command, `nil` to use default.
       #
       # @yield Block to execute as the command. It can be used to define sub-commands.
-      # @yieldself [Discorb::Command::Command::GroupCommand] Group command.
+      # @yieldself [Discorb::ApplicationCommand::Command::GroupCommand] Group command.
       #
-      # @return [Discorb::Command::Command::GroupCommand] Command object.
+      # @return [Discorb::ApplicationCommand::Command::GroupCommand] Command object.
       #
       # @see file:docs/slash_command.md
+      # @see file:docs/cli/setup.md
       #
-      def slash_group(command_name, description, guild_ids: [], &block)
-        command = Discorb::Command::Command::GroupCommand.new(command_name, description, guild_ids, nil, self)
+      def slash_group(command_name, description, guild_ids: nil, &block)
+        command = Discorb::ApplicationCommand::Command::GroupCommand.new(command_name, description, guild_ids, nil, self)
         command.instance_eval(&block) if block_given?
         @commands << command
         command
@@ -63,16 +65,16 @@ module Discorb
       # Add message context menu command.
       #
       # @param [String] command_name Command name.
-      # @param [Array<#to_s>] guild_ids Guild IDs to restrict the command to.
+      # @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.
       # @yield [interaction, message] Block to execute.
-      # @yieldparam [Discorb::CommandInteraction::UserMenuCommand] Interaction object.
-      # @yieldparam [Discorb::Message] user Message object.
+      # @yieldparam [Discorb::ApplicationCommandInteraction::UserMenuCommand] interaction Interaction object.
+      # @yieldparam [Discorb::Message] message Message object.
       #
-      # @return [Discorb::Command::Command] Command object.
+      # @return [Discorb::ApplicationCommand::Command] Command object.
       #
-      def message_command(command_name, guild_ids: [], &block)
-        command = Discorb::Command::Command.new(command_name, guild_ids, block, 3)
+      def message_command(command_name, guild_ids: nil, &block)
+        command = Discorb::ApplicationCommand::Command.new(command_name, guild_ids, block, 3)
         @commands << command
         command
       end
@@ -81,16 +83,16 @@ module Discorb
       # Add user context menu command.
       #
       # @param [String] command_name Command name.
-      # @param [Array<#to_s>] guild_ids Guild IDs to restrict the command to.
+      # @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.
       # @yield [interaction, user] Block to execute.
-      # @yieldparam [Discorb::CommandInteraction::UserMenuCommand] Interaction object.
+      # @yieldparam [Discorb::ApplicationCommandInteraction::UserMenuCommand] interaction Interaction object.
       # @yieldparam [Discorb::User] user User object.
       #
-      # @return [Discorb::Command::Command] Command object.
+      # @return [Discorb::ApplicationCommand::Command] Command object.
       #
-      def user_command(command_name, guild_ids: [], &block)
-        command = Discorb::Command::Command.new(command_name, guild_ids, block, 2)
+      def user_command(command_name, guild_ids: nil, &block)
+        command = Discorb::ApplicationCommand::Command.new(command_name, guild_ids, block, 2)
         @commands << command
         command
       end
@@ -100,20 +102,32 @@ module Discorb
       # @see Client#initialize
       #
       # @param [String] token Bot token.
+      # @param [Array<#to_s>, false, nil] guild_ids Guild IDs to use as default. If `false` is given, it will be global command.
+      #
       # @note `token` parameter only required if you don't run client.
       #
-      def setup_commands(token = nil)
+      def setup_commands(token = nil, guild_ids: nil)
         Async do
           @token ||= token
           @http = HTTP.new(self)
-          global_commands = @commands.select { |c| c.guild_ids.empty? }
-          guild_ids = Set[*@commands.map(&:guild_ids).flatten]
+          global_commands = @commands.select { |c| c.guild_ids == false or c.guild_ids == [] }
+          local_commands = @commands.select { |c| c.guild_ids.is_a?(Array) and c.guild_ids.any? }
+          default_commands = @commands.select { |c| c.guild_ids.nil? }
+          if guild_ids.is_a?(Array)
+            default_commands.each do |command|
+              command.instance_variable_set(:@guild_ids, guild_ids)
+            end
+            local_commands += default_commands
+          else
+            global_commands += default_commands
+          end
+          final_guild_ids = local_commands.map(&:guild_ids).flatten.map(&:to_s).uniq
           app_info = fetch_application.wait
           http.put("/applications/#{app_info.id}/commands", global_commands.map(&:to_hash)).wait unless global_commands.empty?
-          guild_ids.each do |guild_id|
-            commands = @commands.select { |c| c.guild_ids.include?(guild_id) }
+          final_guild_ids.each do |guild_id|
+            commands = local_commands.select { |c| c.guild_ids.include?(guild_id) }
             http.put("/applications/#{app_info.id}/guilds/#{guild_id}/commands", commands.map(&:to_hash)).wait
-          end unless guild_ids.empty?
+          end unless final_guild_ids.empty?
           @log.info "Successfully setup commands"
         end
       end
@@ -146,10 +160,10 @@ module Discorb
       # @!visibility private
       def initialize(name, guild_ids, block, type)
         @name = name
-        @guild_ids = guild_ids.map(&:to_s)
+        @guild_ids = guild_ids&.map(&:to_s)
         @block = block
         @raw_type = type
-        @type = Discorb::Command::Command.types[type]
+        @type = Discorb::ApplicationCommand::Command.types[type]
         @type_raw = type
         @id_map = Discorb::Dictionary.new
       end
@@ -174,12 +188,8 @@ module Discorb
 
         # @!visibility private
         def initialize(name, description, options, guild_ids, block, type, parent)
+          super(name, guild_ids, block, type)
           @description = description
-          @name = name
-          @guild_ids = guild_ids.map(&:to_s)
-          @block = block
-          @type = Discorb::Command::Command.types[type]
-          @type_raw = 1
           @options = options
           @id = nil
           @parent = parent
@@ -241,7 +251,7 @@ module Discorb
       # Represents the command with subcommands.
       #
       class GroupCommand < Command
-        # @return [Array<Discorb::Command::Command::SlashCommand, Discorb::Command::Command::SubcommandGroup>] The subcommands of the command.
+        # @return [Array<Discorb::ApplicationCommand::Command::SlashCommand, Discorb::ApplicationCommand::Command::SubcommandGroup>] The subcommands of the command.
         attr_reader :commands
         # @return [String] The description of the command.
         attr_reader :description
@@ -258,11 +268,11 @@ module Discorb
         #
         # Add new subcommand.
         #
-        # @param (see Discorb::Command::Handler#slash)
-        # @return [Discorb::Command::Command::SlashCommand] The added subcommand.
+        # @param (see Discorb::ApplicationCommand::Handler#slash)
+        # @return [Discorb::ApplicationCommand::Command::SlashCommand] The added subcommand.
         #
         def slash(command_name, description, options = {}, &block)
-          command = Discorb::Command::Command::SlashCommand.new(command_name, description, options, [], block, 1, @name)
+          command = Discorb::ApplicationCommand::Command::SlashCommand.new(command_name, description, options, [], block, 1, @name)
           @client.bottom_commands << command
           @commands << command
           command
@@ -275,14 +285,14 @@ module Discorb
         # @param [String] description Group description.
         #
         # @yield Block to execute as the command. It can be used to define sub-commands.
-        # @yieldself [Discorb::Command::Command::SubcommandGroup] Group command.
+        # @yieldself [Discorb::ApplicationCommand::Command::SubcommandGroup] Group command.
         #
-        # @return [Discorb::Command::Command::SubcommandGroup] Command object.
+        # @return [Discorb::ApplicationCommand::Command::SubcommandGroup] Command object.
         #
         # @see file:docs/slash_command.md
         #
         def group(command_name, description, &block)
-          command = Discorb::Command::Command::SubcommandGroup.new(command_name, description, @name, @client)
+          command = Discorb::ApplicationCommand::Command::SubcommandGroup.new(command_name, description, @name, @client)
           command.instance_eval(&block) if block_given?
           @commands << command
           command
@@ -332,7 +342,7 @@ module Discorb
       # Represents the subcommand group.
       #
       class SubcommandGroup < GroupCommand
-        # @return [Array<Discorb::Command::Command::SlashCommand>] The subcommands of the command.
+        # @return [Array<Discorb::ApplicationCommand::Command::SlashCommand>] The subcommands of the command.
         attr_reader :commands
 
         # @!visibility private
@@ -349,11 +359,11 @@ module Discorb
 
         #
         # Add new subcommand.
-        # @param (see Discorb::Command::Handler#slash)
-        # @return [Discorb::Command::Command::SlashCommand] The added subcommand.
+        # @param (see Discorb::ApplicationCommand::Handler#slash)
+        # @return [Discorb::ApplicationCommand::Command::SlashCommand] The added subcommand.
         #
         def slash(command_name, description, options = {}, &block)
-          command = Discorb::Command::Command::SlashCommand.new(command_name, description, options, [], block, 1, @parent + " " + @name)
+          command = Discorb::ApplicationCommand::Command::SlashCommand.new(command_name, description, options, [], block, 1, @parent + " " + @name)
           @commands << command
           @client.bottom_commands << command
           command