Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(432)

Unified Diff: third_party/gsutil/gslib/addlhelp/command_opts.py

Issue 2280023003: depot_tools: Remove third_party/gsutil (Closed)
Patch Set: Created 4 years, 4 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « third_party/gsutil/gslib/addlhelp/anon.py ('k') | third_party/gsutil/gslib/addlhelp/dev.py » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
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,
- }
« no previous file with comments | « third_party/gsutil/gslib/addlhelp/anon.py ('k') | third_party/gsutil/gslib/addlhelp/dev.py » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698