host-os 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f86c0a89682b428496bf02a65b5807d1caaa30b5a9d70a34b27595436d1a3746
-  data.tar.gz: b788605d3bdf9b5c851012502d665c6a8ef1ab4ef21b6fbf8828edaf40d78298
+  metadata.gz: 8259f7f3965b419b1c41233b4e6a1a2726b78662f5506e3d397a0cab916ea5bc
+  data.tar.gz: a0dabfba2f2ac721b422d62c0eb297ca42e0942215399974f43061dded676ba3
 SHA512:
-  metadata.gz: e87cb31326255c7e359a5d2110ea81bb43971e9b6d524ccd12eefa7c38368e88c1aec56e68b3beccb06dbfbb078244cfbef0ceefdeacc6d9f856835eac177fc8
-  data.tar.gz: e6e316ad63c38c00d01aeefa252ae2cfd3027d0669ac7b023e40b926c493cb11f78b8f237876d9964c91bc6088cf55e5dac64626e5f3b56dd4b43d3c9d21470c
+  metadata.gz: f554e8e5562e7c1bc5d58bd45422529e3838bb6e21cfc132b3f3010c639ed78c9928f2433868091e540ac50553b578245afc77e52fa63463520f3dd81f33cb2b
+  data.tar.gz: 2210f64c92376f4f498e4d3d3041bb36a1f5a2c2eb592c6686540f21c037d979e0a72251d973ad94e0c6995e54bb8d2a4cce9bbfa66dd0855e0aa567cc33d816

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/support.rb

@@ -32,8 +32,8 @@ module HostOS
     # @!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.
+    # 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.
 
@@ -129,19 +129,31 @@ module HostOS
 
       def find_suggested_thread_count
         count = ENV['TC'].to_i
-        count > 0 ? count : with_etc(4) { Etc.nprocessors }
+        return count if count > 0
+        begin
+          require('etc') unless defined?(Etc)
+          Etc.nprocessors
+        rescue LoadError
+          4
+        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
-
-      def as_dir(name, dirname = ENV[name])
+        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
+
+      def as_dir(name, dirname = nil)
+        dirname ||= ENV[name]
         return if dirname.nil? || dirname.empty?
         dirname = File.expand_path(dirname)
         stat = File.stat(dirname)
@@ -153,13 +165,6 @@ module HostOS
       rescue SystemCallError
         nil
       end
-
-      def with_etc(default)
-        require('etc') unless defined?(Etc)
-        yield
-      rescue LoadError
-        default
-      end
     end
   end
 

data/lib/host-os/version.rb

@@ -2,5 +2,5 @@
 
 module HostOS
   # @return [String] the version number of the gem
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 end

data/lib/host-os.rb

@@ -8,11 +8,11 @@
 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)
+      id == what ||
+        (id == (defined?(what.to_sym) ? what.to_sym : what.to_s.to_sym))
     end
 
-    protected
+    private
 
     def respond_to_missing?(name, _include_all = false)
       (name[-1] == '?') || super
@@ -78,10 +78,8 @@ module HostOS
 
       def identify
         found =
-          (
-            ENV['RAILS_ENV'] || ENV['RACK_ENV'] || ENV['ENVIRONMENT'] ||
-              ENV['ENV']
-          )
+          ENV['RAILS_ENV'] || ENV['RACK_ENV'] || ENV['ENVIRONMENT'] ||
+            ENV['ENV']
         return :production if found.nil? || found.empty?
         found.downcase.tr(' -', '__').to_sym
       end
@@ -113,8 +111,8 @@ module HostOS
       end
 
       # @attribute [r] mri?
-      # @return [true, false] whether the interpreter is the Yukihiro Matsumoto's
-      #   C-based (default) Ruby Interpreter
+      # @return [true, false] whether the interpreter is the Yukihiro
+      #   Matsumoto's C-based (default) Ruby Interpreter
       def mri?
         ID == :mri
       end
@@ -122,8 +120,8 @@ module HostOS
       alias default? mri?
 
       # @attribute [r] cardinal?
-      # @return [true, false] whether the interpreter is the Parrot based Cardinal
-      #   interpreter
+      # @return [true, false] whether the interpreter is the Parrot based
+      #   Cardinal interpreter
       def cardinal?
         ID == :cardinal
       end
@@ -138,7 +136,8 @@ module HostOS
       alias java? jruby?
 
       # @attribute [r] rbx?
-      # @return [true, false] whether the interpreter is the Rubinius Interpreter
+      # @return [true, false] whether the interpreter is the Rubinius
+      #   Interpreter
       def rbx?
         ID == :rbx
       end
@@ -171,22 +170,7 @@ module HostOS
 
       # @!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
+        NAMES[ID] || ID.to_s.upcase
       end
 
       # @!method is?(what)
@@ -209,6 +193,17 @@ module HostOS
 
     # @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
@@ -298,34 +293,7 @@ module HostOS
 
     # @!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
+      NAMES[ID] || ID.to_s.upcase
     end
 
     private
@@ -335,7 +303,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],
@@ -364,4 +332,19 @@ module HostOS
   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
 end

metadata

@@ -1,26 +1,25 @@
 --- !ruby/object:Gem::Specification
 name: host-os
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 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
@@ -36,23 +35,21 @@ metadata:
   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:
 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.6.9
 specification_version: 4
 summary: This module offers details on the host OS, the present Ruby interpreter and
   environment.