PEP 249: Replace StandardError with Exception - #2781
malemburg merged 6 commits into
Conversation
Sorry, something went wrong.
the DB-API 2.0 in the context of Python 3. Add a note about a future upgrade to the Warning base class. Fixes python#2776.
Sorry, something went wrong.
|
LGTM. Not sure the Py2 historical note is going to matter much but it's good to have it in case anyone's wondering as they make upgrades. |
Sorry, something went wrong.
|
Posted RFC to DB-SIG: https://mail.python.org/pipermail/db-sig/2022-September/006329.html |
Sorry, something went wrong.
This was removed in Python 3 as well. Python 2.7 doesn't need it either, since all standard exceptions are builtin objects.
They were already for a very long time, so this is pointless. I only had this sentence to explain why I had removed the "import exceptions" line from the Python 2 days.
|
Thank you all for your reviews. |
Sorry, something went wrong.
|
Late to the party, was busy with the Artemis 1 launch, but just FYI as of #2702 you can now use intersphinx links to be able to do e.g. :exc:`Exception`, etc, which will not only format it as an exception, but also link to the relevant exception, if you want. |
Sorry, something went wrong.
|
On 14.09.2022 05:27, C.A.M. Gerlach wrote:
Late to the party, was busy with the Artemis 1 launch, but just FYI as
of #2702 <#2702> you can now use
intersphinx links to be able to do e.g. |:exc:`Exception`|, etc, which
will not only format it as an exception, but also link to the relevant
exception, if you want.
Thanks for the tip.
Is there a reference somewhere of what formatting can be used for PEPs ?
…--
Marc-Andre Lemburg
http://www.malemburg.com/
|
Sorry, something went wrong.
|
Yup, its standard Sphinx reST; PEP-12 both gives an intro to reST as well as PEP-specific guidance, but per #2337 I've been meaning to update it to focus just on the latter and for the rest, refer to the more complete and up to date Sphinx reST primer (which itself is just a mildly updated version of the reST primer in the CPython devguide, not to be confused with the earlier and more limited docutils reST primer). There's also the docutils Quick Reference and full reference to basic reST, and the Sphinx Directives, Domains and Roles pages for the constructs Sphinx adds. |
Sorry, something went wrong.
To avoid confusion when using the DB-API 2.0 in the context of Python 3.
Add a note about a future upgrade to the Warning base class.
Fixes #2776.