Adds facilities for extracting Intl.message calls and generating code from translations

pkg/intl/lib/intl.dart

 // 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 library provides internationalization and localization. This includes
  * message formatting and replacement, date and number formatting and parsing,
  * and utilities for working with Bidirectional text.
  *
  * For things that require locale or other data, there are multiple different
@@ skipping 29 matching lines @@
  *                '1': 'one other person',
  *                'other': '$num_people other people'})} in $place.''''
  *
  * Usage examples:
  *      today(date) => Intl.message(
  *          "Today's date is $date",
  *          desc: 'Indicate the current date',
  *          examples: {'date' : 'June 8, 2012'});
  *      print(today(new DateTime.now());
  *
- *      msg({num_people, place}) => Intl.message(
+ *      msg(num_people, place) => Intl.message(

[Emily Fortuna, 2013/03/13 18:54:43]

So now we can take an arbitrary number of parameters for msg? I thought that was
the reason for taking the dictionary so that we could ensure msg always too the
same one argument, but could be passed multiple different items inside.

If you are changing this, we need to change the example on line 58.

[Alan Knight, 2013/03/14 17:49:05]

Yes, it can take an arbitrary number. I'm using Function.apply in the mechanism
using the "args" parameter. I think the original restriction was because we
didn't have that. The args and name parameters are currently mandatory, because
they're used in the runtime mechanism. That can change if we go beyond
generating additional code and start modifying the original, but right now that
doesn't happen. But they should also be in the examples.

[Emily Fortuna, 2013/03/14 19:45:00]

sgtm.

  *           '''I see ${Intl.plural(num_people,
  *             {'0': 'no one at all',
  *              '1': 'one other person',
  *              'other': '$num_people other people'})} in $place.'''',
  *          desc: 'Description of how many people are seen as program start.',
  *          examples: {'num_people': 3, 'place': 'London'});
  *
  * Calling `msg({'num_people': 2, 'place': 'Athens'});` would
  * produce "I see 2 other people in Athens." as output in the default locale.
  *
@@ skipping 60 matching lines @@
    * The values of [desc] and [examples] are not used at run-time but are only
    * made available to the translators, so they MUST be simple Strings available
    * at compile time: no String interpolation or concatenation.
    * The expected usage of this is inside a function that takes as parameters
    * the variables used in the interpolated string, and additionally also a
    * locale (optional).
    * Ultimately, the information about the enclosing function and its arguments
    * will be extracted automatically but for the time being it must be passed
    * explicitly in the [name] and [args] arguments.
    */
-  static Future<String> message(String message_str, {final String desc: '',
+  static message(String message_str, {final String desc: '',

[Emily Fortuna, 2013/03/13 18:54:43]

should the return type here be a String?

[Alan Knight, 2013/03/14 17:49:05]

Oh yeah, right. Got so caught up in it having been turned into a Future I just
took it out and forgot to put String back.

       final Map examples: const {}, String locale, String name,
       List<String> args}) {
     return messageLookup.lookupMessage(
         message_str, desc, examples, locale, name, args);
   }
 
   /**
    * Return the locale for this instance. If none was set, the locale will
    * be the default.
    */
@@ skipping 122 matching lines @@
 
   /**
    * Accessor for the current locale. This should always == the default locale,
    * unless for some reason this gets called inside a message that resets the
    * locale.
    */
   static String getCurrentLocale() {
     if (_defaultLocale == null) _defaultLocale = systemLocale;
     return _defaultLocale;
   }
+
+  toString() => "Intl($locale)";
 }