Skip to content

Commit

Permalink
Add UML diagrams for overview of the codebase
Browse files Browse the repository at this point in the history
  • Loading branch information
drbenvincent committed Apr 11, 2023
1 parent 09958f7 commit 4f95997
Show file tree
Hide file tree
Showing 4 changed files with 18 additions and 1 deletion.
16 changes: 16 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ pip install -e .
pip install causalpy[dev]
pip install causalpy[docs]
pip install causalpy[test]
pip install causalpy[lint]
```

If that fails, try:
Expand All @@ -36,6 +37,7 @@ If that fails, try:
pip install 'causalpy[dev]'
pip install 'causalpy[docs]'
pip install 'causalpy[test]'
pip install 'causalpy[lint]'
```

It may also be necessary to [install](https://pandoc.org/installing.html) `pandoc`. On a mac, I run `brew install pandoc`.
Expand Down Expand Up @@ -114,3 +116,17 @@ python3 -m twine upload dist/*
5. Readthedocs:
- Docs should be built remotely every time there is a pull request
- See here https://docs.readthedocs.io/en/stable/tutorial/#versioning-documentation for versioning the docs

## Overview of code structure

UML diagrams can be created with the command below. If you have not already done so, you may need to `pip install 'causalpy[lint]'` in order to install `pyreverse`.

```bash
pyreverse -o png causalpy --output-directory img
```

Classes
![](img/classes.png)

Packages
![](img/packages.png)
Binary file added img/classes.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/packages.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 2 additions & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,8 @@ lint = ["black",
"interrogate",
"isort",
"nbqa",
"pre-commit"
"pre-commit",
"pylint"
]
test = [
"pytest",
Expand Down

0 comments on commit 4f95997

Please sign in to comment.