discordrb 3.3.0 → 3.4.0

data/Gemfile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
 # Specify your gem's dependencies in discordrb.gemspec

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015-2016 meew0
+Copyright (c) 2015-2020 meew0
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,42 +1,58 @@
 [![Gem](https://img.shields.io/gem/v/discordrb.svg)](https://rubygems.org/gems/discordrb)
 [![Gem](https://img.shields.io/gem/dt/discordrb.svg)](https://rubygems.org/gems/discordrb)
-[![Build Status](https://travis-ci.org/meew0/discordrb.svg?branch=master)](https://travis-ci.org/meew0/discordrb)
-[![Inline docs](https://inch-ci.org/github/meew0/discordrb.svg?branch=master&style=shields)](https://inch-ci.org/github/meew0/discordrb)
-[![Code Climate](https://codeclimate.com/github/meew0/discordrb/badges/gpa.svg)](https://codeclimate.com/github/meew0/discordrb)
-[![Test Coverage](https://codeclimate.com/github/meew0/discordrb/badges/coverage.svg)](https://codeclimate.com/github/meew0/discordrb/coverage)
+[![CircleCI](https://circleci.com/gh/shardlab/discordrb.svg?style=svg)](https://circleci.com/gh/shardlab/discordrb)
+[![Inline docs](http://inch-ci.org/github/shardlab/discordrb.svg?branch=main)](http://inch-ci.org/github/shardlab/discordrb)
 [![Join Discord](https://img.shields.io/badge/discord-join-7289DA.svg)](https://discord.gg/cyK3Hjm)
 # discordrb
 
-An implementation of the [Discord](https://discordapp.com/) API using Ruby.
+An implementation of the [Discord](https://discord.com/) API using Ruby.
 
 ## Quick links to sections
 
-* [Dependencies](https://github.com/meew0/discordrb#dependencies)
-* [Installation](https://github.com/meew0/discordrb#installation)
-* [Usage](https://github.com/meew0/discordrb#usage)
-* [Webhooks Client](https://github.com/meew0/discordrb#webhooks-client)
-* [Support](https://github.com/meew0/discordrb#support)
-* [Development](https://github.com/meew0/discordrb#development), [Contributing](https://github.com/meew0/discordrb#contributing)
-* [License](https://github.com/meew0/discordrb#license)
+* [Introduction](https://github.com/shardlab/discordrb#introduction)
+* [Dependencies](https://github.com/shardlab/discordrb#dependencies)
+* [Installation](https://github.com/shardlab/discordrb#installation)
+* [Usage](https://github.com/shardlab/discordrb#usage)
+* [Webhooks Client](https://github.com/shardlab/discordrb#webhooks-client)
+* [Support](https://github.com/shardlab/discordrb#support)
+* [Development](https://github.com/shardlab/discordrb#development), [Contributing](https://github.com/shardlab/discordrb#contributing)
+* [License](https://github.com/shardlab/discordrb#license)
 
-See also: [Documentation](https://www.rubydoc.info/gems/discordrb), [Tutorials](https://github.com/meew0/discordrb/wiki)
+See also: [Documentation](https://www.rubydoc.info/gems/discordrb), [Tutorials](https://github.com/shardlab/discordrb/wiki)
 
-## Dependencies
+## Introduction
+
+`discordrb` aims to meet the following design goals:
+
+1. Full coverage of the public bot API.
+2. Expressive, high level abstractions for rapid development of common applications.
+3. Friendly to Ruby beginners and beginners of open source contribution.
+
+If you enjoy using the library, consider getting involved with the community to help us improve and meet these goals!
+
+**You should consider using `discordrb` if:**
 
-* Ruby 2.2+
-* An installed build system for native extensions (on Windows for Ruby < 2.4, try the [DevKit](https://rubyinstaller.org/downloads/); installation instructions [here](https://github.com/oneclick/rubyinstaller/wiki/Development-Kit#quick-start) - you only need to do the quick start)
+- You need a bot - and fast - for small or medium sized communities, and don't want to be bogged down with "low level" details. Getting started takes minutes, and utilities like a command parser and tools for modularization make it simple to quickly add or change your bots functionality.
+- You like or want to learn Ruby, or want to contribute to a Ruby project. A lot of our users are new to Ruby, and eventually make their first open source contributions with us. We have an active Discord channel with experienced members who will happily help you get involved, either as a user or contributor.
+- You want to experiment with Discord's API or prototype concepts for Discord bots without too much commitment.
 
-> **Note:** RubyInstaller for Ruby versions 2.4+ will install the DevKit as the last step of the installation.
+**You should consider other libraries if:**
+
+- You need to scale to large volumes of servers (>2,500) with lots of members. It's still possible, but it can be difficult to scale Ruby processes, and it requires more in depth knowledge to do so well. Especially if you already have a bot that is on a large amount of servers, porting to Ruby is unlikely to improve your performance in most cases.
+- You want full control over the library that you're using. While we expose some "lower level" interfaces, they are unstable, and only exist to serve the more powerful abstractions in the library.
+
+## Dependencies
+
+* Ruby >= 2.5 supported
+* An installed build system for native extensions (on Windows, make sure you download the "Ruby+Devkit" version of [RubyInstaller](https://rubyinstaller.org/downloads/))
 
 ### Voice dependencies
 
 This section only applies to you if you want to use voice functionality.
-* [libsodium](https://github.com/meew0/discordrb/wiki/Installing-libsodium)
-* A compiled libopus distribution for your system, anywhere the script can find it. See [here](https://github.com/meew0/discordrb/wiki/Installing-libopus) for installation instructions.
+* [libsodium](https://github.com/shardlab/discordrb/wiki/Installing-libsodium)
+* A compiled libopus distribution for your system, anywhere the script can find it. See [here](https://github.com/shardlab/discordrb/wiki/Installing-libopus) for installation instructions.
 * [FFmpeg](https://www.ffmpeg.org/download.html) installed and in your PATH
 
-In addition to this, if you're on Windows and want to use voice functionality, your installed Ruby version **needs to be 32 bit**, as otherwise Opus won't work.
-
 ## Installation
 
 ### With Bundler
@@ -47,7 +63,7 @@ Using [Bundler](https://bundler.io/#getting-started), you can add discordrb to y
 
 And then install via `bundle install`.
 
-Run the [ping example](https://github.com/meew0/discordrb/blob/master/examples/ping.rb) to verify that the installation works (make sure to replace the token and client ID in there with your bots'!):
+Run the [ping example](https://github.com/shardlab/discordrb/blob/master/examples/ping.rb) to verify that the installation works (make sure to replace the token and client ID in there with your bots'!):
 
 To run the bot while using bundler:
 
@@ -63,7 +79,7 @@ Alternatively, while Bundler is the recommended option, you can also install dis
 
 #### Windows
 
-> **Make sure you have the DevKit installed! See the [Dependencies](https://github.com/meew0/discordrb#dependencies) section)**
+> **Make sure you have the DevKit installed! See the [Dependencies](https://github.com/shardlab/discordrb#dependencies) section)**
 
     gem install discordrb --platform=ruby
 
@@ -71,53 +87,9 @@ To run the bot:
 
     ruby ping.rb
 
-#### Troubleshooting
-
-**If you get an error like this when installing the gem**:
-
-    ERROR:  Error installing discordrb:
-            The 'websocket-driver' native gem requires installed build tools.
-
-You're missing the development kit required to build native extensions.
-
-##### RubyInstaller for ruby 2.4.3-2 and above
-
-RubyInstaller after version 2.3.3 now includes the development kit in the installer. If you do not have the development kit and have installed ruby using RubyInstaller, open a command prompt with administrator privileges and run:
-
-    ridk install
-
-Select option 3, and then run
-
-    ridk enable
-
-To enable the changes
-
-##### RubyInstaller for ruby 2.3.3 and below
+### Installation Troubleshooting
 
-Download the development kit [here](https://rubyinstaller.org/downloads/) (scroll down to "Development Kit", then choose the one for Ruby 2.0 and your system architecture) and extract it somewhere. Open a command prompt in that folder and run:
-
-    ruby dk.rb init
-    ruby dk.rb install
-
-Then reinstall discordrb:
-
-    gem uninstall discordrb
-    bundle install
-
-    # Or, if you didn't use bundler:
-    gem install discordrb
-
-**If Ruby complains about `ffi_c` not being able to be found:**
-
-For example
-
-    C:/Ruby23-x64/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:in `require': cannot load such file -- ffi_c (LoadError)
-
-Your ffi setup is screwed up, first run `gem uninstall ffi` (uninstall all versions if it asks you, say yes to any unmet dependencies), then run `gem install ffi --platform=ruby` to fix it. If it says something about build tools, follow the steps in the first troubleshooting section.
-
-**If you're having trouble getting voice playback to work**:
-
-Look here: https://github.com/meew0/discordrb/wiki/Voice-sending#troubleshooting
+See https://github.com/shardlab/discordrb/wiki/FAQ#installation for a list of common problems and solutions when installing `discordrb`.
 
 ## Usage
 
@@ -137,7 +109,7 @@ bot.run
 
 This bot responds to every "Ping!" with a "Pong!".
 
-See [additional examples here](https://github.com/meew0/discordrb/tree/master/examples).
+See [additional examples here](https://github.com/shardlab/discordrb/tree/master/examples).
 
 You can find examples of projects that use discordrb by [searching for the discordrb topic on GitHub](https://github.com/topics/discordrb).
 
@@ -148,7 +120,7 @@ If you've made an open source project on GitHub that uses discordrb, consider ad
 Also included is a webhooks client, which can be used as a separate gem `discordrb-webhooks`. This special client can be used to form requests to Discord webhook URLs in a high-level manner.
 
 - [`discordrb-webhooks` documentation](https://www.rubydoc.info/gems/discordrb-webhooks)
-- [More information about webhooks](https://support.discordapp.com/hc/en-us/articles/228383668-Intro-to-Webhooks)
+- [More information about webhooks](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks)
 - [Embed visualizer tool](https://leovoel.github.io/embed-visualizer/) - Includes a discordrb code generator for forming embeds
 
 ### Usage
@@ -156,7 +128,7 @@ Also included is a webhooks client, which can be used as a separate gem `discord
 ```ruby
 require 'discordrb/webhooks'
 
-WEBHOOK_URL = 'https://discordapp.com/api/webhooks/424070213278105610/yByxDncRvHi02mhKQheviQI2erKkfRRwFcEp0MMBfib1ds6ZHN13xhPZNS2-fJo_ApSw'.freeze
+WEBHOOK_URL = 'https://discord.com/api/webhooks/424070213278105610/yByxDncRvHi02mhKQheviQI2erKkfRRwFcEp0MMBfib1ds6ZHN13xhPZNS2-fJo_ApSw'.freeze
 
 client = Discordrb::Webhooks::Client.new(url: WEBHOOK_URL)
 client.execute do |builder|
@@ -173,19 +145,29 @@ end
 
 ## Support
 
-You can find me (@meew0, ID 66237334693085184) on the unofficial Discord API server - if you have a question, just ask there, I or somebody else will probably answer you: https://discord.gg/3Trm6FW
+If you need help or have a question, you can:
 
-## Development
+1. Join our [Discord channel](https://discord.gg/cyK3Hjm). This is the fastest means of getting support.
+2. [Open an issue](https://github.com/shardlab/discordrb/issues). Be sure to read the issue template, and provide as much detail as you can.
 
-**This section is for developing discordrb itself! If you just want to make a bot, see the [Installation](https://github.com/meew0/discordrb#installation) section.**
+## Contributing
 
-After checking out the repo, run `bin/setup` to install dependencies. You can then run tests via `bundle exec rspec spec`. Make sure to run rubocop also: `bundle exec rubocop`. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+Thank you for your interest in contributing!
+Bug reports and pull requests are welcome on GitHub at https://github.com/shardlab/discordrb.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+In general, we recommend starting by discussing what you would like to contribute in the [Discord channel](https://discord.gg/cyK3Hjm).
+There are usually a handful of people working on things for the library, and what you're looking for may already be on the way.
 
-## Contributing
+Additionally, there is a chance what you are looking for might already exist, or we decided not to pursue it for some reason.
+Be sure to use the search feature on our documentation, GitHub, and Discord to see if this might be the case.
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/meew0/discordrb.
+## Development setup
+
+**This section is for developing discordrb itself! If you just want to make a bot, see the [Installation](https://github.com/shardlab/discordrb#installation) section.**
+
+After checking out the repo, run `bin/setup` to install dependencies. You can then run tests via `bundle exec rspec spec`. Make sure to run rubocop also: `bundle exec rubocop`. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## License
 

data/Rakefile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'bundler/gem_helper'
 
 namespace :main do

data/bin/console

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require 'bundler/setup'
 require 'discordrb'

data/discordrb-webhooks.gemspec

@@ -1,18 +1,18 @@
-# coding: utf-8
+# frozen_string_literal: true
 
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'discordrb/webhooks/version'
 
 Gem::Specification.new do |spec|
   spec.name          = 'discordrb-webhooks'
   spec.version       = Discordrb::Webhooks::VERSION
-  spec.authors       = ['meew0']
+  spec.authors       = %w[meew0 swarley]
   spec.email         = ['']
 
   spec.summary       = 'Webhook client for discordrb'
   spec.description   = "A client for Discord's webhooks to fit alongside [discordrb](https://rubygems.org/gems/discordrb)."
-  spec.homepage      = 'https://github.com/meew0/discordrb'
+  spec.homepage      = 'https://github.com/shardlab/discordrb'
   spec.license       = 'MIT'
 
   spec.files         = `git ls-files -z lib/discordrb/webhooks/`.split("\x0") + ['lib/discordrb/webhooks.rb']
@@ -20,7 +20,7 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'rest-client', '>= 2.1.0.rc1'
+  spec.add_dependency 'rest-client', '>= 2.0.0'
 
-  spec.required_ruby_version = '>= 2.1.0'
+  spec.required_ruby_version = '>= 2.5'
 end

data/discordrb.gemspec

@@ -1,44 +1,44 @@
-# coding: utf-8
+# frozen_string_literal: true
 
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'discordrb/version'
 
 Gem::Specification.new do |spec|
   spec.name          = 'discordrb'
   spec.version       = Discordrb::VERSION
-  spec.authors       = ['meew0']
+  spec.authors       = %w[meew0 swarley]
   spec.email         = ['']
 
   spec.summary       = 'Discord API for Ruby'
-  spec.description   = 'A Ruby implementation of the Discord (https://discordapp.com) API.'
-  spec.homepage      = 'https://github.com/meew0/discordrb'
+  spec.description   = 'A Ruby implementation of the Discord (https://discord.com) API.'
+  spec.homepage      = 'https://github.com/shardlab/discordrb'
   spec.license       = 'MIT'
 
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|examples|lib/discordrb/webhooks)/}) }
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.metadata = {
-    'changelog_uri' => 'https://github.com/meew0/discordrb/blob/master/CHANGELOG.md'
+    'changelog_uri' => 'https://github.com/shardlab/discordrb/blob/master/CHANGELOG.md'
   }
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'rest-client', '>= 2.1.0.rc1'
+  spec.add_dependency 'ffi', '>= 1.9.24'
   spec.add_dependency 'opus-ruby'
+  spec.add_dependency 'rest-client', '>= 2.0.0'
   spec.add_dependency 'websocket-client-simple', '>= 0.3.0'
-  spec.add_dependency 'rbnacl', '~> 3.4.0' # 24: update
-  spec.add_dependency 'ffi', '>= 1.9.24'
 
   spec.add_dependency 'discordrb-webhooks', '~> 3.3.0'
 
-  spec.required_ruby_version = '>= 2.2.4'
+  spec.required_ruby_version = '>= 2.5'
 
-  spec.add_development_dependency 'bundler', '~> 1.10'
-  spec.add_development_dependency 'rake', '~> 10.0'
-  spec.add_development_dependency 'yard', '~> 0.9.9'
-  spec.add_development_dependency 'redcarpet', '~> 3.4.0' # YARD markdown formatting
-  spec.add_development_dependency 'rspec', '~> 3.4.0'
+  spec.add_development_dependency 'bundler', '>= 1.10', '< 3'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'redcarpet', '~> 3.5.0' # YARD markdown formatting
+  spec.add_development_dependency 'rspec', '~> 3.10.0'
   spec.add_development_dependency 'rspec-prof', '~> 0.0.7'
-  spec.add_development_dependency 'rubocop', '0.49.1'
-  spec.add_development_dependency 'simplecov', '~> 0.16.0'
+  spec.add_development_dependency 'rubocop', '~> 1.4.0'
+  spec.add_development_dependency 'rubocop-performance', '~> 1.0'
+  spec.add_development_dependency 'simplecov', '~> 0.19.0'
+  spec.add_development_dependency 'yard', '~> 0.9.9'
 end

data/lib/discordrb.rb

@@ -11,6 +11,79 @@ module Discordrb
 
   # The default debug logger used by discordrb.
   LOGGER = Logger.new(ENV['DISCORDRB_FANCY_LOG'])
+
+  # The Unix timestamp Discord IDs are based on
+  DISCORD_EPOCH = 1_420_070_400_000
+
+  # Used to declare what events you wish to recieve from Discord.
+  # @see https://discordapp.com/developers/docs/topics/gateway#gateway-intents
+  INTENTS = {
+    servers: 1 << 0,
+    server_members: 1 << 1,
+    server_bans: 1 << 2,
+    server_emojis: 1 << 3,
+    server_integrations: 1 << 4,
+    server_webhooks: 1 << 5,
+    server_invites: 1 << 6,
+    server_voice_states: 1 << 7,
+    server_presences: 1 << 8,
+    server_messages: 1 << 9,
+    server_message_reactions: 1 << 10,
+    server_message_typing: 1 << 11,
+    direct_messages: 1 << 12,
+    direct_message_reactions: 1 << 13,
+    direct_message_typing: 1 << 14
+  }.freeze
+
+  # @return [Integer] All available intents
+  ALL_INTENTS = INTENTS.values.reduce(&:|)
+
+  # Compares two objects based on IDs - either the objects' IDs are equal, or one object is equal to the other's ID.
+  def self.id_compare(one_id, other)
+    other.respond_to?(:resolve_id) ? (one_id.resolve_id == other.resolve_id) : (one_id == other)
+  end
+
+  # The maximum length a Discord message can have
+  CHARACTER_LIMIT = 2000
+
+  # Splits a message into chunks of 2000 characters. Attempts to split by lines if possible.
+  # @param msg [String] The message to split.
+  # @return [Array<String>] the message split into chunks
+  def self.split_message(msg)
+    # If the messages is empty, return an empty array
+    return [] if msg.empty?
+
+    # Split the message into lines
+    lines = msg.lines
+
+    # Turn the message into a "triangle" of consecutively longer slices, for example the array [1,2,3,4] would become
+    # [
+    #  [1],
+    #  [1, 2],
+    #  [1, 2, 3],
+    #  [1, 2, 3, 4]
+    # ]
+    tri = (0...lines.length).map { |i| lines.combination(i + 1).first }
+
+    # Join the individual elements together to get an array of strings with consecutively more lines
+    joined = tri.map(&:join)
+
+    # Find the largest element that is still below the character limit, or if none such element exists return the first
+    ideal = joined.max_by { |e| e.length > CHARACTER_LIMIT ? -1 : e.length }
+
+    # If it's still larger than the character limit (none was smaller than it) split it into the largest chunk without
+    # cutting words apart, breaking on the nearest space within character limit, otherwise just return an array with one element
+    ideal_ary = ideal.length > CHARACTER_LIMIT ? ideal.split(/(.{1,#{CHARACTER_LIMIT}}\b|.{1,#{CHARACTER_LIMIT}})/o).reject(&:empty?) : [ideal]
+
+    # Slice off the ideal part and strip newlines
+    rest = msg[ideal.length..-1].strip
+
+    # If none remains, return an empty array -> we're done
+    return [] unless rest
+
+    # Otherwise, call the method recursively to split the rest of the string and add it onto the ideal array
+    ideal_ary + split_message(rest)
+  end
 end
 
 # In discordrb, Integer and {String} are monkey-patched to allow for easy resolution of IDs

data/lib/discordrb/allowed_mentions.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'discordrb/id_object'
+
+module Discordrb
+  # Builder class for `allowed_mentions` when sending messages.
+  class AllowedMentions
+    # @return [Array<"users", "roles", "everyone">, nil]
+    attr_accessor :parse
+
+    # @return [Array<String, Integer>, nil]
+    attr_accessor :users
+
+    # @return [Array<String, Integer>, nil]
+    attr_accessor :roles
+
+    # @param parse [Array<"users", "roles", "everyone">] Mention types that can be inferred from the message.
+    #   `users` and `roles` allow for all mentions of the respective type to ping. `everyone` allows usage of `@everyone` and `@here`
+    # @param users [Array<User, String, Integer>] Users or user IDs that can be pinged. Cannot be used in conjunction with `"users"` in `parse`
+    # @param roles [Array<Role, String, Integer>] Roles or role IDs that can be pinged. Cannot be used in conjunction with `"roles"` in `parse`
+    def initialize(parse: nil, users: nil, roles: nil)
+      @parse = parse
+      @users = users
+      @roles = roles
+    end
+
+    # @!visibility private
+    def to_hash
+      {
+        parse: @parse,
+        users: @users&.map { |user| user.is_a?(IDObject) ? user.id : user },
+        roles: @roles&.map { |role| role.is_a?(IDObject) ? role.id : role }
+      }.compact
+    end
+  end
+end