Whois

Checks whether the object represented by qstring is available.

Warning: this method is only available if a Whois parser exists for the top level domain of qstring. If no parser exists for qstring, you'll receive a warning message and the method will return nil. This is a technical limitation. Browse the lib/whois/record/parsers folder to view all available parsers.

@param [String] qstring The string to be sent as query parameter.

It is intended to be a domain name, otherwise this method
may return unexpected responses.

@return [Boolean]

@example

Whois.available?("google.com")
# => false

@example

Whois.available?("google-is-not-available-try-again-later.com")
# => true

# File lib/whois.rb, line 69
def available?(qstring)
  result = query(qstring).available?
  if result.nil?
    warn  "This method is not supported for this kind of object.\n" +
          "Use Whois.query('#{qstring}') instead."
  end
  result
end

Appends Please report issue to to the message and raises a new error with the final message.

@param [Exception] error @param [String] message @return [void]

@api internal @private

# File lib/whois.rb, line 131
def bug!(error, message)
  raise error, message.dup        <<
    " Please report the issue at" <<
    " http://github.com/weppos/whois/issues"
end

Echoes a deprecation warning message.

@param [String] message The message to display. @return [void]

@api internal @private

# File lib/whois.rb, line 117
def deprecate(message = nil)
  message ||= "You are using deprecated behavior which will be removed from the next major or minor release."
  warn("DEPRECATION WARNING: #{message}")
end

Queries the WHOIS server for qstring and returns the response from the server.

@param [String] qstring The string to be sent as query parameter. @return [Whois::Record] The record containing the response from the WHOIS server.

@example

Whois.query("google.com")
# => #<Whois::Record>

# Equivalent to
Whois::Client.new.query("google.com")

# File lib/whois.rb, line 40
def query(qstring)
  Client.new.query(qstring)
end

Checks whether the object represented by qstring is registered.

Warning: this method is only available if a Whois parser exists for the top level domain of qstring. If no parser exists for qstring, you'll receive a warning message and the method will return nil. This is a technical limitation. Browse the lib/whois/record/parsers folder to view all available parsers.

@param [String] qstring The string to be sent as query parameter.

It is intended to be a domain name, otherwise this method
may return unexpected responses.

@return [Boolean]

@example

Whois.registered?("google.com")
# => true

@example

Whois.registered?("google-is-not-available-try-again-later.com")
# => false

# File lib/whois.rb, line 100
def registered?(qstring)
  result = query(qstring).registered?
  if result.nil?
    warn  "This method is not supported for this kind of object.\n" +
          "Use Whois.query('#{qstring}') instead."
  end
  result
end