Bulk File Renamer with Regex Patterns

Project roadmap

1. 01

   Design the CLI argument interface

   ~1h

   Use getopts to accept a directory, a regex pattern, a replacement string, and a --dry-run flag.

2. 02

   Build the file listing and matching logic

   ~1.5h

   Use find to list files and grep -P to test which filenames match the regex pattern.

3. 03

   Implement the rename engine

   ~2h

   Use sed to transform matched filenames into new names and mv to apply the rename, guarding against collisions.

4. 04

   Add dry-run preview output

   ~1h

   When --dry-run is set, print an old-name -> new-name table without touching the filesystem.

5. 05

   Write a test suite with fixture files

   ~1.5h

   Create a set of sample files and assert renamed results match expectations using bats or plain assertions.

Resources

• DocsBash Reference Manual