puml2code


PlantUML code generator (puml2code)

a command line utility that convert Plantuml -text file that represent class UML diagram to source code.
puml parser based on plantuml-code-generator but is rewritten with es6.

$3

Global installation brings puml2code command to PATH
``bash
$ npm i -g puml2code
`

Development installation
`bash
$ git clone https://github.com/jupe/puml2code.git
$ npm i
$ bin/puml2code -h
`

Running tests
`bash
$ npm test
`




$3

* CoffeeScript (coffeescript)
* C# (csharp)
* C++ (cpp)
* ECMAScript5 (ecmascript5)
* ECMAScript6 (ecmascript6) [default]
* Java (java)
* PHP (php)
* python (python)
* Ruby (ruby)
* TypeScript (typescript)

$3

* output: file per class/console
* template engine: handlebars
* puml parser engine: pegjs

Features supported per output language:

|Language|supported|docs|deps imports|
|--------|---------|---------|-------|
|Coffeescript|✓|||
|C#|✓|||
|C++|✓|✓||
|ECMAScript5|✓|||
|ECMAScript6|✓|✓|✓|
|Java|✓|||
|PHP|✓|||
|Python|✓|✓||
|Ruby|✓|||
|TypeScript|✓|||

Feature explanations:

|feature|notes|
|-------|----|
|supported|at least source code can be generated|
|docs|Documentation comments, eg python: docstring|
|deps imports|Try to detect dependencies and import them top of source files|

NOTE:

parser and code templates are not perfect. There is planty of cases that is not yet covered or supported. Basic scenarious should work.

$3

* If puml2code causes error like:
`
Error: line: 21 column: 3: SyntaxError: Expected "'", "--", "..", "__", "abstract ",
"class ", "hide empty members", "interface ", "namespace ", "note ", "skinparam", "title ",
[ \t], [#], [+], [A-Za-z_], [\-], [\n], [\r\n], [^ ,\n\r\t(){}], or [}] but "{" found.
`
it's most probably because PEG.js based grammar does not have support
for plantuml format you have in input file.

What should I do?

Please raise ticket with example plantuml file that does not work

* generated source code does not look like you expected

What should I do?

Please raise ticket with example plantuml file and generated source
code with some description how it should look like.


NOTE If you are able to create PR that solves your issue it would be even more wellcome.

$3

`
$ puml2code -h
Usage: puml2code [options]

Options:
-V, --version output the version number
-i, --input [file] input .puml file, or "stdin"
-l, --lang [lang] Optional output source code language (default: "ecmascript6")
-o, --out [path] Output path. When not given output is printed to console.
-h, --help output usage information

Supported languages: coffeescript, csharp, ecmascript5, ecmascript6, java, php, python, ruby, typescript

Examples:
$ puml2code -i input.puml -l ecmascript6
$ puml2code -h
Use DEBUG=puml2code env variable to get traces. Example:
$ DEBUG=puml2code puml2code -i input.puml
`

e.g.
`
$ puml2code -i myfile.puml

Scheduler.js:
// native modules
// 3rd party modules
// application modules
const Queue = require('./Queue');
const Resources = require('./Resources');


/**
* Class Scheduler
*/
class Scheduler {
/**
* TBD
*/
constructor(queue, resources) {
this._queue = query;
this._resoures = resources;
}

/**
* @param {Queue} queue TBD
*/
_test(queue) {
// TBD
}

/**
* @param {Queue} queue TBD
*/
__protected(queue) {
// TBD
}
}
``
See more output examples here

Tool logic

!logi

$3

MIT