make doctest failed

[JunJie Nan]

cd doc; make doctest
sphinx-build -b doctest -d build/doctrees source build/doctest
Running Sphinx v1.1.3
Generating source documentation for heat
...
Excluded module heat.openstack.common.db.sqlalchemy.
loading pickled environment... done
Using openstack theme from /usr/local/lib/python2.7/dist-packages/oslo/sphinx/theme
building [doctest]: targets for 84 source files that are out of date
updating environment: 0 added, 1 changed, 0 removed
reading sources... [100%] sourcecode/autoindex

looking for now-outdated files... none found
pickling environment... done
checking consistency... done
running tests...

Document: sourcecode/heat/heat.engine.parser
--------------------------------------------
**********************************************************************
File "sourcecode/heat/heat.engine.parser.rst", line 13, in default
Failed example:
    template = Template(template_format.parse(template_str))
Exception raised:
    Traceback (most recent call last):
      File "/usr/lib/python2.7/doctest.py", line 1289, in __run
        compileflags, 1) in test.globs
      File "<doctest default[2]>", line 1, in <module>
        template = Template(template_format.parse(template_str))
    NameError: name 'Template' is not defined
**********************************************************************
File "sourcecode/heat/heat.engine.parser.rst", line 14, in default
Failed example:
    parameters = Parameters('stack', template, {'KeyName': 'my_key'})
Exception raised:
    Traceback (most recent call last):
      File "/usr/lib/python2.7/doctest.py", line 1289, in __run
        compileflags, 1) in test.globs
      File "<doctest default[3]>", line 1, in <module>
        parameters = Parameters('stack', template, {'KeyName': 'my_key'})
    NameError: name 'Parameters' is not defined
**********************************************************************
File "sourcecode/heat/heat.engine.parser.rst", line 15, in default
Failed example:
    resolve_static_data(template, None, parameters, {'Ref': 'KeyName'})
Exception raised:
    Traceback (most recent call last):
      File "/usr/lib/python2.7/doctest.py", line 1289, in __run
        compileflags, 1) in test.globs
      File "<doctest default[4]>", line 1, in <module>
        resolve_static_data(template, None, parameters, {'Ref': 'KeyName'})
    NameError: name 'resolve_static_data' is not defined
**********************************************************************
1 items had failures:
   3 of 5 in default
5 tests in 1 items.
2 passed and 3 failed.
***Test Failed*** 3 failures.

Doctest summary
===============
    5 tests
    3 failures in tests
    0 failures in setup code
    0 failures in cleanup code
build finished with problems.

[Clint Byrum (clint-fewbar)]

I don't see any doctests in Heat's documentation, so can you explain why you think this might be relevant?

[Liang Chen (cbjchen)]

Just found some in parser.resolve_static_data.

I think Junjie hit this issue while working on https://review.openstack.org/#/c/57082/ .

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/57101

[Liang Chen (cbjchen)]

The issue has gone with the removal of the original resolve_static_data function.