[kdeldycke]

Something I've seen asked a couple of time, on the CliRunner hiding the place where exceptions occurs. This PR documents how to activate catch_exceptions to see the traceback.

Relates to:

• click.testing.CliRunner.invoke swallows programming errors #136
• Is there a way to retrieve the stack trace of an exception when testing with the CliRunner? #264
• Please enhance testing workflow + docs #1763
• CliRunner.is_ok method? #1787
• Set the catch_exceptions value for the whole runner #2817

[Rowlando13]

This should go into stable. Rebase please.

[kdeldycke]

This should go into stable. Rebase please.

At first I wasn't sure why targetting either main or stable would make a difference as the likely next release would be 8.6.0 anyway. Then I realized that publishing in stable right away for documentation makes it published on the default URL at https://click.palletsprojects.com . Which is good: no reason to "hide" this doc from current users.

Maybe I should add a note somewhere about that policy? What do you think @Rowlando13 ?

Just made the changes, ready to merge! :)

[kdeldycke]

Maybe I should add a note somewhere about that policy? What do you think @Rowlando13 ?

Never mind. That's already here at https://palletsprojects.com/contributing/docs#work-on-the-stable-branch , committed at pallets/website@aaad29e .