flag

package
v2.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 13, 2022 License: MIT Imports: 7 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Arg

type Arg struct {
	// contains filtered or unexported fields
}

Arg représente un argument de commande

func NewArg

func NewArg(name, usage string, nbargs int, value *[]string) *Arg

NewArg retourne un nouvel argument avec son nom, sa description le nombre d’éléments attendu et un pointeur vers la valeur parsée.

Si nbargs < 0, l’argument peut recevoir un nombre d’éléments indéterminé. Si nbargs = 0, l’argument est facultatif.

func (*Arg) IsParsed

func (a *Arg) IsParsed() bool

IsParsed retourne vrai si l’argument a déjà été parsé

func (*Arg) Name

func (a *Arg) Name() string

Name retourne le nom de l’argument

func (*Arg) Parse

func (a *Arg) Parse(args []string) (next []string, err error)

Parse parse l’argument à partir de l’entrée fournie et retourne les éléments restant à parser. Si le parsage échoue, une erreur est retournée.

func (*Arg) Reset

func (a *Arg) Reset()

Reset réinitialise le parsage

func (*Arg) Usage

func (a *Arg) Usage() string

Usage retourne l’aide sur l’utilisation de l’argument

type ConversionFunc

type ConversionFunc[T any] func([]string, *flag[T]) ([]string, T, int, error)

ConversionFunc est une fonction de conversion.

Les éléments retournés sont : - next : liste des éléments restants à parser - val : la valeur parsée - err : une erreur si le parsage échoue

type Flag

type Flag interface {
	command.Flag
	// contains filtered or unexported methods
}

Flag représente un argument nommé de commande

func Bool

func Bool(name, usage string, value *bool, defaultval bool, fac bool, others ...string) Flag

Bool retourne un argument nommé sans argument supplémentaire

func BoolSlice

func BoolSlice(name, usage string, nb int, value *[]bool, defaultval []bool, others ...string) Flag

BoolSlice retourne un argument nommé de type tableau de booléens

func Float

func Float(name, usage string, value *float64, defaultval float64, fac bool, others ...string) Flag

Float retourne un argument nommé de type décimal

func FloatSlice

func FloatSlice(name, usage string, nb int, value *[]float64, defaultval []float64, others ...string) Flag

FloatSlice retourne un argument nommé de type tableau de décimaux

func Int

func Int(name, usage string, value *int, defaultval int, fac bool, others ...string) Flag

Int retourne un argument nommé de type entier

func IntSlice

func IntSlice(name, usage string, nb int, value *[]int, defaultval []int, others ...string) Flag

IntSlice retourne un argument nommé de type tableau d’entiers

func New

func New[T any](
	name, usage, argname string,
	value *T,
	defaultval T,
	nb int,
	conv ConversionFunc[T],
	others ...string,
) Flag

New retourne un nouvel argument nommé avec : - son nom, - son usage, - le nom donné à l’argument qui suit - un pointeur vers sa valeur - sa valeur par défaut si non parsé - son nombre d’arguments (indéfini si -1, optionnel si 0) - sa fonction de conversion - des noms supplémentaires

func String

func String(name, usage string, value *string, defaultval string, fac bool, others ...string) Flag

String retourne un argument nommé de type chaîne de caractères

func StringSlice

func StringSlice(name, usage string, nb int, value *[]string, defaultval []string, others ...string) Flag

StringSlice retourne un argument nommé de type tableau de strings

func Uint

func Uint(name, usage string, value *uint, defaultval uint, fac bool, others ...string) Flag

Uint retourne un argument nommé de type entier non signé

func UintSlice

func UintSlice(name, usage string, nb int, value *[]uint, defaultval []uint, others ...string) Flag

UintSlice retourne un argument nommé de type tableau d’entiers non signés

type FlagSet

type FlagSet struct {
	// contains filtered or unexported fields
}

FlagSet et un ensemble de flags

func NewSet

func NewSet(unix bool) *FlagSet

NewSet retourne un nouveau set de flags. Si unix, les arguments nommés doivent être de type unix : -n pour les noms courts et --name pour les noms longs.

func (*FlagSet) Add

func (fs *FlagSet) Add(flags ...Flag) *FlagSet

Add ajoute des flags au flagset.

func (*FlagSet) AddArgs

func (fs *FlagSet) AddArgs(args ...*Arg) *FlagSet

AddArgs ajoute des arguments au flagset.

func (*FlagSet) Args

func (fs *FlagSet) Args() []string

Args retourne la valeur des arguments non nommés.

func (*FlagSet) Flags

func (fs *FlagSet) Flags() []command.Flag

Flags retourne la liste des flags disponibles dans le flagset.

func (*FlagSet) Help

func (fs *FlagSet) Help() string

Help retourne l’aide complète sur le flagset.

func (*FlagSet) HelpRequired

func (fs *FlagSet) HelpRequired() bool

HelpRequired retourne vrai si le parsage contient un flag de type aide.

func (*FlagSet) IsParsed

func (fs *FlagSet) IsParsed() bool

IsParsed retourne vrai si le flagset a été parsé.

func (*FlagSet) Parse

func (fs *FlagSet) Parse(args []string) (next []string, err error)

Parse parse les arguments pour alimenter le flagset. Il retourne la liste des arguments restant à parser et une erreur éventuelle si le parsage a échoué.

func (*FlagSet) Reset

func (fs *FlagSet) Reset()

Reset réinitialise l’état du flagset, comme s’il n’avait jamais été parsé.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL