mharris_ext 1.7.1 → 1.8.0

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    ZTVlODA0YTgzNTQwZTM4YTllYWJlOWNmYjYzNjI1YjY2MmI0YTg1Zg==
-  data.tar.gz: !binary |-
-    ZDY3YjUxMGRlODdkYzhkNzYwY2Q1YWU4YmViYjRhMDUxYmE3OWVhOA==
-!binary "U0hBNTEy":
-  metadata.gz: !binary |-
-    ODk3N2IwOTNjZjJjOGQxMjc5NWE4YmQ3OWYzYjNlNWI2MDgyMDgyNjBmYWY3
-    MWZhZTY1OGFkOWE2MDQ4OTkxM2I1ZDI3MTkyY2RkMzA4ZTA2MDU3NGViMzUx
-    NTNhNDIyMDlmMmRkNDEwMWQxZTg2ZDhmMzY4NjE2MWYzYzVkNGU=
-  data.tar.gz: !binary |-
-    YzUyY2ZkMWVkMDcxZGI2ZDAwNTU4ZWM4YTMxOWJjM2IyMzIwNDcwNTM1NzBm
-    NTRiODU0OWU5OGEzODc1NTExOGNiM2QyZTg1MGEzODIxNTg0OTJhMzEzNDk2
-    MTE3Y2Q0NWRiOGU4ZThkOTg5NGUwZDY4MjU1NThhY2M2MjlhMTU=
+SHA256:
+  metadata.gz: 8b1c00fe9fc9db8c94212b12960e5cf57ca42ff0c9201e85931cbdbcc2a66142
+  data.tar.gz: 6e3bf943aa7e4dedf2ee76dade33a4d1008e4f7d6ff2a55f22c291cdba0cc800
+SHA512:
+  metadata.gz: 3db5d208524aaa9447723af3e2dce5ed3f6c67d92c6c037784cc2473f9fc2a6cc8ad5766594d775feee7a5b3ebfa2c3742708f1d44b61d529054924488db2692
+  data.tar.gz: aa2cd71652e5b1dc264f33340e91ec54764faf8b91985154cd11bb1419e6ff0881ff246bec259dfcefee0ece5d739f893e327817544019560cec5563fa5086c1

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+ruby '>= 2.7'
+gemspec
+
+group :test do
+  gem 'minitest', '~> 5.25'
+  gem 'simplecov', '~> 0.22', require: false
+  gem 'activesupport', '>= 7.0', '< 8.2'
+end

data/README

@@ -1,7 +1,102 @@
-mharris_ext===========
-Description goes here.
+= mharris_ext
 
-COPYRIGHT
-=========
+Small Ruby helpers used by the playoff-odds applications. Requiring the gem adds
+core extensions and top-level helpers. Ruby 2.7 or newer is required; the local
+development setup uses Ruby 3.3.7.
 
-Copyright (c) 2008 Mike Harris. See LICENSE for details.
+== Development
+
+  bundle install
+  bundle exec rake test
+  bundle exec rake build
+
+Tests use Minitest and SimpleCov, require no services, and include Active Support
+load-order checks. Coverage is written to coverage/index.html. The built gem is
+written to pkg/. VERSION is the authoritative version; VERSION.yml is retained
+for compatibility with older tooling. Jeweler, RCov and the placeholder Cucumber
+task are no longer part of the build or test workflow.
+
+The only runtime dependency is fattr. File.write is provided by Ruby, so Facets
+is no longer required. Bundler 2.4 or newer is recommended for development and
+for commands that use ec's unbundled child environment.
+
+== Initialization and lazy attributes
+
+  require 'mharris_ext'
+
+  class Options
+    include FromHash
+    attr_accessor :name, :enabled
+    fattr(:retries) { 3 }
+  end
+
+  options = Options.new(name: 'example', enabled: false)
+  options.from_hash(name: 'renamed') # updates and returns the same object
+  copy = Options.from_hash(name: 'another')
+
+Unknown attributes raise rather than being ignored. attr_accessor_nn :value
+provides an accessor that rejects nil when read; false and zero are valid values.
+
+== Collections and formatting
+
+  3.of { [] }                         # three distinct arrays
+  (1..7).nths(3)                      # [[1, 2], [3, 4, 5], [6, 7]]
+  [1, 2, 3].nths_hash(2)              # {0 => [1, 2], 1 => [3]}
+  [1, 2, 3].sum_b { |x| x * x }      # 14
+  [1, 2, 3].avg_b { |x| x * x }      # 4.666...
+  {a: 1, b: 2}.map_value { |x| x * 2 }
+  (-1234567).commify                   # "-1,234,567"
+  '1234.50'.commify                    # "1,234.50"
+  'x'.rpad(3)                         # "x  "
+  12.lpad(4)                          # "0012"
+
+Partition counts must be positive integers. Partitions preserve input order,
+include every element, and may be empty when more partitions than elements are
+requested. nths_hashx remains an alias of nths_hash. An empty avg_b retains its
+existing NaN result.
+
+blank? and present? respect existing implementations, including Active Support.
+When Active Support is absent, nil, false, empty collections and whitespace-only
+strings are blank. Ruby's native Object#tap is preserved.
+
+== Files and commands
+
+  File.create('example.txt', 'first')
+  File.append('example.txt', '-last')
+  mkdir_recursive('tmp/nested/path')
+  mkdir_recursive(dir: 'tmp/another/path')
+  mv_making_dir('example.txt', 'tmp/archive')
+  rm_r_if('tmp/archive')
+  ec('ruby --version', silent: true)
+  tm('work') { perform_work }
+
+Directory helpers load FileUtils themselves. ec executes a shell command,
+returns stdout, and raises on a nonzero status. When Bundler is loaded, its
+with_unbundled_env API isolates the child command from the current bundle.
+Without silent: true, the command and stdout are printed.
+
+Other helpers include Regexp.escaped, Time#short_dt, Object#local_methods,
+all_dirs_recursive, eat_exceptions, bt, and print_memory_usage!. The memory
+reporter returns a Thread and reports resident memory in kilobytes on systems
+with ps; stop and join that thread when finished.
+
+== 1.8.0 compatibility fixes
+
+* Removed the obsolete Facets File.write require and dependency.
+* Integer#of replaces the defunct Fixnum extension.
+* File helpers use File.exist? and load their standard-library dependency.
+* ec uses current Bundler APIs; timing uses a monotonic clock.
+* Fixed the memory reporter's removed String#to_a call.
+* Preserved Ruby's tap and existing Active Support blank?/present? methods.
+* Fixed false-valued non-nil accessors and the FromHash class factory.
+* Consolidated partition code, supported general Enumerable inputs, and moved
+  load-time assertions into tests while keeping the old alias available.
+* Fixed comma formatting for signed numbers and decimal fractions.
+
+Validated on Ruby 3.3.7 with Active Support 8.1.3.1. The built package also passed
+isolated smoke checks on Ruby 3.0.6, 3.2.2 and 3.3.7. Both the simulation library's
+269 examples and the Rails application's 9 integration tests also passed with
+this checkout on the Ruby load path. Consumers must update their dependency
+requirements and lockfiles to use this release.
+
+Copyright (c) 2008 Mike Harris. See LICENSE for the MIT license.

data/Rakefile

@@ -1,49 +1,9 @@
-require 'rake'
-
-begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |s|
-    s.name = "mharris_ext"
-    s.summary = %Q{mharris717 utility methods}
-    s.email = "mharris717@gmail.com"
-    s.homepage = "http://github.com/GFunk911/mharris_ext"
-    s.description = "mharris717 utlity methods"
-    s.authors = ["Mike Harris"]
-    s.add_dependency 'fattr'
-    s.add_dependency 'facets'
-  end
-rescue LoadError
-  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
-end
-
-
-
+require 'bundler/gem_tasks'
 require 'rake/testtask'
+
 Rake::TestTask.new(:test) do |t|
   t.libs << 'lib' << 'test'
   t.pattern = 'test/**/*_test.rb'
-  t.verbose = false
 end
 
-begin
-  require 'rcov/rcovtask'
-  Rcov::RcovTask.new do |t|
-    t.libs << 'test'
-    t.test_files = FileList['test/**/*_test.rb']
-    t.verbose = true
-  end
-rescue LoadError
-  puts "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
-end
-
-begin
-  require 'cucumber/rake/task'
-  Cucumber::Rake::Task.new(:features)
-rescue LoadError
-  puts "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
-end
-
-task :default => :test
-
-Jeweler::GemcutterTasks.new
-
+task default: :test

data/VERSION

@@ -0,0 +1 @@
+1.8.0

data/VERSION.yml

@@ -1,5 +1,5 @@
 ---
 :major: 1
-:minor: 7
-:patch: 1
+:minor: 8
+:patch: 0
 :build: 

data/lib/mharris_ext/accessor.rb

@@ -2,7 +2,7 @@ class Object
   def attr_accessor_nn_one(sym)
     define_method(sym) do
       res = instance_variable_get("@#{sym}")
-      raise "method #{sym} cannot return nil value" unless res
+      raise "method #{sym} cannot return nil value" if res.nil?
       res
     end
     attr_writer(sym)
@@ -10,4 +10,4 @@ class Object
   def attr_accessor_nn(*args)
     args.flatten.each { |x| attr_accessor_nn_one(x) }
   end
-end
+end

data/lib/mharris_ext/benchmark.rb

@@ -1,7 +1,7 @@
-def tm(msg="Thing")
-  t = Time.now
+def tm(msg = "Thing")
+  t = Process.clock_gettime(Process::CLOCK_MONOTONIC)
   res = yield
-  seconds = Time.now - t
+  seconds = Process.clock_gettime(Process::CLOCK_MONOTONIC) - t
   puts "#{msg} took #{seconds} seconds"
   res
 end
@@ -9,7 +9,7 @@ end
 def print_memory_usage!
   Thread.new do
     loop do
-      mem = `ps -l #{Process.pid}`.to_a[1].split[8]
+      mem = `ps -o rss= -p #{Process.pid}`.strip
       puts "Memory: #{mem} #{Time.now}"
       sleep(10)
     end

data/lib/mharris_ext/cmd.rb

@@ -1,23 +1,20 @@
 def has_bundler?
-  Bundler
-  true
-rescue => exp
-  return false
+  !!defined?(Bundler)
 end
 
 module MharrisExt
-  def self.ec(cmd,ops={})
+  def self.ec(cmd,ops = {})
     puts cmd unless ops[:silent]
-    res = nil
-    if has_bundler?
-      Bundler.with_clean_env do
-        res = `#{cmd}`
-      end
-    else
+    run = proc do
       res = `#{cmd}`
+      [res, $?]
     end
-
-    raise "bad cmd #{$?.to_i} #{cmd} #{res}" unless $?.to_i == 0
+    res, status = if has_bundler?
+      Bundler.with_unbundled_env(&run)
+    else
+      run.call
+    end
+    raise "bad cmd #{status.to_i} #{cmd} #{res}" unless status.success?
     puts res unless ops[:silent]
     res
   end
@@ -25,4 +22,4 @@ end
 
 def ec(*args)
   MharrisExt.ec(*args)
-end
+end

data/lib/mharris_ext/enumerable.rb

@@ -1,7 +1,7 @@
-class Fixnum
+class Integer
   def of
     res = []
-    self.times { res << yield }
+    times { res << yield }
     res
   end
 end
@@ -12,80 +12,29 @@ module Enumerable
     each { |x| res += x }
     res
   end
+
   def sum_b
     map { |x| yield(x) }.sum
   end
+
   def avg_b(&b)
     sum_b(&b).to_f / size.to_f
   end
-end
 
-module Enumerable
-  def nths_hashx(num)
-    res = {}
-    s = e_f = e_i = 0
-    n_size = size.to_f / num.to_f
-    total_segment_size = 0
-    (0...num).each do |n|
-      s = e_i
-      e_f = e_f + n_size
-      e_i = (e_f+0.5).to_i
-      seg = self[s...e_i]
-     # puts %w(s e_f e_i seg).map { |x| "#{x}: #{send(x)}" }.join("\n")
-      #puts "s: #{s}, e_f: #{e_f}, e_i: #{e_i}, seg: #{seg.inspect}"
-      res[n] = seg
-      total_segment_size += res[n].size
-    end
-    unless total_segment_size == size
-      puts inspect
-      puts res.inspect
-      raise "nths_hash is bad" 
-    end
-    res
-  end
   def nths(num)
-    res = []
-    s = e_f = e_i = 0
-    n_size = size.to_f / num.to_f
-    total_segment_size = 0
-    (0...num).each do |n|
-      s = e_i
-      e_f = e_f + n_size
-      e_i = (e_f+0.5).to_i
-      seg = self[s...e_i]
-     # puts %w(s e_f e_i seg).map { |x| "#{x}: #{send(x)}" }.join("\n")
-      #puts "s: #{s}, e_f: #{e_f}, e_i: #{e_i}, seg: #{seg.inspect}"
-      res << seg
-      total_segment_size += res[n].size
+    raise ArgumentError, 'number of partitions must be a positive integer' unless num.is_a?(Integer) && num > 0
+    items = to_a
+    size_per = items.size.fdiv(num)
+    Array.new(num) do |i|
+      items[(i * size_per).round...((i + 1) * size_per).round]
     end
-    unless total_segment_size == size
-      puts inspect
-      puts res.inspect
-      raise "nths_hash is bad" 
-    end
-    res
   end
+
   def nths_hash(num)
-    res = {}
-    nths(num).each_with_index { |x,i| res[i] = x }
-    res
+    nths(num).each_with_index.to_h { |x,i| [i,x] }
   end
-end
-
-res = [1,2,3,4,5,6].nths_hash(3)
-exp = {0 => [1,2], 1 => [3,4], 2 => [5,6]}
-unless res == exp
-  puts res.inspect
-  puts exp.inspect
-  raise "nths_hash doesn't work"
-end
 
-res = [1,2,3,4,5,6,7].nths_hash(3)
-exp = {0 => [1,2], 1 => [3,4,5], 2 => [6,7]}
-unless res == exp
-  puts res.inspect
-  puts exp.inspect
-  raise "nths_hash doesn't work"
+  alias_method :nths_hashx, :nths_hash
 end
 
 class Hash
@@ -104,8 +53,13 @@ end
 
 class String
   def commify
-    return self if length <= 3
-    self[0...-3].commify + "," + self[-3..-1]
+    if (parts = /\A([+-]?)(\d+)(\.\d+)?\z/.match(self))
+      digits = parts[2].reverse.scan(/.{1,3}/).join(',').reverse
+      "#{parts[1]}#{digits}#{parts[3]}"
+    else
+      # Preserve the legacy grouping behavior for nonnumeric strings.
+      return self if length <= 3
+      self[0...-3].commify + ',' + self[-3..-1]
+    end
   end
 end
-      

data/lib/mharris_ext/fileutils.rb

@@ -1,8 +1,7 @@
+require 'fileutils'
+
 def all_dirs_recursive(dir)
   raise "null dir" unless dir
-  init_slash = (dir[0..0] == '/')
-  #raise "can't handle initial slash" if dir[0..0] == '/'
-  #puts "all_dirs_recursive #{dir}"
   dir.split("/")[0..-1].inject([]) do |paths,dir|
     last_path = (paths.empty? ? "" : "#{paths[-1]}/")
     paths + ["#{last_path}#{dir}"]
@@ -10,43 +9,26 @@ def all_dirs_recursive(dir)
 end
 
 def mkdir_if(dir)
-  if FileTest.exists?(dir)
-    #puts "not making #{dir}"
-  else
-    #puts "making #{dir}"
-    FileUtils.mkdir(dir) 
-  end
+  FileUtils.mkdir(dir) unless File.exist?(dir)
 end
 
 def mkdir_recursive(ops)
   dir = ops.is_a?(Hash) ? ops[:dir] : ops
-  #puts "mkdir_recursive #{dir}"
   all_dirs_recursive(dir).each do |dir|
     mkdir_if(dir)
   end
 end
 
 def mv_making_dir(f,new_dir)
-  #puts "mv_making_dir #{f} #{new_dir}"
   mkdir_recursive(new_dir)
   FileUtils.mv(f,new_dir)
 end
 
-unless all_dirs_recursive("a/b/c") == ["a","a/b","a/b/c"]
-  res = all_dirs_recursive("a/b/c")
-  raise "all_dirs_recursive doesn't work #{res.inspect}"
-end
-
-unless all_dirs_recursive("/a/b/c") == ["/a","/a/b","/a/b/c"]
-  res = all_dirs_recursive("/a/b/c")
-  raise "all_dirs_recursive doesn't work #{res.inspect}"
-end
-
 def rm_r_if(dir)
-  FileUtils.rm_r(dir) if FileTest.exists?(dir)
+  FileUtils.rm_r(dir) if File.exist?(dir)
 end
 
 def eat_exceptions
   yield
 rescue
-end
+end

data/lib/mharris_ext/from_hash.rb

@@ -1,19 +1,22 @@
 module FromHash
+  def self.included(base)
+    base.extend(ClassMethods)
+  end
+
+  module ClassMethods
+    def from_hash(ops = {})
+      new.from_hash(ops)
+    end
+  end
+
   def from_hash(ops)
     ops.each do |k,v|
       send("#{k}=",v)
     end
     self
   end
-  def initialize(ops={})
+
+  def initialize(ops = {})
     from_hash(ops)
   end
 end
-
-class Class
-  def self.from_hash(ops={})
-    res = new
-    res.from_hash(ops)
-    res
-  end
-end

data/lib/mharris_ext/gems.rb

@@ -1,2 +1 @@
-require 'facets/file/write'
-require 'fattr'
+require 'fattr'

data/lib/mharris_ext/object.rb

@@ -1,6 +1 @@
-class Object
-  def tap
-    yield(self)
-    self
-  end
-end
+# Object#tap is provided by Ruby. Keep this require path for compatibility.

data/lib/mharris_ext/present.rb

@@ -1,8 +1,17 @@
 class Object
-  def blank?
-    to_s.strip == ''
+  unless method_defined?(:blank?)
+    def blank?
+      if is_a?(String)
+        /\A[[:space:]]*\z/.match?(self)
+      else
+        respond_to?(:empty?) ? !!empty? : !self
+      end
+    end
   end
-  def present?
-    !blank?
+
+  unless method_defined?(:present?)
+    def present?
+      !blank?
+    end
   end
-end
+end

data/lib/mharris_ext.rb

@@ -1,2 +1,2 @@
-glob = File.dirname(__FILE__) + "/mharris_ext/*.rb"
-Dir[glob].each { |x| require x }
+require_relative 'mharris_ext/gems'
+Dir[File.join(__dir__, 'mharris_ext', '*.rb')].sort.each { |x| require x }

data/mharris_ext.gemspec

@@ -1,67 +1,17 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
-
 Gem::Specification.new do |s|
-  s.name = "mharris_ext"
-  s.version = "1.7.1"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Mike Harris"]
-  s.date = "2013-11-11"
-  s.description = "mharris717 utlity methods"
-  s.email = "mharris717@gmail.com"
-  s.extra_rdoc_files = [
-    "LICENSE",
-    "README"
-  ]
-  s.files = [
-    "LICENSE",
-    "README",
-    "Rakefile",
-    "VERSION.yml",
-    "features/mharris_ext.feature",
-    "features/steps/mharris_ext_steps.rb",
-    "features/support/env.rb",
-    "lib/mharris_ext.rb",
-    "lib/mharris_ext/accessor.rb",
-    "lib/mharris_ext/benchmark.rb",
-    "lib/mharris_ext/cmd.rb",
-    "lib/mharris_ext/enumerable.rb",
-    "lib/mharris_ext/file.rb",
-    "lib/mharris_ext/fileutils.rb",
-    "lib/mharris_ext/from_hash.rb",
-    "lib/mharris_ext/gems.rb",
-    "lib/mharris_ext/methods.rb",
-    "lib/mharris_ext/object.rb",
-    "lib/mharris_ext/present.rb",
-    "lib/mharris_ext/regexp.rb",
-    "lib/mharris_ext/string.rb",
-    "lib/mharris_ext/time.rb",
-    "lib/mharris_ext/trace.rb",
-    "mharris_ext.gemspec",
-    "test/mharris_ext_test.rb",
-    "test/test_helper.rb"
-  ]
-  s.homepage = "http://github.com/GFunk911/mharris_ext"
-  s.require_paths = ["lib"]
-  s.rubygems_version = "2.0.7"
-  s.summary = "mharris717 utility methods"
-
-  if s.respond_to? :specification_version then
-    s.specification_version = 4
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<fattr>, [">= 0"])
-      s.add_runtime_dependency(%q<facets>, [">= 0"])
-    else
-      s.add_dependency(%q<fattr>, [">= 0"])
-      s.add_dependency(%q<facets>, [">= 0"])
-    end
-  else
-    s.add_dependency(%q<fattr>, [">= 0"])
-    s.add_dependency(%q<facets>, [">= 0"])
-  end
+  s.name = 'mharris_ext'
+  s.version = File.read(File.expand_path('VERSION', __dir__)).strip
+  s.summary = 'Mike Harris Ruby utility methods'
+  s.description = 'Small Ruby helpers for object initialization, collections, files, and shell commands.'
+  s.authors = ['Mike Harris']
+  s.email = 'mharris717@gmail.com'
+  s.homepage = 'https://github.com/mharris717/mharris_ext'
+  s.license = 'MIT'
+  s.required_ruby_version = '>= 2.7'
+  s.require_paths = ['lib']
+  s.files = Dir['lib/**/*.rb', 'test/**/*.rb'] + %w[LICENSE README Rakefile VERSION VERSION.yml Gemfile mharris_ext.gemspec]
+  s.metadata = { 'source_code_uri' => s.homepage }
+  s.add_dependency 'fattr', '~> 2.4'
+  s.add_development_dependency 'bundler', '>= 2.4'
+  s.add_development_dependency 'rake', '~> 13.3'
 end
-

data/test/helpers_test.rb

@@ -0,0 +1,247 @@
+require_relative 'test_helper'
+
+class CollectionsTest < Minitest::Test
+  def test_integer_of_returns_fresh_results
+    rows = 3.of { [] }
+    assert_equal [[], [], []], rows
+    assert_equal 3, rows.map(&:object_id).uniq.size
+    assert_equal [], 0.of { flunk }
+  end
+
+  def test_partition_distribution_and_legacy_alias
+    assert_equal [[1, 2], [3, 4], [5, 6]], (1..6).to_a.nths(3)
+    assert_equal [[1, 2], [3, 4, 5], [6, 7]], (1..7).to_a.nths(3)
+    assert_equal [[], [1], [], [2], []], [1, 2].nths(5)
+    assert_equal [[], [], []], [].nths(3)
+    expected = {0 => [1, 2], 1 => [3, 4, 5], 2 => [6, 7]}
+    assert_equal expected, (1..7).to_a.nths_hash(3)
+    assert_equal expected, (1..7).to_a.nths_hashx(3)
+  end
+
+  def test_partitions_any_enumerable_without_losing_elements
+    assert_equal [[1, 2], [3, 4, 5], [6, 7]], (1..7).nths(3)
+    (1..17).each do |n|
+      parts = (1..31).each.nths(n)
+      assert_equal n, parts.size
+      assert_equal (1..31).to_a, parts.flatten
+      assert_operator parts.map(&:size).max - parts.map(&:size).min, :<=, 1
+    end
+  end
+
+  def test_invalid_partition_counts_are_rejected
+    [0, -1, 1.5, '2', nil].each do |n|
+      assert_raises(ArgumentError) { [1, 2].nths(n) }
+    end
+  end
+
+  def test_aggregation_and_hash_mapping
+    assert_equal 6, [1, 2, 3].sumx
+    assert_equal 14, [1, 2, 3].sum_b { |x| x * x }
+    assert_in_delta 14.0 / 3, [1, 2, 3].avg_b { |x| x * x }
+    assert_equal({a: 2, b: 4}, {a: 1, b: 2}.map_value { |x| x * 2 })
+  end
+end
+
+class ObjectHelpersTest < Minitest::Test
+  def test_from_hash_initialization_updates_and_factory
+    klass = Class.new do
+      include FromHash
+      attr_accessor :name, :active
+    end
+    x = klass.new(name: 'one', active: false)
+    assert_equal 'one', x.name
+    assert_equal false, x.active
+    assert_same x, x.from_hash('name' => 'two')
+    assert_equal 'two', x.name
+    assert_equal 'three', klass.from_hash(name: 'three').name
+    assert_raises(NoMethodError) { klass.new(unknown: 1) }
+  end
+
+  def test_non_nil_accessor_accepts_false
+    klass = Class.new { attr_accessor_nn :value }
+    x = klass.new
+    assert_raises(RuntimeError) { x.value }
+    x.value = false
+    assert_equal false, x.value
+    x.value = 0
+    assert_equal 0, x.value
+    x.value = nil
+    assert_raises(RuntimeError) { x.value }
+  end
+
+  def test_blank_and_present_without_active_support
+    [nil, false, '', '  ', "\u2003", [], {}].each do |x|
+      assert x.blank?, "#{x.inspect} should be blank"
+      refute x.present?
+    end
+    [true, 0, '0', [nil], {a: nil}, Object.new].each do |x|
+      refute x.blank?, "#{x.inspect} should be present"
+      assert x.present?
+    end
+    x = Object.new
+    def x.empty?; true; end
+    assert x.blank?
+  end
+
+  def test_preserves_ruby_tap
+    out, = run_ruby(<<~RUBY)
+      before = Object.instance_method(:tap)
+      require 'mharris_ext'
+      raise 'tap was replaced' unless Object.instance_method(:tap) == before
+      x = Object.new
+      raise unless x.tap { |v| raise unless v.equal?(x) }.equal?(x)
+      puts 'native tap'
+    RUBY
+    assert_equal "native tap\n", out
+  end
+
+  def test_active_support_load_order
+    [true, false].each do |rails_first|
+      code = <<~RUBY
+        require 'active_support/core_ext/object/blank' if #{rails_first}
+        before = Object.instance_method(:blank?) if #{rails_first}
+        require 'mharris_ext'
+        raise 'Active Support blank? replaced' if #{rails_first} && Object.instance_method(:blank?) != before
+        require 'active_support/core_ext/object/blank'
+        [nil, false, '', '  ', [], {}].each { |x| raise x.inspect unless x.blank? && !x.present? }
+        raise unless 0.present?
+        puts 'compatible'
+      RUBY
+      out, = run_ruby(code)
+      assert_equal "compatible\n", out
+    end
+  end
+
+  def test_local_methods
+    x = Class.new { def special_helper; end }.new
+    assert_includes x.local_methods, :special_helper
+  end
+end
+
+class FormattingTest < Minitest::Test
+  def test_padding_preserves_existing_call_shapes
+    assert_equal 'x  ', 'x'.rpad(3)
+    assert_equal '  x', 'x'.lpad(3)
+    assert_equal 'long', 'long'.rpad(2)
+    assert_equal 'x....', 'x'.rpad(3, '..')
+    assert_equal '0012', 12.lpad(4)
+  end
+
+  def test_commify_signed_and_decimal_numbers
+    assert_equal '1,234,567', 1234567.commify
+    assert_equal '-123', (-123).commify
+    assert_equal '-1,234,567', (-1234567).commify
+    assert_equal '1,234.56', '1234.56'.commify
+    assert_equal '+1,234.50', '+1234.50'.commify
+    assert_equal '12', 12.commify
+  end
+
+  def test_regexp_and_time
+    pattern = Regexp.escaped('a.b[0]')
+    assert_match pattern, 'a.b[0]'
+    refute_match pattern, 'axb0'
+    assert_equal '09/04 13:02:03', Time.new(2026, 9, 4, 13, 2, 3).short_dt
+  end
+end
+
+class FileHelpersTest < Minitest::Test
+  def test_file_creation_append_and_native_write
+    Dir.mktmpdir do |dir|
+      file = File.join(dir, 'sample')
+      File.create(file, 'first')
+      File.append(file, '-last')
+      assert_equal 'first-last', File.read(file)
+      assert_equal 3, File.write(file, 'new')
+      assert_equal 'new', File.read(file)
+    end
+  end
+
+  def test_path_expansion
+    assert_equal ['a', 'a/b', 'a/b/c'], all_dirs_recursive('a/b/c')
+    assert_equal ['/a', '/a/b', '/a/b/c'], all_dirs_recursive('/a/b/c')
+    assert_raises(RuntimeError) { all_dirs_recursive(nil) }
+  end
+
+  def test_directory_helpers_use_supported_ruby_file_apis
+    Dir.mktmpdir do |dir|
+      target = File.join(dir, 'a', 'b')
+      mkdir_recursive(dir: target)
+      mkdir_recursive(target)
+      assert File.directory?(target)
+      source = File.join(dir, 'source.txt')
+      File.write(source, 'hello')
+      mv_making_dir(source, target)
+      assert_equal 'hello', File.read(File.join(target, 'source.txt'))
+      rm_r_if(File.join(dir, 'a'))
+      refute File.exist?(target)
+      rm_r_if(File.join(dir, 'missing'))
+    end
+  end
+
+  def test_optional_exception_swallowing
+    assert_nil eat_exceptions { raise 'expected' }
+    assert_equal 42, eat_exceptions { 42 }
+  end
+end
+
+class CommandHelpersTest < Minitest::Test
+  def ruby_command(code)
+    Shellwords.join([RbConfig.ruby, '-e', code])
+  end
+
+  def test_success_and_silent_output
+    out, err = capture_io do
+      assert_equal 'ok', ec(ruby_command("print 'ok'"), silent: true)
+    end
+    assert_empty out
+    assert_empty err
+  end
+
+  def test_nonzero_exit_reports_failure
+    error = assert_raises(RuntimeError) { ec(ruby_command("print 'failure'; exit 7"), silent: true) }
+    assert_match(/bad cmd/, error.message)
+    assert_match(/failure/, error.message)
+  end
+
+  def test_unbundles_child_processes_with_current_bundler
+    assert has_bundler?
+    assert_equal 'unset', ec(ruby_command("print ENV.fetch('BUNDLE_GEMFILE', 'unset')"), silent: true)
+  end
+
+  def test_also_runs_without_bundler
+    out, err, status = Bundler.with_unbundled_env do
+      Open3.capture3(RbConfig.ruby, '-Ilib', '-e', <<~RUBY)
+        require 'mharris_ext'
+        raise if has_bundler?
+        print ec(#{ruby_command("print 'ok'").inspect}, silent: true)
+      RUBY
+    end
+    assert status.success?, err
+    assert_equal 'ok', out
+  end
+end
+
+class DiagnosticHelpersTest < Minitest::Test
+  def test_timing_returns_the_block_result
+    out, = capture_io { assert_equal 42, tm('job') { 42 } }
+    assert_match(/job took .* seconds/, out)
+  end
+
+  def test_backtrace_printing
+    out, = capture_io { bt }
+    assert_includes out, 'test_backtrace_printing'
+  end
+
+  def test_memory_report_thread_can_be_stopped
+    x = Object.new
+    lines = Queue.new
+    x.define_singleton_method(:`) { |_| " 1234\n" }
+    x.define_singleton_method(:puts) { |s| lines << s }
+    thread = x.send(:print_memory_usage!)
+    line = Timeout.timeout(2) { lines.pop }
+    assert_match(/Memory: 1234/, line)
+  ensure
+    thread&.kill
+    thread&.join
+  end
+end

data/test/mharris_ext_test.rb

@@ -1,7 +1,20 @@
-require File.dirname(__FILE__) + '/test_helper'
+require_relative 'test_helper'
 
-class MharrisExtTest < Test::Unit::TestCase
-  should "probably rename this file and start testing for real" do
-    flunk "hey buddy, you should probably rename this file and start testing for real"
+class MharrisExtTest < Minitest::Test
+  def test_loads_without_facets_and_preserves_builtin_file_write
+    out, err = run_ruby(<<~RUBY)
+      original = File.method(:write)
+      require 'mharris_ext'
+      raise 'Facets loaded' if $LOADED_FEATURES.any? { |x| x.include?('/facets/') }
+      raise 'File.write replaced' unless File.method(:write) == original
+      puts 'loaded'
+    RUBY
+    assert_equal "loaded\n", out
+    assert_empty err
   end
-end
+
+  def test_fattr_is_still_available
+    klass = Class.new { fattr(:answer) { 42 } }
+    assert_equal 42, klass.new.answer
+  end
+end

data/test/test_helper.rb

@@ -1,10 +1,24 @@
-require 'rubygems'
-require 'test/unit'
-require 'shoulda'
-require 'mocha'
+require 'simplecov'
+SimpleCov.start do
+  add_filter '/test/'
+  track_files 'lib/**/*.rb'
+end
+require 'minitest/autorun'
+require 'minitest/mock'
+require 'open3'
+require 'rbconfig'
+require 'shellwords'
+require 'tmpdir'
+require 'timeout'
+require 'stringio'
 
-$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
 require 'mharris_ext'
 
-class Test::Unit::TestCase
+class Minitest::Test
+  def run_ruby(code)
+    out, err, status = Open3.capture3(RbConfig.ruby, '-Ilib', '-e', code)
+    assert status.success?, "#{out}\n#{err}"
+    [out, err]
+  end
 end

metadata

@@ -1,58 +1,70 @@
 --- !ruby/object:Gem::Specification
 name: mharris_ext
 version: !ruby/object:Gem::Version
-  version: 1.7.1
+  version: 1.8.0
 platform: ruby
 authors:
 - Mike Harris
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2013-11-11 00:00:00.000000000 Z
+date: 2026-09-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fattr
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.4'
 - !ruby/object:Gem::Dependency
-  name: facets
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
+        version: '2.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.3'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-description: mharris717 utlity methods
+        version: '13.3'
+description: Small Ruby helpers for object initialization, collections, files, and
+  shell commands.
 email: mharris717@gmail.com
 executables: []
 extensions: []
-extra_rdoc_files:
-- LICENSE
-- README
+extra_rdoc_files: []
 files:
+- Gemfile
 - LICENSE
 - README
 - Rakefile
+- VERSION
 - VERSION.yml
-- features/mharris_ext.feature
-- features/steps/mharris_ext_steps.rb
-- features/support/env.rb
 - lib/mharris_ext.rb
 - lib/mharris_ext/accessor.rb
 - lib/mharris_ext/benchmark.rb
@@ -70,29 +82,31 @@ files:
 - lib/mharris_ext/time.rb
 - lib/mharris_ext/trace.rb
 - mharris_ext.gemspec
+- test/helpers_test.rb
 - test/mharris_ext_test.rb
 - test/test_helper.rb
-homepage: http://github.com/GFunk911/mharris_ext
-licenses: []
-metadata: {}
-post_install_message: 
+homepage: https://github.com/mharris717/mharris_ext
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/mharris717/mharris_ext
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.0.7
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
-summary: mharris717 utility methods
+summary: Mike Harris Ruby utility methods
 test_files: []

data/features/mharris_ext.feature

@@ -1,9 +0,0 @@
-Feature: something something
-  In order to something something
-  A user something something
-  something something something
-
-  Scenario: something something
-    Given inspiration
-    When I create a sweet new gem
-    Then everyone should see how awesome I am

data/features/support/env.rb

@@ -1,13 +0,0 @@
-$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../lib')
-require 'mharris_ext'
-
-require 'test/unit/assertions'
-
-require 'test/unit/assertions'
-
-World do |world|
-  
-  world.extend(Test::Unit::Assertions)
-  
-  world
-end