feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/command_lib/transcoder/flags.py

@@ -0,0 +1,87 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google LLC. All Rights Reserved.
+#
+# 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.
+"""A library containing flags used by Transcoder commands."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import actions
+
+
+def AddCreateJobFlags(parser):
+  """Add a list of flags for create jobs."""
+  job_config = parser.add_mutually_exclusive_group()
+  job_config.add_argument('--json', help='Job config in json format.')
+  job_config.add_argument('--file', help='Path to job config.')
+  job_config.add_argument('--template-id', help='Job template id.')
+
+  parser.add_argument(
+      '--input-uri',
+      help=(
+          'Google Cloud Storage URI. This value '
+          'will override input URI in job config.'
+      ),
+  )
+  parser.add_argument(
+      '--output-uri',
+      help=(
+          'Google Cloud Storage directory URI '
+          '(followed by a trailing forward slash). This value '
+          'will override output URI in job config.'
+      ),
+  )
+  parser.add_argument(
+      '--mode',
+      choices=['PROCESSING_MODE_INTERACTIVE', 'PROCESSING_MODE_BATCH'],
+      help=(
+          'Processing mode of transcode job. This value '
+          'will override mode in job config.'
+      ),
+  )
+  parser.add_argument(
+      '--batch-mode-priority',
+      type=int,
+      help=(
+          'Processing priority of a batch mode transcoder job. This value '
+          'will override batch mode priority in job config.'
+      ),
+  )
+  parser.add_argument(
+      '--optimization',
+      choices=['AUTODETECT', 'DISABLED'],
+      help=(
+          'Optimization strategy of transcode job. This value '
+          'will override optimization in job config.'
+      ),
+  )
+  parser.add_argument(
+      '--priority',
+      help='Job priority, default 0.',
+      hidden=True,
+      action=actions.DeprecationAction(
+          '--region',
+          warn='The {flag_name} option is deprecated.',
+          error='The {flag_name} option is removed.',
+          removed=True,
+      ),
+  )
+
+
+def AddCreateTemplateFlags(parser):
+  """Add a list of flags for create job templates."""
+  template_config = parser.add_mutually_exclusive_group(required=True)
+  template_config.add_argument('--json', help='Job template in json format.')
+  template_config.add_argument('--file', help='Path to job template.')

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/command_lib/transcoder/resource_args.py

@@ -0,0 +1,106 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google LLC. All Rights Reserved.
+#
+# 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.
+
+"""A library containing resource args used by Transcoder commands."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope.concepts import concepts
+from googlecloudsdk.calliope.concepts import deps
+from googlecloudsdk.command_lib.util.concepts import concept_parsers
+from googlecloudsdk.core import properties
+
+
+def LocationAttributeConfig():
+  fallthroughs = [
+      deps.PropertyFallthrough(properties.VALUES.transcoder.location)
+  ]
+  return concepts.ResourceParameterAttributeConfig(
+      name='location',
+      help_text='Transcoder location for resources',
+      fallthroughs=fallthroughs)
+
+
+def TemplateAttributeConfig():
+  return concepts.ResourceParameterAttributeConfig(
+      name='template_id', help_text='Transcoder template id for job')
+
+
+def JobAttributeConfig():
+  return concepts.ResourceParameterAttributeConfig(
+      name='job_name', help_text='Transcoder job name')
+
+
+def GetLocationResourceSpec():
+  return concepts.ResourceSpec(
+      'transcoder.projects.locations',
+      resource_name='location',
+      locationsId=LocationAttributeConfig(),
+      projectsId=concepts.DEFAULT_PROJECT_ATTRIBUTE_CONFIG)
+
+
+def GetJobResourceSpec():
+  """Constructs and returns the Resource specification for Job."""
+
+  return concepts.ResourceSpec(
+      'transcoder.projects.locations.jobs',
+      resource_name='job',
+      jobsId=JobAttributeConfig(),
+      projectsId=concepts.DEFAULT_PROJECT_ATTRIBUTE_CONFIG,
+      locationsId=LocationAttributeConfig(),
+      disable_auto_completers=False)
+
+
+def GetTemplateResourceSpec():
+  """Constructs and returns the Resource specification for Job Template."""
+
+  return concepts.ResourceSpec(
+      'transcoder.projects.locations.jobTemplates',
+      resource_name='jobTemplate',
+      jobTemplatesId=TemplateAttributeConfig(),
+      projectsId=concepts.DEFAULT_PROJECT_ATTRIBUTE_CONFIG,
+      locationsId=LocationAttributeConfig(),
+      disable_auto_completers=False)
+
+
+def AddLocationResourceArg(parser):
+  """Constructs and returns the Location Resource Argument."""
+  return concept_parsers.ConceptParser.ForResource(
+      '--location',
+      GetLocationResourceSpec(),
+      'Transcoder location',
+      required=True).AddToParser(parser)
+
+
+def AddJobResourceArg(parser):
+  """Constructs and returns the Job Resource Argument."""
+
+  return concept_parsers.ConceptParser.ForResource(
+      'job_name',
+      GetJobResourceSpec(),
+      'Transcoder Job name',
+      required=True).AddToParser(parser)
+
+
+def AddTemplateResourceArg(parser):
+  """Constructs and returns Job Template Resource Argument."""
+
+  return concept_parsers.ConceptParser.ForResource(
+      'template_id',
+      GetTemplateResourceSpec(),
+      'Transcoder job template id',
+      required=True).AddToParser(parser)

gcloud auth application-default login/google-cloud-sdk/lib/googlecloudsdk/command_lib/transcoder/util.py

@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google LLC. All Rights Reserved.
+#
+# 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.
+
+"""A library containing resource args used by Transcoder commands."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import exceptions as calliope_exceptions
+from googlecloudsdk.core.util import files
+
+
+def GetContent(file_path, content):
+  """Get job or template data."""
+
+  if content is not None:
+    return content
+
+  if file_path is not None:
+    try:
+      return files.ReadFileContents(file_path)
+    except files.Error as e:
+      raise calliope_exceptions.BadFileException('Failed to read {}, {}'
+                                                 .format(file_path, e))
+
+  return None
+
+
+def ValidateCreateJobArguments(args):
+  """Valid parameters for create job command."""
+
+  missing = None
+  # when using (default)template to create job, input/output uri are required
+  if args.file is None and args.json is None:
+    input_uri = args.input_uri
+    output_uri = args.output_uri
+
+    if input_uri is None:
+      missing = 'input-uri'
+    elif output_uri is None:
+      missing = 'output-uri'
+
+  if missing is not None:
+    raise calliope_exceptions.RequiredArgumentException(
+        '--{}'.format(missing),
+        '{} is required when using template to create job'.format(missing))