fast_i18n 4.2.0-dev.0

fast_i18n: ^4.2.0-dev.0 copied to clipboard

• new command: flutter pub run fast_i18n which is much faster than flutter pub run build_runner build --delete-conflicting-outputs

• fix: LocaleSettings.setLocaleRaw for locales encoded with underscore _
• docs: update README

A rebuild is needed: flutter pub run build_runner build.

• feat: the generated file is now self-contained, it works even if you remove this library!
• feat: add stats and timestamp to the generated file
• fix: parse files with underscore only (e.g. strings_en_US)
• fix: parse files with script tag (e.g. strings_zh-Hant-TW)
• perf: generate LocaleSettings.supportedLocales statically without library call
• perf: remove switch call in Translations.of(context).
• docs: updates in generated file
• docs: update README

The typed version is now first class.

• Breaking: setLocale -> setLocaleRaw, setLocaleTyped -> setLocale
• Breaking: locales -> supportedLocalesRaw
• Breaking: AppLocale.toLanguageTag -> AppLocale.languageTag
• Breaking: translation classes are now private by default, you can configure it via translation_class_visibility in build.yaml (in most cases just keep it private!)
• plain strings are now implemented via getters, edit json -> rebuild i18n -> hot reload works now for faster development

• fix LocaleSettings.useDeviceLocale() causing compilation error (Flutter Web)

• docs: add hint for .i18n.json extension
• docs: update code examples
• docs: update image

• new optional case transformation: pascal
• remove recase dependency
• code changes in generated .g.dart file

• add real project example
• update FAQ in README
• depend on null-safety version of recase package

• null safety support
• add type-safe functions LocaleSettings.setLocaleTyped and LocaleSettings.currentLocaleTyped
• Breaking: output_translate_var renamed to translate_var in build.yaml

• Make locales case sensitive to comply with MaterialApp's supportedLocales.

• Add supportedLocales property that can be used to fill MaterialApp's supportedLocales argument.

• Fix compilation error occurring when non-standard name (not 'strings.i18n.json') is used for json files.

• new config: output_translate_var, renames default t variable
• internal: device locale now fetched via Platform.localeName

A rebuild is needed: flutter pub run build_runner build.

• API change: LocaleSettings.useDeviceLocale() is no longer asynchronous and now returns the new locale (was Future<void>)
• API change: LocaleSettings.setLocale(locale) now also returns the new locale (was void)

Just in case you use internal API: FastI18n.findDeviceLocale has been renamed to FastI18n.getDeviceLocale

Thanks to @DenchikBY (https://github.com/DenchikBY).

• Now it's possible to set in and out directories for files.
• You can set the pattern by which to search for files.
• Generated keys can be switched to another case in generated classes.
• Removed dependency on devicelocale.
• Configs with baseLocale and maps moved from config.i18n.json to build.yaml
• Generators replaced with fields for keys with static values.
• Arguments now can be wrapped with braces like ${key}.
• Removed deprecated #map mode (deprecated in 1.5.0)

Example of new config in build.yaml:

targets:
  $default:
    builders:
      fast_i18n:i18nBuilder:
        options:
          base_locale: en
          input_directory: lib/i18n
          input_file_pattern: .i18n.json
          output_directory: lib/i18n
          output_file_pattern: .g.dart
          key_case: snake
          maps:
            - a
            - b
            - c.d

• Hotfix: possible NPE when calling Translations.of(context)

• Hotfix: possible NPE error when calling LocaleSettings.useDeviceLocale or LocaleSettings.setLocale

• New advanced mode: final t = Translations.of(context)

• Prefer language code over region code.

• Add more unit tests.
• Code Polishing.

• Generates List<String> or Map<String, String> instead of List<dynamic> or Map<String, dynamic> if the children are only strings.
• You will experience a better autocompletion like .substring, .indexOf, etc. because of that.

• Update README

• Update README

• Define additional metadata in the config.i18n.json file.

• Maps defined with #map are now deprecated. Use config.i18n.json for that.

• Add LocaleSettings.locales to get the supported locales.

• Add support for country codes. Use e.g. strings_en_US.i18n.json or strings_en-US.i18n.json.

• Add fallback for LocaleSettings.setLocale if locale is not supported.

• Add support for lists.

• Add support for maps. Use { "#map": "" } to enable map inlining.

• Update README

• Only one single .g.dart will be generated

• Fix iOS bug in LocaleSettings.useDeviceLocale

• Fix for LocaleSettings.useDeviceLocale

• Add LocaleSettings.useDeviceLocale()

• Initial Release
• basic json support (no arrays)