Iris

Iris is a simple and easy config format, parser and API for Java.

Iris was designed to be very simple and easy to understand. Look at the examples below and you will see that it is really cool and neat.

You can view the junit code coverage here.

Features

• readable
• comments
• defaults
• easy to use
• lightweight
• fast

Installation

Maven:

• Install Maven 3
• Clone/Download this repo
• Install it with: mvn clean install

<dependency>
    <groupId>de.progme</groupId>
    <artifactId>iris</artifactId>
    <version>1.2.0-SNAPSHOT</version>
</dependency>

Jar library:

Simply download the jar from a [release](https://github.com/Marvin Erkes/Iris/releases) and include it in your project.

Config format

Config file config.cop:

# Comment support
global:
    connections 200

timeout:
	connect 5000
    client 50000
    server 50000

server:
    bind 0.0.0.0 80

Examples

General example:

try {
	// Create a config from a config file
	IrisConfig iris = Iris.from("config.cop").build();

	// Check if the header and the key is available
	if (iris.hasHeaderAndKey("global", "max-con")) {
		Key maxCon = iris.getHeader("global").getKey("max-con");
		if (maxCon.hasValues()) {
			System.out.println("Max connections: " + maxCon.getValue(0).asInt());
			// Works the same
			//System.out.println("Max connections: " + maxCon.nextInt());
		}
	}

	// Check if the header exists
	if (iris.hasHeader("timeout")) {
		Header timeoutHeader = iris.getHeader("timeout");

		Key connectKey = timeoutHeader.getKey("connect");
		if (connectKey.hasValues()) {
			System.out.println("Timeout connect: " + connectKey.getValue(0));
		}

		Key clientKey = timeoutHeader.getKey("client");
		if (clientKey.hasValues()) {
			System.out.println("Timeout client: " + clientKey.getValue(0));
		}

		Key serverKey = timeoutHeader.getKey("server");
		if (serverKey.hasValues()) {
			System.out.println("Timeout server: " + serverKey.getValue(0));
		}
	}

	// Check if the header and the key is available
	if (iris.hasHeaderAndKey("server", "bind")) {
		Key bindKey = iris.getHeader("server").getKey("bind");
		// Check if the key has values
		if (bindKey.hasValues()) {
			String host = bindKey.getValue(0).asString();
			int port = bindKey.getValue(1).asInt();
			// Works the same
			//String host = bindKey.nextString();
			//int port = bindKey.nextInt();

			System.out.println("Host: " + host);
			System.out.println("Port: " + port);
		}
	}
} catch (IrisException e) {
	e.printStackTrace();
}

Defaults:

Defaults are working all the same. Of course you can set multiple key defaults in one header if you call the "def" method multiple times with the same header but a different key.

global:
    connections 200

# You want to have a default for the missing "server" header

try {
    // Create the iris and add the default header
	IrisConfig iris = Iris.from("config.cop")
			.def(new Header("server"), new Key("bind"), new Value("0.0.0.0"), new Value("8080"))
			//.def(new Header("server"), new Key("another-key"), new Value("value"))
			.build();

	// No need to check if the header or key exists
	// because we have the default values
	Key bindKey = iris.getHeader("server").getKey("bind");
	
	String host = bindKey.getValue(0).asString();
	int port = bindKey.getValue(1).asInt();
    // Works the same
    //String host = bindKey.nextString();
    //int port = bindKey.nextInt();

	System.out.println("Host: " + host);
	System.out.println("Port: " + port);
} catch (IrisException e) {
	e.printStackTrace();
}

License

Licensed under the GNU General Public License, Version 3.0.