ConfNG

Add Dependency

dependencies {
    implementation 'org.confng:confng:1.0.1'
}

<dependency>
    <groupId>org.confng</groupId>
    <artifactId>confng</artifactId>
    <version>1.0.1</version>
</dependency>

Define Configuration Keys

import org.confng.api.ConfNGKey;

public enum TestConfig implements ConfNGKey {
    BROWSER("browser", "chrome"),
    BASE_URL("base.url", "http://localhost:8080"),
    TIMEOUT("timeout", "30"),
    HEADLESS("headless", "false");
    
    private final String key;
    private final String defaultValue;
    
    TestConfig(String key, String defaultValue) {
        this.key = key;
        this.defaultValue = defaultValue;
    }
    
    @Override
    public String getKey() {
        return key;
    }
    
    @Override
    public String getDefaultValue() {
        return defaultValue;
    }
}

Load Configuration Sources

import org.confng.ConfNG;

public class TestConfig {
    static {
        // Built for TestNG projects, extensible for other Java applications
        // TestNG parameters are automatically injected when TestNG is present
        
        // Load configuration files (optional - skipped if not found)
        ConfNG.loadProperties("test.properties");
        ConfNG.loadJson("config.json");
        
        // Add custom sources if needed
        ConfNG.registerSource(new CustomConfigSource());
    }
}

Use in TestNG Tests

// Primary use case: TestNG test projects

@Test
public void testWebApplication() {
    // TestNG parameters from testng.xml are automatically available!
    // No listener registration or manual setup required
    
    // Get configuration values with type safety
    String browser = ConfNG.get(TestConfig.BROWSER);     // From testng.xml or other sources
    String baseUrl = ConfNG.get(TestConfig.BASE_URL);    // From testng.xml or other sources
    Integer timeout = ConfNG.getInt(TestConfig.TIMEOUT); // From testng.xml or other sources
    Boolean headless = ConfNG.getBoolean(TestConfig.HEADLESS);
    
    // Use configuration in your tests
    WebDriver driver = createDriver(browser, headless);
    driver.manage().timeouts().implicitlyWait(timeout, TimeUnit.SECONDS);
    driver.get(baseUrl);
}

// Also works in other Java applications
public class DatabaseService {
    public void connect() {
        String dbUrl = ConfNG.get(AppConfig.DATABASE_URL);
        String apiKey = ConfNG.get(AppConfig.API_KEY);
        // Your application logic...
    }
}

TestNG-First with Extensible Support

ConfNG is built for TestNG projects with extensible support for other Java applications:

• ✅ TestNG-First: Designed specifically for TestNG test projects
• ✅ Automatic Detection: Detects TestNG on classpath and activates features
• ✅ Zero Configuration: Registers parameter injection listener via service loader
• ✅ Parameter Capture: Captures all testng.xml parameters (suite, test, method levels)
• ✅ Smart Precedence: Handles parameter precedence (method > test > suite)
• ✅ Thread-Safe: Concurrent test execution support
• ✅ Extensible: Can be used in other Java applications when needed

Built for TestNG, extensible for more!