Indicate the page where rendering failed

[anatoly-scherbakov]

I greatly appreciate #133 which helps to be certain that the site builds correctly, and to prevent errors from sneaking into production. There is one little caveat though: if, while rendering, the process fails it might be hard to understand on which page the failure happened.

I propose to print the page path in the error message.

[github-actions]

Welcome to this project and thank you!' first issue

[fralau]

Yes it makes sense.

For the record, could you provide an example of the error message you are getting (without the filename)?

[anatoly-scherbakov]

@fralau yes:

INFO     -  [macros] - ERROR # _Macro Rendering Error_

            **TypeError**: sequence item 65: expected str instance, span found


            ```
            Traceback (most recent call last):
              File "/home/anatoly/.pyenv/versions/3.8.12/envs/yeti.sh/lib/python3.8/site-packages/mkdocs_macros/plugin.py", line 480, in render
                return md_template.render(**page_variables)
              File "/home/anatoly/.pyenv/versions/3.8.12/envs/yeti.sh/lib/python3.8/site-packages/jinja2/environment.py", line 1291, in render
                self.environment.handle_exception()
              File "/home/anatoly/.pyenv/versions/3.8.12/envs/yeti.sh/lib/python3.8/site-packages/jinja2/environment.py", line 925, in handle_exception
                raise rewrite_traceback_stack(source=source)
              File "<template>", line 9, in top-level template code
              File "/home/anatoly/.pyenv/versions/3.8.12/envs/yeti.sh/lib/python3.8/site-packages/dominate/dom_tag.py", line 334, in __unicode__
                return self.render()
              File "/home/anatoly/.pyenv/versions/3.8.12/envs/yeti.sh/lib/python3.8/site-packages/dominate/dom_tag.py", line 340, in render
                return u''.join(data)
            TypeError: sequence item 65: expected str instance, span found

This is an error raised by my own code (a macro that I am calling).

I am preparing a PR right now.

[anatoly-scherbakov]

After the change:

INFO     -  [macros] - ERROR # _Macro Rendering Error_

            _File_: `index.md`

            _UndefinedError_: 'badoom' is undefined

            ```
            Traceback (most recent call last):
              File "/home/anatoly/research/mkdocs_macros_plugin/mkdocs_macros/plugin.py", line 481, in render
                return md_template.render(**page_variables)
              File "/home/anatoly/.pyenv/versions/3.8.12/envs/octadocs/lib/python3.8/site-packages/jinja2/environment.py", line 1291, in render
                self.environment.handle_exception()
              File "/home/anatoly/.pyenv/versions/3.8.12/envs/octadocs/lib/python3.8/site-packages/jinja2/environment.py", line 926, in handle_exception
                raise rewrite_traceback_stack(source=source)
              File "<template>", line 13, in top-level template code
              File "/home/anatoly/.pyenv/versions/3.8.12/envs/octadocs/lib/python3.8/site-packages/jinja2/environment.py", line 456, in getitem
                return obj[argument]
            jinja2.exceptions.UndefinedError: 'badoom' is undefined

            ```

[anatoly-scherbakov]

The PR: #136

[fralau]

@anatoly-scherbakov Thanks for PR #136. My first impression is that it is a darn good job; let me check it in detail.

[anatoly-scherbakov]

I have spotted some issues there, pushed new commits :)