nimforum mirror - Nim containers

mora (orginal) [2015-05-14T09:13:53+02:00] view original

Hi,

I'm learning about nim containers, and of course dreaming about to improve them. So I started to search for common patterns and concepts. To help my understanding I wrote a nim script which parses the nim source and creates some charts (graphviz rocks!) showing the available functions for each container type. This is the result so far:

http://pottom.mooo.com/nim_collections/

Please take a look and give some feedback. This is far from perfect, for example functions are broken if they accept proc as parameters, templates are completely missing, etc. If you think it is worth to continue, then I'll clean the code and upload to github.

Thanks, Peter

Araq (orginal) [2015-05-14T10:28:35+02:00] view original

OMG, this is awesome! Can I use these images for my upcoming presentations/talks about Nim?

mora (orginal) [2015-05-14T10:47:18+02:00] view original

I would be happy if you could use them. I'll be busy tonight, but I'll try to share the code in the next 2 days.

joseph_wecker (orginal) [2015-05-15T04:25:33+02:00] view original

Peter- these look great and are surprisingly informative (I've often found things like call graphs look great in abstract but end up being less useful in practice- graphing the API to the containers though gives a lot of relevant info at a glance). Thanks for sharing! If I had one piece of feedback at first glance it would be to remove the "proc " from the edge labels as it's implied by being an edge (and maybe "iterator " too since you've covered that with the edge color) (and maybe empty sets of parameters "()" as well?)...

Varriount (orginal) [2015-05-15T05:52:34+02:00] view original

I agree - with some polish and tweaks, this would be quite useful in a tutorial/cheat sheet on the various container data types.

mora (orginal) [2015-05-18T00:22:40+02:00] view original

I've removed the proc/iterator/template tag from the edges, also removed the parenthesis () if there is no parameters. I've added procs without return type, created the charts for string, int, float, File and expr. It is still far from perfect, for example "map" is broken with no easy way to fix, because it takes a function as parameter. The current approach uses regex with several hacks. If I had knew all these issues a week ago, I would have written a parser from scratch.

The code is on github: https://github.com/petermora/nimDot

An example chart from the output folder: https://github.com/petermora/nimDot/blob/master/output/Table.png

joseph_wecker (orginal) [2015-05-18T20:59:45+02:00] view original

Looks tight. Thanks again for sharing and for something to work with dot files in general. Re: parentheses- seems like a good chance to use nim's peg features or import the compiler package.

G4MR (orginal) [2015-05-21T03:26:45+02:00] view original

I've never seen Araq this excited on the forums.

Varriount (orginal) [2015-05-21T06:27:03+02:00] view original

My only complaint with the generated images now is that it can be difficult to tell which proc label corresponds to which line, especially when there are many lines approximately parallel with each other.

Mirror of forum.nim-lang.org

1225 :: Nim containers