Skip to main content

Simple entity relation (ER) diagrams generation

Project description

ERAlchemy generates Entity Relation (ER) diagram (like the one below) from databases or from SQLAlchemy models.

Example

Example for NewsMeme

Example for a graph

Example for NewsMeme

Quick Start

Install

To install ERAlchemy, just do:

$ pip install eralchemy

ERAlchemy requires GraphViz to generate the graphs and Python. Both are available for Windows, Mac and Linux.

Use from python

from eralchemy import render_er
## Draw from SQLAlchemy base
render_er(Base, 'erd_from_sqlalchemy.png')

## Draw from database
render_er("sqlite:///relative/path/to/db.db", 'erd_from_sqlite.png')

Use from the command line and a database

$ eralchemy -i sqlite:///relative/path/to/db.db -o erd_from_sqlite.pdf

Use from the command line and a markdown file.

$ curl 'https://raw.githubusercontent.com/Alexis-benoist/eralchemy/master/example/newsmeme.er' > markdown_file.er
$ eralchemy -i 'markdown_file.er' -o erd_from_markdown_file.pdf

Use from the command line with a Postgresql database to a markdown file excluding tables named temp and audit

$ eralchemy -i 'postgresql+psycopg2://username:password@hostname:5432/databasename' -o filtered.er -x temp audit

Use from the command line with a Postgresql database to a markdown file for the schema schema

$ eralchemy -i 'postgresql+psycopg2://username:password@hostname:5432/databasename' -s schema

Architecture

Architecture schema

Architecture schema

Thanks to it’s modular architecture, it can be connected to other ORMs/ODMs/OGMs/O*Ms.

Notes

Every feedback is welcome on the GitHub issues.

To run the tests, use : $ py.test.

ERAlchemy was inspired by erd, though it is able to render the ER diagram directly from the database and not just only from the ER markup language.

Released under an Apache License 2.0

Creator: Alexis Benoist [@Alexis_Benoist](https://twitter.com/Alexis_Benoist)

Project details


Download files

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

Source Distribution

ERAlchemy-0.0.31.tar.gz (8.8 kB view details)

Uploaded Source

File details

Details for the file ERAlchemy-0.0.31.tar.gz.

File metadata

  • Download URL: ERAlchemy-0.0.31.tar.gz
  • Upload date:
  • Size: 8.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for ERAlchemy-0.0.31.tar.gz
Algorithm Hash digest
SHA256 0ed613f5bace5e17d37ab1eee735db3e65fabbfa9c9b70ab786a89f0d6d0e339
MD5 9dfd4fb8c2b0809c6d44dbef97534d1d
BLAKE2b-256 87faa3dafd2d95776a2cb1ea6d3fcf112468d1e812753523c8044c515426aa9a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page