gh-111356: Add missing documented objects to io.__all__#111370
Merged
Uh oh!
There was an error while loading. Please reload this page.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This change updates
io.__all__with three missing public and documented entries:text_encoding(),DEFAULT_BUFFER_SIZE, andIncrementalNewlineDecoder.As suggested by @AlexWaygood, I have also updated the tests to check
__all__usingtest.support.check__all__(). As a matter of fact, there already wastest__all__()inMiscIOTest, which ostensibly checked that all exported symbols existed. It seems like the test was also designed to check some properties of the exported objects; however, these existing checks failed for me.I have removed the existing checks and replaced them with the suggest
check__all__(). I am using a few new attributes to tailor the test toCMiscIOTestandPyMiscIOTest, respectively.Since I don't understand why existing tests would fail, some extra attention might be warranted here. There is also another detail of possible interest:
IncrementalNewlineDecoderwas not added toio.__all__, but was added toall_membersin the test setup. This could indicate an intentional omission (albeit 15 years ago).