Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Pyagram: Diagram Generator

Project Description

Diagram Generator

This is a command line tool, which generates finite state machine diagram for web and mobile application development from a source file through graphviz.

The finite state machine diagram is a kind of diagram, which describes screen transitions and flows of the processes.

The source file is written in a specific format, which enables us to write a code easier than using only graphviz, since Pyagram generates graphviz code as an intermediate file.

Since graphviz provides 3 kinds of image formats, such as gif, png and svg, Pyagram provides these kinds of file format as well.

There are several kinds of objects in the diagram.

  • Title of a diagram
  • Double circle represents a view.
  • Gray background circle represents a server side process including action.
  • Dashed arrow represents a screen transition between views.
  • Straight arrow represents flow of the process, such as accepting a request, validation, database access and so on.
  • Straight arrow is able to have an label, which describes an action and a result of the process, such as clicking a button, success, error and so on.

How to write source file

Firstly you can define a title of the diagram with @ sign.

@[title] CRUD View Diagram

Next you can define views with # sign and its screen transitions with –> sign.

Now we have 3 views, such as List View, Add View and Server Error View.

List View and Add View are connected one another.

You can define its own path below the view name as well.

I highly recommend you to define those views first, since that would help you when you are trying to define server processes as a guide.

#[List View] /index

—> Add View

#[Add View] /add

—> List View

–> Add View

#[Server Error]

Then you can define server processes with ==> sign connecting source process and destination process.

As you can see, process is able to have multiple flows. Each flow has its own destination.

You can add results of the processes, such as Valid, Invalid, Success, Database Error and so on. It will be used as labels placed beside the straight arrows.

$[GET /index] ==> List View

$[GET /add] ==> Add View

$[POST /add] ==> Validate

$[Validate] Valid ==> Save

Invalid ==> Add View

$[Save] ==> Add View

$[Save] Success ==> List View

Database error ==> Server Error

Now that you can define the flows between the views and the processes with ==> sign.

#[List View] /index

—> Add View

Click add button ==> GET /add

#[Add View] /add

—> List View

–> Add View

Click back button ==> GET /index

Click submit button ==> POST /add

How to install

pip3 command installs depending library, such as pyparsing automatically.

After the installation, executable pyagram command will be placed in a bin directory, such as /usr/local/bin/pyagram.

pip3 install pyagram

How to execute

pyagram command accepts 2 kinds of options.

t option represents image type, which accepts gif, png and svg.

d option represents diagram type, which accepts std and erd.

f option represents font name, which accepts font names in your operation system if it exists or uses default font.

o option represents output path, which accepts path.

i option represents source file, which accepts text file.

v option represents verbose mode, which prints various information useful for debugging.

Output file is placed in the same place as the source file.

pyagram -t {image type} -d {diagram type} -f {font name} -o {output path} -i {source file}
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pyagram-1.4.3.macosx-10.11-x86_64.tar.gz (11.1 kB) Copy SHA256 Checksum SHA256 any Dumb Binary Aug 6, 2016
pyagram-1.4.3-py3.5.egg (14.4 kB) Copy SHA256 Checksum SHA256 3.5 Egg Aug 6, 2016
pyagram-1.4.3.tar.gz (6.4 kB) Copy SHA256 Checksum SHA256 Source Aug 6, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting