| Index: third_party/gsutil/gslib/addlhelp/command_opts.py
|
| diff --git a/third_party/gsutil/gslib/addlhelp/command_opts.py b/third_party/gsutil/gslib/addlhelp/command_opts.py
|
| deleted file mode 100644
|
| index 6494b79edecd8425a587956b04431b268eb5c9ea..0000000000000000000000000000000000000000
|
| --- a/third_party/gsutil/gslib/addlhelp/command_opts.py
|
| +++ /dev/null
|
| @@ -1,116 +0,0 @@
|
| -# 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.
|
| -
|
| -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 HelpProvider
|
| -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>
|
| - Top-level gsutil Options
|
| -
|
| -
|
| -<B>DESCRIPTION</B>
|
| - gsutil supports separate options for the top-level gsutil command and
|
| - the individual sub-commands (like cp, rm, etc.) The top-level options
|
| - control behavior of gsutil that apply across commands. For example, in
|
| - the command:
|
| -
|
| - gsutil -m cp -p file gs://bucket/obj
|
| -
|
| - the -m option applies to gsutil, while the -p option applies to the cp
|
| - sub-command.
|
| -
|
| -
|
| -<B>OPTIONS</B>
|
| - -d Shows HTTP requests/headers.
|
| -
|
| - -D Shows HTTP requests/headers plus additional debug info needed when
|
| - posting support requests.
|
| -
|
| - -DD Shows HTTP requests/headers plus additional debug info plus HTTP
|
| - upstream payload.
|
| -
|
| - -h Allows you to specify additional HTTP headers, for example:
|
| -
|
| - gsutil -h "Cache-Control:public,max-age=3600" \\
|
| - -h "Content-Type:text/html" cp ...
|
| -
|
| - Note that you need to quote the headers/values that
|
| - contain spaces (such as "Content-Disposition: attachment;
|
| - filename=filename.ext"), to avoid having the shell split them
|
| - into separate arguments.
|
| -
|
| - Note that because the -h option allows you to specify any HTTP
|
| - header, it is both powerful and potentially dangerous:
|
| - - It is powerful because it allows you to specify headers that
|
| - gsutil doesn't currently know about (e.g., to request
|
| - service features from a different storage service provider
|
| - than Google); or to override the values gsutil would normally
|
| - send with different values.
|
| - - It is potentially dangerous because you can specify headers
|
| - that cause gsutil to send invalid requests, or that in
|
| - other ways change the behavior of requests.
|
| - Thus, you should be sure you understand the underlying storage
|
| - service HTTP API (and what impact the headers you specify will
|
| - have) before using the gsutil -h option.
|
| -
|
| - See also "gsutil help setmeta" for the ability to set metadata
|
| - fields on objects after they have been uploaded.
|
| -
|
| - -m Causes supported operations (cp, mv, rm, setacl, setmeta) to run
|
| - in parallel. This can significantly improve performance if you are
|
| - uploading, downloading, moving, removing, or changing ACLs on
|
| - a large number of files over a fast network connection.
|
| -
|
| - gsutil performs the specified operation using a combination of
|
| - multi-threading and multi-processing, using a number of threads
|
| - and processors determined by the parallel_thread_count and
|
| - parallel_process_count values set in the boto configuration
|
| - file. You might want to experiment with these value, as the
|
| - best value can vary based on a number of factors, including
|
| - network speed, number of CPUs, and available memory.
|
| -
|
| - Using the -m option may make your performance worse if you
|
| - are using a slower network, such as the typical network speeds
|
| - offered by non-business home network plans.
|
| -
|
| - If a download or upload operation using parallel transfer fails
|
| - before the entire transfer is complete (e.g. failing after 300 of
|
| - 1000 files have been transferred), you will need to restart the
|
| - entire transfer.
|
| -
|
| - -s Tells gsutil to use a simulated storage provider (for testing).
|
| -""")
|
| -
|
| -
|
| -class CommandOptions(HelpProvider):
|
| - """Additional help about gsutil command-level options."""
|
| -
|
| - help_spec = {
|
| - # Name of command or auxiliary help info for which this help applies.
|
| - HELP_NAME : 'options',
|
| - # List of help name aliases.
|
| - HELP_NAME_ALIASES : ['arg', 'args', 'cli', 'opt', 'opts'],
|
| - # Type of help:
|
| - HELP_TYPE : HelpType.ADDITIONAL_HELP,
|
| - # One line summary of this help.
|
| - HELP_ONE_LINE_SUMMARY : 'gsutil-level command line options',
|
| - # The full help text.
|
| - HELP_TEXT : _detailed_help_text,
|
| - }
|
|
|