# class Gem::Uri

The `Uri` handles rubygems source URIs.

### Attributes

parsed_uri[R]

Add a protected reader for the cloned instance to access the original object’s parsed uri

### Public Class Methods

new(source_uri) click to toggle source

    # File lib/rubygems/uri.rb, line 8
    def initialize(source_uri)
      @parsed_uri = parse(source_uri)
    end

### Public Instance Methods

method_missing(method_name, *args, &blk) click to toggle source
Calls superclass method `BasicObject#method_missing`

    # File lib/rubygems/uri.rb, line 34
    def method_missing(method_name, *args, &blk)
      if @parsed_uri.respond_to?(method_name)
        @parsed_uri.send(method_name, *args, &blk)
      else
        super
      end
    end

redact_credentials_from(text) click to toggle source

    # File lib/rubygems/uri.rb, line 28
    def redact_credentials_from(text)
      return text unless valid_uri? && password?

      text.sub(password, 'REDACTED')
    end

redacted() click to toggle source

    # File lib/rubygems/uri.rb, line 12
    def redacted
      return self unless valid_uri?

      if token? || oauth_basic?
        with_redacted_user
      elsif password?
        with_redacted_password
      else
        self
      end
    end

respond_to_missing?(method_name, include_private = false) click to toggle source
Calls superclass method `Object#respond_to_missing?`

    # File lib/rubygems/uri.rb, line 42
    def respond_to_missing?(method_name, include_private = false)
      @parsed_uri.respond_to?(method_name, include_private) || super
    end

to_s() click to toggle source

    # File lib/rubygems/uri.rb, line 24
    def to_s
      @parsed_uri.to_s
    end

### Private Instance Methods

initialize_copy(original) click to toggle source

    # File lib/rubygems/uri.rb, line 108
    def initialize_copy(original)
      @parsed_uri = original.parsed_uri.clone
    end

oauth_basic?() click to toggle source

    # File lib/rubygems/uri.rb, line 100
    def oauth_basic?
      password == 'x-oauth-basic'
    end

parse(uri) click to toggle source

Parses the uri, returning the original uri if it’s invalid

    # File lib/rubygems/uri.rb, line 76
    def parse(uri)
      return uri unless uri.is_a?(String)

      parse!(uri)
    rescue URI::InvalidURIError
      uri
    end

parse!(uri) click to toggle source

Parses the uri, raising if it’s invalid

    # File lib/rubygems/uri.rb, line 56
    def parse!(uri)
      require "uri"

      raise URI::InvalidURIError unless uri

      # Always escape URI's to deal with potential spaces and such
      # It should also be considered that source_uri may already be
      # a valid URI with escaped characters. e.g. "{DESede}" is encoded
      # as "%7BDESede%7D". If this is escaped again the percentage
      # symbols will be escaped.
      begin
        URI.parse(uri)
      rescue URI::InvalidURIError
        URI.parse(URI::DEFAULT_PARSER.escape(uri))
      end
    end

password?() click to toggle source

    # File lib/rubygems/uri.rb, line 96
    def password?
      !!password
    end

token?() click to toggle source

    # File lib/rubygems/uri.rb, line 104
    def token?
      !user.nil? && password.nil?
    end

valid_uri?() click to toggle source

    # File lib/rubygems/uri.rb, line 92
    def valid_uri?
      !@parsed_uri.is_a?(String)
    end

with_redacted_password() click to toggle source

    # File lib/rubygems/uri.rb, line 88
    def with_redacted_password
      clone.tap {|uri| uri.password = 'REDACTED' }
    end

with_redacted_user() click to toggle source

    # File lib/rubygems/uri.rb, line 84
    def with_redacted_user
      clone.tap {|uri| uri.user = 'REDACTED' }
    end