$ show jjohannes/understanding-gradle
This repository is an educational resource that accompanies the 'Understanding Gradle' video series. It contains a series of self-contained example Gradle projects, each demonstrating a specific concept of the Gradle build tool, from basic settings files to advanced topics like artifact transforms and Java module path. The examples are structured as independent projects with their own build configurations, often using composite builds and convention plugins to illustrate best practices. The code is well-crafted, following modern Gradle patterns (Kotlin DSL, lazy configuration, variant-aware dependency management). While not a production application, the repository serves as a reference implementation for Gradle best practices and provides reusable patterns for structuring real-world Gradle projects. The architecture is a collection of example projects, each with a my-build-logic directory containing reusable convention plugins, and a my-project directory demonstrating the concept. The examples cover the full spectrum of Gradle functionality, from settings files to CI integration.
The LLM identified 5 files worth highlighting for reuse:
A Gradle settings plugin that automatically discovers and includes subprojects and sibling builds by scanning the filesystem. It centralizes repository declarations and project structure, making it reusable across multiple builds. This pattern is essential for large-scale Gradle setups.
A custom Gradle task that generates a start script. It demonstrates proper use of @CacheableTask, @Input, @OutputFile annotations, and lazy properties. The task is self-contained and can be extracted into any Gradle project needing script generation.
A Gradle component metadata rule that adds capability information to SLF4J implementations, enabling Gradle to resolve capability conflicts (e.g., multiple logging backends). This is a non-trivial pattern for managing complex dependency ecosystems.
An artifact transform that converts non-modular JAR files into Java modules by injecting module-info.class. It demonstrates the Artifact Transform API, which is a powerful but rarely used Gradle feature for adapting third-party dependencies.
A Gradle plugin written in Java that configures common Java project settings (toolchain, test framework, encoding). It demonstrates how to write plugins using the Java API instead of Kotlin/Groovy DSL, which is useful for teams that prefer Java.