This is a simple application to create and convert property graphs which are represented in flat yaml format.
The term property graph denotes an attributed, multi-relational graph. That is, a graph where the edges are labeled and both vertices and edges can have any number of key/value properties associated with them.
The utility parses the graph, and creates an output in dot format, which can be executed via the graphviz utility. This way, you can visualize your concepts, which are written in yaml as a DSL.
Fundamental concepts to model data:
Use nodes to represent entities—that is, the things that are of interest to you in your domain.
Use relationships to express the connections between entities and establish semantic context for each entity, thereby structuring the domain.
Use node properties to represent entity attributes, plus any necessary entity meta‐data, such as timestamps, version numbers, etc.
Use relationship properties to express the strength, weight or quality of a relationship, plus any necessary relationship metadata, such as timestamps, version numbers, etc.
Execute the following command:
npm install git+https://github.com/tombenke/proper.git
npm install git+https://github.com/tombenke/proper.git#
if you want to install a specific version, for example
v0.1.0 would look like this:
npm install git+https://github.com/tombenke/proper.git#v0.1.0
-g switch to install to the global modules repository, if you want to use the command line utilities as well.
Just simply clone the repository, and add the folder to the PATH.
The downloaded repository does not contain the packages required by the proper utility, so the have to be installed via the npm before the first run:
$ cd <proper-install-dir> $ npm update
To use the utility, execute the
proper.sh shell script
giving the graph file name as a parameter:
$ proper.sh graph.yml
The command will outputs the results to the standard output in dot format.
To get the final graphical results (for example in png format), execute a command like the following:
$ proper.sh concepts.yml > concepts.dot ; dot concepts.dot -Tpng > concepts.png
The graphviz utility has to be installed, in order to create graphics.
proper.sh there are some other small utilities, which converts files among
several formats, such as:
Each command has one parameter, that is the name of the input file. The results are written to the standard output:
jsonToMm.sh sample.json > sample.mm mmToJson.sh sample.mm > sample.json ymlToJson.sh sample.yml > sample.json
View the LICENSE file (MIT).