renamr 1.0.15 → 1.0.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b39e4e5a0e8eb0a2858888181609bcdddfdc71ab315de810bb7c23b6fb626ff0
-  data.tar.gz: 40d581dd0b0351db79c896ced04446bf5cf5d2af0ec2ae186f044bb499b09cff
+  metadata.gz: 7bdc397de28bfad991bced9b577d5f69b510052389ed06af3044490fac938336
+  data.tar.gz: 56e4d20a103f4c330ba2ed9767d4ced07076b0eaf602a14a89ee3c25af7d0f26
 SHA512:
-  metadata.gz: 03b888d15545d19a1e7ad552ebf416d51cf0d0c8dd3c11a547e2b07d467aa733bc64b888340aa7886136d1eadae811b2210db973f38e6c6f4301756c22daa83d
-  data.tar.gz: ad1d1388214aa414ee34fa7f73823f82ff240d31695453fb920f09a218aa8c144754b38f669c7b4f06f43735719e8b1433cb32447d5994a1528847abb01a4e34
+  metadata.gz: 91bd8b832ccd58c174d91825a2690641ec21b8b408ab9da3ee16c3625530748373520aa5417d16ca707bcdf8a7f552cfdfd8e19c1e843d44f0492a8be155d761
+  data.tar.gz: 3f2e603f6ae91a1d3963fb0386c9c9b8f50c8fd12e109b675e6375aa70fd407440ca0df56c17bc3c347b074a94fe455c0445fb4fdbcda10d30600a3f142bd8d5

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2020-2025 David Rabkin
+Copyright 2020-2026 David Rabkin
 
 Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
 

data/README.adoc

@@ -8,7 +8,6 @@
 :img-rake: https://github.com/rdavid/renamr/actions/workflows/rake.yml/badge.svg
 :img-rubocop: https://github.com/rdavid/renamr/actions/workflows/rubocop.yml/badge.svg
 :img-style: https://img.shields.io/badge/code_style-rubocop-brightgreen.svg
-:img-test: https://github.com/rdavid/renamr/actions/workflows/test.yml/badge.svg
 :url-cv: http://cv.rabkin.co.il
 :url-gem: https://badge.fury.io/rb/renamr
 :url-hoc: https://hitsofcode.com/view/github/rdavid/renamr?branch=master
@@ -18,7 +17,6 @@
 :url-rubocop: https://github.com/rdavid/renamr/actions/workflows/rubocop.yml
 :url-ruby: https://www.ruby-lang.org/en/documentation/installation
 :url-style: https://github.com/rubocop/rubocop
-:url-test: https://github.com/rdavid/renamr/actions/workflows/test.yml
 :url-vale: https://vale.sh
 :url-yamllint: https://github.com/adrienverge/yamllint
 
@@ -28,7 +26,6 @@ image:{img-rake}[rake,link={url-rake}]
 image:{img-rubocop}[rubocop,link={url-rubocop}]
 image:{img-gem}[gem version,link={url-gem}]
 image:{img-style}[code style,link={url-style}]
-image:{img-test}[test,link={url-test}]
 image:{img-hoc}[hits of code,link={url-hoc}]
 image:{img-license}[license,link={url-license}]
 
@@ -36,16 +33,17 @@ toc::[]
 
 == About
 
-`renamr` organizes file and directory names.
+`renamr` normalizes file and directory names.
+It rewrites them with lowercase English letters, digits, and hyphens in place
+of spaces and other symbols.
 
 == Installation
-The tool is designed to operate on macOS, GNU/Linux, Windows, and Unix-like
-operating systems.
-It is packaged as a Gem and requires Ruby version 3.2 or later.
-If you do not have the appropriate version on your platform, refer to
-{url-ruby}[Installing Ruby].
+The tool runs on macOS, GNU/Linux, and other Unix-like operating systems, as
+well as Windows.
+It is packaged as a Ruby gem and requires Ruby 3.2 or later.
+If your platform lacks a suitable Ruby, see {url-ruby}[Installing Ruby].
 
-Utilize this command for installing the package:
+Install the gem with:
 
 [,sh]
 ----
@@ -54,7 +52,7 @@ gem install renamr
 
 == Updating
 
-Utilize this command for updating the package:
+Update the gem with:
 
 [,sh]
 ----
@@ -66,17 +64,17 @@ gem update renamr
 [,sh]
 ----
 renamr [options]
-  -a, --act          Real renaming.
-  -r, --rec          Passes recursively.
-  -l, --lim          Limits name length.
-  -m, --mod          Prepends modification time.
-  -d, --dir dir      Directory to rename.
-  -s, --src src      A string to substitute.
-  -t, --dst dst      A string to replace to.
-  -w, --wid wid      Width of the table.
-  -p, --pre str,beg  A string to prepend to started from beg.
-  -c, --cut pos,len  Removes len symbols from pos.
-  -v, --version      Shows version.
+  -a, --act              Performs actual renaming.
+  -c, --cut pos,len      Removes len characters starting at pos.
+  -d, --dir dir          Directory to process.
+  -l, --lim              Limits file name length.
+  -m, --mod              Prepends file modification time.
+  -p, --prepend str,beg  Prepends a string.
+  -r, --rec              Processes directories recursively.
+  -s, --src src          String to replace.
+  -t, --dst dst          Replacement string.
+  -v, --version          Shows the version.
+  -w, --wid wid          Output table width.
 ----
 
 == Example
@@ -86,9 +84,12 @@ renamr [options]
 renamr -d <source>
 ----
 
-It renames all files in `source` by default pattern: 26 English letters, 10 numbers, minus for spaces and other symbols.
+This previews new names for all files in `source` using the default character
+set: the 26 English letters, 10 digits, and hyphens in place of spaces and
+other symbols.
+Adding `-a` performs the actual renaming.
 
 == License
 
-`renamr` is copyright {url-cv}[David Rabkin] and available under a
+`renamr` is copyright {url-cv}[David Rabkin] and is available under the
 {url-license}[Zero-Clause BSD license].

data/bin/renamr

@@ -1,11 +1,11 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 #
-# This script renames files in given directory by specific rules.
+# Renames files in a directory using configured rules.
 
 require_relative '../lib/renamr'
 

data/lib/renamr/action.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 module Renamr
-  # An interface for actions implementation.
+  # Defines the interface for action implementations.
   class Action
     def do(src)
-      raise "Undefined method Action.do is called with #{src}."
+      raise "Action.do must be overridden, called with #{src}."
     end
 
     def set(src) end

data/lib/renamr/ascii_validator.rb

@@ -1,17 +1,17 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative 'action'
 
 module Renamr
-  # Checks if the resulted string has only ASCII symbols.
+  # Checks whether the resulting string contains only ASCII characters.
   class ASCIIValidatorAction < Action
     def do(src)
       ascii = src.chars.select(&:ascii_only?).join
-      raise "String #{src} has non-ASCII symbols." if src != ascii
+      raise "String #{src} contains non-ASCII characters." if src != ascii
 
       src
     end

data/lib/renamr/auto_localization.rb

@@ -1,17 +1,17 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require 'i18n'
 require_relative 'action'
 
 module Renamr
-  # Automatic localization.
+  # Performs automatic localization using I18n transliteration.
   class AutoLocalizationAction < Action
     def initialize
-      super()
+      super
       I18n.config.available_locales = :en
     end
 

data/lib/renamr/char.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative 'action'
 
 module Renamr
-  # All special symbols besides some (., &, $) are replaced by minus.
+  # Replaces special symbols with hyphens, except `.`, `&`, and `$`.
   class CharAction < Action
     SYM = ' (){},~–\'![]_#@=„“”"`—+‘’;·‡«»%…'.chars.to_set.freeze
 

data/lib/renamr/configurator.rb

@@ -1,57 +1,66 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require 'optparse'
 
 module Renamr
-  # Handles input parameters.
+  # Parses and validates command-line options.
   class Configurator
     DIC = [
-      ['-a', '--act',     'Real renaming.',              :act],
-      ['-r', '--rec',     'Passes recursively.',         :rec],
-      ['-l', '--lim',     'Limits name length.',         :lim],
-      ['-m', '--mod',     'Prepends modification time.', :mod],
-      ['-d', '--dir dir', 'Directory to rename.',        :dir],
-      ['-s', '--src src', 'A string to substitute.',     :src],
-      ['-t', '--dst dst', 'A string to replace to.',     :dst],
-      ['-w', '--wid wid', 'Width of the table.',         :wid]
+      ['-a', '--act',     'Performs actual renaming.',          :act],
+      ['-d', '--dir dir', 'Directory to process.',              :dir],
+      ['-l', '--lim',     'Limits file name length.',           :lim],
+      ['-m', '--mod',     'Prepends file modification time.',   :mod],
+      ['-r', '--rec',     'Processes directories recursively.', :rec],
+      ['-s', '--src src', 'String to replace.',                 :src],
+      ['-t', '--dst dst', 'Replacement string.',                :dst],
+      ['-w', '--wid wid', 'Output table width.',                :wid]
     ].freeze
 
+    def add_simple(opt, key)
+      f, p, d = DIC.find { |_, _, _, k| k == key }
+      opt.on(f, p, d) { |i| @options[key] = i }
+    end
+
     def add_cut(opt)
-      opt.on('-c', '--cut pos,len', Array, 'Removes symbols from pos.') do |l|
+      msg = 'Removes len characters starting at pos.'
+      opt.on('-c', '--cut pos,len', Array, msg) do |l|
         @options[:pos] = l[0]
         @options[:len] = l[1]
       end
     end
 
     def add_prepend(opt)
-      opt.on('-p', '--prepend str,beg', Array, 'Prepend a string.') do |l|
+      opt.on('-p', '--prepend str,beg', Array, 'Prepends a string.') do |l|
         @options[:pre] = l[0]
         @options[:beg] = l[1].nil? ? 0 : l[1].to_i
       end
     end
 
     def add_version(opt)
-      opt.on('-v', '--version', 'Show version.') do
+      opt.on('-v', '--version', 'Shows the version.') do
         puts "#{File.basename($PROGRAM_NAME)} #{VERSION} #{DATE}"
         exit
       end
     end
 
     def add(opt)
+      add_simple(opt, :act)
       add_cut(opt)
+      %i[dir lim mod].each { |k| add_simple(opt, k) }
       add_prepend(opt)
+      %i[rec src dst].each { |k| add_simple(opt, k) }
       add_version(opt)
+      add_simple(opt, :wid)
     end
 
     def initialize
       @options = {}
       OptionParser.new do |o|
         o.banner = "Usage: #{File.basename($PROGRAM_NAME)} [options]."
-        DIC.each { |f, p, d, k| o.on(f, p, d) { |i| @options[k] = i } }
         add(o)
       end.parse!
       validate
@@ -65,7 +74,7 @@ module Renamr
 
         @options[:dir] = File.expand_path(dir)
       end
-      raise "Width of the table should exceeds 14 symbols: #{wid}." if wid < 15
+      raise "Table width must be at least 15 characters: #{wid}." if wid < 15
     end
 
     def act?
@@ -114,7 +123,8 @@ module Renamr
 
     def wid
       if @options[:wid].nil?
-        # Reads current terminal width.
+
+        # Reads the current terminal width.
         wid = `tput cols`
         wid.to_s.empty? ? 79 : wid.to_i
       else

data/lib/renamr/date.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require 'date'
 require_relative 'action'
 
 module Renamr
-  # Replaces any valid date, e.g. 2020-11-02 or 02-11-2020 with 20201102.
+  # Replaces valid dates (for example, 2020-11-02 or 02-11-2020) with 20201102.
   class DateAction < Action
     REG = /(\d+)-(\d+)-(\d+)/
     PAT = ['%m-%d-%Y', '%d-%m-%Y', '%Y-%m-%d', '%Y-%d-%m'].freeze
@@ -25,7 +25,7 @@ module Renamr
       PAT.each do |pat|
         return Date.strptime(sub, pat)
       rescue ArgumentError
-        # Nothing to do.
+        # Tries the next date pattern.
       end
       nil
     end

data/lib/renamr/downcase.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative 'action'
 
 module Renamr
-  # All names should be downcased.
+  # Converts names to lowercase.
   class DowncaseAction < Action
     def do(src)
       src.downcase

data/lib/renamr/factory.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative 'ascii_validator'
@@ -21,15 +21,15 @@ require_relative 'trim'
 require_relative 'truncate'
 
 module Renamr
-  # Produces actions for certain directories.
+  # Builds an action pipeline for a directory.
   class ActionsFactory
-    LIMIT = 143 # Synology eCryptfs limitation.
+    LIMIT = 143 # Matches the Synology eCryptfs limitation.
 
     def initialize(cfg)
       @cfg = cfg
     end
 
-    def produce(dir) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+    def produce(dir) # rubocop:disable Metrics/AbcSize
       if @cfg.lim?
         [
           OmitAction.new(LIMIT),
@@ -37,7 +37,7 @@ module Renamr
         ]
       else
         [
-          PointAction.new(dir), # Should be the first.
+          PointAction.new(dir), # Runs first.
           @cfg.pos.nil? ? nil : RemoveAction.new(@cfg.pos, @cfg.len),
           @cfg.src.nil? ? nil : SubstituteAction.new(@cfg.src, @cfg.dst),
           ManualLocalizationAction.new,

data/lib/renamr/manual_localization.rb

@@ -1,25 +1,25 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative 'action'
 
 module Renamr
-  # Manual localization.
+  # Transliterates accented Latin characters to their ASCII equivalents.
   class ManualLocalizationAction < Action
-    SRC = 'ÀÁÂÃÄÅàáâãäåĀāĂ㥹ÇçĆćĈĉĊċČčÐðĎďĐđ'\
-          'ÈÉÊËèéêëĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħÌÍÎÏ'\
-          'ìíîïĨĩĪīĬĭĮįİıĴĵĶķĸĹĺĻļĽľĿŀŁłÑñŃńŅ'\
-          'ņŇňʼnŊŋÒÓÔÕÖØòóôõöøŌōŎŏŐőŔŕŖŗŘřŚśŜŝ'\
-          'ŞşŠšſŢţŤťŦŧÙÚÛÜùúûüŨũŪūŬŭŮůŰűŲųŴŵÝ'\
+    SRC = 'ÀÁÂÃÄÅàáâãäåĀāĂ㥹ÇçĆćĈĉĊċČčÐðĎďĐđ' \
+          'ÈÉÊËèéêëĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħÌÍÎÏ' \
+          'ìíîïĨĩĪīĬĭĮįİıĴĵĶķĸĹĺĻļĽľĿŀŁłÑñŃńŅ' \
+          'ņŇňʼnŊŋÒÓÔÕÖØòóôõöøŌōŎŏŐőŔŕŖŗŘřŚśŜŝ' \
+          'ŞşŠšſŢţŤťŦŧÙÚÛÜùúûüŨũŪūŬŭŮůŰűŲųŴŵÝ' \
           'ýÿŶŷŸŹźŻżŽž'
-    DST = 'AAAAAAaaaaaaAaAaAaCcCcCcCcCcDdDdDd'\
-          'EEEEeeeeEeEeEeEeEeGgGgGgGgHhHhIIII'\
-          'iiiiIiIiIiIiIiJjKkkLlLlLlLlLlNnNnN'\
-          'nNnnNnOOOOOOooooooOoOoOoRrRrRrSsSs'\
-          'SsSssTtTtTtUUUUuuuuUuUuUuUuUuUuWwY'\
+    DST = 'AAAAAAaaaaaaAaAaAaCcCcCcCcCcDdDdDd' \
+          'EEEEeeeeEeEeEeEeEeGgGgGgGgHhHhIIII' \
+          'iiiiIiIiIiIiIiJjKkkLlLlLlLlLlNnNnN' \
+          'nNnnNnOOOOOOooooooOoOoOoRrRrRrSsSs' \
+          'SsSssTtTtTtUUUUuuuuUuUuUuUuUuUuWwY' \
           'yyYyYZzZzZz'
 
     def do(src)

data/lib/renamr/omit.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative 'action'
 
 module Renamr
-  # Omits file names shorter than limit.
+  # Skips file names shorter than the limit.
   class OmitAction < Action
     def initialize(lim)
       super()

data/lib/renamr/point.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative 'action'
 
 module Renamr
-  # All points besides extension are replaced by minus.
+  # Replaces dots with hyphens, except for the file extension separator.
   class PointAction < Action
     def initialize(dir)
       super()

data/lib/renamr/prepend.rb

@@ -1,17 +1,17 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative 'action'
 
 module Renamr
-  # Prepends user patter.
+  # Inserts a user-provided string at the given position.
   class PrependAction < Action
     def initialize(beg, pre) # rubocop:disable Lint/MissingSuper
       raise 'beg cannot be nil.' if beg.nil?
-      raise 'ins cannot be nil.' if pre.nil?
+      raise 'pre cannot be nil.' if pre.nil?
 
       @beg = beg
       @pre = pre

data/lib/renamr/prepend_date.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative 'action'
 
 module Renamr
-  # Prepends file modification datestamp.
+  # Prepends the file modification date.
   class PrependDateAction < Action
     def initialize(dir)
       super()

data/lib/renamr/remove.rb

@@ -1,28 +1,27 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative 'action'
 
 module Renamr
-  # Removes symbols between left and right positions.
+  # Removes a substring by 1-based position and length.
   class RemoveAction < Action
     def initialize(pos, len)
       super()
-      raise 'len cannot bi nil.' if len.nil?
+      raise 'len cannot be nil.' if len.nil?
+      raise 'len must be positive.' unless len.to_i.positive?
       raise 'pos cannot be nil.' if pos.nil?
-      raise 'pos has to be positive.' unless pos.to_i.positive?
+      raise 'pos must be positive.' unless pos.to_i.positive?
 
       @pos = pos.to_i
       @len = len.to_i
     end
 
     def do(src)
-      return src[@len..] if @pos == 1
-
-      src[0..@pos - 1] + src[@pos + @len..]
+      src[0...(@pos - 1)] + (src[(@pos - 1 + @len)..] || '')
     end
   end
 end

data/lib/renamr/renamer.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require 'fileutils'
@@ -10,7 +10,7 @@ require_relative 'factory'
 require_relative 'reporter'
 
 module Renamr
-  # Renames file by certain rules.
+  # Renames files using configured rules.
   class Renamer
     def initialize
       @cfg = Configurator.new
@@ -29,20 +29,21 @@ module Renamr
           rep.add(File.basename(src), File.basename(dst))
         rescue StandardError => e
           rep.add(File.basename(src), e)
-          puts e.backtrace.join("\n\t")
-                .sub("\n\t", ": #{e}#{e.class ? " (#{e.class})" : ''}\n\t")
+          msg = ": #{e}"
+          msg += " (#{e.class})" if e.class
+          msg += "\n\t#{e.backtrace.join("\n\t")}"
+          puts msg
         end
       end
       rep.do
     end
 
     def unique(dat, nme)
-      dst = []
-      dat.each { |_, d| dst << File.basename(d) } # rubocop:disable Style/HashEachMethods
+      dst = dat.map { |_, d| File.basename(d) }
       return nme unless dst.include?(nme)
 
       ext = File.extname(nme)
-      0.step do |i| # Infinitive loop with index.
+      0.step do |i| # Iterates indefinitely with an index.
         n = ext.nil? ? "#{nme}-#{i}" : "#{File.basename(nme, ext)}-#{i}#{ext}"
         return n unless dst.include?(n)
       end
@@ -53,7 +54,8 @@ module Renamr
 
       dat = []
       act = @fac.produce(dir)
-      # Doesn't include hidden files.
+
+      # Skips hidden files.
       Dir.entries(dir).reject { |f| f.start_with?('.') }.sort.each do |nme|
         src = File.join(dir, nme)
         do_dir(src) if @cfg.rec? && File.directory?(src)

data/lib/renamr/reporter.rb

@@ -1,15 +1,16 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require 'terminal-table'
 require_relative 'action'
+require_relative 'timer'
 require_relative 'utils'
 
 module Renamr
-  # Formats and prints output data.
+  # Formats and prints rename results.
   # rubocop:disable Style/ClassVars
   class Reporter
     @@tim = Timer.new

data/lib/renamr/rutoen.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-# vi:ts=2 sw=2 tw=79 et lbr wrap
-# SPDX-FileCopyrightText: 2018-2025 David Rabkin
+# vi: et lbr sw=2 ts=2 tw=79 wrap
+# SPDX-FileCopyrightText: 2018-2026 David Rabkin
 # SPDX-License-Identifier: 0BSD
 
 require_relative 'action'