GitHub CLI 2.99.0 : joignez directement des images et vidéos à vos tickets et PR
L'outil en ligne de commande GitHub CLI s'enrichit du fanion `--attach` dans sa version 2.99.0. Cette fonctionnalité permet d'importer et d'insérer des médias locaux directement dans les tickets, les demandes d'intégration et les commentaires sans passer par le navigateur.
Fil « Prise en charge des fichiers médias dans l'outil GitHub CLI »
Pour illustrer un bogue d'interface ou un résultat de rendu, passer de son terminal au navigateur web pour glisser-déposer un fichier causait une rupture de contexte. La version v2.99.0 de GitHub CLI (l'interface en ligne de commande officielle de la plateforme) résout ce problème avec l'arrivée de l'option --attach. Il est désormais possible de téléverser et de référencer des fichiers médias sans quitter son terminal.
Une intégration fluide dans vos flux de travail
Le fanion --attach est répétable et prend en charge plusieurs types d'interactions. Il s'applique aux commandes de création, d'édition et de commentaire pour les tickets (gh issue) et les pull requests (gh pr, les demandes d'intégration de code).
Voici un exemple d'utilisation pour inclure une capture d'écran avec un texte alternatif :
gh pr create --title "Correction du formulaire de connexion" \
--body "Voici le résultat : " \
--attach "./login.png#L'état d'erreur du formulaire"
Gestion des références Markdown et formats supportés
Lorsqu'un chemin local est déjà présent dans le corps rédigé en Markdown (le langage de balisage léger utilisé par GitHub), l'outil remplace automatiquement ce chemin par l'adresse du fichier téléversé tout en conservant le texte alternatif. Si un fichier est attaché sans être cité dans le texte, il est simplement ajouté à la fin du message.
Les formats acceptés couvrent la majorité des besoins :
- Images et GIF : PNG, JPEG, GIF, WebP et SVG.
- Vidéos : MP4, MOV et WebM.
Permissions et limites de taille
L'authentification s'appuie sur les jetons habituels de l'outil : soit un jeton OAuth (protocole standard d'autorisation) via gh auth login, soit un PAT (Personal Access Token, un jeton d'accès personnel). Un droit d'écriture sur le dépôt cible est obligatoire pour effectuer le téléversement.
"--attach place l'image dans la même commande qui rédige le Markdown."
Les contraintes de taille restent identiques à celles de l'interface web : 10 Mo pour les images et animations GIF, 10 Mo pour les vidéos avec un compte gratuit, et jusqu'à 100 Mo pour les vidéos avec un compte payant. La version GitHub Enterprise Server (la déclinaison auto-hébergée pour entreprise) n'est toutefois pas prise en charge dans cette mise à jour.