JakeWharton/hugo
Hugo
Hugo is an annotation-based debugging tool and Java method logging library. It functions as a method execution tracker that records method arguments, return values, and execution durations during application runtime.
The project differentiates itself by using annotation-driven instrumentation and bytecode-level aspect injection to capture telemetry without requiring manual print statements. It employs post-compilation bytecode manipulation and aspect-oriented wrapping to insert interception logic around annotated method boundaries.
The library covers observability and monitoring capabilities, including the identification of performance bottlenecks through execution time measurements and the tracking of runtime execution flow. It also includes a global mechanism to toggle the emission of logs while the application is running.
Features
- Annotation-Based Debugging Tools - Captures runtime method execution data through simple annotations to simplify troubleshooting and analysis.
- Method Execution Trackers - Measures the duration and output of specific Java methods during application runtime.
- Annotation-Driven Instrumentation - Provides automatic tracking of method arguments, return values, and execution time via Java annotations.
- Method Logging Libraries - Records method arguments, return values, and execution times using annotations for debug builds.
- Bytecode Manipulation - Uses bytecode manipulation to insert interception logic into existing class files after compilation.
- AOP Execution Wrapping - Implements proxy-like wrapping of target methods to capture execution telemetry before and after calls.
- Method Call Verification - Captures method arguments and return values during runtime to validate execution flow for debugging.
- Method Execution Tracking - Monitors which methods are triggered and the data they process while the application is running.
- Method Performance Profiling - Measures the execution time of individual method calls to identify slow parts of the code.
- Build-Time Bytecode Transformers - Modifies compiled class files during the build process to inject logging logic into method boundaries.
- Instrumented Builds - Integrates detailed execution monitors into development build variants to avoid manual print statements.
- Global Debug Toggles - Provides a global switch to enable or disable debug log emission without restarting the application.
- Logging Control Utilities - Provides utilities to enable or disable the generation of method call logs at runtime.
- Logging Utilities - Annotation-triggered method call logging.
- Testing and Debugging Tools - Annotation-based logging for method calls during debugging.
