crowdin_sync.py

Introduction

This script is used to synchronize SlimRom's translations with Crowdin's. Also, it can handle automatic commiting to Gerrit and pushing/downloading to/from Crowdin. Based on CyanogenMod's sync-script.

Prerequisites

The Ruby variant of crowdin-cli >= 0.5.2 is required for this to work.

\curl -sSL https://get.rvm.io | bash -s stable --ruby
source /home/your_username/.rvm/scripts/rvm # Add this to your .bashrc file!
rvm all do gem install crowdin-cli

python-git is used for Git integration.

sudo apt-get install python-git

Copy <omni_version>_extra_packages.xml to .repo/local_manifests of each <omni_version> tree to make sure you sync all the extra packages not included in the main manifest.

Executing

Export the following environment variables to set the API keys and the base path. Base path should contain all SlimRoms trees in subfolders, named after SlimRoms branches:

export SLIM_CROWDIN_API_KEY=your_api_key
export SLIM_CROWDIN_BASE_PATH=your_base_path

Execute:

./crowdin_sync.py --username your_gerrit_username --branch slim_version [--upload-sources] [--upload-translations] [--download]

Bugs

• When committing fails, the reason of it cannot be determined. Often this is just when there are no new translations, so the script will not exit when this happens.

Submitting changes

This repository is preconfigured to use the git-review plugin. More information can be found at: https://pypi.python.org/pypi/git-review

You can upload your change to gerrit with commands like these:

git add *
git commit
git review