Add initial common .vpython environment.
This environment specification file is used on bots to include pinned
external python packages.
[email protected], [email protected]
Bug: 741001
Change-Id: Ibc8a1ac4081d37171825dd1ecf07f0c8e591370c
Reviewed-on: https://chromium-review.googlesource.com/639357
Reviewed-by: Brett Wilson <[email protected]>
Reviewed-by: Dirk Pranke <[email protected]>
Reviewed-by: Daniel Jacques <[email protected]>
Commit-Queue: Robbie Iannucci <[email protected]>
Cr-Commit-Position: refs/heads/master@{#498907}diff --git a/.vpython b/.vpython
new file mode 100644
index 0000000..cf74427
--- /dev/null
+++ b/.vpython
@@ -0,0 +1,32 @@
+# This is a vpython "spec" file.
+#
+# It describes patterns for python wheel dependencies of the python scripts in
+# the chromium repo, particularly for dependencies that have compiled components
+# (since pure-python dependencies can be easily vendored into third_party).
+#
+# When vpython is invoked, it finds this file and builds a python VirtualEnv,
+# containing all of the dependencies described in this file, fetching them from
+# CIPD (the "Chrome Infrastructure Package Deployer" service). Unlike `pip`,
+# this never requires the end-user machine to have a working python extension
+# compilation environment. All of these packages are built using:
+# https://chromium.googlesource.com/infra/infra/+/master/infra/tools/dockerbuild/
+#
+# All python scripts in the repo share this same spec, to avoid dependency
+# fragmentation.
+#
+# If you have depot_tools installed in your $PATH, you can invoke python scripts
+# in this repo by running them as you normally would run them, except
+# substituting `vpython` instead of `python` on the command line, e.g.:
+# vpython path/to/script.py some --arguments
+#
+# Read more about `vpython` and how to modify this file here:
+# https://chromium.googlesource.com/infra/infra/+/master/doc/users/vpython.md
+
+python_version: "2.7"
+
+# Used by:
+# third_party/catapult
+wheel: <
+ name: "infra/python/wheels/psutil/${platform}_${py_python}_${py_abi}"
+ version: "version:5.2.2"
+>
