libv8 5.3.332.38.5 → 5.6.326.50.0beta1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.travis.yml +0 -1
- data/CHANGELOG.md +2 -0
- data/ext/libv8/builder.rb +2 -2
- data/lib/libv8/version.rb +1 -1
- data/patches/0001-Build-a-standalone-static-library.patch +4 -4
- data/patches/0002-Don-t-compile-unnecessary-stuff.patch +16 -11
- data/patches/0003-Use-the-fPIC-flag-for-the-static-library.patch +4 -4
- data/patches/{0005-Do-not-embed-debug-symbols-in-macOS-libraries.patch → 0004-Do-not-embed-debug-symbols-in-macOS-libraries.patch} +4 -4
- data/vendor/depot_tools/.gitignore +4 -0
- data/vendor/depot_tools/OWNERS +0 -2
- data/vendor/depot_tools/PRESUBMIT.py +20 -23
- data/vendor/depot_tools/README.gclient.md +3 -3
- data/vendor/depot_tools/README.git-cl.md +13 -12
- data/vendor/depot_tools/README.md +2 -3
- data/vendor/depot_tools/WATCHLISTS +0 -1
- data/vendor/depot_tools/appengine_mapper.py +23 -0
- data/vendor/depot_tools/apply_issue.py +2 -8
- data/vendor/depot_tools/bootstrap/win/README.md +1 -8
- data/vendor/depot_tools/bootstrap/win/git_bootstrap.py +6 -16
- data/vendor/depot_tools/bootstrap/win/git_version.txt +1 -1
- data/vendor/depot_tools/bootstrap/win/git_version_bleeding_edge.txt +1 -1
- data/vendor/depot_tools/checkout.py +20 -433
- data/vendor/depot_tools/cipd +73 -0
- data/vendor/depot_tools/cipd.bat +12 -0
- data/vendor/depot_tools/cipd.ps1 +57 -0
- data/vendor/depot_tools/cipd_client_version +1 -0
- data/vendor/depot_tools/clang_format.py +9 -6
- data/vendor/depot_tools/clang_format_merge_driver +8 -0
- data/vendor/depot_tools/clang_format_merge_driver.bat +11 -0
- data/vendor/depot_tools/clang_format_merge_driver.py +67 -0
- data/vendor/depot_tools/codereview.settings +3 -2
- data/vendor/depot_tools/commit_queue.py +1 -1
- data/vendor/depot_tools/cpplint.py +2 -0
- data/vendor/depot_tools/fetch.py +1 -54
- data/vendor/depot_tools/fetch_configs/android.py +2 -2
- data/vendor/depot_tools/fetch_configs/breakpad.py +2 -3
- data/vendor/depot_tools/fetch_configs/chromium.py +2 -3
- data/vendor/depot_tools/fetch_configs/crashpad.py +2 -2
- data/vendor/depot_tools/fetch_configs/dart.py +2 -3
- data/vendor/depot_tools/fetch_configs/dartino.py +2 -3
- data/vendor/depot_tools/fetch_configs/dartium.py +2 -3
- data/vendor/depot_tools/fetch_configs/depot_tools.py +3 -6
- data/vendor/depot_tools/fetch_configs/gyp.py +2 -3
- data/vendor/depot_tools/fetch_configs/infra.py +2 -2
- data/vendor/depot_tools/fetch_configs/infra_internal.py +2 -2
- data/vendor/depot_tools/fetch_configs/ios.py +2 -2
- data/vendor/depot_tools/fetch_configs/ios_internal.py +2 -3
- data/vendor/depot_tools/fetch_configs/mojo.py +2 -3
- data/vendor/depot_tools/fetch_configs/nacl.py +2 -3
- data/vendor/depot_tools/fetch_configs/naclports.py +2 -3
- data/vendor/depot_tools/fetch_configs/pdfium.py +2 -2
- data/vendor/depot_tools/fetch_configs/skia.py +2 -2
- data/vendor/depot_tools/fetch_configs/skia_buildbot.py +2 -2
- data/vendor/depot_tools/fetch_configs/syzygy.py +2 -2
- data/vendor/depot_tools/fetch_configs/v8.py +2 -3
- data/vendor/depot_tools/fetch_configs/webrtc.py +5 -3
- data/vendor/depot_tools/fetch_configs/webrtc_android.py +2 -2
- data/vendor/depot_tools/fetch_configs/webrtc_ios.py +2 -2
- data/vendor/depot_tools/fix_encoding.py +6 -6
- data/vendor/depot_tools/gclient.py +136 -368
- data/vendor/depot_tools/gclient_scm.py +108 -647
- data/vendor/depot_tools/gclient_utils.py +22 -86
- data/vendor/depot_tools/gerrit_client.py +105 -0
- data/vendor/depot_tools/gerrit_util.py +174 -67
- data/vendor/depot_tools/git-crrev-parse +6 -7
- data/vendor/depot_tools/git-gs +1 -1
- data/vendor/depot_tools/git_cache.py +68 -18
- data/vendor/depot_tools/git_cherry_pick_upload.py +4 -4
- data/vendor/depot_tools/git_cl.py +1028 -961
- data/vendor/depot_tools/git_common.py +2 -3
- data/vendor/depot_tools/git_drover.py +0 -1
- data/vendor/depot_tools/git_footers.py +3 -43
- data/vendor/depot_tools/git_rebase_update.py +9 -1
- data/vendor/depot_tools/git_squash_branch.py +1 -1
- data/vendor/depot_tools/infra/config/cq.cfg +8 -1
- data/vendor/depot_tools/infra/config/recipes.cfg +1 -1
- data/vendor/depot_tools/man/html/depot_tools.html +3 -11
- data/vendor/depot_tools/man/html/depot_tools_tutorial.html +9 -9
- data/vendor/depot_tools/man/html/git-cherry-pick-upload.html +2 -2
- data/vendor/depot_tools/man/html/git-drover.html +17 -17
- data/vendor/depot_tools/man/html/git-footers.html +2 -2
- data/vendor/depot_tools/man/html/git-freeze.html +4 -4
- data/vendor/depot_tools/man/html/git-hyper-blame.html +2 -2
- data/vendor/depot_tools/man/html/git-map-branches.html +2 -2
- data/vendor/depot_tools/man/html/git-map.html +2 -2
- data/vendor/depot_tools/man/html/git-mark-merge-base.html +2 -2
- data/vendor/depot_tools/man/html/git-nav-downstream.html +2 -2
- data/vendor/depot_tools/man/html/git-nav-upstream.html +2 -2
- data/vendor/depot_tools/man/html/git-new-branch.html +2 -2
- data/vendor/depot_tools/man/html/git-rebase-update.html +2 -2
- data/vendor/depot_tools/man/html/git-rename-branch.html +2 -2
- data/vendor/depot_tools/man/html/git-reparent-branch.html +2 -2
- data/vendor/depot_tools/man/html/git-retry.html +3 -3
- data/vendor/depot_tools/man/html/git-squash-branch.html +3 -3
- data/vendor/depot_tools/man/html/git-thaw.html +2 -2
- data/vendor/depot_tools/man/html/git-upstream-diff.html +3 -3
- data/vendor/depot_tools/man/man1/git-cherry-pick-upload.1 +4 -4
- data/vendor/depot_tools/man/man1/git-drover.1 +19 -19
- data/vendor/depot_tools/man/man1/git-footers.1 +4 -4
- data/vendor/depot_tools/man/man1/git-freeze.1 +6 -6
- data/vendor/depot_tools/man/man1/git-hyper-blame.1 +4 -4
- data/vendor/depot_tools/man/man1/git-map-branches.1 +4 -4
- data/vendor/depot_tools/man/man1/git-map.1 +4 -4
- data/vendor/depot_tools/man/man1/git-mark-merge-base.1 +4 -4
- data/vendor/depot_tools/man/man1/git-nav-downstream.1 +4 -4
- data/vendor/depot_tools/man/man1/git-nav-upstream.1 +4 -4
- data/vendor/depot_tools/man/man1/git-new-branch.1 +4 -4
- data/vendor/depot_tools/man/man1/git-rebase-update.1 +4 -4
- data/vendor/depot_tools/man/man1/git-rename-branch.1 +4 -4
- data/vendor/depot_tools/man/man1/git-reparent-branch.1 +4 -4
- data/vendor/depot_tools/man/man1/git-retry.1 +5 -5
- data/vendor/depot_tools/man/man1/git-squash-branch.1 +5 -5
- data/vendor/depot_tools/man/man1/git-thaw.1 +4 -4
- data/vendor/depot_tools/man/man1/git-upstream-diff.1 +5 -5
- data/vendor/depot_tools/man/man7/depot_tools.7 +5 -10
- data/vendor/depot_tools/man/man7/depot_tools_tutorial.7 +4 -4
- data/vendor/depot_tools/man/src/depot_tools.txt +1 -1
- data/vendor/depot_tools/man/src/depot_tools_tutorial.txt +7 -7
- data/vendor/depot_tools/man/src/filter_demo_output.py +2 -2
- data/vendor/depot_tools/man/src/git-footers.demo.1.sh +1 -1
- data/vendor/depot_tools/man/src/git-retry.txt +1 -1
- data/vendor/depot_tools/man/src/git-squash-branch.txt +2 -2
- data/vendor/depot_tools/man/src/git-upstream-diff.txt +1 -1
- data/vendor/depot_tools/my_activity.py +6 -3
- data/vendor/depot_tools/my_reviews.py +1 -1
- data/vendor/depot_tools/ninja +2 -2
- data/vendor/depot_tools/ninja-linux32 +0 -0
- data/vendor/depot_tools/ninja-linux64 +0 -0
- data/vendor/depot_tools/ninja-mac +0 -0
- data/vendor/depot_tools/ninja.exe +0 -0
- data/vendor/depot_tools/owners.py +14 -3
- data/vendor/depot_tools/presubmit_canned_checks.py +46 -67
- data/vendor/depot_tools/presubmit_support.py +109 -371
- data/vendor/depot_tools/pylintrc +83 -56
- data/vendor/depot_tools/recipe_modules/OWNERS +1 -0
- data/vendor/depot_tools/recipe_modules/bot_update/__init__.py +18 -9
- data/vendor/depot_tools/recipe_modules/bot_update/api.py +56 -55
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/basic.json +3 -7
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/basic_output_manifest.json +3 -7
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/basic_with_branch_heads.json +3 -7
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/buildbot.json +52 -0
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/clobber.json +19 -10
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/gerrit_no_rebase_patch_ref.json +19 -10
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/gerrit_no_reset.json +19 -10
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/no_shallow.json +19 -10
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/reset_root_solution_revision.json +19 -10
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/trychange.json +3 -7
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/trychange_oauth2.json +2 -54
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/trychange_oauth2_buildbot.json +56 -0
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/{forced.json → trychange_oauth2_json.json} +6 -9
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/trychange_oauth2_json_win.json +54 -0
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/tryjob.json +9 -9
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/tryjob_fail.json +9 -9
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/tryjob_fail_patch.json +9 -9
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/tryjob_fail_patch_download.json +9 -9
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/tryjob_gerrit_angle.json +20 -10
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/tryjob_gerrit_angle_deprecated.json +59 -0
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/tryjob_v8.json +9 -9
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/tryjob_v8_head_by_default.json +20 -10
- data/vendor/depot_tools/recipe_modules/bot_update/example.py +45 -63
- data/vendor/depot_tools/recipe_modules/bot_update/resources/bot_update.py +210 -807
- data/vendor/depot_tools/recipe_modules/bot_update/test_api.py +34 -45
- data/vendor/depot_tools/recipe_modules/cipd/api.py +59 -84
- data/vendor/depot_tools/recipe_modules/cipd/example.expected/basic.json +71 -117
- data/vendor/depot_tools/recipe_modules/cipd/example.expected/describe-failed.json +14 -60
- data/vendor/depot_tools/recipe_modules/cipd/example.expected/describe-many-instances.json +71 -117
- data/vendor/depot_tools/recipe_modules/cipd/example.expected/mac64.json +71 -117
- data/vendor/depot_tools/recipe_modules/cipd/example.expected/win64.json +71 -117
- data/vendor/depot_tools/recipe_modules/cipd/example.py +2 -12
- data/vendor/depot_tools/recipe_modules/cipd/test_api.py +0 -9
- data/vendor/depot_tools/recipe_modules/depot_tools/api.py +6 -0
- data/vendor/depot_tools/recipe_modules/depot_tools/example.expected/basic.json +7 -0
- data/vendor/depot_tools/recipe_modules/depot_tools/example.expected/win.json +7 -0
- data/vendor/depot_tools/recipe_modules/depot_tools/example.py +3 -0
- data/vendor/depot_tools/recipe_modules/gclient/__init__.py +4 -0
- data/vendor/depot_tools/recipe_modules/gclient/api.py +9 -22
- data/vendor/depot_tools/recipe_modules/gclient/config.py +18 -5
- data/vendor/depot_tools/recipe_modules/gclient/example.expected/basic.json +14 -14
- data/vendor/depot_tools/recipe_modules/gclient/example.expected/buildbot.json +211 -0
- data/vendor/depot_tools/recipe_modules/gclient/example.expected/revision.json +16 -14
- data/vendor/depot_tools/recipe_modules/gclient/example.expected/tryserver.json +16 -14
- data/vendor/depot_tools/recipe_modules/gclient/example.py +13 -11
- data/vendor/depot_tools/recipe_modules/gerrit/__init__.py +6 -0
- data/vendor/depot_tools/recipe_modules/gerrit/api.py +63 -0
- data/vendor/depot_tools/recipe_modules/gerrit/example.expected/basic.json +64 -0
- data/vendor/depot_tools/recipe_modules/gerrit/example.py +35 -0
- data/vendor/depot_tools/recipe_modules/gerrit/test_api.py +24 -0
- data/vendor/depot_tools/recipe_modules/git/__init__.py +4 -0
- data/vendor/depot_tools/recipe_modules/git/api.py +155 -142
- data/vendor/depot_tools/recipe_modules/git/example.expected/basic.json +43 -17
- data/vendor/depot_tools/recipe_modules/git/example.expected/basic_branch.json +43 -17
- data/vendor/depot_tools/recipe_modules/git/example.expected/basic_file_name.json +43 -17
- data/vendor/depot_tools/recipe_modules/git/example.expected/basic_hash.json +43 -17
- data/vendor/depot_tools/recipe_modules/git/example.expected/basic_ref.json +43 -17
- data/vendor/depot_tools/recipe_modules/git/example.expected/basic_submodule_update_force.json +43 -17
- data/vendor/depot_tools/recipe_modules/git/example.expected/can_fail_build.json +13 -13
- data/vendor/depot_tools/recipe_modules/git/example.expected/cannot_fail_build.json +43 -17
- data/vendor/depot_tools/recipe_modules/git/example.expected/cat-file_test.json +45 -19
- data/vendor/depot_tools/recipe_modules/git/example.expected/count-objects_delta.json +45 -19
- data/vendor/depot_tools/recipe_modules/git/example.expected/count-objects_failed.json +43 -17
- data/vendor/depot_tools/recipe_modules/git/example.expected/count-objects_with_bad_output.json +43 -17
- data/vendor/depot_tools/recipe_modules/git/example.expected/count-objects_with_bad_output_fails_build.json +8 -8
- data/vendor/depot_tools/recipe_modules/git/example.expected/curl_trace_file.json +44 -18
- data/vendor/depot_tools/recipe_modules/git/example.expected/git-cache-checkout.json +48 -22
- data/vendor/depot_tools/recipe_modules/git/example.expected/platform_win.json +43 -17
- data/vendor/depot_tools/recipe_modules/git/example.expected/rebase_failed.json +42 -16
- data/vendor/depot_tools/recipe_modules/git/example.expected/remote_not_origin.json +43 -17
- data/vendor/depot_tools/recipe_modules/git/example.expected/set_got_revision.json +43 -17
- data/vendor/depot_tools/recipe_modules/git/example.py +9 -3
- data/vendor/depot_tools/recipe_modules/git_cl/__init__.py +4 -0
- data/vendor/depot_tools/recipe_modules/git_cl/api.py +8 -8
- data/vendor/depot_tools/recipe_modules/git_cl/example.py +1 -1
- data/vendor/depot_tools/recipe_modules/gsutil/__init__.py +4 -0
- data/vendor/depot_tools/recipe_modules/gsutil/api.py +196 -0
- data/vendor/depot_tools/recipe_modules/gsutil/example.expected/basic.json +186 -0
- data/vendor/depot_tools/recipe_modules/gsutil/example.py +77 -0
- data/vendor/depot_tools/recipe_modules/gsutil/resources/gsutil_smart_retry.py +69 -0
- data/vendor/depot_tools/recipe_modules/infra_paths/__init__.py +3 -0
- data/vendor/depot_tools/recipe_modules/infra_paths/api.py +20 -3
- data/vendor/depot_tools/recipe_modules/infra_paths/example.expected/basic.json +3 -1
- data/vendor/depot_tools/recipe_modules/infra_paths/example.expected/paths_buildbot_linux.json +3 -1
- data/vendor/depot_tools/recipe_modules/infra_paths/example.expected/paths_buildbot_mac.json +3 -1
- data/vendor/depot_tools/recipe_modules/infra_paths/example.expected/paths_buildbot_win.json +3 -1
- data/vendor/depot_tools/recipe_modules/infra_paths/example.expected/paths_kitchen_linux.json +3 -1
- data/vendor/depot_tools/recipe_modules/infra_paths/example.expected/paths_kitchen_mac.json +3 -1
- data/vendor/depot_tools/recipe_modules/infra_paths/example.expected/paths_kitchen_win.json +3 -1
- data/vendor/depot_tools/recipe_modules/infra_paths/example.expected/paths_swarmbucket_linux.json +3 -1
- data/vendor/depot_tools/recipe_modules/infra_paths/example.expected/paths_swarmbucket_mac.json +3 -1
- data/vendor/depot_tools/recipe_modules/infra_paths/example.expected/paths_swarmbucket_win.json +3 -1
- data/vendor/depot_tools/recipe_modules/infra_paths/example.py +6 -1
- data/vendor/depot_tools/recipe_modules/infra_paths/path_config.py +4 -6
- data/vendor/depot_tools/recipe_modules/rietveld/__init__.py +5 -0
- data/vendor/depot_tools/recipe_modules/rietveld/api.py +12 -9
- data/vendor/depot_tools/recipe_modules/rietveld/example.expected/basic.json +2 -24
- data/vendor/depot_tools/recipe_modules/rietveld/example.expected/buildbot.json +30 -0
- data/vendor/depot_tools/recipe_modules/rietveld/example.py +12 -6
- data/vendor/depot_tools/recipe_modules/tryserver/__init__.py +4 -0
- data/vendor/depot_tools/recipe_modules/tryserver/api.py +46 -70
- data/vendor/depot_tools/recipe_modules/tryserver/example.expected/set_failure_hash_with_no_steps.json +8 -0
- data/vendor/depot_tools/recipe_modules/tryserver/example.expected/{with_svn_patch.json → with_gerrit_patch.json} +1 -31
- data/vendor/depot_tools/recipe_modules/tryserver/example.expected/with_gerrit_patch_deprecated.json +39 -0
- data/vendor/depot_tools/recipe_modules/tryserver/example.expected/with_git_patch.json +2 -2
- data/vendor/depot_tools/recipe_modules/tryserver/example.expected/with_git_patch_luci.json +8 -0
- data/vendor/depot_tools/recipe_modules/tryserver/example.expected/with_rietveld_patch.json +3 -3
- data/vendor/depot_tools/recipe_modules/tryserver/example.expected/with_rietveld_patch_new.json +3 -3
- data/vendor/depot_tools/recipe_modules/tryserver/example.expected/with_wrong_patch.json +1 -1
- data/vendor/depot_tools/recipe_modules/tryserver/example.expected/with_wrong_patch_new.json +1 -1
- data/vendor/depot_tools/recipe_modules/tryserver/example.py +35 -5
- data/vendor/depot_tools/recipes.py +52 -28
- data/vendor/depot_tools/repo +216 -69
- data/vendor/depot_tools/rietveld.py +20 -15
- data/vendor/depot_tools/roll_dep.py +1 -1
- data/vendor/depot_tools/scm.py +11 -826
- data/vendor/depot_tools/subprocess2.py +5 -5
- data/vendor/depot_tools/third_party/cq_client/README.depot_tools.md +2 -0
- data/vendor/depot_tools/third_party/cq_client/README.md +5 -1
- data/vendor/depot_tools/third_party/cq_client/cq.pb.go +183 -104
- data/vendor/depot_tools/third_party/cq_client/cq.proto +43 -27
- data/vendor/depot_tools/third_party/cq_client/cq_pb2.py +95 -29
- data/vendor/depot_tools/third_party/cq_client/testdata/cq_both.cfg +67 -0
- data/vendor/depot_tools/third_party/cq_client/testdata/cq_gerrit.cfg +1 -2
- data/vendor/depot_tools/third_party/cq_client/testdata/cq_rietveld.cfg +0 -3
- data/vendor/depot_tools/third_party/upload.py +44 -24
- data/vendor/depot_tools/win_toolchain/get_toolchain_if_necessary.py +0 -5
- metadata +38 -93
- data/patches/0004-Reinterpret-thread-hash-for-FreeBSD-too.patch +0 -25
- data/vendor/depot_tools/git-auto-svn +0 -6
- data/vendor/depot_tools/git_auto_svn.py +0 -122
- data/vendor/depot_tools/man/html/git-auto-svn.html +0 -837
- data/vendor/depot_tools/man/man1/git-auto-svn.1 +0 -113
- data/vendor/depot_tools/man/src/_git-auto-svn_desc.helper.txt +0 -1
- data/vendor/depot_tools/man/src/git-auto-svn.txt +0 -69
- data/vendor/depot_tools/recipe_modules/bot_update/example.expected/off.json +0 -43
- data/vendor/depot_tools/recipe_modules/cipd/example.expected/install-failed.json +0 -31
- data/vendor/depot_tools/recipe_modules/cipd/resources/bootstrap.py +0 -218
- data/vendor/depot_tools/recipe_modules/tryserver/test_api.py +0 -7
- data/vendor/depot_tools/third_party/gsutil/CHECKSUM +0 -1
- data/vendor/depot_tools/third_party/gsutil/COPYING +0 -202
- data/vendor/depot_tools/third_party/gsutil/LICENSE.third_party +0 -295
- data/vendor/depot_tools/third_party/gsutil/MANIFEST.in +0 -5
- data/vendor/depot_tools/third_party/gsutil/README +0 -38
- data/vendor/depot_tools/third_party/gsutil/README.chromium +0 -25
- data/vendor/depot_tools/third_party/gsutil/README.pkg +0 -49
- data/vendor/depot_tools/third_party/gsutil/ReleaseNotes.txt +0 -825
- data/vendor/depot_tools/third_party/gsutil/VERSION +0 -1
- data/vendor/depot_tools/third_party/gsutil/gslib/README +0 -5
- data/vendor/depot_tools/third_party/gsutil/gslib/__init__.py +0 -22
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/__init__.py +0 -15
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/acls.py +0 -234
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/anon.py +0 -57
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/command_opts.py +0 -116
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/dev.py +0 -139
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/metadata.py +0 -186
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/naming.py +0 -173
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/prod.py +0 -160
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/projects.py +0 -130
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/subdirs.py +0 -110
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/support.py +0 -86
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/versioning.py +0 -242
- data/vendor/depot_tools/third_party/gsutil/gslib/addlhelp/wildcards.py +0 -170
- data/vendor/depot_tools/third_party/gsutil/gslib/bucket_listing_ref.py +0 -175
- data/vendor/depot_tools/third_party/gsutil/gslib/command.py +0 -725
- data/vendor/depot_tools/third_party/gsutil/gslib/command_runner.py +0 -102
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/__init__.py +0 -15
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/cat.py +0 -131
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/chacl.py +0 -523
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/config.py +0 -662
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/cp.py +0 -1819
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/disablelogging.py +0 -101
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/enablelogging.py +0 -149
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/getacl.py +0 -82
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/getcors.py +0 -121
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/getdefacl.py +0 -86
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/getlogging.py +0 -137
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/getversioning.py +0 -116
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/getwebcfg.py +0 -122
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/help.py +0 -218
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/ls.py +0 -578
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/mb.py +0 -172
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/mv.py +0 -159
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/perfdiag.py +0 -903
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/rb.py +0 -113
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/rm.py +0 -237
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/setacl.py +0 -138
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/setcors.py +0 -145
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/setdefacl.py +0 -105
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/setmeta.py +0 -420
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/setversioning.py +0 -114
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/setwebcfg.py +0 -190
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/update.py +0 -305
- data/vendor/depot_tools/third_party/gsutil/gslib/commands/version.py +0 -150
- data/vendor/depot_tools/third_party/gsutil/gslib/exception.py +0 -76
- data/vendor/depot_tools/third_party/gsutil/gslib/help_provider.py +0 -81
- data/vendor/depot_tools/third_party/gsutil/gslib/name_expansion.py +0 -550
- data/vendor/depot_tools/third_party/gsutil/gslib/no_op_auth_plugin.py +0 -30
- data/vendor/depot_tools/third_party/gsutil/gslib/plurality_checkable_iterator.py +0 -56
- data/vendor/depot_tools/third_party/gsutil/gslib/project_id.py +0 -67
- data/vendor/depot_tools/third_party/gsutil/gslib/storage_uri_builder.py +0 -56
- data/vendor/depot_tools/third_party/gsutil/gslib/thread_pool.py +0 -79
- data/vendor/depot_tools/third_party/gsutil/gslib/util.py +0 -167
- data/vendor/depot_tools/third_party/gsutil/gslib/wildcard_iterator.py +0 -498
- data/vendor/depot_tools/third_party/gsutil/gsutil +0 -384
- data/vendor/depot_tools/third_party/gsutil/gsutil.spec.in +0 -75
- data/vendor/depot_tools/third_party/gsutil/oauth2_plugin/__init__.py +0 -22
- data/vendor/depot_tools/third_party/gsutil/oauth2_plugin/oauth2_client.py +0 -630
- data/vendor/depot_tools/third_party/gsutil/oauth2_plugin/oauth2_client_test.py +0 -374
- data/vendor/depot_tools/third_party/gsutil/oauth2_plugin/oauth2_helper.py +0 -103
- data/vendor/depot_tools/third_party/gsutil/oauth2_plugin/oauth2_plugin.py +0 -24
- data/vendor/depot_tools/third_party/gsutil/pkg_util.py +0 -60
- data/vendor/depot_tools/third_party/gsutil/plugins/__init__.py +0 -0
- data/vendor/depot_tools/third_party/gsutil/plugins/sso_auth.py +0 -105
@@ -1 +0,0 @@
|
|
1
|
-
3.25
|
@@ -1,5 +0,0 @@
|
|
1
|
-
This directory contains library code used by gsutil. Users are cautioned not
|
2
|
-
to write programs that call the internal interfaces defined in here; these
|
3
|
-
interfaces were defined only for use by gsutil, and are subject to change
|
4
|
-
without notice. Moreover, Google supports this library only when used by
|
5
|
-
gsutil, not when the library interfaces are called directly by other programs.
|
@@ -1,22 +0,0 @@
|
|
1
|
-
# Copyright 2010 Google Inc. All Rights Reserved.
|
2
|
-
#
|
3
|
-
# Permission is hereby granted, free of charge, to any person obtaining a
|
4
|
-
# copy of this software and associated documentation files (the
|
5
|
-
# "Software"), to deal in the Software without restriction, including
|
6
|
-
# without limitation the rights to use, copy, modify, merge, publish, dis-
|
7
|
-
# tribute, sublicense, and/or sell copies of the Software, and to permit
|
8
|
-
# persons to whom the Software is furnished to do so, subject to the fol-
|
9
|
-
# lowing conditions:
|
10
|
-
#
|
11
|
-
# The above copyright notice and this permission notice shall be included
|
12
|
-
# in all copies or substantial portions of the Software.
|
13
|
-
#
|
14
|
-
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
15
|
-
# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
|
16
|
-
# ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
|
17
|
-
# SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
|
18
|
-
# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
19
|
-
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
|
20
|
-
# IN THE SOFTWARE.
|
21
|
-
|
22
|
-
"""Package marker file."""
|
@@ -1,15 +0,0 @@
|
|
1
|
-
# Copyright 2012 Google Inc. All Rights Reserved.
|
2
|
-
#
|
3
|
-
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
-
# you may not use this file except in compliance with the License.
|
5
|
-
# You may obtain a copy of the License at
|
6
|
-
#
|
7
|
-
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
-
#
|
9
|
-
# Unless required by applicable law or agreed to in writing, software
|
10
|
-
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
-
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
-
# See the License for the specific language governing permissions and
|
13
|
-
# limitations under the License.
|
14
|
-
|
15
|
-
"""Package marker file."""
|
@@ -1,234 +0,0 @@
|
|
1
|
-
# Copyright 2012 Google Inc. All Rights Reserved.
|
2
|
-
#
|
3
|
-
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
-
# you may not use this file except in compliance with the License.
|
5
|
-
# You may obtain a copy of the License at
|
6
|
-
#
|
7
|
-
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
-
#
|
9
|
-
# Unless required by applicable law or agreed to in writing, software
|
10
|
-
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
-
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
-
# See the License for the specific language governing permissions and
|
13
|
-
# limitations under the License.
|
14
|
-
|
15
|
-
from gslib.help_provider import HELP_NAME
|
16
|
-
from gslib.help_provider import HELP_NAME_ALIASES
|
17
|
-
from gslib.help_provider import HELP_ONE_LINE_SUMMARY
|
18
|
-
from gslib.help_provider import HelpProvider
|
19
|
-
from gslib.help_provider import HELP_TEXT
|
20
|
-
from gslib.help_provider import HelpType
|
21
|
-
from gslib.help_provider import HELP_TYPE
|
22
|
-
|
23
|
-
_detailed_help_text = ("""
|
24
|
-
<B>OVERVIEW</B>
|
25
|
-
Access Control Lists (ACLs) allow you to control who can read and write
|
26
|
-
your data, and who can read and write the ACLs themselves.
|
27
|
-
|
28
|
-
If not specified at the time an object is uploaded (e.g., via the gsutil cp
|
29
|
-
-a option), objects will be created with a default object ACL set on the
|
30
|
-
bucket (see "gsutil help setdefacl"). You can replace the ACL on an object
|
31
|
-
or bucket using the gsutil setacl command (see "gsutil help setacl"), or
|
32
|
-
modify the existing ACL using the gsutil chacl command (see "gsutil help
|
33
|
-
chacl").
|
34
|
-
|
35
|
-
|
36
|
-
<B>BUCKET VS OBJECT ACLS</B>
|
37
|
-
In Google Cloud Storage, the bucket ACL works as follows:
|
38
|
-
|
39
|
-
- Users granted READ access are allowed to list the bucket contents.
|
40
|
-
|
41
|
-
- Users granted WRITE access are allowed READ access and also are
|
42
|
-
allowed to write and delete objects in that bucket -- including
|
43
|
-
overwriting previously written objects.
|
44
|
-
|
45
|
-
- Users granted FULL_CONTROL access are allowed WRITE access and also
|
46
|
-
are allowed to read and write the bucket's ACL.
|
47
|
-
|
48
|
-
The object ACL works as follows:
|
49
|
-
|
50
|
-
- Users granted READ access are allowed to read the object's data and
|
51
|
-
metadata.
|
52
|
-
|
53
|
-
- Users granted FULL_CONTROL access are allowed READ access and also
|
54
|
-
are allowed to read and write the object's ACL.
|
55
|
-
|
56
|
-
A couple of points are worth noting, that sometimes surprise users:
|
57
|
-
|
58
|
-
1. There is no WRITE access for objects; attempting to set an ACL with WRITE
|
59
|
-
permission for an object will result in an error.
|
60
|
-
|
61
|
-
2. The bucket ACL plays no role in determining who can read objects; only the
|
62
|
-
object ACL matters for that purpose. This is different from how things
|
63
|
-
work in Linux file systems, where both the file and directory permission
|
64
|
-
control file read access. It also means, for example, that someone with
|
65
|
-
FULL_CONTROL over the bucket may not have read access to objects in
|
66
|
-
the bucket. This is by design, and supports useful cases. For example,
|
67
|
-
you might want to set up bucket ownership so that a small group of
|
68
|
-
administrators have FULL_CONTROL on the bucket (with the ability to
|
69
|
-
delete data to control storage costs), but not grant those users read
|
70
|
-
access to the object data (which might be sensitive data that should
|
71
|
-
only be accessed by a different specific group of users).
|
72
|
-
|
73
|
-
|
74
|
-
<B>CANNED ACLS</B>
|
75
|
-
The simplest way to set an ACL on a bucket or object is using a "canned
|
76
|
-
ACL". The available canned ACLs are:
|
77
|
-
|
78
|
-
project-private Gives permission to the project team based on their
|
79
|
-
roles. Anyone who is part of the team has READ
|
80
|
-
permission, and project owners and project editors
|
81
|
-
have FULL_CONTROL permission. This is the default
|
82
|
-
ACL for newly created buckets. This is also the
|
83
|
-
default ACL for newly created objects unless the
|
84
|
-
default object ACL for that bucket has been
|
85
|
-
changed. For more details see
|
86
|
-
"gsutil help projects".
|
87
|
-
|
88
|
-
private Gives the requester (and only the requester)
|
89
|
-
FULL_CONTROL permission for a bucket or object.
|
90
|
-
|
91
|
-
public-read Gives the requester FULL_CONTROL permission and
|
92
|
-
gives all users READ permission. When you apply
|
93
|
-
this to an object, anyone on the Internet can
|
94
|
-
read the object without authenticating.
|
95
|
-
|
96
|
-
public-read-write Gives the requester FULL_CONTROL permission and
|
97
|
-
gives all users READ and WRITE permission. This
|
98
|
-
ACL applies only to buckets.
|
99
|
-
|
100
|
-
authenticated-read Gives the requester FULL_CONTROL permission and
|
101
|
-
gives all authenticated Google account holders
|
102
|
-
READ permission.
|
103
|
-
|
104
|
-
bucket-owner-read Gives the requester FULL_CONTROL permission and
|
105
|
-
gives the bucket owner READ permission. This is
|
106
|
-
used only with objects.
|
107
|
-
|
108
|
-
bucket-owner-full-control Gives the requester FULL_CONTROL permission and
|
109
|
-
gives the bucket owner FULL_CONTROL
|
110
|
-
permission. This is used only with objects.
|
111
|
-
|
112
|
-
|
113
|
-
<B>ACL XML</B>
|
114
|
-
When you use a canned ACL, it is translated into an XML representation
|
115
|
-
that can later be retrieved and edited to specify more fine-grained
|
116
|
-
detail about who can read and write buckets and objects. By running
|
117
|
-
the gsutil getacl command you can retrieve the ACL XML, and edit it to
|
118
|
-
customize the permissions.
|
119
|
-
|
120
|
-
As an example, if you create an object in a bucket that has no default
|
121
|
-
object ACL set and then retrieve the ACL on the object, it will look
|
122
|
-
something like this:
|
123
|
-
|
124
|
-
<AccessControlList>
|
125
|
-
<Owner>
|
126
|
-
<ID>
|
127
|
-
00b4903a9740e42c29800f53bd5a9a62a2f96eb3f64a4313a115df3f3a776bf7
|
128
|
-
</ID>
|
129
|
-
</Owner>
|
130
|
-
<Entries>
|
131
|
-
<Entry>
|
132
|
-
<Scope type="GroupById">
|
133
|
-
<ID>
|
134
|
-
00b4903a9740e42c29800f53bd5a9a62a2f96eb3f64a4313a115df3f3a776bf7
|
135
|
-
</ID>
|
136
|
-
</Scope>
|
137
|
-
<Permission>
|
138
|
-
FULL_CONTROL
|
139
|
-
</Permission>
|
140
|
-
</Entry>
|
141
|
-
<Entry>
|
142
|
-
<Scope type="GroupById">
|
143
|
-
<ID>
|
144
|
-
00b4903a977fd817e9da167bc81306489181a110456bb635f466d71cf90a0d51
|
145
|
-
</ID>
|
146
|
-
</Scope>
|
147
|
-
<Permission>
|
148
|
-
FULL_CONTROL
|
149
|
-
</Permission>
|
150
|
-
</Entry>
|
151
|
-
<Entry>
|
152
|
-
<Scope type="GroupById">
|
153
|
-
<ID>
|
154
|
-
00b4903a974898cc8fc309f2f2835308ba3d3df1b889d3fc7e33e187d52d8e71
|
155
|
-
</ID>
|
156
|
-
</Scope>
|
157
|
-
<Permission>
|
158
|
-
READ
|
159
|
-
</Permission>
|
160
|
-
</Entry>
|
161
|
-
</Entries>
|
162
|
-
</AccessControlList>
|
163
|
-
|
164
|
-
The ACL consists of an Owner element and a collection of Entry elements,
|
165
|
-
each of which specifies a Scope and a Permission. Scopes are the way you
|
166
|
-
specify an individual or group of individuals, and Permissions specify what
|
167
|
-
access they're permitted.
|
168
|
-
|
169
|
-
This particular ACL grants FULL_CONTROL to two groups (which means members
|
170
|
-
of those groups are allowed to read the object and read and write the ACL),
|
171
|
-
and READ permission to a third group. The project groups are (in order)
|
172
|
-
the owners group, editors group, and viewers group.
|
173
|
-
|
174
|
-
The 64 digit hex identifiers used in this ACL are called canonical IDs,
|
175
|
-
and are used to identify predefined groups associated with the project that
|
176
|
-
owns the bucket. For more information about project groups, see "gsutil
|
177
|
-
help projects".
|
178
|
-
|
179
|
-
Here's an example of an ACL specified using the GroupByEmail and GroupByDomain
|
180
|
-
scopes:
|
181
|
-
|
182
|
-
<AccessControlList>
|
183
|
-
<Entries>
|
184
|
-
<Entry>
|
185
|
-
<Permission>
|
186
|
-
FULL_CONTROL
|
187
|
-
</Permission>
|
188
|
-
<Scope type="GroupByEmail">
|
189
|
-
<EmailAddress>travel-companion-owners@googlegroups.com</EmailAddress>
|
190
|
-
</Scope>
|
191
|
-
</Entry>
|
192
|
-
<Entry>
|
193
|
-
<Permission>
|
194
|
-
READ
|
195
|
-
</Permission>
|
196
|
-
<Scope type="GroupByDomain">
|
197
|
-
<Domain>example.com</Domain>
|
198
|
-
</Scope>
|
199
|
-
</Entry>
|
200
|
-
</Entries>
|
201
|
-
</AccessControlList>
|
202
|
-
|
203
|
-
This ACL grants members of an email group FULL_CONTROL, and grants READ
|
204
|
-
access to any user in a domain (which must be a Google Apps for Business
|
205
|
-
domain). By applying email group grants to a collection of objects
|
206
|
-
you can edit access control for large numbers of objects at once via
|
207
|
-
http://groups.google.com. That way, for example, you can easily and quickly
|
208
|
-
change access to a group of company objects when employees join and leave
|
209
|
-
your company (i.e., without having to individually change ACLs across
|
210
|
-
potentially millions of objects).
|
211
|
-
|
212
|
-
|
213
|
-
<B>SHARING SCENARIOS</B>
|
214
|
-
For more detailed examples how to achieve various useful sharing use
|
215
|
-
cases see https://developers.google.com/storage/docs/collaboration
|
216
|
-
""")
|
217
|
-
|
218
|
-
|
219
|
-
class CommandOptions(HelpProvider):
|
220
|
-
"""Additional help about Access Control Lists."""
|
221
|
-
|
222
|
-
help_spec = {
|
223
|
-
# Name of command or auxiliary help info for which this help applies.
|
224
|
-
HELP_NAME : 'acls',
|
225
|
-
# List of help name aliases.
|
226
|
-
HELP_NAME_ALIASES : ['acl', 'ACL', 'access control', 'access control list',
|
227
|
-
'authorization', 'canned', 'canned acl'],
|
228
|
-
# Type of help:
|
229
|
-
HELP_TYPE : HelpType.ADDITIONAL_HELP,
|
230
|
-
# One line summary of this help.
|
231
|
-
HELP_ONE_LINE_SUMMARY : 'Working with Access Control Lists',
|
232
|
-
# The full help text.
|
233
|
-
HELP_TEXT : _detailed_help_text,
|
234
|
-
}
|
@@ -1,57 +0,0 @@
|
|
1
|
-
# Copyright 2012 Google Inc. All Rights Reserved.
|
2
|
-
#
|
3
|
-
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
-
# you may not use this file except in compliance with the License.
|
5
|
-
# You may obtain a copy of the License at
|
6
|
-
#
|
7
|
-
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
-
#
|
9
|
-
# Unless required by applicable law or agreed to in writing, software
|
10
|
-
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
-
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
-
# See the License for the specific language governing permissions and
|
13
|
-
# limitations under the License.
|
14
|
-
|
15
|
-
from gslib.help_provider import HELP_NAME
|
16
|
-
from gslib.help_provider import HELP_NAME_ALIASES
|
17
|
-
from gslib.help_provider import HELP_ONE_LINE_SUMMARY
|
18
|
-
from gslib.help_provider import HelpProvider
|
19
|
-
from gslib.help_provider import HELP_TEXT
|
20
|
-
from gslib.help_provider import HelpType
|
21
|
-
from gslib.help_provider import HELP_TYPE
|
22
|
-
|
23
|
-
_detailed_help_text = ("""
|
24
|
-
<B>OVERVIEW</B>
|
25
|
-
gsutil users can access publicly readable data without obtaining
|
26
|
-
credentials. For example, the gs://uspto-pair bucket contains a number
|
27
|
-
of publicly readable objects, so any user can run the following command
|
28
|
-
without first obtaining credentials:
|
29
|
-
|
30
|
-
gsutil ls gs://uspto-pair/applications/0800401*
|
31
|
-
|
32
|
-
Users can similarly download objects they find via the above gsutil ls
|
33
|
-
command.
|
34
|
-
|
35
|
-
If a user without credentials attempts to access protected data using gsutil,
|
36
|
-
they will be prompted to run "gsutil config" to obtain credentials.
|
37
|
-
|
38
|
-
See "gsutil help acls" for more details about data protection.
|
39
|
-
""")
|
40
|
-
|
41
|
-
|
42
|
-
class CommandOptions(HelpProvider):
|
43
|
-
"""Additional help about Access Control Lists."""
|
44
|
-
|
45
|
-
help_spec = {
|
46
|
-
# Name of command or auxiliary help info for which this help applies.
|
47
|
-
HELP_NAME : 'anon',
|
48
|
-
# List of help name aliases.
|
49
|
-
HELP_NAME_ALIASES : ['anonymous', 'public'],
|
50
|
-
# Type of help:
|
51
|
-
HELP_TYPE : HelpType.ADDITIONAL_HELP,
|
52
|
-
# One line summary of this help.
|
53
|
-
HELP_ONE_LINE_SUMMARY :
|
54
|
-
'Accessing public data without obtaining credentials',
|
55
|
-
# The full help text.
|
56
|
-
HELP_TEXT : _detailed_help_text,
|
57
|
-
}
|
@@ -1,116 +0,0 @@
|
|
1
|
-
# Copyright 2012 Google Inc. All Rights Reserved.
|
2
|
-
#
|
3
|
-
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
-
# you may not use this file except in compliance with the License.
|
5
|
-
# You may obtain a copy of the License at
|
6
|
-
#
|
7
|
-
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
-
#
|
9
|
-
# Unless required by applicable law or agreed to in writing, software
|
10
|
-
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
-
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
-
# See the License for the specific language governing permissions and
|
13
|
-
# limitations under the License.
|
14
|
-
|
15
|
-
from gslib.help_provider import HELP_NAME
|
16
|
-
from gslib.help_provider import HELP_NAME_ALIASES
|
17
|
-
from gslib.help_provider import HELP_ONE_LINE_SUMMARY
|
18
|
-
from gslib.help_provider import HelpProvider
|
19
|
-
from gslib.help_provider import HELP_TEXT
|
20
|
-
from gslib.help_provider import HelpType
|
21
|
-
from gslib.help_provider import HELP_TYPE
|
22
|
-
|
23
|
-
_detailed_help_text = ("""
|
24
|
-
<B>SYNOPSIS</B>
|
25
|
-
Top-level gsutil Options
|
26
|
-
|
27
|
-
|
28
|
-
<B>DESCRIPTION</B>
|
29
|
-
gsutil supports separate options for the top-level gsutil command and
|
30
|
-
the individual sub-commands (like cp, rm, etc.) The top-level options
|
31
|
-
control behavior of gsutil that apply across commands. For example, in
|
32
|
-
the command:
|
33
|
-
|
34
|
-
gsutil -m cp -p file gs://bucket/obj
|
35
|
-
|
36
|
-
the -m option applies to gsutil, while the -p option applies to the cp
|
37
|
-
sub-command.
|
38
|
-
|
39
|
-
|
40
|
-
<B>OPTIONS</B>
|
41
|
-
-d Shows HTTP requests/headers.
|
42
|
-
|
43
|
-
-D Shows HTTP requests/headers plus additional debug info needed when
|
44
|
-
posting support requests.
|
45
|
-
|
46
|
-
-DD Shows HTTP requests/headers plus additional debug info plus HTTP
|
47
|
-
upstream payload.
|
48
|
-
|
49
|
-
-h Allows you to specify additional HTTP headers, for example:
|
50
|
-
|
51
|
-
gsutil -h "Cache-Control:public,max-age=3600" \\
|
52
|
-
-h "Content-Type:text/html" cp ...
|
53
|
-
|
54
|
-
Note that you need to quote the headers/values that
|
55
|
-
contain spaces (such as "Content-Disposition: attachment;
|
56
|
-
filename=filename.ext"), to avoid having the shell split them
|
57
|
-
into separate arguments.
|
58
|
-
|
59
|
-
Note that because the -h option allows you to specify any HTTP
|
60
|
-
header, it is both powerful and potentially dangerous:
|
61
|
-
- It is powerful because it allows you to specify headers that
|
62
|
-
gsutil doesn't currently know about (e.g., to request
|
63
|
-
service features from a different storage service provider
|
64
|
-
than Google); or to override the values gsutil would normally
|
65
|
-
send with different values.
|
66
|
-
- It is potentially dangerous because you can specify headers
|
67
|
-
that cause gsutil to send invalid requests, or that in
|
68
|
-
other ways change the behavior of requests.
|
69
|
-
Thus, you should be sure you understand the underlying storage
|
70
|
-
service HTTP API (and what impact the headers you specify will
|
71
|
-
have) before using the gsutil -h option.
|
72
|
-
|
73
|
-
See also "gsutil help setmeta" for the ability to set metadata
|
74
|
-
fields on objects after they have been uploaded.
|
75
|
-
|
76
|
-
-m Causes supported operations (cp, mv, rm, setacl, setmeta) to run
|
77
|
-
in parallel. This can significantly improve performance if you are
|
78
|
-
uploading, downloading, moving, removing, or changing ACLs on
|
79
|
-
a large number of files over a fast network connection.
|
80
|
-
|
81
|
-
gsutil performs the specified operation using a combination of
|
82
|
-
multi-threading and multi-processing, using a number of threads
|
83
|
-
and processors determined by the parallel_thread_count and
|
84
|
-
parallel_process_count values set in the boto configuration
|
85
|
-
file. You might want to experiment with these value, as the
|
86
|
-
best value can vary based on a number of factors, including
|
87
|
-
network speed, number of CPUs, and available memory.
|
88
|
-
|
89
|
-
Using the -m option may make your performance worse if you
|
90
|
-
are using a slower network, such as the typical network speeds
|
91
|
-
offered by non-business home network plans.
|
92
|
-
|
93
|
-
If a download or upload operation using parallel transfer fails
|
94
|
-
before the entire transfer is complete (e.g. failing after 300 of
|
95
|
-
1000 files have been transferred), you will need to restart the
|
96
|
-
entire transfer.
|
97
|
-
|
98
|
-
-s Tells gsutil to use a simulated storage provider (for testing).
|
99
|
-
""")
|
100
|
-
|
101
|
-
|
102
|
-
class CommandOptions(HelpProvider):
|
103
|
-
"""Additional help about gsutil command-level options."""
|
104
|
-
|
105
|
-
help_spec = {
|
106
|
-
# Name of command or auxiliary help info for which this help applies.
|
107
|
-
HELP_NAME : 'options',
|
108
|
-
# List of help name aliases.
|
109
|
-
HELP_NAME_ALIASES : ['arg', 'args', 'cli', 'opt', 'opts'],
|
110
|
-
# Type of help:
|
111
|
-
HELP_TYPE : HelpType.ADDITIONAL_HELP,
|
112
|
-
# One line summary of this help.
|
113
|
-
HELP_ONE_LINE_SUMMARY : 'gsutil-level command line options',
|
114
|
-
# The full help text.
|
115
|
-
HELP_TEXT : _detailed_help_text,
|
116
|
-
}
|