1.1.3 • Published 2 years ago

javatopuml v1.1.3

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

javatopuml

Tool to create PlantUML Class-Diagrams from Java Code.

Usage

  1. Install globally

    • npm:
      npm install javatopuml --global
    • yarn:
      yarn global add javatopuml
  2. Invoke in any Java Project

    javatopuml

    or with options:

    javatopuml [--path=INPUT_PATH; default: .] \
        [--output=OUTPUT_PATH; default: ./target/puml] \
        [--format=OUTPUT_FORMAT; default: puml] \
        [--linkbyfields={true | false}; default: true] \
        [--inheritance={true | false}; default: true]

    ⇒ The results will be saved in target/plantuml

Positionals:
  packages                                                               [array]

Options:
  --help          Show help                                            [boolean]
  --version       Show version number                                  [boolean]
  --path          The path of the java project
                                           [string] [default: current directory]
  --output                                   [string] [default: "./target/puml"]
  --format                                            [string] [default: "puml"]
  --linkbyfields                                       [boolean] [default: true]
  --inheritance                                        [boolean] [default: true]

Examples:
  javatopuml                         Generates a class diagram of the project
                                     the command is invoked in
  javatopuml my.super.nice.package   Generates a class diagram of the package,
                                     if it can be found in the current project
  javatopuml --format=txt            Outputs to <packagename>.txt instead of
                                     <packagename>.puml
  javatopuml --output=classdiagrams  Outputs to
                                     ./classdiagrams/<packagename>.puml instead
                                     of ./target/plantuml/<packagename>.puml

Options

optiondefault
packagesFully Qualified Names of the packages that should be rendered. If ommited, full project will be rendered.
pathcurrent directoryThe input path, where the Java project is to be found.
ouput./target/pumlThe output path of the diagram files.
formatpumlThe output format of the diagram files. Will always be textbased.
linkbyfieldstrueWether the tool should generate links between classes based on the fields types.
inheritancetrueWether the tool should generate links based on inheritance (extends & implements)

⚠️ known limitations

  • the code has only been tested with valid java code, and not extensively
  • records do not work yet.