CHANGELOG

5.3

Add translation:pull and translation:push commands to manage translations with third-party providers
Add TranslatorBagInterface::getCatalogues method
Add support to load XLIFF string in XliffFileLoader

added support for calling trans with ICU formatted messages
added PseudoLocalizationTranslator
added TranslatableMessage objects that represent a message that can be translated
added the t() function to easily create TranslatableMessage objects
Added support for extracting messages from TranslatableMessage objects

added support for name attribute on unit element from xliff2 to be used as a translation key instead of always the source element

removed support for using null as the locale in Translator
removed TranslatorInterface
removed MessageSelector
removed ChoiceMessageFormatterInterface
removed PluralizationRule
removed Interval
removed transChoice() methods, use the trans() method instead with a %count% parameter
removed FileDumper::setBackup() and TranslationWriter::disableBackup()
removed MessageFormatter::choiceFormat()
added argument $filename to PhpExtractor::parseTokens()
removed support for implicit STDIN usage in the lint:xliff command, use lint:xliff - (append a dash) instead to make it explicit.

deprecated support for using null as the locale in Translator
deprecated accepting STDIN implicitly when using the lint:xliff command, use lint:xliff - (append a dash) instead to make it explicit.
Marked the TranslationDataCollector class as @final.

Started using ICU parent locales as fallback locales.
allow using the ICU message format using domains with the "+intl-icu" suffix
deprecated Translator::transChoice() in favor of using Translator::trans() with a %count% parameter
deprecated TranslatorInterface in favor of Symfony\Contracts\Translation\TranslatorInterface
deprecated MessageSelector, Interval and PluralizationRules; use IdentityTranslator instead
Added IntlFormatter and IntlFormatterInterface
added support for multiple files and directories in XliffLintCommand
Marked Translator::getFallbackLocales() and TranslationDataCollector::getFallbackLocales() as internal

The FileDumper::setBackup() method is deprecated.
The TranslationWriter::disableBackup() method is deprecated.
The XliffFileDumper will write "name" on the "unit" node when dumping XLIFF 2.0.

removed the backup feature of the FileDumper class
removed TranslationWriter::writeTranslations() method
removed support for passing MessageSelector instances to the constructor of the Translator class

Added TranslationDumperPass
Added TranslationExtractorPass
Added TranslatorPass
Added TranslationReader and TranslationReaderInterface
Added <notes> section to the Xliff 2.0 dumper.
Improved Xliff 2.0 loader to load <notes> section.
Added TranslationWriterInterface
Deprecated TranslationWriter::writeTranslations in favor of TranslationWriter::write
added support for adding custom message formatter and decoupling the default one.
Added PhpExtractor
Added PhpStringTokenParser

removed FileDumper::format() method.
Changed the visibility of the locale property in Translator from protected to private.

deprecated FileDumper::format(), overwrite FileDumper::formatCatalogue() instead.
deprecated Translator::getMessages(), rely on TranslatorBagInterface::getCatalogue() instead.
added FileDumper::formatCatalogue which allows format the catalogue without dumping it into file.
added option json_encoding to JsonFileDumper
added options as_tree, inline to YamlFileDumper
added support for XLIFF 2.0.
added support for XLIFF target and tool attributes.
added message parameters to DataCollectorTranslator.
[DEPRECATION] The DiffOperation class has been deprecated and will be removed in Symfony 3.0, since its operation has nothing to do with 'diff', so the class name is misleading. The TargetOperation class should be used for this use-case instead.

added possibility to cache catalogues
added TranslatorBagInterface
added LoggingTranslator
added Translator::getMessages() for retrieving the message catalogue as an array

added classes to make operations on catalogues (like making a diff or a merge on 2 catalogues)
added Translator::getFallbackLocales()
deprecated Translator::setFallbackLocale() in favor of the new Translator::setFallbackLocales() method

QtTranslationsLoader class renamed to QtFileLoader. QtTranslationsLoader is deprecated and will be removed in 2.3.
[BC BREAK] uniformized the exception thrown by the load() method when an error occurs. The load() method now throws Symfony\Component\Translation\Exception\NotFoundResourceException when a resource cannot be found and Symfony\Component\Translation\Exception\InvalidResourceException when a resource is invalid.
changed the exception class thrown by some load() methods from \RuntimeException to \InvalidArgumentException (IcuDatFileLoader, IcuResFileLoader and QtFileLoader)