Disclaimer: This is not an official Google product.
Mug (Coverage)
A small Java 8+ string processing and streams library (javadoc), widely used in Google's internal Java codebase, with 0 deps (Proto, BigQuery, Guava addons are in separate artifacts).
- ✅
Substring– composable substring extraction & manipulation
→Substring.between("(", ")").from("call(foo)") → "foo" - ✅
StringFormat– compile-time-safe bidirectional parsing/formatting
→new StringFormat("/home/{user}/{date}").parse(filePath, (user, date) -> ...) - ✅
Parser– easier and faster than regex
→zeroOrMore(noneOf("\\'")).immediatelyBetween("'", "'").parse(input); - ✅
BiStream– streamsMapand pair-wise collections
→BiStream.zip(keys, values).toMap() - ✅
SafeSql– library-enforced safe, composable SQL template
→SafeSql.of("select id, `{col}` from Users where id = {id}", col, id)
More tools
DateTimeFormats– parse datetimes by example
→DateTimeFormatter format = formatOf("2024-03-14 10:00:00.123 America/New_York")Iteration- implement lazy stream with recursive codeBinarySearch- solve LeetCode binary search problems
→BinarySearch.inSortedArrayWithTolerance(doubleArray, 0.0001).find(target)StructuredConcurrency- simple structured concurrency on virtual threads
→concurrently(() -> fetchArm(), () -> fetchLeg(), (arm, leg) -> makeRobot(arm, leg))MoreStreams
→whileNotNull(queue::poll).filter(...).map(...)Optionals
→return optionally(obj.hasFoo(), obj::getFoo);
Installation
Add the following to pom.xml:
<dependency>
<groupId>com.google.mug</groupId>
<artifactId>mug</artifactId>
<version>9.9.2</version>
</dependency>
Add mug-errorprone to your annotationProcessorPaths:
<build>
<pluginManagement>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<annotationProcessorPaths>
<path>
<groupId>com.google.errorprone</groupId>
<artifactId>error_prone_core</artifactId>
<version>2.23.0</version>
</path>
<path>
<groupId>com.google.mug</groupId>
<artifactId>mug-errorprone</artifactId>
<version>9.9.2</version>
</path>
</annotationProcessorPaths>
</configuration>
</plugin>
</plugins>
</pluginManagement>
</build>
SafeSql (javadoc):
<dependency>
<groupId>com.google.mug</groupId>
<artifactId>mug-safesql</artifactId>
<version>9.9.2</version>
</dependency>
Dot Parse Combinators (javadoc):
<dependency>
<groupId>com.google.mug</groupId>
<artifactId>dot-parse</artifactId>
<version>9.9.2</version>
</dependency>
Protobuf utils (javadoc):
<dependency>
<groupId>com.google.mug</groupId>
<artifactId>mug-protobuf</artifactId>
<version>9.9.2</version>
</dependency>
Add to build.gradle:
implementation 'com.google.mug:mug:9.9.2'
implementation 'com.google.mug:mug-safesql:9.9.2'
implementation 'com.google.mug:dot-parse:9.9.2'
implementation 'com.google.mug:mug-guava:9.9.2'
implementation 'com.google.mug:mug-protobuf:9.9.2'