luciano/d2
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

2022-11-23 10:37:36AM

Browse source
This commit is contained in:
Alexander Wang 2022-11-23 10:37:36 -08:00
parent dc9cc25667
commit d637f9257d
No known key found for this signature in database
GPG key ID: D89FA31966BDBECE
1 changed files with 27 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

45
README.md
View file

@ -109,41 +109,50 @@ Go programs.
```go ```go
import ( import (
"github.com/terrastruct/d2/d2compiler" "context"
"github.com/terrastruct/d2/d2exporter" "io/ioutil"
"github.com/terrastruct/d2/d2layouts/d2dagrelayout" "path/filepath"
"github.com/terrastruct/d2/d2renderers/textmeasure" "strings"
"github.com/terrastruct/d2/d2themes/d2themescatalog"
"oss.terrastruct.com/d2/d2compiler"
"oss.terrastruct.com/d2/d2exporter"
"oss.terrastruct.com/d2/d2layouts/d2dagrelayout"
"oss.terrastruct.com/d2/d2renderers/d2svg"
"oss.terrastruct.com/d2/d2renderers/textmeasure"
"oss.terrastruct.com/d2/d2themes/d2themescatalog"
) )
func main() { func main() {
graph, err := d2compiler.Compile("", strings.NewReader("x -> y"), &d2compiler.CompileOptions{ UTF16: true }) graph, _ := d2compiler.Compile("", strings.NewReader("x -> y"), &d2compiler.CompileOptions{UTF16: true})
ruler, err := textmeasure.NewRuler() ruler, _ := textmeasure.NewRuler()
err = graph.SetDimensions(nil, ruler) graph.SetDimensions(nil, ruler)
err = d2dagrelayout.Layout(ctx, graph) d2dagrelayout.Layout(context.Background(), graph)
diagram, err := d2exporter.Export(ctx, graph, d2themescatalog.NeutralDefault) diagram, _ := d2exporter.Export(context.Background(), graph, d2themescatalog.NeutralDefault.ID)
ioutil.WriteFile(filepath.Join("out.svg"), d2svg.Render(*diagram), 0600) out, _ := d2svg.Render(diagram)
ioutil.WriteFile(filepath.Join("out.svg"), out, 0600)
} }
``` ```
D2 is built to be hackable -- the language has an API built on top of it to make edits D2 is built to be hackable -- the language has an API built on top of it to make edits
programmatically. programmatically.
Modifying the above diagram:
```go ```go
import ( import (
"github.com/terrastruct/d2/d2oracle" "oss.terrastruct.com/d2/d2renderers/textmeasure"
"github.com/terrastruct/d2/d2format" "oss.terrastruct.com/d2/d2themes/d2themescatalog"
) )
// ...modifying the diagram `x -> y` from above
// Create a shape with the ID, "meow" // Create a shape with the ID, "meow"
graph, err = d2oracle.Create(graph, "meow") graph, _, _ = d2oracle.Create(graph, "meow")
// Style the shape green // Style the shape green
graph, err = d2oracle.Set(graph, "meow.style.fill", "green") color := "green"
graph, _ = d2oracle.Set(graph, "meow.style.fill", nil, &color)
// Create a shape with the ID, "cat" // Create a shape with the ID, "cat"
graph, err = d2oracle.Create(graph, "cat") graph, _, _ = d2oracle.Create(graph, "cat")
// Move the shape "meow" inside the container "cat" // Move the shape "meow" inside the container "cat"
graph, err = d2oracle.Move(graph, "meow", "cat.meow") graph, _ = d2oracle.Move(graph, "meow", "cat.meow")
// Prints formatted D2 code // Prints formatted D2 code
println(d2format.Format(graph.AST)) println(d2format.Format(graph.AST))
``` ```