ruby_smart-support 1.1.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd347393200ee92556b1d3ea0c6c364d5da5a13be34100fda90056005ac22adf
-  data.tar.gz: 92bf3aae8deda45cc40b2aa7eb77d5e8774e9ae46320246642e6ea1c8ba3102a
+  metadata.gz: 4e2254a95ec35c6fcbd887b968dbc6a75bdfdc68289450f19b79b302cd9010d9
+  data.tar.gz: ade5163e4e702f1a9526da9619d40db03b60ba16505ec1e5c5408ce67642d00d
 SHA512:
-  metadata.gz: aec073cf8aece0a5930fe22f83365fe804bc589b40b84b7524f5b21edaf4053df678b59968f9c1f1222b7773ec228b3cda5343d9d8c99fb7f7eddc79ab7d869e
-  data.tar.gz: fdc642a6c32398c676e353599d61855390999eca7aea52a3c5a51a0a9c0fc7e3c28ea3c264fc75ac5112e3b30bd8dc97ebea664b819016b160567e854e6be90a
+  metadata.gz: e828e44eca0c4d4c7723a03f1364463d2c6d9d7190218a089ea401c8c40d3762ef491d5df0d8d9d7086144407db7253058e7beb424771369e4ac5f1b37209fa8
+  data.tar.gz: c44c1784d5219dc885ab96c5dace9f877e8ded2f7c1d6ae4a2aab111a480de21ebaf03d4ae0ca63cd8f81e7625c5e3f386d1f02e55a6873b103b33ff001c0316

data/.gitignore

@@ -1,22 +1,25 @@
+# defaults
 /.bundle/
+/tmp/
+Gemfile.lock
+
+# testing
+.rspec_status
+/spec/reports/
+
+# documentation & coverage
 /.yardoc
 /_yardoc/
 /coverage/
 /doc/
-/pkg/
-/spec/reports/
-/tmp/
+/docs/yard
+/.coveralls.yml
 
-# rspec failure tracking
-.rspec_status
+# builds
+/pkg/
+/*.gem
 
 # IDE related files
 /.idea
 /.ruby-version
-/.bundle-version
-
-# Github testing
-Gemfile.lock
-
-# builds
-/*.gem
+/.bundle-version

data/.yardopts

@@ -0,0 +1,4 @@
+--embed-mixins
+--markup=markdown
+--files docs/*.*
+--plugin relative_markdown_links

data/README.md

@@ -1,8 +1,13 @@
 # RubySmart::Support
 
-[![Gem Version](https://badge.fury.io/rb/ruby_smart-support.svg)](https://badge.fury.io/rb/ruby_smart-support)
-[![Test](https://github.com/ruby-smart/support/actions/workflows/ruby.yml/badge.svg)](https://github.com/ruby-smart/support/actions/workflows/ruby.yml)
-[![RubySmart::Support Build Status](https://shields.io/github/workflow/status/ruby-smart/support/Test)](https://github.com/ruby-smart/support/actions)
+[![GitHub](https://img.shields.io/badge/github-ruby--smart/support-blue.svg)](http://github.com/ruby-smart/support)
+[![Documentation](https://img.shields.io/badge/docs-rdoc.info-blue.svg)](http://rubydoc.info/gems/ruby_smart-support)
+
+[![Gem Version](https://badge.fury.io/rb/ruby_smart-support.svg?kill_cache=1)](https://badge.fury.io/rb/ruby_smart-support)
+[![License](https://img.shields.io/github/license/ruby-smart/support)](docs/LICENSE.txt)
+
+[![Coverage Status](https://coveralls.io/repos/github/ruby-smart/support/badge.svg?branch=main&kill_cache=1)](https://coveralls.io/github/ruby-smart/support?branch=main)
+[![Tests](https://github.com/ruby-smart/support/actions/workflows/ruby.yml/badge.svg)](https://github.com/ruby-smart/support/actions/workflows/ruby.yml)
 
 A toolkit of support libraries including GemInfo, ThreadInfo, Ruby core extensions & optionally activesupport extensions.
 
@@ -43,6 +48,9 @@ Or install it yourself as:
   * to `append` & `prepend` additional blocks
   * to check task-state with `#invoked?`, `#performed?` & `#running?`
 
+
+
+
 -----
 
 ## ThreadInfo module
@@ -191,19 +199,19 @@ rake db:migrate
 
 ## Docs
 
-[CHANGELOG](./docs/CHANGELOG.md)
+[CHANGELOG](docs/CHANGELOG.md)
 
 ## Contributing
 
 Bug reports and pull requests are welcome on [GitHub](https://github.com/ruby-smart/support).
-This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](./docs/CODE_OF_CONDUCT.md).
+This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](docs/CODE_OF_CONDUCT.md).
 
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
-A copy of the [LICENSE](./docs/LICENSE.txt) can be found @ the docs.
+A copy of the [LICENSE](docs/LICENSE.txt) can be found @ the docs.
 
 ## Code of Conduct
 
-Everyone interacting in the project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [CODE OF CONDUCT](./docs/CODE_OF_CONDUCT.md).
+Everyone interacting in the project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [CODE OF CONDUCT](docs/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -5,12 +5,4 @@ require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
 
-task default: :spec
-
-# ----- Documentation tasks ---------------------------------------------------
-
-require 'yard'
-YARD::Rake::YardocTask.new(:doc) do |t|
-  t.options = %w| --embed-mixins --markup=markdown|
-  t.files = ['lib/**/*.rb','-','docs/*.*']
-end
+task default: :spec

data/bin/console

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 require "bundler/setup"
-require "ruby_smart/support"
+require "ruby_smart-support"
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.

data/docs/CHANGELOG.md

@@ -1,5 +1,17 @@
 # RubySmart::Support - CHANGELOG
 
+## [1.3.0] - 2023-08-08
+* **[add]** `Enumerator.from_hash` to easily resolve values from Array-of-Hashes (use: ary.map.from_hash(key))
+* **[add]** `RubySmart::Support::GemInfo.licenses` to resolve a hash of licences per loaded gem
+* **[fix]** `RubySmart::Support::ThreadInfo.winsize`-detection for debug-ENVs
+* **[ref]** `RubySmart::Support::ThreadInfo.name` to show full application namespace
+* **[ref]** `RubySmart::Support::ThreadInfo.info` to show a optimized info-string
+
+## [1.2.0] - 2023-01-24
+* **[ref]** `GemInfo` methods (active -> required & active? -> required?)
+* **[ref]** simplify `GemInfo.match?`method
+* **[fix]** `Hash#to_md5` method to use `#inspect` instead of `#to_s`
+
 ## [1.1.1] - 2022-11-15
 * **[fix]** `GemInfo` & `ThreadInfo` not being included on require 'ruby_smart-support'
 * **[fix]** yard comments

data/lib/ruby_smart/support/core_ext/ruby/enumerator.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+unless Enumerator.method_defined? :from_hash
+  class Enumerator
+    # returns a new array with only values from provided key.
+    # The Enumerator must be an array of hashes.
+    #
+    # @example
+    #   ary = [{a: 34, b: 12}, {a: 19, c: 4}, {b: 3, c: 11}]
+    #   ary.with_hash(:a)
+    #   > [34, 19, nil]
+    #
+    # @param [Object] key
+    # @return [Array] ary
+    def from_hash(key)
+      map &->(item){item[key]}
+    end
+  end
+end

data/lib/ruby_smart/support/core_ext/ruby/hash.rb

@@ -2,10 +2,10 @@
 
 unless Hash.method_defined? "to_md5"
   class Hash
-    # returns the md5 of any hash by using the to_s method
+    # returns the md5 of any hash by using the +#inspect+ method
     # @return [String] md5
     def to_md5
-      Digest::MD5.hexdigest(Hash[self.sort].to_s)
+      Digest::MD5.hexdigest(Hash[self.sort].inspect)
     end
   end
 end

data/lib/ruby_smart/support/core_ext.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "core_ext/ruby/array"
+require_relative "core_ext/ruby/enumerator"
 require_relative "core_ext/ruby/float"
 require_relative "core_ext/ruby/hash"
 require_relative "core_ext/ruby/object"

data/lib/ruby_smart/support/gem_info.rb

@@ -15,8 +15,10 @@ module RubySmart
 
       # returns a hash of all installed gems with it's versions
       #
+      # @example
+      #
       #   GemInfo.installed
-      #   > {'bundler' => ['2.2.30', '1.2.3']}
+      #   # > {'bundler' => ['2.2.30', '1.2.3']}
       #
       # @return [Hash{<name> => Array[<version>]}] gem name-versions hash
       def self.installed
@@ -27,10 +29,10 @@ module RubySmart
       # the optional version requirement matches against any available version
       #
       #   GemInfo.installed?('bundler')
-      #   > true
+      #   # > true
       #
       #   GemInfo.installed?('bundler', '~> 3.0')
-      #   > false
+      #   # > false
       #
       # @param [String] name - the gem name
       # @param [nil, String] version - optional version requirement
@@ -41,22 +43,36 @@ module RubySmart
 
       # returns a hash of all loaded gems with its current version
       #
+      # @example
+      #
       #   GemInfo.loaded
-      #   > {'bundler' => '2.2.30'}
+      #   # > {'bundler' => '2.2.30'}
       #
       # @return [Hash{<name> => <version>}] gem name-version hash
       def self.loaded
         Hash[::Gem.loaded_specs.values.map { |g| [g.name, g.version.to_s] }.sort]
       end
 
-      # returns true if the provided gem name is loaded.
+      # returns a hash of all loaded gems with it's licenses
+      #
+      # @example
+      #
+      #   GemInfo.licenses
+      #   # > {'bundler' => 'MIT', 'hashery' => 'BSD-2-Clause'}
+      #
+      # @return [Hash{<name> => <license>}] licenses
+      def self.licenses
+        Hash[::Gem.loaded_specs.values.map { |g| [g.name, g.license || '?'] }.sort]
+      end
+
+      # returns true if the provided gem name is loaded (defined within any Gemfile), but must not be required yet.
       # the optional version requirement matches against the loaded version
       #
       #   GemInfo.loaded?('bundler')
-      #   > true
+      #   # > true
       #
       #   GemInfo.loaded?('bundler', '~> 3.0')
-      #   > false
+      #   # > false
       #
       # @param [String] name - the gem name
       # @param [nil, String] version - optional version requirement
@@ -65,13 +81,13 @@ module RubySmart
         loaded.key?(name) && (version.nil? || match?( loaded[name], version))
       end
 
-      # returns an array of all active gems
+      # returns an array of all required gems
       #
-      #   GemInfo.active
+      #   GemInfo.required
       #   > ['bundler']
       #
       # @return [Array<name>}] gem names
-      def self.active
+      def self.required
         $LOADED_FEATURES.
           select { |feature| feature.match(GEM_PATH_REGEXP) }.
           map { |feature|
@@ -82,20 +98,20 @@ module RubySmart
           sort
       end
 
-      # returns true if the provided gem name is active.
-      # the optional version requirement matches against the *loaded* version
+      # returns true if the provided gem name is required.
+      # the optional version matches against the *required* version
       #
-      #   GemInfo.active?('bundler')
+      #   GemInfo.required?('bundler')
       #   > true
       #
-      #   GemInfo.active?('bundler', '~> 3.0')
+      #   GemInfo.required?('bundler', '~> 3.0')
       #   > false
       #
       # @param [String] name - the gem name
       # @param [nil, String] version - optional version requirement
       # @return [Boolean] activated?
-      def self.active?(name, version = nil)
-        active.include?(name) && (version.nil? || match?(self.version(name), version))
+      def self.required?(name, version = nil)
+        required.include?(name) && (version.nil? || match?(self.version(name), version))
       end
 
       # returns an array of all loaded features
@@ -154,7 +170,7 @@ module RubySmart
       # @return [Boolean]
       def self.safe_require(path, gem = nil, version = nil)
         # check for missing gem (nicely check if the feature name differs to the gem name)
-        return false if !gem.nil? && path != gem && !active?(gem, version)
+        return false if !gem.nil? && path != gem && !required?(gem, version)
 
         # try to require the feature
         begin
@@ -185,28 +201,23 @@ module RubySmart
       #   > false
       def self.match?(*args)
         version_current = args.shift
-        version_requirement = args.join ' '
+        version_requirement = args.join(' ')
 
         return true if version_requirement.nil? || version_requirement.strip == ''
 
-        # split version compare operators
-        version_requirement_str = version_requirement.gsub(/([=~>< ]+)/, '')
-        version_requirement_op  = $1
-
-        # create plain versions without compare operators
         gem_version_current     = Gem::Version.new(version_current)
-        gem_version_requirement = Gem::Version.new(version_requirement_str)
+        gem_version_requirement = Gem::Requirement.new(version_requirement)
 
         # check if required version is PRE & current is NOT
         if gem_version_requirement.prerelease? && !gem_version_current.prerelease?
-          version_requirement = "#{version_requirement_op}#{gem_version_requirement.release}"
+          gem_version_requirement = Gem::Requirement.new("#{gem_version_requirement.requirements[0][0]} #{gem_version_requirement.requirements[0][1].release.version}")
         elsif gem_version_requirement.prerelease? != gem_version_current.prerelease?
           # check if required version PRE doesn't equal current version PRE
-          version_current = gem_version_current.release.to_s
+          gem_version_current = gem_version_current.release
         end
         # else is not required here: either its PRE && PRE || !PRE && !PRE
 
-        Gem::Dependency.new('', version_requirement).match?('', version_current)
+        gem_version_requirement.satisfied_by?(gem_version_current)
       end
     end
   end

data/lib/ruby_smart/support/gem_version.rb

@@ -9,8 +9,8 @@ module RubySmart
 
     module VERSION
       MAJOR = 1
-      MINOR = 1
-      TINY  = 1
+      MINOR = 3
+      TINY  = 0
       PRE   = nil
 
       STRING = [MAJOR, MINOR, TINY, PRE].compact.join(".")

data/lib/ruby_smart/support/thread_info.rb

@@ -98,7 +98,7 @@ module RubySmart
       # @return [String] name
       def self.name
         return Rake.application.top_level_tasks.first.to_s if rake?
-        return Rails.application.to_s.split('::').first if rails?
+        return Rails.application.class.name if rails?
         ''
       end
 
@@ -112,9 +112,7 @@ module RubySmart
       # returns the thread type string
       # @return [String] thread-info string
       def self.info
-        strs = ["$#{id}", "[##{process_object_id}]","@ #{type}"]
-        strs << " :: #{name}" if name != ''
-        strs.join ' '
+        "$(#{id}) -> [##{process_object_id}] @ #{type} :: #{self.name}"
       end
 
       # returns true if thread has a 'window'
@@ -127,7 +125,7 @@ module RubySmart
       # @return [Array<rows, columns>] winsize
       def self.winsize
         return IO.console.winsize if io_console?
-        return [ENV['ROWS'], ENV['COLUMNS']] unless ENV['ROWS'].nil? && ENV['COLUMNS'].nil?
+        return [ENV['ROWS'].to_i, ENV['COLUMNS'].to_i] unless ENV['ROWS'].nil? || ENV['COLUMNS'].nil?
         [0, 0]
       end
 

data/ruby_smart-support.gemspec

@@ -3,11 +3,10 @@
 require_relative 'lib/ruby_smart/support/version'
 
 Gem::Specification.new do |spec|
-  spec.name    = 'ruby_smart-support'
-  spec.version = RubySmart::Support.version
-  spec.authors = ['Tobias Gonsior']
-  spec.email   = ['info@ruby-smart.org']
-
+  spec.name        = 'ruby_smart-support'
+  spec.version     = RubySmart::Support.version
+  spec.authors     = ['Tobias Gonsior']
+  spec.email       = ['info@ruby-smart.org']
   spec.summary     = 'A toolkit of support libraries including GemInfo, ThreadInfo, Ruby core extensions & optionally activesupport extensions'
   spec.description = <<~DESC
     RubySmart::Support is a toolkit of support libraries for Ruby - major features includes GemInfo & ThreadInfo, as well core extensions for Ruby & activesupport (if installed).
@@ -17,9 +16,10 @@ Gem::Specification.new do |spec|
   spec.license               = 'MIT'
   spec.required_ruby_version = '>= 2.6.0'
 
-  spec.metadata['homepage_uri']    = spec.homepage
-  spec.metadata['source_code_uri'] = 'https://github.com/ruby-smart/support'
-  spec.metadata['changelog_uri']   = "#{spec.metadata["source_code_uri"]}/blob/main/docs/CHANGELOG.md"
+  spec.metadata['homepage_uri']      = spec.homepage
+  spec.metadata['source_code_uri']   = 'https://github.com/ruby-smart/support'
+  spec.metadata['documentation_uri'] = 'https://rubydoc.info/gems/ruby_smart-support'
+  spec.metadata['changelog_uri']     = "#{spec.metadata["source_code_uri"]}/blob/main/docs/CHANGELOG.md"
 
   spec.metadata['allowed_push_host'] = 'https://rubygems.org'
 
@@ -32,8 +32,8 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_development_dependency 'activesupport', '>= 4.0'
+  spec.add_development_dependency 'coveralls_reborn', '~> 0.25'
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'simplecov', '~> 0.21'
   spec.add_development_dependency 'yard', '~> 0.9'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_smart-support
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.3.0
 platform: ruby
 authors:
 - Tobias Gonsior
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-11-15 00:00:00.000000000 Z
+date: 2023-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -25,47 +25,47 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '4.0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: coveralls_reborn
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '0.25'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '0.25'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.21'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.21'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -94,6 +94,7 @@ files:
 - ".github/workflows/ruby.yml"
 - ".gitignore"
 - ".rspec"
+- ".yardopts"
 - Gemfile
 - README.md
 - Rakefile
@@ -110,6 +111,7 @@ files:
 - lib/ruby_smart/support/core_ext/rails/info.rb
 - lib/ruby_smart/support/core_ext/rake/task.rb
 - lib/ruby_smart/support/core_ext/ruby/array.rb
+- lib/ruby_smart/support/core_ext/ruby/enumerator.rb
 - lib/ruby_smart/support/core_ext/ruby/float.rb
 - lib/ruby_smart/support/core_ext/ruby/hash.rb
 - lib/ruby_smart/support/core_ext/ruby/object.rb
@@ -126,6 +128,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/ruby-smart/support
   source_code_uri: https://github.com/ruby-smart/support
+  documentation_uri: https://rubydoc.info/gems/ruby_smart-support
   changelog_uri: https://github.com/ruby-smart/support/blob/main/docs/CHANGELOG.md
   allowed_push_host: https://rubygems.org
 post_install_message:
@@ -143,7 +146,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.22
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: A toolkit of support libraries including GemInfo, ThreadInfo, Ruby core extensions