dblista 0.1.2 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ba88619d64539697aa11e51f60ecbf292729ae2d6d8c2ae3291caea28b40dc2
-  data.tar.gz: dcdcd9f0bb7482b30d0d388ea6cda59fad862267341e6b28e8e10bd558a0e3c2
+  metadata.gz: 520e714dd6b6d24600b0d43a3366996c9571c35d2ec87f25a3ffd1d68c61663a
+  data.tar.gz: 761385a770d6631b08d6a06d34956019376990a3257d8b7280f57b92f69adb16
 SHA512:
-  metadata.gz: 65e48135e27d24539322178ed7f7f27c437e7a54a2f22cf004780f9babad45b2baa96972f75f4c88e433e05f20be390453a1a6fdeb7b752da42d9e2b4929cb16
-  data.tar.gz: a3d951c2872d596ce2867b905df9d2e513d1c776ca89011c6b1b624a006dd590b66d370e413bc7213828fa317a0291d872f0a6767dec23a2621f61087c0fb12e
+  metadata.gz: 299e471f6a12be703653c813f061f7b6f2101a1ee2854dec20c089776f3805141939cc4382a3be281514a9d43526d1ca1e20d8333dc28aeabbe472167864f959
+  data.tar.gz: 47188ad512356e1459b1728bd5e3373d09a9e64f60d3ed287c46c7a0338bd04031c49380c4b35b7a085ca47a5a6f3cc3ca4efef9de8c6194b4265f5955b783a1

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    dblista (0.1.2)
+    dblista (0.2.1)
 
 GEM
   remote: https://rubygems.org/

data/lib/dblista.rb

@@ -12,6 +12,7 @@ require_relative 'dblista/errors'
 require_relative 'dblista/list/bot'
 require_relative 'dblista/list/server'
 require_relative 'dblista/user/client'
+require_relative 'dblista/helpers'
 
 # Main module
 module DBLista
@@ -34,7 +35,9 @@ module DBLista
     req['Content-Type'] = 'application/json'
     req['Authorization'] = token if token
     response = _https(uri).request(req)
-    JSON.parse response.body
+    result = JSON.parse response.body
+    raise DBLista::Error, result['error'].capitalize unless result['status'] == 'success'
+    result['data']
   end
 
   # @!visibility private

data/lib/dblista/errors.rb

@@ -6,6 +6,8 @@ module DBLista::Errors
   ID_NEEDED = 'You need to enter ID'
   # Raised when provided page is not an integer
   PAGE_INTEGER = 'Page must be an integer'
+  # Raised when rank is not an integer
+  RANK_INTEGER = 'Rank must be an integer'
   # Raised when token is not provided
   TOKEN_NOT_PROVIDED = 'Token is not provided'
   # Raised when type symbol is invalid

data/lib/dblista/helpers.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# Helper methods
+module DBLista::Helpers
+  # Crafts avatar url from user ID and avatar hash
+  #
+  # @param id [Integer] user ID
+  # @param hash [String] avatar hash
+  # @param size [Integer] avatar width (defaults to 2048)
+  # @return [Hash] raw data from DBLista
+  def self.get_avatar(id, hash, size = 2048)
+    "https://cdn.discordapp.com/avatars/#{id}/#{hash}?size=#{size}"
+  end
+end

data/lib/dblista/info.rb

@@ -8,7 +8,7 @@ module DBLista
   #
   # @example Checking DBLista user information
   #   info = DBLista::Information.user 123456789012345678
-  #   puts info['data']
+  #   puts info
   module Information
     # Fetches DBLista bot information
     #

data/lib/dblista/list/bot.rb

@@ -8,7 +8,7 @@ require 'cgi'
 #
 # @example Fetch top 25 bots
 #   top = DBLista::List::Bot.top
-#   puts top['data'].inspect
+#   puts top.inspect
 module DBLista::List
   # Bot lists
   module Bot

data/lib/dblista/user/actions.rb

@@ -2,8 +2,8 @@
 
 require 'json'
 
-# User client - actions
 module DBLista::User
+  # User client - actions
   module Actions
   # Adds bot/server to DBLista
   #
@@ -12,7 +12,7 @@ module DBLista::User
   # @return [Hash] raw data from DBLista
   def add(body, type = 'bot')
     raise DBLista::Error, DBLista::Errors::BODY_HASH unless body.is_a?(Hash)
-    raise DBLista::Error, DBLista::Errors::TYPE_NOT_ALLOWED unless ALLOWED_TYPES.include?(type)
+    raise DBLista::Error, DBLista::Errors::TYPE_NOT_ALLOWED unless DBLista::User::Client::ALLOWED_TYPES.include?(type)
 
     DBLista._post("/#{type}s", body, @token)
   end
@@ -40,5 +40,19 @@ module DBLista::User
 
     DBLista._delete("/#{type}s/#{id}", nil, @token)
   end
+
+  # Manages user (bans or adds premium)
+  # Available only for DBLista staff
+  #
+  # @param id [Integer] user ID
+  # @param banned [Boolean] user ban status
+  # @param premium [Integer] days for premium
+  # @return [Hash] raw data from DBLista
+  def manage_user(id, banned = false, premium = 0)
+    DBLista._post("/users/#{id}/manage", {
+                    premium: premium,
+                    ban: banned
+                  }, @token)
+  end
   end
 end

data/lib/dblista/user/boosting.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-##
-# User client - boosting
 module DBLista::User
+  # User client - boosting
   module Boosting
   # Boosts selected bot/server
   #
@@ -11,7 +10,7 @@ module DBLista::User
   # @return [Hash] raw data from DBLista
   def boost(id, type = :bot)
     DBLista._validate_id id
-    raise DBLista::Error, DBLista::Errors::TYPE_NOT_ALLOWED unless ALLOWED_TYPES.include?(type)
+    raise DBLista::Error, DBLista::Errors::TYPE_NOT_ALLOWED unless DBLista::User::Client::ALLOWED_TYPES.include?(type)
 
     DBLista._post("/#{type}s/#{id}/boost", nil, @token)
   end

data/lib/dblista/user/client.rb

@@ -4,6 +4,8 @@ require_relative './actions'
 require_relative './boosting'
 require_relative './rating'
 require_relative './voting'
+require_relative './notifications'
+require_relative './verification'
 
 # User module - client + client modules
 module DBLista::User
@@ -21,6 +23,8 @@ module DBLista::User
     include DBLista::User::Actions
     include DBLista::User::Boosting
     include DBLista::User::Rating
+    include DBLista::User::Notifications
+    include DBLista::User::Verification
 
     # Allowed entity types to use
     ALLOWED_TYPES = %i[bot server].freeze
@@ -32,14 +36,21 @@ module DBLista::User
 
       @token = token
 
-      raise DBLista::Error, DBLista::Errors::INVALID_TOKEN unless me['status'] == 'success'
+      me
     end
 
-    # Fetches information about user
+    # Fetches information about current user
     #
     # @return [Hash] raw data from DBLista
     def me
       DBLista._get('/users/me', @token)
     end
+
+    # Fetches current user guilds
+    #
+    # @return [Hash] raw data from DBLista
+    def guilds
+      DBLista._get('/users/me/guilds', @token)
+    end
   end
 end

data/lib/dblista/user/notifications.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module DBLista::User
+  # User client - notifications
+  module Notifications
+  # Fetches user notifications
+  #
+  # @return [Hash] raw data from DBLista
+  def notifications
+    DBLista._get('/users/me/notifications/read', @token)
+  end
+
+  # Clears user notifications
+  #
+  # @return [Hash] raw data from DBLista
+  def clear_notifications
+    DBLista._get('/users/me/notifications/clear', @token)
+  end
+
+  # Sends notification to specified user
+  # Available only for DBLista staff
+  #
+  # @param rank [Integer] user ID
+  # @param details [String] details (content)
+  # @param url [String] url to redirect if clicked
+  # @return [Hash] raw data from DBLista
+  def send_notification(id, details, url = '#')
+    DBLista._validate_id id
+    DBLista._post("/users/#{id}/notifications", {
+                    text: details,
+                    url: url || '#'
+                  }, @token)
+  end
+
+  # Sends notification to specified group (rank)
+  # Available only for DBLista staff
+  #
+  # @param rank [Integer] rank ID
+  # @param details [String] details (content)
+  # @param url [String] url to redirect if clicked
+  # @return [Hash] raw data from DBLista
+  def send_group_notification(rank, details, url = '#')
+    DBLista._post("/users/group/#{rank}/notifications", {
+                    text: details,
+                    url: url || '#'
+                  }, @token)
+  end
+  end
+end

data/lib/dblista/user/rating.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-# User client - rating
 module DBLista::User
+  # User client - rating
   module Rating
   # Sends rate for a selected bot/server
   #
@@ -12,7 +12,7 @@ module DBLista::User
   # @return [Hash] raw data from DBLista
   def rate(id, rating, details, type = :bot)
     DBLista._validate_id id
-    raise DBLista::Error, DBLista::Errors::TYPE_NOT_ALLOWED unless ALLOWED_TYPES.include?(type)
+    raise DBLista::Error, DBLista::Errors::TYPE_NOT_ALLOWED unless DBLista::User::Client::ALLOWED_TYPES.include?(type)
 
     DBLista._post("/#{type}s/#{id}/rate", {
                     rating: rating,

data/lib/dblista/user/verification.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'cgi'
+
+module DBLista::User
+  # User client - verification (only for staff)
+  module Verification
+  # Approves specified bot
+  #
+  # @param id [Integer] bot ID
+  # @param reason [String] reason for approving
+  # @return [Boolean] true if operation succeded
+  def approve(id, reason = 'Brak powodu')
+    DBLista._validate_id id
+
+    DBLista._post("/bots/#{id}/approve?reason=#{CGI.escape reason}", nil, @token)
+    true
+  end
+
+  # Rejects  specified bot
+  #
+  # @param id [Integer] bot ID
+  # @param reason [String] reason for rejecting
+  # @return [Boolean] true if operation succeded
+  def reject(id, reason = 'Brak powodu')
+    DBLista._validate_id id
+
+    DBLista._post("/bots/#{id}/reject?reason=#{CGI.escape reason}", nil, @token)
+    true
+  end
+
+  # Sets specified bot verification status to pending
+  #
+  # @param id [Integer] bot ID
+  # @return [Boolean] true if operation succeded
+  def set_pending(id)
+    DBLista._validate_id id
+
+    DBLista._post("/bots/#{id}/set-pending", nil, @token)
+    true
+  end
+  end
+end

data/lib/dblista/user/voting.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-# User client - voting
 module DBLista::User
+  # User client - voting
   module Voting
   # Votes for a selected bot/server
   #

data/lib/dblista/version.rb

@@ -2,5 +2,5 @@
 
 module DBLista
   # Wrapper version
-  VERSION = '0.1.2'
+  VERSION = '0.2.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dblista
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.1
 platform: ruby
 authors:
 - deepivin
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-07-04 00:00:00.000000000 Z
+date: 2020-07-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -71,6 +71,7 @@ files:
 - example/info.rb
 - lib/dblista.rb
 - lib/dblista/errors.rb
+- lib/dblista/helpers.rb
 - lib/dblista/info.rb
 - lib/dblista/list/bot.rb
 - lib/dblista/list/server.rb
@@ -78,7 +79,9 @@ files:
 - lib/dblista/user/actions.rb
 - lib/dblista/user/boosting.rb
 - lib/dblista/user/client.rb
+- lib/dblista/user/notifications.rb
 - lib/dblista/user/rating.rb
+- lib/dblista/user/verification.rb
 - lib/dblista/user/voting.rb
 - lib/dblista/version.rb
 homepage: https://github.com/marek12306/dblista-wrapper-ruby