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

cms/translations/xtm/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
@@ skipping 423 matching lines @@
 
     with open(file_path, 'wb') as f:
         f.write(data)
 
 
 def input_fn(text):
     try:
         return raw_input(text)
     except Exception:
         return input(text)
+
+
+def extract_workflow_id(api, args):
+    """Extract the workflow id, using the arguments provided by the user.
+
+    Parameters
+    ----------
+    api: XTMCloudAPI
+        Used to interact with the XTM API.
+    args: argparse.Namespace
+        With the arguments provided to the script.
+
+    Returns
+    -------
+    int
+        With the corresponding workflow id.
+
+    Raises
+    ------
+    XTMCloudException
+        If the API communication fails in any way.
+    Exception
+        In one of the following situations:
+            1. If both `--workflow-id` and `--workflow-name` are provided.
+            2. If none of the parameters above are provided.
+            3. If there are no workflows associated with a given name.
+
+    """
+    if args.workflow_id and args.workflow_name:
+        raise Exception(const.ErrorMessages.WORKFLOW_NAME_AND_ID_PROVIDED)
+
+    if not (args.workflow_id or args.workflow_name):
+        raise Exception(const.ErrorMessages.NO_WORKFLOW_INFO)
+
+    if args.workflow_id:
+        return args.workflow_id
+
+    possible_ids = api.get_workflows_by_name(args.workflow_name)
+
+    if len(possible_ids) == 0:
+        raise Exception(const.ErrorMessages.NO_WORKFLOW_FOR_NAME.format(
+            args.workflow_name))
+
+    return possible_ids[0]