Admin/Dev

24
Févr.
2018

Ecrire ses changelogs semi-automatiquement grâce à Git.

Publié par sky

Ecrire un changelog, c'est long, c'est fastidieux, bref, c'est chiant, mais lorsque l'on développe un programme que l'on rend publique, c'est un passage obligé pour chaque nouvelle version que l'on publie.

Si votre programme dispose d'un suivi avec Git, il existe une solution pour simplifier cette tâche des plus rébarbatives. Sinon, cela vous donnera peut être une raison de vous mettre à ce formidable outil.

En bonus, si votre programme est disponible librement sur GitHub, vous pouvez y insérer les liens afin que les curieux qui souhaitent en savoir plus puisse aller sur le détail du commit en question.

Dans un terminal, une fois dans le dossier du programme, voici la commande à adapter selon vos besoins.

git log v1...v2 --pretty=format:'* %s [View details](https://github.com/-github-account-/-project-/commit/%H)' --reverse | grep -v Merge > changelogs/v2.md

Regardons la de plus près

  • git : commande git, bien évidemment
  • log : action permettant à Git de renvoyer la liste des commits
  • v1...v2 : différentiel souhaité entre 2 releases, séparé par 3 petits points, ici cela prendra tous les commits effectués entre le tag v1 et le tag v2
  • --pretty=format : on indique que l'on souhaite un résultat en sortie formatté
  • '* %s [View details](https://github.com/-github-account-/-project-/commit/%H)' : formattage au format markdown où %s indique le sujet du commit et %H sa somme de contrôle.
  • --reverse : indique que l'on souhaite l'ordre des commits dans l'ordre chronologique, et par forcément dans l'ordre donnée par Git qui est d'afficher les derniers en premier
  • | grep -v Merge : permet de supprimer les merges du log, il est possible de ne par mettre ce paramètre ou de le customiser selon ses besoins
  • > changelogs/v2.md : écriture dans un fichier

Ici, l'export se fait au format markdown, mais il est possible d'obtenir du HTML ou n'importe quel autre format, tant que vous arrivez à l'écrire.

Il existe de nombreux paramètres pour personnaliser le formattage, en particulier, il est possible d'ajouter le nom de l'auteur, ou la date, voici une courte liste

  • %H : Somme de contrôle du commit
  • %h : Somme de contrôle courte du commit
  • %an : Nom de l'auteur
  • %ae : E-mail de l'auteur
  • %ad : Date de création
  • %aD : Date de création, format RFC2822
  • %ai : Date de création, format ISO 8601
  • %cn : Nom du validateur
  • %ce : E-mail du validateur
  • %cd : Date de validatation
  • %cD : Date de validatation, format RFC2822
  • %ci : Date de validatation, format ISO 8601

   
Une liste plus complète peut être consultée sur cette page.

Une fois le fichier créé, il est toujours possible de le modifier pour ajouter titres, dates, bref tout ce que vous avez besoin de renseigner pour compléter votre changelog.

 
Sommaire de la série
 
 
Commentaires
Aucun commentaire pour le moment.

 

Poster un commentaire
En postant sur skymac.org, je m'engage à être courtois et à ce que mon message soit pertinent avec le sujet de l'article.
En outre, j'accepte, sans condition, que mon message soit refusé et supprimé si ces règles ne sont pas appliquées.
Captcha indisponible
Pour valider le formulaire, vous devez confirmer que vous êtes bien une personne. Actuellement, la fonctionnalité est indisponible. Vous devez activer le service ReCaptcha dans le gestionnaire des cookies, et donc consentir à l'utilisation de ses cookies.
Ouvrir le panneau de gestion des cookies
Fermer le panneau
Ce site utilise des cookies pour assurer son bon fonctionnement. Il utilise aussi des cookies issues de services tiers permettant de proposer des fonctionnalités avancées. À tout moment, vous pouvez choisir quels services vous souhaitez activer ou refuser, afin de retirer votre consentement quant à l'utilisation des cookies.
 
Personnalisation des services
Vous êtes libre de choisir quels services vous souhaitez activer. En autorisant ces services tiers, vous acceptez le dépôt et la lecture de cookies et l'utilisation de technologies de suivi nécessaires à leur bon fonctionnement. En retirant votre consentement pour certains de ces services, certaines fonctionnalités du site peuvent ne plus fonctionner.
Navigation du site  En savoir plus
Le site écrit un cookie de session permettant son bon fonctionnement et aidant à la navigation. Il ne peut être désactivé.
Utilisation : 1 cookie, enregistre l'identifiant de la session.
Durée de vie : Le cookie est présent pendant toute la session sur le site. Il devient obsolète après 24 minutes d'inactivité.
Obligatoire
Popup Média
Afficher des vidéos depuis Yoube ou Dailymotion.
ReCaptcha  En savoir plus
Permet de valider que les visiteurs sont bien des humains lorsqu'ils valident des formulaires.
 
Tout accepter Tout refuser Gérer