[Python-ideas] Add an UML class diagram to the collections.abc module documentation
Yahya Abou 'Imran
yahya-abou-imran at protonmail.com
Mon Jan 1 17:58:42 EST 2018
You just run it with the `plantuml` command, and you have .png
It has a good integration with a lot of tools (iPython for example) :
I will look at your suggestions though.
-------- Message d'origine --------
On 1 janv. 2018 23:32, Victor Stinner a écrit :
> There is "blockdiag" which is Sphinx friendly:
> Look also at:
> * http://asciiflow.com/
> * http://ditaa.sourceforge.net/
> * http://asciidoctor.org/news/2014/02/18/plain-text-diagrams-in-asciidoctor/
> * etc.
> I like ASCII Art since it doesn't require any specific tool to edit it
> (even if dedicated tools like asciiflow can make editing simpler).
> For example, I have no idea how to open a ".puml" file. What if the
> tool for this specific format becomes outdated or is not available on
> some platforms?
> Graphviz with "dot" files is another option.
> 2018-01-01 21:39 GMT+01:00 Brett Cannon :
>> While I appreciate what you're trying to accomplish, Yahya, one thing I
>> would like to say is if we were to accept the diagram into the docs I would
>> prefer that there be a source file that isn't an image which we can update
>> with easily available software (e.g. like a dot file). Otherwise updating
>> the file will either be burdensome going forward or we will simply have to
>> drop the image at the first instance of needing to update it because no one
>> can or be willing to put in the effort (and I'm thinking in 5 years, not
>> soon while we can count on you to help).
>> On Sat, Dec 30, 2017, 08:12 Yahya Abou 'Imran via Python-ideas,
>>> We can find very usefull class diagramm to understand the hierarchy of the
>>> builtin Collection abstract class and interface in java.
>>> Some examples:
>>> But when I search about python's ABC, The more detailed I can find are
>>> those from the book of Luciano Ramalho Fluent Python:
>>> (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:
>>> The table could be difficult to understand, a diagram help visualize
>>> 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.
>>> Python-ideas mailing list
>>> Python-ideas at python.org
>>> Code of Conduct: http://python.org/psf/codeofconduct/
>> Python-ideas mailing list
>> Python-ideas at python.org
>> Code of Conduct: http://python.org/psf/codeofconduct/
>> @python.org> @python.org>
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Python-ideas