GGraph

web service for generate image with graphviz dot language

Requirement

python >= 3.4
graphviz

Instalation

git clone https://github.com/natir/ggraph.git

pip install -r requirements.txt

For test instalation you can run :

make run PORT=[port number default 8080]

Usage

Service is provide at this adresse : http://ggraph.pierre.marijon.fr/

You can try some exemple url :

node a to b
node a to b png version
[complex graph](http://ggraph.pierre.marijon.fr/dot/svg/digraph{ fontname = "Bitstream Vera Sans"; fontsize = 8; node [fontname = "Bitstream Vera Sans";fontsize = 8;shape = "record";]; edge [fontname = "Bitstream Vera Sans";fontsize = 8;]; Sequence [label = "{Sequence | +data : string \l +comment : string \l| + gc() : float}"]; Genome [label = "{Genome | +seqs : Sequence[] \l +annotation : Annotation \l}"]; Sequence -> Genome; })

In markdown you need escape , ( and ) charactere with , exemple :

[complex graph](http://ggraph.pierre.marijon.fr/dot/svg/digraph{
fontname = "Bitstream Vera Sans";
fontsize = 8;
node [fontname = "Bitstream Vera Sans";fontsize = 8;shape = "record";];
edge [fontname = "Bitstream Vera Sans";fontsize = 8;];
Sequence [label = "{Sequence | +data : string \\l +comment : string \\l | +gc\(\) : float}"];
Genome [label = "{Genome | +seqs:Sequence[] \\l +annotation:Annotation}"];
Sequence -> Genome;
})

The list of avaible:

engine in json format
output format in json format

Production setup

For run ggraph in production you can use this configuration file.

Systemd

[Unit]
Description=SVG graph generator
After=network.target
Requires=network.target

[Service]
User=youruser
Group=yourgroup
WorkingDirectory=/path/to/ggraph
Environement="PATH=/path/to/ggraph/env/bin"
ExecStart=/path/to/ggraph/env/bin/gunicorn --workers 3 -bind unix:ggraph.sock -m 007 ggraph:app
Restart=always

[Install]
WantedBy=multi-user.target

nginx

server
{
	listen 80;

    server_name ggraph.hostname;

    location /
	{
		proxy_set_header Host $http_host;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header X-Forwarded-Proto $scheme;
		proxy_pass http://unix:/path/to/ggraph/ggraph.sock;
	}
}

Contribute

Please fork and propose pull requests.

Bug

You can report bug on github

dridk/ggraph