Diagram as Code (diagrams.mingrammer.com)

It seems to be hyperfocused on system architecture diagrams.

There are some other kinds of diagrams would we like to draw that’s not system architecture diagrams, eg:

- algorithms

- decision trees

- UML/ER Diagrams

Mermaid (JS) helps draw quality diagrams quickly - more than system architecture diagrams.

It would have been perfect if the development cycles that went here was used to create Mermaid templates instead.

Unless this also lets us draw more than just system architecture diagrams.

    from diagrams.aws.database import RDS as Database

    from diagrams.gcp.database import SQL as Database

Thanks for sharing! This is really cool.

When I first read this I thought this did the inverse of what it actually does. Let you interactively draw out diagrams then it would generate the boilerplate code to achieve that diagram.

I was hoping this tool would support directionality/sequencing of nodes.

A tool I've used in the past is SequenceDiagram.org for diagraming a sequence of service calls. While a bit old-school, it's good for its purpose.

I've also used Whimsical[0] to model flows and graph-like relationships. It's got the added benefit of allowing multiple users to view and edit the same document. Whimsical is still my favorite tool right now due to flexibility, but it's a closed-source/paid product, so I'm open to alternatives.

[0] https://whimsical.com/

I like this a lot - trying to store diagrams that look good, without sticking a visio file into a git repo is something I keep an eye out for.

Why do we need a tool to draw its architecture and we don't have a tool which auto discover the architecture and auto updates it and draw it form here ?

That will shrink the gap between the current architecture and the current diagram that almost always exists

This looks really neat! Is it possible to have embedded diagrams. For example, Gitlab lets you embed a PlantUML[1] diagram in any Markdown or ADoc file using a proxy server. This makes it really easy to write and serve documentation.

Personally, I'm a fan of PlantUML. Having an svg served in a browser that has labels linking directly to the relevant entity (code, resource etc) is a huge plus for new hire onboarding.

1: https://plantuml.com/

This is cool! I was hoping it would look something like:

‘’’ import diagrams calc_d = diagrams.new_diagram(“calculator_123”)

calc_d.Datum("SuperNumber") class SuperNumber(int): pass

@calc_d.Service(“Calculator”, “takes numbers and operations and operates”) class Calculator(object): @calc_d.Endpoint("Add", calls=["Increment"], main_data={"b": "SuperNumber}) def add(self, a, b: SuperNumber): out = a for i in range(b): calc_d.multi(calls=["Increment"]) out = self.increment(out)

  @calc_d.Function("Increment")
  def increment(self, a):
    return a+1

def integration_test(): calc_d.instantiate("Calculator") calc = Calculator() ... ‘’’

EDIT: Dear dang and YC Hacker News, I would love to create code blocks using surrounding triple quotes..

    pbpaste | sed 's/^.*$/    &/' | pbcopy

    pbpaste | awk '{print "    "$0}' | pbcopy

    pbpaste | sed 's/^/    &/' | pbcopy

I've got a similar project which takes a diagram of your infrastructure, such as [1] and runs the diagram to build your devops infrastructure [2].

[1]: http://devops-pipeline.com/architecture.tb.png [2]: http://devops-pipeline.com/

I have been thinking about using this for some diagrams, but whats been on the back of my mind since I heard about it is how to combine it with Terraform, or Troposphere, and have your infrastructure as code also draw the diagrams automatically.

Sent this to a few people at work and it spread pretty quickly. We all love it!

This is great. Code needs to replace more drag n drop tools, at the very least to give people options.

I was recently looking for something similar, allowing me to draw network diagrams using text or code. I came across [0] which looks great, but has some rough corners and seems to be abandoned by he author. Does anyone have any other recommendations for more bare-metal oriented topologies?

[0] http://go.drawthe.net/

I just created a Dockerfile to run: https://github.com/skhaz/diagrams

Slightly different, but there is now an VSCode extension to use draw.io directly in the editor.

https://marketplace.visualstudio.com/items?itemName=hediet.v...

If you don't know draw.io, it's an free diagram software that not only has an XML format to save them, but can also be used to save it as a PNG that EMBEDS said XML, so you can edit it again, but display it like a regular image.

When I was ~10yrs old, I would play with a program called RPG Maker 2000. It had a really interesting code system where you could click blocks of code and it would bring up a UI for modifying them. It was always simple stuff like if/else, for, switch.. but it merged the simplicity of clicking dropdowns and the like with the complexity of actually seeing the code and learning to read and navigate it. You could also go rogue and write custom code.

I still think that this solution has more life to it and would like to explore that some day.

cool stuff

So, how well does this compare to graphviz? Seems a heck of a lot more verbose.

my favorite: https://plantuml.com/

Why is this better than Mermaid? It works in Markdown, you can version control, and Git(Hub|Lab) displays it automatically.

I'm really curious. Maybe for doing something programmatically, but GraphViz may be better.

this is going to send me down a rabbit hole for a long long time .... there was another thread some months ago about an architecture diagraming tool that reads the code and outputs architecture based on methods.

Why the obsession with product names and logos? Having a Python class for a specific product is not necessary.

...and then people talk about CV-driven development...

> from diagrams import Diagram

Slightly off-topic, but I wish JavaScript's import syntax was designed to be this way around, for better autocomplete in your editor.

Came here half-expecting to see probabilistic programming implemented via Direct Acyclic Graphs (DAGs). This is cool, too, though.

If you are interested in this kind of thing please check out the blockdiag series of tools (seqdiag, rackdiag, netdiag, etc) I haven't looked back since I started using them other than a workplace that uses lucidchart.

http://blockdiag.com/en/