chore(generator): improve annotation validation, unify async type handling, and refactor BindSpec creation

- Enhance annotation validation in DI code generation. - Move from manual Future<T> extraction to unified type parsing. - Refactor BindSpec creation logic to provide better error messages and type consistency. - Add missing source files for exceptions, annotation validation, and type parsing. BREAKING CHANGE: Invalid annotation combinations now produce custom generator errors. Async detection is now handled via unified type parser.
2026-01-24 05:25:19 +00:00 · 2025-07-25 11:58:56 +03:00
parent c722ad0c07
commit feb7258302
6 changed files with 1070 additions and 81 deletions
--- a/cherrypick_generator/lib/src/exceptions.dart
+++ b/cherrypick_generator/lib/src/exceptions.dart
@@ -0,0 +1,117 @@
+//
+// Copyright 2021 Sergey Penkovsky (sergey.penkovsky@gmail.com)
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//      http://www.apache.org/licenses/LICENSE-2.0
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+import 'package:analyzer/dart/element/element.dart';
+import 'package:source_gen/source_gen.dart';
+
+/// Enhanced exception class for CherryPick generator with detailed context information
+class CherryPickGeneratorException extends InvalidGenerationSourceError {
+  final String category;
+  final String? suggestion;
+  final Map<String, dynamic>? context;
+
+  CherryPickGeneratorException(
+    String message, {
+    required Element element,
+    required this.category,
+    this.suggestion,
+    this.context,
+  }) : super(
+          _formatMessage(message, category, suggestion, context, element),
+          element: element,
+        );
+
+  static String _formatMessage(
+    String message,
+    String category,
+    String? suggestion,
+    Map<String, dynamic>? context,
+    Element element,
+  ) {
+    final buffer = StringBuffer();
+
+    // Header with category
+    buffer.writeln('[$category] $message');
+
+    // Element context
+    buffer.writeln('');
+    buffer.writeln('Context:');
+    buffer.writeln('  Element: ${element.displayName}');
+    buffer.writeln('  Type: ${element.runtimeType}');
+    buffer.writeln('  Location: ${element.source?.fullName ?? 'unknown'}');
+
+    // Note: enclosingElement may not be available in all analyzer versions
+    try {
+      final enclosing = (element as dynamic).enclosingElement;
+      if (enclosing != null) {
+        buffer.writeln('  Enclosing: ${enclosing.displayName}');
+      }
+    } catch (e) {
+      // Ignore if enclosingElement is not available
+    }
+
+    // Additional context
+    if (context != null && context.isNotEmpty) {
+      buffer.writeln('');
+      buffer.writeln('Additional Context:');
+      context.forEach((key, value) {
+        buffer.writeln('  $key: $value');
+      });
+    }
+
+    // Suggestion
+    if (suggestion != null) {
+      buffer.writeln('');
+      buffer.writeln('💡 Suggestion: $suggestion');
+    }
+
+    return buffer.toString();
+  }
+}
+
+/// Specific exception types for different error categories
+class AnnotationValidationException extends CherryPickGeneratorException {
+  AnnotationValidationException(
+    super.message, {
+    required super.element,
+    super.suggestion,
+    super.context,
+  }) : super(category: 'ANNOTATION_VALIDATION');
+}
+
+class TypeParsingException extends CherryPickGeneratorException {
+  TypeParsingException(
+    super.message, {
+    required super.element,
+    super.suggestion,
+    super.context,
+  }) : super(category: 'TYPE_PARSING');
+}
+
+class CodeGenerationException extends CherryPickGeneratorException {
+  CodeGenerationException(
+    super.message, {
+    required super.element,
+    super.suggestion,
+    super.context,
+  }) : super(category: 'CODE_GENERATION');
+}
+
+class DependencyResolutionException extends CherryPickGeneratorException {
+  DependencyResolutionException(
+    super.message, {
+    required super.element,
+    super.suggestion,
+    super.context,
+  }) : super(category: 'DEPENDENCY_RESOLUTION');
+}