NAME

pmv - rename files using Perl expressions

SYNOPSIS

pmv [options] expression [file ...]

Options:

--dry-run   -n       show, but do not do it
--link      -l	link instead of rename
--symlink   -s	symlink instead of rename
--reverse   -r	process in reverse order
--overwite  -o	overwrite existing files
--make-dirs -p       create target dirs, if necessary
--verbose   -v	verbose information
--ident		show identification
--help		brief help message

DESCRIPTION

pmv will apply the given Perl expression to each of the file names. If the result is different from the original name, the file will be renamed, linked, or symlinked.

If the expression is any of uc, lc, of ucfirst, pmv will DWIM. Note that these are pretty useless on file systems that are case insensitive.

pmv is a wrapper around File::PerlMove, which does most of the work.

OPTIONS

--dry-run -n

Show the changes, but do not rename the files.

--link -l

Link instead of rename.

--symlink -s

Symlink instead of rename. Note that not all platforms support symlinking.

--reverse -r

Process the files in reversed order.

--overwrite -o

Overwrite existing files.

--make-dirs -p

Create target directories if necessary.

--verbose -v

More verbose information.

--version

Print a version identification to standard output and exits.

--help

Print a brief help message to standard output and exits.

--ident

Prints a program identification. Processing continues.

file

File name(s).

EXAMPLES

To change editor backup files back to Perl sources:

$ pmv -v 's/\.bak$/.pl/' *.bak
foo.bak => foo.pl
bar.bak => bar.pl

Lowcase file names:

$ pmv -v lc *JPG
DSC03345.JPG => dsc03345.jpg
DSC03346.JPG => dsc03346.jpg
DSC03347.JPG => dsc03347.jpg

Shift numbered examples to a new section:

$ pmv --verbose --reverse 's/^ex(\d)/"ex".($1+3)/ge' ex*
ex42.dat => ex72.dat
ex25.dat => ex55.dat
ex22.dat => ex52.dat
ex13.dat => ex43.dat
ex12.dat => ex42.dat

Note that these need to be processed in reversed order, to prevent ex12.dat => ex42.dat botching with the exisitng ex42.dat.

SEE ALSO

File::PerlMove, App::perlmv (and perlvm), File::Rename (and rename).

AUTHOR

Johan Vromans <jvromans@squirrel.nl>

COPYRIGHT

This programs is Copyright 2004,2010,2011,2017 Squirrel Consultancy.

This program is free software; you can redistribute it and/or modify it under the terms of the Perl Artistic License or the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.