host-os 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8259f7f3965b419b1c41233b4e6a1a2726b78662f5506e3d397a0cab916ea5bc
-  data.tar.gz: a0dabfba2f2ac721b422d62c0eb297ca42e0942215399974f43061dded676ba3
+  metadata.gz: 9a1718752411b34a816e31b58be6f1a3cd83aec89b851e74f6997998e173dcad
+  data.tar.gz: fc322f198a39c3b5b7792012b2206960e0889302a97716ee9bed733b485b642f
 SHA512:
-  metadata.gz: f554e8e5562e7c1bc5d58bd45422529e3838bb6e21cfc132b3f3010c639ed78c9928f2433868091e540ac50553b578245afc77e52fa63463520f3dd81f33cb2b
-  data.tar.gz: 2210f64c92376f4f498e4d3d3041bb36a1f5a2c2eb592c6686540f21c037d979e0a72251d973ad94e0c6995e54bb8d2a4cce9bbfa66dd0855e0aa567cc33d816
+  metadata.gz: 3652cc6e8ddbc5c5489bec318e48f7ce5c73f1c84aa4940887ba080767a8173835e24b2739db27fff6a16f4aaa9f980d9d59edfa66c1ade9e4a296357043bbe2
+  data.tar.gz: 3fd4535322bb9d0de53af3d2ae0695e4199e31976fb472f0d631c1c57750d5c1eac6174abcd16b8e52b4ffa01b3e5ef642dc027c71e4f913fe0412885aeb93cd

data/lib/host-os/interpreter.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+require_relative('../host-os') unless defined?(HostOS.id)
+
+module HostOS
+  #
+  # This module allows to identify the used Ruby interpreter.
+  #
+  # Besides here documented boolean attributes you can also check for any other
+  # boolean attribute or interpreter name:
+  #
+  # @example Query for the Opal interpreter
+  #   HostOS.interpreter.opal?
+  # @example Query for TruffleRuby
+  #   HostOS.interpreter.truffleruby?
+  #
+  module Interpreter
+    extend Helper
+
+    class << self
+      # @!attribute [r] mri?
+      # @return [true, false] whether the interpreter is the Yukihiro
+      #   Matsumoto's C-based (default) Ruby Interpreter
+      def mri?
+        id == :mri
+      end
+      alias cruby? mri?
+      alias default? mri?
+
+      # @!attribute [r] cardinal?
+      # @return [true, false] whether the interpreter is the Parrot based
+      #   Cardinal interpreter
+      def cardinal?
+        id == :cardinal
+      end
+      alias parrot? cardinal?
+
+      # @!attribute [r] jruby?
+      # @return [true, false] whether the interpreter is the Java based JRuby
+      #  Interpreter
+      def jruby?
+        id == :jruby
+      end
+      alias java? jruby?
+
+      # @!attribute [r] rbx?
+      # @return [true, false] whether the interpreter is the Rubinius
+      #   Interpreter
+      def rbx?
+        id == :rbx
+      end
+      alias rubinius? rbx?
+
+      # @!attribute [r] ree?
+      # @return [true, false] whether the interpreter is the Ruby Enterprise
+      #   Edition
+      def ree?
+        id == :ree
+      end
+      alias enterprise? ree?
+
+      # @!attribute [r] jit_enabled?
+      # @return [true, false] whether the interpreter currently uses a JIT
+      #   Compiler
+      def jit_enabled?
+        jit_type != :none
+      end
+
+      # @!attribute [r] jit_type
+      # @return [:mjit, :rjit, :yjit, :java, :none] type of currently used JIT
+      #   Compiler
+      def jit_type
+        return :mjit if defined?(RubyVM::MJIT) && RubyVM::MJIT.enabled?
+        return :yjit if defined?(RubyVM::YJIT) && RubyVM::YJIT.enabled?
+        return :rjit if defined?(RubyVM::RJIT) && RubyVM::RJIT.enabled?
+        jruby? ? :java : :none
+      end
+
+      # @!visibility private
+      def to_s
+        @to_s ||=
+          {
+            cardinal: 'Cardinal',
+            jruby: 'JRuby',
+            mri: 'CRuby',
+            rby: 'Rubinius',
+            ree: 'Enterprise Ruby',
+            truffleruby: 'TruffleRuby'
+          }.compare_by_identity[
+            id
+          ] || id.to_s.upcase
+      end
+
+      # Path name of current Ruby executable.
+      # @!attribute [r] exe
+      # @return [String] complete path name to current Ruby executable
+      # @return [nil] when executable can not be detected
+      def exe
+        defined?(@exe) ? @exe : @exe = find_exe
+      end
+
+      # @!attribute [r] id
+      # @return [Symbol] interpreter identifier
+
+      # @!method is?(what)
+      # @param what [Symbol, String] the identifier to check
+      # @return [true, false] whether the interpreter is the given identifier
+
+      # @comment YARD requires this line
+
+      private
+
+      def identify
+        if defined?(RUBY_PLATFORM) && (RUBY_PLATFORM == 'parrot')
+          return :cardinal
+        end
+        return :mri unless defined?(RUBY_ENGINE)
+        return RUBY_ENGINE.to_sym if RUBY_ENGINE != 'ruby'
+        RUBY_DESCRIPTION.downcase.include?('enterprise') ? :ree : :mri
+      end
+
+      def find_exe
+        require 'rbconfig' unless defined?(RbConfig)
+        RbConfig.ruby
+      rescue LoadError
+        ENV['RUBY']
+      rescue NoMethodError
+        File.join(
+          RbConfig::CONFIG['bindir'],
+          RbConfig::CONFIG['ruby_install_name'] + RbConfig::CONFIG['EXEEXT']
+        )
+      end
+    end
+
+    @id = identify
+  end
+end

data/lib/host-os/support.rb

@@ -10,181 +10,145 @@ module HostOS
   #
   # @note You need to require `host-os/support` explicitly.
   module Support
-    # @attribute [r] dev_null
-    # @return [String] name of or path to the null device
-    # @note This attribute is only available on Windows, OS2 and Unix systems.
-
-    # @attribute [r] open_command
-    # @return [String] name of the open command
-    # @note This attribute is only available on Windows, MacOS and Linux systems.
-
-    # @attribute [r] rss_bytes
-    # @return [Integer] number of bytes used by the current process
-    # @note This attribute is only available on Windows and Unix or when using
-    #   JRuby
-
-    # @attribute [r] suggested_thread_count
-    # @return [Integer] suggested number of threads to use
-
-    # @attribute [r] temp_dir
-    # @return [String] name of the temporary directory
-
-    # @!method app_config_path(app_name)
-    # @param app_name [String] name of the application
-    # @return [String] absolute name of the directory
-    # Determines the name of the directory where application specific data
-    # should be stored.
-    # @note This method is only available on Windows and Posix-compatible
-    #   systems.
-
-    # @comment YARD requires this emoty line :/
-    module Windows
+    if defined?(File::NULL)
+      # @attribute [r] dev_null
+      # @return [String] name of or path to the null device
+      # @note This attribute is only available on
+      #   Windows, OS2 and Unix systems for older Ruby versions.
+      def dev_null
+        File::NULL
+      end
+    elsif HostOS.windows?
       def dev_null
         'NUL'
       end
+    elsif HostOS.os2?
+      def dev_null
+        'nul'
+      end
+    elsif HostOS.unix?
+      def dev_null
+        '/dev/null'
+      end
+    end
 
+    if HostOS.windows?
+      # @attribute [r] open_command
+      # @return [String] name of the open command
+      # @note This attribute is only available on Windows, MacOS and Linux systems.
       def open_command
         'start'
       end
+    elsif HostOS.macosx?
+      def open_command
+        'open'
+      end
+    elsif HostOS.linux?
+      def open_command
+        'xdg-open'
+      end
+    end
 
+    if HostOS.windows?
+      # @attribute [r] rss_bytes
+      # @return [Integer] number of bytes used by the current process
+      # @note This attribute is only available on Windows and Unix or when using
+      #   JRuby
       def rss_bytes
         `tasklist /FI "PID eq #{Process.pid}" /FO CSV`.split(',"')[-1].tr(
           ',.',
           '__'
         ).to_i * 1024
       end
-
-      private
-
-      def _app_config_path
-        ENV['LOCALAPPDATA'] ||
-          "#{ENV['USERPROFILE']}/Local Settings/Application Data"
-      end
-    end
-
-    module Unix
-      def dev_null
-        '/dev/null'
+    elsif Interpreter.jruby?
+      def rss_bytes
+        require 'java' unless defined?(java)
+        bean = java.lang.management.ManagementFactory.getMemoryMXBean
+        bean.heap_memory_usage.used + bean.non_heap_memory_usage.used
       end
-
+    elsif HostOS.unix?
       def rss_bytes
         `ps -o rss= -p #{Process.pid}`.to_i * 1024
       end
-
-      private
-
-      def _app_config_path
-        (ENV['XDG_CONFIG_HOME'] || '~/.config')
-      end
-    end
-
-    module OS2
-      def dev_null
-        'nul'
-      end
     end
 
-    module MacOS
-      def open_command
-        'open'
+    if HostOS.windows?
+      # @param app_name [String] name of the application
+      # @return [String] absolute name of the directory
+      # Determines the name of the directory where application specific data
+      # should be stored.
+      # @note This method is only available on Windows and Posix-compatible
+      #   systems.
+      def app_config_path(app_name)
+        File.expand_path(
+          app_name,
+          ENV['LOCALAPPDATA'] ||
+            "#{ENV['USERPROFILE']}/Local Settings/Application Data"
+        )
       end
-
-      private
-
-      def _app_config_path
-        '~/Library/Application Support'
+    elsif HostOS.macosx?
+      def app_config_path(app_name)
+        File.expand_path(app_name, '~/Library/Application Support')
       end
-    end
-
-    module Linux
-      def open_command
-        'xdg-open'
+    elsif HostOS.unix?
+      def app_config_path(app_name)
+        File.expand_path(app_name, ENV['XDG_CONFIG_HOME'] || '~/.config')
       end
     end
 
-    module AppConfigPath
-      def app_config_path(app_name)
-        File.expand_path(app_name, _app_config_path)
-      end
+    # @attribute [r] suggested_thread_count
+    # @return [Integer] suggested number of threads to use
+    def suggested_thread_count
+      @suggested_thread_count ||= find_suggested_thread_count
     end
 
-    module JRuby
-      def rss_bytes
-        require 'java' unless defined?(java)
-        bean = java.lang.management.ManagementFactory.getMemoryMXBean
-        bean.heap_memory_usage.used + bean.non_heap_memory_usage.used
-      end
+    # @attribute [r] temp_dir
+    # @return [String] name of the temporary directory
+    def temp_dir
+      @temp_dir ||= find_temp_dir
     end
 
-    module Tools
-      def suggested_thread_count
-        @suggested_thread_count ||= find_suggested_thread_count
-      end
+    private
 
-      def temp_dir
-        @temp_dir ||= find_temp_dir
+    def find_suggested_thread_count
+      count = ENV['TC'].to_i
+      return count if count > 0
+      begin
+        require('etc') unless defined?(Etc)
+        Etc.nprocessors
+      rescue LoadError
+        4
       end
+    end
 
-      private
-
-      def find_suggested_thread_count
-        count = ENV['TC'].to_i
-        return count if count > 0
+    def find_temp_dir
+      return Dir.tmpdir if defined?(Dir.tmpdir)
+      ret = as_dir('TMPDIR') || as_dir('TMP') || as_dir('TEMP')
+      return ret if ret
+      ret =
         begin
           require('etc') unless defined?(Etc)
-          Etc.nprocessors
+          Etc.systmpdir
         rescue LoadError
-          4
+          "#{ENV['LOCALAPPDATA']}/Temp"
         end
-      end
-
-      def find_temp_dir
-        return Dir.tmpdir if defined?(Dir.tmpdir)
-        ret = as_dir('TMPDIR') || as_dir('TMP') || as_dir('TEMP')
-        return ret if ret
-        ret =
-          begin
-            require('etc') unless defined?(Etc)
-            Etc.systmpdir
-          rescue LoadError
-            "#{ENV['LOCALAPPDATA']}/Temp"
-          end
-        as_dir('system temp', ret) || as_dir('/tmp', '/tmp') || as_dir('.', '.')
-      end
+      as_dir('system temp', ret) || as_dir('/tmp', '/tmp') || as_dir('.', '.')
+    end
 
-      def as_dir(name, dirname = nil)
-        dirname ||= ENV[name]
-        return if dirname.nil? || dirname.empty?
-        dirname = File.expand_path(dirname)
-        stat = File.stat(dirname)
-        stat.directory? or warn("#{name} is not a valid directory - #{dirname}")
-        stat.writable? or warn("#{name} is not writable - #{dirname}")
-        (stat.world_writable? && !stat.sticky?) and
-          warn("#{name} is world-writable - #{dirname}")
-        dirname
-      rescue SystemCallError
-        nil
-      end
+    def as_dir(name, dirname = nil)
+      dirname ||= ENV[name]
+      return if dirname.nil? || dirname.empty?
+      dirname = File.expand_path(dirname)
+      stat = File.stat(dirname)
+      stat.directory? or warn("#{name} is not a valid directory - #{dirname}")
+      stat.writable? or warn("#{name} is not writable - #{dirname}")
+      (stat.world_writable? && !stat.sticky?) and
+        warn("#{name} is world-writable - #{dirname}")
+      dirname
+    rescue SystemCallError
+      nil
     end
   end
 
-  extend Support::Windows if windows?
-  extend Support::Unix if unix?
-  extend Support::MacOS if macosx?
-  extend Support::OS2 if os2?
-  extend Support::Linux if linux?
-  extend Support::AppConfigPath if windows? || unix?
-  extend Support::JRuby if Interpreter.jruby?
-  extend Support::Tools
-
-  module Support
-    private_constant :Windows
-    private_constant :Unix
-    private_constant :OS2
-    private_constant :MacOS
-    private_constant :Linux
-    private_constant :AppConfigPath
-    private_constant :JRuby
-    private_constant :Tools
-  end
+  extend Support
 end

data/lib/host-os/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module HostOS
-  # @return [String] the version number of the gem
-  VERSION = '0.2.0'
+  # Version number of the gem.
+  VERSION = '0.2.2'
 end

data/lib/host-os.rb

@@ -6,276 +6,65 @@
 # It helps you write environment-specific code in a clean way.
 #
 module HostOS
-  module Helper
-    def is?(what)
-      id == what ||
-        (id == (defined?(what.to_sym) ? what.to_sym : what.to_s.to_sym))
-    end
-
-    private
-
-    def respond_to_missing?(name, _include_all = false)
-      (name[-1] == '?') || super
-    end
-
-    def method_missing(name, *args)
-      return super if name[-1] != '?'
-      return is?(name[0..-2]) if args.empty?
-      raise(
-        ArgumentError,
-        "wrong number of arguments (given #{args.size}, expected 0)"
-      )
-    end
-  end
-  private_constant :Helper
-
-  #
-  # This module allows to identify the current environment by checking the `ENV`
-  # for the following variables in order:
-  #
-  # * RAILS_ENV
-  # * RACK_ENV
-  # * ENVIRONMENT
-  # * ENV
-  #
-  # You can check for any boolean attribute:
-  #
-  # @example Query if the environment is configured as "staging"
-  #   HostOS.env.staging?
-  # @example Test if the environment is configured as "production"
-  #   HostOS.env.is? :production
-  #
-  # @note When no environment is configured 'prod
-  #
-  module Env
-    extend Helper
-
-    class << self
-      # @attribute [r] production?
-      # @return [true, false] whether the environment is configured as "production"
-      # @note This will return true if the environment is not configured.
-
-      # @attribute [r] test?
-      # @return [true, false] whether the environment is configured as "test"
-
-      # @attribute [r] development?
-      # @return [true, false] whether the environment is configured as
-      #   "development"
-
-      # @attribute [r] id
-      # @return [Symbol] environment identifier
-      def id
-        ID
-      end
-
-      # @!method is?(what)
-      # @param what [Symbol, String] the identifier to check
-      # @return [true, false] whether the environment is the given identifier
-
-      # @comment YARD requires this line
-
-      private
-
-      def identify
-        found =
-          ENV['RAILS_ENV'] || ENV['RACK_ENV'] || ENV['ENVIRONMENT'] ||
-            ENV['ENV']
-        return :production if found.nil? || found.empty?
-        found.downcase.tr(' -', '__').to_sym
-      end
-    end
-
-    # @return [Symbol] environment identifier
-    ID = identify
-  end
-
-  #
-  # This module allows to identify the used Ruby interpreter.
-  #
-  # Besides here documented boolean attributes you can also check for any other
-  # boolean attribute or interpreter name:
-  #
-  # @example Query for the Opal interpreter
-  #   HostOS.interpreter.opal?
-  # @example Query for TruffleRuby
-  #   HostOS.interpreter.truffleruby?
-  #
-  module Interpreter
-    extend Helper
-
-    class << self
-      # @attribute [r] id
-      # @return [Symbol] interpreter identifier
-      def id
-        ID
-      end
-
-      # @attribute [r] mri?
-      # @return [true, false] whether the interpreter is the Yukihiro
-      #   Matsumoto's C-based (default) Ruby Interpreter
-      def mri?
-        ID == :mri
-      end
-      alias cruby? mri?
-      alias default? mri?
-
-      # @attribute [r] cardinal?
-      # @return [true, false] whether the interpreter is the Parrot based
-      #   Cardinal interpreter
-      def cardinal?
-        ID == :cardinal
-      end
-      alias parrot? cardinal?
-
-      # @attribute [r] jruby?
-      # @return [true, false] whether the interpreter is the Java based JRuby
-      #  Interpreter
-      def jruby?
-        ID == :jruby
-      end
-      alias java? jruby?
-
-      # @attribute [r] rbx?
-      # @return [true, false] whether the interpreter is the Rubinius
-      #   Interpreter
-      def rbx?
-        ID == :rbx
-      end
-      alias rubinius? rbx?
-
-      # @attribute [r] ree?
-      # @return [true, false] whether the interpreter is the Ruby Enterprise
-      #   Edition
-      def ree?
-        ID == :ree
-      end
-      alias enterprise? ree?
-
-      # @attribute [r] jit_enabled?
-      # @return [true, false] whether the interpreter currently uses a JIT
-      #   Compiler
-      def jit_enabled?
-        jit_type != :none
-      end
-
-      # @attribute [r] jit_type
-      # @return [:mjit, :rjit, :yjit, :java, :none] type of currently used JIT
-      #   Compiler
-      def jit_type
-        return :mjit if defined?(RubyVM::MJIT) && RubyVM::MJIT.enabled?
-        return :yjit if defined?(RubyVM::YJIT) && RubyVM::YJIT.enabled?
-        return :rjit if defined?(RubyVM::RJIT) && RubyVM::RJIT.enabled?
-        jruby? ? :java : :none
-      end
-
-      # @!visibility private
-      def to_s
-        NAMES[ID] || ID.to_s.upcase
-      end
-
-      # @!method is?(what)
-      # @param what [Symbol, String] the identifier to check
-      # @return [true, false] whether the interpreter is the given identifier
-
-      # @comment YARD requires this line
-
-      private
-
-      def identify
-        if defined?(RUBY_PLATFORM) && (RUBY_PLATFORM == 'parrot')
-          return :cardinal
-        end
-        return :mri unless defined?(RUBY_ENGINE)
-        return RUBY_ENGINE.to_sym if RUBY_ENGINE != 'ruby'
-        RUBY_DESCRIPTION.downcase.include?('enterprise') ? :ree : :mri
-      end
-    end
-
-    # @return [Symbol] interpreter identifier
-    ID = identify
-
-    NAMES = {
-      cardinal: 'Cardinal',
-      jruby: 'JRuby',
-      mri: 'CRuby',
-      rby: 'Rubinius',
-      ree: 'Enterprise Ruby',
-      truffleruby: 'TruffleRuby'
-    }.compare_by_identity.freeze
-
-    private_constant :NAMES
-  end
-
-  extend Helper
-
   class << self
-    # @attribute [r] id
-    # @return [Symbol] OS identifier
-    def id
-      ID
-    end
-
-    # @attribute [r] type
     # @return [:unix,  :windows, :vms, :os2, :unknown] OS type
-    def type
-      TYPE
-    end
+    attr_reader :type
 
-    # @attribute [r] interpreter
+    # @!attribute [r] interpreter
     # @return [Interpreter] interpreter information
     def interpreter
       Interpreter
     end
 
-    # @attribute [r] env
+    # @!attribute [r] env
     # @return [Env] environment information
     def env
       Env
     end
 
-    # @attribute [r] unix?
+    # @!attribute [r] unix?
     # @return [true, false] whether the host OS is a Unix OS
     def unix?
-      TYPE == :unix
+      @type == :unix
     end
 
-    # @attribute [r] windows?
+    # @!attribute [r] windows?
     # @return [true, false] whether the host OS is a Windows OS
     def windows?
-      TYPE == :windows
+      @type == :windows
     end
 
-    # @attribute [r] vms?
+    # @!attribute [r] vms?
     # @return [true, false] whether the host OS is VMS
     def vms?
-      TYPE == :vms
+      @type == :vms
     end
 
-    # @attribute [r] os2?
+    # @!attribute [r] os2?
     # @return [true, false] whether the host OS is OS/2
     def os2?
-      TYPE == :os2
+      @type == :os2
     end
 
-    # @attribute [r] macosx?
+    # @!attribute [r] macosx?
     # @return [true, false] whether the host OS is identified as MacOS
     def macosx?
-      ID == :macosx
+      @id == :macosx
     end
 
-    # @attribute [r] linux?
+    # @!attribute [r] linux?
     # @return [true, false] whether the host OS is identified as Linux derivate
     def linux?
-      ID == :linux
+      @id == :linux
     end
 
-    # @attribute [r] cygwin?
+    # @!attribute [r] cygwin?
     # @return [true, false] whether the host OS is Windows/Cygwin
     def cygwin?
-      ID == :cygwin
+      @id == :cygwin
     end
 
-    # @attribute [r] posix?
+    # @!attribute [r] posix?
     # @return [true, false] whether the host OS is Posix compatible
     # This attribute is `true` when Posix compatible commands like `fork` are
     # available.
@@ -286,14 +75,41 @@ module HostOS
     # @param what [Symbol, String] the identifier to check
     # @return [true, false] whether the host OS is the given identifier or type
     def is?(what)
-      return true if (ID == what) || (TYPE == what)
-      what = defined?(what.to_sym) ? what.to_sym : what.to_s.to_sym
-      (ID == what) || (TYPE == what)
+      return (@id == what) || (@type == what) if what.is_a?(Symbol)
+      if defined?(what.to_sym)
+        what = what.to_sym
+        return (@id == what) || (@type == what)
+      end
+      if defined?(what.to_s)
+        what = what.to_s.to_sym
+        return (@id == what) || (@type == what)
+      end
+      false
     end
 
+    # @!attribute [r] id
+    # @return [Symbol] OS identifier
+
     # @!visibility private
     def to_s
-      NAMES[ID] || ID.to_s.upcase
+      @to_s ||=
+        {
+          bccwin: 'BCCWin',
+          cygwin: 'Cygwin',
+          dragonfly: 'Dragonly',
+          freebsd: 'FreeBSD',
+          linux: 'Linux',
+          macosx: 'MacOSX',
+          mingw: 'MinGW',
+          mswin: 'MSWin',
+          netbsd: 'NetBSD',
+          openbsd: 'OpenBSD',
+          sunos: 'SunOS',
+          wince: 'WinCE',
+          windows: 'Windows'
+        }.compare_by_identity[
+          @id
+        ] || @id.to_s.upcase
     end
 
     private
@@ -331,20 +147,92 @@ module HostOS
     end
   end
 
-  ID, TYPE = identify
-  NAMES = {
-    bccwin: 'BCCWin',
-    cygwin: 'Cygwin',
-    dragonfly: 'Dragonly',
-    freebsd: 'FreeBSD',
-    linux: 'Linux',
-    macosx: 'MacOSX',
-    mingw: 'MinGW',
-    mswin: 'MSWin',
-    netbsd: 'NetBSD',
-    openbsd: 'OpenBSD',
-    sunos: 'SunOS',
-    wince: 'WinCE',
-    windows: 'Windows'
-  }.compare_by_identity.freeze
+  module Helper
+    attr_reader :id
+
+    def is?(what)
+      return id == what if what.is_a?(Symbol)
+      return id == what.to_sym if defined?(what.to_sym)
+      return id == what.to_s.to_sym if defined?(what.to_s)
+      false
+    end
+
+    private
+
+    def respond_to_missing?(name, _include_all = false)
+      (name[-1] == '?') || super
+    end
+
+    def method_missing(name, *args)
+      return super if name[-1] != '?'
+      return is?(name[0..-2]) if args.empty?
+      raise(
+        ArgumentError,
+        "wrong number of arguments (given #{args.size}, expected 0)"
+      )
+    end
+  end
+  private_constant :Helper
+
+  #
+  # This module allows to identify the current environment by checking the `ENV`
+  # for the following variables in order:
+  #
+  # * RAILS_ENV
+  # * RACK_ENV
+  # * ENVIRONMENT
+  # * ENV
+  #
+  # You can check for any boolean attribute:
+  #
+  # @example Query if the environment is configured as "staging"
+  #   HostOS.env.staging?
+  # @example Test if the environment is configured as "production"
+  #   HostOS.env.is? :production
+  #
+  # @note When no environment is configured `production` is assumed.
+  #
+  module Env
+    extend Helper
+
+    class << self
+      # @!attribute [r] production?
+      # @return [true, false] whether the environment is configured as "production"
+      # @note This will return true if the environment is not configured.
+
+      # @!attribute [r] test?
+      # @return [true, false] whether the environment is configured as "test"
+
+      # @!attribute [r] development?
+      # @return [true, false] whether the environment is configured as
+      #   "development"
+
+      # @!attribute [r] id
+      # @return [Symbol] environment identifier
+
+      # @!method is?(what)
+      # @param what [Symbol, String] the identifier to check
+      # @return [true, false] whether the environment is the given identifier
+
+      # @comment YARD requires this line
+
+      private
+
+      def identify
+        found =
+          ENV['RAILS_ENV'] || ENV['RACK_ENV'] || ENV['ENVIRONMENT'] ||
+            ENV['ENV']
+        return :production if found.nil? || found.empty?
+        found.downcase.gsub(/\W/, '_').to_sym
+      end
+    end
+
+    @id = identify
+  end
+
+  autoload :Interpreter, "#{__dir__}/host-os/interpreter.rb"
+
+  extend Helper
+
+  @id, @type = identify
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: host-os
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Mike Blumtritt
@@ -24,6 +24,7 @@ files:
 - README.md
 - examples/current.rb
 - lib/host-os.rb
+- lib/host-os/interpreter.rb
 - lib/host-os/support.rb
 - lib/host-os/version.rb
 - lib/host_os.rb
@@ -31,10 +32,10 @@ homepage: https://github.com/mblumtritt/host-os
 licenses:
 - BSD-3-Clause
 metadata:
+  rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/mblumtritt/host-os
   bug_tracker_uri: https://github.com/mblumtritt/host-os/issues
-  documentation_uri: https://rubydoc.info/gems/host-os
-  rubygems_mfa_required: 'true'
+  documentation_uri: https://rubydoc.info/gems/host-os/0.2.2/HostOS
 rdoc_options: []
 require_paths:
 - lib
@@ -49,7 +50,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.7.0
 specification_version: 4
 summary: This module offers details on the host OS, the present Ruby interpreter and
   environment.