Formalize incomplete error exceptions to improve codeop module handling

[pablogsal]

Currently the way we detect incomplete errors in the codeop module is based on the exception text, which is suboptimal at least. To do this properly, add a new SyntaxError subclass called IncompleteInputError and use that in the codeop module to detect errors from the parser.

Linked PRs

• gh-113744: Add a new IncompleteInputError exception to improve incomplete input detection in the codeop module #113745

[encukou]

Since PyExc_IncompleteInputError was added to the stable API, it needs to be documented. Usually the C names for exceptions just link to the Python docs, so the Python docs are needed as well.

[encukou]

(If you want to delegate this to me, let me know. Currently I'd lean toward not including it in builtins and C-API.)

[pablogsal]

(If you want to delegate this to me, let me know. Currently I'd lean toward not including it in builtins and C-API.)

I think is fine to have it in builtins given that we have the other subclasses of SyntaxError, even if this is currently only used in codeop but if you feel strongly about this I am fine to have it removed.

I am fine removing it from the C-API 👍

WDYT?

[encukou]

Sounds good. It can always be added :)

[pablogsal]

@encukou can you refresh my memory on how can I make the API check not complain? Marking the exception as extern? Or there is a better way?

[pablogsal]

@encukou gentle ping