Configurazione

Ignorare file

Controlla a quali file Bob Shell può accedere creando un file `.bobignore` nel tuo progetto.

Panoramica

FunzionalitàDescrizioneVantaggio
Esclusione percorsiImpedisce a Bob Shell di accedere a file o directory specificiProtegge le informazioni sensibili
Corrispondenza patternUsa pattern glob per corrispondere a più fileEsclude i tipi di file in modo efficiente
Supporto negazioneSostituisce le esclusioni per file specificiControllo granulare
Specifico del progettoOgni progetto può avere le proprie regole di esclusionePersonalizzato in base alle esigenze del progetto

Perché usare .bobignore?

  • Protezione della privacy: Mantieni privati i file sensibili come le API key e le credenziali
  • Miglioramento delle prestazioni: Escludi i file binari di grandi dimensioni o le directory che rallentano le operazioni
  • Riduzione del rumore: Rimuovi i file irrilevanti dal contesto di Bob Shell
  • Controllo del focus: Indirizza l'attenzione di Bob Shell alle parti più rilevanti del tuo codebase

Come funziona .bobignore

Quando aggiungi percorsi al tuo file .bobignore, gli strumenti di Bob Shell che rispettano questo file escluderanno automaticamente i file e le directory corrispondenti dalle loro operazioni. Per esempio, quando si usa il comando read_many_files, tutti i percorsi nel tuo file .bobignore verranno ignorati.

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│                 │     │                 │     │                 │
│  I tuoi file    │────▶│  .bobignore     │────▶│  File a cui Bob  │
│  di progetto    │     │  filtro         │     │  Shell può      │
│                 │     │                 │     │  accedere       │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Le modifiche al tuo file .bobignore richiedono il riavvio della sessione di Bob Shell per avere effetto.

Sintassi dei pattern

Il file .bobignore segue la stessa sintassi dei pattern di .gitignore:

PatternDescrizioneEsempio
file.txtCorrisponde a un file specificoapikeys.txt
*.extCorrisponde a tutti i file con l'estensione*.log
/dir/Corrisponde a una directory/node_modules/
/path/to/fileAncora il percorso alla radice/src/config/secrets.json
!patternNega un pattern precedente!important.md
#Riga di commento# API credentials

Per iniziare

Creare un file .bobignore

  1. Crea un file chiamato .bobignore nella radice della directory del tuo progetto
  2. Aggiungi pattern per i file e le directory che vuoi escludere
  3. Salva il file e riavvia la sessione di Bob Shell
# Dalla radice del tuo progetto
touch .bobignore
echo "# Files to ignore" > .bobignore
echo "secrets/" >> .bobignore

Pattern di esclusione comuni

Ecco alcuni pattern comuni che potresti voler aggiungere al tuo file .bobignore:

# Informazioni sensibili
.env
secrets/
*password*
*credential*
*apikey*

# Directory di grandi dimensioni
node_modules/
.git/
dist/
build/

# File binari e multimediali
*.zip
*.tar.gz
*.mp4
*.jpg
*.png

# File di log
*.log
logs/

Esempi di pattern

Escludere directory specifiche

Per escludere intere directory e il loro contenuto:

# Escludi la directory packages e tutto il suo contenuto
/packages/

# Escludi tutte le directory node_modules ovunque nel progetto
**/node_modules/

# Escludi la directory dist ma solo al livello radice
/dist/

Usare i caratteri jolly

I caratteri jolly ti permettono di corrispondere a più file con pattern simili:

# Escludi tutti i file markdown
*.md

# Escludi tutti i file JavaScript nella directory src
/src/**/*.js

# Escludi tutti i file con "test" nel nome
*test*

Usare la negazione

Puoi sostituire le esclusioni per file specifici:

# Escludi tutti i file markdown
*.md

# Ma includi README.md
!README.md

# E includi tutti i file markdown nella directory docs
!docs/*.md

Utilizzo avanzato

Combinare i pattern

Puoi creare regole di esclusione sofisticate combinando i pattern:

# Escludi tutti i file JavaScript
*.js

# Ma includi tutti i file nella directory src
!src/**/*.js

# Eccetto i file di test nella directory src
src/**/*.test.js

Debug del file .bobignore

Se Bob Shell sembra ignorare i file a cui vuoi che acceda, o accedere a file che vuoi che ignori:

  1. Controlla il tuo file .bobignore per pattern in conflitto
  2. Ricorda che i pattern più specifici (come le negazioni) devono venire dopo i pattern generali
  3. Riavvia la sessione di Bob Shell dopo aver apportato modifiche
  4. Usa percorsi assoluti se i percorsi relativi non funzionano come previsto

Best practice

  • Inizia semplice: Inizia con pochi pattern essenziali e aggiungine altri man mano che ne hai bisogno
  • Commenta i tuoi pattern: Aggiungi commenti per spiegare perché certi file sono esclusi
  • Sii specifico: Usa pattern precisi per evitare di escludere accidentalmente file importanti
  • Considera la sicurezza: Escludi sempre i file contenenti informazioni sensibili
  • Mantieni regolarmente: Aggiorna il tuo file .bobignore man mano che il tuo progetto si evolve
Come valuti questo argomento?