unloggedio / unlogged-sdk

Unlogged SDK for recording code execution
https://unlogged.io
Apache License 2.0
152 stars 16 forks source link
assertions automated-testing debugging-tool java junit junit5 mocking mockito regression-testing test-automation

Record. Replay. Test.

Documentation · Bug Bounty · Maven · IntelliJ Plugin


Unlogged Java SDK

Unlogged Java SDK enabled recording of code execution in a binary format.

Replay these records using the Unlogged IntelliJ Plugin and generate junit test cases.

The recording is highly detailed and can be used to reconstruct the code execution from scratch. The binary format descriptions are available in Kaitai format here

Additional Screenshots

🎬 Direct Invoke Direct Invoke Java methods
🖥️ Replay Replay history of code execution
🎭 Mocking Mock downstream calls
🎯 Assertions Assertions in regression tests
🦠 JUnit Test case Generate junit test cases

Usage

  1. Include dependency

Maven

<dependencies>
    <dependency>
        <groupId>video.bug</groupId>
        <artifactId>unlogged-java-sdk</artifactId>
        <version>0.2.16</version>
    </dependency>
</dependencies>

Gradle

dependencies
{
    implementation 'video.bug:unlogged-sdk:0.2.16'
    annotationProcessor 'video.bug:unlogged-sdk:0.2.16'
}
  1. Add @Unlogged annotation to your application entry point
    public class Main {
    @Unlogged
    public static void main(String[] args) {
        // 
    }
    }

Disabling unlogged-sdk

It is highly recommended that you disable the unlogged-sdk when deploying for usage. unlogged-sdk is only targetted for local usage only.

Adding the unlogged-sdk adds probes to your code which emits events in a binary format. Adding the @Unlogged enabled to actual execution of those probes.

To disable at compile time

mvn package -Dunlogged.disable

or

./gradlew build -Dunlogged.disable

To disable at runtime (if not disabled at compile time)

@Unlogged(enable = false)

You can find the latest release version here: https://mvnrepository.com/artifact/video.bug/unlogged-sdk

Contributing

We welcome all contributions! There's many ways to contribute to the project, including but not limited to: