[Python-ideas] Add an UML class diagram to the collections.abc module documentation

pylang pylang3 at gmail.com
Sat Dec 30 17:23:06 EST 2017

+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 <tjreedy at 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 at python.org
> https://mail.python.org/mailman/listinfo/python-ideas
> Code of Conduct: http://python.org/psf/codeofconduct/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-ideas/attachments/20171230/ee6dfa0f/attachment.html>

More information about the Python-ideas mailing list