| Name | dockumentor JSON |
| Version |
0.1.2
JSON |
| download |
| home_page | None |
| Summary | Dockumentor is a Python utility that automates the generation of detailed documentation for Docker Compose projects. It interprets Docker Compose configurations to produce visual diagrams and markdown documentation, leveraging Mermaid diagrams and Jinja2 templates to provide clear and customizable representations of service architectures. Ideal for development teams and educators, Dockumentor streamlines the process of maintaining accurate and visual documentation for Docker environments. |
| upload_time | 2024-12-10 18:06:36 |
| maintainer | None |
| docs_url | None |
| author | Lucian BLETAN |
| requires_python | <4.0,>=3.8 |
| license | MIT |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
### Dockumentor: Docker Compose Documentation Generator
**Dockumentor** is a tool designed to automatically generate comprehensive documentation for Docker Compose configurations.
#### Features:
- **Mermaid Diagram Generation:** Automatically generate Mermaid diagrams that visually map the service relationships and network configurations.
- **Sankey Diagrams for Network and Dependency Insights:** Visualize network ports and service dependencies through Sankey diagrams to better understand internal and external bindings and service interactions.
- **Template-based Documentation:** Customize documentation output using Jinja2 templates, allowing for flexibility in how information is presented.
- **CLI Support:** Comes with a command-line interface to easily generate and update documentation directly from the terminal.
- **Configurable:** Easily adaptable to include more detailed information such as volume mappings, environment variables, and custom commands through a simple YAML configuration.
#### Ideal for:
- Developers looking to automate the documentation of their Docker environments.
- Teams requiring consistent and updated documentation for development, testing, and production setups.
- Educators and trainers who provide tutorials or workshops on Docker and need clear, visual representations of complex configurations.
By simplifying the documentation process, **Dockumentor** helps you focus more on development and less on the manual effort of maintaining up-to-date documentation of your Docker setups.
## Installation
To install Dockumentor, you can use pip, the Python package manager. Make sure you have Python and pip installed on your system. Then run the following command:
```bash
pip install dockumentor
```
## Usage
Once installed, you can use the Dockumentor CLI to generate a README for your project with Docker Compose.
### Generating Documentation
To generate a README for a project with a Docker Compose configuration, navigate to your project directory and run the following command:
```bash
dockumentor --compose-file path/to/docker-compose.yml --output README.md
```
- `--compose-file`: Specify the path to your `docker-compose.yml` file.
- `--output`: Specify the path to the output file (e.g., `README.md`). This is where the generated documentation will be written.
### Example Command
```bash
dockumentor --compose-file ./docker-compose.yml --output ./README.md
```
### Appending to Existing Documentation
If you want to append the generated documentation to an existing README file, use the `--append` option:
```bash
dockumentor --compose-file ./docker-compose.yml --output ./README.md --append
```
This will insert the generated documentation within specific markers in the existing README file, ensuring that the new content is added without overwriting the existing content.
### Customizing the Template
Dockumentor uses Jinja2 templates to format the generated documentation. You can customize the template to match your project's documentation style. Create a custom template file and specify its path using the `--template` option.
#### Example Command with Custom Template
```bash
dockumentor --compose-file ./docker-compose.yml --template ./templates/dockumentor_compose.md --output ./README.md
```
This command specifies a custom template for generating the documentation. If you don't specify a template, Dockumentor will use a default template.
## Author
- [Lucian BLETAN](https://github.com/gni)
Raw data
{
"_id": null,
"home_page": null,
"name": "dockumentor",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Lucian BLETAN",
"author_email": "neuraluc@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/32/38/19e8c2af438646853a495138b9f8af83ad69831eae07fe1b4ec45f0247ca/dockumentor-0.1.2.tar.gz",
"platform": null,
"description": "### Dockumentor: Docker Compose Documentation Generator\n\n**Dockumentor** is a tool designed to automatically generate comprehensive documentation for Docker Compose configurations.\n\n#### Features:\n- **Mermaid Diagram Generation:** Automatically generate Mermaid diagrams that visually map the service relationships and network configurations.\n- **Sankey Diagrams for Network and Dependency Insights:** Visualize network ports and service dependencies through Sankey diagrams to better understand internal and external bindings and service interactions.\n- **Template-based Documentation:** Customize documentation output using Jinja2 templates, allowing for flexibility in how information is presented.\n- **CLI Support:** Comes with a command-line interface to easily generate and update documentation directly from the terminal.\n- **Configurable:** Easily adaptable to include more detailed information such as volume mappings, environment variables, and custom commands through a simple YAML configuration.\n\n#### Ideal for:\n- Developers looking to automate the documentation of their Docker environments.\n- Teams requiring consistent and updated documentation for development, testing, and production setups.\n- Educators and trainers who provide tutorials or workshops on Docker and need clear, visual representations of complex configurations.\n\nBy simplifying the documentation process, **Dockumentor** helps you focus more on development and less on the manual effort of maintaining up-to-date documentation of your Docker setups.\n\n## Installation\n\nTo install Dockumentor, you can use pip, the Python package manager. Make sure you have Python and pip installed on your system. Then run the following command:\n\n```bash\npip install dockumentor\n```\n\n## Usage\n\nOnce installed, you can use the Dockumentor CLI to generate a README for your project with Docker Compose.\n\n### Generating Documentation\n\nTo generate a README for a project with a Docker Compose configuration, navigate to your project directory and run the following command:\n\n```bash\ndockumentor --compose-file path/to/docker-compose.yml --output README.md\n```\n\n- `--compose-file`: Specify the path to your `docker-compose.yml` file.\n- `--output`: Specify the path to the output file (e.g., `README.md`). This is where the generated documentation will be written.\n\n### Example Command\n\n```bash\ndockumentor --compose-file ./docker-compose.yml --output ./README.md\n```\n\n### Appending to Existing Documentation\n\nIf you want to append the generated documentation to an existing README file, use the `--append` option:\n\n```bash\ndockumentor --compose-file ./docker-compose.yml --output ./README.md --append\n```\n\nThis will insert the generated documentation within specific markers in the existing README file, ensuring that the new content is added without overwriting the existing content.\n\n### Customizing the Template\n\nDockumentor uses Jinja2 templates to format the generated documentation. You can customize the template to match your project's documentation style. Create a custom template file and specify its path using the `--template` option.\n\n#### Example Command with Custom Template\n\n```bash\ndockumentor --compose-file ./docker-compose.yml --template ./templates/dockumentor_compose.md --output ./README.md\n```\n\nThis command specifies a custom template for generating the documentation. If you don't specify a template, Dockumentor will use a default template.\n\n## Author\n\n- [Lucian BLETAN](https://github.com/gni)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Dockumentor is a Python utility that automates the generation of detailed documentation for Docker Compose projects. It interprets Docker Compose configurations to produce visual diagrams and markdown documentation, leveraging Mermaid diagrams and Jinja2 templates to provide clear and customizable representations of service architectures. Ideal for development teams and educators, Dockumentor streamlines the process of maintaining accurate and visual documentation for Docker environments.",
"version": "0.1.2",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "49fc477fab1e4011729da31532eef02e8bb66efa89c6b7c056ca3955c00eff1f",
"md5": "876433302d199c8ab89694ff78005a1e",
"sha256": "ebb3c2eecab895f44241353908162456cf43dea624887aeda9916b753826b597"
},
"downloads": -1,
"filename": "dockumentor-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "876433302d199c8ab89694ff78005a1e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 6904,
"upload_time": "2024-12-10T18:06:34",
"upload_time_iso_8601": "2024-12-10T18:06:34.916089Z",
"url": "https://files.pythonhosted.org/packages/49/fc/477fab1e4011729da31532eef02e8bb66efa89c6b7c056ca3955c00eff1f/dockumentor-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "323819e8c2af438646853a495138b9f8af83ad69831eae07fe1b4ec45f0247ca",
"md5": "a47322d35534f068c34878a0f3195a1e",
"sha256": "e65f4823f7d4655dcea89611943deca084c4dfbc8270cf497d4ff209127295c4"
},
"downloads": -1,
"filename": "dockumentor-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "a47322d35534f068c34878a0f3195a1e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 5825,
"upload_time": "2024-12-10T18:06:36",
"upload_time_iso_8601": "2024-12-10T18:06:36.157257Z",
"url": "https://files.pythonhosted.org/packages/32/38/19e8c2af438646853a495138b9f8af83ad69831eae07fe1b4ec45f0247ca/dockumentor-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-10 18:06:36",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "dockumentor"
}
