grunt-scruffy
v1.0.3
Published
Grunt task to generate images from yuml diagram sources by scruffy
Downloads
16
Maintainers
Readme
grunt-scruffy
This module provides a grunt multi-task generating images from yuml diagram sources using scruffy.
If you generate HTML technical documention from textual sources, you may want to maintain only sources of UML diagrams in your repository and generate the pictures only during the documentation build. You will be able to do changes easily, without committing both diagram sources and pictures and sychronizing them manually.
If you want to just quickly convert a yuml source file to a picture, you can use the scruffy command-line tool, which this task is based on.
Installation
You need node >= 4, npm and grunt >= 0.4 installed and your project build managed by a Gruntfile with the necessary modules listed in package.json. If you haven't used Grunt before, be sure to check out the [Getting Started] guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may ensure native dependencies of this plugin and install it:
- Install pre-requisites of scruffy depending on your operating system (Python 2.7, OSX and Ubuntu tested):
$ sudo apt install graphviz plotutils imagemagick librsvg2-bin \
python2.7 python-pip
$ pip install --user -U pip
$ pip install --user 'django<2.0'
$ pip install --user image scruffy
- Install the Grunt task:
$ npm install grunt-scruffy --save-dev
Configuration
Add the scruffy
entry with the scruffy task configuration to the
options of the grunt.initConfig
method:
grunt.initConfig({
scruffy: {
one: {
files: {
'dist/doc/images/diagram.png': ['doc/images/diagram.yuml']
}
},
all: {
src: ['doc/images/*.classses.yuml']
dest: 'dist/doc/images'
}
}
});
The configuration consists of key-value pairs with the output image path as a key pointing to the yuml input file. If you specify more source files by wildcards, the destination should be a directory; the source file extension wil lbe replaced by the output format in the output file name.
Then, load the plugin:
grunt.loadNpmTasks('grunt-scruffy');
Build
Call the scruffy
task:
$ grunt scruffy
or integrate it to your build sequence in Gruntfile.js
:
grunt.registerTask('default', ['scruffy', ...]);
Customizing
Default behaviour of the task can be tweaked by the task options; these are the defaults:
grunt.initConfig({
scruffy: {
one: {
files: {
'dist/doc/images/diagram.png': ['doc/images/diagram.yuml']
},
options: {
scruffy: true,
shadow: false,
type: 'class', // class|sequence
format: 'png', // png|svg
fontFamily: 'Purisa'
}
}
}
});
See the parameters of the command-line scruffy tool
or run suml --help
for more information.
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.
Release History
- 2018-04-27 v1.0.0 Dropped support of Node.js 4
- 2017-02-23 v0.2.1 Update dependencies
- 2016-26-08 v0.2.0 Upgrade to Grunt 1.x
- 2016-03-05 v0.1.1 Update dependencies, improve build testing
- 2016-01-10 v0.1.0 Initial release
License
Copyright (c) 2016-2019 Ferdinand Prantl
Licensed under the MIT license.