Adapt package:messages to be loading mechanism independent

.gitattributes

@@ -1 +1,2 @@
 pkgs/intl4x/lib/src/bindings/* linguist-generated=true
+*.g.dart linguist-generated=true

.github/workflows/messages.yml

@@ -23,10 +23,9 @@ jobs:
         working-directory: pkgs/messages
     strategy:
       matrix:
-        sdk: [stable, dev] # {pkgs.versions}
-        dependencies: [path, published]
+        sdk: [dev]
         include:
-          - sdk: stable
+          - sdk: dev
             run-tests: true
 
     steps:
@@ -37,7 +36,14 @@ jobs:
 
       - run: dart pub get
 
-      - run: (cd example_json; dart pub get)
+      - run: dart pub get
+        working-directory: pkgs/messages/example
+
+      # - run: dart pub get
+      #   working-directory: pkgs/messages/examples_flutter/my_application
+
+      # - run: dart pub get
+      #   working-directory: pkgs/messages/examples_flutter/my_shopping_cart
 
       - run: dart analyze --fatal-infos
 
@@ -46,3 +52,10 @@ jobs:
 
       - run: dart test
         if: ${{matrix.run-tests}}
+
+      - name: Run example
+        working-directory: pkgs/messages/example
+        run: |
+          dart run messages
+          git diff --exit-code
+          dart run

.github/workflows/messages_builder.yml

@@ -23,9 +23,9 @@ jobs:
         working-directory: pkgs/messages_builder
     strategy:
       matrix:
-        sdk: [stable, dev] # {pkgs.versions}
+        sdk: [dev]
         include:
-          - sdk: stable
+          - sdk: dev
             run-tests: true
     steps:
       - uses: actions/checkout@c85c95e3d7251135ab7dc9ce3241c5835cc595a9

.github/workflows/messages_serializer.yml

@@ -23,9 +23,9 @@ jobs:
         working-directory: pkgs/messages_serializer
     strategy:
       matrix:
-        sdk: [stable, dev] # {pkgs.versions}
+        sdk: [dev]
         include:
-          - sdk: stable
+          - sdk: dev
             run-tests: true
     steps:
       - uses: actions/checkout@c85c95e3d7251135ab7dc9ce3241c5835cc595a9

.github/workflows/messages_shrinker.yml

@@ -23,9 +23,9 @@ jobs:
         working-directory: pkgs/messages_shrinker
     strategy:
       matrix:
-        sdk: [stable, dev] # {pkgs.versions}
+        sdk: [dev]
         include:
-          - sdk: stable
+          - sdk: dev
             run-tests: true
     steps:
       - uses: actions/checkout@c85c95e3d7251135ab7dc9ce3241c5835cc595a9

pkgs/messages/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.3.0-wip
+
+- Adapt to output data files to assets.
+
 ## 0.2.0
 
 - Remove `IntlObject` interface.

pkgs/messages/README.md

@@ -68,7 +68,7 @@ This translated file was created by a translator given the reference `en.arb`.
 ```
 you can then run
 
-`dart run build_runner build -d`
+`dart run messages`
 
 This will generate both code to call your messages, as well as data files which will be shipped with your application. You can then use these generated files by importing the generated files:
 
@@ -105,4 +105,4 @@ package_options:
       // multi
       // line
       // header
-```
+```

pkgs/messages/bin/messages.dart

@@ -0,0 +1,40 @@
+// Copyright (c) 2024, the Dart project authors. Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+import 'dart:io';
+
+import 'package:messages_builder/builder.dart';
+import 'package:messages_builder/generation_options.dart';
+import 'package:messages_builder/message_data_builder.dart';
+
+/// Regenerates both data files and code for retrieving the messages from the
+/// data files.
+///
+/// Executed by running `dart run messages` in a project with a dependency on
+/// `package:messages`.
+Future<void> main(List<String> args) async {
+  final generationOptions = await _generationOptions();
+  final inputFolder = Directory.fromUri(
+      Directory.current.uri.resolve('assets/').resolve('l10n/'));
+  final outputFolder =
+      Directory.fromUri(Directory.current.uri.resolve('assets/'));
+
+  final mapping = await MessageDataFileBuilder(
+    inputFolder: inputFolder,
+    outputFolder: outputFolder,
+    generationOptions: generationOptions,
+  ).run();
+
+  await MessageCallingCodeGenerator(
+    mapping: mapping,
+    options: generationOptions,
+  ).build();
+}
+
+Future<GenerationOptions> _generationOptions() async {
+  final pubspecUri = Directory.current.uri.resolve('pubspec.yaml');
+  final file = File.fromUri(pubspecUri);
+  final pubspecContents = await file.readAsString();
+  return await GenerationOptions.fromPubspec(pubspecContents);
+}

pkgs/messages/example_json/.gitignore → pkgs/messages/example/.gitignore

@@ -4,3 +4,4 @@
 
 # Conventional directory for build output.
 build/
+bin/example/

pkgs/messages/example_json/lib/testarb.arb → pkgs/messages/example/assets/l10n/testarb.arb

@@ -36,4 +36,4 @@
         }
     },
     "helloAndWelcome2": "Welcome {firstName} von {lastName}!"
-}
+}

pkgs/messages/example_json/lib/testarb_de.arb → pkgs/messages/example/assets/l10n/testarb_de.arb

@@ -5,4 +5,4 @@
     "helloAndWelcome2": "Willkommen {firstName} von {lastName} 2",
     "newMessages": "testde {newMessages, plural, =0 {No new messages} =1 {One new message} two{Two new Messages} other {test {newMessages} new messages}}",
     "newMessages2": "testdse is just a simple message"
-}
+}

pkgs/messages/example_json/lib/testarbctx2.arb → pkgs/messages/example/assets/l10n/testarbctx2.arb

@@ -43,4 +43,4 @@
             }
         }
     }
-}
+}

pkgs/messages/example_json/lib/testarbctx2_fr.arb → pkgs/messages/example/assets/l10n/testarbctx2_fr.arb

@@ -1,8 +1,9 @@
 {
     "@@context": "AboutPage",
+    "@@locale": "fr",
     "helloAndWelcome": "Welcome {firstName} von {lastName} <",
     "otherMsg": "other",
     "aboutMessage": "Sur {websitename}",
     "newMessages": "test {newMessages, plural, =0 {No new messages} =1 {One new message} two{Two new Messages} other {test {newMessages} new messages}}",
     "newMessages2": "test {gender, select,male {No new messages} female {One new message} other{Two new Messages} other {test {gender} new messages of type {newVar}}}"
-}
+}

pkgs/messages/example/assets/testarb.arb.json

@@ -0,0 +1 @@
+[0,"en","dr9Md951",1,null,["helloAndWelcome","Welcome  von !",[8,0],[13,1]],["helloAndWelcome2","Welcome  von !",[8,0],[13,1]],[6,"newMessages","test ",[3,0,["test  new messages",[5,0]],[0,"No new messages",1,"One new message","w2","Two new Messages"]]],[6,"newMessages2","test ",[4,0,"Two new Messages",{"male":"No new messages","female":"One new message"}]]]

pkgs/messages/example/assets/testarb_de.arb.json

@@ -0,0 +1 @@
+[0,"de","hbDN1MhX",1,null,["helloAndWelcome","Willkommen  von ",[11,0],[16,1]],["helloAndWelcome2","Willkommen  von  2",[11,0],[16,1]],[6,"newMessages","testde ",[3,0,["test  new messages",[5,0]],[0,"No new messages",1,"One new message","w2","Two new Messages"]]],["newMessages2","testdse is just a simple message"]]

pkgs/messages/example/assets/testarbctx2.arb.json

@@ -0,0 +1 @@
+[0,"en","QrwRSsOy",1,null,["aboutMessage","About ",[6,0]],["helloAndWelcome","Welcome  von  <",[8,0],[13,1]],[6,"newMessages","test ",[3,0,["test  new messages",[5,0]],[0,"No new messages",1,"One new message","w2","Two new Messages"]]],[6,"newMessages2","test ",[4,0,"Two new Messages",{"male":"No new messages","female":"One new message"}]],["otherMsg","other"]]

pkgs/messages/example/assets/testarbctx2_fr.arb.json

@@ -0,0 +1 @@
+[0,"fr","390XWry3",1,null,["aboutMessage","Sur ",[4,0]],["helloAndWelcome","Welcome  von  <",[8,0],[13,1]],[6,"newMessages","test ",[3,0,["test  new messages",[5,0]],[0,"No new messages",1,"One new message","w2","Two new Messages"]]],[6,"newMessages2","test ",[4,0,"Two new Messages",{"male":"No new messages","female":"One new message"}]],["otherMsg","other"]]

pkgs/messages/example_json/bin/example.dart → pkgs/messages/example/bin/example.dart

@@ -6,11 +6,11 @@
 
 import 'dart:io';
 
-import 'package:example_json/testarbctx2.g.dart';
+import 'package:example/messages.g.dart';
 
 Future<void> main(List<String> arguments) async {
-  final messages =
-      AboutPageMessages((String id) async => File(id).readAsString());
+  final messages = AboutPageMessages(
+      (id) => File(id.substring(id.indexOf('/') + 1)).readAsString());
   // final index = AboutPageMessagesEnum.aboutMessage;
 
   await messages.loadLocale('en');

pkgs/messages/example/lib/messages.g.dart

@@ -0,0 +1,172 @@
+// Generated by package:messages_builder.
+
+// ignore_for_file: non_constant_identifier_names
+
+import 'package:intl/intl.dart';
+import 'package:messages/messages_json.dart';
+
+Message _pluralSelector(
+  num howMany,
+  String locale, {
+  required Message other,
+  Message? few,
+  Message? many,
+  Map<int, Message>? numberCases,
+  Map<int, Message>? wordCases,
+}) {
+  return Intl.pluralLogic(
+    howMany,
+    few: few,
+    many: many,
+    zero: numberCases?[0] ?? wordCases?[0],
+    one: numberCases?[1] ?? wordCases?[1],
+    two: numberCases?[2] ?? wordCases?[2],
+    other: other,
+    locale: locale,
+  );
+}
+
+class AboutPageMessages {
+  AboutPageMessages(this._fileLoader);
+
+  final Future<String> Function(String id) _fileLoader;
+
+  String _currentLocale = 'en';
+
+  final Map<String, MessageList> _messages = {};
+
+  static const _dataFiles = {
+    'en': ('package:example/assets/testarbctx2.arb.json', 'QrwRSsOy'),
+    'fr': ('package:example/assets/testarbctx2_fr.arb.json', '390XWry3')
+  };
+
+  String get currentLocale => _currentLocale;
+
+  MessageList get _currentMessages => _messages[currentLocale]!;
+
+  String getById(
+    String id, [
+    List<dynamic> args = const [],
+  ]) {
+    return _currentMessages.generateStringAtId(id, args);
+  }
+
+  static Iterable<String> get knownLocales => _dataFiles.keys;
+
+  Future<void> loadLocale(String locale) async {
+    if (!_messages.containsKey(locale)) {
+      final info = _dataFiles[locale];
+      final carb = info?.$1;
+      if (carb == null) {
+        throw ArgumentError('Locale $locale is not in $knownLocales');
+      }
+      final data = await _fileLoader(carb);
+      final messageList = MessageListJson.fromString(data, _pluralSelector);
+      if (messageList.preamble.hash != info?.$2) {
+        throw ArgumentError('''
+              Messages file for locale $locale has different hash "${messageList.preamble.hash}" than generated code "${info?.$2}".''');
+      }
+      _messages[locale] = messageList;
+    }
+    _currentLocale = locale;
+  }
+
+  Future<void> loadAllLocales() async {
+    for (final locale in knownLocales) {
+      await loadLocale(locale);
+    }
+  }
+
+  String aboutMessage(String websitename) =>
+      _currentMessages.generateStringAtIndex(0, [websitename]);
+
+  String helloAndWelcome(
+    String firstName,
+    int lastName,
+  ) =>
+      _currentMessages.generateStringAtIndex(1, [firstName, lastName]);
+
+  String newMessages(int newMessages) =>
+      _currentMessages.generateStringAtIndex(2, [newMessages]);
+
+  String newMessages2(
+    String gender,
+    int newVar,
+  ) =>
+      _currentMessages.generateStringAtIndex(3, [gender, newVar]);
+
+  String get otherMsg => _currentMessages.generateStringAtIndex(4, []);
+}
+
+class HomePageMessages {
+  HomePageMessages(this._fileLoader);
+
+  final Future<String> Function(String id) _fileLoader;
+
+  String _currentLocale = 'en';
+
+  final Map<String, MessageList> _messages = {};
+
+  static const _dataFiles = {
+    'de': ('package:example/assets/testarb_de.arb.json', 'hbDN1MhX'),
+    'en': ('package:example/assets/testarb.arb.json', 'dr9Md951')
+  };
+
+  String get currentLocale => _currentLocale;
+
+  MessageList get _currentMessages => _messages[currentLocale]!;
+
+  String getById(
+    String id, [
+    List<dynamic> args = const [],
+  ]) {
+    return _currentMessages.generateStringAtId(id, args);
+  }
+
+  static Iterable<String> get knownLocales => _dataFiles.keys;
+
+  Future<void> loadLocale(String locale) async {
+    if (!_messages.containsKey(locale)) {
+      final info = _dataFiles[locale];
+      final carb = info?.$1;
+      if (carb == null) {
+        throw ArgumentError('Locale $locale is not in $knownLocales');
+      }
+      final data = await _fileLoader(carb);
+      final messageList = MessageListJson.fromString(data, _pluralSelector);
+      if (messageList.preamble.hash != info?.$2) {
+        throw ArgumentError('''
+              Messages file for locale $locale has different hash "${messageList.preamble.hash}" than generated code "${info?.$2}".''');
+      }
+      _messages[locale] = messageList;
+    }
+    _currentLocale = locale;
+  }
+
+  Future<void> loadAllLocales() async {
+    for (final locale in knownLocales) {
+      await loadLocale(locale);
+    }
+  }
+
+  String helloAndWelcome(
+    String firstName,
+    String lastName,
+  ) =>
+      _currentMessages.generateStringAtIndex(0, [firstName, lastName]);
+
+  String helloAndWelcome2(
+    String firstName,
+    String lastName,
+  ) =>
+      _currentMessages.generateStringAtIndex(1, [firstName, lastName]);
+
+  String newMessages(int newMessages) =>
+      _currentMessages.generateStringAtIndex(2, [newMessages]);
+
+  String newMessages2(
+    String gender,
+    int newVar,
+  ) =>
+      _currentMessages.generateStringAtIndex(3, [gender, newVar]);
+}