Packaging Cahute

Cahute is constituted of a static library, a set of utilities, and a set of udev rules. Due to the last element having to be installed for both, only the following package organisations are available:

• Having one package for both the static library and utilities.

• Having one package for the static library, either a package for all utilities or a package for each utility, and a package for installing the udev rules, of which all previous package depend.

For more about the rationale behind this document, consult the Archlinux CMake packaging guidelines.

Preparing the dependencies

Cahute depends on the following, build-only dependencies:

• cmake >= 3.16;

• Python >= 3.8;

• toml module for Python, either installed through pip or as a native package such as python-toml or python3-toml;

• GNU Make, pkg-config, and other C compilation and linking utilities.

It also depends on the following build and runtime dependencies:

• libusb;

• SDL >= 2.0 (for p7screen).

Producing the distribution directory

You first need to retrieve the source directory, named “cahute-0.3”, using one of the following methods:

• You can download the latest source package at https://ftp.cahuteproject.org/releases:

  curl -o cahute-0.3.tar.gz https://ftp.cahuteproject.org/releases/cahute-0.3.tar.gz
  tar xvaf cahute-0.3.tar.gz

• You can clone the repository and checkout the tag corresponding to the release:

  git clone https://gitlab.com/cahuteproject/cahute.git cahute-0.3
  (cd cahute-0.3 && git checkout -f 0.3)

Now that you have the source directory, you can build it using the following commands:

cmake -B build -S cahute-0.3 -DCMAKE_INSTALL_PREFIX=/usr
cmake --build build

Once this is done, you can produce the distribution directory dist/ using the following command:

DESTDIR=./dist cmake --install build

Your distribution directory is ready; from there, the instructions are specific to your distribution.

Getting informed when a new version is released

Maintaining a package is a long-term process, and you need to stay informed when Cahute is updated so that you can update your package. Fortunately, there is a way to do just this!

As described in Release process, when a new release is created, a new entry is created on the Releases page of the Gitlab repository. You can subscribe to such events by creating a Gitlab.com account, and following the steps in Get notified when a release is created.

Note

You can check your notification settings at any time in Notifications.