caze-tools 0.2.0

Command-line dev tools by Daniel Caze (dsscaze)

caze-tools 🧰

Uma coleção de ferramentas de linha de comando (CLI) para auxiliar em tarefas comuns de desenvolvimento. Criado por Daniel Caze (dsscaze).

O que é?

caze-tools (ou simplesmente cz) é uma CLI projetada para automatizar e simplificar rotinas de desenvolvimento, como criar estruturas de projetos, gerar representações de diretórios e mesclar arquivos de código-fonte.

Instalação

Via PyPI (Recomendado)

Após a publicação no PyPI, você poderá instalar diretamente:

pip install caze-tools

A partir do código-fonte

Para desenvolvimento ou versão mais recente:

git clone https://github.com/dsscaze/caze-tools.git
cd caze-tools
pip install -e .

Comandos Disponíveis

O comando principal é cz (um alias para caze-tools).

cz mkstruct

Cria uma estrutura de diretórios e arquivos a partir de uma representação em texto (árvore de diretórios).

Uso:

cz mkstruct <arquivo_fonte.md>

Exemplo estrutura.md:

meu-projeto/
├── src/
│   ├── __init__.py
│   └── main.py
└── README.md

Ao executar cz mkstruct estrutura.md, a estrutura acima será criada no diretório atual.

cz ls-struct

Faz o inverso do mkstruct: lê uma estrutura de diretórios existente e gera uma representação em árvore.

Uso:

# Imprime a estrutura do diretório atual no console
cz ls-struct

# Salva a estrutura em um arquivo
cz ls-struct -o project_tree.md

# Gera a estrutura de outra pasta
cz ls-struct ../outro-projeto

cz merge

Mescla múltiplos arquivos de um diretório em um único arquivo de saída. Extremamente útil para criar contextos para LLMs ou para arquivar código.

Uso:

cz merge <diretorio_origem> <arquivo_saida> [opções]

Exemplos:

• Mesclar todos os arquivos .py e .js em context.txt:

  cz merge . context.txt --ext py --ext js
  

• Mesclar todos os arquivos de teste do diretório src:

  cz merge src tests_merged.txt --name "test_*.py"
  

cz addprefix

Adiciona um prefixo a todos os arquivos de uma pasta (recursivamente).

Uso:

cz addprefix <pasta> <prefixo> [--dry-run]

Exemplos:

• Adicionar prefixo "old_" a todos os arquivos:

  cz addprefix ./minha-pasta old_
  

• Simular sem fazer alterações reais:

  cz addprefix ./minha-pasta new_ --dry-run
  

cz rename

Renomeia arquivos substituindo um prefixo por outro (recursivamente).

Uso:

cz rename <pasta> <prefixo_antigo> <novo_prefixo> [--dry-run]

Exemplos:

• Trocar prefixo "old_" por "new_":

  cz rename ./minha-pasta old_ new_
  

• Simular a operação antes de executar:

  cz rename ./minha-pasta test_ prod_ --dry-run
  

cz toroot

Move todos os arquivos de subpastas para a pasta raiz, mantendo nomes únicos.

Uso:

cz toroot <pasta> [--dry-run]

Exemplos:

• Mover todos os arquivos para a raiz:

  cz toroot ./minha-pasta
  

• Simular a operação:

  cz toroot ./minha-pasta --dry-run
  

cz trimimg

Remove transparências desnecessárias de imagens PNG, reduzindo o tamanho do arquivo.

Uso:

cz trimimg <pasta> [--padding N] [--threshold N] [--dry-run]

Opções:

• --padding: Pixels de margem a manter (padrão: 0)
• --threshold: Nível de transparência mínimo (0-255, padrão: 10)

Exemplos:

• Processar todas as PNGs com padding de 5px:

  cz trimimg ./imagens --padding 5
  

• Simular processamento:

  cz trimimg ./imagens --dry-run
  

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir uma issue para relatar bugs ou sugerir novas funcionalidades.

Publicação

Se você é mantenedor e deseja publicar uma nova versão no PyPI, consulte o Guia de Publicação.

Licença

Este projeto está licenciado sob a Licença MIT.