npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

plantuml-pipe

v1.6.0

Published

Generate multiple PlantUML diagrams with one JAVA process

Downloads

5,938

Readme

NPM Version Donate

plantuml-pipe

A PlantUmlPipe instance is a wrapper to a PlantUML JAVA process running in pipe mode.

The object has an input stream (in) into which the PlantUML code of multiple diagrams can be written and an output streams (out) from which the generated diagrams can be read.

Instead of the streams you can also use the process method of the object which returns a promise with the generated diagram.

Installation

This module can be installed using npm:

$ npm install plantuml-pipe

Note: JAVA and Graphviz must be installed on your system in order to use this module. A corresponding test is run after installing this module.

This module includes type definitions for TypeScript.

Usage (with streams)

The following TypeScript code creates two SVG image files using streams:

import * as fs from "fs";
import { PlantUmlPipe } from "plantuml_pipe";

const puml = new PlantUmlPipe();

let fileCounter = 0;
puml.out.on("data", (chunk: string) => {
    fs.writeFileSync("./" + fileCounter + ".svg", chunk);
    ++fileCounter;
});

puml.in.write("@startuml\n");
puml.in.write("Buzz -> Woody : To infinity... and beyond!\n");
puml.in.write("@enduml\n");
puml.in.write("@startuml\n");
puml.in.write("Woody -> Buzz : Howdy partner!\n");
puml.in.write("@enduml\n");
puml.in.end();

Output:

| First image (0.svg) | Second image (1.svg) | | :---------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------: | | First image | Second image |

Usage (with promises)

The following TypeScript code creates the same two SVG image files using promises:

import * as fs from "fs";
import { PlantUmlPipe } from "plantuml_pipe";

const puml = new PlantUmlPipe();

const buzzPlantUml = "@startuml\nBuzz -> Woody : To infinity... and beyond!\n@enduml";
const woodyPlantUml = "@startuml\nWoody -> Buzz : Howdy partner!\n@enduml";

puml.process(buzzPlantUml).then((imageData) => {
    fs.writeFileSync("./1.svg", imageData);
});

puml.process(woodyPlantUml).then((imageData) => {
    fs.writeFileSync("./2.svg", imageData);
});

puml.close();

Options

The PlantUmlPipe constructor can receive an options object as a parameter. It has the following members:

| Name | Description | Default | | ------------------ | -------------------------------------------------------------------------------------------- | ------------------------ | | jarPath | A string specifying the path to the PlantUML jar file that is used to generate the diagrams. | ../vendor/plantuml.jar | | outputFormat | A string specifying the output format of the generated diagrams. Possible values are: latex, latex:nopreamble, pdf, png, svg, txt, utxt and vdx. | svg | | delimiter | A string specifying the delimiter the PlantUML process should use so separate the image files in the output stream. You only need to set this value if the default value is used as text in your PlantUML code. But why would you do that, right? | ___PLANTUML_DIAGRAM_DELIMITER___ | | split | This option specifies if the PlantUmlPipe instance should automatically split the PlantUML output stream at the specified delimiter and emit one data event per generated image. You can set this option to false to deactivate this splitting and have full control over the output stream. | true | | includePath | A string specifying the path where the PlantUML process is going to look for files included in the PlantUML code. | . | | pixelCutOffValue | To prevent memory problems PlantUML limits the width and height of pixel (PNG) graphics to 4096. Use this option to set the PLANTUML_LIMIT_SIZE variable which overrides this value. | | | noErrorImages | By default when the PlantUML process encounters an error (eg: because of an error in your PlantUML code), it still generates an image which contains an error message. You can set this option to true to disable error image generation. You can then implement an error handling yourself using the normal data event of PlantUMLPipe's output stream. For every error the data chunk of the event is going to start with the line ERROR. | false | | javaOptions | A string array of options that are passed to the JAVA process. If you are generating many big diagrams it might be necessary to increase the maximum heap size of the JAVA process. You can use this property to do so - look here for more information on this issue. | | | plantUmlArgs | A string array of arguments that are passed to the PlantUML process as options. The PlantUML process has many options that you can set through the command line. Some of these options can be set directly using a property of the options argument you pass to the constructor of PlantUmlPipe - for example the delimiter property sets the -pipedelimitor "xyz" option. If there is no property for the option that you want to pass to the PlantUML process, you can use this property to do so. You can find the list of available PlantUML options here. | |

Bugs

Please report bugs here. Thanks for your contribution!

Donate

If you find this piece of software helpful, please consider a donation. Any amount is greatly appreciated.

Donate