RenameExtensions

Deprecated

This task has been deprecated. Use the move task with a glob mapper instead.

Description

Renames files in the srcDir directory ending with the fromExtension string so that they end with the toExtension string. Files are only replaced if replace is true.

See the section on directory based tasks, on how the inclusion/exclusion of files works, and how to write patterns. This task forms an implicit FileSet and supports most attributes of <fileset> (dir becomes srcDir) as well as the nested <include>, <exclude> and <patternset> elements.

Parameters

Attribute Description Required
defaultexcludes indicates whether default excludes should be used or not (yes|no). No; defaults to yes
excludes comma- or space-separated list of patterns of files that must be excluded. No; defaults to default excludes or none if defaultexcludes is no
excludesfile name of a file. Each line of this file is taken to be an exclude pattern No
fromExtension The string that files must end in to be renamed Yes
includes comma- or space-separated list of patterns of files that must be included. No; defaults to all (**)
includesfile name of a file. Each line of this file is taken to be an include pattern No
replace Whether the file being renamed to should be replaced if it already exists No
srcDir The starting directory for files to search in Yes
toExtension The string that renamed files will end with on completion Yes

Examples

<renameext srcDir="/source/project1"
           includes="**"
           excludes="**/samples/*"
           fromExtension=".java.keep"
           toExtension=".java"
           replace="true"/>