Skip to content

Griffe update removed the options parameter from docstring parsing functions #423

@elnelson575

Description

@elnelson575

Griffe's update on 2/9/2026 removed the options parameter from docstring parsing functions, which quartodoc still allows. This is causing a failure at the quartodoc.autosummary - INFO - Summarizing docs for index page. step.

For more info:
See this patch PR we did for py-shiny: posit-dev/py-shiny#2163
and/or this example of how build fails in the pipeline: https://github.com/posit-dev/py-shiny/actions/runs/21870887721/job/63144591291

It appears to be failing on a numpy function, but not sure if more systemic changes will be necessary:

   File "/opt/hostedtoolcache/Python/3.13.11/x64/lib/python3.13/site-packages/griffe/_internal/models.py", line 183, in parse
      return parse(self, parser or self.parser, **(options or self.parser_options))
    File "/opt/hostedtoolcache/Python/3.13.11/x64/lib/python3.13/site-packages/griffe/_internal/docstrings/parsers.py", line 51, in parse
      return parsers[parser](docstring, **options)
             ~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^
  TypeError: parse_numpy() got an unexpected keyword argument 'allow_section_blank_line'

Let me know if there's any more info I can provide!

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    Status

    No status

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions