Revive binascii.Incomplete?

Feature or enhancement

binascii.Incomplete was only used in BinHex 4 (HQX) decoder. After removing that decoder in #89248, binascii.Incomplete became orphaned. It could be removed too.

We can reuse it for decoding errors that can potentially be fixed by reading more data. Not all incomplete data errors can be detected, in some codecs incomplete data can be valid.

For compatibility, binascii.Incomplete should be made a subclass of binascii.Error.

We perhaps will need to add also the final parameter (True by default). If it is false, then binascii.Incomplete will be raised if the last group of data is ambiguous, if the result of decoding concatenated data can be different from concatenation of independently decoded chunks.

I am not sure that this feature will be very useful, but without it we cannot reliably decode chunked data if it was split not on boundaries between groups. Although having only this feature the incremental decoder will be vulnerable to quadratic complexity issue. For example, reading line by line and decoding Base64 data split on 76 column lines except the first line containing 75 alphabetic characters will have quadratic complexity.

Linked PRs

• gh-148109

此 issue 聚焦於 binascii.Incomplete、已移除的 BinHex/HQX 解碼器，以及分塊 Base64 解碼。請先檢視 binascii 解碼器的進入點與相關工作 gh-148109；釐清該例外應移除還是重複使用、其 Error 子類別關係，以及最終語意。完成條件是確認一致的範圍，並為不完整輸入與串接輸入加入測試。