Guide de démarrage rapide GitHub CLI: dites au revoir au navigateur et contr?lez votre github sur la ligne de commande

Cet article vous amènera à commencer rapidement avec la CLI GitHub pour comprendre ses utilisations, paramètres et méthodes d'utilisation.

Si vous connaissez les commandes GIT, vous devez savoir que vous devez passer à un navigateur Web pour effectuer diverses opérations sur votre référentiel GitHub. Le nouvel outil GitHub CLI vous permet d'effectuer bon nombre de ces opérations sans quitter l'interface de ligne de commande.

Points de base

• GitHub CLI permet aux utilisateurs d'effectuer diverses opérations sur le référentiel GitHub sans laisser l'interface de ligne de commande sans passer à un navigateur Web.
• La structure de commande GitHub CLI est similaire à un arbre et contient deux couches: la première couche contient six commandes: config, repo, issue, pr, gist, credits,
, et
• . Chaque commande a une deuxième couche où l'utilisateur peut spécifier l'action à effectuer.
• GitHub CLI permet aux utilisateurs de cloner, fourche, afficher et créer des référentiels directement à partir de la ligne de commande. Il comprend également des commandes pour créer et gérer les demandes de traction, les problèmes et l'essentiel.

Bien que le GitHub CLI soit un puissant outil de gestion du référentiel GitHub, il est important de noter qu'il est toujours en cours de développement et que de nouvelles commandes peuvent appara?tre au fil du temps. Il est recommandé que l'utilisateur se réfère au manuel des nouvelles fonctionnalités et comment utiliser les outils existants.

Paramètres GitHub CLI

Pour commencer, visitez simplement la page d'installation et trouvez les instructions d'installation de GitHub CLI pour votre système d'exploitation. Pour Windows et MacOS, vous pouvez utiliser le gestionnaire de packages pour installer et mettre à jour le GitHub CLI. Pour les utilisateurs de Linux, le package doit être téléchargé à partir de la dernière page de version. Les utilisateurs de Windows ont également un programme d'installation MSI signé, mais veuillez noter que si vous choisissez cette méthode, vous devez refaire manuellement et mettre à jour l'outil. Pour les utilisateurs de Windows, le moyen le plus simple est d'utiliser le gestionnaire de packages Scoop.

Voici les instructions d'installation pour chaque plate-forme prise en charge:

Windows:

<code>scoop bucket add github-gh https://github.com/cli/scoop-gh.git
scoop install gh</code>

macOS:

<code>brew install gh</code>

Debian / Ubuntu Linux:

<code>sudo apt install git && sudo dpkg -i gh_*_linux_amd64.deb</code>

Fedora / Centos Linux:

<code>sudo yum localinstall gh_*_linux_amd64.rpm</code>

Arch Linux:

<code>yay -S github-cli</code>

Sur Windows, je recommande d'utiliser un terminal Git Bash. Cette interface vous permettra d'accéder aux commandes Linux couramment utilisées et aux fonctions de bash, telles que l'achèvement automatique. Il est également officiellement soutenu par le code Visual Studio par l'intégration du terminal. gh repo view cli/cli

Après avoir installé la CLI GitHub, vous devez vérifier votre compte. L'exécution de toute commande déclenchera ce processus d'authentification. Par exemple, essayez

. Pour les utilisateurs qui l'utilisent pour la première fois, le système vous invitera:

Appuyez simplement sur la touche

Entrez

pour démarrer le processus comme suit:

Après avoir fourni le mot de passe, vous recevrez un message "GiTHub CLI vérifié avec succès". Vous pouvez désormais interagir avec la plate-forme GitHub via le terminal de ligne de commande. L'étape suivante consiste à implémenter l'achèvement automatique, ce qui est facultatif. Ajoutez simplement cette ligne à votre ~/.bash_profile:

<code>scoop bucket add github-gh https://github.com/cli/scoop-gh.git
scoop install gh</code>

Vous pouvez également exécuter les commandes ci-dessus dans le terminal actuel pour obtenir la fonction d'observation automatique sans redémarrer le terminal. Pour confirmer qu'il est valide, tapez gh repo et appuyez deux fois sur Tab . Il doit afficher quatre commandes différentes que vous pouvez attacher à la commande actuelle repo.

Structure de commande GitHub CLI

gh La structure de commande est similaire à un arbre et est facile à retenir. Fondamentalement, il n'y a que deux couches de commandement. La première couche ne contient que six commandes:

• config
• repo
• issue
• pr
• gist
• credits

Chaque commande a une deuxième commande de couche où vous pouvez spécifier les actions à effectuer, telles que gh repo view ou gh pr list. Cependant, la commande credits n'a pas de commande de deuxième niveau. Lorsqu'il est exécuté, il ne fera que répertorier les noms des contributeurs du référentiel. Voici un exemple rapide que vous pouvez essayer par vous-même:

<code>brew install gh</code>

Nous présenterons les commandes restantes plus en détail dans les sections suivantes.

Commande de référentiel GitHub

Clone Le référentiel à l'aide de la commande gh est plus facile que d'utiliser la commande git. Pour clone, exécutez simplement la commande dans le format suivant:

<code>sudo apt install git && sudo dpkg -i gh_*_linux_amd64.deb</code>

Ce format facilite le clonage de la mémoire. Vous n'avez plus besoin de taper ou de copier des URL git longues à clone. Voici un exemple:

<code>sudo yum localinstall gh_*_linux_amd64.rpm</code>

Vous pouvez également débarrasser facilement un référentiel existant de la ligne de commande à votre compte. Essayez ceci:

<code>yay -S github-cli</code>

Pendant le processus de fourche, l'outil vous demandera si vous souhaitez également le cloner. Si vous dites "oui", il effectuera un clone, configurera la branche en amont à distance et effectuera automatiquement des mises à jour pour vous. C'est très pratique. Vous pouvez le confirmer en vérifiant la configuration du référentiel sur la ligne de commande: git config -e. Voici ma sortie:

eval "$(gh completion -s bash)"

Pour ce projet, trunk est la branche par défaut. Vous devez utiliser la commande git pour synchroniser votre référentiel de fourche comme d'habitude. Pour cli entrep?t:

$ gh credits cli/cli

Vous pouvez également utiliser la commande gh repo view pour afficher les fichiers de description et de lecture du projet hébergé sur github. Essayez cette commande:

gh repo clone OWNER/REPO

Jusqu'à présent, vous avez appris à cloner, à fork et à afficher en utilisant la commande gh repo. Créons un nouveau référentiel GitHub à partir de la ligne de commande. Tout d'abord, nous devons créer un nouveau projet. Générons rapidement un projet Next.js. Lorsqu'on vous demande, utilisez le modèle "Application débutante par défaut":

$ gh repo clone tailwindcss/tailwindcss

Vous constaterez que le référentiel GIT local du projet a été initialisé. Pour créer un référentiel à partir de la ligne de commande, exécutez simplement la commande suivante:

<code>scoop bucket add github-gh https://github.com/cli/scoop-gh.git
scoop install gh</code>

Si vous ne spécifiez pas l'option --public, un référentiel privé est créé par défaut. Voici une liste complète des drapeaux que vous pouvez spécifier:

<code>brew install gh</code>

Si vous souhaitez créer un référentiel sous une autre organisation, vous devez utiliser la syntaxe suivante pour créer un référentiel: gh repo create org/repo.

(Le reste de l'article, concernant la demande de traction, le problème, les commandes GIST, le résumé et la FAQ, en raison des limites de l'espace, veuillez poser des questions dans les paragraphes, et j'y répondrai en détail un par un.)

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!