mojang 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2a08c579322cc5c37c14c5e5b0835ac60138c15b
+  data.tar.gz: d6b5e673a294456325780acb81a4e522e323e67f
+SHA512:
+  metadata.gz: c8550b755c11fe989842a9c3b88c7459581e59b2b15dfd405489a7116da91d37c5b9ceaea6c46ff3768263d121dac7885ea9e2882700eeec2b8709d4bc8c140b
+  data.tar.gz: 5fdfc222c79dd752090d368d4038c000371a13e663b4eb0c52eee534da8f584aa95524c957c75214dc39e07daf012787062356bb1f4b44175cd4c5dd867b1232

data/LICENSE.md

@@ -0,0 +1,25 @@
+# The MIT License (MIT)
+
+Copyright © 2016 Eli Foster
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the “Software”), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+

data/lib/errors.rb

@@ -0,0 +1,29 @@
+module Mojang
+  module Errors
+    class NoSuchUserError < StandardError
+      attr_reader :user
+
+      def initialize(user)
+        @user = user
+      end
+
+      def message
+        "No such user '#{@user}'."
+      end
+    end
+
+    class MojangError < StandardError
+      attr_reader :error
+      attr_reader :msg
+
+      def initialize(error, msg)
+        @error = error
+        @msg = msg
+      end
+
+      def message
+        "#{@msg} (#{@error}"
+      end
+    end
+  end
+end

data/lib/mojang.rb

@@ -0,0 +1,87 @@
+require 'curb'
+require 'oj'
+require_relative 'errors'
+
+# Wrapper module around the Mojang and Minecraft web APIs.
+module Mojang
+  module_function
+
+  # Gets the status for the various Mojang and Minecraft servers and web services.
+  # @return [Hash<String, String>] A hash containing keys of the sites, and values of the statuses (green, yellow, red).
+  def status
+    response = Curl.get('https://status.mojang.com/check'.freeze).body_str
+    json = Oj.load(response)
+    ret = {}
+    # Reformatting the returned data because it is super annoying to work with.
+    json.each do |hash|
+      hash.each do |site, status|
+        ret[site] = status
+      end
+    end
+
+    ret
+  end
+
+  # Gets the User ID (UUID) for the given username at the given time.
+  # @param username [String] The username.
+  # @param date [Date] The date to get the ID at.
+  # @return [String] The username's user ID.
+  def userid(username, date = nil)
+    self.profile(username, date, 'id')
+  end
+
+  # Gets the username for the given UUID at the given time.
+  # @param uuid [String] The user's UUID (see #{userid})
+  # @param date [Date] The date to get the name at.
+  # @return [String] The user's username at the given time.
+  def username(uuid, date = nil)
+    self.profile(uuid, date, 'name')
+  end
+
+  # Gets whether the given username has paid for Minecraft.
+  # @param username [String] The username to check.
+  # @return [Boolean] Whether they have paid or not.
+  def has_paid?(username)
+    params = { user: username }
+    response = Curl.get('https://minecraft.net/haspaid.jsp', params).body_str
+
+    response == 'true'
+  end
+
+  # Gets a user's name history from their UUID.
+  # @param uuid [String] The user's ID (see #{userid}).
+  # @return [Hash<Symbol/Time, String>] A hash of all the names. Key is either :original, or the Time object of when
+  # the name was changed. Value is always the name at that point in time.
+  def name_history(uuid)
+    response = Curl.get("https://api.mojang.com/user/profiles/#{uuid}/names").body_str
+    json = Oj.load(response)
+    ret = {}
+    json.each do |hash|
+      if hash.key?('changedToAt')
+        ret[Time.at(hash['changedToAt'] / 1000)] = hash['name']
+      else
+        ret[:original] = hash['name']
+      end
+    end
+
+    ret
+  end
+
+  private
+
+  # Gets the profile data.
+  # @param query [String] Either a username or an ID; they are handled in the same way.
+  # @param date [Date] The date to get at.
+  # @param return_val [String] The key in the returned hash to return.
+  # @return [String] The returned value for the return_val key.
+  def self.profile(query, date, return_val)
+    params = { at: date.to_i }
+    response = Curl.get("https://api.mojang.com/users/profiles/minecraft/#{query}", params).body_str
+    fail NoSuchUserError.new(query) if response.empty?
+    json = Oj.load(response)
+    if json.key?('error')
+      fail MojangError.new(json['error'], json['errorMessage'])
+    end
+    return json[return_val]
+  end
+end

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: mojang
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Eli Foster
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-04-03 00:00:00.000000000 Z
+dependencies: []
+description: A Ruby library accessing the Mojang and Minecraft web APIs
+email: elifosterwy@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- lib/errors.rb
+- lib/mojang.rb
+homepage: https://github.com/elifoster/mojang-rb
+licenses:
+- MIT
+metadata:
+  issue_tracker: https://github.com/elifoster/mojang-rb/issues
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Mojang and Minecraft web APIs in Ruby
+test_files: []