Revert "Add gsutil 4.13 to telemetry/third_party"

tools/telemetry/third_party/gsutil/gslib/help_provider.py

-# -*- coding: utf-8 -*-
-# Copyright 2012 Google Inc. 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.
-"""Module defining help types and providers for gsutil commands."""
-
-from __future__ import absolute_import
-
-import collections
-from gslib.exception import CommandException
-
-ALL_HELP_TYPES = ['command_help', 'additional_help']
-
-# Constants enforced by SanityCheck
-MAX_HELP_NAME_LEN = 15
-MIN_ONE_LINE_SUMMARY_LEN = 10
-MAX_ONE_LINE_SUMMARY_LEN = 80 - MAX_HELP_NAME_LEN
-
-DESCRIPTION_PREFIX = """
-<B>DESCRIPTION</B>"""
-
-SYNOPSIS_PREFIX = """
-<B>SYNOPSIS</B>"""
-
-
-class HelpProvider(object):
-  """Interface for providing help."""
-
-  # Each subclass of HelpProvider define a property named 'help_spec' that is
-  # an instance of the following class.
-  HelpSpec = collections.namedtuple('HelpSpec', [
-      # Name of command or auxiliary help info for which this help applies.
-      'help_name',
-      # List of help name aliases.
-      'help_name_aliases',
-      # Type of help.
-      'help_type',
-      # One line summary of this help.
-      'help_one_line_summary',
-      # The full help text.
-      'help_text',
-      # Help text for subcommands of the command's help being specified.
-      'subcommand_help_text',
-  ])
-
-  # Each subclass must override this with an instance of HelpSpec.
-  help_spec = None
-
-
-# This is a static helper instead of a class method because the help loader
-# (gslib.commands.help._LoadHelpMaps()) operates on classes not instances.
-def SanityCheck(help_provider, help_name_map):
-  """Helper for checking that a HelpProvider has minimally adequate content."""
-  # Sanity check the content.
-  assert (len(help_provider.help_spec.help_name) > 1
-          and len(help_provider.help_spec.help_name) < MAX_HELP_NAME_LEN)
-  for hna in help_provider.help_spec.help_name_aliases:
-    assert hna
-  one_line_summary_len = len(help_provider.help_spec.help_one_line_summary)
-  assert (one_line_summary_len > MIN_ONE_LINE_SUMMARY_LEN
-          and one_line_summary_len < MAX_ONE_LINE_SUMMARY_LEN)
-  assert len(help_provider.help_spec.help_text) > 10
-
-  # Ensure there are no dupe help names or aliases across commands.
-  name_check_list = [help_provider.help_spec.help_name]
-  name_check_list.extend(help_provider.help_spec.help_name_aliases)
-  for name_or_alias in name_check_list:
-    if help_name_map.has_key(name_or_alias):
-      raise CommandException(
-          'Duplicate help name/alias "%s" found while loading help from %s. '
-          'That name/alias was already taken by %s' % (
-              name_or_alias, help_provider.__module__,
-              help_name_map[name_or_alias].__module__))
-
-
-def CreateHelpText(synopsis, description):
-  """Helper for adding help text headers given synopsis and description."""
-  return SYNOPSIS_PREFIX + synopsis + DESCRIPTION_PREFIX + description