Config File

About

The config file is usually located at ~/.config/gib/config, and written in a syntax similar to INI.

Syntax

Headers are case-sensitive, however the individual settings are not. This means [COMMANDS] ≠ [Commands] ≠ [commands], but InstallCommand = installcommand = INSTALLCOMMAND. There may or may not be spaces betweens the =s; both InstallCommand=pacman -Syu and InstallCommand = pacman -Syu are valid.

Valid Options

[COMMANDS] - Header for all the commands you need to supply for Gib to do its job.

InstallCommand - The command you use for the installation of packages, such as pkg install, apt install, or pacman -S.

UpdateCommand - The command you use to update respositories and upgrade your software, such as pkg update, apt update && apt upgrade, or pacman -Syu.

[REPOSITORY]

Repository{x}, with {x} being a number between 1 and ∞ - the URL to the repository you'd like to pull Giblets from, including the protocol and trailing /, ex: https://gib-pkg.sourceforge.io/repo/debian/.
Gib supports virtually infinite repositories. Repository1 will always be checked for the Giblet before Repository2, even if Repository2 comes physically before Repository1. If a respository number is missing from the list, all successive repositoies will be ignored.

[BEHAVIOUR]

NeedUpdateBeforeInstall - {y|yes|n|no}. Whether the UpdateCommand needs to be run before installing a Giblet. It's always a good idea to update your packages before installing new ones, however, some package managers (such as FreeBSD's pkg) will update all packages automatically before the installation of new packages, whereas others (such as pacman in Arch-based Linuxen) will not.

Example 'config' files

Arch-based Linuxen

[COMMANDS]
InstallCommand = pacman -S
UpdateCommand = pacman -Syu
[REPOSITORY]
Repository1 = https://gib-pkg.sourceforge.io/repo/arch/
[BEHAVIOUR]
NeedUpdateBeforeInstall = y

Debian

[COMMANDS]
InstallCommand = apt install
UpdateCommand = apt update && apt upgrade
[REPOSITORY]
Repository1 = https://gib-pkg.sourceforge.io/repo/debian/
[BEHAVIOUR]
NeedUpdateBeforeInstall = yes

FreeBSD

[COMMANDS]
InstallCommand = pkg install
UpdateCommand = pkg upgrade
[REPOSITORY]
Repository1 = https://gib-pkg.sourceforge.io/repo/freebsd/
[BEHAVIOUR]
NeedUpdateBeforeInstall = n