Contents

# frozen_string_literal: true

module Jekyll
  module Utils
    module Internet
      # Public: Determine whether the present device has a connection to
      # the Internet. This allows plugin writers which require the outside
      # world to have a neat fallback mechanism for offline building.
      #
      # Example:
      #   if Internet.connected?
      #     Typhoeus.get("https://pages.github.com/versions.json")
      #   else
      #     Jekyll.logger.warn "Warning:", "Version check has been disabled."
      #     Jekyll.logger.warn "", "Connect to the Internet to enable it."
      #     nil
      #   end
      #
      # Returns true if a DNS call can successfully be made, or false if not.

      module_function

      def connected?
        !dns("example.com").nil?
      end

      def dns(domain)
        require "resolv"
        Resolv::DNS.open do |resolver|
          resolver.getaddress(domain)
        end
      rescue Resolv::ResolvError, Resolv::ResolvTimeout
        nil
      end
    end
  end
end

Version data entries

15 entries across 15 versions & 1 rubygems

Version	Path
jekyll-4.4.1	lib/jekyll/utils/internet.rb
jekyll-4.4.0	lib/jekyll/utils/internet.rb
jekyll-4.3.4	lib/jekyll/utils/internet.rb
jekyll-4.3.3	lib/jekyll/utils/internet.rb
jekyll-4.3.2	lib/jekyll/utils/internet.rb
jekyll-4.3.1	lib/jekyll/utils/internet.rb
jekyll-4.3.0	lib/jekyll/utils/internet.rb
jekyll-4.2.2	lib/jekyll/utils/internet.rb
jekyll-4.2.0	lib/jekyll/utils/internet.rb
jekyll-4.1.1	lib/jekyll/utils/internet.rb
jekyll-4.1.0	lib/jekyll/utils/internet.rb
jekyll-4.0.1	lib/jekyll/utils/internet.rb
jekyll-4.0.0	lib/jekyll/utils/internet.rb
jekyll-4.0.0.pre.beta1	lib/jekyll/utils/internet.rb
jekyll-4.0.0.pre.alpha1	lib/jekyll/utils/internet.rb