3.4. UML Class Diagram

3.4.1. Attributes

>>> class Astronaut:
...     firstname: str
...     lastname: str

```mermaid
classDiagram

class Astronaut {
    firstname: str
    lastname: str
}
```

3.4.2. Methods Without Parameters

>>> class Astronaut:
...     def say_hello():
...         pass

```mermaid
classDiagram

class Astronaut {
    say_hello()
}
```

3.4.3. Methods With Parameters

>>> class Astronaut:
...     def say_hello(firstname: str, lastname: str):
...         pass

```mermaid
classDiagram

class Astronaut {
    say_hello(firstname: str, lastname: str)
}
```

3.4.4. Method Return Type

>>> class Astronaut:
...     def say_hello() -> str:
...         pass

```mermaid
classDiagram

class Astronaut {
    say_hello() str
}
```

3.4.5. Abstract Methods

>>> from abc import abstractmethod, ABCMeta
>>>
>>>
>>> class Astronaut(metaclass=ABCMeta):
...     @abstractmethod
...     def say_hello():
...         pass

```mermaid
classDiagram

class Astronaut {
    say_hello()*
}
```

3.4.6. Static Methods

>>> class Astronaut:
...     @staticmethod
...     def say_hello():
...         pass

```mermaid
classDiagram

class Astronaut {
    say_hello()$
}
```

3.4.7. Types

>>> class Astronaut:
...     firstname: str
...     lastname: str
...
...     def say_hello(name: str) -> str:
...         pass

```mermaid
classDiagram

class Astronaut {
    firstname: str
    lastname: str

    say_hello(name: str) str
}
```

3.4.8. Access Modifiers

• + - Public

• - - Private

• # - Protected

• ~ - Package/Internal

3.4.9. Access Modifiers - Public

>>> class Astronaut:
...     firstname: str
...     lastname: str
...
...     def say_hello() -> str:
...         pass

```mermaid
classDiagram

class Astronaut {
    +firstname: str
    +lastname: str
    +say_hello() str
}
```

3.4.10. Access Modifiers - Protected

>>> class Astronaut:
...     _firstname: str
...     _lastname: str
...
...     def _say_hello() -> str:
...         pass

```mermaid
classDiagram

class Astronaut {
    #firstname: str
    #lastname: str
    #say_hello() str
}
```

3.4.11. Access Modifiers - Private

>>> class Astronaut:
...     __firstname: str
...     __lastname: str
...
...     def __say_hello() -> str:
...         pass

```mermaid
classDiagram

class Astronaut {
    -firstname: str
    -lastname: str
    -say_hello() str
}
```

3.4.12. Boxes and Arrows

3.4.13. Use Cases

3.4.14. Django

• GraphViz + Dot

• Django Extensions: https://django-extensions.readthedocs.io/en/latest/graph_models.html

3.4.15. Generate from code

• sphinx.ext.graphviz (from sphinx) - https://www.sphinx-doc.org/en/master/usage/extensions/graphviz.html

• pyreverse (from pylint) - https://www.logilab.org/blogentry/6883

• GraphModels (from django-command-extensions) - https://code.google.com/p/django-command-extensions/wiki/GraphModels

• epydoc - http://epydoc.sourceforge.net - http://epydoc.sourceforge.net/api/epydoc.apidoc.VariableDoc-class.html

• pynsource - http://pynsource.com/

• pyUML - https://sourceforge.net/projects/eclipse-pyuml/

• lumpy - http://www.greenteapress.com/thinkpython/swampy/lumpy.html

• ObjectDomain - http://www.objectdomain.com/products/od-features

• argouml-python - http://argouml-python.tigris.org/

• pywebuml - https://bitbucket.org/tzulberti/pywebuml

• uml-to-django - https://github.com/auvipy/uml-to-django

• Python Vipera - https://sourceforge.net/projects/pythonvipera/

• gaphor - https://github.com/gaphor/gaphor

• https://stackoverflow.com/questions/260165/whats-the-best-way-to-generate-a-uml-diagram-from-python-source-code

• https://modeling-languages.com/uml-tools/#python

$ pyreverse -o png -p mymodule .