Skip to content
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.

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

Jump to bottom

gh-95273: Improve documented return values and exceptions raised for sqlite3 class methods #95530

Merged
merged 8 commits into from Aug 4, 2022
Merged

gh-95273: Improve documented return values and exceptions raised for sqlite3 class methods #95530

merged 8 commits into from Aug 4, 2022

Conversation

erlend-aasland
Copy link
Contributor

@erlend-aasland erlend-aasland commented Aug 1, 2022 •
edited by bedevere-bot

@erlend-aasland erlend-aasland requested a review from AlexWaygood Aug 1, 2022
@bedevere-bot bedevere-bot added awaiting core review docs Documentation in the Doc dir skip news labels Aug 1, 2022
@erlend-aasland erlend-aasland mentioned this pull request Aug 1, 2022
Closed
5 tasks
@erlend-aasland erlend-aasland linked an issue Aug 1, 2022 that may be closed by this pull request
Improve the sqlite3 reference #95273
Closed
5 tasks
@erlend-aasland erlend-aasland changed the title gh-95273: Improve return values and exceptions raised for sqlite3 class methods gh-95273: Improve documented return values and exceptions raised for sqlite3 class methods Aug 1, 2022
ezio-melotti
ezio-melotti reviewed Aug 4, 2022
View changes
Doc/library/sqlite3.rst Outdated Show resolved Hide resolved
Doc/library/sqlite3.rst Outdated Show resolved Hide resolved
Doc/library/sqlite3.rst Outdated Show resolved Hide resolved
@ezio-melotti
Copy link
Member

ezio-melotti commented Aug 4, 2022

(@erlend-aasland: I fixed a merge conflict, if you are going to make changes to your local branch remember to pull the merge before you create more commits.)

@erlend-aasland
Copy link
Contributor Author

erlend-aasland commented Aug 4, 2022

Thanks for the review Ezio! I'm extending this PR to use parameter lists in a few more cases. I'll ping you again when I'm ready for a second review.

AlexWaygood
AlexWaygood approved these changes Aug 4, 2022
View changes
Copy link
Member

@AlexWaygood AlexWaygood left a comment •
edited

The words look good, and I'm always in favour of more type hints in the docs (where they're useful)! I'll leave the ReST/Sphinx syntax to Ezio :D

Doc/library/sqlite3.rst Outdated Show resolved Hide resolved
Erlend Egeberg Aasland and others added 3 commits Aug 4, 2022
@erlend-aasland
Copy link
Contributor Author

erlend-aasland commented Aug 4, 2022

FTR, I'm going to land this later today.

@erlend-aasland erlend-aasland merged commit 12d92c7 into python:main Aug 4, 2022
14 checks passed
@miss-islington
Copy link
Contributor

miss-islington commented Aug 4, 2022

Thanks @erlend-aasland for the PR 🌮🎉.. I'm working now to backport this PR to: 3.10, 3.11.
🐍🍒⛏🤖

@miss-islington
Copy link
Contributor

miss-islington commented Aug 4, 2022

Sorry @erlend-aasland, I had trouble checking out the 3.11 backport branch.
Please backport using cherry_picker on command line.
cherry_picker 12d92c733cfc00ee630b30e4e0250da400c83395 3.11

@erlend-aasland erlend-aasland deleted the sqlite-reference/return-and-except branch Aug 4, 2022
@miss-islington
Copy link
Contributor

miss-islington commented Aug 4, 2022

Sorry, @erlend-aasland, I could not cleanly backport this to 3.10 due to a conflict.
Please backport using cherry_picker on command line.
cherry_picker 12d92c733cfc00ee630b30e4e0250da400c83395 3.10

@miss-islington
Copy link
Contributor

miss-islington commented Aug 4, 2022

Thanks @erlend-aasland for the PR 🌮🎉.. I'm working now to backport this PR to: 3.11.
🐍🍒⛏🤖

@miss-islington
Copy link
Contributor

miss-islington commented Aug 4, 2022

Thanks @erlend-aasland for the PR 🌮🎉.. I'm working now to backport this PR to: 3.10.
🐍🍒⛏🤖

@miss-islington
Copy link
Contributor

miss-islington commented Aug 4, 2022

Sorry @erlend-aasland, I had trouble checking out the 3.11 backport branch.
Please backport using cherry_picker on command line.
cherry_picker 12d92c733cfc00ee630b30e4e0250da400c83395 3.11

@miss-islington
Copy link
Contributor

miss-islington commented Aug 4, 2022

Sorry @erlend-aasland, I had trouble checking out the 3.10 backport branch.
Please backport using cherry_picker on command line.
cherry_picker 12d92c733cfc00ee630b30e4e0250da400c83395 3.10

@bedevere-bot
Copy link

bedevere-bot commented Aug 4, 2022

GH-95673 is a backport of this pull request to the 3.11 branch.

erlend-aasland added a commit to erlend-aasland/cpython that referenced this pull request Aug 4, 2022
@erlend-aasland
[3.11] pythongh-95273: Improve documented return values and exception…
f86a981 
…s raised for sqlite3 class methods (pythonGH-95530)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
(cherry picked from commit 12d92c7)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
erlend-aasland added a commit to erlend-aasland/cpython that referenced this pull request Aug 4, 2022
@erlend-aasland
[3.10] pythongh-95273: Improve documented return values and exception…
1e6ceaf 
…s raised for sqlite3 class methods (pythonGH-95530)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>.
(cherry picked from commit 12d92c7)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
@bedevere-bot
Copy link

bedevere-bot commented Aug 4, 2022

GH-95674 is a backport of this pull request to the 3.10 branch.

erlend-aasland added a commit that referenced this pull request Aug 4, 2022
@erlend-aasland
[3.11] gh-95273: Improve documented return values and exceptions rais…
c9986be 
…ed for sqlite3 class methods (GH-95530) (#95673)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
(cherry picked from commit 12d92c7)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
erlend-aasland added a commit that referenced this pull request Aug 4, 2022
@erlend-aasland
[3.10] gh-95273: Improve documented return values and exceptions rais…
4a204c1 
…ed for sqlite3 class methods (GH-95530) (#95674)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>.
(cherry picked from commit 12d92c7)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
iritkatriel pushed a commit to iritkatriel/cpython that referenced this pull request Aug 11, 2022
@erlend-aasland @ezio-melotti
@AlexWaygood @iritkatriel
pythongh-95273: Improve documented return values and exceptions raise…
26026fe 
…d for sqlite3 class methods (python#95530)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@ezio-melotti ezio-melotti

@AlexWaygood AlexWaygood

@berkerpeksag berkerpeksag

Assignees

@erlend-aasland erlend-aasland

Labels
docs Documentation in the Doc dir skip news
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

Improve the sqlite3 reference
5 participants
@erlend-aasland @ezio-melotti @miss-islington @bedevere-bot @AlexWaygood