libv8 6.7.288.46.1 → 7.3.492.27.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 +3 -0
- data/CHANGELOG.md +4 -0
- data/README.md +2 -0
- data/ext/libv8/builder.rb +6 -2
- data/lib/libv8/version.rb +1 -1
- data/vendor/depot_tools/.gitattributes +1 -0
- data/vendor/depot_tools/.gitignore +7 -0
- data/vendor/depot_tools/CROS_OWNERS +5 -0
- data/vendor/depot_tools/OWNERS +12 -1
- data/vendor/depot_tools/PRESUBMIT.py +16 -9
- data/vendor/depot_tools/README.md +9 -2
- data/vendor/depot_tools/autoninja +14 -6
- data/vendor/depot_tools/autoninja.bat +11 -1
- data/vendor/depot_tools/autoninja.py +40 -18
- data/vendor/depot_tools/bb +12 -0
- data/vendor/depot_tools/bb.bat +7 -0
- data/vendor/depot_tools/bootstrap/win/manifest.txt +1 -1
- data/vendor/depot_tools/bootstrap/win/manifest_bleeding_edge.txt +1 -1
- data/vendor/depot_tools/bootstrap/win/win_tools.py +2 -1
- data/vendor/depot_tools/buildbucket.py +57 -4
- data/vendor/depot_tools/cipd +157 -44
- data/vendor/depot_tools/cipd.bat +51 -14
- data/vendor/depot_tools/cipd.ps1 +104 -42
- data/vendor/depot_tools/cipd_client_version +1 -1
- data/vendor/depot_tools/cipd_client_version.digests +21 -0
- data/vendor/depot_tools/cipd_manifest.txt +19 -6
- data/vendor/depot_tools/cipd_manifest.versions +318 -0
- data/vendor/depot_tools/clang_format.py +4 -4
- data/vendor/depot_tools/cpplint.py +44 -199
- data/vendor/depot_tools/dart_format.py +2 -2
- data/vendor/depot_tools/detect_host_arch.py +8 -3
- data/vendor/depot_tools/download_from_google_storage.py +47 -39
- data/vendor/depot_tools/fetch.py +30 -18
- data/vendor/depot_tools/fetch_configs/android_internal.py +34 -0
- data/vendor/depot_tools/fetch_configs/chromium.py +18 -1
- data/vendor/depot_tools/fetch_configs/config_util.py +4 -2
- data/vendor/depot_tools/fetch_configs/inspector_protocol.py +40 -0
- data/vendor/depot_tools/fetch_configs/node-ci.py +41 -0
- data/vendor/depot_tools/fix_encoding.py +3 -3
- data/vendor/depot_tools/gclient +1 -1
- data/vendor/depot_tools/gclient.py +415 -198
- data/vendor/depot_tools/gclient_eval.py +220 -171
- data/vendor/depot_tools/gclient_paths.py +142 -0
- data/vendor/depot_tools/gclient_scm.py +200 -51
- data/vendor/depot_tools/gclient_utils.py +88 -191
- data/vendor/depot_tools/gerrit_client.py +13 -0
- data/vendor/depot_tools/gerrit_util.py +158 -23
- data/vendor/depot_tools/git-nav-upstream +1 -1
- data/vendor/depot_tools/git_cache.py +77 -24
- data/vendor/depot_tools/git_cl.py +705 -1099
- data/vendor/depot_tools/git_common.py +9 -6
- data/vendor/depot_tools/git_map_branches.py +19 -2
- data/vendor/depot_tools/git_nav_downstream.py +3 -4
- data/vendor/depot_tools/git_rebase_update.py +14 -0
- data/vendor/depot_tools/git_reparent_branch.py +8 -2
- data/vendor/depot_tools/gn.py +38 -3
- data/vendor/depot_tools/gsutil.py +8 -3
- data/vendor/depot_tools/gsutil.py.bat +15 -0
- data/vendor/depot_tools/gsutil.vpython +16 -0
- data/vendor/depot_tools/infra/config/OWNERS +0 -1
- data/vendor/depot_tools/infra/config/recipes.cfg +3 -2
- data/vendor/depot_tools/lucicfg +12 -0
- data/vendor/depot_tools/lucicfg.bat +7 -0
- data/vendor/depot_tools/man/html/git-map-branches.html +34 -2
- data/vendor/depot_tools/man/html/git-new-branch.html +40 -32
- data/vendor/depot_tools/man/man1/git-map-branches.1 +24 -5
- data/vendor/depot_tools/man/man1/git-new-branch.1 +35 -27
- data/vendor/depot_tools/man/src/git-map-branches.demo.1.sh +1 -0
- data/vendor/depot_tools/man/src/git-map-branches.txt +10 -0
- data/vendor/depot_tools/man/src/git-new-branch.demo.1.sh +9 -4
- data/vendor/depot_tools/man/src/git-new-branch.txt +1 -1
- data/vendor/depot_tools/metrics.README.md +98 -0
- data/vendor/depot_tools/metrics.py +296 -0
- data/vendor/depot_tools/metrics_utils.py +303 -0
- data/vendor/depot_tools/my_activity.py +91 -29
- data/vendor/depot_tools/ninja +1 -1
- data/vendor/depot_tools/ninjalog.README.md +64 -0
- data/vendor/depot_tools/ninjalog_uploader.py +232 -0
- data/vendor/depot_tools/ninjalog_uploader_wrapper.py +116 -0
- data/vendor/depot_tools/owners.py +30 -13
- data/vendor/depot_tools/owners_finder.py +5 -2
- data/vendor/depot_tools/presubmit_canned_checks.py +188 -29
- data/vendor/depot_tools/presubmit_support.py +18 -41
- data/vendor/depot_tools/pylintrc +23 -19
- data/vendor/depot_tools/recipes/OWNERS +2 -0
- data/vendor/depot_tools/recipes/README.recipes.md +344 -151
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/OWNERS +2 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/__init__.py +2 -16
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/api.py +141 -99
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/basic.json +5 -8
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/basic_luci.json +5 -8
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/basic_with_branch_heads.json +6 -98
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/clobber.json +4 -9
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/deprecated_got_revision_mapping.json +45 -5
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/gerrit_no_rebase_patch_ref.json +4 -9
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/gerrit_no_reset.json +4 -9
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/{tryjob.json → input_commit_with_id_without_repo.json} +6 -11
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/{tryjob_empty_revision.json → multiple_patch_refs.json} +8 -9
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/no_apply_patch_on_gclient.json +19 -29
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/{trychange.json → refs.json} +4 -9
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/reset_root_solution_revision.json +4 -9
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_fail.json +51 -6
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_fail_patch.json +50 -6
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_fail_patch_download.json +51 -6
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_gerrit_angle.json +17 -25
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_gerrit_branch_heads.json +17 -25
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_gerrit_feature_branch.json +18 -26
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_gerrit_v8_feature_branch.json +18 -26
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_gerrit_webrtc.json +26 -28
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_v8.json +45 -5
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_v8_head_by_default.json +17 -25
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/unrecognized_commit_repo.json +13 -0
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/with_manifest_name.json +13 -152
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/with_tags.json +4 -9
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.py +185 -202
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/resources/bot_update.py +52 -157
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/test_api.py +5 -14
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/tests/ensure_checkout.py +34 -0
- data/vendor/depot_tools/recipes/recipe_modules/cipd/api.py +14 -2
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/basic.json +4 -5
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/basic_pkg.json +4 -5
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/describe-failed.json +7 -5
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/describe-many-instances.json +4 -5
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/mac64.json +4 -5
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/pkg_bad_file.json +9 -3
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/pkg_bad_mode.json +9 -3
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/pkg_bad_verfile.json +9 -3
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/full.expected/win64.json +4 -5
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/junk arch.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/junk bits.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/linux_arm_32.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/linux_arm_64.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/linux_intel_32.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/linux_intel_64.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/linux_mips_64.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/mac_intel_64.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/win_intel_32.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/cipd/examples/platform_suffix.expected/win_intel_64.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/depot_tools/api.py +13 -8
- data/vendor/depot_tools/recipes/recipe_modules/depot_tools/examples/full.expected/basic.json +18 -12
- data/vendor/depot_tools/recipes/recipe_modules/depot_tools/examples/full.expected/basic_luci.json +18 -12
- data/vendor/depot_tools/recipes/recipe_modules/depot_tools/examples/full.expected/win.json +18 -12
- data/vendor/depot_tools/recipes/recipe_modules/depot_tools/examples/full.py +3 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/__init__.py +1 -0
- data/vendor/depot_tools/recipes/recipe_modules/gclient/api.py +58 -46
- data/vendor/depot_tools/recipes/recipe_modules/gclient/config.py +65 -22
- data/vendor/depot_tools/recipes/recipe_modules/gclient/examples/full.expected/basic.json +20 -21
- data/vendor/depot_tools/recipes/recipe_modules/gclient/examples/full.expected/buildbot.json +20 -21
- data/vendor/depot_tools/recipes/recipe_modules/gclient/examples/full.expected/revision.json +20 -21
- data/vendor/depot_tools/recipes/recipe_modules/gclient/examples/full.expected/tryserver.json +20 -21
- data/vendor/depot_tools/recipes/recipe_modules/gclient/examples/full.py +5 -2
- data/vendor/depot_tools/recipes/recipe_modules/gclient/tests/patch_project.py +62 -14
- data/vendor/depot_tools/recipes/recipe_modules/gerrit/api.py +24 -38
- data/vendor/depot_tools/recipes/recipe_modules/gerrit/examples/full.expected/basic.json +56 -50
- data/vendor/depot_tools/recipes/recipe_modules/gerrit/examples/full.py +15 -9
- data/vendor/depot_tools/recipes/recipe_modules/git/__init__.py +4 -1
- data/vendor/depot_tools/recipes/recipe_modules/git/api.py +34 -22
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_branch.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_file_name.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_hash.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_luci.json +222 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_ref.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_submodule_update_force.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/basic_tags.json +224 -0
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/can_fail_build.json +10 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/cannot_fail_build.json +5 -7
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/cat-file_test.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/count-objects_delta.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/count-objects_failed.json +5 -7
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/count-objects_with_bad_output.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/count-objects_with_bad_output_fails_build.json +10 -5
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/curl_trace_file.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/git-cache-checkout.json +8 -9
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/platform_win.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/rebase_failed.json +12 -8
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/remote_not_origin.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.expected/set_got_revision.json +5 -6
- data/vendor/depot_tools/recipes/recipe_modules/git/examples/full.py +27 -11
- data/vendor/depot_tools/recipes/recipe_modules/git_cl/api.py +1 -1
- data/vendor/depot_tools/recipes/recipe_modules/git_cl/examples/full.expected/basic.json +12 -13
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/__init__.py +5 -0
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/api.py +120 -5
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/examples/full.expected/basic.json +45 -3
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/examples/full.py +25 -0
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/resources/gerrit_client.py +56 -4
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/tests/parse_repo_url.expected/basic.json +6 -0
- data/vendor/depot_tools/recipes/recipe_modules/gitiles/tests/parse_repo_url.py +49 -0
- data/vendor/depot_tools/recipes/recipe_modules/gsutil/api.py +24 -13
- data/vendor/depot_tools/recipes/recipe_modules/gsutil/examples/full.expected/basic.json +13 -14
- data/vendor/depot_tools/recipes/recipe_modules/infra_paths/examples/full.expected/basic.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/infra_paths/examples/full.expected/paths_buildbot_linux.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/infra_paths/examples/full.expected/paths_buildbot_mac.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/infra_paths/examples/full.expected/paths_buildbot_win.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/infra_paths/examples/full.expected/paths_generic_linux.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/infra_paths/examples/full.expected/paths_generic_mac.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/infra_paths/examples/full.expected/paths_generic_win.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/infra_paths/examples/full.expected/paths_kitchen_linux.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/infra_paths/examples/full.expected/paths_kitchen_mac.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/infra_paths/examples/full.expected/paths_kitchen_win.json +2 -3
- data/vendor/depot_tools/recipes/recipe_modules/infra_paths/path_config.py +1 -2
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/__init__.py +35 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/api.py +116 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/examples/full.expected/linux.json +22 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/examples/full.expected/mac.json +82 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/examples/full.expected/win.json +22 -0
- data/vendor/depot_tools/recipes/recipe_modules/osx_sdk/examples/full.py +23 -0
- data/vendor/depot_tools/recipes/recipe_modules/presubmit/__init__.py +1 -0
- data/vendor/depot_tools/recipes/recipe_modules/presubmit/api.py +2 -7
- data/vendor/depot_tools/recipes/recipe_modules/presubmit/examples/full.expected/basic.json +7 -6
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/__init__.py +1 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/api.py +117 -8
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/basic_tags.json +4 -5
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/set_failure_hash_with_no_steps.json +7 -4
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/with_gerrit_patch.json +98 -7
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/with_gerrit_patch_and_target_ref.json +147 -0
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/with_git_patch.json +8 -5
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/with_git_patch_luci.json +8 -5
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/with_wrong_patch.json +9 -6
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.expected/with_wrong_patch_new.json +9 -6
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/examples/full.py +27 -2
- data/vendor/depot_tools/recipes/recipe_modules/tryserver/test_api.py +14 -0
- data/vendor/depot_tools/recipes/recipe_modules/windows_sdk/__init__.py +25 -0
- data/vendor/depot_tools/recipes/recipe_modules/windows_sdk/api.py +137 -0
- data/vendor/depot_tools/recipes/recipe_modules/windows_sdk/examples/full.expected/linux.json +22 -0
- data/vendor/depot_tools/recipes/recipe_modules/windows_sdk/examples/full.expected/mac.json +22 -0
- data/vendor/depot_tools/recipes/recipe_modules/windows_sdk/examples/full.expected/win.json +107 -0
- data/vendor/depot_tools/recipes/recipe_modules/windows_sdk/examples/full.py +26 -0
- data/vendor/depot_tools/recipes/recipes.py +37 -27
- data/vendor/depot_tools/recipes/recipes/fetch_end_to_end_test.expected/basic.json +7 -10
- data/vendor/depot_tools/repo +34 -8
- data/vendor/depot_tools/roll_dep.py +52 -49
- data/vendor/depot_tools/scm.py +38 -23
- data/vendor/depot_tools/setup_color.py +4 -2
- data/vendor/depot_tools/split_cl.py +32 -4
- data/vendor/depot_tools/subprocess2.py +22 -4
- data/vendor/depot_tools/third_party/httplib2/README.chromium +2 -2
- data/vendor/depot_tools/third_party/httplib2/__init__.py +242 -158
- data/vendor/depot_tools/third_party/httplib2/cacerts.txt +57 -44
- data/vendor/depot_tools/third_party/httplib2/socks.py +15 -5
- data/vendor/depot_tools/third_party/logilab/README.chromium +2 -4
- data/vendor/depot_tools/third_party/logilab/astroid/README.chromium +2 -1
- data/vendor/depot_tools/third_party/logilab/astroid/__init__.py +10 -5
- data/vendor/depot_tools/third_party/logilab/astroid/__pkginfo__.py +5 -5
- data/vendor/depot_tools/third_party/logilab/astroid/arguments.py +233 -0
- data/vendor/depot_tools/third_party/logilab/astroid/as_string.py +82 -33
- data/vendor/depot_tools/third_party/logilab/astroid/bases.py +137 -153
- data/vendor/depot_tools/third_party/logilab/astroid/brain/{builtin_inference.py → brain_builtin_inference.py} +117 -26
- data/vendor/depot_tools/third_party/logilab/astroid/brain/brain_dateutil.py +15 -0
- data/vendor/depot_tools/third_party/logilab/astroid/brain/{py2gi.py → brain_gi.py} +48 -8
- data/vendor/depot_tools/third_party/logilab/astroid/brain/{py2mechanize.py → brain_mechanize.py} +0 -0
- data/vendor/depot_tools/third_party/logilab/astroid/brain/{pynose.py → brain_nose.py} +4 -1
- data/vendor/depot_tools/third_party/logilab/astroid/brain/brain_numpy.py +62 -0
- data/vendor/depot_tools/third_party/logilab/astroid/brain/brain_pytest.py +76 -0
- data/vendor/depot_tools/third_party/logilab/astroid/brain/brain_qt.py +44 -0
- data/vendor/depot_tools/third_party/logilab/astroid/brain/{pysix_moves.py → brain_six.py} +28 -1
- data/vendor/depot_tools/third_party/logilab/astroid/brain/brain_ssl.py +65 -0
- data/vendor/depot_tools/third_party/logilab/astroid/brain/brain_stdlib.py +473 -0
- data/vendor/depot_tools/third_party/logilab/astroid/builder.py +104 -81
- data/vendor/depot_tools/third_party/logilab/astroid/context.py +81 -0
- data/vendor/depot_tools/third_party/logilab/astroid/decorators.py +75 -0
- data/vendor/depot_tools/third_party/logilab/astroid/exceptions.py +20 -0
- data/vendor/depot_tools/third_party/logilab/astroid/inference.py +137 -183
- data/vendor/depot_tools/third_party/logilab/astroid/manager.py +45 -169
- data/vendor/depot_tools/third_party/logilab/astroid/mixins.py +37 -14
- data/vendor/depot_tools/third_party/logilab/astroid/modutils.py +112 -41
- data/vendor/depot_tools/third_party/logilab/astroid/node_classes.py +243 -156
- data/vendor/depot_tools/third_party/logilab/astroid/nodes.py +35 -22
- data/vendor/depot_tools/third_party/logilab/astroid/objects.py +186 -0
- data/vendor/depot_tools/third_party/logilab/astroid/protocols.py +157 -102
- data/vendor/depot_tools/third_party/logilab/astroid/raw_building.py +32 -8
- data/vendor/depot_tools/third_party/logilab/astroid/rebuilder.py +372 -309
- data/vendor/depot_tools/third_party/logilab/astroid/scoped_nodes.py +652 -420
- data/vendor/depot_tools/third_party/logilab/astroid/test_utils.py +4 -21
- data/vendor/depot_tools/third_party/logilab/astroid/transforms.py +96 -0
- data/vendor/depot_tools/third_party/logilab/astroid/util.py +89 -0
- data/vendor/depot_tools/third_party/logilab/lazy_object_proxy/LICENSE +19 -0
- data/vendor/depot_tools/third_party/logilab/lazy_object_proxy/README.chromium +11 -0
- data/vendor/depot_tools/third_party/logilab/lazy_object_proxy/__init__.py +20 -0
- data/vendor/depot_tools/third_party/logilab/lazy_object_proxy/cext.c +1421 -0
- data/vendor/depot_tools/third_party/logilab/lazy_object_proxy/compat.py +9 -0
- data/vendor/depot_tools/third_party/logilab/lazy_object_proxy/simple.py +246 -0
- data/vendor/depot_tools/third_party/logilab/lazy_object_proxy/slots.py +414 -0
- data/vendor/depot_tools/third_party/logilab/lazy_object_proxy/utils.py +13 -0
- data/vendor/depot_tools/third_party/logilab/wrapt/LICENSE +24 -0
- data/vendor/depot_tools/third_party/logilab/wrapt/README.chromium +11 -0
- data/vendor/depot_tools/third_party/logilab/wrapt/__init__.py +19 -0
- data/vendor/depot_tools/third_party/logilab/wrapt/_wrappers.c +2729 -0
- data/vendor/depot_tools/third_party/logilab/wrapt/arguments.py +96 -0
- data/vendor/depot_tools/third_party/logilab/wrapt/decorators.py +512 -0
- data/vendor/depot_tools/third_party/logilab/wrapt/importer.py +228 -0
- data/vendor/depot_tools/third_party/logilab/wrapt/wrappers.py +901 -0
- data/vendor/depot_tools/third_party/pylint/README.chromium +2 -25
- data/vendor/depot_tools/third_party/pylint/__pkginfo__.py +13 -3
- data/vendor/depot_tools/third_party/pylint/checkers/__init__.py +1 -2
- data/vendor/depot_tools/third_party/pylint/checkers/async.py +82 -0
- data/vendor/depot_tools/third_party/pylint/checkers/base.py +893 -119
- data/vendor/depot_tools/third_party/pylint/checkers/classes.py +342 -204
- data/vendor/depot_tools/third_party/pylint/checkers/design_analysis.py +51 -34
- data/vendor/depot_tools/third_party/pylint/checkers/exceptions.py +84 -47
- data/vendor/depot_tools/third_party/pylint/checkers/format.py +55 -30
- data/vendor/depot_tools/third_party/pylint/checkers/imports.py +314 -73
- data/vendor/depot_tools/third_party/pylint/checkers/logging.py +10 -8
- data/vendor/depot_tools/third_party/pylint/checkers/misc.py +2 -1
- data/vendor/depot_tools/third_party/pylint/checkers/newstyle.py +45 -48
- data/vendor/depot_tools/third_party/pylint/checkers/python3.py +31 -21
- data/vendor/depot_tools/third_party/pylint/checkers/raw_metrics.py +3 -3
- data/vendor/depot_tools/third_party/pylint/checkers/similar.py +4 -5
- data/vendor/depot_tools/third_party/pylint/checkers/spelling.py +24 -10
- data/vendor/depot_tools/third_party/pylint/checkers/stdlib.py +120 -56
- data/vendor/depot_tools/third_party/pylint/checkers/strings.py +38 -35
- data/vendor/depot_tools/third_party/pylint/checkers/typecheck.py +485 -138
- data/vendor/depot_tools/third_party/pylint/checkers/utils.py +319 -142
- data/vendor/depot_tools/third_party/pylint/checkers/variables.py +329 -207
- data/vendor/depot_tools/third_party/pylint/config.py +739 -76
- data/vendor/depot_tools/third_party/pylint/epylint.py +9 -5
- data/vendor/depot_tools/third_party/pylint/extensions/__init__.py +0 -0
- data/vendor/depot_tools/third_party/pylint/extensions/check_docs.py +311 -0
- data/vendor/depot_tools/third_party/pylint/extensions/check_elif.py +62 -0
- data/vendor/depot_tools/third_party/{logilab/common → pylint}/graph.py +30 -133
- data/vendor/depot_tools/third_party/pylint/gui.py +2 -2
- data/vendor/depot_tools/third_party/pylint/interfaces.py +21 -3
- data/vendor/depot_tools/third_party/pylint/lint.py +123 -140
- data/vendor/depot_tools/third_party/pylint/pyreverse/diadefslib.py +10 -13
- data/vendor/depot_tools/third_party/pylint/pyreverse/diagrams.py +15 -4
- data/vendor/depot_tools/third_party/pylint/pyreverse/inspector.py +372 -0
- data/vendor/depot_tools/third_party/pylint/pyreverse/main.py +30 -7
- data/vendor/depot_tools/third_party/pylint/pyreverse/utils.py +80 -2
- data/vendor/depot_tools/third_party/{logilab/common → pylint/pyreverse}/vcgutils.py +19 -37
- data/vendor/depot_tools/third_party/pylint/pyreverse/writer.py +3 -4
- data/vendor/depot_tools/third_party/pylint/reporters/__init__.py +34 -18
- data/vendor/depot_tools/third_party/pylint/reporters/guireporter.py +1 -1
- data/vendor/depot_tools/third_party/pylint/reporters/html.py +10 -3
- data/vendor/depot_tools/third_party/pylint/reporters/json.py +10 -4
- data/vendor/depot_tools/third_party/pylint/reporters/text.py +94 -3
- data/vendor/depot_tools/third_party/pylint/reporters/ureports/__init__.py +106 -0
- data/vendor/depot_tools/third_party/{logilab/common → pylint/reporters}/ureports/html_writer.py +17 -57
- data/vendor/depot_tools/third_party/{logilab/common → pylint/reporters}/ureports/nodes.py +52 -74
- data/vendor/depot_tools/third_party/{logilab/common → pylint/reporters}/ureports/text_writer.py +14 -60
- data/vendor/depot_tools/third_party/pylint/testutils.py +22 -20
- data/vendor/depot_tools/third_party/pylint/utils.py +268 -44
- data/vendor/depot_tools/third_party/repo/progress.py +42 -0
- data/vendor/depot_tools/update_depot_tools +1 -1
- data/vendor/depot_tools/upload_metrics.py +25 -0
- data/vendor/depot_tools/win_toolchain/get_toolchain_if_necessary.py +45 -15
- data/vendor/depot_tools/win_toolchain/package_from_installed.py +71 -24
- data/vendor/depot_tools/yapf +1 -1
- data/vendor/depot_tools/yapf.bat +1 -1
- metadata +92 -77
- data/vendor/depot_tools/git-crsync +0 -3
- data/vendor/depot_tools/infra/config/cq.cfg +0 -32
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/apply_gerrit_ref.json +0 -29
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/apply_gerrit_ref_custom.json +0 -29
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/buildbot.json +0 -105
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/shallow.json +0 -195
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_gerrit_angle_deprecated.json +0 -248
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/tryjob_gerrit_v8.json +0 -248
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/examples/full.expected/with_manifest_name_no_patch.json +0 -105
- data/vendor/depot_tools/recipes/recipe_modules/bot_update/resources/apply_gerrit.py +0 -33
- data/vendor/depot_tools/third_party/logilab/astroid/brain/py2pytest.py +0 -31
- data/vendor/depot_tools/third_party/logilab/astroid/brain/py2qt4.py +0 -22
- data/vendor/depot_tools/third_party/logilab/astroid/brain/py2stdlib.py +0 -334
- data/vendor/depot_tools/third_party/logilab/astroid/inspector.py +0 -273
- data/vendor/depot_tools/third_party/logilab/astroid/utils.py +0 -239
- data/vendor/depot_tools/third_party/logilab/common/LICENSE.txt +0 -339
- data/vendor/depot_tools/third_party/logilab/common/README.chromium +0 -11
- data/vendor/depot_tools/third_party/logilab/common/__init__.py +0 -175
- data/vendor/depot_tools/third_party/logilab/common/__pkginfo__.py +0 -57
- data/vendor/depot_tools/third_party/logilab/common/cache.py +0 -114
- data/vendor/depot_tools/third_party/logilab/common/changelog.py +0 -238
- data/vendor/depot_tools/third_party/logilab/common/clcommands.py +0 -334
- data/vendor/depot_tools/third_party/logilab/common/cli.py +0 -211
- data/vendor/depot_tools/third_party/logilab/common/compat.py +0 -78
- data/vendor/depot_tools/third_party/logilab/common/configuration.py +0 -1105
- data/vendor/depot_tools/third_party/logilab/common/contexts.py +0 -5
- data/vendor/depot_tools/third_party/logilab/common/corbautils.py +0 -117
- data/vendor/depot_tools/third_party/logilab/common/daemon.py +0 -101
- data/vendor/depot_tools/third_party/logilab/common/date.py +0 -335
- data/vendor/depot_tools/third_party/logilab/common/dbf.py +0 -231
- data/vendor/depot_tools/third_party/logilab/common/debugger.py +0 -214
- data/vendor/depot_tools/third_party/logilab/common/decorators.py +0 -281
- data/vendor/depot_tools/third_party/logilab/common/deprecation.py +0 -189
- data/vendor/depot_tools/third_party/logilab/common/fileutils.py +0 -404
- data/vendor/depot_tools/third_party/logilab/common/interface.py +0 -71
- data/vendor/depot_tools/third_party/logilab/common/logging_ext.py +0 -195
- data/vendor/depot_tools/third_party/logilab/common/modutils.py +0 -702
- data/vendor/depot_tools/third_party/logilab/common/optik_ext.py +0 -392
- data/vendor/depot_tools/third_party/logilab/common/optparser.py +0 -92
- data/vendor/depot_tools/third_party/logilab/common/proc.py +0 -277
- data/vendor/depot_tools/third_party/logilab/common/pyro_ext.py +0 -180
- data/vendor/depot_tools/third_party/logilab/common/pytest.py +0 -1199
- data/vendor/depot_tools/third_party/logilab/common/registry.py +0 -1119
- data/vendor/depot_tools/third_party/logilab/common/shellutils.py +0 -462
- data/vendor/depot_tools/third_party/logilab/common/sphinx_ext.py +0 -87
- data/vendor/depot_tools/third_party/logilab/common/sphinxutils.py +0 -122
- data/vendor/depot_tools/third_party/logilab/common/table.py +0 -929
- data/vendor/depot_tools/third_party/logilab/common/tasksqueue.py +0 -101
- data/vendor/depot_tools/third_party/logilab/common/testlib.py +0 -1392
- data/vendor/depot_tools/third_party/logilab/common/textutils.py +0 -537
- data/vendor/depot_tools/third_party/logilab/common/tree.py +0 -369
- data/vendor/depot_tools/third_party/logilab/common/umessage.py +0 -194
- data/vendor/depot_tools/third_party/logilab/common/ureports/__init__.py +0 -172
- data/vendor/depot_tools/third_party/logilab/common/ureports/docbook_writer.py +0 -140
- data/vendor/depot_tools/third_party/logilab/common/urllib2ext.py +0 -89
- data/vendor/depot_tools/third_party/logilab/common/visitor.py +0 -109
- data/vendor/depot_tools/third_party/logilab/common/xmlrpcutils.py +0 -131
- data/vendor/depot_tools/third_party/logilab/common/xmlutils.py +0 -61
@@ -0,0 +1,228 @@
|
|
1
|
+
"""This module implements a post import hook mechanism styled after what is
|
2
|
+
described in PEP-369. Note that it doesn't cope with modules being reloaded.
|
3
|
+
|
4
|
+
"""
|
5
|
+
|
6
|
+
import sys
|
7
|
+
import threading
|
8
|
+
|
9
|
+
PY2 = sys.version_info[0] == 2
|
10
|
+
PY3 = sys.version_info[0] == 3
|
11
|
+
|
12
|
+
if PY3:
|
13
|
+
import importlib
|
14
|
+
string_types = str,
|
15
|
+
else:
|
16
|
+
string_types = basestring,
|
17
|
+
|
18
|
+
from .decorators import synchronized
|
19
|
+
|
20
|
+
# The dictionary registering any post import hooks to be triggered once
|
21
|
+
# the target module has been imported. Once a module has been imported
|
22
|
+
# and the hooks fired, the list of hooks recorded against the target
|
23
|
+
# module will be truncacted but the list left in the dictionary. This
|
24
|
+
# acts as a flag to indicate that the module had already been imported.
|
25
|
+
|
26
|
+
_post_import_hooks = {}
|
27
|
+
_post_import_hooks_init = False
|
28
|
+
_post_import_hooks_lock = threading.RLock()
|
29
|
+
|
30
|
+
# Register a new post import hook for the target module name. This
|
31
|
+
# differs from the PEP-369 implementation in that it also allows the
|
32
|
+
# hook function to be specified as a string consisting of the name of
|
33
|
+
# the callback in the form 'module:function'. This will result in a
|
34
|
+
# proxy callback being registered which will defer loading of the
|
35
|
+
# specified module containing the callback function until required.
|
36
|
+
|
37
|
+
def _create_import_hook_from_string(name):
|
38
|
+
def import_hook(module):
|
39
|
+
module_name, function = name.split(':')
|
40
|
+
attrs = function.split('.')
|
41
|
+
__import__(module_name)
|
42
|
+
callback = sys.modules[module_name]
|
43
|
+
for attr in attrs:
|
44
|
+
callback = getattr(callback, attr)
|
45
|
+
return callback(module)
|
46
|
+
return import_hook
|
47
|
+
|
48
|
+
@synchronized(_post_import_hooks_lock)
|
49
|
+
def register_post_import_hook(hook, name):
|
50
|
+
# Create a deferred import hook if hook is a string name rather than
|
51
|
+
# a callable function.
|
52
|
+
|
53
|
+
if isinstance(hook, string_types):
|
54
|
+
hook = _create_import_hook_from_string(hook)
|
55
|
+
|
56
|
+
# Automatically install the import hook finder if it has not already
|
57
|
+
# been installed.
|
58
|
+
|
59
|
+
global _post_import_hooks_init
|
60
|
+
|
61
|
+
if not _post_import_hooks_init:
|
62
|
+
_post_import_hooks_init = True
|
63
|
+
sys.meta_path.insert(0, ImportHookFinder())
|
64
|
+
|
65
|
+
# Determine if any prior registration of a post import hook for
|
66
|
+
# the target modules has occurred and act appropriately.
|
67
|
+
|
68
|
+
hooks = _post_import_hooks.get(name, None)
|
69
|
+
|
70
|
+
if hooks is None:
|
71
|
+
# No prior registration of post import hooks for the target
|
72
|
+
# module. We need to check whether the module has already been
|
73
|
+
# imported. If it has we fire the hook immediately and add an
|
74
|
+
# empty list to the registry to indicate that the module has
|
75
|
+
# already been imported and hooks have fired. Otherwise add
|
76
|
+
# the post import hook to the registry.
|
77
|
+
|
78
|
+
module = sys.modules.get(name, None)
|
79
|
+
|
80
|
+
if module is not None:
|
81
|
+
_post_import_hooks[name] = []
|
82
|
+
hook(module)
|
83
|
+
|
84
|
+
else:
|
85
|
+
_post_import_hooks[name] = [hook]
|
86
|
+
|
87
|
+
elif hooks == []:
|
88
|
+
# A prior registration of port import hooks for the target
|
89
|
+
# module was done and the hooks already fired. Fire the hook
|
90
|
+
# immediately.
|
91
|
+
|
92
|
+
module = sys.modules[name]
|
93
|
+
hook(module)
|
94
|
+
|
95
|
+
else:
|
96
|
+
# A prior registration of port import hooks for the target
|
97
|
+
# module was done but the module has not yet been imported.
|
98
|
+
|
99
|
+
_post_import_hooks[name].append(hook)
|
100
|
+
|
101
|
+
# Register post import hooks defined as package entry points.
|
102
|
+
|
103
|
+
def _create_import_hook_from_entrypoint(entrypoint):
|
104
|
+
def import_hook(module):
|
105
|
+
__import__(entrypoint.module_name)
|
106
|
+
callback = sys.modules[entrypoint.module_name]
|
107
|
+
for attr in entrypoint.attrs:
|
108
|
+
callback = getattr(callback, attr)
|
109
|
+
return callback(module)
|
110
|
+
return import_hook
|
111
|
+
|
112
|
+
def discover_post_import_hooks(group):
|
113
|
+
try:
|
114
|
+
import pkg_resources
|
115
|
+
except ImportError:
|
116
|
+
return
|
117
|
+
|
118
|
+
for entrypoint in pkg_resources.iter_entry_points(group=group):
|
119
|
+
callback = _create_import_hook_from_entrypoint(entrypoint)
|
120
|
+
register_post_import_hook(callback, entrypoint.name)
|
121
|
+
|
122
|
+
# Indicate that a module has been loaded. Any post import hooks which
|
123
|
+
# were registered against the target module will be invoked. If an
|
124
|
+
# exception is raised in any of the post import hooks, that will cause
|
125
|
+
# the import of the target module to fail.
|
126
|
+
|
127
|
+
@synchronized(_post_import_hooks_lock)
|
128
|
+
def notify_module_loaded(module):
|
129
|
+
name = getattr(module, '__name__', None)
|
130
|
+
hooks = _post_import_hooks.get(name, None)
|
131
|
+
|
132
|
+
if hooks:
|
133
|
+
_post_import_hooks[name] = []
|
134
|
+
|
135
|
+
for hook in hooks:
|
136
|
+
hook(module)
|
137
|
+
|
138
|
+
# A custom module import finder. This intercepts attempts to import
|
139
|
+
# modules and watches out for attempts to import target modules of
|
140
|
+
# interest. When a module of interest is imported, then any post import
|
141
|
+
# hooks which are registered will be invoked.
|
142
|
+
|
143
|
+
class _ImportHookLoader:
|
144
|
+
|
145
|
+
def load_module(self, fullname):
|
146
|
+
module = sys.modules[fullname]
|
147
|
+
notify_module_loaded(module)
|
148
|
+
|
149
|
+
return module
|
150
|
+
|
151
|
+
class _ImportHookChainedLoader:
|
152
|
+
|
153
|
+
def __init__(self, loader):
|
154
|
+
self.loader = loader
|
155
|
+
|
156
|
+
def load_module(self, fullname):
|
157
|
+
module = self.loader.load_module(fullname)
|
158
|
+
notify_module_loaded(module)
|
159
|
+
|
160
|
+
return module
|
161
|
+
|
162
|
+
class ImportHookFinder:
|
163
|
+
|
164
|
+
def __init__(self):
|
165
|
+
self.in_progress = {}
|
166
|
+
|
167
|
+
@synchronized(_post_import_hooks_lock)
|
168
|
+
def find_module(self, fullname, path=None):
|
169
|
+
# If the module being imported is not one we have registered
|
170
|
+
# post import hooks for, we can return immediately. We will
|
171
|
+
# take no further part in the importing of this module.
|
172
|
+
|
173
|
+
if not fullname in _post_import_hooks:
|
174
|
+
return None
|
175
|
+
|
176
|
+
# When we are interested in a specific module, we will call back
|
177
|
+
# into the import system a second time to defer to the import
|
178
|
+
# finder that is supposed to handle the importing of the module.
|
179
|
+
# We set an in progress flag for the target module so that on
|
180
|
+
# the second time through we don't trigger another call back
|
181
|
+
# into the import system and cause a infinite loop.
|
182
|
+
|
183
|
+
if fullname in self.in_progress:
|
184
|
+
return None
|
185
|
+
|
186
|
+
self.in_progress[fullname] = True
|
187
|
+
|
188
|
+
# Now call back into the import system again.
|
189
|
+
|
190
|
+
try:
|
191
|
+
if PY3:
|
192
|
+
# For Python 3 we need to use find_loader() from
|
193
|
+
# the importlib module. It doesn't actually
|
194
|
+
# import the target module and only finds the
|
195
|
+
# loader. If a loader is found, we need to return
|
196
|
+
# our own loader which will then in turn call the
|
197
|
+
# real loader to import the module and invoke the
|
198
|
+
# post import hooks.
|
199
|
+
|
200
|
+
loader = importlib.find_loader(fullname, path)
|
201
|
+
|
202
|
+
if loader:
|
203
|
+
return _ImportHookChainedLoader(loader)
|
204
|
+
|
205
|
+
else:
|
206
|
+
# For Python 2 we don't have much choice but to
|
207
|
+
# call back in to __import__(). This will
|
208
|
+
# actually cause the module to be imported. If no
|
209
|
+
# module could be found then ImportError will be
|
210
|
+
# raised. Otherwise we return a loader which
|
211
|
+
# returns the already loaded module and invokes
|
212
|
+
# the post import hooks.
|
213
|
+
|
214
|
+
__import__(fullname)
|
215
|
+
|
216
|
+
return _ImportHookLoader()
|
217
|
+
|
218
|
+
finally:
|
219
|
+
del self.in_progress[fullname]
|
220
|
+
|
221
|
+
# Decorator for marking that a function should be called as a post
|
222
|
+
# import hook when the target module is imported.
|
223
|
+
|
224
|
+
def when_imported(name):
|
225
|
+
def register(hook):
|
226
|
+
register_post_import_hook(hook, name)
|
227
|
+
return hook
|
228
|
+
return register
|
@@ -0,0 +1,901 @@
|
|
1
|
+
import os
|
2
|
+
import sys
|
3
|
+
import functools
|
4
|
+
import operator
|
5
|
+
import weakref
|
6
|
+
import inspect
|
7
|
+
|
8
|
+
PY2 = sys.version_info[0] == 2
|
9
|
+
PY3 = sys.version_info[0] == 3
|
10
|
+
|
11
|
+
if PY3:
|
12
|
+
string_types = str,
|
13
|
+
else:
|
14
|
+
string_types = basestring,
|
15
|
+
|
16
|
+
def with_metaclass(meta, *bases):
|
17
|
+
"""Create a base class with a metaclass."""
|
18
|
+
return meta("NewBase", bases, {})
|
19
|
+
|
20
|
+
class _ObjectProxyMethods(object):
|
21
|
+
|
22
|
+
# We use properties to override the values of __module__ and
|
23
|
+
# __doc__. If we add these in ObjectProxy, the derived class
|
24
|
+
# __dict__ will still be setup to have string variants of these
|
25
|
+
# attributes and the rules of descriptors means that they appear to
|
26
|
+
# take precedence over the properties in the base class. To avoid
|
27
|
+
# that, we copy the properties into the derived class type itself
|
28
|
+
# via a meta class. In that way the properties will always take
|
29
|
+
# precedence.
|
30
|
+
|
31
|
+
@property
|
32
|
+
def __module__(self):
|
33
|
+
return self.__wrapped__.__module__
|
34
|
+
|
35
|
+
@__module__.setter
|
36
|
+
def __module__(self, value):
|
37
|
+
self.__wrapped__.__module__ = value
|
38
|
+
|
39
|
+
@property
|
40
|
+
def __doc__(self):
|
41
|
+
return self.__wrapped__.__doc__
|
42
|
+
|
43
|
+
@__doc__.setter
|
44
|
+
def __doc__(self, value):
|
45
|
+
self.__wrapped__.__doc__ = value
|
46
|
+
|
47
|
+
# We similar use a property for __dict__. We need __dict__ to be
|
48
|
+
# explicit to ensure that vars() works as expected.
|
49
|
+
|
50
|
+
@property
|
51
|
+
def __dict__(self):
|
52
|
+
return self.__wrapped__.__dict__
|
53
|
+
|
54
|
+
# Need to also propagate the special __weakref__ attribute for case
|
55
|
+
# where decorating classes which will define this. If do not define
|
56
|
+
# it and use a function like inspect.getmembers() on a decorator
|
57
|
+
# class it will fail. This can't be in the derived classes.
|
58
|
+
|
59
|
+
@property
|
60
|
+
def __weakref__(self):
|
61
|
+
return self.__wrapped__.__weakref__
|
62
|
+
|
63
|
+
class _ObjectProxyMetaType(type):
|
64
|
+
def __new__(cls, name, bases, dictionary):
|
65
|
+
# Copy our special properties into the class so that they
|
66
|
+
# always take precedence over attributes of the same name added
|
67
|
+
# during construction of a derived class. This is to save
|
68
|
+
# duplicating the implementation for them in all derived classes.
|
69
|
+
|
70
|
+
dictionary.update(vars(_ObjectProxyMethods))
|
71
|
+
|
72
|
+
return type.__new__(cls, name, bases, dictionary)
|
73
|
+
|
74
|
+
class ObjectProxy(with_metaclass(_ObjectProxyMetaType)):
|
75
|
+
|
76
|
+
__slots__ = '__wrapped__'
|
77
|
+
|
78
|
+
def __init__(self, wrapped):
|
79
|
+
object.__setattr__(self, '__wrapped__', wrapped)
|
80
|
+
|
81
|
+
# Python 3.2+ has the __qualname__ attribute, but it does not
|
82
|
+
# allow it to be overridden using a property and it must instead
|
83
|
+
# be an actual string object instead.
|
84
|
+
|
85
|
+
try:
|
86
|
+
object.__setattr__(self, '__qualname__', wrapped.__qualname__)
|
87
|
+
except AttributeError:
|
88
|
+
pass
|
89
|
+
|
90
|
+
@property
|
91
|
+
def __name__(self):
|
92
|
+
return self.__wrapped__.__name__
|
93
|
+
|
94
|
+
@__name__.setter
|
95
|
+
def __name__(self, value):
|
96
|
+
self.__wrapped__.__name__ = value
|
97
|
+
|
98
|
+
@property
|
99
|
+
def __class__(self):
|
100
|
+
return self.__wrapped__.__class__
|
101
|
+
|
102
|
+
@__class__.setter
|
103
|
+
def __class__(self, value):
|
104
|
+
self.__wrapped__.__class__ = value
|
105
|
+
|
106
|
+
@property
|
107
|
+
def __annotations__(self):
|
108
|
+
return self.__wrapped__.__anotations__
|
109
|
+
|
110
|
+
@__annotations__.setter
|
111
|
+
def __annotations__(self, value):
|
112
|
+
self.__wrapped__.__annotations__ = value
|
113
|
+
|
114
|
+
def __dir__(self):
|
115
|
+
return dir(self.__wrapped__)
|
116
|
+
|
117
|
+
def __str__(self):
|
118
|
+
return str(self.__wrapped__)
|
119
|
+
|
120
|
+
if PY3:
|
121
|
+
def __bytes__(self):
|
122
|
+
return bytes(self.__wrapped__)
|
123
|
+
|
124
|
+
def __repr__(self):
|
125
|
+
return '<%s at 0x%x for %s at 0x%x>' % (
|
126
|
+
type(self).__name__, id(self),
|
127
|
+
type(self.__wrapped__).__name__,
|
128
|
+
id(self.__wrapped__))
|
129
|
+
|
130
|
+
def __reversed__(self):
|
131
|
+
return reversed(self.__wrapped__)
|
132
|
+
|
133
|
+
if PY3:
|
134
|
+
def __round__(self):
|
135
|
+
return round(self.__wrapped__)
|
136
|
+
|
137
|
+
def __lt__(self, other):
|
138
|
+
return self.__wrapped__ < other
|
139
|
+
|
140
|
+
def __le__(self, other):
|
141
|
+
return self.__wrapped__ <= other
|
142
|
+
|
143
|
+
def __eq__(self, other):
|
144
|
+
return self.__wrapped__ == other
|
145
|
+
|
146
|
+
def __ne__(self, other):
|
147
|
+
return self.__wrapped__ != other
|
148
|
+
|
149
|
+
def __gt__(self, other):
|
150
|
+
return self.__wrapped__ > other
|
151
|
+
|
152
|
+
def __ge__(self, other):
|
153
|
+
return self.__wrapped__ >= other
|
154
|
+
|
155
|
+
def __hash__(self):
|
156
|
+
return hash(self.__wrapped__)
|
157
|
+
|
158
|
+
def __nonzero__(self):
|
159
|
+
return bool(self.__wrapped__)
|
160
|
+
|
161
|
+
def __bool__(self):
|
162
|
+
return bool(self.__wrapped__)
|
163
|
+
|
164
|
+
def __setattr__(self, name, value):
|
165
|
+
if name.startswith('_self_'):
|
166
|
+
object.__setattr__(self, name, value)
|
167
|
+
|
168
|
+
elif name == '__wrapped__':
|
169
|
+
object.__setattr__(self, name, value)
|
170
|
+
try:
|
171
|
+
object.__delattr__(self, '__qualname__')
|
172
|
+
except AttributeError:
|
173
|
+
pass
|
174
|
+
try:
|
175
|
+
object.__setattr__(self, '__qualname__', value.__qualname__)
|
176
|
+
except AttributeError:
|
177
|
+
pass
|
178
|
+
|
179
|
+
elif name == '__qualname__':
|
180
|
+
setattr(self.__wrapped__, name, value)
|
181
|
+
object.__setattr__(self, name, value)
|
182
|
+
|
183
|
+
elif hasattr(type(self), name):
|
184
|
+
object.__setattr__(self, name, value)
|
185
|
+
|
186
|
+
else:
|
187
|
+
setattr(self.__wrapped__, name, value)
|
188
|
+
|
189
|
+
def __getattr__(self, name):
|
190
|
+
# If we are being to lookup '__wrapped__' then the
|
191
|
+
# '__init__()' method cannot have been called.
|
192
|
+
|
193
|
+
if name == '__wrapped__':
|
194
|
+
raise ValueError('wrapper has not been initialised')
|
195
|
+
|
196
|
+
return getattr(self.__wrapped__, name)
|
197
|
+
|
198
|
+
def __delattr__(self, name):
|
199
|
+
if name.startswith('_self_'):
|
200
|
+
object.__delattr__(self, name)
|
201
|
+
|
202
|
+
elif name == '__wrapped__':
|
203
|
+
raise TypeError('__wrapped__ must be an object')
|
204
|
+
|
205
|
+
elif name == '__qualname__':
|
206
|
+
object.__delattr__(self, name)
|
207
|
+
delattr(self.__wrapped__, name)
|
208
|
+
|
209
|
+
elif hasattr(type(self), name):
|
210
|
+
object.__delattr__(self, name)
|
211
|
+
|
212
|
+
else:
|
213
|
+
delattr(self.__wrapped__, name)
|
214
|
+
|
215
|
+
def __add__(self, other):
|
216
|
+
return self.__wrapped__ + other
|
217
|
+
|
218
|
+
def __sub__(self, other):
|
219
|
+
return self.__wrapped__ - other
|
220
|
+
|
221
|
+
def __mul__(self, other):
|
222
|
+
return self.__wrapped__ * other
|
223
|
+
|
224
|
+
def __div__(self, other):
|
225
|
+
return operator.div(self.__wrapped__, other)
|
226
|
+
|
227
|
+
def __truediv__(self, other):
|
228
|
+
return operator.truediv(self.__wrapped__, other)
|
229
|
+
|
230
|
+
def __floordiv__(self, other):
|
231
|
+
return self.__wrapped__ // other
|
232
|
+
|
233
|
+
def __mod__(self, other):
|
234
|
+
return self.__wrapped__ % other
|
235
|
+
|
236
|
+
def __divmod__(self, other):
|
237
|
+
return divmod(self.__wrapped__, other)
|
238
|
+
|
239
|
+
def __pow__(self, other, *args):
|
240
|
+
return pow(self.__wrapped__, other, *args)
|
241
|
+
|
242
|
+
def __lshift__(self, other):
|
243
|
+
return self.__wrapped__ << other
|
244
|
+
|
245
|
+
def __rshift__(self, other):
|
246
|
+
return self.__wrapped__ >> other
|
247
|
+
|
248
|
+
def __and__(self, other):
|
249
|
+
return self.__wrapped__ & other
|
250
|
+
|
251
|
+
def __xor__(self, other):
|
252
|
+
return self.__wrapped__ ^ other
|
253
|
+
|
254
|
+
def __or__(self, other):
|
255
|
+
return self.__wrapped__ | other
|
256
|
+
|
257
|
+
def __radd__(self, other):
|
258
|
+
return other + self.__wrapped__
|
259
|
+
|
260
|
+
def __rsub__(self, other):
|
261
|
+
return other - self.__wrapped__
|
262
|
+
|
263
|
+
def __rmul__(self, other):
|
264
|
+
return other * self.__wrapped__
|
265
|
+
|
266
|
+
def __rdiv__(self, other):
|
267
|
+
return operator.div(other, self.__wrapped__)
|
268
|
+
|
269
|
+
def __rtruediv__(self, other):
|
270
|
+
return operator.truediv(other, self.__wrapped__)
|
271
|
+
|
272
|
+
def __rfloordiv__(self, other):
|
273
|
+
return other // self.__wrapped__
|
274
|
+
|
275
|
+
def __rmod__(self, other):
|
276
|
+
return other % self.__wrapped__
|
277
|
+
|
278
|
+
def __rdivmod__(self, other):
|
279
|
+
return divmod(other, self.__wrapped__)
|
280
|
+
|
281
|
+
def __rpow__(self, other, *args):
|
282
|
+
return pow(other, self.__wrapped__, *args)
|
283
|
+
|
284
|
+
def __rlshift__(self, other):
|
285
|
+
return other << self.__wrapped__
|
286
|
+
|
287
|
+
def __rrshift__(self, other):
|
288
|
+
return other >> self.__wrapped__
|
289
|
+
|
290
|
+
def __rand__(self, other):
|
291
|
+
return other & self.__wrapped__
|
292
|
+
|
293
|
+
def __rxor__(self, other):
|
294
|
+
return other ^ self.__wrapped__
|
295
|
+
|
296
|
+
def __ror__(self, other):
|
297
|
+
return other | self.__wrapped__
|
298
|
+
|
299
|
+
def __iadd__(self, other):
|
300
|
+
self.__wrapped__ += other
|
301
|
+
return self
|
302
|
+
|
303
|
+
def __isub__(self, other):
|
304
|
+
self.__wrapped__ -= other
|
305
|
+
return self
|
306
|
+
|
307
|
+
def __imul__(self, other):
|
308
|
+
self.__wrapped__ *= other
|
309
|
+
return self
|
310
|
+
|
311
|
+
def __idiv__(self, other):
|
312
|
+
self.__wrapped__ = operator.idiv(self.__wrapped__, other)
|
313
|
+
return self
|
314
|
+
|
315
|
+
def __itruediv__(self, other):
|
316
|
+
self.__wrapped__ = operator.itruediv(self.__wrapped__, other)
|
317
|
+
return self
|
318
|
+
|
319
|
+
def __ifloordiv__(self, other):
|
320
|
+
self.__wrapped__ //= other
|
321
|
+
return self
|
322
|
+
|
323
|
+
def __imod__(self, other):
|
324
|
+
self.__wrapped__ %= other
|
325
|
+
return self
|
326
|
+
|
327
|
+
def __ipow__(self, other):
|
328
|
+
self.__wrapped__ **= other
|
329
|
+
return self
|
330
|
+
|
331
|
+
def __ilshift__(self, other):
|
332
|
+
self.__wrapped__ <<= other
|
333
|
+
return self
|
334
|
+
|
335
|
+
def __irshift__(self, other):
|
336
|
+
self.__wrapped__ >>= other
|
337
|
+
return self
|
338
|
+
|
339
|
+
def __iand__(self, other):
|
340
|
+
self.__wrapped__ &= other
|
341
|
+
return self
|
342
|
+
|
343
|
+
def __ixor__(self, other):
|
344
|
+
self.__wrapped__ ^= other
|
345
|
+
return self
|
346
|
+
|
347
|
+
def __ior__(self, other):
|
348
|
+
self.__wrapped__ |= other
|
349
|
+
return self
|
350
|
+
|
351
|
+
def __neg__(self):
|
352
|
+
return -self.__wrapped__
|
353
|
+
|
354
|
+
def __pos__(self):
|
355
|
+
return +self.__wrapped__
|
356
|
+
|
357
|
+
def __abs__(self):
|
358
|
+
return abs(self.__wrapped__)
|
359
|
+
|
360
|
+
def __invert__(self):
|
361
|
+
return ~self.__wrapped__
|
362
|
+
|
363
|
+
def __int__(self):
|
364
|
+
return int(self.__wrapped__)
|
365
|
+
|
366
|
+
def __long__(self):
|
367
|
+
return long(self.__wrapped__)
|
368
|
+
|
369
|
+
def __float__(self):
|
370
|
+
return float(self.__wrapped__)
|
371
|
+
|
372
|
+
def __oct__(self):
|
373
|
+
return oct(self.__wrapped__)
|
374
|
+
|
375
|
+
def __hex__(self):
|
376
|
+
return hex(self.__wrapped__)
|
377
|
+
|
378
|
+
def __index__(self):
|
379
|
+
return operator.index(self.__wrapped__)
|
380
|
+
|
381
|
+
def __len__(self):
|
382
|
+
return len(self.__wrapped__)
|
383
|
+
|
384
|
+
def __contains__(self, value):
|
385
|
+
return value in self.__wrapped__
|
386
|
+
|
387
|
+
def __getitem__(self, key):
|
388
|
+
return self.__wrapped__[key]
|
389
|
+
|
390
|
+
def __setitem__(self, key, value):
|
391
|
+
self.__wrapped__[key] = value
|
392
|
+
|
393
|
+
def __delitem__(self, key):
|
394
|
+
del self.__wrapped__[key]
|
395
|
+
|
396
|
+
def __getslice__(self, i, j):
|
397
|
+
return self.__wrapped__[i:j]
|
398
|
+
|
399
|
+
def __setslice__(self, i, j, value):
|
400
|
+
self.__wrapped__[i:j] = value
|
401
|
+
|
402
|
+
def __delslice__(self, i, j):
|
403
|
+
del self.__wrapped__[i:j]
|
404
|
+
|
405
|
+
def __enter__(self):
|
406
|
+
return self.__wrapped__.__enter__()
|
407
|
+
|
408
|
+
def __exit__(self, *args, **kwargs):
|
409
|
+
return self.__wrapped__.__exit__(*args, **kwargs)
|
410
|
+
|
411
|
+
def __iter__(self):
|
412
|
+
return iter(self.__wrapped__)
|
413
|
+
|
414
|
+
class CallableObjectProxy(ObjectProxy):
|
415
|
+
|
416
|
+
def __call__(self, *args, **kwargs):
|
417
|
+
return self.__wrapped__(*args, **kwargs)
|
418
|
+
|
419
|
+
class _FunctionWrapperBase(ObjectProxy):
|
420
|
+
|
421
|
+
__slots__ = ('_self_instance', '_self_wrapper', '_self_enabled',
|
422
|
+
'_self_binding', '_self_parent')
|
423
|
+
|
424
|
+
def __init__(self, wrapped, instance, wrapper, enabled=None,
|
425
|
+
binding='function', parent=None):
|
426
|
+
|
427
|
+
super(_FunctionWrapperBase, self).__init__(wrapped)
|
428
|
+
|
429
|
+
object.__setattr__(self, '_self_instance', instance)
|
430
|
+
object.__setattr__(self, '_self_wrapper', wrapper)
|
431
|
+
object.__setattr__(self, '_self_enabled', enabled)
|
432
|
+
object.__setattr__(self, '_self_binding', binding)
|
433
|
+
object.__setattr__(self, '_self_parent', parent)
|
434
|
+
|
435
|
+
def __get__(self, instance, owner):
|
436
|
+
# This method is actually doing double duty for both unbound and
|
437
|
+
# bound derived wrapper classes. It should possibly be broken up
|
438
|
+
# and the distinct functionality moved into the derived classes.
|
439
|
+
# Can't do that straight away due to some legacy code which is
|
440
|
+
# relying on it being here in this base class.
|
441
|
+
#
|
442
|
+
# The distinguishing attribute which determines whether we are
|
443
|
+
# being called in an unbound or bound wrapper is the parent
|
444
|
+
# attribute. If binding has never occurred, then the parent will
|
445
|
+
# be None.
|
446
|
+
#
|
447
|
+
# First therefore, is if we are called in an unbound wrapper. In
|
448
|
+
# this case we perform the binding.
|
449
|
+
#
|
450
|
+
# We have one special case to worry about here. This is where we
|
451
|
+
# are decorating a nested class. In this case the wrapped class
|
452
|
+
# would not have a __get__() method to call. In that case we
|
453
|
+
# simply return self.
|
454
|
+
#
|
455
|
+
# Note that we otherwise still do binding even if instance is
|
456
|
+
# None and accessing an unbound instance method from a class.
|
457
|
+
# This is because we need to be able to later detect that
|
458
|
+
# specific case as we will need to extract the instance from the
|
459
|
+
# first argument of those passed in.
|
460
|
+
|
461
|
+
if self._self_parent is None:
|
462
|
+
if not inspect.isclass(self.__wrapped__):
|
463
|
+
descriptor = self.__wrapped__.__get__(instance, owner)
|
464
|
+
|
465
|
+
return self.__bound_function_wrapper__(descriptor, instance,
|
466
|
+
self._self_wrapper, self._self_enabled,
|
467
|
+
self._self_binding, self)
|
468
|
+
|
469
|
+
return self
|
470
|
+
|
471
|
+
# Now we have the case of binding occurring a second time on what
|
472
|
+
# was already a bound function. In this case we would usually
|
473
|
+
# return ourselves again. This mirrors what Python does.
|
474
|
+
#
|
475
|
+
# The special case this time is where we were originally bound
|
476
|
+
# with an instance of None and we were likely an instance
|
477
|
+
# method. In that case we rebind against the original wrapped
|
478
|
+
# function from the parent again.
|
479
|
+
|
480
|
+
if self._self_instance is None and self._self_binding == 'function':
|
481
|
+
descriptor = self._self_parent.__wrapped__.__get__(
|
482
|
+
instance, owner)
|
483
|
+
|
484
|
+
return self._self_parent.__bound_function_wrapper__(
|
485
|
+
descriptor, instance, self._self_wrapper,
|
486
|
+
self._self_enabled, self._self_binding,
|
487
|
+
self._self_parent)
|
488
|
+
|
489
|
+
return self
|
490
|
+
|
491
|
+
def __call__(self, *args, **kwargs):
|
492
|
+
# If enabled has been specified, then evaluate it at this point
|
493
|
+
# and if the wrapper is not to be executed, then simply return
|
494
|
+
# the bound function rather than a bound wrapper for the bound
|
495
|
+
# function. When evaluating enabled, if it is callable we call
|
496
|
+
# it, otherwise we evaluate it as a boolean.
|
497
|
+
|
498
|
+
if self._self_enabled is not None:
|
499
|
+
if callable(self._self_enabled):
|
500
|
+
if not self._self_enabled():
|
501
|
+
return self.__wrapped__(*args, **kwargs)
|
502
|
+
elif not self._self_enabled:
|
503
|
+
return self.__wrapped__(*args, **kwargs)
|
504
|
+
|
505
|
+
# This can occur where initial function wrapper was applied to
|
506
|
+
# a function that was already bound to an instance. In that case
|
507
|
+
# we want to extract the instance from the function and use it.
|
508
|
+
|
509
|
+
if self._self_binding == 'function':
|
510
|
+
if self._self_instance is None:
|
511
|
+
instance = getattr(self.__wrapped__, '__self__', None)
|
512
|
+
if instance is not None:
|
513
|
+
return self._self_wrapper(self.__wrapped__, instance,
|
514
|
+
args, kwargs)
|
515
|
+
|
516
|
+
# This is generally invoked when the wrapped function is being
|
517
|
+
# called as a normal function and is not bound to a class as an
|
518
|
+
# instance method. This is also invoked in the case where the
|
519
|
+
# wrapped function was a method, but this wrapper was in turn
|
520
|
+
# wrapped using the staticmethod decorator.
|
521
|
+
|
522
|
+
return self._self_wrapper(self.__wrapped__, self._self_instance,
|
523
|
+
args, kwargs)
|
524
|
+
|
525
|
+
class BoundFunctionWrapper(_FunctionWrapperBase):
|
526
|
+
|
527
|
+
def __call__(self, *args, **kwargs):
|
528
|
+
# If enabled has been specified, then evaluate it at this point
|
529
|
+
# and if the wrapper is not to be executed, then simply return
|
530
|
+
# the bound function rather than a bound wrapper for the bound
|
531
|
+
# function. When evaluating enabled, if it is callable we call
|
532
|
+
# it, otherwise we evaluate it as a boolean.
|
533
|
+
|
534
|
+
if self._self_enabled is not None:
|
535
|
+
if callable(self._self_enabled):
|
536
|
+
if not self._self_enabled():
|
537
|
+
return self.__wrapped__(*args, **kwargs)
|
538
|
+
elif not self._self_enabled:
|
539
|
+
return self.__wrapped__(*args, **kwargs)
|
540
|
+
|
541
|
+
# We need to do things different depending on whether we are
|
542
|
+
# likely wrapping an instance method vs a static method or class
|
543
|
+
# method.
|
544
|
+
|
545
|
+
if self._self_binding == 'function':
|
546
|
+
if self._self_instance is None:
|
547
|
+
# This situation can occur where someone is calling the
|
548
|
+
# instancemethod via the class type and passing the instance
|
549
|
+
# as the first argument. We need to shift the args before
|
550
|
+
# making the call to the wrapper and effectively bind the
|
551
|
+
# instance to the wrapped function using a partial so the
|
552
|
+
# wrapper doesn't see anything as being different.
|
553
|
+
|
554
|
+
if not args:
|
555
|
+
raise TypeError('missing 1 required positional argument')
|
556
|
+
|
557
|
+
instance, args = args[0], args[1:]
|
558
|
+
wrapped = functools.partial(self.__wrapped__, instance)
|
559
|
+
return self._self_wrapper(wrapped, instance, args, kwargs)
|
560
|
+
|
561
|
+
return self._self_wrapper(self.__wrapped__, self._self_instance,
|
562
|
+
args, kwargs)
|
563
|
+
|
564
|
+
else:
|
565
|
+
# As in this case we would be dealing with a classmethod or
|
566
|
+
# staticmethod, then _self_instance will only tell us whether
|
567
|
+
# when calling the classmethod or staticmethod they did it via an
|
568
|
+
# instance of the class it is bound to and not the case where
|
569
|
+
# done by the class type itself. We thus ignore _self_instance
|
570
|
+
# and use the __self__ attribute of the bound function instead.
|
571
|
+
# For a classmethod, this means instance will be the class type
|
572
|
+
# and for a staticmethod it will be None. This is probably the
|
573
|
+
# more useful thing we can pass through even though we loose
|
574
|
+
# knowledge of whether they were called on the instance vs the
|
575
|
+
# class type, as it reflects what they have available in the
|
576
|
+
# decoratored function.
|
577
|
+
|
578
|
+
instance = getattr(self.__wrapped__, '__self__', None)
|
579
|
+
|
580
|
+
return self._self_wrapper(self.__wrapped__, instance, args,
|
581
|
+
kwargs)
|
582
|
+
|
583
|
+
class FunctionWrapper(_FunctionWrapperBase):
|
584
|
+
|
585
|
+
__bound_function_wrapper__ = BoundFunctionWrapper
|
586
|
+
|
587
|
+
def __init__(self, wrapped, wrapper, enabled=None):
|
588
|
+
# What it is we are wrapping here could be anything. We need to
|
589
|
+
# try and detect specific cases though. In particular, we need
|
590
|
+
# to detect when we are given something that is a method of a
|
591
|
+
# class. Further, we need to know when it is likely an instance
|
592
|
+
# method, as opposed to a class or static method. This can
|
593
|
+
# become problematic though as there isn't strictly a fool proof
|
594
|
+
# method of knowing.
|
595
|
+
#
|
596
|
+
# The situations we could encounter when wrapping a method are:
|
597
|
+
#
|
598
|
+
# 1. The wrapper is being applied as part of a decorator which
|
599
|
+
# is a part of the class definition. In this case what we are
|
600
|
+
# given is the raw unbound function, classmethod or staticmethod
|
601
|
+
# wrapper objects.
|
602
|
+
#
|
603
|
+
# The problem here is that we will not know we are being applied
|
604
|
+
# in the context of the class being set up. This becomes
|
605
|
+
# important later for the case of an instance method, because in
|
606
|
+
# that case we just see it as a raw function and can't
|
607
|
+
# distinguish it from wrapping a normal function outside of
|
608
|
+
# a class context.
|
609
|
+
#
|
610
|
+
# 2. The wrapper is being applied when performing monkey
|
611
|
+
# patching of the class type afterwards and the method to be
|
612
|
+
# wrapped was retrieved direct from the __dict__ of the class
|
613
|
+
# type. This is effectively the same as (1) above.
|
614
|
+
#
|
615
|
+
# 3. The wrapper is being applied when performing monkey
|
616
|
+
# patching of the class type afterwards and the method to be
|
617
|
+
# wrapped was retrieved from the class type. In this case
|
618
|
+
# binding will have been performed where the instance against
|
619
|
+
# which the method is bound will be None at that point.
|
620
|
+
#
|
621
|
+
# This case is a problem because we can no longer tell if the
|
622
|
+
# method was a static method, plus if using Python3, we cannot
|
623
|
+
# tell if it was an instance method as the concept of an
|
624
|
+
# unnbound method no longer exists.
|
625
|
+
#
|
626
|
+
# 4. The wrapper is being applied when performing monkey
|
627
|
+
# patching of an instance of a class. In this case binding will
|
628
|
+
# have been perfomed where the instance was not None.
|
629
|
+
#
|
630
|
+
# This case is a problem because we can no longer tell if the
|
631
|
+
# method was a static method.
|
632
|
+
#
|
633
|
+
# Overall, the best we can do is look at the original type of the
|
634
|
+
# object which was wrapped prior to any binding being done and
|
635
|
+
# see if it is an instance of classmethod or staticmethod. In
|
636
|
+
# the case where other decorators are between us and them, if
|
637
|
+
# they do not propagate the __class__ attribute so that the
|
638
|
+
# isinstance() checks works, then likely this will do the wrong
|
639
|
+
# thing where classmethod and staticmethod are used.
|
640
|
+
#
|
641
|
+
# Since it is likely to be very rare that anyone even puts
|
642
|
+
# decorators around classmethod and staticmethod, likelihood of
|
643
|
+
# that being an issue is very small, so we accept it and suggest
|
644
|
+
# that those other decorators be fixed. It is also only an issue
|
645
|
+
# if a decorator wants to actually do things with the arguments.
|
646
|
+
#
|
647
|
+
# As to not being able to identify static methods properly, we
|
648
|
+
# just hope that that isn't something people are going to want
|
649
|
+
# to wrap, or if they do suggest they do it the correct way by
|
650
|
+
# ensuring that it is decorated in the class definition itself,
|
651
|
+
# or patch it in the __dict__ of the class type.
|
652
|
+
#
|
653
|
+
# So to get the best outcome we can, whenever we aren't sure what
|
654
|
+
# it is, we label it as a 'function'. If it was already bound and
|
655
|
+
# that is rebound later, we assume that it will be an instance
|
656
|
+
# method and try an cope with the possibility that the 'self'
|
657
|
+
# argument it being passed as an explicit argument and shuffle
|
658
|
+
# the arguments around to extract 'self' for use as the instance.
|
659
|
+
|
660
|
+
if isinstance(wrapped, classmethod):
|
661
|
+
binding = 'classmethod'
|
662
|
+
|
663
|
+
elif isinstance(wrapped, staticmethod):
|
664
|
+
binding = 'staticmethod'
|
665
|
+
|
666
|
+
elif hasattr(wrapped, '__self__'):
|
667
|
+
if inspect.isclass(wrapped.__self__):
|
668
|
+
binding = 'classmethod'
|
669
|
+
else:
|
670
|
+
binding = 'function'
|
671
|
+
|
672
|
+
else:
|
673
|
+
binding = 'function'
|
674
|
+
|
675
|
+
super(FunctionWrapper, self).__init__(wrapped, None, wrapper,
|
676
|
+
enabled, binding)
|
677
|
+
|
678
|
+
try:
|
679
|
+
if not os.environ.get('WRAPT_DISABLE_EXTENSIONS'):
|
680
|
+
from ._wrappers import (ObjectProxy, CallableObjectProxy,
|
681
|
+
FunctionWrapper, BoundFunctionWrapper, _FunctionWrapperBase)
|
682
|
+
except ImportError:
|
683
|
+
pass
|
684
|
+
|
685
|
+
# Helper functions for applying wrappers to existing functions.
|
686
|
+
|
687
|
+
def resolve_path(module, name):
|
688
|
+
if isinstance(module, string_types):
|
689
|
+
__import__(module)
|
690
|
+
module = sys.modules[module]
|
691
|
+
|
692
|
+
parent = module
|
693
|
+
|
694
|
+
path = name.split('.')
|
695
|
+
attribute = path[0]
|
696
|
+
|
697
|
+
original = getattr(parent, attribute)
|
698
|
+
for attribute in path[1:]:
|
699
|
+
parent = original
|
700
|
+
|
701
|
+
# We can't just always use getattr() because in doing
|
702
|
+
# that on a class it will cause binding to occur which
|
703
|
+
# will complicate things later and cause some things not
|
704
|
+
# to work. For the case of a class we therefore access
|
705
|
+
# the __dict__ directly. To cope though with the wrong
|
706
|
+
# class being given to us, or a method being moved into
|
707
|
+
# a base class, we need to walk the class hierarchy to
|
708
|
+
# work out exactly which __dict__ the method was defined
|
709
|
+
# in, as accessing it from __dict__ will fail if it was
|
710
|
+
# not actually on the class given. Fallback to using
|
711
|
+
# getattr() if we can't find it. If it truly doesn't
|
712
|
+
# exist, then that will fail.
|
713
|
+
|
714
|
+
if inspect.isclass(original):
|
715
|
+
for cls in inspect.getmro(original):
|
716
|
+
if attribute in vars(cls):
|
717
|
+
original = vars(cls)[attribute]
|
718
|
+
break
|
719
|
+
else:
|
720
|
+
original = getattr(original, attribute)
|
721
|
+
|
722
|
+
else:
|
723
|
+
original = getattr(original, attribute)
|
724
|
+
|
725
|
+
return (parent, attribute, original)
|
726
|
+
|
727
|
+
def apply_patch(parent, attribute, replacement):
|
728
|
+
setattr(parent, attribute, replacement)
|
729
|
+
|
730
|
+
def wrap_object(module, name, factory, args=(), kwargs={}):
|
731
|
+
(parent, attribute, original) = resolve_path(module, name)
|
732
|
+
wrapper = factory(original, *args, **kwargs)
|
733
|
+
apply_patch(parent, attribute, wrapper)
|
734
|
+
return wrapper
|
735
|
+
|
736
|
+
# Function for applying a proxy object to an attribute of a class
|
737
|
+
# instance. The wrapper works by defining an attribute of the same name
|
738
|
+
# on the class which is a descriptor and which intercepts access to the
|
739
|
+
# instance attribute. Note that this cannot be used on attributes which
|
740
|
+
# are themselves defined by a property object.
|
741
|
+
|
742
|
+
class AttributeWrapper(object):
|
743
|
+
|
744
|
+
def __init__(self, attribute, factory, args, kwargs):
|
745
|
+
self.attribute = attribute
|
746
|
+
self.factory = factory
|
747
|
+
self.args = args
|
748
|
+
self.kwargs = kwargs
|
749
|
+
|
750
|
+
def __get__(self, instance, owner):
|
751
|
+
value = instance.__dict__[self.attribute]
|
752
|
+
return self.factory(value, *self.args, **self.kwargs)
|
753
|
+
|
754
|
+
def __set__(self, instance, value):
|
755
|
+
instance.__dict__[self.attribute] = value
|
756
|
+
|
757
|
+
def __delete__(self, instance):
|
758
|
+
del instance.__dict__[self.attribute]
|
759
|
+
|
760
|
+
def wrap_object_attribute(module, name, factory, args=(), kwargs={}):
|
761
|
+
path, attribute = name.rsplit('.', 1)
|
762
|
+
parent = resolve_path(module, path)[2]
|
763
|
+
wrapper = AttributeWrapper(attribute, factory, args, kwargs)
|
764
|
+
apply_patch(parent, attribute, wrapper)
|
765
|
+
return wrapper
|
766
|
+
|
767
|
+
# Functions for creating a simple decorator using a FunctionWrapper,
|
768
|
+
# plus short cut functions for applying wrappers to functions. These are
|
769
|
+
# for use when doing monkey patching. For a more featured way of
|
770
|
+
# creating decorators see the decorator decorator instead.
|
771
|
+
|
772
|
+
def function_wrapper(wrapper):
|
773
|
+
def _wrapper(wrapped, instance, args, kwargs):
|
774
|
+
target_wrapped = args[0]
|
775
|
+
if instance is None:
|
776
|
+
target_wrapper = wrapper
|
777
|
+
elif inspect.isclass(instance):
|
778
|
+
target_wrapper = wrapper.__get__(None, instance)
|
779
|
+
else:
|
780
|
+
target_wrapper = wrapper.__get__(instance, type(instance))
|
781
|
+
return FunctionWrapper(target_wrapped, target_wrapper)
|
782
|
+
return FunctionWrapper(wrapper, _wrapper)
|
783
|
+
|
784
|
+
def wrap_function_wrapper(module, name, wrapper):
|
785
|
+
return wrap_object(module, name, FunctionWrapper, (wrapper,))
|
786
|
+
|
787
|
+
def patch_function_wrapper(module, name):
|
788
|
+
def _wrapper(wrapper):
|
789
|
+
return wrap_object(module, name, FunctionWrapper, (wrapper,))
|
790
|
+
return _wrapper
|
791
|
+
|
792
|
+
def transient_function_wrapper(module, name):
|
793
|
+
def _decorator(wrapper):
|
794
|
+
def _wrapper(wrapped, instance, args, kwargs):
|
795
|
+
target_wrapped = args[0]
|
796
|
+
if instance is None:
|
797
|
+
target_wrapper = wrapper
|
798
|
+
elif inspect.isclass(instance):
|
799
|
+
target_wrapper = wrapper.__get__(None, instance)
|
800
|
+
else:
|
801
|
+
target_wrapper = wrapper.__get__(instance, type(instance))
|
802
|
+
def _execute(wrapped, instance, args, kwargs):
|
803
|
+
(parent, attribute, original) = resolve_path(module, name)
|
804
|
+
replacement = FunctionWrapper(original, target_wrapper)
|
805
|
+
setattr(parent, attribute, replacement)
|
806
|
+
try:
|
807
|
+
return wrapped(*args, **kwargs)
|
808
|
+
finally:
|
809
|
+
setattr(parent, attribute, original)
|
810
|
+
return FunctionWrapper(target_wrapped, _execute)
|
811
|
+
return FunctionWrapper(wrapper, _wrapper)
|
812
|
+
return _decorator
|
813
|
+
|
814
|
+
# A weak function proxy. This will work on instance methods, class
|
815
|
+
# methods, static methods and regular functions. Special treatment is
|
816
|
+
# needed for the method types because the bound method is effectively a
|
817
|
+
# transient object and applying a weak reference to one will immediately
|
818
|
+
# result in it being destroyed and the weakref callback called. The weak
|
819
|
+
# reference is therefore applied to the instance the method is bound to
|
820
|
+
# and the original function. The function is then rebound at the point
|
821
|
+
# of a call via the weak function proxy.
|
822
|
+
|
823
|
+
def _weak_function_proxy_callback(ref, proxy, callback):
|
824
|
+
if proxy._self_expired:
|
825
|
+
return
|
826
|
+
|
827
|
+
proxy._self_expired = True
|
828
|
+
|
829
|
+
# This could raise an exception. We let it propagate back and let
|
830
|
+
# the weakref.proxy() deal with it, at which point it generally
|
831
|
+
# prints out a short error message direct to stderr and keeps going.
|
832
|
+
|
833
|
+
if callback is not None:
|
834
|
+
callback(proxy)
|
835
|
+
|
836
|
+
class WeakFunctionProxy(ObjectProxy):
|
837
|
+
|
838
|
+
__slots__ = ('_self_expired', '_self_instance')
|
839
|
+
|
840
|
+
def __init__(self, wrapped, callback=None):
|
841
|
+
# We need to determine if the wrapped function is actually a
|
842
|
+
# bound method. In the case of a bound method, we need to keep a
|
843
|
+
# reference to the original unbound function and the instance.
|
844
|
+
# This is necessary because if we hold a reference to the bound
|
845
|
+
# function, it will be the only reference and given it is a
|
846
|
+
# temporary object, it will almost immediately expire and
|
847
|
+
# the weakref callback triggered. So what is done is that we
|
848
|
+
# hold a reference to the instance and unbound function and
|
849
|
+
# when called bind the function to the instance once again and
|
850
|
+
# then call it. Note that we avoid using a nested function for
|
851
|
+
# the callback here so as not to cause any odd reference cycles.
|
852
|
+
|
853
|
+
_callback = callback and functools.partial(
|
854
|
+
_weak_function_proxy_callback, proxy=self,
|
855
|
+
callback=callback)
|
856
|
+
|
857
|
+
self._self_expired = False
|
858
|
+
|
859
|
+
if isinstance(wrapped, _FunctionWrapperBase):
|
860
|
+
self._self_instance = weakref.ref(wrapped._self_instance,
|
861
|
+
_callback)
|
862
|
+
|
863
|
+
if wrapped._self_parent is not None:
|
864
|
+
super(WeakFunctionProxy, self).__init__(
|
865
|
+
weakref.proxy(wrapped._self_parent, _callback))
|
866
|
+
|
867
|
+
else:
|
868
|
+
super(WeakFunctionProxy, self).__init__(
|
869
|
+
weakref.proxy(wrapped, _callback))
|
870
|
+
|
871
|
+
return
|
872
|
+
|
873
|
+
try:
|
874
|
+
self._self_instance = weakref.ref(wrapped.__self__, _callback)
|
875
|
+
|
876
|
+
super(WeakFunctionProxy, self).__init__(
|
877
|
+
weakref.proxy(wrapped.__func__, _callback))
|
878
|
+
|
879
|
+
except AttributeError:
|
880
|
+
self._self_instance = None
|
881
|
+
|
882
|
+
super(WeakFunctionProxy, self).__init__(
|
883
|
+
weakref.proxy(wrapped, _callback))
|
884
|
+
|
885
|
+
def __call__(self, *args, **kwargs):
|
886
|
+
# We perform a boolean check here on the instance and wrapped
|
887
|
+
# function as that will trigger the reference error prior to
|
888
|
+
# calling if the reference had expired.
|
889
|
+
|
890
|
+
instance = self._self_instance and self._self_instance()
|
891
|
+
function = self.__wrapped__ and self.__wrapped__
|
892
|
+
|
893
|
+
# If the wrapped function was originally a bound function, for
|
894
|
+
# which we retained a reference to the instance and the unbound
|
895
|
+
# function we need to rebind the function and then call it. If
|
896
|
+
# not just called the wrapped function.
|
897
|
+
|
898
|
+
if instance is None:
|
899
|
+
return self.__wrapped__(*args, **kwargs)
|
900
|
+
|
901
|
+
return function.__get__(instance, type(instance))(*args, **kwargs)
|