Undeprecate the onerror argument in shutil.rmtree()

[serhiy-storchaka]

Bug report

A new onexc parameter was added in shutil.rmtree() in 3.12 (see #102828). At the same time passing the onerror argument was deprecated. It creates inconvenience for code that should run on several Python versions. It forces users to modify their working code to avoid deprecation warnings.

I think that there was nothing wrong in onerror. The only advantage of onexc over onerror was that it may require to write less code in some cases, but the deprecation causes an opposite effect -- it requires to write more code.

So I think that the deprecation should be reverted.

@iritkatriel

Linked PRs

• gh-112645: remove deprecation warning for use of onerror in shutil.rmtree #112659
• [3.12] gh-112645: remove deprecation warning for use of onerror in shutil.rmtree (#112659) #112665

[iritkatriel]

We can remove the deprecation warning but leave it deprecated in the docs.

[serhiy-storchaka]

Thank you @iritkatriel. Please backport this change to 3.12.