Go Academy · Leçon

Options et options persistantes

Options string, int et bool, et intégration de Viper

Options et options persistantes est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 2 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.

Options locales

Les options locales s’appliquent uniquement à la commande sur laquelle elles sont définies. Utilisez cmd.Flags() :

var port int
serveCmd.Flags().IntVar(&port, "port", 8080, "HTTP server port")

Options persistantes

Les options persistantes sont héritées par la commande et par toutes ses sous-commandes. Utilisez cmd.PersistentFlags() :

var verbose bool
rootCmd.PersistentFlags().BoolVarP(&verbose, "verbose", "v", false, "Enable verbose output")

Options abrégées

Utilisez les variantes *VarP pour ajouter une abréviation d’une seule lettre :

cmd.Flags().StringVarP(&output, "output", "o", "stdout", "Output destination")

Types d’options

Cobra, par l’intermédiaire de pflag, prend en charge les types suivants : String, Bool, Int, Int64, Float64, StringSlice, Duration, Count, et bien d’autres. Chacun possède une variante Var (qui prend un pointeur) et une variante pratique (qui renvoie un pointeur).

Options obligatoires

Marquez une option comme obligatoire : Cobra génère une erreur si elle n’est pas fournie :

cmd.MarkFlagRequired("config")

Groupes d’options

Marquez des options comme mutuellement exclusives ou obligatoires ensemble avec MarkFlagsRequiredTogether et MarkFlagsMutuallyExclusive :

cmd.MarkFlagsRequiredTogether("user", "password")
cmd.MarkFlagsMutuallyExclusive("json", "yaml")

Option StringSlice

Acceptez plusieurs valeurs sous forme de liste séparée par des virgules ou d’options répétées :

var tags []string
cmd.Flags().StringSliceVar(&tags, "tags", nil, "Tags (comma-separated)")
// Usage: --tags a,b,c or --tags a --tags b

Lier des options à Viper

Liez une option Cobra à une clé Viper afin que sa valeur puisse également provenir d’une variable d’environnement ou d’un fichier de configuration :

viper.BindPFlag("port", serveCmd.Flags().Lookup("port"))
viper.BindEnv("port", "APP_PORT")

Affichage de la valeur par défaut

Cobra affiche automatiquement la valeur par défaut dans le texte d’aide. Fournissez une valeur par défaut claire qui fonctionne directement dans le cas courant.

Accéder aux valeurs des options

Accédez aux valeurs des options via le pointeur que vous avez lié, ou recherchez-les par nom dans l’ensemble d’options de la commande si le pointeur n’est pas accessible :

port, _ := cmd.Flags().GetInt("port")

Méthode Changed

cmd.Flags().Changed("flag-name") renvoie true uniquement si l’utilisateur a défini explicitement l’option. Utilisez-la pour distinguer « non fournie » de « fournie avec la valeur par défaut ».

Vérification rapide

Quelle est la différence entre une option locale et une option persistante dans Cobra ?

Récapitulatif : options et options persistantes

Points essentiels :

cmd.Flags() : locale ; cmd.PersistentFlags() : héritée par les sous-commandes
*VarP pour les abréviations ; MarkFlagRequired pour les options obligatoires
MarkFlagsRequiredTogether / MarkFlagsMutuallyExclusive pour les relations entre options
Changed() pour détecter si l’utilisateur a défini explicitement une option

Questions Fréquemment Posées

La leçon « Options et options persistantes » est-elle gratuite ?

Oui — le texte complet de « Options et options persistantes » 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 « Options et options persistantes » ?

Options string, int et bool, et intégration de Viper 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 2 sur 4.

Combien de temps prend la leçon « Options et options persistantes » ?

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