Bumping to 5.2.0

Author: Craigacp

README-Configuration.md

@@ -4,9 +4,10 @@ The OLCUT Configuration System uses runtime dependency-injection to instantiate
 configurable components on the fly based on the contents of your configuration
 file.  It allows you to both specify the parameters ("properties") that should
 be given to the components at initialization time as well as which types of
-objects should actually be instantiated for each component.  It uses an XML
-file to describe the configuration. OLCUT uses Java Annotations extensively
-to facilitate code integration.
+objects should actually be instantiated for each component.  By default it uses
+an XML file to describe the configuration, though edn, json and protobuf
+formats are available. OLCUT uses Java Annotations extensively to facilitate
+code integration.
 
 
 ## Basic Configuration / Initialization
@@ -123,7 +124,9 @@ The supported list of annotated field types are:
     * `double`, `Double`
     * `String`
 * Primitive array types
+    * `boolean[]`
     * `byte[]`
+    * `char[]`
     * `short[]`
     * `int[]`
     * `long[]`
@@ -352,3 +355,6 @@ list of fully qualified class names which implement `FileFormatFactory`. For exa
 
 will insert the JsonConfigFactory into the configuration manager before the
 configuration is loaded.
+
+Support for protobuf config formats was added in OLCUT 5.2.
+

README.md

@@ -23,12 +23,12 @@ Maven:
 <dependency>
     <groupId>com.oracle.labs.olcut</groupId>
     <artifactId>olcut-core</artifactId>
-    <version>5.1.6</version>
+    <version>5.2.0</version>
 </dependency>
 ```
 or from Gradle:
 ```groovy
-implementation 'com.oracle.labs.olcut:olcut-core:5.1.6'
+implementation 'com.oracle.labs.olcut:olcut-core:5.2.0'
 ```
 
 The `olcut-extras` artifact is designed as a small tool for developers, as such you should compile the appropriate 
@@ -37,12 +37,13 @@ version based on your needs.
 ## Configuration System
 
 The OLCUT [Configuration System](README-Configuration.md) uses runtime
-dependency-injection to instantiate configurable components on the fly based on 
-the contents of your configuration file.  It allows you to both specify the parameters
-("properties") that should be given to the components at initialization time as well
-as which types of objects should actually be instantiated for each component.  It
-uses an XML file to describe the configuration. OLCUT uses Java Annotations extensively
-to facilitate code integration.
+dependency-injection to instantiate configurable components on the fly based on
+the contents of your configuration file.  It allows you to both specify the
+parameters ("properties") that should be given to the components at
+initialization time as well as which types of objects should actually be
+instantiated for each component. By default it uses an XML file to describe the
+configuration, though edn, json and protobuf formats are available. OLCUT uses
+Java Annotations extensively to facilitate code integration.
 
 ```xml
     <config>
@@ -90,7 +91,7 @@ the appropriate fields.
 
 This is just a small sample of what the Configuration system can do. It
 supports **inheritance**, many configurable types, **command line overrides**, self-description,
-and multiple file formats including **JSON**.
+and multiple file formats including **JSON**, **edn**, and **protobuf**.
 
 Read all about the [Configuration System](README-Configuration.md).
 
@@ -196,12 +197,12 @@ Read more about the [Command Interpreter](README-Commands.md).
 
 ## Provenance
 
-OLCUT provides a system for extracting the state of configurable objects into 
-immutable Provenance objects used to record the state of a computation. It's heavily
-used in [Tribuo](https://tribuo.org) to record a trainer and dataset configuration.
-It can optionally include
-non-configurable state. It supports conversion to a marshalled format which can be
-easily serialised and deserialised from JSON or protobuf.
+OLCUT provides a system for extracting the state of configurable objects into
+immutable Provenance objects used to record the state of a computation. It's
+heavily used in [Tribuo](https://tribuo.org) to record a trainer and dataset
+configuration.  It can optionally include non-configurable state. It supports
+conversion to a marshalled format which can be easily serialised and
+deserialised from JSON, xml or protobuf.
 
 Provenance objects can be converted back into a list of configurations, which can be 
 used to recreate the config file that generated that provenance. This can be used

THIRD_PARTY_LICENSES.txt

@@ -1,4 +1,4 @@
-jline 3.19.0
+jline 3.20.0
 
 Copyright (c) 2002-2018, the original author or authors.
 All rights reserved.
@@ -35,7 +35,7 @@ LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
 IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 OF THE POSSIBILITY OF SUCH DAMAGE.
 
-jackson-core, jackson-databind 2.12.2
+jackson-core, jackson-databind 2.12.5
 
 
                                  Apache License
@@ -242,7 +242,7 @@ jackson-core, jackson-databind 2.12.2
 
 junit 5.7.1
 
-Copyright 2015-2020 the original author or authors.
+Copyright 2015-2021 the original author or authors.
 
 Eclipse Public License - v 2.0
 ==============================
@@ -576,3 +576,37 @@ this Agreement will bring a legal action under this Agreement more than
 one year after the cause of action arose. Each party waives its rights to
 a jury trial in any resulting litigation.
 
+protobuf-java 3.17.3
+
+Copyright 2008 Google Inc.  All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following disclaimer
+in the documentation and/or other materials provided with the
+distribution.
+    * Neither the name of Google Inc. nor the names of its
+contributors may be used to endorse or promote products derived from
+this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Code generated by the Protocol Buffer compiler is owned by the owner
+of the input file used when generating it.  This code is not
+standalone and requires a support library to be linked with it.  This
+support library is itself covered by the above license.

pom.xml

@@ -35,7 +35,7 @@
     <version>${revision}</version>
     <packaging>pom</packaging>
     <properties>
-        <revision>5.2.0-SNAPSHOT</revision>
+        <revision>5.2.0</revision>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <maven.compiler.source>1.8</maven.compiler.source>
         <maven.compiler.target>1.8</maven.compiler.target>