stfc / fparser

This project maintains and develops a Fortran parser called fparser2 written purely in Python which supports Fortran 2003 and some Fortran 2008. A legacy parser fparser1 is also available but is not supported. The parsers were originally part of the f2py project by Pearu Peterson.
https://fparser.readthedocs.io
Other
63 stars 29 forks source link

Documentation build issues #432

Closed arporter closed 8 months ago

arporter commented 11 months ago

Currently, the fparser doc builds on RTD are failing. Probably for the same package-incompatibility reason that we had in PSyclone (https://github.com/stfc/PSyclone/issues/2242). There are also some warnings indicating that we need to update our configuration: image

arporter commented 9 months ago

The builds will now always fail on RTD because we don't have a .readthedocs.yaml configuration file.

Also, I am now unable to build the documentation locally. I get a KeyError from AutoAPI:

Exception occurred:
  File "/home/me/.pyenv/versions/3.10.7/envs/fparser310/lib/python3.10/site-packages/autoapi/directives.py", line 22, in get_items
    obj = all_objects[name]
KeyError: 'fparser.two.Fortran2008.Fortran2008.Program_Unit'

Just to check, can either @rupertford or @sergisiso reproduce this?

arporter commented 9 months ago

Added the Release label because we need RTD working before we make a new release.

arporter commented 9 months ago

Added a yaml file (in project home directory) and build on RTD works fine: https://fparser.readthedocs.io/en/435_add_rtd_yaml/.