Ant Parsing

Import/Include

<!-- Import: targets can override -->
<import file="common-build.xml"/>

<!-- Include: targets are prefixed with filename -->
<include file="shared/testing.xml"/>

Target Attributes

Dual Parser Strategy

XML Parser (Default)

• Fast regex-based extraction in AntParserService.parseWithXml()
• Follows <import> and <include> elements up to importDepth limit
• Circular import detection via visited paths set
• Cannot resolve Ant properties (${prop.name} stays as-is)

Java Parser (Optional)

• Uses Apache Ant 1.10.14 API via AntParser.java
• Full property resolution (system, file, built-in properties)
• Follows all imports regardless of depth
• Slower — requires JDK 11+ at runtime

Both parsers return identical structure:

interface AntBuildInfo {
    projectName: string;
    defaultTarget: string;
    baseDir: string;
    description: string | null;
    buildFile: string;
    targets: AntTarget[];
}

Adding Parser Support for New Elements

1. XML parser: Add regex pattern in parseXmlFile() within AntParserService.ts
2. Java parser: Update AntParser.java to extract the new data from Ant API
3. Types: Add field to AntBuildInfo or AntTarget in BOTH TypeScript and Java
4. Test: Verify both parsers return the same result for the same input file