2024-01-13 08:15:51 +00:00
|
|
|
{ lib
|
|
|
|
, buildPackages
|
|
|
|
}:
|
|
|
|
|
|
|
|
let
|
|
|
|
# rudimentary support for cross-compiling
|
|
|
|
# see: https://github.com/NixOS/nixpkgs/pull/279487#discussion_r1444449726
|
|
|
|
inherit (buildPackages)
|
|
|
|
mktemp
|
|
|
|
rsync
|
|
|
|
;
|
|
|
|
in
|
|
|
|
|
2024-01-02 11:29:13 +00:00
|
|
|
rec {
|
|
|
|
/* Prepare a derivation for local builds.
|
|
|
|
*
|
2024-01-13 08:15:51 +00:00
|
|
|
* This function prepares checkpoint builds by storing
|
|
|
|
* the build output and the sources for cross checking.
|
2024-01-02 11:29:13 +00:00
|
|
|
* The build output can be used later to allow checkpoint builds
|
|
|
|
* by passing the derivation output to the `mkCheckpointBuild` function.
|
|
|
|
*
|
2024-01-13 08:15:51 +00:00
|
|
|
* To build a project with checkpoints, follow these steps:
|
|
|
|
* - run `prepareCheckpointBuild` on the desired derivation, e.g.
|
|
|
|
* checkpointArtifacts = prepareCheckpointBuild virtualbox;
|
|
|
|
* - change something you want in the sources of the package,
|
|
|
|
* e.g. using source override:
|
|
|
|
* changedVBox = pkgs.virtuabox.overrideAttrs (old: {
|
|
|
|
* src = path/to/vbox/sources;
|
|
|
|
* };
|
|
|
|
* - use `mkCheckpointBuild changedVBox checkpointArtifacts`
|
2024-01-02 11:29:13 +00:00
|
|
|
* - enjoy shorter build times
|
|
|
|
*/
|
|
|
|
prepareCheckpointBuild = drv: drv.overrideAttrs (old: {
|
|
|
|
outputs = [ "out" ];
|
|
|
|
name = drv.name + "-checkpointArtifacts";
|
|
|
|
# To determine differences between the state of the build directory
|
2024-01-13 08:15:51 +00:00
|
|
|
# from an earlier build and a later one we store the state of the build
|
2024-01-02 11:29:13 +00:00
|
|
|
# directory before build, but after patch phases.
|
|
|
|
# This way, the same derivation can be used multiple times and only changes are detected.
|
2024-01-13 08:15:51 +00:00
|
|
|
# Additionally, removed files are handled correctly in later builds.
|
2024-01-02 11:29:13 +00:00
|
|
|
preBuild = (old.preBuild or "") + ''
|
|
|
|
mkdir -p $out/sources
|
|
|
|
cp -r ./* $out/sources/
|
|
|
|
'';
|
|
|
|
|
2024-01-13 08:15:51 +00:00
|
|
|
# After the build, the build directory is copied again
|
2024-01-02 11:29:13 +00:00
|
|
|
# to get the output files.
|
2024-01-13 08:15:51 +00:00
|
|
|
# We copy the complete build folder, to take care of
|
|
|
|
# build tools that build in the source directory, instead of
|
|
|
|
# having a separate build directory such as the Linux kernel.
|
2024-01-02 11:29:13 +00:00
|
|
|
installPhase = ''
|
|
|
|
runHook preCheckpointInstall
|
|
|
|
mkdir -p $out/outputs
|
|
|
|
cp -r ./* $out/outputs/
|
|
|
|
runHook postCheckpointInstall
|
2024-04-21 15:54:59 +00:00
|
|
|
unset postPhases
|
2024-01-02 11:29:13 +00:00
|
|
|
'';
|
2024-04-21 15:54:59 +00:00
|
|
|
|
|
|
|
dontFixup = true;
|
|
|
|
doInstallCheck = false;
|
|
|
|
doDist = false;
|
2024-01-02 11:29:13 +00:00
|
|
|
});
|
|
|
|
|
|
|
|
/* Build a derivation based on the checkpoint output generated by
|
2024-01-13 08:15:51 +00:00
|
|
|
* the `prepareCheckpointBuild` function.
|
2024-01-02 11:29:13 +00:00
|
|
|
*
|
|
|
|
* Usage:
|
|
|
|
* let
|
2024-01-13 08:15:51 +00:00
|
|
|
* checkpointArtifacts = prepareCheckpointBuild drv;
|
|
|
|
* in mkCheckpointBuild drv checkpointArtifacts
|
2024-01-02 11:29:13 +00:00
|
|
|
*/
|
2024-01-13 08:15:51 +00:00
|
|
|
mkCheckpointBuild = drv: checkpointArtifacts: drv.overrideAttrs (old: {
|
2024-01-02 11:29:13 +00:00
|
|
|
# The actual checkpoint build phase.
|
2024-01-13 08:15:51 +00:00
|
|
|
# We compare the changed sources from a previous build with the current and create a patch.
|
|
|
|
# Afterwards we clean the build directory and copy the previous output files (including the sources).
|
|
|
|
# The source difference patch is then applied to get the latest changes again to allow short build times.
|
2024-01-02 11:29:13 +00:00
|
|
|
preBuild = (old.preBuild or "") + ''
|
|
|
|
set +e
|
2024-01-13 08:15:51 +00:00
|
|
|
sourceDifferencePatchFile=$(${mktemp}/bin/mktemp)
|
|
|
|
diff -ur ${checkpointArtifacts}/sources ./ > "$sourceDifferencePatchFile"
|
2024-01-02 11:29:13 +00:00
|
|
|
set -e
|
2024-01-13 08:15:51 +00:00
|
|
|
shopt -s dotglob
|
|
|
|
rm -r *
|
|
|
|
${rsync}/bin/rsync \
|
|
|
|
--checksum --times --atimes --chown=$USER:$USER --chmod=+w \
|
|
|
|
-r ${checkpointArtifacts}/outputs/ .
|
|
|
|
patch -p 1 -i "$sourceDifferencePatchFile"
|
|
|
|
rm "$sourceDifferencePatchFile"
|
2024-01-02 11:29:13 +00:00
|
|
|
'';
|
|
|
|
});
|
2024-01-13 08:15:51 +00:00
|
|
|
|
|
|
|
mkCheckpointedBuild = lib.warn
|
|
|
|
"`mkCheckpointedBuild` is deprecated, use `mkCheckpointBuild` instead!"
|
|
|
|
mkCheckpointBuild;
|
2024-01-02 11:29:13 +00:00
|
|
|
}
|