Skip to content

PlantUML Animation

PyPI PyPI - Python Version PyPI - License

Simple animation for PlantUML diagrams.

Documentation: https://namuan.github.io/animate-puml

Source Code: https://github.com/namuan/animate-puml

PyPI: https://pypi.org/project/animate-puml/

Pre-requisites

Installation

pip install animate-puml

Usage

Given an example PlantUML document in assets/security.puml:

animate-puml -i assets/security.puml -o assets/security-puml.gif

By default, the script will delete any temporary files generated during the animation process. To keep the files, use the --debug flag.

animate-puml -i assets/security.puml -o assets/security-puml.gif --debug

Each frame of the animation will wait for 1 second by default. To change the wait time, use the --frame-duration flag to specify the time in milliseconds.

animate-puml -i assets/security.puml -o assets/security-puml.gif --frame-duration 4000

Use the -h flag to see all available options.

animate-puml -h

Acknowledgements

Development

  • Clone this repository
  • Requirements:
  • Python 3.7+

  • Poetry

  • Create a virtual environment and install the dependencies

poetry install
  • Activate the virtual environment
poetry shell

Validating build

make build

Release process

A release is automatically published when a new version is bumped using make bump. See .github/workflows/build.yml for more details. Once the release is published, .github/workflows/publish.yml will automatically publish it to PyPI.

Disclaimer

This project is not affiliated with PlantUML.