Feature/basic plurals support

README.md

@@ -188,3 +188,26 @@ String description({
   @required String var1,
 })
 ```
+
+If the variables are not provided, the String will be given without replacing the variables placeholders.
+
+### Plurals
+
+Plurals are possible thanks to dart's [Intl.plural](https://api.flutter.dev/flutter/intl/Intl/plural.html) method. In order to select the correct plural form, six alternatives must be given: `zero`, `one`, `two`, `few`, `many` and `other`. An explanation about these alternatives can be found [here](http://cldr.unicode.org/index/cldr-spec/plural-rules).
+
+These alternatives must be given in the form `|alt1:alt2:alt3:alt4:alt5:alt6|`, that is, surrounded by `|` and separated with `:`.
+
+```
+pluralTest,Time left: %seconds$d |seconds:second:seconds:seconds:seconds:seconds|,Verbleibende Zeit: %seconds$d |Sekunden:Sekunde:Sekunden:Sekunden:Sekunden:Sekunden|,Pozostały czas: %seconds$d |sekund:sekunda:sekundy:sekund:sekund:sekund|
+```
+
+`pluralTest` would then be parsed with the following function signature: `String pluralTest({@required int seconds})` and could be used as follows:
+
+|seconds|en|de|pl|
+|:-:|-|-|-|
+|0|Time left: 0 seconds|Verbleibende Zeit: 0 Sekunden|Pozostały czas: 0 sekund|
+|1|Time left: 1 second|Verbleibende Zeit: 1 Sekunde|Pozostały czas: 1 sekunda|
+|2|Time left: 2 seconds|Verbleibende Zeit: 2 Sekunden|Pozostały czas: 2 sekundy|
+|5|Time left: 5 seconds|Verbleibende Zeit: 5 Sekunden|Pozostały czas: 5 sekund|
+
+Note that only one plural per key is presently supported.

example/lib/main.dart

@@ -31,6 +31,8 @@ class Home extends StatelessWidget {
               Text(I18n.of(context).appTitle),
               Text(I18n.of(context).description(var1: '2')),
               Text(I18n.of(context).littleTest(age: 32)),
+              Text(I18n.of(context).pluralTest(seconds: 24)),
+              Text(I18n.of(context).pluralTest(seconds: 1)),
             ],
           ),
         ),

example/pubspec.yaml

@@ -11,6 +11,7 @@ dependencies:
   flutter_localizations:
     sdk: flutter
   cupertino_icons: ^0.1.2
+  intl: ^0.16.1
 
 dev_dependencies:
   flappy_translator:

example/test.csv

@@ -2,4 +2,5 @@ keys,fr,en,es,de_CH
 appTitle,Ma super application,My awesome application,Mi gran application,Meine tolle App
 subtitle,Un sous titre,A subtitle,Un subtitulò,Ein Untertitel
 description,Un texte avec une variable : %1$s,Text with a variable: %1$s,Un texto con una variable : %1$s,Text mit einer Variable: %1$s
-littleTest,"Voici, pour l'exemple, ""un test"" avec la variable %age$d","Here is, for the example, ""a test"" with the variable %age$d","Aqui esta, por ejemplo, ""una prueba"" con la variable %age$d","Hier ist, zum Beispiel, ""ein Test"" mit der Variable %age$d"
+littleTest,"Voici, pour l'exemple, ""un test"" avec la variable %age$d","Here is, for the example, ""a test"" with the variable %age$d","Aqui esta, por ejemplo, ""una prueba"" con la variable %age$d","Hier ist, zum Beispiel, ""ein Test"" mit der Variable %age$d"
+pluralTest,Temps restant: %seconds$d |seconde:second:secondes:secondes:secondes:secondes|,Time left: %seconds$d |seconds:second:seconds:seconds:seconds:seconds|,Tiempo que queda: %seconds$d |segundos:segundo:segundos:segundos:segundos:segundos|,Verbleibende Zeit: %seconds$d |Sekunden:Sekunde:Sekunden:Sekunden:Sekunden:Sekunden|

lib/src/services/code_generation/code_generator.dart

@@ -1,4 +1,7 @@
+import 'dart:io';
+
 import 'package:dart_style/dart_style.dart';
+import 'package:flappy_translator/src/utils/flappy_logger.dart';
 
 import '../../configs/constants.dart' as constants;
 import '../../configs/default_settings.dart';
@@ -10,6 +13,7 @@ class CodeGenerator {
   final String _quoteString;
   final bool replaceNoBreakSpaces;
   final _parametersRegex = RegExp(r'(\%[[0-9a-zA-Z]+]*\$(d|s))');
+  final _pluralsRegexp = RegExp(r'\|(.*?)\|');
 
   String _template;
   List<Map<String, String>> _maps;
@@ -77,8 +81,15 @@ class CodeGenerator {
   }
 
   void addField(String key, String defaultWord, List<String> words) {
+    if (_pluralsRegexp.allMatches(defaultWord).length > 1) {
+      FlappyLogger.logError(
+          'Key $key contains multiple plurals. Only one plural per key is supported.');
+      exit(0);
+    }
+
     var result = '';
     final hasParameters = _parametersRegex.hasMatch(defaultWord);
+    final hasPlural = _pluralsRegexp.hasMatch(defaultWord);
     if (hasParameters) {
       var parameters = '';
       final matches = _parametersRegex.allMatches(defaultWord).toList();
@@ -103,8 +114,42 @@ class CodeGenerator {
         ''';
       }
 
+      if (hasPlural) {
+        final plurals = _pluralsRegexp
+            .firstMatch(defaultWord)
+            .group(0)
+            .replaceAll('|', '')
+            .split(':');
+        if (plurals.length != 6) {
+          FlappyLogger.logError(
+              'Incorrect number of plurals given in $defaultWord. Must give 6.');
+          exit(0);
+        }
+
+        final varName =
+            _getParameterNameFromPlaceholder(matches.first.group(0));
+        result += '''
+        final _pluralsRegExp = RegExp(r"\\\|(.*?)\\\|");
+        final plurals = _pluralsRegExp.firstMatch(_text).group(0).replaceAll('|', '').split(':');
+        if(plurals.length != 6) {
+          return 'Issue with key $key. Incorrect number of plurals.';
+        }
+        return Intl.plural(
+              $varName,
+              zero: _text.replaceAll(_pluralsRegExp, plurals[0]),
+              one: _text.replaceAll(_pluralsRegExp, plurals[1]),
+              two: _text.replaceAll(_pluralsRegExp, plurals[2]),
+              few: _text.replaceAll(_pluralsRegExp, plurals[3]),
+              many: _text.replaceAll(_pluralsRegExp, plurals[4]),
+              other: _text.replaceAll(_pluralsRegExp, plurals[5]),
+            );
+
+        ''';
+      } else {
+        result += 'return _text;';
+      }
+
       result += '''
-      return _text;
 
       }
       ''';

lib/src/services/code_generation/template.dart

@@ -6,6 +6,7 @@ abstract class Template {
 import 'dart:async';
 
 import 'package:flutter/material.dart';
+import 'package:intl/intl.dart';
 
 /// A  class generated by flappy_translator package containing localized strings
 class #CLASS_NAME# {

test/services/code_generation/code_generator_test.dart

@@ -125,6 +125,7 @@ void main() {
 import 'dart:async';
 
 import 'package:flutter/material.dart';
+import 'package:intl/intl.dart';
 
 /// A  class generated by flappy_translator package containing localized strings
 class I18n {
@@ -188,6 +189,7 @@ class I18nDelegate extends LocalizationsDelegate<I18n> {
 import 'dart:async';
 
 import 'package:flutter/material.dart';
+import 'package:intl/intl.dart';
 
 /// A  class generated by flappy_translator package containing localized strings
 class I18n {
@@ -261,6 +263,7 @@ class I18nDelegate extends LocalizationsDelegate<I18n> {
 import 'dart:async';
 
 import 'package:flutter/material.dart';
+import 'package:intl/intl.dart';
 
 /// A  class generated by flappy_translator package containing localized strings
 class I18n {

test/services/parsing/csv_parser_test.dart

@@ -34,6 +34,13 @@ void main() {
         "Aqui esta, por ejemplo, \"una prueba\" con la variable %age\$d",
         "Hier ist, zum Beispiel, \"ein Test\" mit der Variable %age\$d"
       ],
+      [
+        'pluralTest',
+        'Temps restant: %seconds\$d |seconde:second:secondes:secondes:secondes:secondes|',
+        'Time left: %seconds\$d |seconds:second:seconds:seconds:seconds:seconds|',
+        'Tiempo que queda: %seconds\$d |segundos:segundo:segundos:segundos:segundos:segundos|',
+        'Verbleibende Zeit: %seconds\$d |Sekunden:Sekunde:Sekunden:Sekunden:Sekunden:Sekunden|'
+      ],
     ]);
   });
 }

test/services/parsing/excel_parser_test.dart

@@ -25,6 +25,13 @@ void main() {
         "Aqui esta, por ejemplo, \"una prueba\" con la variable %age\$d",
         "Hier ist, zum Beispiel, \"ein Test\" mit der Variable %age\$d"
       ],
+      [
+        'pluralTest',
+        'Temps restant: %seconds\$d |seconde:second:secondes:secondes:secondes:secondes|',
+        'Time left: %seconds\$d |seconds:second:seconds:seconds:seconds:seconds|',
+        'Tiempo que queda: %seconds\$d |segundos:segundo:segundos:segundos:segundos:segundos|',
+        'Verbleibende Zeit: %seconds\$d |Sekunden:Sekunde:Sekunden:Sekunden:Sekunden:Sekunden|'
+      ],
     ]);
   });
 }