The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Serge-1.4
River stage two • 10 direct dependents • 10 total dependents
1 ++

Changes for version 1.4

  • Support `--lang` parameter in `serge pull-ts` and `serge push-ts` (gives an ability to specify one or more languages which should be synchronized with the translation service). Previously this parameter worked only for `serge sync` and `serge localize` and only affected the localization step.
  • Properly handle `leave_untranslated_blank` job option in .properties, .ts, .rrc and .strings parsers (previously this option wouldn't affect untranslated strings in the generated localized files leaving source string values instead).
  • POT parser can now generate compiled .mo files in addition to producing localized .po files.
  • Make Serge installable via `./Build install`
  • Git plugin now always uses `reset --hard` instead of `rebase` when doing updates so that it can recover from history rewrites on a remote server.
  • Better error reporting when spawning child processes.
  • `output_default_lang_file` config setting now works correctly with the `limit_languages` plugin. Additionally, the list of target languages is now de-duplicated and sorted before job runs.
  • Implemented cache eviction optimizations to make sure the process uses less memory on large databases.
  • Implemented four different caching strategies ('db', 'namespace', 'file', and 'string') that can be set with SERGE_DB_CACHING_STRATEGY environment variable. The more granular the level, the less memory Serge uses, at the potential expense of longer execution time. The default is 'db', which is backward-compatible with the old behavior where the entire database would be cached in memory.
  • `add_dev_comment` callback is now deprecated in favor of `add_hint` callback which provides more parameters than the old one.
  • New `keys_language` plugin that allows one to generate globally unique keys in place of translation. An ability to uniquely address any string opens possibilities for some advanced techniques like dynamic localization and integration with external tools.
  • parse_ts parser improved to support proper string literal escaping/unescaping, which now supports sequences like \NNN, \xNN, \uNNNN, \u{NNNNN}. \n and \t sequences are properly converted to raw line breaks and tabulation symbols, respectively.
  • parse_master can now be configured to use custom opening/closing markers and delimiters.
  • Added feature branch config generator tool (see `bin/tools/feature-branch-config-generator` folder for the tool itself, examples and documentation). This tool scans your Git repository, determines the list of actively maintained branches that match the provided name masks, and generates a Serge config to localize all these branches based on the provided config template.
  • `if` plugin can now capture content using regular expressions and keep it around for child plugin classes, as well as use them in test statements (`has_capture`, `has_no_capture`, `has_all_captures`). `append_hint_message` plugin can now replace `%CAPTURE:...%` macros with the values of such captures. This is useful, for example, to extract a specific string from the header of the source file and expose it as a hint (comment) in all translation units.
  • Net::SMTP is now used instead of deprecated Net::SMTP::SSL.
  • An ability to use XLIFF 1.2 as a translation interchange format added (previously the only supported interchange format was .po). Using XLIFF for translation might come in handy when working with certain CAT tools or online services.
  • Added `rewrite_relative_ts_file_path` and `rewrite_absolute_ts_file_path` phases that allow one to manipulate TS file names with plugins.
  • Added `after_serialize_ts_file` and `before_deserialize_ts_file` phases that allow one to manipulate the translation interchange file contents.
  • Added `apply_xslt` plugin, which allows one to apply XSLT transformations to source or target XML resource files, as well as XLIFF translation interchange files.
  • Split `pootle` and `zing` translation plugins for better clarity.
  • Git sync plugin now supports 'fetch_params', `commit_params` and `push_params` configuration parameters in addition to a previously existed `clone_params`. This allows one to pass extra parameters to `git` during different stages of its work. This is useful for e.g. shallow cloning and fetching, or for bypassing commit and push hooks.
  • Improved `transform` plugin logic to make trailing punctuation detection more smart when it is combined with wrapper tags. It also deals better with whitespace, reducing the list of candidates to guess transformations for.
  • `transform` plugin now always returns guessed translations as fuzzy; its previous configuration parameters (`as_fuzzy_default`, `as_fuzzy` and `as_not_fuzzy`) are now deprecated. You will see a corresponding notice in the command line output if you still have these parameters in your configuration file.
  • Fixed a bug where `reuse_orphaned` job parameter would not be passed down to the code that expected it, which resulted in not reusing orphaned translations in the `transform` plugin.
  • Refactored `feature_branch` plugin to more accurately reuse master branch translations in dependent branches. This required to selectively disable optimizations when localizing master files, so handling localization with `feature_branch` might become a bit slower.
  • `parse_keyvalue` plugin now exports keys explicitly (in addition to extracting them as translation hints).
  • Added support for `use_keys_as_context` job parameter (#89).
  • Added new `show` command to display expanded .serge configurations (#40).
  • Miscellaneous smaller fixes and improvements.

Documentation

clear_merge_flags.pl
Clear all merge flags from the database.
copy_db.pl
Migrate data between translation databases
fbcgen.pl
Feature branch config generator.
guess_transformation.pl
Run transformation plugin against the given string.
normalize_database_whitespace.pl
Normalizes leading/trailing whitespaces for all translations in the database
serge-clean-ts
Delete orphaned translation files
serge-gendocs
Generate HTML docs from POD
serge-help
Show help on Serge and its commands
serge-import
Import translations from already existing resource files
serge-localize
Perform localization cycle
serge-pull-ts
Pull translation files from translation server
serge-pull
Pull project files from source control
serge-push-ts
Push translation files to translation server
serge-push
Push project files to source control
serge-show
Show expanded version of a configuration file
serge-sync
Perform a full synchronization + localization cycle
serge-test-parser
Test parser against any given file
serge
Serge command launcher

Modules

Serge
Solution for continuous localization

Provides

Serge::Application
in lib/Serge/Application.pm
Serge::Command
in lib/Serge/Command.pm
Serge::Command::clean_ts
in lib/Serge/Command/clean_ts.pm
Serge::Command::gendocs
in lib/Serge/Command/gendocs.pm
Serge::Command::help
in lib/Serge/Command/help.pm
Serge::Command::import
in lib/Serge/Command/import.pm
Serge::Command::show
in lib/Serge/Command/show.pm
Serge::Command::sync
in lib/Serge/Command/sync.pm
Serge::Command::test_parser
in lib/Serge/Command/test_parser.pm
Serge::Config
in lib/Serge/Config.pm
Serge::Config::Collector
in lib/Serge/Config/Collector.pm
Serge::DB
in lib/Serge/DB.pm
Serge::DB::Cached
in lib/Serge/DB/Cached.pm
Serge::Engine
in lib/Serge/Engine.pm
Serge::Engine::Job
in lib/Serge/Engine/Job.pm
Serge::Engine::Plugin::Base::Parser
in lib/Serge/Engine/Plugin/Base/Parser.pm
Serge::Engine::Plugin::Base::Serializer
in lib/Serge/Engine/Plugin/Base/Serializer.pm
Serge::Engine::Plugin::Base::Transform
in lib/Serge/Engine/Plugin/Base/Transform.pm
Serge::Engine::Plugin::Transform::case
in lib/Serge/Engine/Plugin/Transform/case.pm
Serge::Engine::Plugin::Transform::endpunc
in lib/Serge/Engine/Plugin/Transform/endpunc.pm
Serge::Engine::Plugin::Transform::tags
in lib/Serge/Engine/Plugin/Transform/tags.pm
Serge::Engine::Plugin::Transform::whitespace
in lib/Serge/Engine/Plugin/Transform/whitespace.pm
Serge::Engine::Plugin::Transform::wrappertag
in lib/Serge/Engine/Plugin/Transform/wrappertag.pm
Serge::Engine::Plugin::append_hint_message
in lib/Serge/Engine/Plugin/append_hint_message.pm
Serge::Engine::Plugin::apply_xslt
in lib/Serge/Engine/Plugin/apply_xslt.pm
Serge::Engine::Plugin::completeness
in lib/Serge/Engine/Plugin/completeness.pm
Serge::Engine::Plugin::control_commands
in lib/Serge/Engine/Plugin/control_commands.pm
Serge::Engine::Plugin::feature_branch
in lib/Serge/Engine/Plugin/feature_branch.pm
Serge::Engine::Plugin::if
in lib/Serge/Engine/Plugin/if.pm
Serge::Engine::Plugin::keys_language
in lib/Serge/Engine/Plugin/keys_language.pm
Serge::Engine::Plugin::limit_languages
in lib/Serge/Engine/Plugin/limit_languages.pm
Serge::Engine::Plugin::metaparser
in lib/Serge/Engine/Plugin/metaparser.pm
Serge::Engine::Plugin::parse_android
in lib/Serge/Engine/Plugin/parse_android.pm
Serge::Engine::Plugin::parse_bypass
in lib/Serge/Engine/Plugin/parse_bypass.pm
Serge::Engine::Plugin::parse_chrome_json
in lib/Serge/Engine/Plugin/parse_chrome_json.pm
Serge::Engine::Plugin::parse_csv
in lib/Serge/Engine/Plugin/parse_csv.pm
Serge::Engine::Plugin::parse_dtd
in lib/Serge/Engine/Plugin/parse_dtd.pm
Serge::Engine::Plugin::parse_go
in lib/Serge/Engine/Plugin/parse_go.pm
Serge::Engine::Plugin::parse_hash
in lib/Serge/Engine/Plugin/parse_hash.pm
Serge::Engine::Plugin::parse_js
in lib/Serge/Engine/Plugin/parse_js.pm
Serge::Engine::Plugin::parse_json
in lib/Serge/Engine/Plugin/parse_json.pm
Serge::Engine::Plugin::parse_json_keyvalue
in lib/Serge/Engine/Plugin/parse_json_keyvalue.pm
Serge::Engine::Plugin::parse_key_space_value
in lib/Serge/Engine/Plugin/parse_key_space_value.pm
Serge::Engine::Plugin::parse_keyvalue
in lib/Serge/Engine/Plugin/parse_keyvalue.pm
Serge::Engine::Plugin::parse_master
in lib/Serge/Engine/Plugin/parse_master.pm
Serge::Engine::Plugin::parse_php_xhtml
in lib/Serge/Engine/Plugin/parse_php_xhtml.pm
Serge::Engine::Plugin::parse_plist
in lib/Serge/Engine/Plugin/parse_plist.pm
Serge::Engine::Plugin::parse_pot
in lib/Serge/Engine/Plugin/parse_pot.pm
Serge::Engine::Plugin::parse_properties
in lib/Serge/Engine/Plugin/parse_properties.pm
Serge::Engine::Plugin::parse_rc
in lib/Serge/Engine/Plugin/parse_rc.pm
Serge::Engine::Plugin::parse_resx
in lib/Serge/Engine/Plugin/parse_resx.pm
Serge::Engine::Plugin::parse_rrc
in lib/Serge/Engine/Plugin/parse_rrc.pm
Serge::Engine::Plugin::parse_strings
in lib/Serge/Engine/Plugin/parse_strings.pm
Serge::Engine::Plugin::parse_ts
in lib/Serge/Engine/Plugin/parse_ts.pm
Serge::Engine::Plugin::parse_wxl
in lib/Serge/Engine/Plugin/parse_wxl.pm
Serge::Engine::Plugin::parse_xliff
in lib/Serge/Engine/Plugin/parse_xliff.pm
Serge::Engine::Plugin::parse_xml
in lib/Serge/Engine/Plugin/parse_xml.pm
Serge::Engine::Plugin::parse_yaml
in lib/Serge/Engine/Plugin/parse_yaml.pm
Serge::Engine::Plugin::process_if
in lib/Serge/Engine/Plugin/process_if.pm
Serge::Engine::Plugin::replace_strings
in lib/Serge/Engine/Plugin/replace_strings.pm
Serge::Engine::Plugin::run_command
in lib/Serge/Engine/Plugin/run_command.pm
Serge::Engine::Plugin::serialize_csv
in lib/Serge/Engine/Plugin/serialize_csv.pm
Serge::Engine::Plugin::serialize_po
in lib/Serge/Engine/Plugin/serialize_po.pm
Serge::Engine::Plugin::serialize_xliff
in lib/Serge/Engine/Plugin/serialize_xliff.pm
Serge::Engine::Plugin::test_language
in lib/Serge/Engine/Plugin/test_language.pm
Serge::Engine::Plugin::trademarks
in lib/Serge/Engine/Plugin/trademarks.pm
Serge::Engine::Plugin::transform
in lib/Serge/Engine/Plugin/transform.pm
Serge::Engine::Processor
in lib/Serge/Engine/Processor.pm
Serge::FindFiles
in lib/Serge/FindFiles.pm
Serge::Importer
in lib/Serge/Importer.pm
Serge::Interface::PluginHost
in lib/Serge/Interface/PluginHost.pm
Serge::Interface::SysCmdRunner
in lib/Serge/Interface/SysCmdRunner.pm
Serge::Mail
in lib/Serge/Mail.pm
Serge::Plugin::Base
in lib/Serge/Plugin/Base.pm
Serge::Plugin::Base::Callback
in lib/Serge/Plugin/Base/Callback.pm
Serge::Pod
in lib/Serge/Pod.pm
Serge::ScanTSFiles
in lib/Serge/ScanTSFiles.pm
Serge::Sync
in lib/Serge/Sync.pm
Serge::Sync::Plugin::Base::TranslationService
in lib/Serge/Sync/Plugin/Base/TranslationService.pm
Serge::Sync::Plugin::Base::VCS
in lib/Serge/Sync/Plugin/Base/VCS.pm
Serge::Sync::Plugin::TranslationService::command
in lib/Serge/Sync/Plugin/TranslationService/command.pm
Serge::Sync::Plugin::TranslationService::pootle
in lib/Serge/Sync/Plugin/TranslationService/pootle.pm
Serge::Sync::Plugin::TranslationService::zing
in lib/Serge/Sync/Plugin/TranslationService/zing.pm
Serge::Sync::Plugin::VCS::gerrit
in lib/Serge/Sync/Plugin/VCS/gerrit.pm
Serge::Sync::Plugin::VCS::git
in lib/Serge/Sync/Plugin/VCS/git.pm
Serge::Sync::Plugin::VCS::mercurial
in lib/Serge/Sync/Plugin/VCS/mercurial.pm
Serge::Sync::Plugin::VCS::svn
in lib/Serge/Sync/Plugin/VCS/svn.pm
Serge::Sync::Util
in lib/Serge/Sync/Util.pm
Serge::Util
in lib/Serge/Util.pm
Serge::Util::CLDRPlurals
in lib/Serge/Util/CLDRPlurals.pm
Serge::Util::LangID
in lib/Serge/Util/LangID.pm
Serge::Util::Pager
in lib/Serge/Util/Pager.pm
Serge::Util::WordStats
in lib/Serge/Util/WordStats.pm

Examples

Other files