discorb 0.2.3 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1381542f36d691bc8c16bbca477f7dbc034d18d4308c6e51689e02d766af9fac
-  data.tar.gz: 611e01c698fbb0c19f7a37cad66faddf5dfbba860b59dc2a140c3a3b7d85dd9e
+  metadata.gz: 48ed0b82cf398970b54454d1d41f60e8fdf55fb6d5499f1e55a54769d61bc954
+  data.tar.gz: 5aae36deb140de42e2ff94249f61aa346856682ae27de444eb2aadc8a0b29591
 SHA512:
-  metadata.gz: eab30f2c135c3a1dd63fc36cea26df4035f57da50e96fbc52e74d207248599dd0d50d7df9379bf20b906b128aa3e7abd47f637c7cd56662a991c7feb7cd7944e
-  data.tar.gz: e9b03bd76e066037ef98480c9952bbfe6a0d7d039199e5d2a804bac49e550d03b74c1596847e485f2ba13b935012c80fb39a356df21f0d154b981f705807a113
+  metadata.gz: 3cc6e43128c370e30e6d16b6a19ec88be33a848e56a112981a6f272146d3506222f2240d55edb359e2d1d60f64b002841e37de5b52aa5142d837bddf75afcf5f
+  data.tar.gz: 3cf2390626afa7eb22ac3d906e9915ba2e4cee75e40a3d6dc9bbf25b5d00db0bd693ae2c7d1798a8811ea2c57475ab90e9825ffb3ceb762e415167a80bb9f192

data/.gitignore

@@ -53,4 +53,5 @@ build-iPhoneSimulator/
 .rvmrc
 
 # Used by RuboCop. Remote config files pulled in from inherit_from directive.
-# .rubocop-https?--*
+# .rubocop-https?--*
+tmp-template-replace

data/.yardopts

@@ -2,6 +2,7 @@
 --no-private
 --markup markdown
 --tag flags:"Flags"
+--verbose
 -
-docs/*.md
+docs/**/*.md
 Changelog.md

data/Changelog.md

@@ -64,4 +64,13 @@
 
 ## 0.2.3
 
-- Fix: Fix critical error
+- Fix: Fix critical error
+
+## 0.2.4
+
+- Fix: Fix error in `Embed#image=`, `Embed#thumbnail=`
+
+## 0.2.5
+
+- Add: Add way to add event listener
+- Change: Move document to https://discorb-lib.github.io/

data/Gemfile

@@ -1,17 +1,17 @@
-# frozen_string_literal: true
-
-source "https://rubygems.org"
-
-# Specify your gem's dependencies in discorb.gemspec
-gemspec
-
-gem "rake", "~> 13.0"
-
-group :debug, optional: true do
-  gem "rufo", "~> 0.13.0"
-end
-
-group :docs, optional: true do
-  gem "redcarpet"
-  gem "yard", "~> 0.9.26"
-end
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in discorb.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+group :debug, optional: true do
+  gem "rufo", "~> 0.13.0"
+end
+
+group :docs, optional: true do
+  gem "redcarpet"
+  gem "yard", "~> 0.9.26"
+end

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    discorb (0.2.3)
+    discorb (0.3.1)
       async
       async-http
       async-websocket
@@ -34,11 +34,11 @@ GEM
     fiber-local (1.0.0)
     mime-types (3.3.1)
       mime-types-data (~> 3.2015)
-    mime-types-data (3.2021.0704)
-    nio4r (2.5.7)
+    mime-types-data (3.2021.0901)
+    nio4r (2.5.8)
     protocol-hpack (1.4.2)
     protocol-http (0.22.5)
-    protocol-http1 (0.14.1)
+    protocol-http1 (0.14.2)
       protocol-http (~> 0.22)
     protocol-http2 (0.14.2)
       protocol-hpack (~> 1.4)

data/README.md

@@ -1,5 +1,5 @@
 # discorb
-[![rubydoc](https://img.shields.io/badge/Document-rubydoc.info-blue.svg)](https://rubydoc.info/gems/discorb)
+[![Document](https://img.shields.io/badge/Document-discord--lib.github.io-blue.svg)](https://discorb-lib.github.io/)
 [![Gem](https://img.shields.io/gem/dt/discorb?logo=rubygems&logoColor=fff)](https://rubygems.org/gems/discorb)
 [![Gem](https://img.shields.io/gem/v/discorb?logo=rubygems&logoColor=fff)](https://rubygems.org/gems/discorb)
 [![Discord](https://img.shields.io/discord/863581274916913193?logo=discord&logoColor=fff&color=5865f2&label=Discord)](https://discord.gg/hCP6zq8Vpj)  

data/Rakefile

@@ -1,46 +1,171 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-task default: %i[]
-
-task :emoji_table do
-  require_relative "lib/discorb"
-
-  res = {}
-  Discorb::EmojiTable::DISCORD_TO_UNICODE.each do |discord, unicode|
-    res[unicode] ||= []
-    res[unicode] << discord
-  end
-
-  res_text = +""
-  res.each do |unicode, discord|
-    res_text << %(#{unicode.unpack("C*").pack("C*").inspect} => %w[#{discord.join(" ")}],\n)
-  end
-
-  table_script = File.read("lib/discorb/emoji_table.rb")
-
-  table_script.gsub!(/(?<=UNICODE_TO_DISCORD = {\n)[\s\S]+(?=}\.freeze)/, res_text)
-
-  File.open("lib/discorb/emoji_table.rb", "w") do |f|
-    f.print(table_script)
-  end
-  `rubocop -A lib/discorb/emoji_table.rb`
-  puts "Successfully made emoji_table.rb"
-end
-
-task :format do
-  Dir.glob("**/*.rb").each do |file|
-    next if file.start_with?("vendor")
-
-    puts "Formatting #{file}"
-    `rufo ./#{file}`
-    content = ""
-    File.open(file, "rb") do |f|
-      content = f.read
-    end
-    content.gsub!("\r\n", "\n")
-    File.open(file, "wb") do |f|
-      f.print(content)
-    end
-  end
-end
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require_relative "lib/discorb/utils/colored_puts"
+task default: %i[]
+
+# @!visibility private
+def get_version
+  require_relative "lib/discorb/common"
+  latest_commit = `git log --oneline`.force_encoding("utf-8").split("\n")[0]
+  version = Discorb::VERSION
+  unless latest_commit.downcase.include?("update version")
+    version += "-dev"
+  end
+  version
+end
+
+desc "Build emoji_table.rb"
+task :emoji_table do
+  require_relative "lib/discorb"
+
+  gputs "Building emoji_table.rb"
+  res = {}
+  Discorb::EmojiTable::DISCORD_TO_UNICODE.each do |discord, unicode|
+    res[unicode] ||= []
+    res[unicode] << discord
+  end
+
+  res_text = +""
+  res.each do |unicode, discord|
+    res_text << %(#{unicode.unpack("C*").pack("C*").inspect} => %w[#{discord.join(" ")}],\n)
+  end
+
+  table_script = File.read("lib/discorb/emoji_table.rb")
+
+  table_script.gsub!(/(?<=UNICODE_TO_DISCORD = {\n)[\s\S]+(?=}\.freeze)/, res_text)
+
+  File.open("lib/discorb/emoji_table.rb", "w") do |f|
+    f.print(table_script)
+  end
+  `rufo lib/discorb/emoji_table.rb`
+  sputs "Successfully made emoji_table.rb"
+end
+
+desc "Format files"
+task :format do
+  Dir.glob("**/*.rb").each do |file|
+    next if file.start_with?("vendor")
+
+    gputs "Formatting #{file}"
+    `rufo ./#{file}`
+    content = ""
+    File.open(file, "rb") do |f|
+      content = f.read
+    end
+    content.gsub!("\r\n", "\n")
+    File.open(file, "wb") do |f|
+      f.print(content)
+    end
+  end
+end
+
+desc "Generate document and replace"
+namespace :document do
+  version = get_version
+
+  desc "Just generate document"
+  task :yard do
+    sh "yardoc -o doc/#{version}"
+  end
+
+  desc "Replace files"
+  namespace :replace do
+    require "fileutils"
+
+    desc "Replace CSS"
+    task :css do
+      gputs "Replacing css"
+      Dir.glob("template-replace/files/**/*.*")
+        .map { |f| f.delete_prefix("template-replace/files") }.each do |file|
+        FileUtils.cp("template-replace/files" + file, "doc/#{version}/#{file}")
+      end
+      sputs "Successfully replaced css"
+    end
+
+    desc "Replace HTML"
+    task :html do
+      require_relative "template-replace/scripts/sidebar.rb"
+      require_relative "template-replace/scripts/version.rb"
+      require_relative "template-replace/scripts/index.rb"
+      require_relative "template-replace/scripts/yard_replace.rb"
+      gputs "Resetting changes"
+      Dir.glob("doc/#{version}/**/*.html") do |f|
+        next if (m = f.match(/[0-9]+\.[0-9]+\.[0-9]+(-[a-z]+)?/)) && m[0] != version
+
+        content = File.read(f)
+        content.gsub!(/<!--od-->[\s\S]*<!--eod-->/, "")
+        File.write(f, content)
+      end
+      gputs "Adding version tab"
+      %w[file_list class_list method_list].each do |f|
+        replace_sidebar("doc/#{version}/#{f}.html")
+      end
+
+      gputs "Building version tab"
+      build_version_sidebar("doc/#{version}")
+      gputs "Replacing _index.html"
+      replace_index("doc/#{version}", version)
+      gputs "Replacing YARD credits"
+      yard_replace("doc/#{version}", version)
+      gputs "Successfully replaced htmls"
+    end
+
+    desc "Replace EOL"
+    task :eol do
+      gputs "Replacing CRLF with LF"
+      Dir.glob("doc/**/*.*") do |file|
+        next unless File.file?(file)
+
+        content = ""
+        File.open(file, "rb") do |f|
+          content = f.read
+        end
+        content.gsub!("\r\n", "\n")
+        File.open(file, "wb") do |f|
+          f.print(content)
+        end
+      end
+      sputs "Successfully replaced CRLF with LF"
+    end
+  end
+  task :replace => %i[replace:css replace:html replace:eol]
+
+  desc "Build all versions"
+  task :build_all do
+    require "fileutils"
+    gputs "Building all versions"
+    FileUtils.cp_r("./template-replace/.", "./tmp-template-replace")
+    tags = `git tag`.force_encoding("utf-8").split("\n")
+    tags.each do |tag|
+      sh "git checkout #{tag} -f"
+      gputs "Building #{tag}"
+      FileUtils.cp_r("./tmp-template-replace/.", "./template-replace")
+      version = tag.delete_prefix("v")
+      Rake::Task["document:yard"].execute
+      Rake::Task["document:replace:html"].execute
+      Rake::Task["document:replace:css"].execute
+      Rake::Task["document:replace:eol"].execute
+    end
+    version = "."
+    Rake::Task["document:yard"].execute
+    Rake::Task["document:replace:html"].execute
+    Rake::Task["document:replace:css"].execute
+    Rake::Task["document:replace:eol"].execute
+    sh "git switch main -f"
+    sputs "Successfully built all versions"
+  end
+
+  desc "Push to discorb-lib/discorb-lib.github.io"
+  task :push do
+    gputs "Pushing documents"
+    Dir.chdir("doc") do
+      sh "git add ."
+      sh "git commit -m \"Update: Update document\""
+      sh "git push -f"
+    end
+    sputs "Successfully pushed documents"
+  end
+end
+
+task :document => %i[document:yard document:replace]

data/crowdin.yml

@@ -0,0 +1,3 @@
+files:
+  - source: /po/yard.pot
+    translation: /po/%two_letters_code%.po

data/discorb.gemspec

@@ -18,6 +18,7 @@ Gem::Specification.new do |spec|
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/discorb-lib/discorb"
   spec.metadata["changelog_uri"] = "https://github.com/discorb-lib/discorb/blob/main/Changelog.md"
+  spec.metadata["documentation_uri"] = "https://discorb-lib.github.io"
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.

data/docs/application_command.md

@@ -10,7 +10,7 @@ From: [Discord API docs](https://discord.com/developers/docs/interactions/applic
 
 ## How do I register an application command?
 
-Use {Discorb::Command::Handler#slash}, {Discorb::Command::Handler#group} for slash commands, {Discorb::Command::Handler#user_command} for user menu commands, and {Discorb::Command::Handler#message_command} for message menu commands.
+Use {Discorb::Command::Handler.slash}, {Discorb::Command::Handler.slash_group} for slash commands, {Discorb::Command::Handler.user_command} for user menu commands, and {Discorb::Command::Handler.message_command} for message menu commands.
 
 ### Note
 
@@ -69,7 +69,7 @@ In `options`, hash should be like this:
 {
     "vocaloid" => {
         required: true,
-        description: "The vocaloid which you like."
+        description: "The vocaloid which you like.",
         type: :string,
         choices: {
             "Hatsune Miku" => "miku",
@@ -125,7 +125,7 @@ group.slash("bump_alert", "Whether bot should notify DISBOARD bump.", {
 end
 ```
 
-You can make subcommand group by using {Discorb::Command::GroupCommand#group}.
+You can make subcommand group by using {Discorb::Command::Command::GroupCommand#group}.
 
 ```ruby
 group = client.slash_group("permission", "Set/Get command permissions.")
@@ -211,7 +211,7 @@ client.user_command("hello") do |interaction, user|
   interaction.post("Hello, #{user.name}!")
 end
 ```
-{Discorb::Command::Handler#user_command} takes 3 arguments:
+{Discorb::Command::Handler.user_command} takes 3 arguments:
 
 | Parameter | Description |
 | --- | --- |
@@ -235,7 +235,7 @@ client.message_command("Bookmark") do |interaction, message|
 end
 ```
 
-{Discorb::Command::Handler#message_command} takes 3 arguments:
+{Discorb::Command::Handler.message_command} takes 3 arguments:
 
 | Parameter | Description |
 | --- | --- |
@@ -248,4 +248,4 @@ end
 | Parameter | Description |
 | --- | --- |
 | `interaction` | The interaction object. |
-| `message` | The message object. |
+| `message` | The message object. |

data/docs/cli/init.md

@@ -0,0 +1,55 @@
+# @title CLI: discorb init
+
+# discorb init
+
+This command will create a new project in the directory.
+
+## Usage
+
+```bash
+discorb init [options] [dir]
+```
+
+## Options
+
+### `dir`
+
+The directory to create the project in.
+Defaults to the current directory.
+If the directory exists and is not empty, an error is returned.
+You can use `--force` to overwrite an existing directory.
+
+### `--[no-]bundle`
+
+Whether to use bundle.
+If true, the command will create Gemfile and execute `bundle install`.
+Default to true.
+
+### `--[no-]git`
+
+Whether to initialize git.
+If true, the command will initialize git and commit the initial files with commit message `Initial commit`.
+Use `git commit --amend -m "..."` to change the commit message.
+Default to true.
+
+### `-t`, `--token`
+
+The name of token environment variable.
+Default to TOKEN.
+
+### `-f`, `--force`
+
+Whether to overwrite an existing directory.
+Default to false.
+
+## File structure
+
+The following files will be created:
+
+| File | Description |
+| ---- | ----------- |
+| `.env` | Environment variables. |
+| `.gitignore` | Git ignore file. Won't be created if `--git` is false. |
+| `Gemfile` | Gemfile. Won't be created if `--bundle` is false. |
+| `Gemfile.lock` | Gemfile lock file. Won't be created if `--bundle` is false. |
+| `main.rb` | Main script. |