Metadata-Version: 2.1
Name: tabulatedockerps
Version: 0.1.0
Summary: Script Python que formata em tabela a saída do `docker ps`
Home-page: https://github.com/viniciusccosta/TabulateDockerPS
License: MIT
Keywords: docker,tabulate,command-line,cli
Author: viniciusccosta
Author-email: viniciusccosta95@gmail.com
Requires-Python: >=3.12,<3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: debugpy (>=1.8.5,<2.0.0)
Requires-Dist: tabulate (>=0.9.0,<0.10.0)
Project-URL: Repository, https://github.com/viniciusccosta/TabulateDockerPS
Description-Content-Type: text/markdown

# TabulateDockerPS

TabulateDockerPS é um script Python que transforma a saída do comando docker ps em uma tabela formatada utilizando a biblioteca tabulate. Isso permite que a saída seja visualmente mais organizada e de fácil leitura. O script é simples de usar e pode ser instalado via pipx, tornando-o fácil de integrar em qualquer ambiente de desenvolvimento que utilize Docker.

## Uso

Para utilizar o script, simplesmente redirecione a saída do comando `docker ps` para o script Python:

```bash
docker ps | python tabulatedockerps/tdps.py [--debug] [--format FORMAT]
```

ou, caso instalado com PIPX:

```bash
docker ps | tdps [--debug] [--format FORMAT]
```

## Exemplo de Saída

Ao executar o comando docker ps e passar a saída para o script TabulateDockerPS, você obtém uma tabela formatada como no exemplo abaixo:

```bash
$ docker ps | tdps

+----------------+---------+--------------------------+----------------+---------------+------------------------+
| CONTAINER ID   | IMAGE   | COMMAND                  | CREATED        | STATUS        | PORTS                  |
+================+=========+==========================+================+===============+========================+
| 874ace075081   | ubuntu  | "bash -c 'while true…"   | 37 minutes ago | Up 37 minutes | 0.0.0.0:8080->8080/tcp |
|                |         |                          |                |               | 0.0.0.0:80->80/tcp     |
+----------------+---------+--------------------------+----------------+---------------+------------------------+
```

## Formatos Suportados

O TabulateDockerPS suporta todos os formatos de saída oferecidos pela biblioteca tabulate. Isso inclui, mas não se limita a:

- plain
- grid
- pipe
- orgtbl
- jira
- presto
- pretty
- html
- latex

Para uma lista completa de formatos, consulte a documentação do [tabulate](https://pypi.org/project/tabulate/).

## Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues e pull requests para melhorias ou correções.

## Licença

Este projeto é distribuído sob a licença MIT. Para mais detalhes, consulte o arquivo LICENSE

