The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

App::FileRenameUtils - Utilities related to renaming/moving files

VERSION

This document describes version 0.007 of App::FileRenameUtils (from Perl distribution App-FileRenameUtils), released on 2021-08-02.

DESCRIPTION

This distribution provides the following command-line utilities:

FUNCTIONS

add_filename_suffix

Usage:

 $new_name = add_filename_suffix($filename, $suffix);

Examples:

 add_filename_suffix("foo.jpg", " (1)"); # -> "foo (1).jpg"
 add_filename_suffix("foo", " (1)"); # -> "foo (1)"

find_unique_filename

Usage:

 $new_name = find_unique_filename($filename);

Continue adding suffix " (1)", " (2)", and so on to $filename (see "add_filename_suffix") until the new name does not exist on the filesystem. If $filename already does not exist, it will be returned as-is.

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/App-FileRenameUtils.

SOURCE

Source repository is at https://github.com/perlancar/perl-App-FileRenameUtils.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=App-FileRenameUtils

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SEE ALSO

rename from File::Rename

perlmv from App::perlmv

renwd from App::renwd

Other similar distributions: App::FileModifyUtils, App::FileRemoveUtilities.

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2021, 2020, 2019 by perlancar@cpan.org.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.