Logging

This library uses [SLF4J][1] but does not bundle an SLF4J implementation.

• Notebooks
• Scripts
  • simple-logger
• Projects
  • simple-logger

Notebooks

1. Set %logLevel <level> in a code cell, e.g., %logLevel debug.

Logs appear in the Kotlin Jupyter kernel logs:

• In Jupyter and JupyterLab, logs appear in the shell that owns the Jupyter process
• In IntelliJ, view logs in the Kotlin Notebook logs tool window

⚠️ Older versions of the Kotlin Jupyter kernel had issues with logging. Kernel version 0.15.0-598 and higher are known to work. In IntelliJ, configure to use a later version than bundled. In pip and conda, update the kernel package.

See the example notebook Logging.ipynb.

Scripts

1. Add an SLF4J implementation (e.g., slf4j-simple, logback-classic, etc.)
2. Set the log level for the package com.gabrielfeo.develocity.api using your chosen logging framework's configuration

simple-logger

Adding simple-logger to your classpath is the easiest way to get logging in scripts. You can do this by adding the following line to your script:

@file:DependsOn("org.slf4j:slf4j-simple:2.0.17")

Then set the log level for com.gabrielfeo.develocity.api using system properties. For example:

• from script code

@file:DependsOn("com.gabrielfeo:develocity-api-kotlin:2026.2.0")
@file:DependsOn("org.slf4j:slf4j-simple:2.0.17")

System.setProperty("org.slf4j.simpleLogger.log.com.gabrielfeo.develocity.api", "debug")

// ...

• from the shebang line

#!/usr/bin/env kotlin -script -J-Dorg.slf4j.simpleLogger.log.com.gabrielfeo.develocity.api=debug

@file:DependsOn("com.gabrielfeo:develocity-api-kotlin:2026.2.0")
@file:DependsOn("org.slf4j:slf4j-simple:2.0.17")

// ...

• from JAVA_OPTS

export JAVA_OPTS="-Dorg.slf4j.simpleLogger.log.com.gabrielfeo.develocity.api=debug"
kotlin -script example-script.main.kts

Projects

1. Add an SLF4J implementation (e.g., slf4j-simple, logback-classic, etc.) to your classpath
2. Set the log level for the package com.gabrielfeo.develocity.api using your chosen logging framework's configuration

simple-logger

Adding simple-logger to your classpath is the easiest way to get logging in projects. You can do this by adding the following dependency to your build file:

// build.gradle.kts
dependencies {
    implementation("com.gabrielfeo:develocity-api-kotlin:2026.2.0")
    runtimeOnly("org.slf4j:slf4j-simple:2.0.17")
}

Then set the system property when running your application. If using the Gradle run task, it can be declared in your build:

tasks.named<JavaExec>("run") {
    // ...
    systemProperty("org.slf4j.simpleLogger.log.com.gabrielfeo.develocity.api", "debug")
}