Configuración

Ignorar archivos

Controla a qué archivos puede acceder Bob Shell creando un archivo `.bobignore` en tu proyecto.

Descripción general

FunciónDescripciónBeneficio
Exclusión de rutasEvita que Bob Shell acceda a archivos o directorios específicosProtege información sensible
Coincidencia de patronesUsa patrones glob para coincidir con múltiples archivosExcluye tipos de archivos de forma eficiente
Soporte de negaciónAnula exclusiones para archivos específicosControl granular
Específico del proyectoCada proyecto puede tener sus propias reglas de exclusiónAdaptado a las necesidades del proyecto

¿Por qué usar .bobignore?

  • Protección de privacidad: Mantén privados los archivos sensibles como API keys y credenciales
  • Mejora del rendimiento: Excluye archivos binarios grandes o directorios que ralentizan las operaciones
  • Reducción de ruido: Elimina archivos irrelevantes del contexto de Bob Shell
  • Control del enfoque: Dirige la atención de Bob Shell a las partes más relevantes de tu base de código

Cómo funciona .bobignore

Cuando agregas rutas a tu archivo .bobignore, las herramientas de Bob Shell que respetan este archivo excluirán automáticamente los archivos y directorios coincidentes de sus operaciones. Por ejemplo, al usar el comando read_many_files, se omitirán las rutas en tu archivo .bobignore.

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│                 │     │                 │     │                 │
│  Your project   │────▶│  .bobignore     │────▶│  Files Bob Shell │
│  files          │     │  filter         │     │  can access     │
│                 │     │                 │     │                 │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Los cambios en tu archivo .bobignore requieren reiniciar la sesión de Bob Shell para que tengan efecto.

Sintaxis de patrones

El archivo .bobignore sigue la misma sintaxis de patrones que .gitignore:

PatrónDescripciónEjemplo
file.txtCoincide con un archivo específicoapikeys.txt
*.extCoincide con todos los archivos con la extensión*.log
/dir/Coincide con un directorio/node_modules/
/path/to/fileAncla la ruta a la raíz/src/config/secrets.json
!patternNiega un patrón anterior!important.md
#Línea de comentario# API credentials

Primeros pasos

Crear un archivo .bobignore

  1. Crea un archivo llamado .bobignore en la raíz del directorio de tu proyecto
  2. Agrega patrones para los archivos y directorios que quieres excluir
  3. Guarda el archivo y reinicia tu sesión de Bob Shell
# Desde la raíz de tu proyecto
touch .bobignore
echo "# Files to ignore" > .bobignore
echo "secrets/" >> .bobignore

Patrones de exclusión comunes

Aquí hay algunos patrones comunes que podrías querer agregar a tu archivo .bobignore:

# Sensitive information
.env
secrets/
*password*
*credential*
*apikey*

# Large directories
node_modules/
.git/
dist/
build/

# Binary and media files
*.zip
*.tar.gz
*.mp4
*.jpg
*.png

# Log files
*.log
logs/

Ejemplos de patrones

Excluir directorios específicos

Para excluir directorios completos y su contenido:

# Exclude the packages directory and all its contents
/packages/

# Exclude all node_modules directories anywhere in the project
**/node_modules/

# Exclude the dist directory but only at the root level
/dist/

Usar comodines

Los comodines te permiten coincidir con múltiples archivos con patrones similares:

# Exclude all markdown files
*.md

# Exclude all JavaScript files in the src directory
/src/**/*.js

# Exclude all files with "test" in their name
*test*

Usar negación

Puedes anular exclusiones para archivos específicos:

# Exclude all markdown files
*.md

# But include README.md
!README.md

# And include all markdown files in the docs directory
!docs/*.md

Uso avanzado

Combinar patrones

Puedes crear reglas de exclusión sofisticadas combinando patrones:

# Exclude all JavaScript files
*.js

# But include all files in the src directory
!src/**/*.js

# Except for test files in the src directory
src/**/*.test.js

Depurar tu archivo .bobignore

Si Bob Shell parece estar ignorando archivos a los que quieres que acceda, o accediendo a archivos que quieres que ignore:

  1. Revisa tu archivo .bobignore en busca de patrones conflictivos
  2. Recuerda que los patrones más específicos (como las negaciones) deben ir después de los patrones generales
  3. Reinicia tu sesión de Bob Shell después de hacer cambios
  4. Usa rutas absolutas si las rutas relativas no funcionan como se esperaba

Buenas prácticas

  • Empieza simple: Comienza con unos pocos patrones esenciales y agrega más según sea necesario
  • Comenta tus patrones: Agrega comentarios para explicar por qué se excluyen ciertos archivos
  • Sé específico: Usa patrones precisos para evitar excluir accidentalmente archivos importantes
  • Considera la seguridad: Siempre excluye los archivos que contienen información sensible
  • Mantén regularmente: Actualiza tu archivo .bobignore a medida que evoluciona tu proyecto
¿Cómo es este tema?