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

gcloud auth application-default login/google-cloud-sdk/lib/surface/artifacts/print_settings/__init__.py

@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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.
+"""Command group for Artifact Registry print-settings."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+class PrintSettings(base.Group):
+  """Print snippets to add to native tools settings files.
+
+  The snippets provide a credentials placeholder and configurations to allow
+  native tools to interact with Artifact Registry repositories.
+
+  ## EXAMPLES
+
+  To print a snippet to add a repository to the Gradle build.gradle file for
+  repository my-repo in the current project, run:
+
+      $ {command} gradle --repository=my-repo
+
+  To print a snippet to add to the Maven pom.xml file for repository my-repo in
+  the current project, run:
+
+      $ {command} mvn --repository=my-repo
+
+  To print a snippet to add to the npm .npmrc file for repository my-repo in
+  the current project, run:
+
+      $ {command} npm --repository=my-repo
+
+  To print a snippet to add to the Python .pypirc and pip.comf files for
+  repository my-repo in the current project, run:
+
+      $ {command} python --repository=my-repo
+  """
+
+  category = base.CI_CD_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/artifacts/print_settings/apt.py

@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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.
+"""Print credential settings to add to the sources.list file."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.artifacts import flags
+from googlecloudsdk.command_lib.artifacts.print_settings import settings_util
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class Apt(base.Command):
+  """Print settings to add to the sources.list.d directory.
+
+  Print settings to add to the sources.list.d directory for connecting to an Apt
+  repository.
+  """
+
+  detailed_help = {
+      "DESCRIPTION":
+          "{description}",
+      "EXAMPLES":
+          """\
+    To print a snippet for the repository set in the `artifacts/repository`
+    property in the default location:
+
+      $ {command}
+
+    To print a snippet for repository `my-repository` in the default location:
+
+      $ {command} --repository="my-repository"
+    """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.GetRepoFlag().AddToParser(parser)
+    parser.display_info.AddFormat("value(apt)")
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      An Apt settings snippet.
+    """
+
+    return {"apt": settings_util.GetAptSettingsSnippet(args)}

gcloud auth application-default login/google-cloud-sdk/lib/surface/artifacts/print_settings/gradle.py

@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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.
+"""Print a snippet to add a repository to the Gradle build.gradle file."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.artifacts import flags
+from googlecloudsdk.command_lib.artifacts.print_settings import settings_util
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Gradle(base.Command):
+  """Print a snippet to add a repository to the Gradle build.gradle file."""
+
+  detailed_help = {
+      "DESCRIPTION":
+          "{description}",
+      "EXAMPLES":
+          """\
+    To print a snippet for the repository set in the `artifacts/repository`
+    property in the default location:
+
+      $ {command}
+
+    To print a snippet for repository `my-repository` in the default location:
+
+      $ {command} --repository="my-repository"
+
+    To print a snippet using service account key:
+
+      $ {command} --json-key=path/to/key.json
+    """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.GetRepoFlag().AddToParser(parser)
+    flags.GetJsonKeyFlag("gradle").AddToParser(parser)
+    parser.display_info.AddFormat("value(gradle)")
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      A maven gradle snippet.
+    """
+
+    return {"gradle": settings_util.GetGradleSnippet(args)}

gcloud auth application-default login/google-cloud-sdk/lib/surface/artifacts/print_settings/mvn.py

@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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.
+"""Print a snippet to add a Maven repository to the pom.xml file."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.artifacts import flags
+from googlecloudsdk.command_lib.artifacts.print_settings import settings_util
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Maven(base.Command):
+  """Print a snippet to add a Maven repository to the pom.xml file."""
+
+  detailed_help = {
+      "DESCRIPTION":
+          "{description}",
+      "EXAMPLES":
+          """\
+    To print a snippet for the repository set in the `artifacts/repository`
+    property in the default location:
+
+      $ {command}
+
+    To print a snippet for repository `my-repository` in the default location:
+
+      $ {command} --repository="my-repository"
+
+    To print a snippet using service account key:
+
+      $ {command} --json-key=path/to/key.json
+    """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.GetRepoFlag().AddToParser(parser)
+    flags.GetJsonKeyFlag("maven").AddToParser(parser)
+    parser.display_info.AddFormat("value(mvn)")
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      A maven pom snippet.
+    """
+    return {"mvn": settings_util.GetMavenSnippet(args)}

gcloud auth application-default login/google-cloud-sdk/lib/surface/artifacts/print_settings/npm.py

@@ -0,0 +1,79 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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.
+"""Print credential settings to add to the .npmrc file."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.artifacts import flags
+from googlecloudsdk.command_lib.artifacts.print_settings import settings_util
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Npm(base.Command):
+  """Print credential settings to add to the .npmrc file.
+
+  Print credential settings to add to the .npmrc file for connecting to an npm
+  repository.
+  """
+
+  detailed_help = {
+      "DESCRIPTION":
+          "{description}",
+      "EXAMPLES":
+          """\
+    To print a snippet for the repository set in the `artifacts/repository`
+    property in the default location:
+
+      $ {command}
+
+    To print a snippet for repository `my-repository` in the default location:
+
+      $ {command} --repository="my-repository"
+
+    To print a snippet using service account key:
+
+      $ {command} --json-key=path/to/key.json
+
+    To print a snippet for the repository set in the `artifacts/repository`
+    property with scope @my-company:
+
+      $ {command} --scope=@my-company
+    """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.GetRepoFlag().AddToParser(parser)
+    flags.GetJsonKeyFlag("npm").AddToParser(parser)
+    flags.GetScopeFlag().AddToParser(parser)
+    parser.display_info.AddFormat("value(npm)")
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      An npm settings snippet.
+    """
+
+    return {"npm": settings_util.GetNpmSettingsSnippet(args)}

gcloud auth application-default login/google-cloud-sdk/lib/surface/artifacts/print_settings/python.py

@@ -0,0 +1,73 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2021 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.
+"""Print credential settings to add to the .pypirc and pip.conf file."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.artifacts import flags
+from googlecloudsdk.command_lib.artifacts.print_settings import settings_util
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Python(base.Command):
+  """Print credential settings to add to the .pypirc and pip.conf files.
+
+  Print credential settings to add to the .pypirc and pip.conf files for
+  connecting to a Python package repository.
+  """
+
+  detailed_help = {
+      "DESCRIPTION":
+          "{description}",
+      "EXAMPLES":
+          """\
+    To print a snippet for the repository set in the `artifacts/repository`
+    property in the default location:
+
+      $ {command}
+
+    To print a snippet for repository `my-repository` in the default location:
+
+      $ {command} --repository="my-repository"
+
+    To print a snippet using service account key:
+
+      $ {command} --json-key=path/to/key.json
+    """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.GetRepoFlag().AddToParser(parser)
+    flags.GetJsonKeyFlag("python").AddToParser(parser)
+    parser.display_info.AddFormat("value(python)")
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      A python settings snippet.
+    """
+
+    return {"python": settings_util.GetPythonSettingsSnippet(args)}

gcloud auth application-default login/google-cloud-sdk/lib/surface/artifacts/print_settings/yum.py

@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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.
+"""Print credential settings to add to the yum.repos.d directory."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.artifacts import flags
+from googlecloudsdk.command_lib.artifacts.print_settings import settings_util
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA)
+class Yum(base.Command):
+  """Print settings to add to the yum.repos.d directory.
+
+  Print settings to add to the yum.repos.d directory for connecting to a Yum
+  repository.
+  """
+
+  detailed_help = {
+      "DESCRIPTION":
+          "{description}",
+      "EXAMPLES":
+          """\
+    To print a snippet for the repository set in the `artifacts/repository`
+    property in the default location:
+
+      $ {command}
+
+    To print a snippet for repository `my-repository` in the default location:
+
+      $ {command} --repository="my-repository"
+    """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.GetRepoFlag().AddToParser(parser)
+    parser.display_info.AddFormat("value(yum)")
+
+  def Run(self, args):
+    """This is what gets called when the user runs this command.
+
+    Args:
+      args: an argparse namespace. All the arguments that were provided to this
+        command invocation.
+
+    Returns:
+      A Yum settings snippet.
+    """
+
+    return {"yum": settings_util.GetYumSettingsSnippet(args)}