Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2026-06-08 18:08
repositories	[ DIR ]	drwxr-xr-x	2026-06-08 18:08
__init__.py	3.76 KB	-rw-r--r--	1980-01-01 08:00
copy_bundled_python.py	1.6 KB	-rw-r--r--	1980-01-01 08:00
install.py	2.69 KB	-rw-r--r--	1980-01-01 08:00
list.py	4.16 KB	-rw-r--r--	1980-01-01 08:00
post_process.py	1.49 KB	-rw-r--r--	1980-01-01 08:00
reinstall.py	1.52 KB	-rw-r--r--	1980-01-01 08:00
remove.py	1.87 KB	-rw-r--r--	1980-01-01 08:00
restore.py	2.16 KB	-rw-r--r--	1980-01-01 08:00
update.py	4.21 KB	-rw-r--r--	1980-01-01 08:00
update_macos_python.py	1.61 KB	-rw-r--r--	1980-01-01 08:00

Rename

# -*- coding: utf-8 -*- #
# Copyright 2013 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.

"""The super-group for the update manager."""

import argparse

from googlecloudsdk.calliope import base
from googlecloudsdk.core import config
from googlecloudsdk.core import log

@base.UniverseCompatible
@base.ReleaseTracks(base.ReleaseTrack.GA)
class Components(base.Group):
  """List, install, update, or remove Google Cloud CLI components.

The {command} command group lets you control which tools are installed
  in the Google Cloud CLI. It can be used to install, update and remove
  components of the Google Cloud CLI, ensuring a lean, up-to-date installation.

{command} regularly checks whether updates are available for the
  tools you already have installed, and gives you the opportunity to upgrade to
  the latest version.

Certain components have dependencies. {command} will install any dependencies,
  and during removal, any dependant components will be uninstalled
  automatically.

## EXAMPLES

To see all available components:

$ {command} list

To install a component you don't have:

$ {command} install COMPONENT

To remove a component you no longer need:

$ {command} remove COMPONENT

To update all components you have to their latest version:

$ {command} update

To update all installed components to version 1.2.3:

$ {command} update --version 1.2.3
  """

category = base.SDK_TOOLS_CATEGORY

@staticmethod
  def Args(parser):
    """Sets args for gcloud components."""
    # An override for the location to install components into.
    parser.add_argument('--sdk-root-override', required=False, hidden=True,
                        help='THIS ARGUMENT NEEDS HELP TEXT.')
    # A different URL to look at instead of the default.
    parser.add_argument('--snapshot-url-override', required=False, hidden=True,
                        help='THIS ARGUMENT NEEDS HELP TEXT.')
    # This is not a commonly used option.  You can use this flag to create a
    # Cloud SDK install for an OS other than the one you are running on.
    # Running the updater multiple times for different operating systems could
    # result in an inconsistent install.
    parser.add_argument('--operating-system-override', required=False,
                        hidden=True,
                        help='THIS ARGUMENT NEEDS HELP TEXT.')
    # This is not a commonly used option.  You can use this flag to create a
    # Cloud SDK install for a processor architecture other than that of your
    # current machine.  Running the updater multiple times for different
    # architectures could result in an inconsistent install.
    parser.add_argument('--architecture-override', required=False, hidden=True,
                        help='THIS ARGUMENT NEEDS HELP TEXT.')

# pylint:disable=g-missing-docstring
  def Filter(self, unused_tool_context, args):
    base.DisableUserProjectQuota()
    if config.INSTALLATION_CONFIG.IsAlternateReleaseChannel():
      log.warning('You are using alternate release channel: [%s]',
                  config.INSTALLATION_CONFIG.release_channel)
      # Always show the URL if using a non standard release channel.
      log.warning('Snapshot URL for this release channel is: [%s]',
                  config.INSTALLATION_CONFIG.snapshot_url)