[issue22014] Improve display of OS exception <-> errno mapping

[Brett Cannon]

Brett Cannon  added the comment:

Is this still important now that OSError has so many subclasses that correspond 
to specific error codes?

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue22014] Improve display of OS exception - errno mapping

[Brett Cannon]

Changes by Brett Cannon br...@python.org:


--
nosy: +brett.cannon

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue22014
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue22014] Improve display of OS exception - errno mapping

[Jon Poler]

Jon Poler added the comment:

Here's one way to accomplish this. Please see attached 
os_exceptions_table_V2.patch.

I wasn't having much luck trying to use ReST, so I took advantage of the fact 
that the Doc/conf.py file is executed every time sphinx-build is run. conf.py 
imports and calls the main function from Doc/tools/build_table.py. This script 
dynamically builds a table by scraping errno values corresponding to an OS 
exception and inserting them in the appropriate place. 
Doc/library/exceptions.rst just uses a literalinclude of the new table that 
gets built to Lib/test/os_exception_hierarchy.txt (the same directory that 
holds the original exceptions hierarchy).

Error catching is used so that, in the event of an error, a warning will be 
raised but the sphinx-build command will still succeed.

--
Added file: http://bugs.python.org/file36392/os_exceptions_table_V2.patch

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue22014
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue22014] Improve display of OS exception - errno mapping

[Nick Coghlan]

Nick Coghlan added the comment:

I'd suggested starting with seeing including of the subsection of the 
exceptions.txt file looks, and if that's still a bit hard to read, try the 
explicit table approach.

I'm always wary of having hand maintained mappings in the docs, but this 
particular one isn't likely to change any time soon.

--
title: Add summary table for OS exception - errno mapping - Improve display 
of OS exception - errno mapping

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue22014
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue22014] Improve display of OS exception - errno mapping

[Jon Poler]

Jon Poler added the comment:

I'm not entirely sure that I'm interpreting what you are looking for correctly, 
but here is what the table looks like with literalinclude.

--
keywords: +patch
Added file: http://bugs.python.org/file36365/OS_exceptions_table.patch

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue22014
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com