config file values handling

CHANGELOG.md

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## 7.0.0-beta.7
+
+- config file error handling
+
 ## 7.0.0-beta.6
 
 - packages update

analysis_options.yaml

@@ -7,7 +7,6 @@ analyzer:
     implicit-casts: false
   exclude:
     - example/**/*.dart
-    - test/**/*.dart
 linter:
   rules:
     - public_member_api_docs

lib/builder.dart

@@ -24,16 +24,18 @@ String _addGraphQLExtensionToPathIfNeeded(String path) {
 }
 
 List<String> _builderOptionsToExpectedOutputs(BuilderOptions builderOptions) {
-  final schemaMaps =
+  final schemaMapping =
       GeneratorOptions.fromJson(builderOptions.config).schemaMapping;
 
-  if (schemaMaps.any((s) => s.output == null)) {
-    throw Exception('''One or more SchemaMap configurations miss an output!
-Please check your build.yaml file.
-''');
+  if (schemaMapping.isEmpty) {
+    throw MissingBuildConfigurationException('schema_mapping');
   }
 
-  return schemaMaps
+  if (schemaMapping.any((s) => s.output == null)) {
+    throw MissingBuildConfigurationException('schema_mapping => output');
+  }
+
+  return schemaMapping
       .map((s) {
         final outputWithoutLib = s.output!.replaceAll(RegExp(r'^lib/'), '');
 
@@ -70,49 +72,72 @@ class GraphQLQueryBuilder implements Builder {
         r'$lib$': expectedOutputs,
       };
 
+  /// read asset files
+  Future<List<DocumentNode>> readGraphQlFiles(
+    BuildStep buildStep,
+    String schema,
+  ) async {
+    final schemaAssetStream = buildStep.findAssets(Glob(schema));
+
+    return await schemaAssetStream
+        .asyncMap(
+          (asset) async => parseString(
+            await buildStep.readAsString(asset),
+            url: asset.path,
+          ),
+        )
+        .toList();
+  }
+
   @override
   Future<void> build(BuildStep buildStep) async {
-    if (options.fragmentsGlob != null) {
-      final fragmentStream = buildStep.findAssets(Glob(options.fragmentsGlob!));
-      final fDocs = await fragmentStream
-          .asyncMap(
-            (asset) async => parseString(
-              await buildStep.readAsString(asset),
-              url: asset.path,
-            ),
-          )
-          .toList();
-      fDocs.forEach(
-        (fDoc) => fragmentsCommon.addAll(
-            fDoc.definitions.whereType<FragmentDefinitionNode>().toList()),
+    final fragmentsGlob = options.fragmentsGlob;
+    if (fragmentsGlob != null) {
+      fragmentsCommon.addAll(
+        (await readGraphQlFiles(buildStep, fragmentsGlob))
+            .map((e) => e.definitions.whereType<FragmentDefinitionNode>())
+            .expand((e) => e)
+            .toList(),
       );
+
+      if (fragmentsCommon.isEmpty) {
+        throw MissingFilesException(fragmentsGlob);
+      }
     }
 
     for (final schemaMap in options.schemaMapping) {
-      final buffer = StringBuffer();
-      final outputFileId = AssetId(buildStep.inputId.package,
-          _addGraphQLExtensionToPathIfNeeded(schemaMap.output!));
+      final queriesGlob = schemaMap.queriesGlob;
+      final schema = schemaMap.schema;
+      final output = schemaMap.output;
+
+      if (schema == null) {
+        throw MissingBuildConfigurationException('schema_map => schema');
+      }
+
+      if (output == null) {
+        throw MissingBuildConfigurationException('schema_map => output');
+      }
 
       // Loop through all files in glob
-      if (schemaMap.queriesGlob == null) {
-        throw Exception('''No queries were considered on this generation!
-Make sure that `queries_glob` your build.yaml file include GraphQL queries files.
-''');
-      } else if (Glob(schemaMap.queriesGlob!).matches(schemaMap.schema!)) {
+      if (queriesGlob == null) {
+        throw MissingBuildConfigurationException('schema_map => queries_glob');
+      } else if (Glob(queriesGlob).matches(schema)) {
         throw QueryGlobsSchemaException();
-      } else if (Glob(schemaMap.queriesGlob!).matches(schemaMap.output!)) {
+      } else if (Glob(queriesGlob).matches(output)) {
         throw QueryGlobsOutputException();
       }
 
-      final assetStream = buildStep.findAssets(Glob(schemaMap.queriesGlob!));
-      var gqlDocs = await assetStream
-          .asyncMap(
-            (asset) async => parseString(
-              await buildStep.readAsString(asset),
-              url: asset.path,
-            ),
-          )
-          .toList();
+      final gqlSchema = await readGraphQlFiles(buildStep, schema);
+
+      if (gqlSchema.isEmpty) {
+        throw MissingFilesException(schema);
+      }
+
+      var gqlDocs = await readGraphQlFiles(buildStep, queriesGlob);
+
+      if (gqlDocs.isEmpty) {
+        throw MissingFilesException(queriesGlob);
+      }
 
       if (schemaMap.appendTypeName) {
         gqlDocs = gqlDocs.map(
@@ -137,38 +162,26 @@ Make sure that `queries_glob` your build.yaml file include GraphQL queries files
             .toList();
       }
 
-      final schemaAssetStream = buildStep.findAssets(Glob(schemaMap.schema!));
-
-      DocumentNode gqlSchema;
-
-      try {
-        gqlSchema = await schemaAssetStream
-            .asyncMap(
-              (asset) async => parseString(
-                await buildStep.readAsString(asset),
-                url: asset.path,
-              ),
-            )
-            .first;
-      } catch (e) {
-        throw Exception(
-            '''Schema `${schemaMap.schema}` was not found or doesn't have a proper format!
-Make sure the file exists and you've typed it correctly on build.yaml.
-$e
-''');
-      }
-
       final libDefinition = generateLibrary(
-        _addGraphQLExtensionToPathIfNeeded(schemaMap.output!),
+        _addGraphQLExtensionToPathIfNeeded(output),
         gqlDocs,
         options,
         schemaMap,
         fragmentsCommon,
-        gqlSchema,
+        gqlSchema.first,
       );
+
       if (onBuild != null) {
         onBuild!(libDefinition);
       }
+
+      final buffer = StringBuffer();
+
+      final outputFileId = AssetId(
+        buildStep.inputId.package,
+        _addGraphQLExtensionToPathIfNeeded(output),
+      );
+
       writeLibraryDefinitionToBuffer(
         buffer,
         options.ignoreForFile,
@@ -177,9 +190,9 @@ $e
 
       await buildStep.writeAsString(outputFileId, buffer.toString());
 
-      if (!schemaMap.output!.endsWith('.graphql.dart')) {
+      if (!output.endsWith('.graphql.dart')) {
         final forwarderOutputFileId =
-            AssetId(buildStep.inputId.package, schemaMap.output!);
+            AssetId(buildStep.inputId.package, output);
         await buildStep.writeAsString(
             forwarderOutputFileId, writeLibraryForwarder(libDefinition));
       }

lib/generator/errors.dart

@@ -65,6 +65,33 @@ Change `schema` or `output` location and try again.
 ''';
 }
 
+/// Define an exception thrown when Artemis does not find asset files
+class MissingFilesException implements Exception {
+  /// glob pattern which was used
+  final String globPattern;
+
+  /// Define an exception thrown when Artemis does not find asset files
+  MissingFilesException(this.globPattern);
+
+  @override
+  String toString() {
+    return 'Missing files for $globPattern';
+  }
+}
+
+/// Define an exception thrown when Artemis does not find required config params
+class MissingBuildConfigurationException implements Exception {
+  /// missing config option name
+  final String name;
+
+  /// Define an exception thrown when Artemis does not find required config params
+  MissingBuildConfigurationException(this.name);
+
+  @override
+  String toString() =>
+      'Missing `$name` configuration option. Cehck `build.yaml` configuration';
+}
+
 /// Define an exception thrown when Artemis find a scalar on schema but it's
 /// not configured on `build.yaml`.
 class MissingScalarConfigurationException implements Exception {

pubspec.yaml

@@ -1,5 +1,5 @@
 name: artemis
-version: 7.0.0-beta.6
+version: 7.0.0-beta.7
 
 description: Build dart types from GraphQL schemas and queries (using Introspection Query).
 homepage: https://github.com/comigor/artemis

test/generator/helpers_test.dart

@@ -1,5 +1,3 @@
-import 'package:artemis/generator/data/data.dart';
-import 'package:gql/language.dart';
 import 'package:test/test.dart';
 import 'package:artemis/generator/helpers.dart';
 

test/generator/print_helpers_test.dart

@@ -696,7 +696,7 @@ enum SomeEnum {
   test('Should not add ignore_for_file when ignoreForFile is null', () {
     final buffer = StringBuffer();
     final definition = LibraryDefinition(basename: r'test_query.graphql');
-    final List<String> ignoreForFile = [];
+    final ignoreForFile = <String>[];
 
     writeLibraryDefinitionToBuffer(buffer, ignoreForFile, definition);
 

test/helpers.dart

@@ -64,8 +64,6 @@ Future testNaming({
   required String namingScheme,
   bool shouldFail = false,
 }) {
-  Logger.root.level = Level.ALL;
-
   final anotherBuilder = graphQLQueryBuilder(BuilderOptions({
     'generate_helpers': false,
     'schema_mapping': [

test/query_generator/append_type_name_test.dart

@@ -1,8 +1,4 @@
-import 'package:artemis/builder.dart';
-import 'package:artemis/generator/data/enum_value_definition.dart';
 import 'package:artemis/generator/data/data.dart';
-import 'package:build/build.dart';
-import 'package:build_test/build_test.dart';
 import 'package:test/test.dart';
 
 import '../helpers.dart';

test/query_generator/ast_schema/multiple_schema_mappint_test.dart

@@ -3,9 +3,7 @@ import 'package:build/build.dart';
 import 'package:artemis/generator/data/data.dart';
 import 'package:artemis/generator/data/enum_value_definition.dart';
 import 'package:build_test/build_test.dart';
-import 'package:logging/logging.dart';
 import 'package:test/test.dart';
-import 'package:collection/collection.dart';
 
 void main() {
   group('Multiple schema mapping', () {
@@ -30,7 +28,7 @@ void main() {
           ],
         }));
 
-        int count = 0;
+        var count = 0;
         anotherBuilder.onBuild = expectAsync1((definition) {
           log.fine(definition);
           if (count == 0) {

test/query_generator/deprecated/deprecated_field_test.dart

@@ -1,5 +1,4 @@
 import 'package:artemis/generator/data/data.dart';
-import 'package:gql/language.dart';
 import 'package:test/test.dart';
 
 import '../../helpers.dart';