findpath ‘;’ REGEX ( ‘;’ REPLACE )?

Find bundle resources by full path with optional regex replacement

Summary

The findpath macro finds resources in the current bundle by matching full resource paths against a regular expression, with optional replacement to transform the results.

Syntax

${findpath[;<regex>[;<replacement>]]}

Parameters

regex (optional) - Regular expression to match full paths (default: “.*” matches all)
replacement (optional) - Replacement pattern using regex groups (e.g., “$1”)

Behavior

Searches bundle resources by full path
Matches entire path against regex pattern
Optionally applies replacement to matched paths
Returns comma-separated list of results

Examples

Find all resources:

${findpath}
# Returns full paths of all resources

Find by path pattern:

${findpath;META-INF/.*\.xml}
# Returns XML files (full path) in META-INF/

Extract path components:

${findpath;com/example/(.*)/.*\.class;$1}
# Returns middle package component

Find and transform:

${findpath;src/(.*)\.java;$1}
# Returns paths without src/ prefix and .java extension

Use Cases

Resource discovery by path
Full path pattern matching
Path transformation
Bundle content analysis
Package structure extraction

Notes

Matches full resource path, not just filename
Uses Java regex syntax
See also: ${findname} for filename-only matching
See also: ${lsr} for file system searches

See test cases in MacroTestsForDocsExamples.java

findpath ';' REGEX ( ';' REPLACE )?