Merge Files Pro

Vue d'ensemble

L'extension Merge Files Pro pour VSCode est conçue pour simplifier le processus de collecte de code et de texte à partir de votre espace de travail. Son objectif principal est de fusionner de multiples fichiers de code et de configuration (selon vos préférences) en un seul fichier texte (.txt), formaté pour être facilement ingéré par des modèles de langage à grande échelle (LLM) ou d'autres outils d'analyse de code.

Plus besoin de copier-coller manuellement chaque fichier ! Cette extension vous permet de préparer rapidement un contexte de code complet pour vos assistants IA, vos analyses ou vos documentations.

Fonctionnalités

• Fusion Intelligente : Parcourt votre espace de travail, incluant uniquement les fichiers pertinents selon vos configurations.
• Configuration Flexible : Définissez précisément les extensions de fichiers à inclure, ainsi que les fichiers et dossiers spécifiques à exclure, directement depuis les paramètres de VSCode.
• Suppression des Commentaires : Option pour supprimer automatiquement les commentaires de code afin de réduire le nombre de tokens (idéal pour les LLM avec des limites de tokens).
• Conservation des Sauts de Lignes : Nouveau paramètre pour choisir entre conserver ou supprimer les sauts de lignes lors de la suppression des commentaires, offrant un contrôle précis sur le compromis lisibilité/compression.
• Sortie Structurée : Le fichier de sortie .txt est clairement structuré avec des séparateurs personnalisables et des chemins de fichiers pour une lisibilité optimale.
• Division en Plusieurs Fichiers : Possibilité de diviser la sortie en plusieurs fichiers de taille égale pour gérer les grandes bases de code.
• Préparation pour les LLM : Optimisé pour fournir aux LLM un aperçu condensé de votre base de code pour des tâches comme la revue de code, la génération de documentation, l'explication de code, ou la refactorisation.
• Nommage Personnalisé : Le fichier de sortie est nommé automatiquement avec la date et l'heure locales de fusion (Code_JJ-MM-AAAA_HHhMM.txt).
• Ouverture Automatique : Le fichier fusionné est ouvert automatiquement dans VSCode après sa création.

Utilisation

1. Ouvrez votre dossier de projet dans VSCode.
2. Ouvrez la Palette de Commandes (Ctrl+Shift+P ou Cmd+Shift+P sur macOS).
3. Tapez Fusionner les fichiers et sélectionnez la commande.
4. L'extension parcourra votre dossier de travail (ou le sous-dossier configuré), fusionnera les fichiers éligibles et créera un fichier au format Code_JJ-MM-AAAA_HHhMM.txt (ou plusieurs fichiers numérotés si configuré) dans le dossier de fusion, puis ouvrira le premier fichier.

Configuration

Vous pouvez personnaliser le comportement de l'extension via les paramètres de VSCode :

1. Allez dans Fichier > Préférences > Paramètres (ou utilisez le raccourci Ctrl+,).
2. Dans la barre de recherche des paramètres, tapez merge-files ou Merge Files Pro.

Vous trouverez la section "Merge Files Pro Configuration" avec les options suivantes :

• merge-files.mergeFolder:

  • Type: Chaîne de caractères
  • Défaut: "" (Vide)
  • Description: Spécifie un sous-dossier (relatif à la racine de l'espace de travail) à partir duquel la fusion des fichiers doit commencer. Le fichier de sortie sera également placé dans ce dossier. Laissez vide pour fusionner l'intégralité de l'espace de travail. Exemple : src/my-module ou backend.

• merge-files.codeExtensions:

  • Type: Tableau de chaînes de caractères
  • Défaut: [".js", ".json", ".example", ".gitignore", ".http", ".yml", ".md", ".sh", ".c", ".sql", ".css"]
  • Description: Liste des extensions de fichiers (y compris les fichiers sans extension mais avec un point comme .gitignore) que l'extension doit inclure dans le fichier fusionné. Ajoutez ou supprimez des extensions selon vos besoins.

• merge-files.excludedFiles:

  • Type: Tableau de chaînes de caractères
  • Défaut: ["package.json", "package-lock.json", ".env"]
  • Description: Liste des noms de fichiers spécifiques à exclure de la fusion, quelle que soit leur extension. Ceci est utile pour ignorer des fichiers sensibles ou inutiles pour l'analyse.

• merge-files.excludedFolders:

  • Type: Tableau de chaînes de caractères
  • Défaut: ["node_modules", "dist", "build", ".git", ".vscode", "bin", "obj", "out", "target", "vendor", "coverage", "__pycache__"]
  • Description: Liste des noms de dossiers à ignorer complètement lors du parcours. Idéal pour exclure les dépendances de projet, les répertoires de compilation, etc.

• merge-files.fileSeparator:

  • Type: Chaîne de caractères
  • Défaut: "==============================="
  • Description: Séparateur utilisé entre les fichiers dans le document fusionné. Peut être personnalisé ou laissé vide pour n'afficher que les noms de fichiers sans séparateur.

• merge-files.splitOutput:

  • Type: Entier
  • Défaut: 1
  • Description: Nombre de fichiers de sortie à générer. Par défaut, un seul fichier est créé. Si une valeur supérieure à 1 est spécifiée, les fichiers seront divisés de manière égale (par exemple, 4 fichiers pour 100 fichiers de code = 25 fichiers par sortie). Les fichiers générés seront nommés avec un suffixe indiquant la partie (par exemple, _part1_of_4).

• merge-files.removeComments:

  • Type: Booléen
  • Défaut: false
  • Description: Supprime automatiquement les commentaires de code dans les fichiers fusionnés pour réduire le nombre de tokens. Cette fonctionnalité est particulièrement utile lors de l'utilisation avec des LLM ayant des limites de tokens strictes. Les commentaires sont conservés par défaut. Supporte les formats de commentaires pour JavaScript, TypeScript, Python, HTML, CSS, SQL, Shell, YAML et d'autres langages courants.

• merge-files.preserveLineBreaks:

  • Type: Booléen
  • Défaut: true
  • Description: Conserve les sauts de lignes lors de la suppression des commentaires pour maintenir la structure du code. Si désactivé, les lignes vides laissées par la suppression des commentaires seront également supprimées pour une compression maximale. Ce paramètre n'a d'effet que si removeComments est activé.

Vous pouvez également trouver les paramètres en recherchant @ext:matheorie.merge-files.

Suppression des Commentaires - Détails Techniques

La fonctionnalité de suppression des commentaires supporte plusieurs types de langages spécifiques :

• JavaScript/TypeScript/Java/C/C++/C#/PHP/Go/Swift/Kotlin : Supprime les commentaires // et /* */
• Python : Supprime les commentaires # et les docstrings """ ou '''
• HTML/XML : Supprime les commentaires <!-- -->
• CSS/SCSS/Sass/Less : Supprime les commentaires /* */
• SQL : Supprime les commentaires -- et /* */
• Shell/Bash : Supprime les commentaires # (conserve les shebangs #!)
• YAML : Supprime les commentaires #

Pour les fichiers d'extensions non reconnues, les commentaires sont conservés intacts pour éviter toute altération accidentelle du contenu.

Gestion des Sauts de Lignes

Le nouveau paramètre preserveLineBreaks vous offre deux modes de fonctionnement :

Mode Conservation (preserveLineBreaks: true - par défaut) :

• Les commentaires multi-lignes sont remplacés par des espaces, mais les sauts de lignes sont conservés
• La structure visuelle et l'indentation du code restent intactes
• Idéal pour maintenir la lisibilité lors de l'analyse par des humains ou des LLM qui bénéficient de la structure

Mode Compression (preserveLineBreaks: false) :

• Les commentaires sont complètement supprimés sans laisser de traces
• Les lignes vides résultant de la suppression sont également éliminées
• Compression maximale pour économiser le plus de tokens possible
• Recommandé pour les LLM avec des limites de tokens strictes

Cas d'utilisation courants

1. Préparation pour les LLM : Fusionnez votre base de code pour l'analyser avec ChatGPT, Claude ou d'autres assistants IA.
2. Optimisation des tokens :
   • Supprimez les commentaires avec conservation de structure (preserveLineBreaks: true) pour un bon équilibre
   • Ou supprimez tout avec compression maximale (preserveLineBreaks: false) pour économiser le maximum de tokens
3. Gestion des grands projets : Divisez votre code en plusieurs fichiers pour respecter les limites de taille des assistants IA.
4. Documentation : Génèrez un aperçu complet de votre projet pour vos documentations internes.
5. Revue de code : Partagez facilement du code avec des collègues sans leur envoyer chaque fichier séparément.
6. Formation : Créez des exemples de code complets pour des sessions de formation.

Licence

Cette extension est publiée sous la licence MIT.