CompletableFutureU

CompletableFutureU is a lightweight utility library built around the Java 8 CompletableFuture API. Its primary goal is to simplify common asynchronous programming patterns, providing convenient methods for composition, error handling, and time‑bounded execution. The library is distributed under the permissive Apache 2.0 license and can be added to a project via Maven Central or Gradle.

Core features include higher‑level combinators such as zip and fold, which allow developers to aggregate multiple futures and process results as a single entity. An error‑propagation wrapper automatically logs exceptions and propagates failures to downstream consumers, reducing boilerplate try‑catch blocks. The library also exposes a timeout helper that converts a CompletableFuture into a new future which completes exceptionally if a specified duration elapses, aiding in the implementation of safety‑critical workflows.

CompletableFutureU is designed for integration rather than replacement. It adheres to the standard CompletableFuture semantics, accepting any supplied Executor. Users can supply their own thread pool or rely on the common ForkJoinPool. Because the library does not modify the underlying API, existing codebases can adopt it incrementally without significant refactoring.

The project’s source code is hosted on GitHub, with a continuous integration pipeline that runs unit tests against multiple Java versions (8 through 17). Documentation is generated by javadoc and includes examples demonstrating typical usage scenarios such as concurrent database queries, HTTP client streams, and batched computation pipelines. Community contributions are encouraged, and the issue tracker is used to manage feature requests and bug reports.