py-mermaider
is a tool written in Rust designed to generate mermaid.js class diagrams from Python code. By analyzing Python code, py-mermaider
automatically generates mermaid.js-compatible diagrams that represent the class structures, including classes, methods, attributes, and their relationships. This tool aims to simplify the documentation process for Python projects, making it easier to visualize class hierarchies and relationships.
- Automatic Class Diagram Generation: Generate detailed class diagrams from Python codebases with minimal configuration.
- Mermaid.js Compatibility: Outputs diagrams in mermaid.js markdown syntax, ready to be embedded in your markdown documents or rendered using mermaid.js tools. GitHub supports this natively as you'll see below!
Ensure you have Rust installed on your system. This project is not currently available as a crate or binary, so it'll have to be compiled on your machine with cargo build --release
. You'll find the executable in ./target/release/
pymermaider [FLAGS] <path>
Where <path>
is either a directory, or Python file (.py
or .pyi
). A directory will be recursively resolved.
-m
, shorthand for--multiple-files
. When used with a directory, each file will be made into their own markdown file.
NOTES:
- Currently, all markdown files will be written to
./output/
with the name of the processed file. - Some codebases are so massive that processing the directory into one file will result in mermaid code that's too large to render. By default, it's 50,000 characters. This is a good reason for the
-m
flag. You can break class diagrams apart more easily into multiple renderings.
Given a Python file example.py
with the following content:
class Animal:
def __init__(self, name: str) -> None:
self.name = name
class Dog(Animal):
def bark(self) -> str:
return "Woof!"
Running py-mermaider on this file will provide:
classDiagram
class Animal {
- __init__(self, name) None
}
class Dog {
+ bark(self) str
}
Dog --|> Animal
- Output directory option
- Better output file naming convention
- Import resolution (sorta-kinda implemented now, but not good enough or even used yet)
- More language support, maybe?? 😳🤔
- Sort classes with relationships to be grouped together
- methods with property-setter decorators can be confusing in the output
Contributions are more than welcome, just make a PR and we'll go from there!
This project is licensed under the MIT license. Please see the LICENSE file for more details.