blob: 54c77a7f62535efed31fc31143c2c2021d8fc8ef [file] [log] [blame]
#!/usr/bin/env python
# -*- coding: utf-8 -*-
# crowdin_sync.py
#
# Updates Crowdin source translations and pushes translations
# directly to LineageOS' Gerrit.
#
# Copyright (C) 2014-2015 The CyanogenMod Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# ################################# IMPORTS ################################## #
from __future__ import print_function
import argparse
import git
import os
import subprocess
import sys
from xml.dom import minidom
# ################################# GLOBALS ################################## #
_DIR = os.path.dirname(os.path.realpath(__file__))
_COMMITS_CREATED = False
# ################################ FUNCTIONS ################################# #
def run_subprocess(cmd, silent=False):
p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
universal_newlines=True)
comm = p.communicate()
exit_code = p.returncode
if exit_code != 0 and not silent:
print("There was an error running the subprocess.\n"
"cmd: %s\n"
"exit code: %d\n"
"stdout: %s\n"
"stderr: %s" % (cmd, exit_code, comm[0], comm[1]),
file=sys.stderr)
return comm, exit_code
def push_as_commit(base_path, path, name, branch, username, ticket):
if 'stable/' in base_path:
branch = ''.join(('stable/', branch))
print('Committing %s on branch %s' % (name, branch))
# Get path
path = os.path.join(base_path, path)
if not path.endswith('.git'):
path = os.path.join(path, '.git')
# Create repo object
repo = git.Repo(path)
# Remove previously deleted files from Git
files = repo.git.ls_files(d=True).split('\n')
if files and files[0]:
repo.git.rm(files)
# Add all files to commit
repo.git.add('-A')
# Create commit; if it fails, probably empty so skipping
if ticket:
message = '''Automatic translation import
Ticket: %s''' % ticket
else:
message = 'Automatic translation import'
try:
repo.git.commit(m=message)
except:
print('Failed to create commit for %s, probably empty: skipping'
% name, file=sys.stderr)
return
# Push commit
try:
repo.git.push('ssh://%s@review.lineageos.org:29418/%s' % (username, name),
'HEAD:refs/for/%s%%topic=translation' % branch)
print('Successfully pushed commit for %s' % name)
except:
print('Failed to push commit for %s' % name, file=sys.stderr)
_COMMITS_CREATED = True
def check_run(cmd):
p = subprocess.Popen(cmd, stdout=sys.stdout, stderr=sys.stderr)
ret = p.wait()
if ret != 0:
print('Failed to run cmd: %s' % ' '.join(cmd), file=sys.stderr)
sys.exit(ret)
def find_xml(base_path):
for dp, dn, file_names in os.walk(base_path):
for f in file_names:
if os.path.splitext(f)[1] == '.xml':
yield os.path.join(dp, f)
# ############################################################################ #
def parse_args():
parser = argparse.ArgumentParser(
description="Synchronising LineageOS' translations with Crowdin")
parser.add_argument('-u', '--username', help='Gerrit username')
parser.add_argument('-b', '--branch', help='LineageOS branch',
required=True)
parser.add_argument('-c', '--config', help='Custom yaml config')
parser.add_argument('-t', '--ticket', help='JIRA ticket')
parser.add_argument('--upload-sources', action='store_true',
help='Upload sources to Crowdin')
parser.add_argument('--upload-translations', action='store_true',
help='Upload translations to Crowdin')
parser.add_argument('--download', action='store_true',
help='Download translations from Crowdin')
return parser.parse_args()
# ################################# PREPARE ################################## #
def check_dependencies():
# Check for Ruby version of crowdin-cli
cmd = ['gem', 'list', 'crowdin-cli', '-i']
if run_subprocess(cmd, silent=True)[1] != 0:
print('You have not installed crowdin-cli.', file=sys.stderr)
return False
return True
def load_xml(x):
try:
return minidom.parse(x)
except IOError:
print('You have no %s.' % x, file=sys.stderr)
return None
except Exception:
# TODO: minidom should not be used.
print('Malformed %s.' % x, file=sys.stderr)
return None
def check_files(files):
for f in files:
if not os.path.isfile(f):
print('You have no %s.' % f, file=sys.stderr)
return False
return True
# ################################### MAIN ################################### #
def upload_sources_crowdin(branch, config):
if config:
print('\nUploading sources to Crowdin (custom config)')
check_run(['crowdin-cli',
'--config=%s/config/%s' % (_DIR, config),
'upload', 'sources', '--branch=%s' % branch])
else:
print('\nUploading sources to Crowdin (AOSP supported languages)')
check_run(['crowdin-cli',
'--config=%s/config/%s.yaml' % (_DIR, branch),
'upload', 'sources', '--branch=%s' % branch])
print('\nUploading sources to Crowdin (non-AOSP supported languages)')
check_run(['crowdin-cli',
'--config=%s/config/%s_aosp.yaml' % (_DIR, branch),
'upload', 'sources', '--branch=%s' % branch])
def upload_translations_crowdin(branch, config):
if config:
print('\nUploading translations to Crowdin (custom config)')
check_run(['crowdin-cli',
'--config=%s/config/%s' % (_DIR, config),
'upload', 'translations', '--branch=%s' % branch,
'--no-import-duplicates', '--import-eq-suggestions',
'--auto-approve-imported'])
else:
print('\nUploading translations to Crowdin '
'(AOSP supported languages)')
check_run(['crowdin-cli',
'--config=%s/config/%s.yaml' % (_DIR, branch),
'upload', 'translations', '--branch=%s' % branch,
'--no-import-duplicates', '--import-eq-suggestions',
'--auto-approve-imported'])
print('\nUploading translations to Crowdin '
'(non-AOSP supported languages)')
check_run(['crowdin-cli',
'--config=%s/config/%s_aosp.yaml' % (_DIR, branch),
'upload', 'translations', '--branch=%s' % branch,
'--no-import-duplicates', '--import-eq-suggestions',
'--auto-approve-imported'])
def download_crowdin(base_path, branch, xml, username, config, ticket):
if config:
print('\nDownloading translations from Crowdin (custom config)')
check_run(['crowdin-cli',
'--config=%s/config/%s' % (_DIR, config),
'download', '--branch=%s' % branch])
else:
print('\nDownloading translations from Crowdin '
'(AOSP supported languages)')
check_run(['crowdin-cli',
'--config=%s/config/%s.yaml' % (_DIR, branch),
'download', '--branch=%s' % branch])
print('\nDownloading translations from Crowdin '
'(non-AOSP supported languages)')
check_run(['crowdin-cli',
'--config=%s/config/%s_aosp.yaml' % (_DIR, branch),
'download', '--branch=%s' % branch])
print('\nRemoving useless empty translation files')
empty_contents = {
'<resources/>',
'<resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2"/>',
('<resources xmlns:android='
'"http://schemas.android.com/apk/res/android"/>'),
('<resources xmlns:android="http://schemas.android.com/apk/res/android"'
' xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2"/>'),
('<resources xmlns:tools="http://schemas.android.com/tools"'
' xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2"/>')
}
xf = None
for xml_file in find_xml(base_path):
xf = open(xml_file).read()
for line in empty_contents:
if line in xf:
print('Removing ' + xml_file)
os.remove(xml_file)
break
del xf
print('\nCreating a list of pushable translations')
# Get all files that Crowdin pushed
paths = []
if config:
files = ['%s/config/%s' % (_DIR, config)]
else:
files = ['%s/config/%s.yaml' % (_DIR, branch),
'%s/config/%s_aosp.yaml' % (_DIR, branch)]
for c in files:
cmd = ['crowdin-cli', '--config=%s' % c, 'list', 'project',
'--branch=%s' % branch]
comm, ret = run_subprocess(cmd)
if ret != 0:
sys.exit(ret)
for p in str(comm[0]).split("\n"):
paths.append(p.replace('/%s' % branch, ''))
print('\nUploading translations to Gerrit')
items = [x for sub in xml for x in sub.getElementsByTagName('project')]
all_projects = []
for path in paths:
path = path.strip()
if not path:
continue
if "/res" not in path:
print('WARNING: Cannot determine project root dir of '
'[%s], skipping.' % path)
continue
result = path.split('/res')[0].strip('/')
if result == path.strip('/'):
print('WARNING: Cannot determine project root dir of '
'[%s], skipping.' % path)
continue
if result in all_projects:
continue
# When a project has multiple translatable files, Crowdin will
# give duplicates.
# We don't want that (useless empty commits), so we save each
# project in all_projects and check if it's already in there.
all_projects.append(result)
# Search android/default.xml or config/%(branch)_extra_packages.xml
# for the project's name
for project in items:
path = project.attributes['path'].value
if not (result + '/').startswith(path +'/'):
continue
if result != path:
if path in all_projects:
break
result = path
all_projects.append(result)
br = project.getAttribute('revision') or branch
push_as_commit(base_path, result,
project.getAttribute('name'), br, username, ticket)
break
def main():
args = parse_args()
default_branch = args.branch
if 'stable/' in default_branch:
base_path_env = 'CM_CROWDIN_STABLE_BASE_PATH'
base_path = os.getenv(base_path_env)
default_branch = default_branch.replace('stable/', '')
else:
base_path_env = 'CM_CROWDIN_BASE_PATH'
base_path = os.getenv(base_path_env)
if base_path is None:
cwd = os.getcwd()
print('You have not set %s. Defaulting to %s' % (base_path_env, cwd))
base_path = cwd
else:
base_path = os.path.join(os.path.realpath(base_path), default_branch)
if not os.path.isdir(base_path):
print('%s + branch is not a real directory: %s'
% (base_path_env, base_path))
sys.exit(1)
if not check_dependencies():
sys.exit(1)
xml_android = load_xml(x='%s/android/default.xml' % base_path)
if xml_android is None:
sys.exit(1)
xml_extra = load_xml(x='%s/config/%s_extra_packages.xml'
% (_DIR, default_branch))
if xml_extra is None:
sys.exit(1)
xml_cm = load_xml(x='%s/android/snippets/cm.xml' % base_path)
if xml_cm is None:
xml_cm = load_xml(x='%s/android/snippets/hal_cm_all.xml' % base_path)
if xml_cm is not None:
xml_files = (xml_android, xml_cm, xml_extra)
else:
xml_files = (xml_android, xml_extra)
if args.config:
files = ['%s/config/%s' % (_DIR, args.config)]
else:
files = ['%s/config/%s.yaml' % (_DIR, default_branch),
'%s/config/%s_aosp.yaml' % (_DIR, default_branch)]
if not check_files(files):
sys.exit(1)
if args.download and args.username is None:
print('Argument -u/--username is required for translations download')
sys.exit(1)
if args.upload_sources:
upload_sources_crowdin(default_branch, args.config)
if args.upload_translations:
upload_translations_crowdin(default_branch, args.config)
if args.download:
download_crowdin(base_path, default_branch, xml_files,
args.username, args.config, args.ticket)
if _COMMITS_CREATED:
print('\nDone!')
sys.exit(0)
else:
print('\nNothing to commit')
sys.exit(-1)
if __name__ == '__main__':
main()