Issue #7036 - [XTM Integration] Add support for providing workflow name

tests/utils.py

 # This file is part of the Adblock Plus web scripts,
 # Copyright (C) 2006-present eyeo GmbH
 #
 # Adblock Plus is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License version 3 as
 # published by the Free Software Foundation.
 #
 # Adblock Plus is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
 #
 # You should have received a copy of the GNU General Public License
 # along with Adblock Plus.  If not, see <http://www.gnu.org/licenses/>.
 
 import contextlib
 import os
 import signal
 import subprocess
 import time
 import zipfile
 from io import BytesIO
 
 import pytest
 
+from cms.translations.xtm.projects_handler import (
+    create_project, upload_files, download_files,
+)
+
 
 def get_dir_contents(path):
     # TODO: This function is duplicated in test_page_outputs.py.
     dirdata = {}
     for dirpath, dirnames, filenames in os.walk(path):
         for output_file in filenames:
             filepath = os.path.join(dirpath, output_file)
             with open(filepath) as f:
                 locale = os.path.split(os.path.split(filepath)[0])[1]
                 dirdata[os.path.join(locale, output_file)] = f.read().strip()
@@ skipping 37 matching lines @@
 
     with zipfile.ZipFile(memory_zip, 'w') as zf:
         for idx in range(len(file_names)):
             zf.writestr(file_names[idx], file_data[idx], zipfile.ZIP_DEFLATED)
 
     memory_zip.seek(0)
     return memory_zip
 
 
 def exception_test(func, exception, exp_msg, *args, **kw):
+    """Test if a function raises the correct exception.
+
+    Parameters
+    ----------
+    func: function
+        The function we're testing.
+    exception: classobj
+        The exception we expect to be raised.
+    exp_msg: str
+        The message we expect the exception to contain.
+
+    """
     with pytest.raises(exception) as err:
         func(*args, **kw)
 
     assert exp_msg in str(err.value)
+
+
+class XtmMockArgs:
+    """Mock arguments for the XTM integration script."""

[Vasily Kuznetsov, 2018/10/19 12:47:28]

Yay, docstrings!

+
+    class CreationArgsNamespace:
+        """Mock arguments for creating a new XTM project."""
+
+        name = 'bar'
+        desc = 'foo'
+        client_id = 10
+        ref_id = 'faz'
+        workflow_id = 20
+        save_id = False
+        source_dir = None
+        projects_func = staticmethod(create_project)
+        source_lang = 'en_US'
+        workflow_name = None
+
+    class UploadArgsNamespace:
+        """Mock arguments for uploading files to XTM for translation."""
+
+        source_dir = None
+        projects_func = staticmethod(upload_files)
+        no_overwrite = False
+
+    class DownloadArgsNamespace:
+        """Mock arguments for downloading translation from XTM."""
+
+        source_dir = None
+        projects_func = staticmethod(download_files)