README
¶
svg-sequence
Small go library and CLI tool to generate sequence diagrams in SVG format.
Usage
As a library
package main
import (
"fmt"
svgsequence "github.com/aorith/svg-sequence"
)
func main() {
s := svgsequence.NewSequence()
s.AddStep(svgsequence.Step{SourceActor: "Bob", TargetActor: "Maria", Description: "Hi! How are you doing?"})
s.OpenSection("response", "")
s.AddStep(svgsequence.Step{
SourceActor: "Maria", TargetActor: "Maria",
Description: "*Thinks*\nLong time no see...",
Color: "#667777",
})
s.AddStep(svgsequence.Step{SourceActor: "Maria", TargetActor: "Bob", Description: "Fine!"})
s.CloseSection()
svg, err := s.Generate()
if err != nil {
panic(err)
}
fmt.Println(svg)
}
This will print a basic SVG that you can save and open in the browser.
Using the CLI
Check the command at cmd/cli.
See cmd/cli/examples for config examples.
# Install the CLI tool or run it from cmd/cli
go install github.com/aorith/svg-sequence/cmd/cli@latest
# Generate a sequence from a config file
$ svgsequence -i complete.cfg -o /tmp/sequence.svg
Documentation
¶
Index ¶
- func GenerateFromCFG(filename string) (string, error)
- type Sequence
- func (s *Sequence) AddActors(actors ...string)
- func (s *Sequence) AddStep(step Step)
- func (s *Sequence) CloseSection()
- func (s *Sequence) Generate() (string, error)
- func (s *Sequence) OpenSection(name, color string)
- func (s *Sequence) SetDistance(d int)
- func (s *Sequence) SetHeight(height string)
- func (s *Sequence) SetWidth(width string)
- type Step
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func GenerateFromCFG ¶
GenerateFromCFG generates the sequence by parsing a config file
Types ¶
type Sequence ¶
type Sequence struct {
// contains filtered or unexported fields
}
func NewSequence ¶
func NewSequence() *Sequence
func (*Sequence) AddActors ¶
AddActors adds the given actors to the sequence, in order use this to ensure the order of the actors in the sequence
func (*Sequence) CloseSection ¶
func (s *Sequence) CloseSection()
CloseSection closes the open section
func (*Sequence) OpenSection ¶
OpenSection opens a new section to the sequence diagram. An open section must be closed after adding the steps which should be placed in it.
Parameters:
- name: Required name of the section.
- color: Optional CSS color value (e.g., "#ff0000", "red"). Pass an empty string to use the default color.
func (*Sequence) SetDistance ¶
SetDistance sets the distance between actors
type Step ¶
type Step struct {
// Description: Optional text displayed above the arrow or mark.
Description string
// SourceActor: Required name of the actor that initiates the action.
SourceActor string
// TargetActor: Required name of the actor that receives the action.
//
// It can be the same as sourceActor.
TargetActor string
// Color: Optional CSS color value (e.g., "#ff0000", "red").
//
// Pass an empty string to use the default color.
Color string
// contains filtered or unexported fields
}
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.