d2
dsl
DISCONTINUED
Our great sponsors
d2 | dsl | |
---|---|---|
92 | 12 | |
15,607 | 1,398 | |
3.0% | - | |
9.8 | 0.0 | |
3 days ago | 3 months ago | |
Go | Java | |
Mozilla Public License 2.0 | Apache License 2.0 |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
d2
- NMAP-formatter: convert NMAP results to HTML, CSV, JSON, graphviz (dot), SQLite
- Penrose – Penrose
-
Pikchr: A PIC-like markup language for diagrams in technical documentation
While not embedded in markdown, I like d2 [1]. I can use it with org-babel to embed and view the diagrams on emacs. After using graphviz for years, the visual output seems more polished to me. With that said, I want to give pikchr a try.
- Ask HN: How do you build diagrams for the web?
-
Documentation as Code for Cloud - C4 Model & Structurizr
In the next post I'll deep-dive into the D2 language which also has a huge set of features. Stay tuned.
- Inkscape Cloud Architect
-
Nomnoml
That site is created by the maintainers of D2[1], so it might be biased, but I still think D2 has the friendliest syntax of the bunch, including nomnoml.
[1]: https://d2lang.com/
-
Architecture diagrams enable better conversations
I've been using https://structurizr.com/ to automatically generate C4 diagrams from a model (rather than drawing them by hand). It works well with the approach for written documentation as proposed in https://arc42.org/. It's very easy to embed a C4 diagram into a markdown document.
The result is a set of documents and diagrams under version control that can be rendered using the structurizr documentation server (for interactive diagrams and indexed search).
I also use https://d2lang.com/ for declarative diagrams in addition to C4, e.g., sequence diagrams and https://adr.github.io/ for architectural decision records. These are also well integrated into structurizr.
-
Top 6 tools for text-based UML sequence diagrams
D2 is a modern declarative language for designing diagrams with text. It supports a variety of different diagram types as well as traditional UML sequence diagrams. D2 is free and open-source under the Mozilla Public License 2.0 license.
- The Unreasonable Effectiveness of Sequence Diagrams in MermaidJS
dsl
-
D2 is now open source – a new, modern language that turns text to diagrams
1. not currently, but it's on the roadmap!
2. with any integration, if there's enough demand, we'll do it. Once we add interactivity to diagrams, it should be trivial to emulate. However I should mention that Simon Brown (the creator of C4) has his own DSL for C4 https://github.com/structurizr/dsl)! We have no intention of competing with it.
3. Currently the options to tune are limited. The Terrastruct app has granular layout control via drag-and-drop, and we're working to bring some of that to native/open-source.
-
How is your time spent in the architecture role?
It's really just an evolution of the original Structurizr for Java library that I built 5+ years ago. Some people really liked the ability to create a model+views using a programming language (ports are now available for .NET, PHP, Python, TypeScript, etc), but many thought it was silly. So I've always wanted to do something "text-based", but I wanted to do "models as code" rather than "diagrams as code". The lockdown in 2020 gave me some time to do this, and the DSL is really just a thin wrapper on that original Java library. Being a wrapper for the Java library provides a way for you to create parts of your model via scripts (Groovy, Kotlin, JRuby) or by mixing the DSL and code. This creates opportunities for manually defining a high level model, and then perhaps inserting a deployment architecture that's automatically generated by parsing AWS/Azure/Terrform/etc.
-
Diagrams as Code 2.0
Structurizr DSL - https://github.com/structurizr/dsl
-
Software to build a visual representation of the solution?
The C4 model and the Structurizr DSL (demo) are pretty much designed to do exactly this. Disclaimer: I'm the author of both.
-
A visual C4 model tool for your team
This (icepanel.io) is just a graphical editor for C4 Model diagrams.
The actual standard (if you can call it that, because it is quite light weight, and that is a good thing) is open source as far as I know.
This means that you can create C4 diagrams with PlantUML [0] or using the C4 specific DSL [1].
-
Alternatives to c4 model?
With this in mind, the Structurizr DSL provides a way to create a model as code, which can then be rendered using tooling of your choice. The Structurizr renderer is one option, but there are others, and you can build your own to meet the style that you're looking for. See structurizr.org - Rendering tools for more.
-
Scripting support added to the Structurizr DSL
The Structurizr DSL now provides a way to run scripts written in Groovy, Kotlin, Ruby, and JavaScript, via the new !script keyword. This gives you access to the underlying Structurizr for Java workspace, for when you need to do something not supported by the DSL.
-
Practical experience of using Structurizr?
This diagram provides an overview of the Structurizr tooling. In short, a Structurizr workspace is described using a JSON document - all authoring methods (code or text) allow you to create/manipulate that JSON document, for rendering using a number of tools (the Structurizr service, PlantUML, Mermaid, DOT, etc). The DSL parser is written in Java (source), so you could use that directly to parse a local DSL file ... this is essentially what the Structurizr CLI does.
What are some alternatives?
mermaid - Generation of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown
C4-PlantUML - C4-PlantUML combines the benefits of PlantUML and the C4 model for providing a simple way of describing and communicate software architectures
d3 - Bring data to life with SVG, Canvas and HTML. :bar_chart::chart_with_upwards_trend::tada:
Mermaid - Edit, preview and share mermaid charts/diagrams. New implementation of the live editor.
diagrams - :art: Diagram as Code for prototyping cloud system architectures
mermaid-cli - Command line tool for the Mermaid library
plantuml - Generate diagrams from textual description
kubernetes-client - Java client for Kubernetes & OpenShift
text-to-diagram-site - Compare syntax, layouts, outputs between languages for generating diagrams with text.
cli - A command line utility for Structurizr.
java - Structurizr for Java