| Index: third_party/gsutil/gslib/commands/getversioning.py | 
| diff --git a/third_party/gsutil/gslib/commands/getversioning.py b/third_party/gsutil/gslib/commands/getversioning.py | 
| new file mode 100644 | 
| index 0000000000000000000000000000000000000000..8c170754e7f941365a2165df88f4f21f36f717ff | 
| --- /dev/null | 
| +++ b/third_party/gsutil/gslib/commands/getversioning.py | 
| @@ -0,0 +1,116 @@ | 
| +# Copyright 2012 Google Inc. | 
| +# | 
| +# 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. | 
| + | 
| +from gslib.command import Command | 
| +from gslib.command import COMMAND_NAME | 
| +from gslib.command import COMMAND_NAME_ALIASES | 
| +from gslib.command import CONFIG_REQUIRED | 
| +from gslib.command import FILE_URIS_OK | 
| +from gslib.command import MAX_ARGS | 
| +from gslib.command import MIN_ARGS | 
| +from gslib.command import PROVIDER_URIS_OK | 
| +from gslib.command import SUPPORTED_SUB_ARGS | 
| +from gslib.command import URIS_START_ARG | 
| +from gslib.exception import CommandException | 
| +from gslib.help_provider import HELP_NAME | 
| +from gslib.help_provider import HELP_NAME_ALIASES | 
| +from gslib.help_provider import HELP_ONE_LINE_SUMMARY | 
| +from gslib.help_provider import HELP_TEXT | 
| +from gslib.help_provider import HelpType | 
| +from gslib.help_provider import HELP_TYPE | 
| + | 
| + | 
| +_detailed_help_text = (""" | 
| +<B>SYNOPSIS</B> | 
| +  gsutil getversioning bucket_uri | 
| + | 
| + | 
| +<B>DESCRIPTION</B> | 
| +  The Versioning Configuration feature enables you to configure a Google Cloud | 
| +  Storage bucket to keep old versions of objects. | 
| + | 
| +  The gsutil getversioning command gets the versioning configuration for a | 
| +  bucket, and displays an XML representation of the configuration. | 
| + | 
| +  In Google Cloud Storage, this would look like: | 
| + | 
| +  <?xml version="1.0" ?> | 
| +  <VersioningConfiguration> | 
| +    <Status> | 
| +      Enabled | 
| +    </Status> | 
| +  </VersioningConfiguration> | 
| +""") | 
| + | 
| +class GetVersioningCommand(Command): | 
| +  """Implementation of gsutil getversioning command.""" | 
| + | 
| +  # Command specification (processed by parent class). | 
| +  command_spec = { | 
| +    # Name of command. | 
| +    COMMAND_NAME : 'getversioning', | 
| +    # List of command name aliases. | 
| +    COMMAND_NAME_ALIASES : [], | 
| +    # Min number of args required by this command. | 
| +    MIN_ARGS : 1, | 
| +    # Max number of args required by this command, or NO_MAX. | 
| +    MAX_ARGS : 1, | 
| +    # Getopt-style string specifying acceptable sub args. | 
| +    SUPPORTED_SUB_ARGS : '', | 
| +    # True if file URIs acceptable for this command. | 
| +    FILE_URIS_OK : False, | 
| +    # True if provider-only URIs acceptable for this command. | 
| +    PROVIDER_URIS_OK : False, | 
| +    # Index in args of first URI arg. | 
| +    URIS_START_ARG : 1, | 
| +    # True if must configure gsutil before running command. | 
| +    CONFIG_REQUIRED : True, | 
| +  } | 
| +  help_spec = { | 
| +    # Name of command or auxiliary help info for which this help applies. | 
| +    HELP_NAME : 'getversioning', | 
| +    # List of help name aliases. | 
| +    HELP_NAME_ALIASES : [], | 
| +    # Type of help) | 
| +    HELP_TYPE : HelpType.COMMAND_HELP, | 
| +    # One line summary of this help. | 
| +    HELP_ONE_LINE_SUMMARY : 'Get the versioning configuration ' | 
| +                            'for one or more buckets', | 
| +    # The full help text. | 
| +    HELP_TEXT : _detailed_help_text, | 
| +  } | 
| + | 
| +  # Command entry point. | 
| +  def RunCommand(self): | 
| +    uri_args = self.args | 
| + | 
| +    # Iterate over URIs, expanding wildcards, and getting the website | 
| +    # configuration on each. | 
| +    some_matched = False | 
| +    for uri_str in uri_args: | 
| +      for blr in self.WildcardIterator(uri_str): | 
| +        uri = blr.GetUri() | 
| +        if not uri.names_bucket(): | 
| +          raise CommandException('URI %s must name a bucket for the %s command' | 
| +                                 % (str(uri), self.command_name)) | 
| +        some_matched = True | 
| +        uri_str = '%s://%s' % (uri.scheme, uri.bucket_name) | 
| +        if uri.get_versioning_config(): | 
| +          print '%s: Enabled' % uri_str | 
| +        else: | 
| +          print '%s: Suspended' % uri_str | 
| +    if not some_matched: | 
| +      raise CommandException('No URIs matched') | 
| + | 
| +    return 0 | 
|  |