host-os 0.2.3 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4d4c55e46c861d21e6c2870483c2fcdde4363dbd258dbcc8dd90151c695dfd3
-  data.tar.gz: f22941bb284272fdc2e981853d993a68f855c9fa2e991b50e69d79ba9e193ae7
+  metadata.gz: 6911e87a33d86796f13712244715bd4674550d7aab285e0b74b46a60bdbc1fee
+  data.tar.gz: 1bea2940bb32647883bda9d6d31351acf00c446eaa1e9ab61830955aa23af252
 SHA512:
-  metadata.gz: ce5dfb8a75cc6f71e1ff527ca00460616a0a8e7feb9578a07bb365a0e6d40969070b5af5a6b9f146570a9df85557e0e0ad1a3ea4e645a495d5ecb62a91679d13
-  data.tar.gz: 8468203ff0fda61f4e2973c0ad6754aa226b6b3f754363ed7d27c86ca83d59333b0030504e9a5380dc4d8229267dd74e4ce2ff529b7336fa684f3d6db1666b12
+  metadata.gz: 494c3eb435deb200f27f605ce6f9a3ffb21c2b602b552fa5b4ac3b122298b53f12139775580adb1d079f1bd418a6fee5653ea3bc5e326594b1e222c917e945cc
+  data.tar.gz: ce7457278f78b6285044bb3a0a54dd341be3d862eb3b5c415879fb078e4114ac9edaa08f1cdfebf8c1bd249968b3ecfc6fc18e962756ebfaad415dcf53221211

data/README.md

@@ -1,10 +1,10 @@
-# HostOS ![version](https://img.shields.io/gem/v/host-os?label=)
+# HostOS v0.4.0
 
 HostOS is a module that offers details about the host operating system, the current Ruby interpreter, and the environment currently in use.
 
 - Gem: [rubygems.org](https://rubygems.org/gems/host-os)
 - Source: [codeberg.org](https://codeberg.org/mblumtritt/host-os)
-- Help: [rubydoc.info](https://rubydoc.info/gems/host-os/HostOS)
+- Help: [rubydoc.info](https://rubydoc.info/gems/host-os/0.4.0/HostOS)
 
 ## Description
 
@@ -79,7 +79,7 @@ This gem is compatible with Ruby 2.3 and higher. You can install it in your syst
 gem install host-os
 ```
 
-or you can use [Bundler](http://gembundler.com/) to add HostOS just to your own project:
+or you can use [Bundler](https://bundler.io) to add HostOS just to your own project:
 
 ```shell
 bundle add 'host-os'

data/examples/current.rb

@@ -12,7 +12,7 @@
 # $ ENV=test ruby examples/current.rb
 #
 
-require 'host-os/support'
+require_relative '../lib/host-os/support'
 
 puts <<~INFORMATION
   # OS Information

data/host-os.gemspec

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative 'lib/host-os/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'host-os'
+  spec.version = HostOS::VERSION
+  spec.summary = <<~SUMMARY.tr("\n", ' ')
+    This module offers details on the host OS, the present Ruby interpreter
+    and environment.
+  SUMMARY
+  spec.description = <<~DESCRIPTION.tr("\n", ' ')
+    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.
+  DESCRIPTION
+
+  spec.author = 'Mike Blumtritt'
+  spec.licenses = %w[MIT Ruby]
+  spec.homepage = 'https://codeberg.org/mblumtritt/host-os'
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['bug_tracker_uri'] = "#{spec.homepage}/issues"
+  spec.metadata['documentation_uri'] = "https://rubydoc.info/gems/host-os/#{
+    HostOS::VERSION
+  }"
+  spec.metadata['rubygems_mfa_required'] = 'true'
+  spec.metadata['yard.run'] = 'yard'
+
+  spec.required_ruby_version = '>= 3.0'
+
+  spec.files = (Dir['lib/**/*'] + Dir['examples/**/*'])
+  spec.files << 'host-os.gemspec' << '.yardopts'
+  spec.extra_rdoc_files = %w[README.md]
+end

data/lib/host-os/interpreter.rb

@@ -19,62 +19,51 @@ module HostOS
 
     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
+      # @return [true, false]
+      #   whether the interpreter is the Yukihiro Matsumoto's C-based (default)
+      #   Ruby Interpreter
+      def mri? = (@id == :mri)
       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
+      # @return [true, false]
+      #   whether the interpreter is the Parrot based Cardinal interpreter
+      def cardinal? = (@id == :cardinal)
       alias parrot? cardinal?
 
       # @!attribute [r] jruby?
-      # @return [true, false] whether the interpreter is the Java based JRuby
-      #  Interpreter
-      def jruby?
-        id == :jruby
-      end
+      # @return [true, false]
+      #   whether the interpreter is the Java based JRuby Interpreter
+      def jruby? = (@id == :jruby)
       alias java? jruby?
 
       # @!attribute [r] rbx?
-      # @return [true, false] whether the interpreter is the Rubinius
-      #   Interpreter
-      def rbx?
-        id == :rbx
-      end
+      # @return [true, false]
+      #   whether the interpreter is the Rubinius Interpreter
+      def rbx? = (@id == :rbx)
       alias rubinius? rbx?
 
       # @!attribute [r] ree?
-      # @return [true, false] whether the interpreter is the Ruby Enterprise
-      #   Edition
-      def ree?
-        id == :ree
-      end
+      # @return [true, false]
+      #   whether the interpreter is the Ruby Enterprise Edition
+      def ree? = (@id == :ree)
       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
+      # @return [true, false]
+      #   whether the interpreter currently uses a JIT Compiler
+      def jit_enabled? = (jit_type != :none)
 
       # @!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
+      # @return [:java, :mjit, :rjit, :yjit, :zjit, :none]
+      #   type of currently used JIT Compiler
+      def jit_type = (@jit_type ||= find_jit_type)
+
+      # @!attribute [r] jit_modules
+      # @return [Array<Module>]
+      #   available JIT Modules
+      def jit_modules = (@jit_modules ||= find_jit_modules)
 
       # @!visibility private
       def to_s
@@ -87,17 +76,15 @@ module HostOS
             ree: 'Enterprise Ruby',
             truffleruby: 'TruffleRuby'
           }.compare_by_identity[
-            id
-          ] || id.to_s.upcase
+            @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
+      def exe = (defined?(@exe) ? @exe : @exe = find_exe)
 
       # @!attribute [r] id
       # @return [Symbol] interpreter identifier
@@ -110,6 +97,35 @@ module HostOS
 
       private
 
+      def find_exe
+        require 'rbconfig' unless defined?(RbConfig)
+        RbConfig.ruby
+      rescue LoadError
+        ENV['RUBY']
+      rescue NoMethodError
+        cfg = RbConfig::CONFIG
+        File.join(cfg['bindir'], "#{cfg['ruby_install_name']}#{cfg['EXEEXT']}")
+      end
+
+      def find_jit_modules
+        return [] unless defined?(RubyVM)
+        RubyVM.constants.filter_map do |c|
+          c = RubyVM.const_get(c)
+          c if Module === c && defined?(c.reset_stats!) && defined?(c.enabled?)
+        end
+      end
+
+      def find_jit_type
+        return :java if jruby?
+        jit_modules.each do |mod|
+          next unless mod.enabled?
+          name = mod.name
+          idx = name.rindex(':') and name = name[(idx + 1)..]
+          return name.downcase.to_sym
+        end
+        :none
+      end
+
       def identify
         if defined?(RUBY_PLATFORM) && (RUBY_PLATFORM == 'parrot')
           return :cardinal
@@ -118,18 +134,6 @@ module HostOS
         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

data/lib/host-os/support.rb

@@ -15,38 +15,24 @@ module HostOS
       # @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
+      def dev_null = File::NULL
     elsif HostOS.windows?
-      def dev_null
-        'NUL'
-      end
+      def dev_null = 'NUL'
     elsif HostOS.os2?
-      def dev_null
-        'nul'
-      end
+      def dev_null = 'nul'
     elsif HostOS.unix?
-      def dev_null
-        '/dev/null'
-      end
+      def dev_null = '/dev/null'
     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
+      def open_command = 'start'
     elsif HostOS.macosx?
-      def open_command
-        'open'
-      end
+      def open_command = 'open'
     elsif HostOS.linux?
-      def open_command
-        'xdg-open'
-      end
+      def open_command = 'xdg-open'
     end
 
     if HostOS.windows?
@@ -104,9 +90,7 @@ module HostOS
 
     # @attribute [r] temp_dir
     # @return [String] name of the temporary directory
-    def temp_dir
-      @temp_dir ||= find_temp_dir
-    end
+    def temp_dir = (@temp_dir ||= find_temp_dir)
 
     private
 

data/lib/host-os/version.rb

@@ -2,5 +2,5 @@
 
 module HostOS
   # Version number of the gem.
-  VERSION = '0.2.3'
+  VERSION = '0.4.0'
 end

data/lib/host-os.rb

@@ -12,65 +12,45 @@ module HostOS
 
     # @!attribute [r] interpreter
     # @return [Interpreter] interpreter information
-    def interpreter
-      Interpreter
-    end
+    def interpreter = Interpreter
 
     # @!attribute [r] env
     # @return [Env] environment information
-    def env
-      Env
-    end
+    def env = Env
 
     # @!attribute [r] unix?
     # @return [true, false] whether the host OS is a Unix OS
-    def unix?
-      @type == :unix
-    end
+    def unix? = (@type == :unix)
 
     # @!attribute [r] windows?
     # @return [true, false] whether the host OS is a Windows OS
-    def windows?
-      @type == :windows
-    end
+    def windows? = (@type == :windows)
 
     # @!attribute [r] vms?
     # @return [true, false] whether the host OS is VMS
-    def vms?
-      @type == :vms
-    end
+    def vms? = (@type == :vms)
 
     # @!attribute [r] os2?
     # @return [true, false] whether the host OS is OS/2
-    def os2?
-      @type == :os2
-    end
+    def os2? = (@type == :os2)
 
     # @!attribute [r] macosx?
     # @return [true, false] whether the host OS is identified as MacOS
-    def macosx?
-      @id == :macosx
-    end
+    def macosx? = (@id == :macosx)
 
     # @!attribute [r] linux?
     # @return [true, false] whether the host OS is identified as Linux derivate
-    def linux?
-      @id == :linux
-    end
+    def linux? = (@id == :linux)
 
     # @!attribute [r] cygwin?
     # @return [true, false] whether the host OS is Windows/Cygwin
-    def cygwin?
-      @id == :cygwin
-    end
+    def cygwin? = (@id == :cygwin)
 
     # @!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.
-    def posix?
-      Process.respond_to?(:fork)
-    end
+    def posix? = Process.respond_to?(:fork)
 
     # @param what [Symbol, String] the identifier to check
     # @return [true, false] whether the host OS is the given identifier or type
@@ -153,8 +133,7 @@ module HostOS
     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
+      defined?(what.to_s) ? id == what.to_s.to_sym : false
     end
 
     private
@@ -196,23 +175,26 @@ module HostOS
     extend Helper
 
     class << self
+      # @!attribute [r] id
+      # @return [Symbol]
+      #   environment identifier
+
       # @!attribute [r] production?
-      # @return [true, false] whether the environment is configured as "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
+      # @return [true, false]
+      #   whether the environment is configured as "development"
 
       # @!method is?(what)
-      # @param what [Symbol, String] the identifier to check
-      # @return [true, false] whether the environment is the given identifier
+      # @param what [#to_sym, #to_s] the identifier to check
+      # @return [true, false]
+      #   whether the environment is the given identifier
 
       # @comment YARD requires this line
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: host-os
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.4.0
 platform: ruby
 authors:
 - Mike Blumtritt
@@ -9,20 +9,18 @@ bindir: bin
 cert_chain: []
 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.
+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. '
 executables: []
 extensions: []
 extra_rdoc_files:
-- LICENSE
 - README.md
 files:
 - ".yardopts"
-- LICENSE
 - README.md
 - examples/current.rb
+- host-os.gemspec
 - lib/host-os.rb
 - lib/host-os/interpreter.rb
 - lib/host-os/support.rb
@@ -30,12 +28,14 @@ files:
 - lib/host_os.rb
 homepage: https://codeberg.org/mblumtritt/host-os
 licenses:
-- BSD-3-Clause
+- MIT
+- Ruby
 metadata:
-  rubygems_mfa_required: 'true'
   source_code_uri: https://codeberg.org/mblumtritt/host-os
   bug_tracker_uri: https://codeberg.org/mblumtritt/host-os/issues
-  documentation_uri: https://rubydoc.info/gems/host-os/0.2.3/HostOS
+  documentation_uri: https://rubydoc.info/gems/host-os/0.4.0
+  rubygems_mfa_required: 'true'
+  yard.run: yard
 rdoc_options: []
 require_paths:
 - lib
@@ -43,14 +43,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.1
+rubygems_version: 4.0.11
 specification_version: 4
 summary: This module offers details on the host OS, the present Ruby interpreter and
   environment.

data/LICENSE

@@ -1,28 +0,0 @@
-BSD 3-Clause License
-
-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:
-
-1. Redistributions of source code must retain the above copyright notice, this
-   list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice,
-   this list of conditions and the following disclaimer in the documentation
-   and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its
-   contributors may be used to endorse or promote products derived from
-   this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.