What text->diagram tools do you guys prefer? I am partial to PlantUML: https://plantuml.com/
Oddly, I've never heard this called "security protocol notation" before, but apparently that's a thing as well.
for more sophisticated scenarios (or customisation), you can still get "rendered from text on my computer" using tools like PlantUML. (Or GraphViz for graphs, etc.).
Embedding the resulting diagrams in the text editor (like Emacs' org-babel allows for) makes for a nice diagramming experience.
While we should reach for prior art, something like this bit of python is good for the hip pocket for those moments when PlantUML might not support some zany requirement.
It turned out to be extremely convenient:
- python makes it easy to spot errors/typos (you can use mypy even before running the genrator)
- keyword arguments and dictionaries map naturally to node/edge properties
- you can reuse boilerplate by using functions, variables and control structures
- you can always inject graphviz string directly as a last resort hacking measure
- thanks to python's dynamic features, you can even give the nodes/clusters same names as their corresponding python objects, which results in less boilerplate and makes easy to debug
(ended up having to turn it into a custom WebExtension just so it could integrate "easily" with kibana by monkeypatching & intercepting its xhr requests, let's not get into that...)
What I really wish for is integration, or at least discovery.
I run into posts like this all the time, see neat things, and then can never find them again.
I like all-in-one libraries like pylab/matplotlib where I know where to look. The corollary is that if this could be folded into something, it'd probably see more use. But I'm not sure what.
Or perhaps an alternative might be to have all libraries like this categorized in some way. I'm not quite sure how, though.
ValueError: invalid literal for int() with base 10: ''
Changed it to float before int casting but still the same error.
Not text to diagram, but creating diagrams in text that I check-in to the comments at the top of my code.