saker.windows Documentation TaskDoc JavaDoc Packages
A file configuration that is used to include files in a given package. The configuration is used to specify which files and how they should be added to the result package or directory. The configuration accepts simple paths and wildcards of theirs or its fields can be used to configure in a more complex way.
Summary
Fields
DirectorySpecifies one or more directory paths which are used as a base to find files specified in Wildcard.
FilesSpecifies one or more files that should be added to the result.
RemapContains path remapping specifications with regular expressions.
TargetDirectorySpecifies the target directory under which the entries specified in the configuration should be placed.
WildcardWildcard patterns used to find files relative to the specified Directory.
Fields
Specifies one or more directory paths which are used as a base to find files specified in Wildcard. Each wildcard path specified in the Wildcard field will be matched relative to the Directory paths specified. The result path will be the concatenation of the TargetDirectory field, and the relative path from the Directory to each found file. If no directory is specified, the current working path of the task will be used. This option cannot be used together with Files.
Specifies one or more files that should be added to the result. The files can be specified using simple paths, wildcards, file locations or file collections. The final archive path of each file will be the concatenation of the TargetDirectory and the file name of a given file. This option cannot be used together with Directory and Resources.
Contains path remapping specifications with regular expressions. The keys of the Remap field are regular expressions that are matched against the output relative path of a file. The paths which are matched don't have the TargetDirectory value prepended to them. The values of the Remap field are replacement expressions that are applied to the matched paths. The pattern matching and replacement works the same way as the Java Pattern class. If the remapped path replacement results in empty string then the corresponding file will be omitted.
Specifies the target directory under which the entries specified in the configuration should be placed. Any input file that is matched by this configuration will have their output paths prepended by the value of this field. The specified path must be forward relative. By default, no target directory is used. The TargetDirectory is prepended to the output path AFTER it has been remapped defined by the Remap field.
Collection of WildcardPath
Wildcard patterns used to find files relative to the specified Directory. The specified wildcard paths in this field will be used to match the input files under the directories specified in Directory. Each matched file will be included in the result with the path that is the concatenation of TargetDirectory and the relative path from the associated Directory. The wildcards can be used to match both files and directories to add to the archive. This option cannot be used together with Files.