ipify 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 21fd9dfcc11cfb8e5beb37d22ccc1ecaf664884e
-  data.tar.gz: 81e01fca75bd48172c671786a386183f84341742
+  metadata.gz: 46049822ec6b7e96bfa5cba35ea23deb488121b0
+  data.tar.gz: f0bfbe5590f2b0db342d2d1de3d8d78d1db14c35
 SHA512:
-  metadata.gz: 063da2714a5e4de12a6afc6da1222b0fd57665f4f13ecdcaf317f6ceb9de6275fe754b69a2e3c740adaa4f60f183dc125d1aca364fc928f7c11115296e05d28b
-  data.tar.gz: 3480d9ec93f888f2d6c62ae3ad8c3d17b14dca5b4dc0fbb8c2bacb4dd9e0f0b2571be1707ede263e49e46f817fe2c853286e2314b0a3284ccef4d03205e7708d
+  metadata.gz: 243b954291d381cccd564d5145e2990fa497171ef43c8acfe8c013055eb60afb04298791cbfc7ee635dab985c1dba7968b383bc3e3127549a0387ecbb22e38b1
+  data.tar.gz: 2292821c3a48c65b9b7904ab499b8d50fdc4c4eca89fdeae515661f6ff8f2257cd82d372385e02a8169576284dbe678ef9b55bccb6408e2a54eff9aea9b89a43

data/lib/ipify.rb

@@ -4,7 +4,19 @@ require 'retriable'
 
 module Ipify
 
+  # 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
   def self.ip
+    ip! rescue nil
+  end
+
+  # 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
+  def self.ip!
     http = build_http
     Retriable.retriable tries: 3 do
       http.get('/').body
@@ -13,6 +25,7 @@ module Ipify
 
   private
 
+  # @return [Net::HTTP] http client
   def self.build_http
     uri = URI('https://api.ipify.org')
     http = Net::HTTP.new(uri.host, uri.port)

data/lib/ipify/version.rb

@@ -1,3 +1,3 @@
 module Ipify
-  VERSION = "0.1.0"
+  VERSION = '0.2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ipify
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Nick Veys