Recursive IncludeBuild

Recursively discovers nested included builds under one or more root directories and includes them as composite builds.

• Scans configured root directories after settings evaluation.
• Detects nested builds by looking for settings.gradle or settings.gradle.kts.
• Supports filtering candidate directories before they are included.

Usage

plugins {
    id 'com.helixframework.recursive-includebuild'
}

recursiveIncludeBuild {
    rootDir('external-builds')
}

plugins {
    id("com.helixframework.recursive-includebuild")
}

recursiveIncludeBuild {
    rootDir("external-builds")
}

Configuration

The plugin exposes the recursiveIncludeBuild extension.

Settings extension used to define where recursive included-build discovery should run.

• rootDirs (List, default: empty): Collection of root directories that should be scanned for nested builds.
• filter (Predicate): Optional Java Predicate used to reject candidate directories before includeBuild is called.
• rootDir(Object dir) (method): Adds a single root directory to the scan list.
• rootDirs(Object... dirs) (method): Adds multiple root directories to the scan list in one call.