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

2018-01-01 Thread Wes Turner
SVG is preferable to PNG because you can Ctrl-F SVG. On Monday, January 1, 2018, Wes Turner wrote: > > > On Monday, January 1, 2018, Yahya Abou 'Imran via Python-ideas < > python-ideas@python.org> wrote: > >> Plantuml can also generate ASCII, so playing with ditaa I

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

2018-01-01 Thread Wes Turner
On Monday, January 1, 2018, Yahya Abou 'Imran via Python-ideas < python-ideas@python.org> wrote: > Plantuml can also generate ASCII, so playing with ditaa I managed to have > intersting things... > > I opened a public repo on my GitLab account to put that all so you can > have a visualization of

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

2018-01-01 Thread Yahya Abou 'Imran via Python-ideas
Plantuml can also generate ASCII, so playing with ditaa I managed to have intersting things... I opened a public repo on my GitLab account to put that all so you can have a visualization of it (source files and `png`s): https://gitlab.com/yahya-abou-imran/collections-abc-uml `dot` files seems

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

2018-01-01 Thread Yahya Abou 'Imran via Python-ideas
http://plantuml.com/ 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) : http://plantuml.com/running I will look at your suggestions though. Message d'origine On 1 janv. 2018 23:32, Victor

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

2018-01-01 Thread Terry Reedy
On 1/1/2018 3:39 PM, Brett Cannon wrote: 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

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

2018-01-01 Thread Victor Stinner
Hi, There is "blockdiag" which is Sphinx friendly: http://blockdiag.com/en/blockdiag/sphinxcontrib.html 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

Re: [Python-ideas] a set of enum.Enum values rather than the construction of bit-sets as the "norm"?

2018-01-01 Thread Guido van Rossum
The enum.Flag type solves all this neatly. On Mon, Jan 1, 2018 at 2:43 PM, Barry Scott wrote: > I'm guessing that what this thread is about is coming up with an API rule > that makes > providing a set of boolean options available to a function or class in the > least

Re: [Python-ideas] a set of enum.Enum values rather than the construction of bit-sets as the "norm"?

2018-01-01 Thread Barry Scott
I'm guessing that what this thread is about is coming up with an API rule that makes providing a set of boolean options available to a function or class in the least error prone way. Its the error prone nature of integer bit masks that is behind the enum suggestion I assume. >From the C

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

2018-01-01 Thread Yahya Abou 'Imran via Python-ideas
>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

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

2018-01-01 Thread 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