Skip to content

gh-105286: Improve typing.py docstrings #105287

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AlexWaygood merged 12 commits into from
Jun 5, 2023
Merged

gh-105286: Improve typing.py docstrings #105287

Changes from 1 commit
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
e808f2b
Improve `typing.py` docstrings
AlexWaygood Jun 4, 2023
7f20599
Apply suggestions from code review
AlexWaygood Jun 5, 2023
d59d72b
Update Lib/typing.py
AlexWaygood Jun 5, 2023
f96723e
Update Lib/typing.py
AlexWaygood Jun 5, 2023
9f132e9
Colons
AlexWaygood Jun 5, 2023
e7983b2
Use two colons everywhere
AlexWaygood Jun 5, 2023
ff90369
Newlines following class docstrings as per PEP 257
AlexWaygood Jun 5, 2023
d54c06b
Nit
AlexWaygood Jun 5, 2023
ab3e627
Fix first line of NoReturn docstring
AlexWaygood Jun 5, 2023
748c55f
Better first sentences
AlexWaygood Jun 5, 2023
f9e27e2
Make module docstring more user-facing
AlexWaygood Jun 5, 2023
58fbb0f
Capitalise Point2D
AlexWaygood Jun 5, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Update Lib/typing.py 
Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
  • Loading branch information
@AlexWaygood @sobolevn
AlexWaygood and sobolevn authored Jun 5, 2023
commit d59d72b77bb80022905d7b750dca3c3949d1da8d
2 changes: 1 addition & 1 deletion Lib/typing.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2402,7 +2402,7 @@ def utf8(value: bytes) -> bytes: ...
@overload
def utf8(value: str) -> bytes: ...
def utf8(value):
# implementation goes here
... # implementation goes here

The overloads for a function can be retrieved at runtime using the
get_overloads() function.
Expand Down