BidsLogger (nf-bids 0.3.0 API)

nfneuro.util.BidsLogger

```
@groovy.util.logging.Slf4j
@groovy.transform.CompileStatic
class BidsLogger
extends java.lang.Object
```
Centralized structured logging for nf-bids operations.
All methods delegate to SLF4J (@Slf4j) at the appropriate level and prefix each message with a context identifier enclosed in brackets (e.g. "[nf-bids-parser] Parsed 42 files") for easy log filtering.

Static factory methods (logProgress, logSuccess, logWarning, logError, logDebug, withTiming) cover all operational needs; the single-argument convenience aliases (info, warn, debug, trace) use the default context "nf-bids".

Constructor Summary

Constructors
Constructor and description
`BidsLogger()`

Methods Summary

Methods
Type Params	Return Type	Name and description
	`static void`	`debug(java.lang.Object message)` Convenience method for debug logging (alias for logDebug)
	`static void`	`info(java.lang.Object message)` Convenience method for info logging (alias for logProgress)
	`static void`	`logConfig(java.lang.String context, java.util.Map<java.lang.String, java.lang.Object> config)` Log configuration summary
	`static void`	`logDebug(java.lang.String context, java.lang.String message)` Log debug message with context
	`static void`	`logDebug(java.lang.String message)` Log debug message with default context
	`static void`	`logError(java.lang.String context, java.lang.String message)` Log error message with context
	`static void`	`logError(java.lang.String message)` Log error message with default context
	`static void`	`logProgress(java.lang.String context, java.lang.String message)` Log progress message with context
	`static void`	`logProgress(java.lang.String message)` Log progress message with default context
	`static void`	`logStats(java.lang.String context, java.util.Map<java.lang.String, java.lang.Object> stats)` Log statistics
	`static void`	`logSuccess(java.lang.String context, java.lang.String message)` Log success message with context
	`static void`	`logSuccess(java.lang.String message)` Log success message with default context
	`static void`	`logTiming(java.lang.String context, java.lang.String operation, long duration)` Log timing information
	`static void`	`logTiming(java.lang.String context, java.lang.String operation, BigDecimal duration)`
	`static void`	`logWarning(java.lang.String context, java.lang.String message)` Log warning message with context
	`static void`	`logWarning(java.lang.String message)` Log warning message with default context
	`static void`	`trace(java.lang.Object message)` Convenience method for trace logging (same as debug)
	`static void`	`warn(java.lang.Object message)` Convenience method for warn logging (alias for logWarning)
`<T>`	`static T`	`withTiming(java.lang.String context, java.lang.String operation, groovy.lang.Closure<T> closure)` Execute closure with timing

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class java.lang.Object`	`java.lang.Object#equals(java.lang.Object), java.lang.Object#toString(), java.lang.Object#hashCode(), java.lang.Object#getClass(), java.lang.Object#notify(), java.lang.Object#notifyAll(), java.lang.Object#wait(long), java.lang.Object#wait(long, int), java.lang.Object#wait()`

- Constructor Detail
  - BidsLogger()
- Method Detail
  - static void debug(java.lang.Object message)
    
    Convenience method for debug logging (alias for logDebug)
  - static void info(java.lang.Object message)
    
    Convenience method for info logging (alias for logProgress)
  - static void logConfig(java.lang.String context, java.util.Map<java.lang.String, java.lang.Object> config)
    
    Log configuration summary
    Parameters:
    context - Processing context
    config - Configuration map
  - static void logDebug(java.lang.String context, java.lang.String message)
    
    Log debug message with context
    reference:
    logDebug function: https://github.com/agahkarakuzu/bids2nf/blob/main/modules/utils/error_handling.nf#L22-L26
    
    Parameters:
    context - Processing context
    message - Debug message
  - static void logDebug(java.lang.String message)
    
    Log debug message with default context
    Parameters:
    message - Debug message
  - static void logError(java.lang.String context, java.lang.String message)
    
    Log error message with context
    Parameters:
    context - Processing context
    message - Error message
  - static void logError(java.lang.String message)
    
    Log error message with default context
    Parameters:
    message - Error message
  - static void logProgress(java.lang.String context, java.lang.String message)
    
    Log progress message with context
    reference:
    logProgress function: https://github.com/agahkarakuzu/bids2nf/blob/main/modules/utils/error_handling.nf#L18-L20
    
    Parameters:
    context - Processing context (e.g., "nf-bids")
    message - Message to log
  - static void logProgress(java.lang.String message)
    
    Log progress message with default context
    Parameters:
    message - Message to log
  - static void logStats(java.lang.String context, java.util.Map<java.lang.String, java.lang.Object> stats)
    
    Log statistics
    Parameters:
    context - Processing context
    stats - Statistics map
  - static void logSuccess(java.lang.String context, java.lang.String message)
    
    Log success message with context
    Parameters:
    context - Processing context
    message - Success message
  - static void logSuccess(java.lang.String message)
    
    Log success message with default context
    Parameters:
    message - Success message
  - static void logTiming(java.lang.String context, java.lang.String operation, long duration)
    
    Log timing information
    Parameters:
    context - Processing context
    operation - Operation name
    duration - Duration in milliseconds
  - static void logTiming(java.lang.String context, java.lang.String operation, BigDecimal duration)
  - static void logWarning(java.lang.String context, java.lang.String message)
    
    Log warning message with context
    Parameters:
    context - Processing context
    message - Warning message
  - static void logWarning(java.lang.String message)
    
    Log warning message with default context
    Parameters:
    message - Warning message
  - static void trace(java.lang.Object message)
    
    Convenience method for trace logging (same as debug)
  - static void warn(java.lang.Object message)
    
    Convenience method for warn logging (alias for logWarning)
  - <T> static T withTiming(java.lang.String context, java.lang.String operation, groovy.lang.Closure<T> closure)
    
    Execute closure with timing
    Parameters:
    context - Processing context
    operation - Operation name
    closure - Code to execute
    Returns:
    Result of closure

Summary:
Constructor
Method

| Detail:
Constructor
Method

Groovy Documentation

[Groovy] Class BidsLogger

Constructor Summary

Methods Summary

Inherited Methods Summary

Constructor Detail

BidsLogger()

Method Detail

static void debug(java.lang.Object message)

static void info(java.lang.Object message)

static void logConfig(java.lang.String context, java.util.Map<java.lang.String, java.lang.Object> config)

static void logDebug(java.lang.String context, java.lang.String message)

static void logDebug(java.lang.String message)

static void logError(java.lang.String context, java.lang.String message)

static void logError(java.lang.String message)

static void logProgress(java.lang.String context, java.lang.String message)

static void logProgress(java.lang.String message)

static void logStats(java.lang.String context, java.util.Map<java.lang.String, java.lang.Object> stats)

static void logSuccess(java.lang.String context, java.lang.String message)

static void logSuccess(java.lang.String message)

static void logTiming(java.lang.String context, java.lang.String operation, long duration)

static void logTiming(java.lang.String context, java.lang.String operation, BigDecimal duration)

static void logWarning(java.lang.String context, java.lang.String message)

static void logWarning(java.lang.String message)

static void trace(java.lang.Object message)

static void warn(java.lang.Object message)

<T> static T withTiming(java.lang.String context, java.lang.String operation, groovy.lang.Closure<T> closure)