dart_swagger_to_models 0.5.2

dart_swagger_to_models: ^0.5.2 copied to clipboard

• missing_type - поле без типа и без $ref
• suspicious_id_field - подозрительное id поле (без required и без nullable)
• missing_ref_target - отсутствующая цель для $ref
• type_inconsistency - несогласованность типов (например, integer с format)
• empty_object - пустой объект (нет properties и additionalProperties)
• array_without_items - массив без items
• empty_enum - enum без значений

lint:
  enabled: true
  rules:
    missing_type: error
    suspicious_id_field: warning
    missing_ref_target: error
    type_inconsistency: warning
    empty_object: off
    array_without_items: warning
    empty_enum: warning

• Caches schema hashes in .dart_swagger_to_models.cache file
• Uses SHA-256 hashes to detect schema changes
• Automatically handles new, modified, and deleted schemas

• Regenerates only schemas that have changed since last run
• Significantly improves performance for large specifications
• Automatically removes files for deleted schemas

• First run (generates all schemas)
• Incremental run (only changed schemas)
• Adding new schemas
• Removing schemas
• Modifying single schema in large spec

# First run - generates all schemas
dart run dart_swagger_to_models:dart_swagger_to_models \
  --input api.yaml \
  --changed-only
    
# Subsequent runs - only changed schemas
dart run dart_swagger_to_models:dart_swagger_to_models \
  --input api.yaml \
  --changed-only

• Number of processed schemas
• Number of processed enums
• Number of created/updated files
• Total files generated

• example/dart_example/ - Pure Dart project demonstrating build_runner integration
• example/flutter_example/ - Flutter project with HTTP client integration

• Added section "Integration with build_runner" to doc/en/USAGE.md
• Added section "Интеграция с build_runner" to doc/ru/usage.md

# build.yaml
targets:
  $default:
    builders:
      dart_swagger_to_models|swaggerBuilder:
        enabled: true
        generate_for:
          - swagger/**
          - openapi/**
          - api/**

# Run build_runner
dart run build_runner build
# or for Flutter
flutter pub run build_runner build

• Automatic model generation when specifications change
• Seamless integration with other code generators (e.g., json_serializable)
• Works with all configuration options (defaultStyle, outputDir, useJsonKey, etc.)
• Generated files are part of project structure for IDE support

• StyleRegistry class for registering custom styles
• StyleRegistry.register() method to register a custom style
• StyleRegistry.createCustomStrategy() to create a strategy instance
• Support for custom style names in configuration files
• Support for custom style names via CLI --style option

• example/custom_style_equatable.dart - Complete example of an Equatable style generator

• doc/en/CUSTOM_STYLES.md - Step-by-step guide on creating custom styles
• doc/ru/CUSTOM_STYLES.md - Step-by-step guide in Russian

// Register a custom style
StyleRegistry.register('my_style', () => MyCustomGenerator());
    
// Use in config file
// dart_swagger_to_models.yaml:
// defaultStyle: my_style
    
// Or via CLI
// --style my_style

• External packages can provide their own ClassGeneratorStrategy implementations
• Style name → strategy mapping via StyleRegistry
• Custom styles work alongside built-in styles (plain_dart, json_serializable, freezed)
• Clear error messages when using unregistered styles

• Safer dynamic wrappers with clear error messages
• Architecture prepared for future union-type generation (especially with discriminator)
• Verbose logging about possible types in oneOf/anyOf schemas
• Detection and logging of discriminator usage

• Recursive handling of nested allOf combinations
• Support for multiple inheritance cases
• Detection and prevention of circular dependencies
• Verbose logging for nested allOf processing

• Nested allOf combinations
• Multiple inheritance through allOf
• oneOf / anyOf with discriminator
• Circular dependency handling