Suivant: , Précédent: , Monter: Utilitaires   [Table des matières][Index]

10.7 Invoquer guix style

The guix style command helps packagers style their package definitions according to the latest fashionable trends. The command currently provides the following styling rules:

The way package inputs are written is going through a transition (voir référence de package, for more on package inputs). Until version 1.3.0, package inputs were written using the “old style”, where each input was given an explicit label, most of the time the package name:

  ;; …
  ;; The "old style" (deprecated).
  (inputs `(("libunistring" ,libunistring)
            ("libffi" ,libffi))))

Today, the old style is deprecated and the preferred style looks like this:

  ;; …
  ;; The "new style".
  (inputs (list libunistring libffi)))

Likewise, uses of alist-delete and friends to manipulate inputs is now deprecated in favor of modify-inputs (voir Définition de variantes de paquets, for more info on modify-inputs).

In the vast majority of cases, this is a purely mechanical change on the surface syntax that does not even incur a package rebuild. Running guix style -S inputs can do that for you, whether you’re working on packages in Guix proper or in an external channel.

La syntaxe générale est :

guix style [options] paquet

This causes guix style to analyze and rewrite the definition of package… or, when package is omitted, of all the packages. The --styling or -S option allows you to select the style rule, the default rule being format—see below.

Les options disponibles sont listées ci-dessous.


Show source file locations that would be edited but do not modify them.

-S rule

Apply rule, one of the following styling rules:


Format the given package definition(s)—this is the default styling rule. For example, a packager running Guix on a checkout (voir Lancer Guix avant qu'il ne soit installé) might want to reformat the definition of the Coreutils package like so:

./pre-inst-env guix style coreutils

Rewrite package inputs to the “new style”, as described above. This is how you would rewrite inputs of package whatnot in your own channel:

guix style -L ~/my/channel -S inputs whatnot

Rewriting is done in a conservative way: preserving comments and bailing out if it cannot make sense of the code that appears in an inputs field. The --input-simplification option described below provides fine-grain control over when inputs should be simplified.

-L répertoire

Ajoute répertoire au début du chemin de recherche de module de paquets (voir Modules de paquets).

-e expr

Style the package expr evaluates to.

Par exemple, lancer :

guix style -e '(@ (gnu packages gcc) gcc-5)'

styles the gcc-5 package definition.


When using the inputs styling rule, with ‘-S inputs’, this option specifies the package input simplification policy for cases where an input label does not match the corresponding package name. policy may be one of the following:


Simplify inputs only when the change is “silent”, meaning that the package does not need to be rebuilt (its derivation is unchanged).


Simplify inputs only when that is “safe” to do: the package might need to be rebuilt, but the change is known to have no observable effect.


Simplify inputs even when input labels do not match package names, and even if that might have an observable effect.

The default is silent, meaning that input simplifications do not trigger any package rebuild.

Suivant: , Précédent: , Monter: Utilitaires   [Table des matières][Index]