Reenrb

Reen-rb is a utility written in Ruby (requires Ruby installed on your machine) that mass renames/deletes files by allowing the user to modify a list. It includes a command line executable called reen that opens the user's default editor to permit interactive changes, or can be used programatically by modifying the list of file names using a code block.

To install the command line utility, use:

$ gem install reenrb

Or add this line to your Ruby application's Gemfile for programmatic use:

gem 'reenrb'

From command line, run reen with file list:

reen files [options]

where files are a list of files or wildcard pattern (defaults to *; see examples)

Options include:

• --help or -h' to see options help
• --editor EDITOR or -e EDITOR' to set the editor (defaults to $VISUAL or $EDITOR otherwise) such as emacs or vi. For Visual Studio Code use 'code -w' to block until editor finishes.
• --review or -r request to review and confirm changes

Examples:

reen                    # reen all files (*)
reen **/*               # reen all files in all subfolders
reen myfolder/**/*.mov  # reen all mov files in subfolders
reen *.md --editor vi   # reen all markdown files using vi
reen --editor 'code -w' # reen all markdown files using vscode

Use programmatically using the reenrb gem. In the example below, we specify that we do not want to use an actual editor to modify the list, but rather alter the list file using a block.

require 'reenrb'

glob = Dir.glob("*")
reen = Reenrb::Reen.new(editor: nil)

reen.execute(glob) do |file|
  # Rename LICENSE.txt -> LICENSE.md
  index = file.list.index { |l| l.include? "LICENSE.txt" }
  file.list[index] = file.list[index].gsub("txt", "md")
end

You may also pass a block with an editor specified, in which case the block is run after the editor has finished.

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

Bug reports and pull requests are welcome on GitHub at https://github.com/soumyaray/reenrb.

The gem is available as open source under the terms of the MIT License.