Intl_translation #

This package provides message extraction and code generation from translated messages for the Intl package. It's a separate package so as to not require a dependency on analyzer for all users.

Extracting And Using Translated Messages #

When your program contains messages that need translation, these must be extracted from the program source, sent to human translators, and the results need to be incorporated.

To extract messages, run the extract_to_arb.dart program.

  pub run intl_translation:extract_to_arb --output-dir=target/directory
      my_program.dart more_of_my_program.dart

This will produce a file intl_messages.arb with the messages from all of these programs. an [ARB] (https://code.google.com/p/arb/wiki/ApplicationResourceBundleSpecification) format file which can be used for input to translation tools like Google Translator Toolkit The resulting translations can be used to generate a set of libraries using the generate_from_arb.dart program.

This expects to receive a series of files, one per locale.

pub run intl_translation:generate_from_arb --generated-file-prefix=<prefix>
    <my_dart_files> <translated_ARB_files>

This will generate Dart libraries, one per locale, which contain the translated versions. Your Dart libraries can import the primary file, named <prefix>messages_all.dart, and then call the initialization for a specific locale. Once that's done, any Intl.message calls made in the context of that locale will automatically print the translated version instead of the original.

  import "my_prefix_messages_all.dart";
  ...
  initializeMessages("dk").then(printSomeMessages);

Once the future returned from the initialization call returns, the message data is available.

0.17.0 #

Fully move to Dart 2.0
Delete the transformer and related code.
Minor update to analyzer API.
Update pubspec version requirements

0.16.8 #

Allow message extraction to find messages from prefixed uses of Intl.
Move analyzer dependency up to 0.33.0

0.16.7 #

Allow message extraction to find messages in class field declarations and top-level declarations.
Fix incorrect name and parameters propagation during extraction phase.
Still more uppercase constant removal.

0.16.6 #

More uppercase constant removal.

0.16.5 #

Replace uses of JSON constant for Dart 2 compatibility.

0.16.4 #

Update Intl compatibility requirements. This requires at least 0.15.3 of Intl, because the tests contain messages with the new "skip" parameter.

0.16.3 #

Fix https://github.com/flutter/flutter/issues/15458 - specify concrete type for generated map.

0.16.2 #

Handle fallback better when we provide translations for locale "xx" but initialize "xx_YY", initializing "xx". Previously we would do nothing.
Skip extracting messages that pass the 'skip' argument to Intl calls.
Move analyzer dependency up to 0.32.0

0.16.1 #

Add @@last_modified to extracted ARB files.
Handle @@locale in translated ARB files properly, and adds a --locale parameter to specify the locale.
Adds a --output-file parameter to extract_to_arb
Indent the output file for ARB for better readability.
A couple of tweaks to satisfy Flutter's default linter rules when run on the generated code.

0.16.0 #

BREAKING CHANGE: Require that the examples to message/plural/gender/select calls be const. DDC does not optimize non-const maps well, so it's a significant performance issue if these are non-const.
Added a utility to convert examples in calls to be const. See bin/make_examples_const.dart
Add a codegen_mode flag, which can be either release or debug. In release mode a missing translation throws an exception, in debug mode it returns the original text, which was the previous behavior.
Add support for generating translated messages as JSON rather than methods. This can significantly improve dart2js compile times for applications with many translations. The JSON is a literal string in the deferred library, so usage doesn't change at all.

0.15.0 #

Change non-transformer message rewriting to preserve the original message as much as possible. Adds --useStringSubstitution command-line arg.
Change non-transformer message rewriting to allow multiple input files to be specified on the command line. Adds --replace flag to ignore --output option and just replace files.
Make non-transformer message rewriting also run dartfmt on the output.
Make message extraction more robust: error message instead of stack trace when an Intl call is made outside a method, when a prefixed expression is used in an interpolation, and when a non-required example Map is not a literal.
Make message extraction more robust: if parsing triggers an exception then report it as an error instead of exiting.
Move barback to being a normal rather than a dev dependency.
Add a check for invalid select keywords.
Added a post-message construction validate, moved IntlMessageExtractionException into intl_message.dart
Make use of analyzer's new AstFactory class (requires analyzer version 0.29.1).
Fix error in transformer, pass the path instead of the asset id.
Prefer an explicit =0/=1/=2 to a ZERO/ONE/TWO if both are present. We don't distinguish the two as Intl.message arguments, we just have the "one" parameter, which we confusingly write out as =1. Tools interpret these differently, and in particular, a ONE clause is used for the zero case if there's no explicit zero. Translation tools may implement this by filling in both ZERO and ONE values with the OTHER clause when there's no ZERO provided, resulting in a translation with both =1 and ONE clauses which are different. We should prefer the explicit =1 in that case. In future we may distinguish the different forms, but that would probably break existing translations.
Switch to using package:test
Give a more specific type in the generated code to keep lints happy.

0.14.0 #

Split message extraction and code generation out into a separate package. Versioned to match the corresponding Intl version.

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  intl_translation: ^0.17.0

2. Install it

You can install packages from the command line:

with pub:


$ pub get

with Flutter:


$ flutter packages get

Alternatively, your editor might support pub get or flutter packages get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:intl_translation/extract_messages.dart';
import 'package:intl_translation/generate_localized.dart';

Version	Uploaded	Documentation	Archive
0.17.3	Feb 12, 2019
0.17.2	Oct 1, 2018
0.17.1	Sep 28, 2018
0.17.0	Jul 17, 2018
0.16.8	Jul 5, 2018
0.16.7	May 17, 2018
0.16.6	Apr 11, 2018
0.16.5	Apr 10, 2018
0.16.4	Mar 21, 2018
0.16.3	Mar 12, 2018

All 16 versions...

Popularity: Describes how popular the package is relative to other packages. [more]	98
Health: Code health derived from static analysis. [more]	93
Maintenance: Reflects how tidy and up-to-date the package is. [more]	90
Overall: Weighted score of the above. [more]	95

Learn more about scoring.

We analyzed this package on Feb 14, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

Dart: 2.1.0
pana: 0.12.13

Platforms

Detected platforms: Flutter, other

Platform components identified in package: io, isolate.

Health suggestions

Fix lib/src/intl_message.dart. (-3.45 points)

Analysis of lib/src/intl_message.dart reported 7 hints, including:

line 133 col 33: Use = to separate a named parameter from its default value.

line 133 col 63: Use = to separate a named parameter from its default value.

line 141 col 25: Use isNotEmpty for Iterables and Maps.

line 439 col 33: Use = to separate a named parameter from its default value.

line 439 col 63: Use = to separate a named parameter from its default value.

Fix bin/extract_to_arb.dart. (-1 points)

Analysis of bin/extract_to_arb.dart reported 2 hints:

line 59 col 7: Use isEmpty instead of length

line 130 col 26: Use = to separate a named parameter from its default value.

Fix bin/generate_from_arb.dart. (-1 points)

Analysis of bin/generate_from_arb.dart reported 2 hints:

line 79 col 7: Use isEmpty instead of length

line 79 col 32: Use isEmpty instead of length

Fix additional 4 files with analysis or formatting issues. (-2 points)

Additional issues in the following files:

bin/make_examples_const.dart (1 hint)
bin/rewrite_intl_messages.dart (1 hint)
lib/generate_localized.dart (1 hint)
lib/src/message_rewriter.dart (1 hint)

Maintenance suggestions

Maintain an example. (-10 points)

Create a short demo in the example/ directory to show how to use this package.

Common filename patterns include main.dart, example.dart, and intl_translation.dart. Packages with multiple examples should provide example/README.md.

For more information see the pub package layout conventions.

Dependencies

Package	Constraint	Resolved	Available
Direct dependencies
Dart SDK	>=2.0.0-dev.33.0 <3.0.0
analyzer	>=0.32.1 <0.33.0	0.32.6	0.35.1
args	>=0.12.1 <2.0.0	1.5.1
dart_style	^1.0.0	1.1.3	1.2.3
intl	>=0.15.3 <0.16.0	0.15.7
path	>=0.9.0 <2.0.0	1.6.2
petitparser	>=1.1.3 <2.0.0	1.7.7	2.1.1
Transitive dependencies
async		2.0.8
charcode		1.1.2
collection		1.14.11
convert		2.1.1
crypto		2.0.6
csslib		0.14.6
front_end		0.1.4+2	0.1.11
glob		1.1.7
html		0.13.3+3
kernel		0.3.4+2	0.3.11
logging		0.11.3+2
matcher		0.12.4
meta		1.1.7
package_config		1.0.5
plugin		0.2.0+3
source_span		1.5.4
stack_trace		1.9.3
string_scanner		1.0.4
term_glyph		1.1.0
typed_data		1.1.6
utf		0.9.0+5
watcher		0.9.7+10
yaml		2.1.15
Dev dependencies
test	^1.2.0

Dart pub