Catégories

Extracteur de Journal des Modifications

Analyse et extrait des données structurées de journaux des modifications et de notes de version dans plusieurs formats

Fonctionnalités

Extrait et analyse des informations de version de divers formats de journaux des modifications :

  • Keep a Changelog: Format standard avec en-têtes de version et changements catégorisés
  • Conventional Commits: Style de message de commit Git avec type et portée
  • GitHub Releases: Notes de version avec listes de fonctionnalités et corrections de bugs
  • Détection automatique: Identifie automatiquement le format utilisé

Extraction

Extrait des données complètes de version :

  • Numéros de version: Versionnage sémantique (ex: 1.0.0, 2.1.3-beta)
  • Dates de publication: La date de publication de chaque version
  • Catégories de changements: Ajouté, Modifié, Déprécié, Supprimé, Corrigé, Sécurité
  • Descriptions des changements: Texte complet de chaque entrée de changement
  • Portée et changements cassants: Métadonnées supplémentaires des commits conventionnels

Analyse

Fournit des statistiques détaillées :

  • Nombre total de versions
  • Première et dernière version
  • Changements par catégorie par version
  • Détection des changements non publiés
  • Nombre total des changements dans toutes les versions

Export

Exporte des données JSON structurées adaptées pour :

  • Documentation d'API
  • Génération de notes de version
  • Outils de comparaison de versions
  • Guides de migration

Inclure le texte complet pour chaque entrée de changement

Points clés

Catégorie
Development
Types d’entrée
textarea, select, checkbox
Type de sortie
json
Couverture des échantillons
4
API disponible
Yes

Vue d’ensemble

L'Extracteur de Journal des Modifications est un outil puissant conçu pour analyser et convertir automatiquement vos notes de version et journaux de commits en données JSON structurées, facilitant ainsi leur intégration dans vos outils de documentation ou vos pipelines de déploiement.

Quand l’utiliser

  • Pour transformer des fichiers texte de type 'Keep a Changelog' en données exploitables par une API.
  • Lors de la standardisation de vos notes de version issues de commits Git conventionnels.
  • Pour générer des statistiques sur la fréquence et la nature des mises à jour de vos projets logiciels.

Comment ça marche

  • Collez le contenu de votre journal des modifications ou de vos notes de version dans la zone de saisie.
  • Sélectionnez le format source ou laissez l'outil détecter automatiquement la structure utilisée.
  • Activez l'option d'inclusion des descriptions pour conserver les détails textuels de chaque changement.
  • Récupérez le résultat au format JSON structuré, prêt à être utilisé dans vos applications.

Cas d’usage

Automatisation de la génération de pages de documentation technique à partir de dépôts Git.
Création de tableaux de bord de suivi de version pour les équipes produit.
Migration de données de versionnage entre différents systèmes de gestion de projet.

Exemples

1. Conversion de Conventional Commits

Développeur DevOps
Contexte
Une équipe utilise les Conventional Commits pour gérer ses versions et souhaite afficher les dernières mises à jour sur leur portail interne.
Problème
Les messages de commits bruts sont difficiles à lire pour les utilisateurs finaux et non structurés pour le site web.
Comment l’utiliser
Copier l'historique des commits, sélectionner 'Conventional Commits' dans le menu déroulant et extraire le JSON.
Résultat
Un fichier JSON propre classant les changements par type (feat, fix, chore) et par version, prêt à être affiché sur le portail.

2. Standardisation de Keep a Changelog

Responsable Produit
Contexte
Le fichier CHANGELOG.md du projet est devenu trop volumineux et complexe à maintenir manuellement pour les rapports de conformité.
Problème
Besoin d'extraire des statistiques précises sur le nombre de correctifs de sécurité par version.
Comment l’utiliser
Importer le contenu du fichier Markdown, choisir le format 'Keep a Changelog' et générer le JSON.
Résultat
Extraction structurée permettant de compter instantanément les entrées dans la catégorie 'Sécurité' pour chaque version publiée.

Tester avec des échantillons

text

Hubs associés

FAQ

Quels formats de journaux sont pris en charge ?

L'outil prend en charge les formats 'Keep a Changelog', 'Conventional Commits' et les notes de version 'GitHub Releases'.

L'outil peut-il détecter automatiquement le format ?

Oui, l'option de détection automatique identifie le style de votre texte pour appliquer les règles d'extraction appropriées.

Quelles données sont extraites ?

L'outil extrait les numéros de version, les dates, les catégories de changements (ajout, correction, etc.) et les descriptions détaillées.

Le format de sortie est-il toujours du JSON ?

Oui, l'outil génère systématiquement un objet JSON structuré pour garantir une compatibilité maximale avec vos outils de développement.

Puis-je exclure les descriptions longues ?

Oui, vous pouvez décocher l'option 'Inclure les Descriptions Complètes' pour obtenir un fichier JSON plus léger contenant uniquement les métadonnées.

Documentation de l'API

Point de terminaison de la requête

POST /fr/api/tools/changelog-extractor

Paramètres de la requête

Nom du paramètre Type Requis Description
changelogInput textarea Oui -
formatHint select Non -
includeDescriptions checkbox Non Inclure le texte complet pour chaque entrée de changement

Format de réponse

{
  "key": {...},
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Données JSON: Données JSON

Documentation de MCP

Ajoutez cet outil à votre configuration de serveur MCP:

{
  "mcpServers": {
    "elysiatools-changelog-extractor": {
      "name": "changelog-extractor",
      "description": "Analyse et extrait des données structurées de journaux des modifications et de notes de version dans plusieurs formats",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=changelog-extractor",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Vous pouvez chaîner plusieurs outils, par ex.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 outils.

Si vous rencontrez des problèmes, veuillez nous contacter à [email protected]