module Ipify

Constants

ConnectionError
ServiceError
VERSION

Public Class Methods

ip() click to toggle source

Requests this machine's IP address from the ipify.org service. Will retry up to 3 times until ultimately returning nil.

@return [String] external ip address, or nil if unsuccessful

# File lib/ipify.rb, line 14
def self.ip
  ip! rescue nil
end

ip!() click to toggle source

Requests this machine's IP address from the ipify.org service. Will retry up to 3 times until ultimately raising the last exception encountered.

@return [String] external ip address @raise [Ipify::ConnectionError] if unable to reach the ipify service @raise [Ipify::ServiceError] if the ipify service returns status other than 200(OK)

# File lib/ipify.rb, line 24
def self.ip!
  http = build_http
  response = Retriable.retriable tries: 3 do
    http.get('/')
  end
  raise ServiceError, "ipify.org returned status #{response.code}" if '200' != response.code
  response.body
rescue Net::OpenTimeout
  raise ConnectionError, "ipify.org timed out"
end

Private Class Methods

build_http() click to toggle source

@return [Net::HTTP] http client

# File lib/ipify.rb, line 38
def self.build_http
  uri = URI('https://api.ipify.org')
  http = Net::HTTP.new(uri.host, uri.port)
  http.use_ssl = true
  http.open_timeout = 1
  http.read_timeout = 1
  http
end