jacoco/jacoco
Jacoco
JaCoCo ist ein Java-Code-Coverage-Tool und Bytecode-Instrumentierer, der misst, welche Teile des Quellcodes während Tests ausgeführt werden. Er fungiert als Runtime-Agent zur Überwachung der Anwendungsausführung im laufenden Betrieb oder als Bibliothek für Offline-Bytecode-Instrumentierung, wodurch er Ausführungsdaten in Umgebungen erfassen kann, in denen Runtime-Agenten eingeschränkt sind.
Das Projekt zeichnet sich dadurch aus, dass es sowohl dynamische als auch statische Instrumentierungspfade zur Verfolgung der Ausführung bietet. Es enthält einen Runtime-Agenten für die Überwachung im laufenden Betrieb und die Möglichkeit, kompilierte Klassendateien vor der Ausführung zu modifizieren. Es ermöglicht zudem das Abrufen von Ausführungsmetriken aus laufenden Prozessen über Remote-Netzwerkverbindungen, ohne die aktive Anwendung zu unterbrechen.
Das System berechnet quantitative Coverage-Metriken über Anweisungen, Zweige, Zeilen, Methoden und Klassen hinweg, neben Messungen der zyklomatischen Komplexität. Es bietet Funktionen zum Zusammenführen von Daten aus mehreren Testläufen, zur Durchsetzung von Coverage-Schwellenwerten innerhalb von CI/CD-Quality-Gates und zur Generierung von Berichten, die ausgeführten Bytecode auf den Quellcode zurückführen. Eine visuelle Integration ist verfügbar, um diese Ergebnisse direkt in Code-Editoren anzuzeigen.
Das Tool lässt sich in Build-Automatisierungssysteme und Befehlszeilenschnittstellen integrieren, um die Datenerfassung und Berichterstellung zu automatisieren.
Features
- Code Coverage Analysis - Measures the extent to which Java source code is executed by a test suite to identify untested logic.
- Java Agents - Functions as a Java agent that monitors application execution on the fly to record coverage data.
- Code Quality Analysis Tools - Calculates cyclomatic complexity and enforces coverage thresholds to maintain software quality standards.
- Execution Tracking - Records which specific bytecode instructions and branches are executed during a test run using boolean markers.
- Bytecode-to-Source Mapping - Links executed bytecode instructions back to original source code lines and methods for report generation.
- Bytecode Instrumentation Agents - Implements bytecode instrumentation agents to inject tracking probes into compiled Java classes at runtime.
- Class Definition Hashing - Assigns a unique hash to raw class definitions to distinguish between different versions of the same class.
- Offline Bytecode Instrumentation - Modifies compiled class files before execution to enable coverage tracking in environments that prohibit runtime agents.
- Runtime Bytecode Instrumentation - Injects tracking logic into class files during execution via a Java agent to monitor runtime behavior.
- Branch Coverage Tracking - Analyzes decision statements to determine the number of executed or missed paths in the code.
- Java Instrumentation Frameworks - Provides a framework for injecting tracking probes into Java class files via runtime or offline instrumentation.
- Runtime Bytecode Instrumentation - Injects tracking probes into class files at runtime using a Java agent to monitor execution paths.
- Execution Coverage Metrics - Tracks whether at least one instruction in a method or one method in a class has been executed.
- Class Version Hashes - Assigns unique identifiers to class definitions to ensure execution data matches the correct version of the source code.
- Code Coverage Tools - Instruments bytecode to measure the percentage of Java source code executed during automated tests.
- Threshold Enforcements - Implements validation mechanisms that fail the build process if coverage percentages fall below a predefined minimum.
- Instrumentation Filters - Provides rules to include or exclude specific packages and classes from instrumentation to limit data collection.
- Runtime Metrics Extraction - Enables retrieval of execution metrics from running processes via remote network connections without interrupting the application.
- Large-Scale Codebase Analysis - Uses streaming patterns and depth-first traversals to analyze large projects with thousands of classes while maintaining low memory overhead.
- Build Tool Integrations - Provides native extensions and tasks to integrate coverage data collection into build automation systems.
- Remote Execution Data Extraction - Transmits execution metrics from a running process to an external collector via a dedicated network protocol.
- Cyclomatic Complexity Analyzers - Computes the minimum number of paths through a method to determine the test cases required for full coverage.
- Coverage Threshold Validation - Enforces minimum code coverage thresholds during the build process to ensure software meets quality standards.
- Quality Gates - Integrates with CI/CD pipelines to block code progression if specific coverage quality gates are not met.
- Visual Coverage Mapping - Displays execution data directly within code editors using visual highlights and gutter decorations.
- Report Generators - Transforms raw binary execution data into human-readable reports to identify untested sections of the application.
- Code Coverage Reportings - Compares execution metrics against source code to generate reports identifying untested lines and branches.
- Test-Frameworks - Java code coverage library.
