host-os 0.1.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f86c0a89682b428496bf02a65b5807d1caaa30b5a9d70a34b27595436d1a3746
-  data.tar.gz: b788605d3bdf9b5c851012502d665c6a8ef1ab4ef21b6fbf8828edaf40d78298
+  metadata.gz: 9a1718752411b34a816e31b58be6f1a3cd83aec89b851e74f6997998e173dcad
+  data.tar.gz: fc322f198a39c3b5b7792012b2206960e0889302a97716ee9bed733b485b642f
 SHA512:
-  metadata.gz: e87cb31326255c7e359a5d2110ea81bb43971e9b6d524ccd12eefa7c38368e88c1aec56e68b3beccb06dbfbb078244cfbef0ceefdeacc6d9f856835eac177fc8
-  data.tar.gz: e6e316ad63c38c00d01aeefa252ae2cfd3027d0669ac7b023e40b926c493cb11f78b8f237876d9964c91bc6088cf55e5dac64626e5f3b56dd4b43d3c9d21470c
+  metadata.gz: 3652cc6e8ddbc5c5489bec318e48f7ce5c73f1c84aa4940887ba080767a8173835e24b2739db27fff6a16f4aaa9f980d9d59edfa66c1ade9e4a296357043bbe2
+  data.tar.gz: 3fd4535322bb9d0de53af3d2ae0695e4199e31976fb472f0d631c1c57750d5c1eac6174abcd16b8e52b4ffa01b3e5ef642dc027c71e4f913fe0412885aeb93cd

data/.yardopts

@@ -0,0 +1,7 @@
+--readme README.md
+--title 'HostOS: Documentation'
+--charset utf-8
+--markup markdown
+--tag comment
+--hide-tag comment
+'lib/**/*.rb' - 'README.md' 'LICENSE'

data/LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2017-2021, Mike Blumtritt. All rights reserved.
+Copyright (c) 2017-2025, Mike Blumtritt. All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

data/README.md

@@ -1,6 +1,4 @@
-# HostOS
-
-![version](https://img.shields.io/gem/v/host-os?label=)
+# HostOS ![version](https://img.shields.io/gem/v/host-os?label=)
 
 HostOS is a module that offers details about the host operating system, the current Ruby interpreter, and the environment currently in use.
 

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,176 +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
-        'NUL'
-      end
-
-      def open_command
-        'start'
+        File::NULL
       end
-
-      def rss_bytes
-        `tasklist /FI "PID eq #{Process.pid}" /FO CSV`.split(',"')[-1].tr(
-          ',.',
-          '__'
-        ).to_i * 1024
+    elsif HostOS.windows?
+      def dev_null
+        'NUL'
       end
-
-      private
-
-      def _app_config_path
-        ENV['LOCALAPPDATA'] ||
-          "#{ENV['USERPROFILE']}/Local Settings/Application Data"
+    elsif HostOS.os2?
+      def dev_null
+        'nul'
       end
-    end
-
-    module Unix
+    elsif HostOS.unix?
       def dev_null
         '/dev/null'
       end
-
-      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'
+    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
-    end
-
-    module MacOS
+    elsif HostOS.macosx?
       def open_command
         'open'
       end
-
-      private
-
-      def _app_config_path
-        '~/Library/Application Support'
-      end
-    end
-
-    module Linux
+    elsif HostOS.linux?
       def open_command
         'xdg-open'
       end
     end
 
-    module AppConfigPath
-      def app_config_path(app_name)
-        File.expand_path(app_name, _app_config_path)
+    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
-    end
-
-    module JRuby
+    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
     end
 
-    module Tools
-      def suggested_thread_count
-        @suggested_thread_count ||= find_suggested_thread_count
+    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
-
-      def temp_dir
-        @temp_dir ||= find_temp_dir
+    elsif HostOS.macosx?
+      def app_config_path(app_name)
+        File.expand_path(app_name, '~/Library/Application Support')
       end
-
-      private
-
-      def find_suggested_thread_count
-        count = ENV['TC'].to_i
-        count > 0 ? count : with_etc(4) { Etc.nprocessors }
+    elsif HostOS.unix?
+      def app_config_path(app_name)
+        File.expand_path(app_name, ENV['XDG_CONFIG_HOME'] || '~/.config')
       end
+    end
 
-      def find_temp_dir
-        return Dir.tmpdir if defined?(Dir.tmpdir)
-        as_dir('TMPDIR') || as_dir('TMP') || as_dir('TEMP') ||
-          as_dir(
-            'system temp dir',
-            with_etc("#{ENV['LOCALAPPDATA']}/Temp") { Etc.systmpdir }
-          ) || as_dir('/tmp', '/tmp') || as_dir('.', '.')
-      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
 
-      def as_dir(name, 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
+    # @attribute [r] temp_dir
+    # @return [String] name of the temporary directory
+    def temp_dir
+      @temp_dir ||= find_temp_dir
+    end
 
-      def with_etc(default)
+    private
+
+    def find_suggested_thread_count
+      count = ENV['TC'].to_i
+      return count if count > 0
+      begin
         require('etc') unless defined?(Etc)
-        yield
+        Etc.nprocessors
       rescue LoadError
-        default
+        4
       end
     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
+    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
 
-  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
+    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
 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.1.0'
+  # Version number of the gem.
+  VERSION = '0.2.2'
 end

data/lib/host-os.rb

@@ -6,281 +6,65 @@
 # It helps you write environment-specific code in a clean way.
 #
 module HostOS
-  module Helper
-    def is?(what)
-      return true if id == what
-      id == (defined?(what.to_sym) ? what.to_sym : what.to_s.to_sym)
-    end
-
-    protected
-
-    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
-        case ID
-        when :mri
-          'CRuby'
-        when :ree
-          'Enterprise Ruby'
-        when :cardinal
-          'Cardinal'
-        when :jruby
-          'JRuby'
-        when :rby
-          'Rubinius'
-        when :truffleruby
-          'TruffleRuby'
-        else
-          ID.to_s.upcase
-        end
-      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
-  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.
@@ -291,41 +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
-      case ID
-      when :linux
-        'Linux'
-      when :macosx
-        'MacOSX'
-      when :freebsd
-        'FreeBSD'
-      when :netbsd
-        'NetBSD'
-      when :openbsd
-        'OpenBSD'
-      when :dragonfly
-        'Dragonly'
-      when :sunis
-        'SunOS'
-      when :mswin
-        'MSWin'
-      when :mingw
-        'MinGW'
-      when :bccwin
-        'BCCWin'
-      when :wince
-        'WinCE'
-      when :windows, :cygwin
-        ID.to_s.capitalize
-      else
-        ID.to_s.upcase
-      end
+      @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
@@ -335,7 +119,7 @@ module HostOS
       id = RbConfig::CONFIG['host_os'].downcase
       id, type, normalized =
         [
-          ['linux', :unix],
+          ['linux', :unix, :linux],
           ['arch', :unix, :linux],
           ['darwin', :unix, :macosx],
           ['mac', :unix, :macosx],
@@ -363,5 +147,92 @@ module HostOS
     end
   end
 
-  ID, TYPE = identify
+  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,30 +1,30 @@
 --- !ruby/object:Gem::Specification
 name: host-os
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Mike Blumtritt
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-09-30 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: |
   This gem helps you write environment-specific code in a clean way.
   It provides a simple API to get information about the operating system,
   the current Ruby interpreter, and the configured environment.
-email:
 executables: []
 extensions: []
 extra_rdoc_files:
-- README.md
 - LICENSE
+- README.md
 files:
+- ".yardopts"
 - LICENSE
 - 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
@@ -32,27 +32,25 @@ 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'
-post_install_message:
+  documentation_uri: https://rubydoc.info/gems/host-os/0.2.2/HostOS
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '2.3'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.7.0
 specification_version: 4
 summary: This module offers details on the host OS, the present Ruby interpreter and
   environment.