Feature: Flexible Filtering for `ApplicationModules`

[xenoterracide]

Problem

ApplicationModules.of(…) factory methods are restrictive. Specifically:

• Naming Collisions: A DescribedPredicate sharing a name with the class blocks the import.
• Lack of Composition: Cannot apply multiple ImportOption filters (e.g., excluding tests AND fixtures) while using predicates.

Proposed Solution

Introduce a Builder or expanded Varargs support to match ArchUnit’s ClassFileImporter flexibility:

// Option A: Builder Pattern
ApplicationModules modules = ApplicationModules.builder(MyApplication.class)
    .withImportOption(ImportOption.Predefined.DO_NOT_INCLUDE_TESTS)
    .withExclusion(DescribedPredicate.resideInAPackage("..internal.."))
    .build();

// Option B: Importer Injection
ClassFileImporter importer = new ClassFileImporter()
    .withImportOption(new DontIncludeTests());
ApplicationModules modules = ApplicationModules.of(MyApplication.class, importer);

[odrotbohm]

ApplicationModules.of(…) factory methods are restrictive.

In what context? What are you actually trying to achieve?

[xenoterracide]

was generating documentation, and we had both test fixtures and tests., but it would appear that there's no option to filter tests. I seem to recall that one of the other builders that can be passed has closer functionality, but still didn't seem to allow more multiple import options for filtering tests/fixtures.