compose-viz

No description

Find a file

Xyphuz 5495f3cd1f Merge pull request #21 from compose-viz/dev feat: new supported output formats		2022-05-26 11:13:32 +08:00
.github/workflows	chore: add new examples	2022-05-25 17:46:53 +08:00
compose_viz	feat: new supported output formats	2022-05-26 11:06:06 +08:00
examples	feat: new supported output formats	2022-05-26 11:06:06 +08:00
tests	fix: wrong expected value in tests	2022-05-26 11:10:19 +08:00
.gitignore	chore: add cpv results in examples	2022-05-25 17:55:52 +08:00
.pre-commit-config.yaml	chore: apply pre-commit hooks	2022-05-25 17:16:10 +08:00
LICENSE	chore: add LICENSE	2022-05-02 16:17:17 +08:00
poetry.lock	fix: missing dev dependency	2022-05-19 15:37:49 +08:00
pyproject.toml	feat: new supported output formats	2022-05-26 11:06:06 +08:00
README.md	chore: update example in README.md	2022-05-26 11:08:20 +08:00

README.md

Explore Usage »

Report Bug · Request Feature

Table of Contents

About The Project
Getting Started
- Prerequisities
- Installation
- Example
- Usage
- Options
Roadmap
Contributing
License
Contact

About The Project

compose-viz is a compose file visualization tool that supports compose-spec and allows you to gernerate graph in several formats.

If you are looking for a compose file vizualization tool, and you are using one of the compose-spec implementations (e.g. docker-compose/podman-compose), then compose-viz is a great choice for you.

(back to top)

Getting Started

Prerequisities

Graphviz

You need to install Graphviz to generate graphs.

Installation

Using `pip`

pip install compose-viz

Using `.whl`

See releases.

Example

This example yml is from docker compose beginner tutorial.

cd examples/voting-app/
cpv -m svg docker-compose.yml

And this is what the result looks like:

Check out the result here.

Usage

cpv [OPTIONS] INPUT_PATH

Options

Option	Description
`-o, --output-filename`	Output filename for the generated visualization file. [default: compose-viz]
`-m, --format`	Output format for the generated visualization file. See supported formats. [default: png]
`-v, --version`	Show the version of compose-viz.
`--help`	Show help and exit.

(back to top)

Roadmap

Support more vizualization components.

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!