# 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": "<3.13,>=3.12",
"maintainer_email": null,
"keywords": "docker, tabulate, command-line, cli",
"author": "viniciusccosta",
"author_email": "viniciusccosta95@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/54/2e/5049735bc6899ba1eb8bd756c5d99156e21bfa98ffe1a33e05c6c667ab4c/tabulatedockerps-0.1.1.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.1.1",
"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": "3b83cb77a1e095586040c015476f31fabd30a5460faaace4c04bceb768eb4589",
"md5": "438e5614aba5272007ef82be4ed0b66f",
"sha256": "941acf4f828ad72e80d1d3dde96dac01e99833ba4092e5171652b3906893765d"
},
"downloads": -1,
"filename": "tabulatedockerps-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "438e5614aba5272007ef82be4ed0b66f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.12",
"size": 4696,
"upload_time": "2024-08-22T21:11:24",
"upload_time_iso_8601": "2024-08-22T21:11:24.769894Z",
"url": "https://files.pythonhosted.org/packages/3b/83/cb77a1e095586040c015476f31fabd30a5460faaace4c04bceb768eb4589/tabulatedockerps-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "542e5049735bc6899ba1eb8bd756c5d99156e21bfa98ffe1a33e05c6c667ab4c",
"md5": "bb6242a6a266eab5cf85fe3f3e627353",
"sha256": "37a2b14dde0e2c116d0ad2a02c6b8a8934e706b03a1d0c23c366dcc3084fb2f0"
},
"downloads": -1,
"filename": "tabulatedockerps-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "bb6242a6a266eab5cf85fe3f3e627353",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.12",
"size": 3980,
"upload_time": "2024-08-22T21:11:26",
"upload_time_iso_8601": "2024-08-22T21:11:26.139372Z",
"url": "https://files.pythonhosted.org/packages/54/2e/5049735bc6899ba1eb8bd756c5d99156e21bfa98ffe1a33e05c6c667ab4c/tabulatedockerps-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-22 21:11:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "viniciusccosta",
"github_project": "TabulateDockerPS",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "tabulatedockerps"
}
JSON
