bjoern: Skill for Claude Code

Bjoern Gradle Plugin Configuration

Plugin Setup

Finding the Latest Version

IMPORTANT: Always use the latest Bjoern version. Check these sources:

1. Gradle Plugin Portal: https://plugins.gradle.org/plugin/de.mehtrick.bjoern.gradle-plugin
2. Maven Central: https://search.maven.org/artifact/de.mehtrick/bjoern-gradle-plugin
3. GitHub Releases: https://github.com/Mehtrick/bjoern/releases
4. Project version.config: Check the bjoernversion property in the Bjoern repository

To find the latest version programmatically:

# Check Gradle Plugin Portal
curl -s https://plugins.gradle.org/plugin/de.mehtrick.bjoern.gradle-plugin | grep -o 'version "[^"]*"' | head -1

# Or visit the plugin portal URL directly

Apply the Plugin

Replace LATEST_VERSION with the actual version from the sources above:

plugins {
    id "de.mehtrick.bjoern.gradle-plugin" version "LATEST_VERSION"
}

apply plugin: 'de.mehtrick.bjoern.gradle-plugin'

Example with a specific version (check for updates!):

plugins {
    id "de.mehtrick.bjoern.gradle-plugin" version "1.3.3" // Check for latest!
}

Required Dependencies

dependencies {
    // For JUnit 5 (default)
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.2'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.10.2'
    
    // OR for JUnit 4
    testImplementation 'junit:junit:4.13.2'
    
    // Recommended assertion library
    testImplementation 'org.assertj:assertj-core:3.27.7'
}

Gradle Version Requirement

Minimum: Gradle > 7.6.2 (due to Jackson dependency bug) Recommended: Gradle 8.x

Configuration Block

All configuration is done in the bjoern block:

bjoern {
    // Required parameters
    folder = "${projectDir}/src/test/resources"
    pckg = "com.example.tests"
    gendir = "${projectDir}/src/gen/bjoern"
    
    // Optional parameters
    extendedTestClass = "com.example.AbstractBjoernTest"
    docdir = "${projectDir}/src/gen/bjoern/docs"
    template = "/custom-template.ftlh"
    templateFolder = "${projectDir}/src/main/resources/templates"
    docExtension = "adoc"
    junitVersion = "5"
    encoding = "UTF-8"
    specRecursive = true
    gitHistory = false
}