Add async initialization for Intl.message and an example

pkg/intl/example/basic/basic_example.dart

Index: pkg/intl/example/basic/basic_example.dart
===================================================================
--- pkg/intl/example/basic/basic_example.dart	(revision 0)
+++ pkg/intl/example/basic/basic_example.dart	(revision 0)
@@ -0,0 +1,67 @@
+// Copyright (c) 2012, 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.
+
+/**
+ * This provides a basic example of internationalization usage. It uses the
+ * local variant of all the facilities, meaning that libraries with the
+ * data for all the locales are directly imported by the program. More realistic
+ * examples might read the data from files or over the web, which uses the
+ * same APIs but requires different imports.
+ *
+ * This defines messages for an English locale directly in the program and
+ * has separate libraries that define German and Thai messages that say more or
+ * less the same thing, and prints the message with the date and time in it
+ * formatted appropriately for the locale.
+ */
+
+#library('intl_basic_example');
+// These can be replaced with package:intl/... references if using this in
+// a separate package.

[Emily Fortuna, 2012/09/12 01:23:48]

why not use package:intl references here too to set a complete example?

[Alan Knight, 2012/09/12 20:58:20]

Sadly, I had them, but took them out because I set it up to be used in a test,
rather than duplicating the logic to write a test, and the buildbots aren't
going to understand pub until post-M1.

[Emily Fortuna, 2012/09/12 21:55:59]

Ah. Fair enough. Can we add a TODO?

[Alan Knight, 2012/09/13 18:20:08]

Done.

+#import('../../date_format.dart');
+#import('../../date_symbol_data_local.dart');
+#import('../../intl.dart');
+#import('../../message_lookup_local.dart');
+#import('messages_all.dart');
+
+Function doThisWithTheOutput;
+
+void setup(Function program, Function output) {
+  // Before we use any messages or use date formatting for a locale we must
+  // call their initializtion messages, which are asynchronous, since they
+  // might be reading information from files or over the web. Since we are
+  // running here in local mode they will all complete immediately.
+  doThisWithTheOutput = output;
+  var germanDatesFuture = initializeDateFormatting('de_DE', null);
+  var thaiDatesFuture = initializeDateFormatting('th_TH', null);
+  var germanMessagesFuture = initializeMessages('de_DE');
+  var thaiMessagesFuture = initializeMessages('th_TH');
+  Futures.wait([germanDatesFuture, thaiDatesFuture, germanMessagesFuture,
+                thaiMessagesFuture]).then(program);
+}
+
+// Because the initialization messages return futures we split out the main
+// part of our program into a separate function that runs once all the
+// futures have completed. We are passed the collection of futures, but we
+// don't need to use them, so ignore the parameter.
+runProgram(_) {

[Emily Fortuna, 2012/09/12 01:23:48]

I don't quite understand why you're passed a collection of futures. In
intl_message_test_using_example.dart it looks like you're just passing in the
print function(?) Maybe I'm mis-reading this.

If you're going to pass a not used argument, I'd still give the _ a type, and
maybe call it "notUsed" (_ is also an okay name, though)

[Alan Knight, 2012/09/12 20:58:20]

runProgram is called in the "then" call from Futures.wait on locale
initialization, so it gets the result, which is a collection of the Futures that
were waited on. 

The call from the test was wrong, and didn't get caught because the name didn't
end in _test, so it wasn't run. Fixed.

I liked the _ convention without a type because it made the thing visually
minimal, making it easy to ignore. But I put in a type.

[Emily Fortuna, 2012/09/12 21:55:59]

Fair enough. I'm convinced. Feel free to disregard my suggestion then.

[Alan Knight, 2012/09/13 18:20:08]

Done :-)

+  var aDate = new Date.fromMillisecondsSinceEpoch(0, true);
+  var de = new Intl('de_DE');
+  var th = new Intl('th_TH');
+  // This defines a message that can be internationalized. It is written as a
+  // function that returns the result of an Intl.message call. The primary
+  // parameter is a string that may use interpolation.
+  runAt(time, date) =>
+      Intl.message('Ran at $time on $date', name: 'runAt', args: [time, date]);
+  printForLocale(aDate, new Intl(), runAt);
+  printForLocale(aDate, de, runAt);
+  printForLocale(aDate, th, runAt);
+}
+
+printForLocale(aDate, intl, operation) {
+  var hmsFormat = intl.date().add_Hms();
+  var dayFormat = intl.date().add_yMMMMEEEEd();
+  var time = hmsFormat.format(aDate);
+  var day = dayFormat.format(aDate);
+  Intl.withLocale(intl.locale, () { doThisWithTheOutput(operation(time,day));});
+}