Unblocking the openstack-tox-docs job.

Fixing indentation error breaking openstack-tox-docs

Adjusts openstack-tox-docs job to be triggered by
the validations_common directory changes.

Introducing upper-requirements constraint to the
doc build dependencies.

Adjusts ansible_autodoc to handle missing molecule confs.

Signed-off-by: Jiri Podivin <jpodivin@redhat.com>
Change-Id: I8021f786476b61bbf88bf21a1151ce3198f7abbd

.zuul.yaml

@@ -69,6 +69,7 @@
             files:
               - ^doc/.*
               - ^README.rst
+              - ^validations_common/.*
     gate:
       jobs:
         - openstack-tox-linters

doc/source/_exts/ansible-autodoc.py

@@ -265,7 +265,7 @@ class AnsibleAutoPluginDirective(Directive):
                 )
                 with open(molecule_file) as f:
                     molecule_conf = DOCYAML.load(f.read())
-
+                if molecule_conf:
                     driver_data = molecule_conf.get('driver')
                     if driver_data:
                         molecule_section.append(

tox.ini

@@ -127,6 +127,7 @@ commands =
 
 [testenv:docs]
 deps =
+  -c {env:TOX_CONSTRAINTS_FILE:https://opendev.org/openstack/requirements/raw/branch/master/upper-constraints.txt}
   -r {toxinidir}/doc/requirements.txt
   -r {toxinidir}/molecule-requirements.txt
 commands=

validations_common/tests/callback_plugins/test_validation_json.py

@@ -44,7 +44,8 @@ def is_iso_time(time_string):
     with the default delimiter.
     Regex is somewhat convoluted, but general enough to last
     at least until the 9999 AD.
-    Returns:
+
+    :returns:
         True if string matches the pattern.
         False otherwise.
     """