gems 0.8.3 → 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 27bd2da368ca93d2b8ac32fd25465987368be2b0
+  data.tar.gz: c53afd6178dfab27ca122e9b144b441e71f69a47
+SHA512:
+  metadata.gz: 2bd0758a749c07093478dea04fe356f39e4be8158892b9a97f7b4e7bdd965cfd4b4cd28bdc422d5a2471acb88663cdc56883286f541032e9c639cbe6e15d65d9
+  data.tar.gz: 8a60367eec5ed9cd320909e8cc706091b0e4aaed76f19b9f95f9673f9b2d4fa2161638af876390bbb0d2bbf4c91ddb10c5b3537d1d93608130a00ab0ec761cf5

data/CONTRIBUTING.md

@@ -28,12 +28,12 @@ Ideally, a bug report should include a pull request with failing specs.
 3. Add specs for your unimplemented feature or bug fix.
 4. Run `bundle exec rake spec`. If your specs pass, return to step 3.
 5. Implement your feature or bug fix.
-6. Run `bundle exec rake spec`. If your specs fail, return to step 5.
+6. Run `bundle exec rake`. If your specs fail, return to step 5.
 7. Run `open coverage/index.html`. If your changes are not completely covered
    by your tests, return to step 3.
 8. Add documentation for your feature or bug fix.
-9. Run `bundle exec rake yard`. If your changes are not 100% documented, go
-   back to step 8.
+9. Run `bundle exec rake verify_measurements`. If your changes are not 100%
+   documented, go back to step 8.
 10. Add, commit, and push your changes.
 11. [Submit a pull request.][pr]
 

data/README.md

@@ -1,10 +1,10 @@
 # Gems
 
-[![Gem Version](https://badge.fury.io/rb/gems.png)][gem]
-[![Build Status](https://secure.travis-ci.org/rubygems/gems.png?branch=master)][travis]
-[![Dependency Status](https://gemnasium.com/rubygems/gems.png?travis)][gemnasium]
-[![Code Climate](https://codeclimate.com/github/rubygems/gems.png)][codeclimate]
-[![Coverage Status](https://coveralls.io/repos/rubygems/gems/badge.png?branch=master)][coveralls]
+[![Gem Version](http://img.shields.io/gem/v/gems.svg)][gem]
+[![Build Status](http://img.shields.io/travis/rubygems/gems.svg)][travis]
+[![Dependency Status](http://img.shields.io/gemnasium/rubygems/gems.svg)][gemnasium]
+[![Code Climate](http://img.shields.io/codeclimate/github/rubygems/gems.svg)][codeclimate]
+[![Coverage Status](http://img.shields.io/coveralls/rubygems/gems.svg)][coveralls]
 
 [gem]: https://rubygems.org/gems/gems
 [travis]: http://travis-ci.org/rubygems/gems
@@ -17,16 +17,6 @@ Ruby wrapper for the RubyGems.org API.
 ## Installation
     gem install gems
 
-To ensure the code you're installing hasn't been tampered with, it's
-recommended that you verify the signature. To do this, you need to add my
-public key as a trusted certificate (you only need to do this once):
-
-    gem cert --add <(curl -Ls https://raw.github.com/rubygems/gems/master/certs/sferik.pem)
-
-Then, install the gem with the high security trust policy:
-
-    gem install gems -P HighSecurity
-
 ## Documentation
 [http://rdoc.info/gems/gems](http://rdoc.info/gems/gems)
 
@@ -119,25 +109,23 @@ Then, install the gem with the high security trust policy:
     Gems.dependencies ['rails', 'thor']
 
     # The following methods require authentication.
-    # By default, we load your API key from ~/.gem/credentails
+    # By default, we load your API key from ~/.gem/credentials
     # You can override this default by specifying a custom API key.
     Gems.configure do |config|
-      config.key '701243f217cdf23b1370c7b66b65ca97'
+      config.key = '701243f217cdf23b1370c7b66b65ca97'
     end
 
 ## Supported Ruby Versions
 This library aims to support and is [tested against][travis] the following Ruby
 implementations:
 
-* Ruby 1.8.7
-* Ruby 1.9.2
-* Ruby 1.9.3
-* Ruby 2.0.0
+* Ruby 2.1
+* Ruby 2.2
+* Ruby 2.3
+* Ruby 2.4
 * [JRuby][]
-* [Rubinius][]
 
 [jruby]: http://www.jruby.org/
-[rubinius]: http://rubini.us/
 
 If something doesn't work on one of these interpreters, it's a bug.
 

data/gems.gemspec

@@ -4,21 +4,17 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'gems/version'
 
 Gem::Specification.new do |spec|
+  spec.add_dependency 'json'
   spec.add_development_dependency 'bundler', '~> 1.0'
-  spec.authors     = ["Erik Michaels-Ober"]
-  spec.cert_chain  = ['certs/sferik.pem']
-  spec.description = %q{Ruby wrapper for the RubyGems.org API}
-  spec.email       = ['sferik@gmail.com']
-  spec.files       = `git ls-files`.split("\n")
-  spec.files       = %w(.yardopts CONTRIBUTING.md LICENSE.md README.md Rakefile gems.gemspec)
-  spec.files      += Dir.glob("lib/**/*.rb")
-  spec.files      += Dir.glob("spec/**/*")
-  spec.homepage    = 'https://github.com/rubygems/gems'
-  spec.licenses    = ['MIT']
-  spec.name        = 'gems'
-  spec.require_paths = ['lib']
-  spec.signing_key = File.expand_path("~/.gem/private_key.pem") if $0 =~ /gem\z/
-  spec.summary     = spec.description
-  spec.test_files  = Dir.glob("spec/**/*")
-  spec.version     = Gems::VERSION
+  spec.authors       = ['Erik Michaels-Ober']
+  spec.description   = 'Ruby wrapper for the RubyGems.org API'
+  spec.email         = ['sferik@gmail.com']
+  spec.files         = %w(.yardopts CONTRIBUTING.md LICENSE.md README.md gems.gemspec) + Dir['lib/**/*.rb']
+  spec.homepage      = 'https://github.com/rubygems/gems'
+  spec.licenses      = %w(MIT)
+  spec.name          = 'gems'
+  spec.require_paths = %w(lib)
+  spec.required_ruby_version = '>= 2.1.9'
+  spec.summary       = spec.description
+  spec.version       = Gems::VERSION
 end

data/lib/gems.rb

@@ -7,7 +7,7 @@ module Gems
     # Alias for Gems::Client.new
     #
     # @return [Gems::Client]
-    def new(options={})
+    def new(options = {})
       Gems::Client.new(options)
     end
 
@@ -17,8 +17,12 @@ module Gems
       new.send(method, *args, &block)
     end
 
-    def respond_to?(method, include_private=false)
-      new.respond_to?(method, include_private) || super(method, include_private)
+    def respond_to?(method_name, include_private = false)
+      new.respond_to?(method_name, include_private) || super(method_name, include_private)
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      new.respond_to?(method_name, include_private) || super(method_name, include_private)
     end
   end
 end

data/lib/gems/client.rb

@@ -1,14 +1,14 @@
 require 'date'
 require 'gems/configuration'
 require 'gems/request'
-require 'yaml'
+require 'json'
 
 module Gems
   class Client
     include Gems::Request
-    attr_accessor *Configuration::VALID_OPTIONS_KEYS
+    attr_accessor(*Configuration::VALID_OPTIONS_KEYS)
 
-    def initialize(options={})
+    def initialize(options = {})
       options = Gems.options.merge(options)
       Configuration::VALID_OPTIONS_KEYS.each do |key|
         send("#{key}=", options[key])
@@ -23,8 +23,8 @@ module Gems
     # @example
     #   Gems.info 'rails'
     def info(gem_name)
-      response = get("/api/v1/gems/#{gem_name}.yaml")
-      YAML.load(response)
+      response = get("/api/v1/gems/#{gem_name}.json")
+      JSON.parse(response)
     end
 
     # Returns an array of active gems that match the query
@@ -35,8 +35,8 @@ module Gems
     # @example
     #   Gems.search 'cucumber'
     def search(query)
-      response = get("/api/v1/search.yaml", {:query => query})
-      YAML.load(response)
+      response = get('/api/v1/search.json', :query => query)
+      JSON.parse(response)
     end
 
     # List all gems that you own
@@ -46,13 +46,9 @@ module Gems
     # @return [Array]
     # @example
     #   Gems.gems
-    def gems(user_handle=nil)
-      response = if user_handle
-        get("/api/v1/owners/#{user_handle}/gems.yaml")
-      else
-        get("/api/v1/gems.yaml")
-      end
-      YAML.load(response)
+    def gems(user_handle = nil)
+      response = user_handle ? get("/api/v1/owners/#{user_handle}/gems.json") : get('/api/v1/gems.json')
+      JSON.parse(response)
     end
 
     # Submit a gem to RubyGems.org or another host
@@ -63,8 +59,8 @@ module Gems
     # @return [String]
     # @example
     #   Gems.push File.new 'pkg/gemcutter-0.2.1.gem'
-    def push(gem, host=Configuration::DEFAULT_HOST)
-      post("/api/v1/gems", gem.read, 'application/octet-stream', host)
+    def push(gem, host = Configuration::DEFAULT_HOST)
+      post('/api/v1/gems', gem.read, 'application/octet-stream', host)
     end
 
     # Remove a gem from RubyGems.org's index
@@ -77,9 +73,9 @@ module Gems
     # @return [String]
     # @example
     #   Gems.yank "gemcutter", "0.2.1", {:platform => "x86-darwin-10"}
-    def yank(gem_name, gem_version=nil, options={})
+    def yank(gem_name, gem_version = nil, options = {})
       gem_version ||= info(gem_name)['version']
-      delete("/api/v1/gems/yank", options.merge(:gem_name => gem_name, :version => gem_version))
+      delete('/api/v1/gems/yank', options.merge(:gem_name => gem_name, :version => gem_version))
     end
 
     # Update a previously yanked gem back into RubyGems.org's index
@@ -92,9 +88,9 @@ module Gems
     # @return [String]
     # @example
     #   Gems.unyank "gemcutter", "0.2.1", {:platform => "x86-darwin-10"}
-    def unyank(gem_name, gem_version=nil, options={})
+    def unyank(gem_name, gem_version = nil, options = {})
       gem_version ||= info(gem_name)['version']
-      put("/api/v1/gems/unyank", options.merge(:gem_name => gem_name, :version => gem_version))
+      put('/api/v1/gems/unyank', options.merge(:gem_name => gem_name, :version => gem_version))
     end
 
     # Returns an array of gem version details
@@ -105,8 +101,8 @@ module Gems
     # @example
     #   Gems.versions 'coulda'
     def versions(gem_name)
-      response = get("/api/v1/versions/#{gem_name}.yaml")
-      YAML.load(response)
+      response = get("/api/v1/versions/#{gem_name}.json")
+      JSON.parse(response)
     end
 
     # Returns the total number of downloads for a particular gem
@@ -117,14 +113,9 @@ module Gems
     # @return [Hash]
     # @example
     #   Gems.total_downloads 'rails_admin', '0.0.1'
-    def total_downloads(gem_name=nil, gem_version=nil)
-      response = if gem_name
-        gem_version ||= info(gem_name)['version']
-        get("/api/v1/downloads/#{gem_name}-#{gem_version}.yaml")
-      else
-        get("/api/v1/downloads.yaml")
-      end
-      YAML.load(response)
+    def total_downloads(gem_name = nil, gem_version = nil)
+      response = gem_name ? get("/api/v1/downloads/#{gem_name}-#{gem_version || info(gem_name)['version']}.json") : get('/api/v1/downloads.json')
+      JSON.parse(response, :symbolize_names => true)
     end
 
     # Returns an array containing the top 50 downloaded gem versions for today
@@ -134,8 +125,8 @@ module Gems
     # @example
     #   Gems.most_downloaded_today
     def most_downloaded_today
-      response = get("/api/v1/downloads/top.yaml")
-      YAML.load(response)[:gems]
+      response = get('/api/v1/downloads/top.json')
+      JSON.parse(response)['gems']
     end
 
     # Returns an array containing the top 50 downloaded gem versions of all time
@@ -145,8 +136,8 @@ module Gems
     # @example
     #   Gems.most_downloaded
     def most_downloaded
-      response = get("/api/v1/downloads/all.yaml")
-      YAML.load(response)[:gems]
+      response = get('/api/v1/downloads/all.json')
+      JSON.parse(response)['gems']
     end
 
     # Returns the number of downloads by day for a particular gem version
@@ -159,14 +150,10 @@ module Gems
     # @return [Hash]
     # @example
     #   Gems.downloads 'coulda', '0.6.3', Date.today - 30, Date.today
-    def downloads(gem_name, gem_version=nil, from=nil, to=Date.today)
+    def downloads(gem_name, gem_version = nil, from = nil, to = Date.today)
       gem_version ||= info(gem_name)['version']
-      response = if from
-        get("/api/v1/versions/#{gem_name}-#{gem_version}/downloads/search.yaml", {:from => from.to_s, :to => to.to_s})
-      else
-        get("/api/v1/versions/#{gem_name}-#{gem_version}/downloads.yaml")
-      end
-      YAML.load(response)
+      response = from ? get("/api/v1/versions/#{gem_name}-#{gem_version}/downloads/search.json", :from => from.to_s, :to => to.to_s) : get("/api/v1/versions/#{gem_name}-#{gem_version}/downloads.json")
+      JSON.parse(response)
     end
 
     # View all owners of a gem that you own
@@ -177,8 +164,8 @@ module Gems
     # @example
     #   Gems.owners 'gemcutter'
     def owners(gem_name)
-      response = get("/api/v1/gems/#{gem_name}/owners.yaml")
-      YAML.load(response)
+      response = get("/api/v1/gems/#{gem_name}/owners.json")
+      JSON.parse(response)
     end
 
     # Add an owner to a RubyGem you own, giving that user permission to manage it
@@ -190,7 +177,7 @@ module Gems
     # @example
     #   Gems.add_owner 'gemcutter', 'josh@technicalpickles.com'
     def add_owner(gem_name, owner)
-      post("/api/v1/gems/#{gem_name}/owners", {:email => owner})
+      post("/api/v1/gems/#{gem_name}/owners", :email => owner)
     end
 
     # Remove a user's permission to manage a RubyGem you own
@@ -202,7 +189,7 @@ module Gems
     # @example
     #   Gems.remove_owner 'gemcutter', 'josh@technicalpickles.com'
     def remove_owner(gem_name, owner)
-      delete("/api/v1/gems/#{gem_name}/owners", {:email => owner})
+      delete("/api/v1/gems/#{gem_name}/owners", :email => owner)
     end
 
     # List the webhooks registered under your account
@@ -212,8 +199,8 @@ module Gems
     # @example
     #   Gems.web_hooks
     def web_hooks
-      response = get("/api/v1/web_hooks.yaml")
-      YAML.load(response)
+      response = get('/api/v1/web_hooks.json')
+      JSON.parse(response)
     end
 
     # Create a webhook
@@ -225,7 +212,7 @@ module Gems
     # @example
     #   Gems.add_web_hook 'rails', 'http://example.com'
     def add_web_hook(gem_name, url)
-      post("/api/v1/web_hooks", {:gem_name => gem_name, :url => url})
+      post('/api/v1/web_hooks', :gem_name => gem_name, :url => url)
     end
 
     # Remove a webhook
@@ -237,7 +224,7 @@ module Gems
     # @example
     #   Gems.remove_web_hook 'rails', 'http://example.com'
     def remove_web_hook(gem_name, url)
-      delete("/api/v1/web_hooks/remove", {:gem_name => gem_name, :url => url})
+      delete('/api/v1/web_hooks/remove', :gem_name => gem_name, :url => url)
     end
 
     # Test fire a webhook
@@ -249,7 +236,7 @@ module Gems
     # @example
     #   Gems.fire_web_hook 'rails', 'http://example.com'
     def fire_web_hook(gem_name, url)
-      post("/api/v1/web_hooks/fire", {:gem_name => gem_name, :url => url})
+      post('/api/v1/web_hooks/fire', :gem_name => gem_name, :url => url)
     end
 
     # Returns the 50 gems most recently added to RubyGems.org (for the first time)
@@ -259,9 +246,9 @@ module Gems
     # @return [Array]
     # @example
     #   Gem.latest
-    def latest(options={})
-      response = get("/api/v1/activity/latest.yaml", options)
-      YAML.load(response)
+    def latest(options = {})
+      response = get('/api/v1/activity/latest.json', options)
+      JSON.parse(response)
     end
 
     # Returns the 50 most recently updated gems
@@ -271,9 +258,9 @@ module Gems
     # @return [Array]
     # @example
     #   Gem.just_updated
-    def just_updated(options={})
-      response = get("/api/v1/activity/just_updated.yaml", options)
-      YAML.load(response)
+    def just_updated(options = {})
+      response = get('/api/v1/activity/just_updated.json', options)
+      JSON.parse(response)
     end
 
     # Retrieve your API key using HTTP basic auth
@@ -298,7 +285,7 @@ module Gems
     # @example
     #   Gems.dependencies 'rails', 'thor'
     def dependencies(*gems)
-      response = get('/api/v1/dependencies', {:gems => gems.join(',')})
+      response = get('/api/v1/dependencies', :gems => gems.join(','))
       Marshal.load(response)
     end
 
@@ -310,9 +297,9 @@ module Gems
     # @return [Array]
     # @example
     #   Gems.reverse_dependencies 'money'
-    def reverse_dependencies(gem_name, options={})
-      response = get("/api/v1/gems/#{gem_name}/reverse_dependencies.yaml", options)
-      YAML.load(response)
+    def reverse_dependencies(gem_name, options = {})
+      response = get("/api/v1/gems/#{gem_name}/reverse_dependencies.json", options)
+      JSON.parse(response)
     end
   end
 end

data/lib/gems/configuration.rb

@@ -11,18 +11,18 @@ module Gems
       :password,
       :user_agent,
       :username,
-    ]
+    ].freeze
 
     # Set the default API endpoint
-    DEFAULT_HOST = ENV['RUBYGEMS_HOST'] ? ENV['RUBYGEMS_HOST'] : "https://rubygems.org"
+    DEFAULT_HOST = ENV['RUBYGEMS_HOST'] ? ENV['RUBYGEMS_HOST'] : 'https://rubygems.org'
 
     # Set the default credentials
     DEFAULT_KEY = Gem.configuration.rubygems_api_key
 
     # Set the default 'User-Agent' HTTP header
-    DEFAULT_USER_AGENT = "Gems #{Gems::VERSION}"
+    DEFAULT_USER_AGENT = "Gems #{Gems::VERSION}".freeze
 
-    attr_accessor *VALID_OPTIONS_KEYS
+    attr_accessor(*VALID_OPTIONS_KEYS)
 
     # When this module is extended, set all configuration options to their default values
     def self.extended(base)
@@ -37,17 +37,17 @@ module Gems
     # Create a hash of options and their values
     def options
       options = {}
-      VALID_OPTIONS_KEYS.each{|k| options[k] = send(k)}
+      VALID_OPTIONS_KEYS.each { |k| options[k] = send(k) }
       options
     end
 
     # Reset all configuration options to defaults
     def reset
+      self.username = nil
+      self.password = nil
       self.host       = DEFAULT_HOST
       self.key        = DEFAULT_KEY
-      self.password   = nil
       self.user_agent = DEFAULT_USER_AGENT
-      self.username   = nil
       self
     end
   end