Skip to content

grmartin/godoc2puml

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

godoc2puml

godoc2puml converts godoc formatted documentation into plantuml format.

Installation

Just type the following to install the program:

$ go get -u github.com/t-yuki/godoc2puml

If you want to draw a diagram as a image file, it depends on java and graphviz. you must install them:

$ sudo yum install java graphviz
$ # or, etc...
$ sudo apt-get install java graphviz

It also depends on plantuml. Well, it is already attached so you do not need to install separately.

Usage

godoc2puml generates a diagram for packages. You can also specify output format if you installed the above.

$ godoc2puml net/http > net.http.puml
$ java -jar plantuml.jar -pipe -tpng < net.http.puml > net.http.png

$ # NOT IMPLEMENTED YET # godoc2puml -t=png net/http > net.http.png

Other options:

Usage of godoc2puml:
  -t="puml": output format
        puml:  write PlantUML format.
  -h=false: show this help

Examples

The below is output example of "image" package. For more examples, see #1

image

Known Problems

Many, but...

  • enum pattern is not recognized
  • noisy
  • elementType of map is not recognized as an association
  • interface extensions is recognized only when explicit extensions, not implicit extension
  • cant parse array- or nested-pointer- embed structs
  • cant detect constructors
  • ...

References

Authors

About

godoc to PlantUML format converter for golang

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 99.8%
  • C 0.2%