Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stefan-zobel/minifuture
A CompletableFuture backport reduced to the essentials
https://github.com/stefan-zobel/minifuture
android completablefuture java-6 java-7 jep-266
Last synced: about 2 months ago
JSON representation
A CompletableFuture backport reduced to the essentials
- Host: GitHub
- URL: https://github.com/stefan-zobel/minifuture
- Owner: stefan-zobel
- Created: 2021-11-01T12:12:33.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2023-03-18T12:29:39.000Z (almost 2 years ago)
- Last Synced: 2023-07-28T14:40:45.835Z (over 1 year ago)
- Topics: android, completablefuture, java-6, java-7, jep-266
- Language: Java
- Homepage:
- Size: 189 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://github.com/stefan-zobel/minifuture/actions/workflows/codeql.yml)
[](https://maven-badges.herokuapp.com/maven-central/net.sourceforge.streamsupport/streamsupport-minifuture)
[](https://javadoc.io/doc/net.sourceforge.streamsupport/streamsupport-minifuture)
# minifuture
A stripped to the bones `CompletableFuture` backport for Java 6+ and Android (API level 14+).
This is a minimized (105 KiB) version of the [streamsupport-cfuture](https://javadoc.io/doc/net.sourceforge.streamsupport/streamsupport-cfuture/latest/index.html) component without any dependencies that provides only CompletableFuture and the API necessary to use it and nothing else (no Streams, no ForkJoinPool and such). It is intended for projects that only have a need for a CompletableFuture backport and want minimal dependency footprint. The public API surface comprises the following interfaces / classes:
* java8.util.concurrent.CompletableFuture
* java8.util.concurrent.CompletionException
* java8.util.concurrent.CompletionStage
* java8.util.function.BiConsumer
* java8.util.function.BiFunction
* java8.util.function.Consumer
* java8.util.function.Function
* java8.util.function.Supplier
The CompletableFuture API is the one from Java 12, i.e. it contains the Java 9 ([JEP 266](https://openjdk.java.net/jeps/266)) enhancements and the exception handling methods introduced in Java 12 ([JDK-8211010](https://bugs.openjdk.java.net/browse/JDK-8211010)). The project can be compiled with Java 6 and should be compatible with any OpenJDK based JVM and Android versions starting from API level 14.
### build.gradle:
```gradle
dependencies {
implementation 'net.sourceforge.streamsupport:streamsupport-minifuture:1.7.4'
}
```
### Maven:
```xml
net.sourceforge.streamsupport
streamsupport-minifuture
1.7.4
```
## LICENSE
GNU General Public License, version 2, [with the Classpath Exception](https://github.com/stefan-zobel/minifuture/blob/master/GPL_ClasspathException) (and [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) for JSR-166 derived code)
### License clarification
* This library's latest-version includes 18 `*.java` files.
* 9 of said files are under [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) License
>Where said license allows you to use almost any sub-license you want.
* 9 other of said files are under [`GPL with Classpath license-exception`](./GPL_ClasspathException).
Where said "Classpath" license-exception allows your executables:
* "`to link this library`" (no matter if statically or dynamically),
* "`and to copy and distribute the resulting executable under terms of your
choice`",
* But those who re-distribute this library's source-code form, not "executable" binary, can only do that under the terms of GPL 2.0.
>In other words, some of our source-codes always remain GPL 2.0, but your executable can link to them statically and/or dynamically, which is far more permissive than LGPL and/or GPL.