Uploaded image for project: 'Data Management'
  1. Data Management
  2. DM-32364

Developer Guide: Update dependencies given docutils 0.18

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Done
    • Resolution: Done
    • Fix Version/s: None
    • Component/s: dm_dev_guide
    • Labels:
      None

      Description

      Right now the Developer Guide pins Sphinx < 2, but docutils is allowed to float. With docutils 0.18, there is an incompatibility:

       

      Exception occurred:
      		 
      37  File "/opt/hostedtoolcache/Python/3.8.12/x64/lib/python3.8/site-packages/sphinx/util/nodes.py", line 57, in apply_source_workaround
      		 
      38    for classifier in reversed(node.parent.traverse(nodes.classifier)):
      		 
      39TypeError: 'generator' object is not reversible

      The solution should either be to update to modern sphinx via unpinning documenteer or pinning docutils < 0.16

        Attachments

          Activity

          Hide
          Permalink
          jsick Jonathan Sick added a comment -
          • Unpin documenteer and sphinx_rtd_theme. The old pins were becoming inconsistent with the docutils
            sub-dependency. Using the latest versions works perfectly.
          • Add sphinx-prompt dependency. This is not part of the documenteer package itself.
          • Update intersphinx links

           

          Show
          jsick Jonathan Sick added a comment - Unpin documenteer and sphinx_rtd_theme. The old pins were becoming inconsistent with the docutils sub-dependency. Using the latest versions works perfectly. Add sphinx-prompt dependency. This is not part of the documenteer package itself. Update intersphinx links  

            People

            Assignee:
            jsick Jonathan Sick
            Reporter:
            jsick Jonathan Sick
            Watchers:
            Jonathan Sick
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Dates

              Created:
              Updated:
              Resolved:

                Jenkins

                No builds found.