optionalInt method

int optionalInt(String key, { int? defaultValue, String? description, })

Reads an optional integer environment variable identified by key.

Returns defaultValue (or 0 if defaultValue is null) when the variable is unset or empty. Throws BloomEnvironmentException if the variable is present but not a valid integer string.

Implementation

int optionalInt(String key, {int? defaultValue, String? description}) {
  final val = BloomEnv.getOrNull(key)?.trim();
  if (val == null || val.isEmpty) {
    return defaultValue ?? 0;
  }
  final parsed = int.tryParse(val);
  if (parsed == null) {
    final err = 'Environment variable "$key" is not a valid integer: "$val".';
    _validationErrors.add(err);
    throw BloomEnvironmentException(err, errors: [err]);
  }
  return parsed;
}