| // Copyright (c) 2020, the Dart project authors. Please see the AUTHORS file |
| // for details. All rights reserved. Use of this source code is governed by a |
| // BSD-style license that can be found in the LICENSE file. |
| |
| /// Validates the yaml input by the user, prints useful info for the user |
| |
| import 'package:ffigen/src/code_generator.dart'; |
| import 'package:ffigen/src/header_parser/type_extractor/cxtypekindmap.dart'; |
| |
| import 'package:logging/logging.dart'; |
| import 'package:yaml/yaml.dart'; |
| |
| import '../strings.dart' as strings; |
| import 'config_types.dart'; |
| import 'spec_utils.dart'; |
| |
| var _logger = Logger('ffigen.config_provider.config'); |
| |
| /// Provides configurations to other modules. |
| /// |
| /// Handles validation, extraction of confiurations from yaml file. |
| class Config { |
| /// output file name. |
| String output; |
| |
| // Holds headers and filters for header. |
| Headers headers; |
| |
| /// CommandLine Arguments to pass to clang_compiler. |
| List<String> compilerOpts; |
| |
| /// Declaration config for Functions. |
| Declaration functionDecl; |
| |
| /// Declaration config for Structs. |
| Declaration structDecl; |
| |
| /// Declaration config for Enums. |
| Declaration enumClassDecl; |
| |
| /// Declaration config for Enums. |
| Declaration macroDecl; |
| |
| /// If generated bindings should be sorted alphabetically. |
| bool sort; |
| |
| /// If typedef of supported types(int8_t) should be directly used. |
| bool useSupportedTypedefs; |
| |
| /// Extracted Doc comment type. |
| CommentType commentType; |
| |
| /// If tool should generate array workarounds. |
| /// |
| /// If false(default), structs with inline array members will have all its |
| /// members removed. |
| bool arrayWorkaround; |
| |
| /// If constants should be generated for unnamed enums. |
| bool unnamedEnums; |
| |
| /// Name of the wrapper class. |
| String wrapperName; |
| |
| /// Doc comment for the wrapper class. |
| String wrapperDocComment; |
| |
| /// Header of the generated bindings. |
| String preamble; |
| |
| Config._(); |
| |
| /// Create config from Yaml map. |
| factory Config.fromYaml(YamlMap map) { |
| final configspecs = Config._(); |
| _logger.finest('Config Map: ' + map.toString()); |
| |
| final specs = configspecs._getSpecs(); |
| |
| final result = configspecs._checkConfigs(map, specs); |
| if (!result) { |
| throw ConfigError(); |
| } |
| |
| configspecs._extract(map, specs); |
| return configspecs; |
| } |
| |
| /// Validates Yaml according to given specs. |
| bool _checkConfigs(YamlMap map, Map<String, Specification> specs) { |
| var _result = true; |
| for (final key in specs.keys) { |
| final spec = specs[key]; |
| if (map.containsKey(key)) { |
| _result = _result && spec.validator(key, map[key]); |
| } else if (spec.requirement == Requirement.yes) { |
| _logger.severe("Key '${key}' is required."); |
| _result = false; |
| } else if (spec.requirement == Requirement.prefer) { |
| _logger.warning("Prefer adding Key '$key' to your config."); |
| } |
| } |
| // Warn about unknown keys. |
| for (final key in map.keys) { |
| if (!specs.containsKey(key)) { |
| _logger.warning("Unknown key '$key' found."); |
| } |
| } |
| |
| return _result; |
| } |
| |
| /// Extracts variables from Yaml according to given specs. |
| /// |
| /// Validation must be done beforehand, using [_checkConfigs]. |
| void _extract(YamlMap map, Map<String, Specification> specs) { |
| for (final key in specs.keys) { |
| final spec = specs[key]; |
| if (map.containsKey(key)) { |
| spec.extractedResult(spec.extractor(map[key])); |
| } else { |
| spec.extractedResult(spec.defaultValue?.call()); |
| } |
| } |
| } |
| |
| /// Returns map of various specifications avaialble for our tool. |
| /// |
| /// Key: Name, Value: [Specification] |
| Map<String, Specification> _getSpecs() { |
| return <String, Specification>{ |
| strings.output: Specification<String>( |
| requirement: Requirement.yes, |
| validator: outputValidator, |
| extractor: outputExtractor, |
| extractedResult: (dynamic result) => output = result as String, |
| ), |
| strings.headers: Specification<Headers>( |
| requirement: Requirement.yes, |
| validator: headersValidator, |
| extractor: headersExtractor, |
| extractedResult: (dynamic result) => headers = result as Headers, |
| ), |
| strings.compilerOpts: Specification<List<String>>( |
| requirement: Requirement.no, |
| validator: compilerOptsValidator, |
| extractor: compilerOptsExtractor, |
| extractedResult: (dynamic result) => |
| compilerOpts = result as List<String>, |
| ), |
| strings.functions: Specification<Declaration>( |
| requirement: Requirement.no, |
| validator: declarationConfigValidator, |
| extractor: declarationConfigExtractor, |
| defaultValue: () => Declaration(), |
| extractedResult: (dynamic result) { |
| functionDecl = result as Declaration; |
| }, |
| ), |
| strings.structs: Specification<Declaration>( |
| requirement: Requirement.no, |
| validator: declarationConfigValidator, |
| extractor: declarationConfigExtractor, |
| defaultValue: () => Declaration(), |
| extractedResult: (dynamic result) { |
| structDecl = result as Declaration; |
| }, |
| ), |
| strings.enums: Specification<Declaration>( |
| requirement: Requirement.no, |
| validator: declarationConfigValidator, |
| extractor: declarationConfigExtractor, |
| defaultValue: () => Declaration(), |
| extractedResult: (dynamic result) { |
| enumClassDecl = result as Declaration; |
| }, |
| ), |
| strings.macros: Specification<Declaration>( |
| requirement: Requirement.no, |
| validator: declarationConfigValidator, |
| extractor: declarationConfigExtractor, |
| defaultValue: () => Declaration(), |
| extractedResult: (dynamic result) { |
| macroDecl = result as Declaration; |
| }, |
| ), |
| strings.sizemap: Specification<Map<int, SupportedNativeType>>( |
| validator: sizemapValidator, |
| extractor: sizemapExtractor, |
| defaultValue: () => <int, SupportedNativeType>{}, |
| extractedResult: (dynamic result) { |
| final map = result as Map<int, SupportedNativeType>; |
| for (final key in map.keys) { |
| if (cxTypeKindToSupportedNativeTypes.containsKey(key)) { |
| cxTypeKindToSupportedNativeTypes[key] = map[key]; |
| } |
| } |
| }, |
| ), |
| strings.sort: Specification<bool>( |
| requirement: Requirement.no, |
| validator: booleanValidator, |
| extractor: booleanExtractor, |
| defaultValue: () => false, |
| extractedResult: (dynamic result) => sort = result as bool, |
| ), |
| strings.useSupportedTypedefs: Specification<bool>( |
| requirement: Requirement.no, |
| validator: booleanValidator, |
| extractor: booleanExtractor, |
| defaultValue: () => true, |
| extractedResult: (dynamic result) => |
| useSupportedTypedefs = result as bool, |
| ), |
| strings.comments: Specification<CommentType>( |
| requirement: Requirement.no, |
| validator: commentValidator, |
| extractor: commentExtractor, |
| defaultValue: () => CommentType.def(), |
| extractedResult: (dynamic result) => |
| commentType = result as CommentType, |
| ), |
| strings.arrayWorkaround: Specification<bool>( |
| requirement: Requirement.no, |
| validator: booleanValidator, |
| extractor: booleanExtractor, |
| defaultValue: () => false, |
| extractedResult: (dynamic result) => arrayWorkaround = result as bool, |
| ), |
| strings.unnamedEnums: Specification<bool>( |
| requirement: Requirement.no, |
| validator: booleanValidator, |
| extractor: booleanExtractor, |
| defaultValue: () => true, |
| extractedResult: (dynamic result) => unnamedEnums = result as bool, |
| ), |
| strings.name: Specification<String>( |
| requirement: Requirement.prefer, |
| validator: dartClassNameValidator, |
| extractor: stringExtractor, |
| defaultValue: () => 'NativeLibrary', |
| extractedResult: (dynamic result) => wrapperName = result as String, |
| ), |
| strings.description: Specification<String>( |
| requirement: Requirement.prefer, |
| validator: nonEmptyStringValidator, |
| extractor: stringExtractor, |
| defaultValue: () => null, |
| extractedResult: (dynamic result) => |
| wrapperDocComment = result as String, |
| ), |
| strings.preamble: Specification<String>( |
| requirement: Requirement.no, |
| validator: nonEmptyStringValidator, |
| extractor: stringExtractor, |
| extractedResult: (dynamic result) => preamble = result as String, |
| ), |
| }; |
| } |
| } |
| |
| class ConfigError implements Exception { |
| final String message; |
| ConfigError([this.message]); |
| |
| @override |
| String toString() { |
| if (message == null) { |
| return 'ConfigError: Invalid configurations provided.'; |
| } else { |
| return 'ConfigError: $message'; |
| } |
| } |
| } |