Controla quais ficheiros Bob Shell pode aceder criando um ficheiro `.bobignore` no teu projeto.

Visão geral

Funcionalidade	Descrição	Benefício
Exclusão de caminhos	Impede Bob Shell de aceder a ficheiros ou diretórios específicos	Protege informações sensíveis
Correspondência de padrões	Usa padrões glob para corresponder a múltiplos ficheiros	Exclui tipos de ficheiros de forma eficiente
Suporte a negação	Substitui exclusões para ficheiros específicos	Controlo granular
Específico do projeto	Cada projeto pode ter as suas próprias regras de exclusão	Personalizado para as necessidades do projeto

Por que usar .bobignore?

Proteção de privacidade: Mantém ficheiros sensíveis como API keys e credenciais privados

Melhoria de desempenho: Exclui ficheiros binários grandes ou diretórios que abrandam as operações

Redução de ruído: Remove ficheiros irrelevantes do contexto do Bob Shell

Controlo de foco: Direciona a atenção do Bob Shell para as partes mais relevantes do teu código

Quando adicionas caminhos ao teu ficheiro .bobignore, as tools do Bob Shell que respeitam este ficheiro excluirão automaticamente os ficheiros e diretórios correspondentes das suas operações. Por exemplo, ao usar o comando read_many_files, qualquer caminho no teu ficheiro .bobignore será ignorado.

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│                 │     │                 │     │                 │
│  Os ficheiros   │────▶│  Filtro         │────▶│  Ficheiros que  │
│  do projeto     │     │  .bobignore     │     │  Bob Shell pode │
│                 │     │                 │     │  aceder         │
└─────────────────┘     └─────────────────┘     └─────────────────┘

As alterações ao teu ficheiro .bobignore requerem o reinício da sessão do Bob Shell para terem efeito.

Sintaxe de padrões

O ficheiro .bobignore segue a mesma sintaxe de padrões que o .gitignore:

Padrão	Descrição	Exemplo
`file.txt`	Corresponde a um ficheiro específico	`apikeys.txt`
`*.ext`	Corresponde a todos os ficheiros com a extensão	`*.log`
`/dir/`	Corresponde a um diretório	`/node_modules/`
`/path/to/file`	Ancora o caminho à raiz	`/src/config/secrets.json`
`!pattern`	Nega um padrão anterior	`!important.md`
`#`	Linha de comentário	`# API credentials`

Primeiros passos

Criar um ficheiro .bobignore

Cria um ficheiro chamado .bobignore na raiz do diretório do teu projeto

Adiciona padrões para ficheiros e diretórios que queres excluir

Guarda o ficheiro e reinicia a sessão do Bob Shell

# A partir da raiz do teu projeto
touch .bobignore
echo "# Files to ignore" > .bobignore
echo "secrets/" >> .bobignore

Padrões de exclusão comuns

Aqui estão alguns padrões comuns que podes querer adicionar ao teu ficheiro .bobignore:

# Informações sensíveis
.env
secrets/
*password*
*credential*
*apikey*

# Diretórios grandes
node_modules/
.git/
dist/
build/

# Ficheiros binários e de média
*.zip
*.tar.gz
*.mp4
*.jpg
*.png

# Ficheiros de log
*.log
logs/

Exemplos de padrões

Excluir diretórios específicos

Para excluir diretórios inteiros e o seu conteúdo:

# Excluir o diretório packages e todo o seu conteúdo
/packages/

# Excluir todos os diretórios node_modules em qualquer parte do projeto
**/node_modules/

# Excluir o diretório dist mas apenas ao nível da raiz
/dist/

Usar wildcards

Os wildcards permitem-te corresponder a múltiplos ficheiros com padrões semelhantes:

# Excluir todos os ficheiros markdown
*.md

# Excluir todos os ficheiros JavaScript no diretório src
/src/**/*.js

# Excluir todos os ficheiros com "test" no nome
*test*

Usar negação

Podes substituir exclusões para ficheiros específicos:

# Excluir todos os ficheiros markdown
*.md

# Mas incluir README.md
!README.md

# E incluir todos os ficheiros markdown no diretório docs
!docs/*.md

Utilização avançada

Combinar padrões

Podes criar regras de exclusão sofisticadas combinando padrões:

# Excluir todos os ficheiros JavaScript
*.js

# Mas incluir todos os ficheiros no diretório src
!src/**/*.js

# Exceto para ficheiros de teste no diretório src
src/**/*.test.js

Depurar o teu ficheiro .bobignore

Se Bob Shell parece estar a ignorar ficheiros a que queres aceder, ou a aceder a ficheiros que queres ignorar:

Verifica o teu ficheiro .bobignore para padrões conflituantes

Lembra-te que padrões mais específicos (como negações) devem vir depois dos padrões gerais

Reinicia a sessão do Bob Shell após fazer alterações

Usa caminhos absolutos se os caminhos relativos não estiverem a funcionar como esperado

Boas práticas

Começa simples: Começa com alguns padrões essenciais e adiciona mais conforme necessário

Comenta os teus padrões: Adiciona comentários para explicar por que certos ficheiros estão excluídos

Sê específico: Usa padrões precisos para evitar excluir acidentalmente ficheiros importantes

Considera a segurança: Exclui sempre ficheiros que contenham informações sensíveis

Mantém regularmente: Atualiza o teu ficheiro .bobignore à medida que o teu projeto evolui

Ignorar ficheiros