Go Academy · Leçon

Sous-commandes et groupes de commandes

Construire des hiérarchies de CLI à plusieurs niveaux

Sous-commandes et groupes de commandes est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.

Commandes hiérarchiques

Cobra prend en charge un imbrication arbitraire : racine → sous-commande → sous-sous-commande. Les utilisateurs appellent app resource action, comme kubectl get pods.

Ajouter des sous-commandes

Construisez chaque sous-commande comme un cobra.Command distinct et enregistrez-le auprès de son parent :

var userCmd = &cobra.Command{Use: "user", Short: "Manage users"}
var userCreateCmd = &cobra.Command{Use: "create", Short: "Create user", RunE: createUser}
func init() {
    userCmd.AddCommand(userCreateCmd)
    rootCmd.AddCommand(userCmd)
}

Affichage par groupes (Cobra v1.6+)

Attribuez les commandes à des groupes d’affichage dans la sortie d’aide pour améliorer l’organisation :

rootCmd.AddGroup(&cobra.Group{ID: "mgmt", Title: "Management Commands"})
userCmd.GroupID = "mgmt"

Alias

Ajoutez des alias afin que les utilisateurs puissent employer des noms courts ou différents pour les commandes :

var userCmd = &cobra.Command{
    Use:     "user",
    Aliases: []string{"users", "u"},
}

Commandes masquées

Marquez les commandes de débogage ou internes comme masquées afin qu’elles n’apparaissent pas dans l’aide tout en continuant à fonctionner :

cmd.Hidden = true

Commandes obsolètes

Marquez les anciennes commandes comme obsolètes afin d’afficher un avertissement lorsqu’elles sont utilisées :

cmd.Deprecated = "use 'new-command' instead"

Crochets avant et après

Utilisez PersistentPreRunE et PostRunE pour la mise en place et le nettoyage qui s’appliquent à une commande et à toutes ses sous-commandes (par exemple, initialiser une connexion à une base de données avant l’exécution de toute sous-commande).

rootCmd.PersistentPreRunE = func(cmd *cobra.Command, args []string) error {
    return initDB()
}

Désactiver l’aide pour les commandes feuilles

Cobra ajoute par défaut help comme sous-commande. Désactivez-la si votre application possède sa propre commande d’aide ou si la structure des sous-commandes risque de prêter à confusion.

rootCmd.SetHelpCommand(&cobra.Command{Hidden: true})

Accéder à la commande parent

Dans une fonction Run, cmd.Parent() renvoie la commande parent, ce qui est utile pour accéder aux options définies sur le parent.

Parcours des commandes

Utilisez rootCmd.Commands() pour parcourir toutes les sous-commandes enregistrées. Cette méthode est utile pour l’introspection programmatique ou la génération automatique de documentation.

Génération de pages de manuel et de fichiers Markdown

Cobra peut générer des pages de manuel et une documentation Markdown pour toutes les commandes avec le paquet cobra/doc :

doc.GenMarkdownTree(rootCmd, "./docs")

Vérification rapide

Comment rendre une sous-commande Cobra accessible sous plusieurs noms ?

Récapitulatif : sous-commandes et groupes

Points essentiels :

AddCommand imbrique les commandes de façon hiérarchique
GroupID organise l’affichage de l’aide dans Cobra v1.6+
Les alias servent aux formes courtes ; Hidden aux commandes internes
PersistentPreRunE permet une mise en place commune pour les sous-commandes

Questions Fréquemment Posées

La leçon « Sous-commandes et groupes de commandes » est-elle gratuite ?

Oui — le texte complet de « Sous-commandes et groupes de commandes » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Sous-commandes et groupes de commandes » ?

Construire des hiérarchies de CLI à plusieurs niveaux Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Go Academy ?

Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.

Combien de temps prend la leçon « Sous-commandes et groupes de commandes » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?

Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Go Academy