# TabulateDockerPS
[](https://choosealicense.com/licenses/mit/)
[](https://www.python.org/downloads/release/python-3125/)
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.
## Instalação
```bash
pipx install tabulatedockerps
```
## Uso
Para utilizar o script, simplesmente redirecione a saída do comando `docker ps` para o script Python:
```bash
docker ps | tdps [--debug] [--format FORMAT]
```
## Exemplo de Saída
Ao executar o comando docker ps e passar a saída para o TabulateDockerPS, você obtém uma tabela formatada, com destaque para a coluna "Ports", que é dividida em várias linhas para facilitar a leitura dos múltiplos mapeamentos de portas. Veja o 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
Raw data
{
"_id": null,
"home_page": "https://github.com/viniciusccosta/TabulateDockerPS",
"name": "tabulatedockerps",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.7",
"maintainer_email": null,
"keywords": "docker, tabulate, command-line, cli",
"author": "viniciusccosta",
"author_email": "viniciusccosta95@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3a/4a/e60efdc6eff031b45b39f9e23b5ffbc3a3a8bcb3f1021b2e9b6b39a94766/tabulatedockerps-0.2.0.tar.gz",
"platform": null,
"description": "# TabulateDockerPS\n\n[](https://choosealicense.com/licenses/mit/)\n[](https://www.python.org/downloads/release/python-3125/)\n\nTabulateDockerPS \u00e9 um script Python que transforma a sa\u00edda do comando docker ps em uma tabela formatada utilizando a biblioteca tabulate. Isso permite que a sa\u00edda seja visualmente mais organizada e de f\u00e1cil leitura. O script \u00e9 simples de usar e pode ser instalado via pipx, tornando-o f\u00e1cil de integrar em qualquer ambiente de desenvolvimento que utilize Docker.\n\n## Instala\u00e7\u00e3o\n\n```bash\npipx install tabulatedockerps\n```\n\n## Uso\n\nPara utilizar o script, simplesmente redirecione a sa\u00edda do comando `docker ps` para o script Python:\n\n```bash\ndocker ps | tdps [--debug] [--format FORMAT]\n```\n\n## Exemplo de Sa\u00edda\n\nAo executar o comando docker ps e passar a sa\u00edda para o TabulateDockerPS, voc\u00ea obt\u00e9m uma tabela formatada, com destaque para a coluna \"Ports\", que \u00e9 dividida em v\u00e1rias linhas para facilitar a leitura dos m\u00faltiplos mapeamentos de portas. Veja o exemplo abaixo:\n\n```bash\n$ docker ps | tdps\n\n+----------------+---------+--------------------------+----------------+---------------+------------------------+\n| CONTAINER ID | IMAGE | COMMAND | CREATED | STATUS | PORTS |\n+================+=========+==========================+================+===============+========================+\n| 874ace075081 | ubuntu | \"bash -c 'while true\u2026\" | 37 minutes ago | Up 37 minutes | 0.0.0.0:8080->8080/tcp |\n| | | | | | 0.0.0.0:80->80/tcp |\n+----------------+---------+--------------------------+----------------+---------------+------------------------+\n```\n\n## Formatos Suportados\n\nO TabulateDockerPS suporta todos os formatos de sa\u00edda oferecidos pela biblioteca tabulate. Isso inclui, mas n\u00e3o se limita a:\n\n- plain\n- grid\n- pipe\n- orgtbl\n- jira\n- presto\n- pretty\n- html\n- latex\n\nPara uma lista completa de formatos, consulte a documenta\u00e7\u00e3o do [tabulate](https://pypi.org/project/tabulate/).\n\n## Contribui\u00e7\u00e3o\n\nContribui\u00e7\u00f5es s\u00e3o bem-vindas! Sinta-se \u00e0 vontade para abrir issues e pull requests para melhorias ou corre\u00e7\u00f5es.\n\n## Licen\u00e7a\n\nEste projeto \u00e9 distribu\u00eddo sob a licen\u00e7a MIT. Para mais detalhes, consulte o arquivo LICENSE\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Script Python que formata em tabela a sa\u00edda do `docker ps`",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/viniciusccosta/TabulateDockerPS",
"Repository": "https://github.com/viniciusccosta/TabulateDockerPS"
},
"split_keywords": [
"docker",
" tabulate",
" command-line",
" cli"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0ceab6ce4c73d5282e027d3de40aae6cdb7658a078995836ff0ef7210e153d34",
"md5": "8b2e0dc0aacea78e7d66e9774040713b",
"sha256": "7c71f094fa137f2f5146861406b0bf6f480a6c2763039c02bf349c5aac9cf8ae"
},
"downloads": -1,
"filename": "tabulatedockerps-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8b2e0dc0aacea78e7d66e9774040713b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.7",
"size": 4785,
"upload_time": "2025-03-18T19:40:44",
"upload_time_iso_8601": "2025-03-18T19:40:44.844001Z",
"url": "https://files.pythonhosted.org/packages/0c/ea/b6ce4c73d5282e027d3de40aae6cdb7658a078995836ff0ef7210e153d34/tabulatedockerps-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3a4ae60efdc6eff031b45b39f9e23b5ffbc3a3a8bcb3f1021b2e9b6b39a94766",
"md5": "1c3826f38049f4734bb3efd211408164",
"sha256": "79217842d2fa1595d9cb09644823fe1a7e51d4ee00595ddec1050d95ea53f4fd"
},
"downloads": -1,
"filename": "tabulatedockerps-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "1c3826f38049f4734bb3efd211408164",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.7",
"size": 3706,
"upload_time": "2025-03-18T19:40:46",
"upload_time_iso_8601": "2025-03-18T19:40:46.174943Z",
"url": "https://files.pythonhosted.org/packages/3a/4a/e60efdc6eff031b45b39f9e23b5ffbc3a3a8bcb3f1021b2e9b6b39a94766/tabulatedockerps-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-03-18 19:40:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "viniciusccosta",
"github_project": "TabulateDockerPS",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "tabulatedockerps"
}