Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/compose-viz/compose-viz
A compose file visualization tool that follows compose-spec and allows you to gernerate graph in several formats.
https://github.com/compose-viz/compose-viz
compose compose-files compose-spec compose-viz containers docker docker-compose graphviz graphviz-dot podmain-compose podman vizualization
Last synced: 1 day ago
JSON representation
A compose file visualization tool that follows compose-spec and allows you to gernerate graph in several formats.
- Host: GitHub
- URL: https://github.com/compose-viz/compose-viz
- Owner: compose-viz
- License: mit
- Created: 2022-05-02T07:20:51.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-04T01:16:56.000Z (about 2 months ago)
- Last Synced: 2024-12-15T10:06:35.935Z (9 days ago)
- Topics: compose, compose-files, compose-spec, compose-viz, containers, docker, docker-compose, graphviz, graphviz-dot, podmain-compose, podman, vizualization
- Language: Python
- Homepage: https://pypi.org/project/compose-viz/
- Size: 978 KB
- Stars: 53
- Watchers: 2
- Forks: 10
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[
![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![MIT License][license-shield]][license-url]
[![Issues][issues-shield]][issues-url]
[![Issues Closed][issues-closed-shield]][issues-closed-url]
Table of Contents
## About The Project
`compose-viz` is a compose file visualization tool that follows [compose-spec](https://github.com/compose-spec/compose-spec/blob/master/spec.md) 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](https://github.com/compose-spec/compose-spec/blob/master/spec.md) implementations (e.g. [docker-compose](https://github.com/docker/compose)/[podman-compose](https://github.com/containers/podman-compose)), then `compose-viz` is a great choice for you.
## Getting Started
### Prerequisities
#### Graphviz
You need to install [Graphviz](https://graphviz.org/download/) to generate graphs.
### Installation
#### Using `pip`
```
pip install compose-viz
```
#### Using `.whl`
See [releases](https://github.com/compose-viz/compose-viz/releases).
#### Docker Image
See [wst24365888/compose-viz](https://hub.docker.com/r/wst24365888/compose-viz/tags).
### Example
This example yml is from [docker compose beginner tutorial](https://github.com/docker/labs/blob/master/beginner/chapters/votingapp.md).
```bash
cd examples/voting-app/
# using python script
cpv -m svg docker-compose.yml
# using docker image
docker run --rm -it -v $(pwd):/in wst24365888/compose-viz -m svg docker-compose.yml
# using docker image in powershell
docker run --rm -it -v ${pwd}:/in wst24365888/compose-viz -m svg docker-compose.yml
```
And this is what the result looks like:
Check out the result [here](https://github.com/compose-viz/compose-viz/blob/main/examples/voting-app).
### Usage
`cpv [OPTIONS] INPUT_PATH`
### Options
| Option | Description |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-o, --output-filename FILENAME` | Output filename for the generated visualization file. [default: compose-viz] |
| `-m, --format FORMAT` | Output format for the generated visualization file. See [supported formats](https://github.com/compose-viz/compose-viz/blob/main/compose_viz/models/viz_formats.py). [default: png] |
| `-r, --root-service SERVICE_NAME` | Root of the service tree (convenient for large compose yamls) |
| `-l, --legend` | Include a legend in the visualization. |
| `-p, --no-ports` | Don't show ports. |
| `-s, --simple` | Output a more simple graph with no image names and only basename of sources. |
| `-v, --version` | Show the version of compose-viz. |
| `--help` | Show help and exit. |
## Roadmap
- [ ] Support more vizualization components.
See the [open issues](https://github.com/compose-viz/compose-viz/issues)
for a full list of proposed features (and known issues).
## 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!
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feat/amazing-feature`)
3. Commit your Changes with
[Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/)
4. Push to the Branch (`git push origin feat/amazing-feature`)
5. Open a Pull Request, **please select the `dev` branch as the target
branch**.
## License
Distributed under the MIT License. See
[LICENSE](https://github.com/compose-viz/compose-viz/blob/main/LICENSE)
for more information.
## Contact
### Author
- HSING-HAN, WU (Xyphuz)
- Mail me: [email protected]
- About me:
- GitHub:
### Project Link
-
[contributors-shield]: https://img.shields.io/github/contributors/compose-viz/compose-viz.svg?style=for-the-badge
[contributors-url]: https://github.com/compose-viz/compose-viz/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/compose-viz/compose-viz.svg?style=for-the-badge
[forks-url]: https://github.com/compose-viz/compose-viz/network/members
[stars-shield]: https://img.shields.io/github/stars/compose-viz/compose-viz.svg?style=for-the-badge
[stars-url]: https://github.com/compose-viz/compose-viz/stargazers
[issues-shield]: https://img.shields.io/github/issues/compose-viz/compose-viz.svg?style=for-the-badge
[issues-url]: https://github.com/compose-viz/compose-viz/issues
[issues-closed-shield]: https://img.shields.io/github/issues-closed/compose-viz/compose-viz.svg?style=for-the-badge
[issues-closed-url]: https://github.com/compose-viz/compose-viz/issues?q=is%3Aissue+is%3Aclosed
[license-shield]: https://img.shields.io/github/license/compose-viz/compose-viz.svg?style=for-the-badge
[license-url]: https://github.com/compose-viz/compose-viz/blob/main/LICENSE