modname

about

a versatile file naming tool.

easily rename groups of files with regex replacements.

also supports easily changing file extensions.

setup

[sudo] gem install modname

usage

modname [options] <match> [transform]

modname | rename files, fast
     -e | change file extensions
     -f | force run; don't pre-check
     -r | run modname recursively
     -h | show more help, examples

commands
  file names
    atch] [trans] => modify a pattern in filenames
    atch] => delete a pattern from filenames

  extensions (-e)
    [old] [new] => move file extensions, <old> to <new>
    [ext] => lowercase one extension type (EXT => ext)
    nil => move all extensions to lower case

examples
  file names
    modname hello => deletes 'hello' from all filenames
    modname hello byebye => replace 'hello' with byebye

  extensions (-e)
    modname -e txt md => move all txt files to markdown
    modname -e mov mp4 => move all mov files to mp4

Note: <required> [optional]

examples

modname -e jpeg jpg # change all jpeg file exts to jpg
modname -e # change all file extensions to lowercase
modname '(.*)' 'jeremy \1' # use grouping to prepend string

development / testing

To build from source, first install the project dependencies. This project uses bundler, the standard ruby gem management system. If you don't have it, try running gem install bundler. Once that is done:

bundle install

Now, we should be able to build the gem locally. This will build the local modname gem and link it in your path, so you can playing around with modname.

rake build

This uses rspec and rake to run a suite of unit tests. To run the suite:

rake

todos

• only try to rename filenames, not folders on recursive calls
• figure out whats up with the extension globbing
• apply optionally to directories as well