123456789_123456789_123456789_123456789_123456789_

Module: Gem::GemcutterUtilities

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In:
Super Chains via Extension / Inclusion / Inheritance
Instance Chain:
self, Text
Defined in: lib/rubygems/gemcutter_utilities.rb

Overview

Utility methods for using the RubyGems API.

Instance Attribute Summary

  • #host rw

    The host to connect to either from the RUBYGEMS_HOST environment variable or from the user’s configuration.

  • #host=(value) rw

Instance Method Summary

Text - Included

#clean_text

Remove any non-printable characters and make the text suitable for printing.

#format_text

Wraps text to wrap characters and optionally indents by indent characters.

#levenshtein_distance

This code is based directly on the Text gem implementation Returns a value representing the “cost” of transforming str1 into str2.

#truncate_text, #min3

Instance Attribute Details

#host (rw)

The host to connect to either from the RUBYGEMS_HOST environment variable or from the user’s configuration

[ GitHub ]

  
# File 'lib/rubygems/gemcutter_utilities.rb', line 57

def host
  configured_host = Gem.host unless
    Gem.configuration.disable_default_gem_server

  @host ||=
    begin
      env_rubygems_host = ENV['RUBYGEMS_HOST']
      env_rubygems_host = nil if
        env_rubygems_host and env_rubygems_host.empty?

      env_rubygems_host|| configured_host
    end
end

#host=(value) (rw)

[ GitHub ]

  
# File 'lib/rubygems/gemcutter_utilities.rb', line 17

attr_writer :host

Instance Method Details

#add_key_option

Add the –key option

[ GitHub ]

  
# File 'lib/rubygems/gemcutter_utilities.rb', line 22

def add_key_option
  add_option('-k', '--key KEYNAME', Symbol,
             'Use the given API key',
             'from ~/.gem/credentials') do |value,options|
    options[:key] = value
  end
end

#add_otp_option

Add the –otp option

[ GitHub ]

  
# File 'lib/rubygems/gemcutter_utilities.rb', line 33

def add_otp_option
  add_option('--otp CODE',
             'Digit code for multifactor authentication') do |value, options|
    options[:otp] = value
  end
end

#api_key

The API key from the command options or from the user’s configuration.

[ GitHub ]

  
# File 'lib/rubygems/gemcutter_utilities.rb', line 43

def api_key
  if options[:key]
    verify_api_key options[:key]
  elsif Gem.configuration.api_keys.key?(host)
    Gem.configuration.api_keys[host]
  else
    Gem.configuration.rubygems_api_key
  end
end

#need_otp?(response) ⇒ Boolean

Returns true when the user has enabled multifactor authentication from response text.

[ GitHub ]

  
# File 'lib/rubygems/gemcutter_utilities.rb', line 183

def need_otp?(response)
  return unless response.kind_of?(Net::HTTPUnauthorized) &&
      response.body.start_with?('You have enabled multifactor authentication')
  return true if options[:otp]

  say 'You have enabled multi-factor authentication. Please enter OTP code.'
  options[:otp] = ask 'Code: '
  true
end

#rubygems_api_request(method, path, host = nil, allowed_push_host = nil, &block)

Creates an RubyGems API to #host and Gem.path with the given HTTP method.

If allowed_push_host metadata is present, then it will only allow that host.

[ GitHub ]

  
# File 'lib/rubygems/gemcutter_utilities.rb', line 76

def rubygems_api_request(method, path, host = nil, allowed_push_host = nil, &block)
  require 'net/http'

  self.host = host if host
  unless self.host
    alert_error "You must specify a gem server"
    terminate_interaction 1 # TODO: question this
  end

  if allowed_push_host
    allowed_host_uri = URI.parse(allowed_push_host)
    host_uri         = URI.parse(self.host)

    unless (host_uri.scheme == allowed_host_uri.scheme) && (host_uri.host == allowed_host_uri.host)
      alert_error "#{self.host.inspect} is not allowed by the gemspec, which only allows #{allowed_push_host.inspect}"
      terminate_interaction 1
    end
  end

  uri = URI.parse "#{self.host}/#{path}"

  request_method = Net::HTTP.const_get method.to_s.capitalize

  Gem::RemoteFetcher.fetcher.request(uri, request_method, &block)
end

#set_api_key(host, key)

[ GitHub ]

  
# File 'lib/rubygems/gemcutter_utilities.rb', line 193

def set_api_key(host, key)
  if host == Gem::DEFAULT_HOST
    Gem.configuration.rubygems_api_key = key
  else
    Gem.configuration.set_api_key host, key
  end
end

#sign_in(sign_in_host = nil)

Signs in with the RubyGems API at sign_in_host and sets the rubygems API key.

[ GitHub ]

  
# File 'lib/rubygems/gemcutter_utilities.rb', line 106

def ( = nil)
   ||= self.host
  return if api_key

  pretty_host = if Gem::DEFAULT_HOST == 
                  'RubyGems.org'
                else
                  
                end

  say "Enter your #{pretty_host} credentials."
  say "Don't have an account yet? " +
      "Create one at #{}/sign_up"

  email    =              ask "   Email: "
  password = ask_for_password "Password: "
  say "\n"

  response = rubygems_api_request(:get, "api/v1/api_key",
                                  ) do |request|
    request.basic_auth email, password
  end

  if need_otp? response
    response = rubygems_api_request(:get, "api/v1/api_key", ) do |request|
      request.basic_auth email, password
      request.add_field "OTP", options[:otp]
    end
  end

  with_response response do |resp|
    say "Signed in."
    set_api_key host, resp.body
  end
end

#verify_api_key(key)

Retrieves the pre-configured API key key or terminates interaction with an error.

[ GitHub ]

  
# File 'lib/rubygems/gemcutter_utilities.rb', line 146

def verify_api_key(key)
  if Gem.configuration.api_keys.key? key
    Gem.configuration.api_keys[key]
  else
    alert_error "No such API key. Please add it to your configuration (done automatically on initial `gem push`)."
    terminate_interaction 1 # TODO: question this
  end
end

#with_response(response, error_prefix = nil)

If response is an HTTP Success (2XX) response, yields the response if a block was given or shows the response body to the user.

If the response was not successful, shows an error to the user including the error_prefix and the response body.

[ GitHub ]

  
# File 'lib/rubygems/gemcutter_utilities.rb', line 162

def with_response(response, error_prefix = nil)
  case response
  when Net::HTTPSuccess then
    if block_given?
      yield response
    else
      say clean_text(response.body)
    end
  else
    message = response.body
    message = "#{error_prefix}: #{message}" if error_prefix

    say clean_text(message)
    terminate_interaction 1 # TODO: question this
  end
end