+1 on adding these diagrams to the docs. It's great to visualize where the special methods are implemented.
On Sat, Dec 30, 2017 at 4:17 PM, Terry Reedy <tjre...@udel.edu> wrote: > On 12/30/2017 11:11 AM, Yahya Abou 'Imran via Python-ideas wrote: > >> We can find very usefull class diagramm to understand the hierarchy of >> the builtin Collection abstract class and interface in java. >> >> Some examples: >> http://www.falkhausen.de/Java-8/java.util/Collection-Hierarc >> hy-simple.html >> http://www.falkhausen.de/Java-8/java.util/Collection-List.html >> >> But when I search about python's ABC, The more detailed I can find are >> those from the book of Luciano Ramalho Fluent Python: >> https://goo.gl/images/8JGjvM >> https://goo.gl/images/6xZqcA >> >> (I think they're done with pyreverse of pylint) >> >> They are fine, but I think we could provide some other more detailed in >> this page: >> https://docs.python.org/3/library/collections.abc.html >> >> The table could be difficult to understand, a diagram help visualize >> things. >> >> I've began working on it with plantuml and pyreverse, I'm joining to this >> mail what I've done so far so you can tell me what you think. >> > > We have a few .png files in the docs. Yours look like the beginning of > perhaps 2 nice additions. > > A. Width restrictions suggest making the async branches a separate diagram. > > B. Be consistent on placement of inherited versus added methods. Always > list inherited first? Different fonts, as suggested, might be good. > > C. After discussion here, and revision, open a doc enhancement issue on > bugs.python.org. > > -- > Terry Jan Reedy > > > _______________________________________________ > Python-ideas mailing list > Python-ideas@python.org > https://mail.python.org/mailman/listinfo/python-ideas > Code of Conduct: http://python.org/psf/codeofconduct/ >
_______________________________________________ Python-ideas mailing list Python-ideas@python.org https://mail.python.org/mailman/listinfo/python-ideas Code of Conduct: http://python.org/psf/codeofconduct/
