Settings

The registry settings can be used to customize the registry for all projects. If no registry is specified, the packages will be fetched via HTTP from the official registry. The registry settings are specified in the global configuration file.

Global configuration file

The global configuration file can be used to set default options across all fpm projects on the system. It is, by default, located at ~/.local/share/fpm/config.toml on Unix-like machines and %APPDATA%\local\fpm\config.toml on Windows and must be parsable to a TOML structure. It can be used to configure registry settings.

Cache du registre

Le cache du registre contient le code source des paquets précédemment téléchargés. Il sera d’abord interrogé pour les paquets existants qui satisfont aux exigences du projet demandeur avant que le paquet ne soit téléchargé. L’emplacement par défaut du cache est ~/.local/share/fpm/dependencies sur les machines de type Unix et %APPDATA%\local\fpm\dependencies sur Windows. L’emplacement du cache peut être modifié en définissant cache_path dans le fichier de configuration globale :

[registry]
cache_path = "/path/to/cache"

Registre personnalisé

Si vous souhaitez utiliser un registre personnalisé, vous pouvez le spécifier dans le fichier de configuration globale :

[registry]
url = "https://my-registry.com"

Votre registre doit mettre en œuvre la même API que le registre officiel.

Registre local

Utilisez la configuration suivante si vous souhaitez mettre en place un registre local :

[registry]
path = "/path/to/registry"

fpm recherchera les paquets dans ce répertoire et ne téléchargera pas de paquets depuis internet et ne récupérera pas de paquets depuis le cache.

Le répertoire doit être structuré selon le modèle attendu par fpm. Un paquet doit être situé dans un répertoire nommé d’après le nom de l’espace de noms, suivi du nom du paquet et de sa version. Par exemple, le paquet my-package avec la version 0.1.0, qui fait partie de my-namespace, doit se trouver dans le répertoire <path_to_local_registry>/my-namespace/my-package/0.1.0 sur les systèmes de type Unix. Le répertoire du paquet doit contenir un fichier fpm.toml qui contient les métadonnées du paquet. Le manifeste doit donc se trouver à l’adresse <path_to_local_registry>/my-namespace/my-package/0.1.0/fpm.toml.

If a specific version is requested, fpm will look for that version in the local registry. If you do not specify a version, fpm will look for the version with the highest precedence.

For instructions on how to set up project dependencies in fpm.toml when using a registry see