From 15854bdfdfc637c9e15ab923b3f3925110226d26 Mon Sep 17 00:00:00 2001 From: Danny Hermes Date: Tue, 28 Oct 2014 15:36:14 -0700 Subject: [PATCH 1/3] Removing skip travis from commit msg so wheelhouse rebuilds occur. Also removing an out-of-date comment. --- scripts/update_wheels_project.sh | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/scripts/update_wheels_project.sh b/scripts/update_wheels_project.sh index 44eaa151c6aa..78f3c00b516c 100755 --- a/scripts/update_wheels_project.sh +++ b/scripts/update_wheels_project.sh @@ -47,7 +47,6 @@ cd ${FRESH_REPO_DIR} git add LATEST_COMMIT git status -# H/T: http://stackoverflow.com/a/13730477/1068170 -git commit -m "Latest wheels build by travis-ci. [ci skip]" +git commit -m "Main project gcloud-python has been updated." git status git push origin master From 5d9b46acbab54b032b55825ee992819b06e2246b Mon Sep 17 00:00:00 2001 From: Danny Hermes Date: Tue, 28 Oct 2014 16:15:48 -0700 Subject: [PATCH 2/3] Updating CONTRIBUTING to describe build optimizations. --- CONTRIBUTING.rst | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 1ad10bebc3d2..f2743eccdde3 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -240,6 +240,32 @@ can build the docs via:: $ tox -e docs +Travis Configuration and Build Optimizations +-------------------------------------------- + +All build scripts in the ``.travis.yml`` configuration file which have +Python dependencies are specified in the ``tox.ini`` configuration. +They are executed in the Travis build via ``tox -e {ENV}`` where +``{ENV}`` is the environment being tested. + +By enumerating all Python dependencies in the ``tox`` configuration, +we can use our custom ``gcloud-python-wheels`` +`wheelhouse `__ +to speed up builds. This project builds and stores pre-built Python +`wheels `__ for every Python dependency our library +and tests have. + +If new ``tox`` environments are added to be run in a Travis build, they +should either be: + +- listed in ``[tox].envlist`` as a default environment + +- added to the list in the + `Travis environment variable `__ + ``EXTRA_TOX_ENVS``. The current value is:: + + EXTRA_TOX_ENVS="coveralls regression" + Contributor License Agreements ------------------------------ From 544c22c0e4d76ef6b74319be31d62984ea75b6eb Mon Sep 17 00:00:00 2001 From: Danny Hermes Date: Wed, 29 Oct 2014 14:25:20 -0700 Subject: [PATCH 3/3] Removing current value of EXTRA_TOX_ENVs from CONTRIBUTING. Also changed the Travis settings in gcloud-python-wheels to make this value visible so people can continue to maintain it. --- CONTRIBUTING.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index f2743eccdde3..7ac9ad7700b7 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -262,9 +262,8 @@ should either be: - added to the list in the `Travis environment variable `__ - ``EXTRA_TOX_ENVS``. The current value is:: - - EXTRA_TOX_ENVS="coveralls regression" + ``EXTRA_TOX_ENVS``. This value is unencrypted in ``gcloud-python-wheels`` + to make ongoing maintenance easier. Contributor License Agreements ------------------------------