recls-ruby 2.13.1 → 2.13.4

data/test/unit/tc_recls_util.rb

@@ -13,115 +13,6 @@ end
 require 'test/unit'
 
 
-class Test_combine_paths < Test::Unit::TestCase
-
-  def test_nil_nil
-
-    if RUBY_VERSION >= '2'
-
-      assert_raise_with_message(::ArgumentError, /must specify one or more path elements/) { Recls.combine_paths(nil, nil) }
-    else
-
-      assert_raise(::ArgumentError) { Recls.combine_paths(nil, nil) }
-    end
-  end
-
-  def test_origin_nil
-
-    strings = [
-
-      'abc',
-      'abc/def',
-      'abc/def/ghi.ext',
-    ]
-
-    strings.each do |s|
-
-      assert_equal s, Recls.combine_paths(nil, s)
-    end
-  end
-
-  def test_path_nil
-
-    strings = [
-
-      'abc',
-      'abc/def',
-      'abc/def/ghi.ext',
-    ]
-
-    strings.each do |s|
-
-      assert_equal s, Recls.combine_paths(s, nil)
-    end
-  end
-
-  def test_both_relative
-
-    assert_equal 'abc/def', Recls.combine_paths('abc', 'def')
-    assert_equal 'abc/def', Recls.combine_paths('abc/', 'def')
-    assert_equal 'abc/def/ghi', Recls.combine_paths('abc/def', 'ghi')
-    assert_equal 'abc/def/ghi', Recls.combine_paths('abc/def/', 'ghi')
-    assert_equal 'abc/def/ghi', Recls.combine_paths('abc', 'def/ghi')
-    assert_equal 'abc/def/ghi', Recls.combine_paths('abc/', 'def/ghi')
-    assert_equal 'abc/./def/ghi', Recls.combine_paths('abc/.', 'def/ghi')
-    assert_equal 'abc/./def/ghi', Recls.combine_paths('abc/./', 'def/ghi')
-
-    if RUBY_VERSION >= '2'
-
-      assert_equal 'abc/./def/ghi', Recls.combine_paths('abc/.', 'def/ghi', clean_path: false)
-      assert_equal 'abc/./def/ghi', Recls.combine_paths('abc/./', 'def/ghi', clean: false)
-      assert_equal 'abc/def/ghi', Recls.combine_paths('abc/.', 'def/ghi', clean_path: true)
-      assert_equal 'abc/def/ghi', Recls.combine_paths('abc/./', 'def/ghi', clean: true)
-      assert_equal 'abc/def/ghi', Recls.combine_paths('abc/./.', 'def/ghi', clean_path: true)
-      assert_equal 'abc/../def/ghi', Recls.combine_paths('abc/..', 'def/ghi')
-      assert_equal 'def/ghi', Recls.combine_paths('abc/..', 'def/ghi', clean_path: true)
-    end
-  end
-
-  def test_multiple_relative
-
-    if RUBY_VERSION >= '2'
-
-      assert_equal 'a/b/c/d/e/f/g', Recls.combine_paths('a', 'b', 'c', 'd/e/f/', 'g', clean: false)
-      assert_equal 'a/b/c/d/e/f/g', Recls.combine_paths('a', 'b', 'c', 'd/e/f/', 'g', clean: true)
-
-      assert_equal 'a/b/c/../d/e/f/g', Recls.combine_paths('a', 'b', 'c', '..', 'd/e/f/', 'g', clean: false)
-      assert_equal 'a/b/d/e/f/g', Recls.combine_paths('a', 'b', 'c', '..', 'd/e/f/', 'g/', clean: true)
-      assert_equal 'a/b/d/e/f/g/', Recls.combine_paths('a', 'b', 'c', '..', 'd/e/f/', 'g/', canonicalise: true)
-    end
-  end
-
-  def test_various_absolute_placings
-
-    assert_equal '/a/b/c/d/e/f/g', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', 'f/g')
-
-    assert_equal '/b/c/d/e/f/g', Recls.combine_paths('/', 'a', '/b', 'c', 'd/e', 'f/g')
-
-    assert_equal '/c/d/e/f/g', Recls.combine_paths('/', 'a', 'b', '/c', 'd/e', 'f/g')
-
-    assert_equal '/d/e/f/g', Recls.combine_paths('/', 'a', 'b', 'c', '/d/e', 'f/g')
-
-    assert_equal '/f/g', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', '/f/g')
-    assert_equal '/f/g/', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', '/f/g/')
-
-    if RUBY_VERSION >= '2'
-
-      assert_equal '/f/g', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', '/f/g/', clean: true)
-      assert_equal '/f/g/', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', '/f/g/', canonicalise: true)
-    end
-  end
-
-  def test_combining_with_entries
-
-    f_g = Recls.stat('/f/g', Recls::DETAILS_LATER)
-    b = Recls.stat('b', Recls::DETAILS_LATER)
-
-    assert_equal '/f/g', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', f_g)
-    assert_equal '/f/g', Recls.combine_paths('/', 'a', b, 'c', 'd/e', f_g)
-  end
-end
-
 class Test_canonicalise_path < Test::Unit::TestCase
 
   def test_nil

data/test/unit/util/tc_combine_paths.rb

@@ -0,0 +1,157 @@
+#! /usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), '../../..', 'lib')
+
+require 'recls'
+
+require 'xqsr3/extensions/test/unit'
+require 'test/unit'
+
+require 'fileutils'
+
+
+class Test_combine_paths < Test::Unit::TestCase
+
+  def test_nil_nil
+
+    if RUBY_VERSION >= '2'
+
+      assert_raise_with_message(::ArgumentError, /must specify one or more path elements/) { Recls.combine_paths(nil, nil) }
+    else
+
+      assert_raise(::ArgumentError) { Recls.combine_paths(nil, nil) }
+    end
+  end
+
+  def test_origin_nil
+
+    strings = [
+
+      'abc',
+      'abc/def',
+      'abc/def/ghi.ext',
+    ]
+
+    strings.each do |s|
+
+      assert_equal s, Recls.combine_paths(nil, s)
+    end
+  end
+
+  def test_path_nil
+
+    strings = [
+
+      'abc',
+      'abc/def',
+      'abc/def/ghi.ext',
+    ]
+
+    strings.each do |s|
+
+      assert_equal s, Recls.combine_paths(s, nil)
+    end
+  end
+
+  def test_both_relative
+
+    assert_equal 'abc/def', Recls.combine_paths('abc', 'def')
+    assert_equal 'abc/def', Recls.combine_paths('abc/', 'def')
+    assert_equal 'abc/def/ghi', Recls.combine_paths('abc/def', 'ghi')
+    assert_equal 'abc/def/ghi', Recls.combine_paths('abc/def/', 'ghi')
+    assert_equal 'abc/def/ghi', Recls.combine_paths('abc', 'def/ghi')
+    assert_equal 'abc/def/ghi', Recls.combine_paths('abc/', 'def/ghi')
+    assert_equal 'abc/./def/ghi', Recls.combine_paths('abc/.', 'def/ghi')
+    assert_equal 'abc/./def/ghi', Recls.combine_paths('abc/./', 'def/ghi')
+
+    if RUBY_VERSION >= '2'
+
+      assert_equal 'abc/./def/ghi', Recls.combine_paths('abc/.', 'def/ghi', clean_path: false)
+      assert_equal 'abc/./def/ghi', Recls.combine_paths('abc/./', 'def/ghi', clean: false)
+      assert_equal 'abc/def/ghi', Recls.combine_paths('abc/.', 'def/ghi', clean_path: true)
+      assert_equal 'abc/def/ghi', Recls.combine_paths('abc/./', 'def/ghi', clean: true)
+      assert_equal 'abc/def/ghi', Recls.combine_paths('abc/./.', 'def/ghi', clean_path: true)
+      assert_equal 'abc/../def/ghi', Recls.combine_paths('abc/..', 'def/ghi')
+      assert_equal 'def/ghi', Recls.combine_paths('abc/..', 'def/ghi', clean_path: true)
+    end
+  end
+
+  def test_multiple_relative
+
+    if RUBY_VERSION >= '2'
+
+      assert_equal 'a/b/c/d/e/f/g', Recls.combine_paths('a', 'b', 'c', 'd/e/f/', 'g', clean: false)
+      assert_equal 'a/b/c/d/e/f/g', Recls.combine_paths('a', 'b', 'c', 'd/e/f/', 'g', clean: true)
+
+      assert_equal 'a/b/c/../d/e/f/g', Recls.combine_paths('a', 'b', 'c', '..', 'd/e/f/', 'g', clean: false)
+      assert_equal 'a/b/d/e/f/g', Recls.combine_paths('a', 'b', 'c', '..', 'd/e/f/', 'g/', clean: true)
+      assert_equal 'a/b/d/e/f/g/', Recls.combine_paths('a', 'b', 'c', '..', 'd/e/f/', 'g/', canonicalise: true)
+    end
+  end
+
+  def test_various_absolute_placings
+
+    assert_equal '/a/b/c/d/e/f/g', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', 'f/g')
+
+    assert_equal '/b/c/d/e/f/g', Recls.combine_paths('/', 'a', '/b', 'c', 'd/e', 'f/g')
+
+    assert_equal '/c/d/e/f/g', Recls.combine_paths('/', 'a', 'b', '/c', 'd/e', 'f/g')
+
+    assert_equal '/d/e/f/g', Recls.combine_paths('/', 'a', 'b', 'c', '/d/e', 'f/g')
+
+    assert_equal '/f/g', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', '/f/g')
+    assert_equal '/f/g/', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', '/f/g/')
+
+    if RUBY_VERSION >= '2'
+
+      assert_equal '/f/g', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', '/f/g/', clean: true)
+      assert_equal '/f/g/', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', '/f/g/', canonicalise: true)
+    end
+  end
+
+  def test_combining_with_entries
+
+    f_g = Recls.stat('/f/g', Recls::DETAILS_LATER | Recls::DIRECTORIES)
+    b = Recls.stat('b', Recls::DETAILS_LATER | Recls::DIRECTORIES)
+
+    assert_equal '/a/b/c/d/e/f/g', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', 'f/g')
+    assert_equal '/f/g', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', '/f/g')
+
+    assert_equal '/f/g', Recls.combine_paths('/', 'a', 'b', 'c', 'd/e', f_g)
+    assert_equal '/f/g', Recls.combine_paths('/', 'a', b, 'c', 'd/e', f_g)
+  end
+
+  def test_combining_with_entries_that_exist
+
+    fe_this_file = Recls.stat(__FILE__)
+    fe_this_dir = Recls.stat(File.dirname(__FILE__))
+
+    assert_true fe_this_file.file?
+    assert_false fe_this_file.directory?
+
+    assert_true fe_this_dir.directory?
+    assert_false fe_this_dir.file?
+
+    assert_equal fe_this_file.to_s, Recls.combine_paths(fe_this_file)
+    assert_equal fe_this_file.to_s, Recls.combine_paths(nil, fe_this_file)
+    assert_equal fe_this_file.to_s, Recls.combine_paths('abc', fe_this_file)
+    assert_equal fe_this_file.to_s, Recls.combine_paths(fe_this_file)
+    assert_equal fe_this_file.to_s, Recls.combine_paths(fe_this_file, nil)
+    assert_equal fe_this_file.to_s, Recls.combine_paths(fe_this_file, '')
+    assert_equal fe_this_file.to_s, Recls.combine_paths(fe_this_file, 'abc')
+    assert_equal fe_this_file.to_s, Recls.combine_paths('abc', fe_this_file, 'abc')
+
+    assert_equal fe_this_dir.to_s, Recls.combine_paths(fe_this_dir)
+    assert_equal fe_this_dir.to_s, Recls.combine_paths(nil, fe_this_dir)
+    assert_equal fe_this_dir.to_s, Recls.combine_paths('abc', fe_this_dir)
+    assert_equal fe_this_dir.to_s, Recls.combine_paths(fe_this_dir)
+    assert_equal fe_this_dir.to_s, Recls.combine_paths(fe_this_dir, nil)
+    assert_equal "#{fe_this_dir.to_s}/", Recls.combine_paths(fe_this_dir, '')
+    assert_equal "#{fe_this_dir.to_s}/abc", Recls.combine_paths(fe_this_dir, 'abc')
+    assert_equal "#{fe_this_dir.to_s}/abc", Recls.combine_paths('abc', fe_this_dir, 'abc')
+  end
+end
+
+
+# ############################## end of file ############################# #
+

data/test/unit/util/ts_all.rb

@@ -0,0 +1,22 @@
+#! /usr/bin/env ruby
+#
+# executes all other tests
+
+this_dir = File.expand_path(File.dirname(__FILE__))
+
+# all tc_*rb in current directory
+Dir[File.join(this_dir, 'tc_*rb')].each do |file|
+
+  $stderr.puts "requiring file '#{file}'" if $DEBUG
+
+  require file
+end
+
+# all ts_*rb in immediate sub-directories
+Dir[File.join(this_dir, '*', 'ts_*rb')].each do |file|
+
+  $stderr.puts "requiring file '#{file}'" if $DEBUG
+
+  require file
+end
+

metadata

@@ -1,40 +1,62 @@
 --- !ruby/object:Gem::Specification
 name: recls-ruby
 version: !ruby/object:Gem::Version
-  version: 2.13.1
+  version: 2.13.4
 platform: ruby
 authors:
 - Matt Wilson
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-06-02 00:00:00.000000000 Z
+date: 2026-08-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: xqsr3
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.31'
+        version: 0.39.5
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.39.5
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.31'
-description: 'RECursive LS for Ruby
-
-  '
-email: matthew@synesis.com.au
+        version: '1.0'
+description: |
+  recls.Ruby is a platform-independent recursive file-system search library
+  for Ruby. It enumerates files and directories (recursively or not),
+  optionally filtered by wildcards and type flags, and returns each hit as a
+  rich entry object with path components, type, size, and timestamps
+  (including Windows-specific attributes where they exist). Path-combination
+  and existence helpers are included so client code can stay on one API.
+  The name stands for rec-ursive ls; this gem is the Ruby implementation of
+  the recls family (also available for C/C++, Go, .NET, Python, and Rust).
+email:
+- matthew@synesis.com.au
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- AUTHORS.md
+- CHANGES.md
+- CONTRIBUTING.md
+- EXAMPLES.md
+- FAQ.md
+- INSTALL.md
 - LICENSE
+- NEWS.md
 - README.md
 - Rakefile
+- SECURITY.md
+- TODO.md
 - examples/find_files_and_directories.md
 - examples/find_files_and_directories.rb
 - examples/find_files_and_directories.recursive.md
@@ -79,11 +101,17 @@ files:
 - test/unit/test_all_separately.cmd
 - test/unit/test_all_separately.sh
 - test/unit/ts_all.rb
-homepage: http://github.com/synesissoftware/recls.Ruby
+- test/unit/util/tc_combine_paths.rb
+- test/unit/util/ts_all.rb
+homepage: https://github.com/synesissoftware/recls.Ruby
 licenses:
 - BSD-3-Clause
-metadata: {}
-post_install_message:
+metadata:
+  bug_tracker_uri: https://github.com/synesissoftware/recls.Ruby/issues
+  changelog_uri: https://github.com/synesissoftware/recls.Ruby/blob/master/CHANGES.md
+  homepage_uri: https://github.com/synesissoftware/recls.Ruby
+  source_code_uri: https://github.com/synesissoftware/recls.Ruby
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -98,8 +126,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubygems_version: 3.1.6
+signing_key: 
 specification_version: 4
-summary: recls.Ruby
+summary: The platform-independent recursive file-system search library, for Ruby
 test_files: []