auto_easy_localization 1.0.1

auto_easy_localization: ^1.0.1 copied to clipboard

example/example.dart

// Example usage for auto_easy_localization
// This example shows programmatic usage. For most use cases,
// prefer configuring via pubspec.yaml and running: dart run auto_easy_localization

import 'dart:io';

import 'package:auto_easy_localization/auto_easy_localization.dart';
import 'package:path/path.dart' as p;

Future<void> main() async {
  print('🌐 Auto Easy Localization Example');
  print('');
  print('For normal usage, add configuration to your pubspec.yaml:');
  print('');
  print('auto_easy_localization:');
  print('  source_locale: en');
  print('  target_locales: [fr, es, de, it, tr]');
  print('  translations_path: assets/translations');
  print('  delay_between_requests: 100');
  print('  max_retries: 3');
  print('');
  print('Then run: dart run auto_easy_localization');
  print('');
  print('--- Programmatic Usage Example ---');

  // 1) Example directory structure.
  final translationsDir = Directory(
    p.join('example', 'assets', 'translations'),
  );

  // 2) Configure generator (use a small set of targets for demo)
  final config = TranslationConfig(
    translationsPath: translationsDir.path,
    sourceLocale: 'en',
    targetLocales: const ['fr', 'es', 'de', 'it', 'tr'],
    // Keep overwriteExisting=false so we only fill missing keys in existing files
    overwriteExisting: false,
    // Adjust these for your needs
    delayBetweenRequests: 100,
    maxRetries: 3,
    // Optional: specify a custom excluded keys file
    // excludedKeysPath: 'assets/excluded_keys.json',
  );

  final validationErrors = config.validate();
  if (validationErrors.isNotEmpty) {
    stderr.writeln('Invalid configuration:');
    for (final err in validationErrors) {
      stderr.writeln(' - $err');
    }
    exit(2);
  }

  // 3) Run generator
  // NOTE: The generator will automatically check for assets/excluded_keys.json
  // If it exists, keys listed there (like "app.title", "app.author") will not be translated
  // but will be copied to target locale files with their original values.
  final generator = AutoLocalizationGenerator(config);

  stdout.writeln('Starting smart generation in: ${config.translationsPath}');
  stdout.writeln(
    '🔧 Excluded keys will be loaded from assets/excluded_keys.json if it exists',
  );
  try {
    await generator.smartGenerate();

    // 4) Print some quick stats
    final stats = await generator.getStats();
    stdout
      ..writeln(stats.toString())
      ..writeln(
        'Example complete. Check generated *.json files under ${config.translationsPath}',
      );
  } catch (e) {
    stderr.writeln('Generation failed: $e');
    exit(1);
  }
}