README.md

gopuml

gopuml is a CLI tool to compile Plant UML into images and links.

It has support for generating png, svg and txt output either as files or links. gopuml is built in golang and leverages plantuml.com to generate the output.

Example:

gopuml can convert this example text into a file or a link, in this example, using the svg formatter.

Plant UML

@startuml Example
Bob -> Alice : hello
@enduml

Generated SVG file

gopuml build -f svg example/example.puml

Generated SVG link

gopuml build -f svg --style link example/example.puml

https://www.plantuml.com/plantuml/svg/SYWkIImgAStDKN2jICmjo4dbSifFKj2rKt3CoKnELR1Io4ZDoSddSaZDIodDpG44003__m00

Table of Contents

• Usage
  • Install
  • Compiling UML
  • Development Environment
• Examples

Usage

Install

go install github.com/lonnblad/gopuml/cmd/gopuml@v0.2.1

Compiling UML

The command used to compile the Plant UML to different formats.

gopuml build [files]

To test the build feature in the gopuml repository:

gopuml build example/example.puml

Options

• -f, --format

  The format to use when compiling the Plant UML, defaults to: svg.

  Supported formatters are:

  • png, will format the content as .png
  • svg, will format the content as .svg
  • txt, will format the content as .txt

• --server

  The Server URL to use when the style used is link, defaults to: https://www.plantuml.com/plantuml.

• --style

  The style to use when compiling the Plant UML, defaults to: file.

  Supported styles are:

  • file, will write the formatted content to a file
  • link, will write a link to the formatted content to stdout
  • out, will write the formatted content to stdout

Development Environment

gopuml supports running a local webserver which will automatically reload the rendered version of the Plant UML as they are updated

gopuml serve [files]

To test the serve feature in the gopuml repository:

gopuml serve example/example.puml

Options

• -p, --port

The port to use to serve the HTML page, defaults to: 8080.

Examples

These examples can be found here.

example.puml

The source Plant UML.

@startuml Example
Bob -> Alice : hello
@enduml

Compile files

Compiles example.png.

gopuml build -f png example/example.puml

Compiles example.svg.

gopuml build -f svg example/example.puml

Compiles example.txt.

gopuml build -f txt example/example.puml

     ┌───┐          ┌─────┐
     │Bob│          │Alice│
     └─┬─┘          └──┬──┘
       │    hello      │
       │──────────────>│
     ┌─┴─┐          ┌──┴──┐
     │Bob│          │Alice│
     └───┘          └─────┘

Generate links

Generates a link for the example.png.

gopuml build -f png --style link example/example.puml

Generates a link for the example.svg.

gopuml build -f svg --style link example/example.puml

Generates a link for the example.txt.

gopuml build -f txt --style link example/example.puml