[Sqlalchemy-tickets] Issue #3400: Exception occurred during documentation build (`make dist-html`) (zzzeek/sqlalchemy)

[Sam Z. <iss...@bi...>]

New issue 3400: Exception occurred during documentation build (`make dist-html`)
https://bitbucket.org/zzzeek/sqlalchemy/issue/3400/exception-occurred-during-documentation

Sam Zhang:

Traceback:


```
#!error

reading sources... [ 61%] orm/events
reading sources... [ 62%] orm/examples
The name of the builder is: htmlThe name of the builder is: html
Exception occurred:
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/zzzeeksphinx/viewsource.py", line 61, in _view_source_node
    tok, [pathname] if pathname else None)
ImportError: No module named
The full traceback has been saved in /tmp/sphinx-err-qz9ZgL.log

 /t/sphinx-err-qz9ZgL.log                                                                                                                                                                                 
# Sphinx version: 1.3.1
# Python version: 2.7.6 (CPython)
# Docutils version: 0.12 release
# Jinja2 version: 2.7.3
# Last messages:
#   reading sources... [ 57%] orm/classical
#   reading sources... [ 57%] orm/collections
#   reading sources... [ 58%] orm/composites
#   reading sources... [ 59%] orm/constructors
#   reading sources... [ 60%] orm/contextual
#   reading sources... [ 61%] orm/deprecated
#   reading sources... [ 61%] orm/events
#   reading sources... [ 62%] orm/examples
#   The name of the builder is: html
#   The name of the builder is: html
# Loaded extensions:
#   sphinx.ext.autodoc (1.3.1) from /mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/ext/autodoc.pyc
#   sphinx.ext.intersphinx (1.3.1) from /mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/ext/intersphinx.pyc
#   changelog (unknown version) from /mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/changelog/__init__.pyc
#   alabaster (0.7.3) from /mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/alabaster/__init__.pyc
#   sphinx_paramlinks (unknown version) from /mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx_paramlinks/__init__.pyc
#   zzzeeksphinx (unknown version) from /mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/zzzeeksphinx/__init__.pyc
Traceback (most recent call last):
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/cmdline.py", line 245, in main
    app.build(opts.force_all, filenames)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/application.py", line 264, in build
    self.builder.build_update()
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 245, in build_update
    'out of date' % len(to_build))
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 259, in build
    self.doctreedir, self.app))
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/environment.py", line 618, in update
    self._read_serial(docnames, app)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/environment.py", line 638, in _read_serial
    self.read_doc(docname, app)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/environment.py", line 791, in read_doc
    pub.publish()
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/core.py", line 217, in publish
    self.settings)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/environment.py", line 126, in read
    self.parse()
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/readers/__init__.py", line 78, in parse
    self.parser.parse(self.input, document)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/__init__.py", line 172, in parse
    self.statemachine.run(inputlines, document, inliner=self.inliner)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 170, in run
    input_source=document['source'])
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2961, in text
    self.section(title.lstrip(), source, style, lineno + 1, messages)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 327, in section
    self.new_subsection(title, lineno, messages)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 395, in new_subsection
    node=section_node, match_titles=True)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 282, in nested_parse
    node=node, match_titles=match_titles)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 195, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2726, in underline
    self.section(title, source, style, lineno - 1, messages)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 327, in section
    self.new_subsection(title, lineno, messages)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 395, in new_subsection
    node=section_node, match_titles=True)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 282, in nested_parse
    node=node, match_titles=match_titles)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 195, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2726, in underline
    self.section(title, source, style, lineno - 1, messages)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 327, in section
    self.new_subsection(title, lineno, messages)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 395, in new_subsection
    node=section_node, match_titles=True)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 282, in nested_parse
    node=node, match_titles=match_titles)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 195, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2299, in explicit_markup
    nodelist, blank_finish = self.explicit_construct(match)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2311, in explicit_construct
    return method(self, expmatch)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2054, in directive
    directive_class, match, type_name, option_presets)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2103, in run_directive
    result = directive_instance.run()
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 1488, in run
    nested_parse_with_titles(self.state, self.result, node)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/sphinx/util/nodes.py", line 165, in nested_parse_with_titles
    return state.nested_parse(content, 0, node, match_titles=1)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 282, in nested_parse
    node=node, match_titles=match_titles)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 195, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2299, in explicit_markup
    nodelist, blank_finish = self.explicit_construct(match)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2311, in explicit_construct
    return method(self, expmatch)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2054, in directive
    directive_class, match, type_name, option_presets)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2103, in run_directive
    result = directive_instance.run()
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/zzzeeksphinx/viewsource.py", line 200, in run
    link = _view_source_node(env, modname, self.state)
  File "/mnt/open-source/sqlalchemy/.venv/local/lib/python2.7/site-packages/zzzeeksphinx/viewsource.py", line 61, in _view_source_node
    tok, [pathname] if pathname else None)
ImportError: No module named
```