# format-python-files

> Formata automaticamente ficheiros Python após qualquer operação de Edit usando o formatador black. Este hook executa 'black' em qualquer ficheiro .py que o

- Fonte: https://doutorai.pt/componentes/hooks__format-python-files
- Tipo: Automações
- Categoria: Post Tool
- Downloads: 677
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

Componente da comunidade open-source, selecionado, traduzido e adaptado pelo Doutor AI.

## Para que serve e como usar

Um **hook** que automatiza ações de post tool em momentos-chave (antes/depois de uma ferramenta, ao guardar, etc.), sem ter de pensar nisso.

1. Instale o hook (comando acima).
2. Fica ativo automaticamente nos eventos definidos.
3. Ajuste as regras no ficheiro de settings se quiser afinar.

## Instalar (Claude Code)

```bash
mkdir -p .claude/hooks && curl -fsSL https://doutorai.pt/data/lib/hooks__format-python-files.md -o .claude/hooks/format-python-files.json
```

Cole este comando no terminal, na pasta do seu projeto, e o componente é instalado automaticamente.

## Conteúdo

```
{
  "description": "Automatically format Python files after any Edit operation using black formatter. This hook runs 'black' on any .py file that Claude modifies, ensuring consistent Python code formatting. Requires black to be installed ('pip install black'). The command includes error suppression (2>/dev/null || true) so it won't fail if black is not installed.",
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "if [[ \"$CLAUDE_TOOL_FILE_PATH\" == *.py ]]; then black \"$CLAUDE_TOOL_FILE_P

- 🔒 Conteúdo completo no plano Pro (7,99€/mês) -
```

## Componentes relacionados

- [agents-md-loader](https://doutorai.pt/componentes/hooks__agents-md-loader): Carrega automaticamente o conteúdo do ficheiro de configuração AGENTS.md no início da sessão para garantir que o Claude Code segue o comport
- [ai-bash-guard](https://doutorai.pt/componentes/hooks__ai-bash-guard): Guarda de segurança para comandos bash baseada em IA. Antes da execução de qualquer comando Bash, um subagent Claude leve avalia-o à procura
- [auto-git-add](https://doutorai.pt/componentes/hooks__auto-git-add): Faz automaticamente stage dos ficheiros modificados com git add após a edição. Ajuda a manter um fluxo de trabalho git limpo, ao colocar as 
- [backup-before-edit](https://doutorai.pt/componentes/hooks__backup-before-edit): Cria cópias de segurança automáticas dos ficheiros antes de qualquer operação Edit, por segurança. Este hook cria uma cópia de segurança com
- [build-on-change](https://doutorai.pt/componentes/hooks__build-on-change): Aciona automaticamente processos de build quando os ficheiros de código-fonte mudam. Deteta ferramentas de build comuns e executa os comando
- [change-logger](https://doutorai.pt/componentes/hooks__change-logger-2): Regista em CSV cada mutação de ficheiro para preparação de demonstrações. Guarda o carimbo de data e hora, a ferramenta, o caminho do fichei

## Poupe horas todas as semanas com IA, sem complicações

O **Doutor AI** dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe. [Ver planos →](https://doutorai.pt/precos)

---
Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/componentes/hooks__format-python-files