plantuml-libs

Tested with PlantUML compiled Jar (Version 1.2021.3).

This is the version 2 of the library.

The version 1 of the library is available in the v1.x branch.

Presentation

This repository hosts a PlantUML lib which provides several packages. Each package focus on a particular technology/approach: Amazon Web Services (AWS), Azure, C4 Model or even EventStorming and more.

The repository hosts also two command lines utilities. The first one (glib) helps to generate packages, the second one (gdiag) helps to use the packages from external projects in order.

Contributing

Thanks for your interest in contributing! There are many ways to contribute to this project. Get started here.

PlantUML library

The resources can be browsed, from GitHub, with Markdown pages directly in the dist directory.

Ready? Show me the doc!.

The available packages:

• aws-20200430
• aws-20200911
• aws-20210131
• azure-v2
• c4model
• eip
• eventstorming
• fontawesome-5.15
• gcp
• homecloud
• material-4.0
• simpleicons-4

Usage

The library can be directly used remotely hitting the GitHub repository.

However, the performances are not good enough for intensive usage. In this case, the library should be installed locally and use directly from the file system.

To help the local installation, an NPM package is available.

Usage of the NPM package

The NPM package @tmorin/plantuml-libs provides the CLI commands as well as the packages The CLI commands managed them-self the download of the PlantUML jar.

Install the NPM package globally:

npm i -g @tmorin/plantuml-libs

Show the gdiag help output:

gdiag --help

gdiag

Render PlantUML diagrams discovered (*.{puml,plantuml}) in the working
directory.

Options:
      --version                 Show version number                    [boolean]
      --work-directory, --wd    The directory where the PlantUML files will be
                                discovered and rendered. [string] [default: "."]
      --tech-directory, --td    The directory where technical resources will be
                                stored.             [string] [default: ".gdiag"]
      --lib-directory, --ld     The directory where the library is located.
  [string] [default: "<Depend of the host>/node_modules/@tmorin/plantuml-libs/"]
      --java-command, --jc      The command of the java binary.
                                                      [string] [default: "java"]
      --plantuml-version, --pv  The version of PlantUML to use.
                                                  [string] [default: "1.2020.9"]
      --log-level, --ll         The level of the logs.
         [string] [choices: "error", "warn", "info", "http", "verbose", "debug",
                                                      "silly"] [default: "info"]
  -c, --clean                   Delete recursively the pictures located in the
                                working directory.    [boolean] [default: false]
      --help                    Show help                              [boolean]