elderresearch / commons-jvm

A "toolbox" of langauge extensions and utilities for JVM-based languages

ERI Commons - Language Extensions

A "toolbox" of language extensions and utilities for JVM-based languages, like Java. Supports Java 8 and Java 11.

Maven

You can install this library from Jipack.io. Add the following repository to your POM:

<repositories>
   <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
   </repository>
</repositories>

And then the following dependency:

<dependency>
	<groupId>com.elderresearch.commons-jvm</groupId>
	<artifactId>commons-jvm</artifactId>
	<version>2.5.0</version>
</dependency>

for Java 11+ or

<dependency>
	<groupId>com.elderresearch.commons-jvm</groupId>
	<artifactId>commons-jvm-java8</artifactId>
	<version>2.5.0</version>
</dependency>

for Java 8.

Dependencies

This sends the following transitive dependencies:

• Apache Commons Lang and Commons Text
• jOOλ
• Guava
• Jackson with YAML support
• Log4j2

Overview

Some of the utilities in this project include:

• Config, YAMLConfig, and EnvironmentTree: Powerful configuration that supports a configuration bean via YAML (or any other supported Jackson format) with environment (environment variable and/or system property) overrides.
• DaemonWorker: An easy to use wrapper around a daemon thread and a blocking queue for multithreaded, queueable tasks.
• @Documentation: Annotation to facilitate code generation and documentation of system components that can be reflected at runtime
• NumberExtractor and DateExtractor: General-purpose/robust number and date parser/extractor that uses all localized formats available to the JVM to extract values from text.
• IteratorCloseable, IteratorMultithreaded, and IteratorWithSize: Variants on the standard Iterator pattern offering deterministic progress, closeability, and parallelism.
• LambdaUtils: Utilities for using Java 8 lambdas
• ReflectionUtils: Wrapper around the Java reflection APIs, simplifying their use and absorbing exceptions.
• StatusMonitor/StatusListener: "Transactional" status API for long-running tasks. You can set the task state, progress, or message in atomic operations continually, but listeners will only be notified at fixed time intervals (or when certain state changes regardless of time). You can poll a status monitor to know if the user canceled the task.
• StopWatch: Enhanced/improved version of Apache's stop watch functionality
• StringMatcher: Utility for programmatically matching strings using starts with, ends with, contains, equals, regular expressions, and ignore case.
• UnicodeChars: Constant declarations of most unicode characters

Contribution

We welcome pull requests and issues!

commons-jvm's Issues

EnvironmentTree's `normalizePath` method doesn't handle numbers as expected

example: MYPREFIX_X1_Y2="test" would not override

x1:
  y2: "I want to change this string to test with my environment variable"

Configuration doesn't fall back to current directory if file isn't found.

The configuration file is looked up relative to the jar file, which is great for execution, but for local testing or running within an IDE, this leads to wild file paths. It would be great to check the jar path, then the current directory, then fall back on defaults if it isn't found in either location.