py_sig_re dropped without a deprecation warning about sphinx HOT 4 CLOSED

cc: @mansenfranzen

We can make a patch release to reinstate py_sig_re. I would note, though, that it is a private object, and thus is not subject to any deprecation policies -- it is not documented anywhere and the regular expression contained therein is subject to change without notice (and indeed, has done so).

It would be better to find a supported and documented method for autodoc_pydantic to achieve the same outcome.

A

from sphinx.

@j-carson thanks for taking care with this issue!

@AA-Turner it would be great if you could re-import the regular expression to allow older versions of autodoc_pydantic to work with the newest sphinx versions.

For the future, I would also like to rely on a public function/API instead of using the private regex. Are you aware of any? If not, I would be willing to provide a PR adding the rather narrow functionality wrapped in a publicly facing function.

from sphinx.

62c3bad will be included in Sphinx 7.3.7.

For the second, I will have a think. Perhaps it could be as simple as splitting the first few lines from handle_signature and returning some custom type:

def split_object_signature(sig: str) -> _SigType:
    m = py_sig_re.match(sig)
    if m is None:
        raise ValueError
    prefix, name, tp_list, arglist, retann = m.groups()
    return _SigType(...)

from sphinx.

Sphinx 7.3.7 has been released with fixes.

A

from sphinx.