105 lines
3.9 KiB
Markdown
105 lines
3.9 KiB
Markdown
# gob
|
||
|
||
Ensemble de librairies personnalisées en Go
|
||
|
||
## Architecture
|
||
|
||
### collection
|
||
|
||
Le paquet **collection** contient quelques fonctions utiles pour la gestion des slices (ajout, insertion, comparaison de slices, différence, intersection, conversion, map/reduce, etc.).
|
||
|
||
Il implémente également quelques collections non présentes, à l’heure actuelle, dans la librairie standard :
|
||
|
||
- Les piles : collection.Stack
|
||
- Les files : collection.Queue
|
||
- Les collections d’éléments uniques : collection.Set
|
||
|
||
**collection/concurrent** est une sous-bibliothèque pour alimenter les slices et les maps de manière concurrente et en toute sécurité.
|
||
|
||
**collection/json** permet de gérer des objets json (modification, parcours, import, export).
|
||
|
||
### compare
|
||
|
||
Le paquet **compare** implémente différentes fonctions de comparaison de chaînes de caractères (insensible à la casse, tri naturel, prise en compte des accents, etc.), et permet d’aggréger plusieurs fonctions de comparaison.
|
||
|
||
### convert
|
||
|
||
Le paquet **convert** fournit le nécessaire pour convertir des variables typées en d’autres types de manière transparente. Types actuellement gérés :
|
||
|
||
- Booléens,
|
||
- Caractères (rune, byte),
|
||
- Entiers (int, int8, int16, int32, int64, uint, uint8, uint16, uint62, uint64),
|
||
- Nombres à virgule flottante (float32, float64),
|
||
- Nombres complexes (complex64, complex128),
|
||
- Chaînes de caractères,
|
||
- Collections (slice, map),
|
||
- Structures.
|
||
|
||
Tous ces types sont convertibles entre eux.
|
||
|
||
### datetime
|
||
|
||
Le paquet **datetime** implémente des structures pour gérer des temps :
|
||
|
||
- datetime.Clock : pour gérer une heure dans la journée,
|
||
- datetime.Date : pour gérer une date, sans indication de l’heure,
|
||
- datetime.DateTime : pour gérer une date avec indication de l’heure.
|
||
- Range : pour gérer une période entre deux temps.
|
||
|
||
### number
|
||
|
||
Le paquet **number** implémente une structure pour gérer des opérations sur les nombres réels.
|
||
Un nombre peut être présenté sous différentes formes (dans une base donnée) :
|
||
|
||
- Format entier (ex : 58)
|
||
- Format décimal (ex : 36.25)
|
||
- Format scientifique (ex : 42.5E-18)
|
||
- Fraction (ex : 12/5)
|
||
|
||
Un nombre peut être également indérminé (NaN, ±∞)
|
||
|
||
### format
|
||
|
||
Le paquet **format** fournit le nécessaire pour formater la sortie terminal :
|
||
|
||
- Alignement des entrées (utile pour afficher un tableau),
|
||
- Couleurs et styles (gras, italique, etc.).
|
||
|
||
Seuls les terminaux supportant les chaînes d’échappement ASCII sont supportés.
|
||
|
||
### ini
|
||
|
||
Le paquet **ini** permet de parser et de gérer des fichiers de configuration (générations avec l’extension .ini ou .conf).
|
||
|
||
### option
|
||
|
||
Le paquet **option** implémente en Go les types Option et Result existant dans certains langages de programmation (comme Rust).
|
||
|
||
### random
|
||
|
||
Le paquet **random** fournit des fonctions pour générer des variables avec des caractères aléatoires.
|
||
|
||
### secret
|
||
|
||
Le paquet **secret** permet de générer des hashs ou de chiffrer des chaînes de caractères.
|
||
|
||
### shell
|
||
|
||
Le paquet **shell** regroupe des sous-paquets dédiés à faciliter la programmation d’applications en ligne de commandes.
|
||
|
||
#### shell/command
|
||
|
||
**shell/command** définit des interfaces permettant de parser les arguments d’une commande saisie. Une implémentation fonctionnelle est fournie dans le sous-paquet **shell/command/flag**.
|
||
|
||
#### shell/console
|
||
|
||
**shell/console** définit des interfaces dédiés à la programmation de CLI (_Command Line Interface_). Il fournit également des fonctions pour récupérer directement des entrées saisies dans le terminal dans des variables.
|
||
|
||
#### shell/file
|
||
|
||
**shell/file** permet de récupérer de façon détaillée les informations d’un fichier ou d’une arborescence de fichiers.
|
||
|
||
#### shell/scanner
|
||
|
||
**shell/scanner** fournit un outil pour découper une ou plusieurs lignes de caractères en mots selon des critères définis (chaîne d’échappment, guillemets, etc.).
|