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
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
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0ed613f5bace5e17d37ab1eee735db3e65fabbfa9c9b70ab786a89f0d6d0e339 |
|
MD5 | 9dfd4fb8c2b0809c6d44dbef97534d1d |
|
BLAKE2b-256 | 87faa3dafd2d95776a2cb1ea6d3fcf112468d1e812753523c8044c515426aa9a |