FileRenamer
Simple bulk file renaming tool.
https://rubygems.org/gems/file_renamer
Installation
Add this line to your application's Gemfile:
gem 'file_renamer'And then execute:
$ bundle
Or install it yourself as:
$ gem install file_renamer
Usage
From terminal
file_renamer [options]
-d --dir (optional)
-p --prefix (optional)
-e --extension (optional)
-n --name (required)
- Use
--dirkey to specify directory where you want script to be ran (not required in terminal version)
IMPORTANT!
If no --dir passed to parameters, directory where script where executed will be proceed.
-
Use
--namekey to specifynew_namefor the files that should be renamedFirst will be named
new_name, second -new_name_1, third -new_name_2etc. -
Use
--prefixkey to specify prefix for the filenames that should be renamedIf
filepassed to--prefixand directory contains 3 files:file1,file2,picture3Onlyfile1andfile2will be renamed,picture3will stay untouched. -
Use
--extkey to specify file extension for the filenames that should be renamedIf
jpg(dot is not required) passed to--extand directory contains 3 files:file1.txt,file2.jpg,picture3.jpgOnlyfile2.jpgandpicture3.jpgwill be renamed,file1.txtwill stay untouched.
IMPORTANT! - If no prefix neither extension passed to the script EVERY file in directory will be renamed, except directories.
HINT: - You can mix --ext and --prefix to concretize conditions
In your project
FileRenamer::PathProcessor.run!(params)
where
- params[:dir] - for execution directory (required)
- params[:prefix] - for filename's prefixes
- params[:ext] - for filename's extensions
- params[:name] - for filename's new names (required)
or
- corrected_params[:dir] - for execution directory (required)
- corrected_params[:prefix] - for filename's prefixes
- corrected_params[:ext] - for filename's extensions
- corrected_params[:name] - for filename's new names (required)
Development
To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release to create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.
TODO: extension change
Contributing
- Fork it ( https://github.com/[my-github-username]/file_renamer/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
Spec
rake spec_all
in project folder to run all specs
License
MIT License.
2020 Tee Zed