library angel_configuration; import 'dart:async'; import 'package:angel_framework/angel_framework.dart'; import 'package:dotenv/dotenv.dart' as dotenv; import 'package:file/file.dart'; import 'package:merge_map/merge_map.dart'; import 'package:yaml/yaml.dart'; Future _loadYamlFile(Map map, File yamlFile, Map env, void Function(String msg) warn) async { if (await yamlFile.exists()) { var config = loadYaml(await yamlFile.readAsString()); if (config is! Map) { warn( 'The configuration at "${yamlFile.absolute.path}" is not a Map. Refusing to load it.'); return; } var out = {}; for (String key in config.keys) { out[key] = _applyEnv(config[key], env ?? {}, warn); } map.addAll(mergeMap( [ map, out, ], acceptNull: true, )); } } Object _applyEnv( var v, Map env, void Function(String msg) warn) { if (v is String) { if (v.startsWith(r'$') && v.length > 1) { var key = v.substring(1); if (env.containsKey(key)) { return env[key]; } else { warn( 'Your configuration calls for loading the value of "$key" from the system environment, but it is not defined. Defaulting to `null`.'); return null; } } else { return v; } } else if (v is Iterable) { return v.map((x) => _applyEnv(x, env ?? {}, warn)).toList(); } else if (v is Map) { return v.keys .fold({}, (out, k) => out..[k] = _applyEnv(v[k], env ?? {}, warn)); } else { return v; } } /// Loads [configuration], and returns a [Map]. /// /// You can override [onWarning]; otherwise, configuration errors will throw. Future loadStandaloneConfiguration(FileSystem fileSystem, {String directoryPath = './config', String overrideEnvironmentName, String envPath, void Function(String message) onWarning}) async { var sourceDirectory = fileSystem.directory(directoryPath); var env = dotenv.env; var envFile = sourceDirectory.childFile(envPath ?? '.env'); if (await envFile.exists()) { dotenv.load(envFile.absolute.uri.toFilePath()); } var environmentName = env['ANGEL_ENV'] ?? 'development'; if (overrideEnvironmentName != null) { environmentName = overrideEnvironmentName; } onWarning ??= (String message) => throw StateError(message); var out = {}; var defaultYaml = sourceDirectory.childFile('default.yaml'); await _loadYamlFile(out, defaultYaml, env, onWarning); var configFilePath = '$environmentName.yaml'; var configFile = sourceDirectory.childFile(configFilePath); await _loadYamlFile(out, configFile, env, onWarning); return out; } /// Dynamically loads application configuration from configuration files. /// /// You can modify which [directoryPath] to search in, or explicitly /// load from a [overrideEnvironmentName]. /// /// You can also specify a custom [envPath] to load system configuration from. AngelConfigurer configuration(FileSystem fileSystem, {String directoryPath = './config', String overrideEnvironmentName, String envPath}) { return (Angel app) async { var sourceDirectory = fileSystem.directory(directoryPath); var env = dotenv.env; var envFile = sourceDirectory.childFile(envPath ?? '.env'); if (await envFile.exists()) { try { dotenv.load(envFile.absolute.uri.toFilePath()); } catch (_) { app.logger?.warning( 'WARNING: Found an environment configuration at ${envFile.absolute.path}, but it was invalidly formatted. Refusing to load it.'); } } var environmentName = env['ANGEL_ENV'] ?? 'development'; if (overrideEnvironmentName != null) { environmentName = overrideEnvironmentName; } void warn(String message) { app.logger?.warning('WARNING: $message'); } var defaultYaml = sourceDirectory.childFile('default.yaml'); await _loadYamlFile(app.configuration, defaultYaml, env, warn); var configFilePath = '$environmentName.yaml'; var configFile = sourceDirectory.childFile(configFilePath); await _loadYamlFile(app.configuration, configFile, env, warn); }; }