recls-ruby 2.13.2 → 2.13.5

data/TODO.md

@@ -0,0 +1,24 @@
+# recls.Ruby - TODO <!-- omit in toc -->
+
+
+## Functional improvements
+
+* \<none>
+
+
+## Performance improvements
+
+* \<none>
+
+
+## Packaging improvements
+
+* [x] ~~~complete **.github/workflows/ruby.yml** (matrix, gem smoke, warnings job) to match **xqsr3**~~~;
+* [x] ~~~implement **Rakefile** `test` / `default` tasks for `bundle exec rake test`~~~;
+* [x] ~~~fix **recls.gemspec** metadata URIs and homepage to **recls.Ruby** (HTTPS)~~~;
+* [x] ~~~rename gemspec so the filename stem matches `spec.name` (`recls.gemspec` → **recls-ruby.gemspec**)~~~;
+* [x] ~~~obtain a **run_all_unit_tests.sh** (from **misc-dev-scripts**) that skips `tput` when `$TERM` is unset or stdout is not a TTY (CI: `tput: No value for $TERM and no -T specified`)~~~;
+* [x] ~~~after this packaging/boilerplate/CI lift: bump **VERSION** to **2.13.4** and align the gem~~~;
+
+
+<!-- ########################### end of file ########################### -->

data/examples/find_files_and_directories.md

@@ -1,8 +1,9 @@
-# recls.Ruby Example - **find_files_and_directories**
+# recls.Ruby - Example - **find_files_and_directories**
 
 ## Summary
 
-Illustrates finding of FILES, then DIRECTORIES, then both
+Illustrates non-recursive finding of FILES, then DIRECTORIES, then both.
+
 
 ## Source
 

data/examples/find_files_and_directories.recursive.md

@@ -1,8 +1,9 @@
-# recls.Ruby Example - **find_files_and_directories.recursive**
+# recls.Ruby - Example - **find_files_and_directories.recursive**
 
 ## Summary
 
-Illustrates recursive finding of FILES, then DIRECTORIES, then both
+Illustrates recursive finding of FILES, then DIRECTORIES, then both.
+
 
 ## Source
 

data/examples/show_hidden_files.md

@@ -1,8 +1,9 @@
-# recls.Ruby Example - **show_hidden_files**
+# recls.Ruby - Example - **show_hidden_files**
 
 ## Summary
 
-TBC
+Illustrates recursive searching for hidden files via `Recls::SHOW_HIDDEN` and filtering with `Recls::Entry#hidden?`.
+
 
 ## Source
 
@@ -23,9 +24,14 @@ Recls.file_rsearch('.', Recls::WILDCARDS_ALL, Recls::FILES | Recls::SHOW_HIDDEN)
 end
 ```
 
+
 ## Discussion
 
-TBC
+By default, searches omit hidden entries. Including `Recls::SHOW_HIDDEN` causes
+them to be returned; the example then keeps only those for which `#hidden?` is
+true. (The older `Recls.file_rsearch` name is retained for compatibility;
+`Recls.rsearch` is preferred.)
+
 
 ## Example results
 
@@ -39,4 +45,3 @@ TBC
 
 
 <!-- ########################### end of file ########################### -->
-

data/examples/show_readonly_files.md

@@ -1,8 +1,9 @@
-# recls.Ruby Example - **show_hidden_files**
+# recls.Ruby - Example - **show_hidden_files**
 
 ## Summary
 
-TBC
+Illustrates recursive searching for read-only files by filtering with `Recls::Entry#readonly?`.
+
 
 ## Source
 
@@ -22,9 +23,13 @@ Recls.file_rsearch('.', Recls::WILDCARDS_ALL, Recls::FILES).each do |fe|
 end
 ```
 
+
 ## Discussion
 
-TBC
+Unlike hidden entries, read-only files are returned by a normal files search;
+filtering is done solely via `#readonly?`. (The older `Recls.file_rsearch` name
+is retained for compatibility; `Recls.rsearch` is preferred.)
+
 
 ## Example results
 
@@ -35,4 +40,3 @@ TBC
 
 
 <!-- ########################### end of file ########################### -->
-

data/lib/recls/api.rb

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/api.rb
 #
 # Purpose:  Defines Recls module search functions
 #
 # Created:  9th June 2016
-# Updated:  21st April 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #

data/lib/recls/combine_paths_1.rb

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/compare_paths_1.rb
 #
 # Purpose:  Definition of Recls::compare_paths() for Ruby 1.x
 #
 # Created:  17th February 2014
-# Updated:  9th January 2025
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #
@@ -77,7 +78,7 @@ module Recls
 
       if fe.directory?
 
-        paths = paths[ix_last_entry..]
+        paths = paths[ix_last_entry..-1]
       else
 
         return fe

data/lib/recls/combine_paths_2plus.rb

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/compare_paths_2plus.rb
 #
 # Purpose:  Definition of Recls::compare_paths() for Ruby 2+
 #
 # Created:  17th February 2014
-# Updated:  9th January 2025
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #
@@ -83,7 +84,7 @@ module Recls
 
       if fe.directory?
 
-        paths = paths[ix_last_entry..]
+        paths = paths[ix_last_entry..-1]
       else
 
         return fe

data/lib/recls/entry.rb

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/entry.rb
 #
 # Purpose:  Defines the Recls::Entry class for the recls.Ruby library.
 #
 # Created:  24th July 2012
-# Updated:  9th January 2025
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #

data/lib/recls/file_search.rb

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/file_search.rb
 #
 # Purpose:  Defines the Recls::FileSearch class for the recls.Ruby library.
 #
 # Created:  24th July 2012
-# Updated:  21st April 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #
@@ -203,7 +204,7 @@ module Recls
       rescue Errno::ENOENT, Errno::ENXIO
 
         nil
-      rescue SystemCallError => x
+      rescue SystemCallError
 
         # TODO this should be filtered up and/or logged
 

data/lib/recls/flags.rb

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/flags.rb
 #
 # Purpose:  Defines the Recls::Flags module for the recls.Ruby library.
 #
 # Created:  24th July 2012
-# Updated:  21st April 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #

data/lib/recls/foreach.rb

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/foreach.rb
 #
 # Purpose:  Definition of Recls::foreach() utility function
 #
 # Created:  22nd October 2014
-# Updated:  21st April 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #

data/lib/recls/obsolete.rb

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/obsolete.rb
 #
 # Purpose:  Obsolete elements
 #
 # Created:  19th July 2012
-# Updated:  21st April 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #

data/lib/recls/recls.rb

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/recls.rb
 #
 # Purpose:  Main source file for recls library
 #
 # Created:  19th July 2012
-# Updated:  21st April 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #

data/lib/recls/stat.rb

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/stat.rb
 #
 # Purpose:  Defines the Recls.stat() method for the recls.Ruby library.
 #
 # Created:  24th July 2012
-# Updated:  21st April 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #

data/lib/recls/util.rb

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/util.rb
 #
 # Purpose:  Utility module functions for recls library
 #
 # Created:  17th February 2014
-# Updated:  21st April 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #

data/lib/recls/version.rb

@@ -1,14 +1,15 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/version.rb
 #
 # Purpose:  Version for recls library
 #
 # Created:  14th February 2014
-# Updated:  24th April 2025
+# Updated:  30th August 2026
 #
 # Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2025, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2012-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -43,7 +44,7 @@
 module Recls
 
   # Current version of the recls.Ruby library
-  VERSION           = '2.13.2'
+  VERSION           = '2.13.5'
 
   private
   # @!visibility private

data/lib/recls/ximpl/os.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/ximpl/os.rb
 #
@@ -5,7 +6,7 @@
 #           recls library.
 #
 # Created:  16th February 2014
-# Updated:  21st April 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #

data/lib/recls/ximpl/unix.rb

@@ -1,14 +1,15 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/ximpl/unix.rb
 #
 # Purpose:  UNIX-specific constructs for the recls library.
 #
 # Created:  19th February 2014
-# Updated:  21st April 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2012-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -48,15 +49,19 @@ module Recls
   # @!visibility private
   module Ximpl # :nodoc: all
 
+    # File::Stat cannot reliably be subclassed on all Rubies (notably some
+    # Ruby 4 / MinGW builds raise TypeError: wrong instance allocation).
+    # Compose instead and forward File::Stat APIs via method_missing.
+    #
     # @!visibility private
-    class FileStat < File::Stat # :nodoc:
+    class FileStat # :nodoc:
 
       private
       def initialize(path)
 
         @path = path
 
-        super(path)
+        @stat = ::File::Stat.new(path)
       end
 
       public
@@ -74,6 +79,16 @@ module Recls
         return true
       end
 
+      def method_missing(name, *args, &block)
+
+        @stat.__send__(name, *args, &block)
+      end
+
+      def respond_to_missing?(name, include_all = false)
+
+        @stat.respond_to?(name, include_all) || super
+      end
+
       public
       def FileStat.stat(path)
 

data/lib/recls/ximpl/util.rb

@@ -1,14 +1,15 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/ximpl/util.rb
 #
 # Purpose:  Internal implementation constructs for the recls library.
 #
 # Created:  24th July 2012
-# Updated:  21st April 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2012-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -501,7 +502,12 @@ module Recls
 
       f1_windows_root, f2_directory, dummy1, dummy2, dummy3, dummy4, dummy5 = Util.split_path(path)
 
-      dummy1 = dummy2 = dummy3 = dummy4 = dummy5 = nil
+      # suppress unused warnings
+      dummy1 = dummy1
+      dummy2 = dummy2
+      dummy3 = dummy3
+      dummy4 = dummy4
+      dummy5 = dummy5
 
       unless f1_windows_root
 

data/lib/recls/ximpl/windows.rb

@@ -1,14 +1,15 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls/ximpl/windows.rb
 #
 # Purpose:  Windows-specific constructs for the recls library.
 #
 # Created:  19th February 2014
-# Updated:  2nd June 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2012-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -39,8 +40,15 @@
 
 if RUBY_VERSION >= '2'
 
-  require 'fiddle'
-  require 'fiddle/import'
+  begin
+
+    require 'fiddle'
+    require 'fiddle/import'
+  rescue LoadError => e
+
+    # Ruby 4+ no longer ships fiddle as a default gem.
+    raise LoadError, "#{e.message}; on Ruby 4+ Windows, add the 'fiddle' gem (see the project Gemfile)"
+  end
 else
 
   require 'Win32API'
@@ -211,8 +219,12 @@ module Recls
       end # module Kernel32
     end
 
+    # File::Stat cannot reliably be subclassed on all Rubies (notably some
+    # Ruby 4 / MinGW builds raise TypeError: wrong instance allocation).
+    # Compose instead and forward File::Stat APIs via method_missing.
+    #
     # @!visibility private
-    class FileStat < File::Stat # :nodoc:
+    class FileStat # :nodoc:
 
       private
       FILE_ATTRIBUTE_READONLY     = 0x00000001
@@ -260,7 +272,7 @@ module Recls
 
         @attributes = Kernel32.get_file_attributes(path)
 
-        super(path)
+        @stat = ::File::Stat.new(path)
 
         @by_handle_information = ByHandleInformation.new(path)
 
@@ -328,6 +340,17 @@ module Recls
         has_attribute_? FILE_ATTRIBUTE_ENCRYPTED
       end
 
+      # @!visibility private
+      def method_missing(name, *args, &block) # :nodoc:
+
+        @stat.__send__(name, *args, &block)
+      end
+
+      # @!visibility private
+      def respond_to_missing?(name, include_all = false) # :nodoc:
+
+        @stat.respond_to?(name, include_all) || super
+      end
 
       public
       # @!visibility private

data/lib/recls.rb

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 # ######################################################################## #
 # File:     recls.rb
 #
 # Purpose:  Top-level include for recls.Ruby library
 #
 # Created:  13th January 2012
-# Updated:  20th April 2024
+# Updated:  15th August 2026
 #
 # Author:   Matthew Wilson
 #

data/test/unit/test_all_separately.cmd

@@ -1,5 +1,5 @@
-@echo off
-
-echo Executing all ruby tests, each in a separate process:
-for %i in (*.rb) do @ruby "%i"
-
+@echo off
+
+echo Executing all ruby tests, each in a separate process:
+for %i in (*.rb) do @ruby "%i"
+

data/test/unit/util/tc_combine_paths.rb

@@ -113,7 +113,6 @@ class Test_combine_paths < Test::Unit::TestCase
 
     f_g = Recls.stat('/f/g', Recls::DETAILS_LATER | Recls::DIRECTORIES)
     b = Recls.stat('b', Recls::DETAILS_LATER | Recls::DIRECTORIES)
-    root_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')

metadata

@@ -1,40 +1,62 @@
 --- !ruby/object:Gem::Specification
 name: recls-ruby
 version: !ruby/object:Gem::Version
-  version: 2.13.2
+  version: 2.13.5
 platform: ruby
 authors:
 - Matt Wilson
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-04-25 00:00:00.000000000 Z
+date: 2026-08-30 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
@@ -81,10 +103,14 @@ files:
 - test/unit/ts_all.rb
 - test/unit/util/tc_combine_paths.rb
 - test/unit/util/ts_all.rb
-homepage: http://github.com/synesissoftware/recls.Ruby
+homepage: https://github.com/synesissoftware/recls.Ruby
 licenses:
 - BSD-3-Clause
-metadata: {}
+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:
@@ -100,8 +126,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubyforge_project: 
+rubygems_version: 2.7.6.3
 signing_key: 
 specification_version: 4
-summary: recls.Ruby
+summary: The platform-independent recursive file-system search library, for Ruby
 test_files: []