Merge "Revert "Add sphinx_python variable to sphinx role and job""

roles/ensure-sphinx/README.rst

@@ -16,11 +16,6 @@ All pip installs are done with a provided constraints file, if given.
 
    List of python packages to install for building docs.
 
-.. zuul:rolevar:: sphinx_python
-   :default: python2
-
-   Version of python to use, either ``python2`` or ``python3``.
-
 .. zuul:rolevar:: zuul_work_virtualenv
    :default: ~/.venv
 

roles/ensure-sphinx/defaults/main.yaml

@@ -1,5 +1,4 @@
 zuul_work_dir: "{{ zuul.project.src_dir }}"
 zuul_work_virtualenv: "{{ ansible_user_dir }}/.venv"
-sphinx_python: python2
 doc_building_packages:
   - sphinx

roles/ensure-sphinx/tasks/main.yaml

@@ -9,27 +9,36 @@
   include_role:
     name: find-constraints
 
-# Note (dmsimard): This installs doc/requirements.txt or test-requirements.txt
+- name: Install virtualenv and doc requirements files if found
-# if the former is not found. If neither are found, this task is skipped.
+  shell:
-# TODO(dmsimard) Don't assume virtualenv is installed
+    executable: /bin/bash
-- name: Initialize virtual environment
-  pip:
-    requirements: "{{ item }}"
     chdir: "{{ zuul_work_dir }}"
-    virtualenv: "{{ zuul_work_virtualenv }}"
+    # NOTE(mordred) There is a bug in ansible-lint that mistakenly detects
-    virtualenv_python: "{{ sphinx_python }}"
+    # setting the VENV variable below as an error if it occurs on the fist
-    extra_args: "{{ upper_constraints | default(omit) }}"
+    # line. Work around that by putting a comment as the first line until we
-  with_first_found:
+    # can get a fix upstream.
-    - files:
+    cmd: |
-        - "{{ zuul_work_dir }}/doc/requirements.txt"
+      # Create virtualenv is it does not already exist
-        - "{{ zuul_work_dir }}/test-requirements.txt"
+      VENV={{ zuul_work_virtualenv }}
-      skip: true
+      if [ ! -d $VENV ] ; then
+          virtualenv $VENV
+      fi
+      source $VENV/bin/activate
+      # skipping requirements.txt as it gets picked up by installing the
+      # python package itself
+      for f in doc/requirements.txt test-requirements.txt ; do
+          if [ -f $f ] ; then
+              pip install $CONSTRAINTS -r $f
+              break
+          fi
+      done
+  environment:
+    CONSTRAINTS: "{{ upper_constraints|default('') }}"
 
 - name: Install doc building packages
   pip:
     name: "{{ item }}"
     chdir: "{{ zuul_work_dir }}"
     virtualenv: "{{ zuul_work_virtualenv }}"
-    virtualenv_python: "{{ sphinx_python }}"
+    extra_args: "{{ upper_constraints|default(omit) }}"
-    extra_args: "{{ upper_constraints | default(omit) }}"
   with_items: "{{ doc_building_packages }}"

roles/install-if-python/tasks/main.yaml

@@ -28,7 +28,7 @@
 - name: Install requirements if they exist
   pip:
     chdir: "{{ zuul_work_dir }}"
-    virtualenv: "{{ zuul_work_virtualenv }}"
+    virtualenv: "{{ ansible_user_dir }}/.venv"
     requirements: requirements.txt
     extra_args: "{{ upper_constraints|default(omit) }}"
   register: requirements_install
@@ -45,7 +45,7 @@
 # the ChangeLog to have been generated.
 - name: Make sdist to generate ChangeLog
   command:
-    cmd: "{{ zuul_work_virtualenv }}/bin/python setup.py sdist"
+    cmd: "{{ ansible_user_dir }}/.venv/bin/python setup.py sdist"
     chdir: "{{ zuul_work_dir }}"
   when:
     - install_package
@@ -61,7 +61,7 @@
 - name: Install the project if it is a Python project
   pip:
     chdir: "{{ zuul_work_dir }}"
-    virtualenv: "{{ zuul_work_virtualenv }}"
+    virtualenv: "{{ ansible_user_dir }}/.venv"
     name: .
     extra_args: --no-deps
   when:

roles/sphinx/tasks/main.yaml

@@ -10,14 +10,11 @@
     sphinx_warning_is_error: "{{ check_result.warning_is_error }}"
 
 - name: Run sphinx
-  shell:
+  command:
-    executable: /bin/bash
+    cmd: >
-    cmd: |
+      {{ zuul_work_virtualenv }}/bin/sphinx-build
-      # Source the activate file so that sphinx subcommands have the correct
+        -b {{ item }}
-      # paths set.
+        {% if sphinx_warning_is_error %} -W {% endif %}
-      source {{ zuul_work_virtualenv }}/bin/activate
-      sphinx-build -b {{ item }} \
-        {% if sphinx_warning_is_error %} -W {% endif %} \
         {{ sphinx_source_dir }} {{ sphinx_build_dir }}/{{ item }}
     chdir: "{{ zuul_work_dir }}"
   with_items: "{{ sphinx_builders }}"

zuul.yaml

@@ -174,11 +174,6 @@
          Optional path to a pip constraints file for installing python
          libraries.
 
-      .. zuul:jobvar:: sphinx_python
-          :default: python2
-
-         Version of python to use, either ``python2`` or ``python3``.
-
       .. zuul:jobvar:: zuul_work_dir
          :default: {{ zuul.project.src_dir }}