NOTICE: This repository is presented as-is. No guarantees are made with regards to quality, suitability, or backwards-compatibility. Use at your own risk.
A library for describing software systems in Go following the C4 model.
Before getting started, it's important to note that this library is not intended as a complete implementation of the C4 extension for PlantUML. Functionality is only added as I have a use-case for it. See the References section for links to alternatives.
$ go get -u github.com/haleyrc/c4
This section outlines the general workflow using the
c4package. For detailed instructions on implementation, see the package documentation.
When generating diagrams with PlantUML, you generally write a specification in the PlantUML "language" in a plain text file and then use either the online server or the CLI to convert that specification to a PNG/SVG/etc. This package focuses exclusively on the first portion of this process by allowing you to write your specification in Go rather than the PlantUML DSL. This has a number of benefits including test, error handling, and re-use. If you are familiar with infrastructure-as-code tooling, this package draws a lot of inspiration from Pulumi where native PlantUML is more akin to writing Terraform configs in raw HCL.
Given the following minimal program:
package main
import (
"context"
"os"
"github.com/haleyrc/c4"
)
func main() {
ctx := context.Background()
internetBankingSystem, _ := c4.NewSystem(ctx, "internetBankingSystem", c4.SystemArgs{
Name: "Internet Banking System",
Description: "Allows customers to view information about their bank accounts and make payments.",
})
d, _ := c4.NewDiagram(ctx, "Example")
d.AddElement(ctx, internetBankingSystem)
d.PlantUML(ctx, os.Stdout)
}You can generate a PNG by running the following:
$ go run main.go | java -jar plantuml.jar -p > example.pngYou are, of course, free to output your PlantUML specification to a file and pass that to the PlantUML CLI as an argument. The c4 package doesn't make any real assumptions about how you are getting from the Go world to the PlantUML world.
The following diagrams were generated using the sample code in the examples/ directory to mimic the "official" examples found at https://c4model.com.
- Queue elements
- Deployment diagram support
- Dynamic diagram support
- Single static definition e.g. the ability to write a single monolithic description of your systems, their containers, and their components, and then use those in building diagrams by only specififying the nodes you want.