CruiseControl.NET : PathFilter
This page last changed on Dec 15, 2009 by csut017.
PathFilter
The PathFilter can be used to filter modifications on the basis of their file path.
Version
Available from version 1.0
Examples
<pathFilter> <pattern>$/Kunigunda/ServiceLocator/Sources/Kunigunda.ServiceLocator/AssemblyInfo.cs</pattern> </pathFilter>
Configuration Elements
| Element | Description | Type | Required | Default | Version |
|---|---|---|---|---|---|
| caseSensitive | Sets casesensitive searching on or off. | Boolean | No | true | 1.0 |
| pattern | This is the pattern used to compare the modification path against. The pattern should match the path of the files in the repository (not the path of the files in the working directory). See below for examples of the syntax for this element. Each PathFilter contains a single pattern element. | String | Yes | n/a | 1.0 |
Notes
Using the PathFilter:
PathFilter supports following wildcards:
| Wildcard | Used as | Matches | Example |
|---|---|---|---|
| *" | part of the path | none or exactly one subfolder | Pattern "/Kunigunda//Sources/." matches "/Kunigunda/Sources/.", "/Kunigunda/Service/Sources/.", and "/Kunigunda/Web/Sources/.*" |
| "*" | part of the folder name | zero or more characters that can appear in the folder name | Pattern "/Kunigunda/Sources/Test*/." matches "/Kunigunda/Sources/Test/." and "/Kunigunda/Sources/Tests/." |
| "*" | part of the filename | zero or more characters that can appear in the file name | Pattern "/Kunigunda/Sources/*.cs" matches all filenames in the "/Kunigunda/Sources" folder ending in ".cs". Pattern "/Kunigunda/Sources/*Test.cs", matches all filenames in the "/Kunigunda/Sources/" folder that end with "Test.cs". |
| "*" | part of the extension | zero or more characters that can appear in the extension. | Pattern "/Kunigunda/Sources/Build.*" matches all files in "/Kunigunda/Sources" folder starting with "Build.". |
| "*" | filename | any file name and extension | Pattern "/Kunigunda/Sources/*" matches all files in "/Kunigunda/Sources" folder. |
| "." | filename | any file name and extension | Pattern "/Kunigunda/Sources/." matches all files in "/Kunigunda/Sources" folder. Note: "." is exactly the same as "*" as a filename. |
| "**" | part of the path | zero or more subfolders. | Pattern "/Kunigunda/Sources/*/Test/." matches all files stored in any "Test" subfolder anywhere below the "/Kunigunda/Sources" tree (e.g., "/Kunigunda/Sources/Test/.", "/Kunigunda/Sources/Core/Test/.*"). |
| ? | anywhere | any single character | Pattern "/Kunigunda/Sources/Test?.cs" matches all files in "/Kunigunda/Sources" are named "Test" followed by one more character and that end in ".cs". |
 | Paths do not include the roots Paths do not include the root server identifiers. For example, if you are using subversion source control on server "myserver" and trying to exclude path "svn://myserver/project1/excludedir/." your node should be "/project1/excludedir/.". |
| Path separators are not characters Path separators are not compared as characters, but rather as separations between path elements. The separators "\", "/" and the .Net System.IO.Path.DirectorySeparatorChar are all treated interchangably. This means that the patterns "/Kunigunda/Sources/Test.cs" and "\Kunigunda\Sources\Test.cs" both match the file named "Test.cs" in the folder named "Sources" under the folder named "Kunigunda". |
| StarTeam needs the full path With StarTeam, use the entire file path as recognized by StarTeam, such as what is displayed when clicking File/Properties/Working File within StarTeam. Examples: c:\project\module1\** c:\project\module2\**\filethatdoesntaffectbuild.txt |
 | Automatically Generated Documentation generated on Tuesday, 15 Dec 2009 at 2:48:11 AM |
