BidsErrorHandler (nf-bids 0.3.0 API)

nfneuro.util.BidsErrorHandler

```
@groovy.util.logging.Slf4j
@groovy.transform.CompileStatic
class BidsErrorHandler
extends java.lang.Object
```
Context-aware error-handling utilities for nf-bids processing.
Provides tryWithContext (re-throw with context), safeExecute (return a default on failure), and validateWithContext (assert with context-labelled exception). Also contains three typed exception sub-classes: BidsProcessingException, BidsValidationException, and BidsConfigurationException.

Nested Class Summary

Nested classes
Modifiers	Name	Description
`static class`	`BidsErrorHandler.BidsConfigurationException`	Custom exception for BIDS configuration errors
`static class`	`BidsErrorHandler.BidsProcessingException`	Custom exception for BIDS-specific errors
`static class`	`BidsErrorHandler.BidsValidationException`	Custom exception for BIDS validation errors

Constructor Summary

Constructors
Constructor and description
`BidsErrorHandler()`

Methods Summary

Methods
Type Params	Return Type	Name and description
	`static java.lang.String`	`createDetailedError(java.lang.String error, java.util.List<java.lang.String> suggestions)` Create detailed error message with suggestions
	`static void`	`handleError(java.lang.String context, java.lang.Exception e)` Handle error with context
	`static void`	`handleErrorWithMessage(java.lang.String context, java.lang.String message)` Handle error with custom message
	`static void`	`handleWarning(java.lang.String context, java.lang.String message)` Handle warning with context
`<T>`	`static T`	`safeExecute(java.lang.String context, groovy.lang.Closure<T> closure, T defaultValue)` Execute code block safely with default value on failure
`<T>`	`static T`	`tryWithContext(java.lang.String context, groovy.lang.Closure<T> closure)` Execute code block with error context
	`static void`	`validateWithContext(boolean condition, java.lang.String context, java.lang.String message)` Validate condition with context

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
  - BidsErrorHandler()
- Method Detail
  - static java.lang.String createDetailedError(java.lang.String error, java.util.List<java.lang.String> suggestions)
    
    Create detailed error message with suggestions
    Parameters:
    error - Main error message
    suggestions - List of suggestions to resolve
    Returns:
    Formatted error message
  - static void handleError(java.lang.String context, java.lang.Exception e)
    
    Handle error with context
    reference:
    handleError function: https://github.com/agahkarakuzu/bids2nf/blob/main/modules/utils/error_handling.nf#L1-L7
    
    Parameters:
    context - Error context
    e - Exception that occurred
  - static void handleErrorWithMessage(java.lang.String context, java.lang.String message)
    
    Handle error with custom message
    reference:
    handleErrorWithMessage function: https://github.com/agahkarakuzu/bids2nf/blob/main/modules/utils/error_handling.nf#L9-L12
    
    Parameters:
    context - Error context
    message - Error message
  - static void handleWarning(java.lang.String context, java.lang.String message)
    
    Handle warning with context
    reference:
    handleWarning function: https://github.com/agahkarakuzu/bids2nf/blob/main/modules/utils/error_handling.nf#L14-L16
    
    Parameters:
    context - Warning context
    message - Warning message
  - <T> static T safeExecute(java.lang.String context, groovy.lang.Closure<T> closure, T defaultValue)
    
    Execute code block safely with default value on failure
    reference:
    safeExecute function: https://github.com/agahkarakuzu/bids2nf/blob/main/modules/utils/error_handling.nf#L42-L48
    
    Parameters:
    context - Error context identifier
    closure - Code to execute
    defaultValue - Value to return on failure
    Returns:
    Result of closure or default value
  - <T> static T tryWithContext(java.lang.String context, groovy.lang.Closure<T> closure)
    
    Execute code block with error context Wraps execution with context information for better error messages
    reference:
    tryWithContext function: https://github.com/agahkarakuzu/bids2nf/blob/main/modules/utils/error_handling.nf#L35-L48
    
    Parameters:
    context - Error context identifier
    closure - Code to execute
    Returns:
    Result of closure execution
  - static void validateWithContext(boolean condition, java.lang.String context, java.lang.String message)
    
    Validate condition with context
    reference:
    validateAndThrow function: https://github.com/agahkarakuzu/bids2nf/blob/main/modules/utils/error_handling.nf#L28-L32
    
    Parameters:
    condition - Condition to validate
    context - Error context
    message - Error message if condition fails

Summary:
Nested
Constructor
Method

| Detail:
Constructor
Method

Groovy Documentation

[Groovy] Class BidsErrorHandler

Nested Class Summary

Constructor Summary

Methods Summary

Inherited Methods Summary

Constructor Detail

BidsErrorHandler()

Method Detail

static java.lang.String createDetailedError(java.lang.String error, java.util.List<java.lang.String> suggestions)

static void handleError(java.lang.String context, java.lang.Exception e)

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

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

<T> static T safeExecute(java.lang.String context, groovy.lang.Closure<T> closure, T defaultValue)

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

static void validateWithContext(boolean condition, java.lang.String context, java.lang.String message)