online 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b676e3f37ff58fe5ad57c2bebe0afafeb9c522e18113ff6098f456f18b4d4df0
-  data.tar.gz: c388c79309f619b4f9c5ffc58a680859281396d029ebf6fb3dbb2feddcf3571c
+  metadata.gz: 9ef9ba22638e58d94758ea94060301897d60251ff964c63b7a8cc45f238d4a3e
+  data.tar.gz: 412b3685da1492928b2de676d5b19cf706cc5a6b4ca5d9cb7c5d8627f27b805e
 SHA512:
-  metadata.gz: 5576f41fd242027a3401a428c491b9b507550460dab23505ae24b17ea833f5d352336a8485b6099b01de031d9b9d5b3ecdcc52ba4d32fb929aadddfcef38fd49
-  data.tar.gz: '0068189a76b8a4da93194471c7d0798fb102c608f09c8e5cbccb9ada926e44b6dbed4f95939da4276d9c52ba364571fbb40b00a6913b270b0e793ac7bcb00e2b'
+  metadata.gz: e75c5f2eda683c5fb86b1ec4e43cacc9df7bb028ac1c006f3d0ce206f9cf99791b8e14dd22eba8ce3e9f4ee474337b1cc5a578754aa730fdbcc00ebe00687413
+  data.tar.gz: f2dbd844247fd86d688d7b289525577b0c9993e40201a5cef318344855d4052f8a763f5f34e5c04f8942ab60c62fae122ddd5e7d93e8f491d38fbbe9136d8a57

data/Gemfile

@@ -6,7 +6,7 @@
 source 'https://rubygems.org'
 gemspec
 
-gem 'minitest', '~>5.25', require: false
+gem 'minitest', '~>6.0', require: false
 gem 'minitest-reporters', '~>1.7', require: false
 gem 'rake', '~>13.2', require: false
 gem 'rubocop', '~>1.73', require: false

data/Gemfile.lock

@@ -2,43 +2,46 @@ PATH
   remote: .
   specs:
     online (0.0.0)
+      openssl (>= 3)
       timeout (~> 0.4)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
     ansi (1.5.0)
     ast (2.4.3)
-    bigdecimal (3.2.2)
+    bigdecimal (4.0.1)
     builder (3.3.0)
-    crack (1.0.0)
+    crack (1.0.1)
       bigdecimal
       rexml
     docile (1.4.1)
-    hashdiff (1.2.0)
-    json (2.13.2)
+    hashdiff (1.2.1)
+    json (2.18.0)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
-    minitest (5.25.5)
+    minitest (6.0.1)
+      prism (~> 1.5)
     minitest-reporters (1.7.1)
       ansi
       builder
       minitest (>= 5.0)
       ruby-progressbar
+    openssl (4.0.0)
     parallel (1.27.0)
-    parser (3.3.9.0)
+    parser (3.3.10.0)
       ast (~> 2.4.1)
       racc
-    prism (1.4.0)
-    public_suffix (6.0.2)
+    prism (1.7.0)
+    public_suffix (7.0.0)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.3.0)
-    regexp_parser (2.11.2)
-    rexml (3.4.2)
-    rubocop (1.80.2)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    rexml (3.4.4)
+    rubocop (1.82.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -46,20 +49,20 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.46.0, < 2.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.46.0)
+    rubocop-ast (1.49.0)
       parser (>= 3.3.7.2)
-      prism (~> 1.4)
+      prism (~> 1.7)
     rubocop-minitest (0.38.2)
       lint_roller (~> 1.1)
       rubocop (>= 1.75.0, < 2.0)
       rubocop-ast (>= 1.38.0, < 2.0)
-    rubocop-performance (1.26.0)
+    rubocop-performance (1.26.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.75.0, < 2.0)
-      rubocop-ast (>= 1.44.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
@@ -73,15 +76,15 @@ GEM
       simplecov (~> 0.19)
     simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    timeout (0.4.3)
-    unicode-display_width (3.1.5)
-      unicode-emoji (~> 4.0, >= 4.0.4)
-    unicode-emoji (4.0.4)
-    webmock (3.25.1)
+    timeout (0.6.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    webmock (3.26.1)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    yard (0.9.37)
+    yard (0.9.38)
 
 PLATFORMS
   aarch64-linux
@@ -94,7 +97,7 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
-  minitest (~> 5.25)
+  minitest (~> 6.0)
   minitest-reporters (~> 1.7)
   online!
   rake (~> 13.2)

data/README.md

@@ -44,6 +44,15 @@ if online?(ttl: 3)
 end
 ```
 
+You can specify HTTP timeout (in seconds) to prevent hanging on slow connections,
+for example:
+
+```ruby
+if online?(timeout: 2)
+  # We are online, if the timeout has not expired
+end
+```
+
 That's it.
 
 ## How to contribute

data/Rakefile

@@ -33,6 +33,7 @@ require 'yard'
 desc 'Build Yard documentation'
 YARD::Rake::YardocTask.new do |t|
   t.files = ['lib/**/*.rb']
+  t.options = ['--fail-on-warning']
 end
 
 require 'rubocop/rake_task'

data/lib/online.rb

@@ -3,6 +3,7 @@
 # SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
+require 'openssl'
 require 'net/http'
 require 'socket'
 require 'timeout'
@@ -30,8 +31,9 @@ module Kernel
   # for checking internet availability before performing network-dependent operations
   # or for implementing offline-mode functionality in applications.
   #
-  # @param uri [String] the URI to check connectivity against (default: 'http://www.google.com')
+  # @param uri [String] the URI to check connectivity against (default: 'https://www.google.com/generate_204')
   # @param ttl [Integer] time-to-live for cached results in seconds (default: 300 seconds = 5 minutes)
+  # @param timeout [Integer] open, read and write HTTP timeout (default: 10 seconds)
   # @return [Boolean] true if the URI is reachable and returns HTTP success, false otherwise
   #
   # @example Basic usage - check internet connectivity
@@ -85,19 +87,29 @@ module Kernel
   # @note Returns false for any network-related errors including timeouts, DNS failures,
   #   and unreachable hosts
   # @note Results are cached with a default TTL of 5 minutes to reduce network requests
-  def online?(uri: 'http://www.google.com', ttl: 300)
+  def online?(uri: 'https://www.google.com/generate_204', ttl: 300, timeout: 10)
     raise 'The URI is nil' if uri.nil?
     raise 'The TTL is nil' if ttl.nil?
     key = uri.to_s
     OnlineOrOffline.mutex.synchronize do
       entry = OnlineOrOffline.cache[key]
       return entry[:status] if entry && (Time.now - entry[:time]) < ttl
+      uri = URI(uri) unless uri.is_a?(URI)
       status =
-        Timeout.timeout(10) do
-          Net::HTTP.get_response(URI(uri)).is_a?(Net::HTTPSuccess)
+        begin
+          Net::HTTP.start(
+            uri.hostname,
+            uri.port,
+            use_ssl: uri.scheme == 'https',
+            open_timeout: timeout,
+            read_timeout: timeout,
+            write_timeout: timeout
+          ) do |http|
+            http.request_get(uri, {}).is_a?(Net::HTTPSuccess)
+          end
         rescue \
-          Timeout::Error, Timeout::ExitException, Socket::ResolutionError,
-          Errno::EHOSTUNREACH, Errno::EINVAL, Errno::EADDRNOTAVAIL, Errno::EBADF
+          Socket::ResolutionError, Net::OpenTimeout, Net::ReadTimeout, Net::WriteTimeout,
+          Errno::EHOSTUNREACH, Errno::EINVAL, Errno::EADDRNOTAVAIL, Errno::EBADF, OpenSSL::SSL::SSLError
           false
         end
       OnlineOrOffline.cache[key] = { status: status, time: Time.now }

data/online.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
   s.required_ruby_version = '>=3.2'
   s.name = 'online'
-  s.version = '0.1.0'
+  s.version = '0.3.0'
   s.license = 'MIT'
   s.summary = 'Checks whether we are currently online or offline'
   s.description =
@@ -22,6 +22,7 @@ Gem::Specification.new do |s|
   s.executables = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
   s.rdoc_options = ['--charset=UTF-8']
   s.extra_rdoc_files = ['README.md', 'LICENSE.txt']
+  s.add_dependency 'openssl', '>=3'
   s.add_dependency 'timeout', '~>0.4'
   s.metadata['rubygems_mfa_required'] = 'true'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: online
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Yegor Bugayenko
@@ -9,6 +9,20 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: openssl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: timeout
   requirement: !ruby/object:Gem::Requirement