discordrb 1.7.2 → 1.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f91839616b4ad8e792ebfbd149f2ecfcdc50e614
-  data.tar.gz: 45afd38f057ffb4d9366eac1bf404bfca064363e
+  metadata.gz: bcde95d0c926eba8368ed3553686b396a4a500db
+  data.tar.gz: 387df5587eaeab2eb24a8cb085ea4e951ffff3bf
 SHA512:
-  metadata.gz: cf7c6250b3fc4bb927d76d7696d9f980559c1018e15a063306bba71d5c172dbd4c00ea01e26d85732fc2d056a1315ecaf672fc6e141d69d669b316d72c61efd6
-  data.tar.gz: 786ff878add75d25bdd5f49169f0ecd21515da2371e826dde0b5356d19bdcd293aab6bb842fb3b74109e03a72ee36f518b28fed85deca435e9b8b9bf5a3bb314
+  metadata.gz: 3374e7195c49d28d84cd936ff1e44b5232bbc65ad7df4fae6e9a22c2047730086b254af9e4ffde0d38c9b9a203be80fd8b1d86ef659816f9ee17fe6f3d39ca72
+  data.tar.gz: 271acc3f47814bf89b188fe02038d106a16c016b10eca67630a423e416a32c21815e743204a9028ed20991b4af5217860511690e04223c2e303d70da1c0205c4

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 1.7.3
+* The server banlist can now be accessed more nicely using `Server#bans`.
+* Some abstractions for OAuth application creation were added - `bot.create_oauth_application` and `bot.update_oauth_application`. See the docs about how to use them.
+
 ## 1.7.2
 * The `bot` object can now be read from all events, not just from command ones.
 * You can now set the `filter_volume` on VoiceBot, which corresponds to the old way of doing volume handling, in case the new way is too slow for you.

data/lib/discordrb/api.rb

@@ -128,6 +128,28 @@ module Discordrb::API
     )
   end
 
+  # Create an OAuth application
+  def create_oauth_application(token, name, redirect_uris)
+    request(
+      :post,
+      "#{APIBASE}/oauth2/applications",
+      { name: name, redirect_uris: redirect_uris }.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
+  # Change an OAuth application's properties
+  def update_oauth_application(token, name, redirect_uris, description = '', icon = nil)
+    request(
+      :put,
+      "#{APIBASE}/oauth2/applications",
+      { name: name, redirect_uris: redirect_uris, description: description, icon: icon }.to_json,
+      Authorization: token,
+      content_type: :json
+    )
+  end
+
   # Create a server
   def create_server(token, name, region = :london)
     request(

data/lib/discordrb/bot.rb

@@ -363,6 +363,26 @@ module Discordrb
       server
     end
 
+    # Creates a new application to do OAuth authorization with. This allows you to use OAuth to authorize users using
+    # Discord. For information how to use this, see this example: https://github.com/vishnevskiy/discord-oauth2-example
+    # @param name [String] What your application should be called.
+    # @param redirect_uris [Array<String>] URIs that Discord should redirect your users to after authorizing.
+    # @return [Array(String, String)] your applications' client ID and client secret to be used in OAuth authorization.
+    def create_oauth_application(name, redirect_uris)
+      response = JSON.parse(API.create_oauth_application(@token, name, redirect_uris))
+      [response['id'], response['secret']]
+    end
+
+    # Changes information about your OAuth application
+    # @param name [String] What your application should be called.
+    # @param redirect_uris [Array<String>] URIs that Discord should redirect your users to after authorizing.
+    # @param description [String] A string that describes what your application does.
+    # @param icon [String, nil] A data URI for your icon image (for example a base 64 encoded image), or nil if no icon
+    #   should be set or changed.
+    def update_oauth_application(name, redirect_uris, description = '', icon = nil)
+      API.update_oauth_application(@token, name, redirect_uris, description, icon)
+    end
+
     # Gets the user from a mention of the user.
     # @param mention [String] The mention, which should look like <@12314873129>.
     # @return [User] The user identified by the mention, or `nil` if none exists.

data/lib/discordrb/data.rb

@@ -910,6 +910,12 @@ module Discordrb
       role
     end
 
+    # @return [Array<User>] a list of banned users on this server.
+    def bans
+      users = JSON.parse(API.bans(@bot.token, @id))
+      users.map { |e| User.new(e['user'], @bot) }
+    end
+
     # Bans a user from this server.
     # @param user [User] The user to ban.
     # @param message_days [Integer] How many days worth of messages sent by the user should be deleted.

data/lib/discordrb/events/generic.rb

@@ -51,6 +51,7 @@ module Discordrb::Events
 
   # Generic event class that can be extended
   class Event
+    # @return [Bot] the bot used to initialize this event.
     attr_reader :bot
   end
 

data/lib/discordrb/version.rb

@@ -1,5 +1,5 @@
 # Discordrb and all its functionality, in this case only the version.
 module Discordrb
   # The current version of discordrb.
-  VERSION = '1.7.2'.freeze
+  VERSION = '1.7.3'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: discordrb
 version: !ruby/object:Gem::Version
-  version: 1.7.2
+  version: 1.7.3
 platform: ruby
 authors:
 - meew0
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-02-25 00:00:00.000000000 Z
+date: 2016-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faye-websocket