filename-toolkit

A toolkit for editing multiple filenames at once.

Usage

filename-toolkit [-h] [-d DIR] [-m MATCH] [-n] [-p PREPEND] [-a APPEND]
                 [-l] [-r REPLACE [WITH ...]] [-c COPY] [-e] [-R]
                 [-C COMMAND] [-t] [--version]

Help

optional arguments:
  -h, --help            show this help message and exit
  -d DIR, --dir DIR     Directory to work on. Defaults to current
  -m MATCH, --match MATCH
                        Process files with given regex
  -n, --negative        All files not matching will be processed
  -p PREPEND, --prepend PREPEND
                        Insert string at the beggining of filename
  -a APPEND, --append APPEND
                        Insert string at the end of filename
  -l, --list            Show list of processed files
  -r REPLACE [WITH ...], --replace REPLACE [WITH ...]
                        Replace string/regex with other string, defaults
                        repace to ''
  -c COPY, --copy COPY  Don't rename but copy files with new name to specified
                        dir.
  -e, --erase           Erase processed files
  -R, --recursive       Process files recursively in each subdirectory
  -C COMMAND, --command COMMAND
                        Run given command for each file (refer filename with
                        '#@' and filename without type '#<').
  -t, --test            Changes won't be applied. Show list of processed files
  --version             show program's version number and exit

In -r/--replace, you may use named groups in the first one and refer to them in the second one \g<name>, or use annonymous groups, they're named in order starting from 1 (\g<1> or \1).

Examples

Remove substring from filenames

filename-toolkit -r "substring"

Change filename from 21-03 to 03-21

filename-toolkit -r "(?P<day>\d+)-(?P<month>\d+)" "\g<month>-\g<day>"
or
filename-toolkit -r "(\d+)-(\d+)" "\g<2>-\g<1>"
or
filename-toolkit -r "(\d+)-(\d+)" "\2-\1"

Remove 5 characters from beginning of filename

filename-toolkit -r "^.*{5}"

Add to a git repo files with matching pattern

filename-toolkit -m "P[3-6].py" -l -C "git add #@"