AttributeError: 'Values' object has no attribute 'pep_references'
Exiting due to error.  Use "--traceback" to diagnose.
Please report errors to <docutils-users@lists.sf.net>.
Include "--traceback" output, Docutils version (0.17.1 [release]),
Python version (3.7.3), your OS type & version, and the
command line used.
make: *** [Makefile:1004: alectryon-html-done.timestamp] Error 1

https://github.com/HoTT/HoTT/runs/2369972229#step:6:2123

Is it safe to always run with --traceback? Is it suggested?

Maybe it's not so nondeterministic, it seems to happen every time now.

Traceback (most recent call last):
  File "etc/alectryon/alectryon.py", line 26, in <module>
    main()
  File "/github/workspace/etc/alectryon/alectryon/cli.py", line 662, in main
    process_pipelines(args)
  File "/github/workspace/etc/alectryon/alectryon/cli.py", line 651, in process_pipelines
    state = call_pipeline_step(step, state, ctx)
  File "/github/workspace/etc/alectryon/alectryon/cli.py", line 620, in call_pipeline_step
    return step(state, **{p: ctx[p] for p in params})
  File "/github/workspace/etc/alectryon/alectryon/cli.py", line 114, in gen_rstcoq_html
    RSTCoqParser, RSTCoqStandaloneReader)
  File "/github/workspace/etc/alectryon/alectryon/cli.py", line 105, in _gen_docutils_html
    enable_exit_status=True).decode("utf-8")
  File "/home/coq/.local/lib/python3.7/site-packages/docutils/core.py", line 417, in publish_string
    enable_exit_status=enable_exit_status)
  File "/home/coq/.local/lib/python3.7/site-packages/docutils/core.py", line 665, in publish_programmatically
    output = pub.publish(enable_exit_status=enable_exit_status)
  File "/home/coq/.local/lib/python3.7/site-packages/docutils/core.py", line 218, in publish
    self.settings)
  File "/home/coq/.local/lib/python3.7/site-packages/docutils/readers/__init__.py", line 72, in read
    self.parse()
  File "/home/coq/.local/lib/python3.7/site-packages/docutils/readers/__init__.py", line 78, in parse
    self.parser.parse(self.input, document)
  File "/github/workspace/etc/alectryon/alectryon/docutils.py", line 495, in parse
    self.statemachine.run(lines, document, inliner=self.inliner)
  File "/home/coq/.local/lib/python3.7/site-packages/docutils/parsers/rst/states.py", line 158, in run
    inliner.init_customizations(document.settings)
  File "/home/coq/.local/lib/python3.7/site-packages/docutils/parsers/rst/states.py", line 607, in init_customizations
    if settings.pep_references:
AttributeError: 'Values' object has no attribute 'pep_references'
make: *** [Makefile:1005: alectryon-html-done.timestamp] Error 1

https://github.com/HoTT/HoTT/runs/2386323130?check_suite_focus=true#step:6:2122 https://github.com/HoTT/HoTT/pull/1466

Is there a way to get the python traceback to also print function arguments?

Traceback with arguments: https://github.com/HoTT/HoTT/runs/2393729047?check_suite_focus=true#step:6:2122

@cpitclaudel do you have any idea what's going on here?

I will look soon

Quick check: which command is yielding this result? You're processing a .v file with embedded reST? Or with embedded Coqdoc?

I'm invoking python3 etc/alectryon/alectryon.py --frontend coq+rst --backend webpage --sertop-arg=--no_prelude --sertop-arg=--indices-matter -R "./theories" HoTT -Q "./contrib" HoTT.Contrib --output-directory alectryon-html --cache-directory alectryon-cache ./theories/Basics.v ./theories/Basics/Notations.v ./theories/Basics/Utf8.v ... with a couple hundred more .v files, it looks like it's processing theories/Basics.v. I'm claiming there's embedded reST, but in fact we haven't added any yet.

It looks like there was a similar issue in Sphinx (https://github.com/sphinx-doc/sphinx/pull/4512) that was fixed by

 default_settings = {
     'embed_stylesheet': False,
     'cloak_email_addresses': True,
     'pep_base_url': 'https://www.python.org/dev/peps/',
+    'pep_references': None,
     'rfc_base_url': 'https://tools.ietf.org/html/',
+    'rfc_references': None,
     'input_encoding': 'utf-8-sig',
     'doctitle_xform': False,
     'sectsubtitle_xform': False,
     'halt_level': 5,
     'file_insertion_enabled': True,
     'smartquotes_locales': [],
 }

in sphinx/environment/__init__.py

Thanks, I saw that one, but I should be inheriting all default settings in RstCoqParser:

class RSTCoqParser(docutils.parsers.rst.Parser):
    """A wrapper around the reStructuredText parser for literate Coq files."""

    supported = ('coq',)
    """Aliases this parser supports."""

    settings_spec = ('Literate Coq Parser Options', None,
                     docutils.parsers.rst.Parser.settings_spec[2]) # ← Here

Which version of docutils are you using?

it looks like it's processing theories/Basics.v. I'm claiming there's embedded reST, but in fact we haven't added any yet.

If you run that same command manually, with just theories/Basics.v, do you get the same issue?

Reproduced by upgrading to 0.17

That's strange, given that we seem to have succeeded on docutils-0.17 (see https://github.com/HoTT/HoTT/runs/2353352310?check_suite_focus=true), but we are failing on docutils-0.17.1. In any case, the failure occurs with docutils 0.17.1 [release] and Python version 3.7.3.

Ah sorry, I meant I updated to the latest from 0.16, and things are now reproducing; it could be that the culprit is 17.1 instead of 17. Will look right away.