According to the docs:
"When an exception has occurred in the try clause and has not been handled by an except clause (or it has occurred in an except or else clause), it is re-raised after the finally clause has been executed."
https://docs.python.org/2/tutorial/errors.html#defining-clean-up-actions

This seems to not be the case if return inside a finally block, the exception needing to be thrown looks like its tossed out.

I'm not sure if this is intended behavior and the docs need to be updated or python isn't doing the correct behavior.



Python 3.4.4 (v3.4.4:737efcadf5a6, Dec 20 2015, 19:28:18) [MSC v.1600 32 bit (Intel)] on win32
Type "help", "copyright", "credits" or "license" for more information.

This is intended and documented behavior.

https://docs.python.org/3/reference/compound_stmts.html#the-try-statement

Oops I didn't realize I referenced the tutorial documentation.

Maybe it would be better to mention this behavior in the tutorial documentation also.

I've always assumed exception raises take priority over any return/break/continues. Behavior is backwards from what I'd expect but makes sense.

I'm not sure that the tutorial should contain such details. But if you provide a pull request with a short and clear documenting of this behavior, it will be reviewed and may be accepted (not by me, I'm not native English and not tech writer). Otherwise this issue will be closed.

I'll have to look into this as I have yet to commit anything but I'll put it on my list of things to do.

The doc has a lot more detail now: https://docs.python.org/3.10/tutorial/errors.html#defining-clean-up-actions

but this point is still not mentioned.

Just opened PR 25600, if the changes are ok then I can backport it to 3.9 and 3.8 docs.

3.8 is in security fixes mode but I'll happily take this for 3.9.

New changeset 91cb1e20e6a432b8b2c1b5db37b03c84b15384fa by Miss Islington (bot) in branch '3.9':
bpo-32822: Add finally with return/break/continue to the tutorial (GH-25600) (#25890)
https://github.com/python/cpython/commit/91cb1e20e6a432b8b2c1b5db37b03c84b15384fa

New changeset 8655521de8760e8a695bcce92937800c079ea2b2 by Miss Islington (bot) in branch '3.10':
bpo-32822: Add finally with return/break/continue to the tutorial (GH-25600) (#25893)
https://github.com/python/cpython/commit/8655521de8760e8a695bcce92937800c079ea2b2

pull_requests: + pull_request25774

messages: + msg392886
versions: - Python 3.8

pull_requests: + pull_request24317
stage: patch review

messages: + msg388690

keywords: + easy

nosy: + docs@python
versions: + Python 2.7, Python 3.6, Python 3.7, Python 3.8, - Python 3.4
assignee: docs@python
components: + Documentation, - Interpreter Core
type: behavior -> enhancement

messages: + msg313858