Rocana Configuration

A JSON-like configuration format that doesn't require quoting key names in dictionaries and supports richer types including floats, doubles, data sizes, and durations.

License	The Apache License, Version 2.0
Categories	Configuration Application Layer Libs config
GroupId	com.rocana
ArtifactId	rocana-configuration
Last Version	1.2.0
Release Date	May 20, 2016
Type	jar
Description	Rocana Configuration A JSON-like configuration format that doesn't require quoting key names in dictionaries and supports richer types including floats, doubles, data sizes, and durations.
Project URL	https://github.com/scalingdata/rocana-configuration
Source Code Management	https://github.com/scalingdata/rocana-configuration

Download rocana-configuration

Filename	Size
rocana-configuration-1.2.0.pom
rocana-configuration-1.2.0.jar	70 KB
rocana-configuration-1.2.0-sources.jar	30 KB
rocana-configuration-1.2.0-javadoc.jar	277 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.rocana/rocana-configuration/ -->
<dependency>
    <groupId>com.rocana</groupId>
    <artifactId>rocana-configuration</artifactId>
    <version>1.2.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.rocana/rocana-configuration/
implementation 'com.rocana:rocana-configuration:1.2.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.rocana/rocana-configuration/
implementation ("com.rocana:rocana-configuration:1.2.0")

Apache Buildr

'com.rocana:rocana-configuration:jar:1.2.0'

Apache Ivy

<dependency org="com.rocana" name="rocana-configuration" rev="1.2.0">
  <artifact name="rocana-configuration" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.rocana', module='rocana-configuration', version='1.2.0')
)

Scala SBT

libraryDependencies += "com.rocana" % "rocana-configuration" % "1.2.0"

Leiningen

[com.rocana/rocana-configuration "1.2.0"]

Dependencies

compile (5)

Group / Artifact	Type	Version
com.google.guava : guava	jar	15.0
org.antlr : antlr4	jar	4.5
org.slf4j : slf4j-api	jar	1.7.5
org.apache.commons : commons-lang3	jar	3.0
joda-time : joda-time	jar	2.3

test (2)

Group / Artifact	Type	Version
junit : junit	jar	4.11
org.slf4j : slf4j-log4j12	jar	1.7.5

Project Modules

There are no modules declared in this project.

Rocana Configuration

rocana-configuration is a JSON-like configuration format intended to be handled by humans. Some of the additional functionality includes:

• Comments
• Dictionary keys without quotes
• Rich data types such as floats, doubles, data sizes, and durations
• Java API for marshalling configuration files to types

Examples

Currently, examples come in the form of unit tests.

• Example complex Java types in src/test/java/com/rocana/configuration
• Tests for reading Configurations into Java types in TestConfigurationParser
• Configurations examples for TestConfigurationParser in src/test/resources/conf

Comparison with JSON

JSON is a great data interchange format, but is often used as a configuration format. JSON can be tedious to modify by hand because of required quoting for both keys and values.

Comparison with Java Properties

Java Properties files are the de-facto standard for configuration in Java projects. However, they lack a few features that would improve editing by hand:

• Nested data structures
• Non-string keys and values
• Arrays

Rocana

Versions

Version
1.2.0 May 20, 2016
1.2.0-rc2 May 19, 2016
1.2.0-rc1 May 19, 2016