Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bowbahdoe/guava

Most of com.google.common repackaged and modularized
https://github.com/bowbahdoe/guava

Last synced: 7 days ago
JSON representation

Most of com.google.common repackaged and modularized

Awesome Lists containing this project

README 

        
# guava



## Usage



For the most part, you should be able to just find+replace all

references to `com.google.common` with `dev.mccue.guava`.



Consult the [original documentation](https://github.com/google/guava) for

in-depth usage guides.



```xml



    dev.mccue

    guava

    33.2.0



```



## What



This module is a soft-fork of [Guava](https://github.com/google/guava) which



* Is shaded under `dev.mccue.guava`

* Has a proper `module-info.java`

* Has all usages of `sun.misc.*`, The Security Manager, and `finalize()` removed.



The work of shading is done by [this project](https://github.com/bowbahdoe/guava-generator). Releases of this and dependent modules should contain the guava release or commit hash from which they are generated.



This is an aggregator module and each package of guava has been split into submodules which can be found here



* [dev.mccue.guava.base](https://github.com/bowbahdoe/guava-base)

* [dev.mccue.guava.primitives](https://github.com/bowbahdoe/guava-primitives)

* [dev.mccue.guava.escape](https://github.com/bowbahdoe/guava-escape)

* [dev.mccue.guava.math](https://github.com/bowbahdoe/guava-math)

* [dev.mccue.guava.collect](https://github.com/bowbahdoe/guava-collect)

* [dev.mccue.guava.xml](https://github.com/bowbahdoe/guava-xml)

* [dev.mccue.guava.html](https://github.com/bowbahdoe/guava-html)

* [dev.mccue.guava.graph](https://github.com/bowbahdoe/guava-graph)

* [dev.mccue.guava.hash](https://github.com/bowbahdoe/guava-hash)

* [dev.mccue.guava.io](https://github.com/bowbahdoe/guava-io)

* [dev.mccue.guava.net](https://github.com/bowbahdoe/guava-net)

* [dev.mccue.guava.reflect](https://github.com/bowbahdoe/guava-reflect)

* [dev.mccue.guava.concurrent](https://github.com/bowbahdoe/guava-concurrent)



## Why



* It [doesn't seem like guava will be modularized any time soon](https://github.com/google/guava/issues/2970#issuecomment-1572148291)

* I want to enable more libraries to be fully modular so that the `jlink`

workflow is more viable

* This was fun to do, and it seems as if some people are interested in the results.



## Support



I'll try to keep up to date, but if you 



* Notice something wrong

* Want me to make a release for a new version

* Want a minute of my time



Feel free to reach out. 



## Changes made from Guava



* Everything is shaded under `dev.mccue.guava`

    * `com.google.common.util.concurrent` is turned into `dev.mccue.guava.concurrent`, dropping the `util`

* All usages of `sun.misc.Unsafe` are removed

    * The unsafe implementation is removed, leaving a safe fallback in `LittleEndianByteArray`, `AbstractFuture`, and `UnsignedBytes`

    * The unsafe implementation in is replaced with a new one based on `VarHandle`s in `Striped64`

* All usages of `sun.misc.JavaLangAccess` are removed

    * Replaced with `Throwable.getStackTrace` in `Throwables`

* All usages of `finalize()` are removed

    * `FileBackedOutputStream` has a constructor which takes a boolean to indicate that resources should be freed on finalization. This was made private and the logic was removed.

* All usages of the Security Manager are removed

    * `Types` catches an `AccessControlException` and that could safely be replaced with catching an `Exception`

    * Explicit uses of the security manager in `LittleEndianByteArray`, `AbstractFuture`, `UnsignedBytes`,  and `Striped64` were removed along with the code to load `sun.misc.Unsafe`.

* All usages of `java.util.logging.Logger` were replaced with `java.lang.System.Logger`

    * With this change, the only JDK module depended on is `java.base`.

* All usages of `javax.annotation.*` classes from `com.google.code.findbugs/jsr305` are replaced with equivalent classes from `dev.mccue/jsr305`

* `FinalizableReferenceQueue` and associated classes were removed

    * They were rarely used, probably do a job better done by a `Cleaner`, and I wasn't able to validate that they would behave correctly in a module

* Annotation modules are used via `requires static` and are not carried over to dependents.

* All annotation usages from `com.google.common.annotations` and `com.google.j2objc.annotations` have been removed

* Split into multiple submodules, each with their own `module-info.java`

* Drops explicit support for GWT, j2objc, j2cl, etc.

* Drops explicit support for android (equivalent to the `-jre` build)

* Does not include

  * `com.google.common.eventbus` (Guava docs explicitly recommends against its use)

  * `com.google.common.cache` ([Caffiene](https://github.com/ben-manes/caffeine) covers that use.)

  * `com.google.common.annotations` (Only `@Beta` and `@VisibleForTesting` would be relevant without GWT+etc. testing, and you can make your own pretty easily.)

* Compiled for Java 9+, not Java 8