2021-08-05 01:45:38 -04:00
|
|
|
|
;;; GNU Guix --- Functional package management for GNU
|
2023-01-09 02:46:57 -05:00
|
|
|
|
;;; Copyright © 2021-2023 Andrew Tropin <andrew@trop.in>
|
2021-08-05 01:45:38 -04:00
|
|
|
|
;;; Copyright © 2021 Xinglu Chen <public@yoctocell.xyz>
|
2023-01-05 09:36:29 -05:00
|
|
|
|
;;; Copyright © 2022-2023 Ludovic Courtès <ludo@gnu.org>
|
2023-10-11 07:57:19 -04:00
|
|
|
|
;;; Copyright © 2023 Carlo Zancanaro <carlo@zancanaro.id.au>
|
2021-08-05 01:45:38 -04:00
|
|
|
|
;;;
|
|
|
|
|
;;; This file is part of GNU Guix.
|
|
|
|
|
;;;
|
|
|
|
|
;;; GNU Guix is free software; you can redistribute it and/or modify it
|
|
|
|
|
;;; under the terms of the GNU General Public License as published by
|
|
|
|
|
;;; the Free Software Foundation; either version 3 of the License, or (at
|
|
|
|
|
;;; your option) any later version.
|
|
|
|
|
;;;
|
|
|
|
|
;;; GNU Guix is distributed in the hope that it will be useful, but
|
|
|
|
|
;;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
;;; GNU General Public License for more details.
|
|
|
|
|
;;;
|
|
|
|
|
;;; You should have received a copy of the GNU General Public License
|
|
|
|
|
;;; along with GNU Guix. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
|
2021-10-09 09:51:25 -04:00
|
|
|
|
(define-module (gnu home services)
|
2021-08-05 01:45:38 -04:00
|
|
|
|
#:use-module (gnu services)
|
2021-12-22 10:37:09 -05:00
|
|
|
|
#:use-module ((gnu packages package-management) #:select (guix))
|
2022-07-26 06:10:08 -04:00
|
|
|
|
#:use-module ((gnu packages base) #:select (coreutils))
|
2021-08-05 01:45:38 -04:00
|
|
|
|
#:use-module (guix channels)
|
|
|
|
|
#:use-module (guix monads)
|
|
|
|
|
#:use-module (guix store)
|
|
|
|
|
#:use-module (guix gexp)
|
|
|
|
|
#:use-module (guix profiles)
|
|
|
|
|
#:use-module (guix sets)
|
|
|
|
|
#:use-module (guix ui)
|
|
|
|
|
#:use-module (guix discovery)
|
|
|
|
|
#:use-module (guix diagnostics)
|
2021-12-22 10:37:09 -05:00
|
|
|
|
#:use-module (guix i18n)
|
2022-02-01 14:48:35 -05:00
|
|
|
|
#:use-module (guix modules)
|
2023-08-06 12:25:22 -04:00
|
|
|
|
#:use-module (guix memoization)
|
2021-08-05 01:45:38 -04:00
|
|
|
|
#:use-module (srfi srfi-1)
|
2022-12-26 13:11:27 -05:00
|
|
|
|
#:use-module (srfi srfi-9)
|
2021-08-05 01:45:38 -04:00
|
|
|
|
#:use-module (ice-9 match)
|
2022-06-01 10:53:01 -04:00
|
|
|
|
#:use-module (ice-9 vlist)
|
2021-08-05 01:45:38 -04:00
|
|
|
|
|
|
|
|
|
#:export (home-service-type
|
|
|
|
|
home-profile-service-type
|
|
|
|
|
home-environment-variables-service-type
|
|
|
|
|
home-files-service-type
|
2022-02-11 03:03:02 -05:00
|
|
|
|
home-xdg-configuration-files-service-type
|
2022-03-29 05:47:39 -04:00
|
|
|
|
home-xdg-data-files-service-type
|
2021-08-05 01:45:38 -04:00
|
|
|
|
home-run-on-first-login-service-type
|
2021-08-05 01:46:22 -04:00
|
|
|
|
home-activation-service-type
|
2021-08-05 01:46:58 -04:00
|
|
|
|
home-run-on-change-service-type
|
|
|
|
|
home-provenance-service-type
|
|
|
|
|
|
2022-12-26 13:11:27 -05:00
|
|
|
|
literal-string
|
|
|
|
|
literal-string?
|
|
|
|
|
literal-string-value
|
|
|
|
|
|
2023-07-06 10:53:21 -04:00
|
|
|
|
with-shell-quotation-bindings
|
2022-07-13 18:54:40 -04:00
|
|
|
|
environment-variable-shell-definitions
|
2022-02-11 02:55:01 -05:00
|
|
|
|
home-files-directory
|
2022-02-11 03:03:02 -05:00
|
|
|
|
xdg-configuration-files-directory
|
2022-03-29 05:47:39 -04:00
|
|
|
|
xdg-data-files-directory
|
2022-02-11 02:55:01 -05:00
|
|
|
|
|
2021-12-22 10:37:09 -05:00
|
|
|
|
fold-home-service-types
|
2022-06-01 10:53:01 -04:00
|
|
|
|
lookup-home-service-types
|
2022-01-23 10:21:03 -05:00
|
|
|
|
home-provenance
|
2021-12-22 10:37:09 -05:00
|
|
|
|
|
2023-08-06 12:25:22 -04:00
|
|
|
|
define-service-type-mapping
|
|
|
|
|
system->home-service-type
|
|
|
|
|
|
2021-12-22 10:37:09 -05:00
|
|
|
|
%initialize-gettext)
|
2021-08-05 01:45:38 -04:00
|
|
|
|
|
|
|
|
|
#:re-export (service
|
|
|
|
|
service-type
|
2023-08-06 12:25:22 -04:00
|
|
|
|
service-extension
|
|
|
|
|
for-home
|
|
|
|
|
for-home?))
|
2021-08-05 01:45:38 -04:00
|
|
|
|
|
|
|
|
|
;;; Comment:
|
|
|
|
|
;;;
|
|
|
|
|
;;; This module is similar to (gnu system services) module, but
|
|
|
|
|
;;; provides Home Services, which are supposed to be used for building
|
|
|
|
|
;;; home-environment.
|
|
|
|
|
;;;
|
|
|
|
|
;;; Home Services use the same extension as System Services. Consult
|
|
|
|
|
;;; (gnu system services) module or manual for more information.
|
|
|
|
|
;;;
|
|
|
|
|
;;; home-service-type is a root of home services DAG.
|
|
|
|
|
;;;
|
|
|
|
|
;;; home-profile-service-type is almost the same as profile-service-type, at least
|
|
|
|
|
;;; for now.
|
|
|
|
|
;;;
|
|
|
|
|
;;; home-environment-variables-service-type generates a @file{setup-environment}
|
|
|
|
|
;;; shell script, which is expected to be sourced by login shell or other program,
|
|
|
|
|
;;; which starts early and spawns all other processes. Home services for shells
|
|
|
|
|
;;; automatically add code for sourcing this file, if person do not use those home
|
|
|
|
|
;;; services they have to source this script manually in their's shell *profile
|
|
|
|
|
;;; file (details described in the manual).
|
|
|
|
|
;;;
|
|
|
|
|
;;; home-files-service-type is similar to etc-service-type, but doesn't extend
|
2022-02-11 02:55:01 -05:00
|
|
|
|
;;; home-activation, because deploy mechanism for config files is pluggable
|
|
|
|
|
;;; and can be different for different home environments: The default one is
|
|
|
|
|
;;; called symlink-manager, which creates links for various dotfiles and xdg
|
|
|
|
|
;;; configuration files to store, but is possible to implement alternative
|
|
|
|
|
;;; approaches like read-only home from Julien's guix-home-manager.
|
2021-08-05 01:45:38 -04:00
|
|
|
|
;;;
|
|
|
|
|
;;; home-run-on-first-login-service-type provides an @file{on-first-login} guile
|
|
|
|
|
;;; script, which runs provided gexps once, when user makes first login. It can
|
|
|
|
|
;;; be used to start user's Shepherd and maybe some other process. It relies on
|
|
|
|
|
;;; assumption that /run/user/$UID will be created on login by some login
|
|
|
|
|
;;; manager (elogind for example).
|
|
|
|
|
;;;
|
|
|
|
|
;;; home-activation-service-type provides an @file{activate} guile script, which
|
|
|
|
|
;;; do three main things:
|
|
|
|
|
;;;
|
|
|
|
|
;;; - Sets environment variables to the values declared in
|
|
|
|
|
;;; @file{setup-environment} shell script. It's necessary, because user can set
|
|
|
|
|
;;; for example XDG_CONFIG_HOME and it should be respected by activation gexp of
|
|
|
|
|
;;; symlink-manager.
|
|
|
|
|
;;;
|
|
|
|
|
;;; - Sets GUIX_NEW_HOME and possibly GUIX_OLD_HOME vars to paths in the store.
|
|
|
|
|
;;; Later those variables can be used by activation gexps, for example by
|
|
|
|
|
;;; symlink-manager or run-on-change services.
|
|
|
|
|
;;;
|
|
|
|
|
;;; - Run all activation gexps provided by other home services.
|
|
|
|
|
;;;
|
2021-08-05 01:46:22 -04:00
|
|
|
|
;;; home-run-on-change-service-type allows to trigger actions during
|
|
|
|
|
;;; activation if file or directory specified by pattern is changed.
|
|
|
|
|
;;;
|
2021-08-05 01:45:38 -04:00
|
|
|
|
;;; Code:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(define (home-derivation entries mextensions)
|
|
|
|
|
"Return as a monadic value the derivation of the 'home'
|
|
|
|
|
directory containing the given entries."
|
|
|
|
|
(mlet %store-monad ((extensions (mapm/accumulate-builds identity
|
|
|
|
|
mextensions)))
|
|
|
|
|
(lower-object
|
|
|
|
|
(file-union "home" (append entries (concatenate extensions))))))
|
|
|
|
|
|
|
|
|
|
(define home-service-type
|
|
|
|
|
;; This is the ultimate service type, the root of the home service
|
|
|
|
|
;; DAG. The service of this type is extended by monadic name/item
|
|
|
|
|
;; pairs. These items end up in the "home-environment directory" as
|
|
|
|
|
;; returned by 'home-environment-derivation'.
|
|
|
|
|
(service-type (name 'home)
|
|
|
|
|
(extensions '())
|
|
|
|
|
(compose identity)
|
|
|
|
|
(extend home-derivation)
|
|
|
|
|
(default-value '())
|
|
|
|
|
(description
|
|
|
|
|
"Build the home environment top-level directory,
|
|
|
|
|
which in turn refers to everything the home environment needs: its
|
|
|
|
|
packages, configuration files, activation script, and so on.")))
|
|
|
|
|
|
|
|
|
|
(define (packages->profile-entry packages)
|
|
|
|
|
"Return a system entry for the profile containing PACKAGES."
|
|
|
|
|
;; XXX: 'mlet' is needed here for one reason: to get the proper
|
|
|
|
|
;; '%current-target' and '%current-target-system' bindings when
|
|
|
|
|
;; 'packages->manifest' is called, and thus when the 'package-inputs'
|
|
|
|
|
;; etc. procedures are called on PACKAGES. That way, conditionals in those
|
|
|
|
|
;; inputs see the "correct" value of these two parameters. See
|
|
|
|
|
;; <https://issues.guix.gnu.org/44952>.
|
|
|
|
|
(mlet %store-monad ((_ (current-target-system)))
|
|
|
|
|
(return `(("profile" ,(profile
|
|
|
|
|
(content (packages->manifest
|
|
|
|
|
(map identity
|
|
|
|
|
;;(options->transformation transformations)
|
|
|
|
|
(delete-duplicates packages eq?))))))))))
|
|
|
|
|
|
|
|
|
|
;; MAYBE: Add a list of transformations for packages. It's better to
|
|
|
|
|
;; place it in home-profile-service-type to affect all profile
|
|
|
|
|
;; packages and prevent conflicts, when other packages relies on
|
|
|
|
|
;; non-transformed version of package.
|
|
|
|
|
(define home-profile-service-type
|
|
|
|
|
(service-type (name 'home-profile)
|
|
|
|
|
(extensions
|
|
|
|
|
(list (service-extension home-service-type
|
|
|
|
|
packages->profile-entry)))
|
|
|
|
|
(compose concatenate)
|
|
|
|
|
(extend append)
|
|
|
|
|
(description
|
|
|
|
|
"This is the @dfn{home profile} and can be found in
|
|
|
|
|
@file{~/.guix-home/profile}. It contains packages and
|
|
|
|
|
configuration files that the user has declared in their
|
|
|
|
|
@code{home-environment} record.")))
|
|
|
|
|
|
2022-12-26 13:11:27 -05:00
|
|
|
|
;; Representation of a literal string.
|
|
|
|
|
(define-record-type <literal-string>
|
|
|
|
|
(literal-string str)
|
|
|
|
|
literal-string?
|
|
|
|
|
(str literal-string-value))
|
|
|
|
|
|
2023-07-06 10:53:21 -04:00
|
|
|
|
(define (with-shell-quotation-bindings exp)
|
|
|
|
|
"Insert EXP, a gexp, in a lexical environment providing the
|
|
|
|
|
'shell-single-quote' and 'shell-double-quote' bindings."
|
|
|
|
|
#~(let* ((quote-string
|
2022-12-26 13:11:27 -05:00
|
|
|
|
(lambda (value quoted-chars)
|
|
|
|
|
(list->string (string-fold-right
|
2022-07-13 18:54:40 -04:00
|
|
|
|
(lambda (chr lst)
|
2022-12-26 13:11:27 -05:00
|
|
|
|
(if (memq chr quoted-chars)
|
2023-01-09 03:22:56 -05:00
|
|
|
|
(append (list #\\ chr) lst)
|
2022-12-26 13:11:27 -05:00
|
|
|
|
(cons chr lst)))
|
2022-07-13 18:54:40 -04:00
|
|
|
|
'()
|
|
|
|
|
value))))
|
2022-12-26 13:11:27 -05:00
|
|
|
|
(shell-double-quote
|
|
|
|
|
(lambda (value)
|
|
|
|
|
;; Double-quote VALUE, leaving dollar sign as is.
|
|
|
|
|
(string-append "\"" (quote-string value '(#\" #\\))
|
|
|
|
|
"\"")))
|
|
|
|
|
(shell-single-quote
|
|
|
|
|
(lambda (value)
|
|
|
|
|
;; Single-quote VALUE to enter a literal string.
|
2023-01-05 09:36:29 -05:00
|
|
|
|
(string-append "'" (quote-string value '(#\'))
|
2022-12-26 13:11:27 -05:00
|
|
|
|
"'"))))
|
2023-07-06 10:53:21 -04:00
|
|
|
|
#$exp))
|
|
|
|
|
|
|
|
|
|
(define (environment-variable-shell-definitions variables)
|
|
|
|
|
"Return a gexp that evaluates to a list of POSIX shell statements defining
|
|
|
|
|
VARIABLES, a list of environment variable name/value pairs. The returned code
|
|
|
|
|
ensures variable values are properly quoted."
|
|
|
|
|
(with-shell-quotation-bindings
|
|
|
|
|
#~(string-append
|
|
|
|
|
#$@(map (match-lambda
|
|
|
|
|
((key . #f)
|
|
|
|
|
"")
|
|
|
|
|
((key . #t)
|
|
|
|
|
#~(string-append "export " #$key "\n"))
|
|
|
|
|
((key . (or (? string? value)
|
|
|
|
|
(? file-like? value)
|
|
|
|
|
(? gexp? value)))
|
|
|
|
|
#~(string-append "export " #$key "="
|
|
|
|
|
(shell-double-quote #$value)
|
|
|
|
|
"\n"))
|
|
|
|
|
((key . (? literal-string? value))
|
|
|
|
|
#~(string-append "export " #$key "="
|
|
|
|
|
(shell-single-quote
|
|
|
|
|
#$(literal-string-value value))
|
|
|
|
|
"\n")))
|
|
|
|
|
variables))))
|
2022-07-13 18:54:40 -04:00
|
|
|
|
|
2021-08-05 01:45:38 -04:00
|
|
|
|
(define (environment-variables->setup-environment-script vars)
|
|
|
|
|
"Return a file that can be sourced by a POSIX compliant shell which
|
|
|
|
|
initializes the environment. The file will source the home
|
|
|
|
|
environment profile, set some default environment variables, and set
|
|
|
|
|
environment variables provided in @code{vars}. @code{vars} is a list
|
|
|
|
|
of pairs (@code{(key . value)}), @code{key} is a string and
|
|
|
|
|
@code{value} is a string or gexp.
|
|
|
|
|
|
|
|
|
|
If value is @code{#f} variable will be omitted.
|
|
|
|
|
If value is @code{#t} variable will be just exported.
|
|
|
|
|
For any other, value variable will be set to the @code{value} and
|
|
|
|
|
exported."
|
2022-07-13 11:00:00 -04:00
|
|
|
|
(define (warn-about-duplicate-definitions)
|
2021-08-05 01:45:38 -04:00
|
|
|
|
(fold
|
|
|
|
|
(lambda (x acc)
|
|
|
|
|
(when (equal? (car x) (car acc))
|
|
|
|
|
(warning
|
|
|
|
|
(G_ "duplicate definition for `~a' environment variable ~%") (car x)))
|
|
|
|
|
x)
|
|
|
|
|
(cons "" "")
|
|
|
|
|
(sort vars (lambda (a b)
|
|
|
|
|
(string<? (car a) (car b))))))
|
|
|
|
|
|
2022-07-13 11:00:00 -04:00
|
|
|
|
(warn-about-duplicate-definitions)
|
2021-08-05 01:45:38 -04:00
|
|
|
|
(with-monad
|
|
|
|
|
%store-monad
|
|
|
|
|
(return
|
|
|
|
|
`(("setup-environment"
|
|
|
|
|
;; TODO: It's necessary to source ~/.guix-profile too
|
|
|
|
|
;; on foreign distros
|
2022-07-13 18:54:40 -04:00
|
|
|
|
,(computed-file "setup-environment"
|
|
|
|
|
#~(call-with-output-file #$output
|
|
|
|
|
(lambda (port)
|
|
|
|
|
(set-port-encoding! port "UTF-8")
|
|
|
|
|
(display "\
|
2021-08-05 01:45:38 -04:00
|
|
|
|
HOME_ENVIRONMENT=$HOME/.guix-home
|
|
|
|
|
GUIX_PROFILE=\"$HOME_ENVIRONMENT/profile\"
|
|
|
|
|
PROFILE_FILE=\"$HOME_ENVIRONMENT/profile/etc/profile\"
|
|
|
|
|
[ -f $PROFILE_FILE ] && . $PROFILE_FILE
|
|
|
|
|
|
|
|
|
|
case $XDG_DATA_DIRS in
|
|
|
|
|
*$HOME_ENVIRONMENT/profile/share*) ;;
|
|
|
|
|
*) export XDG_DATA_DIRS=$HOME_ENVIRONMENT/profile/share:$XDG_DATA_DIRS ;;
|
|
|
|
|
esac
|
|
|
|
|
case $MANPATH in
|
|
|
|
|
*$HOME_ENVIRONMENT/profile/share/man*) ;;
|
|
|
|
|
*) export MANPATH=$HOME_ENVIRONMENT/profile/share/man:$MANPATH
|
|
|
|
|
esac
|
|
|
|
|
case $INFOPATH in
|
|
|
|
|
*$HOME_ENVIRONMENT/profile/share/info*) ;;
|
|
|
|
|
*) export INFOPATH=$HOME_ENVIRONMENT/profile/share/info:$INFOPATH ;;
|
|
|
|
|
esac
|
|
|
|
|
case $XDG_CONFIG_DIRS in
|
|
|
|
|
*$HOME_ENVIRONMENT/profile/etc/xdg*) ;;
|
|
|
|
|
*) export XDG_CONFIG_DIRS=$HOME_ENVIRONMENT/profile/etc/xdg:$XDG_CONFIG_DIRS ;;
|
|
|
|
|
esac
|
|
|
|
|
case $XCURSOR_PATH in
|
|
|
|
|
*$HOME_ENVIRONMENT/profile/share/icons*) ;;
|
|
|
|
|
*) export XCURSOR_PATH=$HOME_ENVIRONMENT/profile/share/icons:$XCURSOR_PATH ;;
|
|
|
|
|
esac
|
|
|
|
|
|
2022-07-13 18:54:40 -04:00
|
|
|
|
" port)
|
|
|
|
|
(display
|
|
|
|
|
#$(environment-variable-shell-definitions vars)
|
|
|
|
|
port)))))))))
|
2021-08-05 01:45:38 -04:00
|
|
|
|
|
|
|
|
|
(define home-environment-variables-service-type
|
|
|
|
|
(service-type (name 'home-environment-variables)
|
|
|
|
|
(extensions
|
|
|
|
|
(list (service-extension
|
|
|
|
|
home-service-type
|
|
|
|
|
environment-variables->setup-environment-script)))
|
|
|
|
|
(compose concatenate)
|
|
|
|
|
(extend append)
|
|
|
|
|
(default-value '())
|
|
|
|
|
(description "Set the environment variables.")))
|
|
|
|
|
|
|
|
|
|
(define (files->files-directory files)
|
|
|
|
|
"Return a @code{files} directory that contains FILES."
|
|
|
|
|
(define (assert-no-duplicates files)
|
|
|
|
|
(let loop ((files files)
|
|
|
|
|
(seen (set)))
|
|
|
|
|
(match files
|
|
|
|
|
(() #t)
|
|
|
|
|
(((file _) rest ...)
|
|
|
|
|
(when (set-contains? seen file)
|
|
|
|
|
(raise (formatted-message (G_ "duplicate '~a' entry for files/")
|
|
|
|
|
file)))
|
|
|
|
|
(loop rest (set-insert file seen))))))
|
|
|
|
|
|
|
|
|
|
;; Detect duplicates early instead of letting them through, eventually
|
|
|
|
|
;; leading to a build failure of "files.drv".
|
|
|
|
|
(assert-no-duplicates files)
|
|
|
|
|
|
|
|
|
|
(file-union "files" files))
|
|
|
|
|
|
2022-02-11 02:55:01 -05:00
|
|
|
|
;; Used by symlink-manager
|
|
|
|
|
(define home-files-directory "files")
|
|
|
|
|
|
2021-08-05 01:45:38 -04:00
|
|
|
|
(define (files-entry files)
|
|
|
|
|
"Return an entry for the @file{~/.guix-home/files}
|
|
|
|
|
directory containing FILES."
|
|
|
|
|
(with-monad %store-monad
|
2022-02-11 02:55:01 -05:00
|
|
|
|
(return `((,home-files-directory ,(files->files-directory files))))))
|
2021-08-05 01:45:38 -04:00
|
|
|
|
|
|
|
|
|
(define home-files-service-type
|
|
|
|
|
(service-type (name 'home-files)
|
|
|
|
|
(extensions
|
|
|
|
|
(list (service-extension home-service-type
|
|
|
|
|
files-entry)))
|
|
|
|
|
(compose concatenate)
|
|
|
|
|
(extend append)
|
|
|
|
|
(default-value '())
|
2022-02-11 02:55:01 -05:00
|
|
|
|
(description "Files that will be put in
|
2022-12-29 19:14:26 -05:00
|
|
|
|
@file{~/.guix-home/files}, and further processed during activation.")))
|
2021-08-05 01:45:38 -04:00
|
|
|
|
|
2022-03-29 04:28:30 -04:00
|
|
|
|
(define xdg-configuration-files-directory ".config")
|
2022-02-11 03:03:02 -05:00
|
|
|
|
|
|
|
|
|
(define (xdg-configuration-files files)
|
2022-03-29 04:28:30 -04:00
|
|
|
|
"Add .config/ prefix to each file-path in FILES."
|
2022-02-11 03:03:02 -05:00
|
|
|
|
(map (match-lambda
|
|
|
|
|
((file-path . rest)
|
|
|
|
|
(cons (string-append xdg-configuration-files-directory "/" file-path)
|
|
|
|
|
rest)))
|
|
|
|
|
files))
|
|
|
|
|
|
|
|
|
|
(define home-xdg-configuration-files-service-type
|
2022-03-29 04:28:30 -04:00
|
|
|
|
(service-type (name 'home-xdg-configuration)
|
2022-02-11 03:03:02 -05:00
|
|
|
|
(extensions
|
|
|
|
|
(list (service-extension home-files-service-type
|
|
|
|
|
xdg-configuration-files)))
|
|
|
|
|
(compose concatenate)
|
|
|
|
|
(extend append)
|
|
|
|
|
(default-value '())
|
|
|
|
|
(description "Files that will be put in
|
2022-12-29 19:14:26 -05:00
|
|
|
|
@file{~/.guix-home/files/.config}, and further processed during activation.")))
|
2022-02-11 03:03:02 -05:00
|
|
|
|
|
2022-03-29 05:47:39 -04:00
|
|
|
|
(define xdg-data-files-directory ".local/share")
|
|
|
|
|
|
|
|
|
|
(define (xdg-data-files files)
|
|
|
|
|
"Add .local/share prefix to each file-path in FILES."
|
|
|
|
|
(map (match-lambda
|
|
|
|
|
((file-path . rest)
|
|
|
|
|
(cons (string-append xdg-data-files-directory "/" file-path)
|
|
|
|
|
rest)))
|
|
|
|
|
files))
|
|
|
|
|
|
|
|
|
|
(define home-xdg-data-files-service-type
|
|
|
|
|
(service-type (name 'home-xdg-data)
|
|
|
|
|
(extensions
|
|
|
|
|
(list (service-extension home-files-service-type
|
|
|
|
|
xdg-data-files)))
|
|
|
|
|
(compose concatenate)
|
|
|
|
|
(extend append)
|
|
|
|
|
(default-value '())
|
|
|
|
|
(description "Files that will be put in
|
2022-12-29 19:14:26 -05:00
|
|
|
|
@file{~/.guix-home/files/.local/share}, and further processed during
|
2022-03-29 05:47:39 -04:00
|
|
|
|
activation.")))
|
|
|
|
|
|
|
|
|
|
|
2021-12-22 10:37:09 -05:00
|
|
|
|
(define %initialize-gettext
|
|
|
|
|
#~(begin
|
|
|
|
|
(bindtextdomain %gettext-domain
|
|
|
|
|
(string-append #$guix "/share/locale"))
|
2022-02-01 14:48:35 -05:00
|
|
|
|
(textdomain %gettext-domain)))
|
2021-12-22 10:37:09 -05:00
|
|
|
|
|
2021-08-05 01:45:38 -04:00
|
|
|
|
(define (compute-on-first-login-script _ gexps)
|
2021-11-16 07:19:21 -05:00
|
|
|
|
(program-file
|
2021-08-05 01:45:38 -04:00
|
|
|
|
"on-first-login"
|
2022-08-02 01:20:38 -04:00
|
|
|
|
(with-imported-modules (source-module-closure '((guix i18n)
|
|
|
|
|
(guix diagnostics)))
|
2022-02-01 14:48:35 -05:00
|
|
|
|
#~(begin
|
2022-08-02 01:20:38 -04:00
|
|
|
|
(use-modules (guix i18n)
|
|
|
|
|
(guix diagnostics))
|
2023-10-11 07:57:19 -04:00
|
|
|
|
|
|
|
|
|
(define (claim-first-run file)
|
|
|
|
|
(catch #t
|
|
|
|
|
(lambda ()
|
|
|
|
|
;; This incantation raises an error if FILE already exists, and
|
|
|
|
|
;; creates it otherwise.
|
|
|
|
|
(close-fdes
|
|
|
|
|
(open-fdes file (logior O_CREAT O_EXCL O_CLOEXEC)))
|
|
|
|
|
#t)
|
|
|
|
|
(const #f)))
|
|
|
|
|
|
2021-12-22 10:37:09 -05:00
|
|
|
|
#$%initialize-gettext
|
|
|
|
|
|
|
|
|
|
(let* ((xdg-runtime-dir (or (getenv "XDG_RUNTIME_DIR")
|
|
|
|
|
(format #f "/run/user/~a" (getuid))))
|
|
|
|
|
(flag-file-path (string-append
|
2023-10-11 07:57:19 -04:00
|
|
|
|
xdg-runtime-dir "/on-first-login-executed")))
|
2021-12-22 10:37:09 -05:00
|
|
|
|
;; XDG_RUNTIME_DIR dissapears on logout, that means such trick
|
|
|
|
|
;; allows to launch on-first-login script on first login only
|
|
|
|
|
;; after complete logout/reboot.
|
|
|
|
|
(if (file-exists? xdg-runtime-dir)
|
2023-10-11 07:57:19 -04:00
|
|
|
|
(when (claim-first-run flag-file-path)
|
2023-10-21 04:37:53 -04:00
|
|
|
|
(begin #$@gexps)) ;GEXPS can be empty, hence 'begin'
|
2021-12-22 10:37:09 -05:00
|
|
|
|
;; TRANSLATORS: 'on-first-login' is the name of a service and
|
|
|
|
|
;; shouldn't be translated
|
2022-08-02 01:20:38 -04:00
|
|
|
|
(warning (G_ "XDG_RUNTIME_DIR doesn't exists, on-first-login script
|
2021-10-07 01:12:04 -04:00
|
|
|
|
won't execute anything. You can check if xdg runtime directory exists,
|
2021-11-17 15:09:36 -05:00
|
|
|
|
XDG_RUNTIME_DIR variable is set to appropriate value and manually execute the
|
2022-02-01 14:48:35 -05:00
|
|
|
|
script by running '$HOME/.guix-home/on-first-login'"))))))))
|
2021-08-05 01:45:38 -04:00
|
|
|
|
|
2021-11-16 07:19:21 -05:00
|
|
|
|
(define (on-first-login-script-entry on-first-login)
|
2021-08-05 01:45:38 -04:00
|
|
|
|
"Return, as a monadic value, an entry for the on-first-login script
|
|
|
|
|
in the home environment directory."
|
2021-11-16 07:19:21 -05:00
|
|
|
|
(with-monad %store-monad
|
|
|
|
|
(return `(("on-first-login" ,on-first-login)))))
|
2021-08-05 01:45:38 -04:00
|
|
|
|
|
|
|
|
|
(define home-run-on-first-login-service-type
|
|
|
|
|
(service-type (name 'home-run-on-first-login)
|
|
|
|
|
(extensions
|
|
|
|
|
(list (service-extension
|
|
|
|
|
home-service-type
|
|
|
|
|
on-first-login-script-entry)))
|
|
|
|
|
(compose identity)
|
|
|
|
|
(extend compute-on-first-login-script)
|
|
|
|
|
(default-value #f)
|
|
|
|
|
(description "Run gexps on first user login. Can be
|
|
|
|
|
extended with one gexp.")))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(define (compute-activation-script init-gexp gexps)
|
|
|
|
|
(gexp->script
|
|
|
|
|
"activate"
|
|
|
|
|
#~(let* ((he-init-file (lambda (he) (string-append he "/setup-environment")))
|
|
|
|
|
(he-path (string-append (getenv "HOME") "/.guix-home"))
|
|
|
|
|
(new-home-env (getenv "GUIX_NEW_HOME"))
|
|
|
|
|
(new-home (or new-home-env
|
2022-01-14 01:16:32 -05:00
|
|
|
|
;; Absolute path of the directory of the activation
|
|
|
|
|
;; file if called interactively.
|
|
|
|
|
(canonicalize-path (dirname (car (command-line))))))
|
2021-08-05 01:45:38 -04:00
|
|
|
|
(old-home-env (getenv "GUIX_OLD_HOME"))
|
|
|
|
|
(old-home (or old-home-env
|
|
|
|
|
(if (file-exists? (he-init-file he-path))
|
|
|
|
|
(readlink he-path)
|
|
|
|
|
#f))))
|
|
|
|
|
(if (file-exists? (he-init-file new-home))
|
|
|
|
|
(let* ((port ((@ (ice-9 popen) open-input-pipe)
|
2022-07-26 06:10:08 -04:00
|
|
|
|
(format #f "source ~a && ~a -0"
|
|
|
|
|
(he-init-file new-home)
|
|
|
|
|
#$(file-append coreutils "/bin/env"))))
|
2021-08-05 01:45:38 -04:00
|
|
|
|
(result ((@ (ice-9 rdelim) read-delimited) "" port))
|
|
|
|
|
(vars (map (lambda (x)
|
|
|
|
|
(let ((si (string-index x #\=)))
|
|
|
|
|
(cons (string-take x si)
|
|
|
|
|
(string-drop x (1+ si)))))
|
|
|
|
|
((@ (srfi srfi-1) remove)
|
|
|
|
|
string-null?
|
2021-08-30 05:26:19 -04:00
|
|
|
|
(string-split result #\nul)))))
|
2021-08-05 01:45:38 -04:00
|
|
|
|
(close-port port)
|
|
|
|
|
(map (lambda (x) (setenv (car x) (cdr x))) vars)
|
|
|
|
|
|
|
|
|
|
(setenv "GUIX_NEW_HOME" new-home)
|
|
|
|
|
(setenv "GUIX_OLD_HOME" old-home)
|
|
|
|
|
|
|
|
|
|
#$@gexps
|
|
|
|
|
|
|
|
|
|
;; Do not unset env variable if it was set outside.
|
|
|
|
|
(unless new-home-env (setenv "GUIX_NEW_HOME" #f))
|
|
|
|
|
(unless old-home-env (setenv "GUIX_OLD_HOME" #f)))
|
|
|
|
|
(format #t "\
|
2021-11-14 20:30:07 -05:00
|
|
|
|
Activation script was either called or loaded by file from this directory:
|
2021-08-05 01:45:38 -04:00
|
|
|
|
~a
|
|
|
|
|
It doesn't seem that home environment is somewhere around.
|
|
|
|
|
Make sure that you call ./activate by symlink from -home store item.\n"
|
|
|
|
|
new-home)))))
|
|
|
|
|
|
|
|
|
|
(define (activation-script-entry m-activation)
|
|
|
|
|
"Return, as a monadic value, an entry for the activation script
|
|
|
|
|
in the home environment directory."
|
|
|
|
|
(mlet %store-monad ((activation m-activation))
|
|
|
|
|
(return `(("activate" ,activation)))))
|
|
|
|
|
|
|
|
|
|
(define home-activation-service-type
|
|
|
|
|
(service-type (name 'home-activation)
|
|
|
|
|
(extensions
|
|
|
|
|
(list (service-extension
|
|
|
|
|
home-service-type
|
|
|
|
|
activation-script-entry)))
|
|
|
|
|
(compose identity)
|
|
|
|
|
(extend compute-activation-script)
|
|
|
|
|
(default-value #f)
|
|
|
|
|
(description "Run gexps to activate the current
|
|
|
|
|
generation of home environment and update the state of the home
|
|
|
|
|
directory. @command{activate} script automatically called during
|
|
|
|
|
reconfiguration or generation switching. This service can be extended
|
|
|
|
|
with one gexp, but many times, and all gexps must be idempotent.")))
|
|
|
|
|
|
2023-08-06 12:25:22 -04:00
|
|
|
|
|
|
|
|
|
;;;
|
|
|
|
|
;;; Service type graph rewriting.
|
|
|
|
|
;;;
|
|
|
|
|
|
|
|
|
|
(define (service-type-mapping proc)
|
|
|
|
|
"Return a procedure that applies PROC to map a service type graph to another
|
|
|
|
|
one."
|
|
|
|
|
(define (rewrite extension)
|
|
|
|
|
(match (proc (service-extension-target extension))
|
|
|
|
|
(#f #f)
|
|
|
|
|
(target
|
|
|
|
|
(service-extension target
|
|
|
|
|
(service-extension-compute extension)))))
|
|
|
|
|
|
|
|
|
|
(define replace
|
|
|
|
|
(mlambdaq (type)
|
|
|
|
|
(service-type
|
|
|
|
|
(inherit type)
|
|
|
|
|
(name (symbol-append 'home- (service-type-name type)))
|
|
|
|
|
(location (service-type-location type))
|
|
|
|
|
(extensions (filter-map rewrite (service-type-extensions type))))))
|
|
|
|
|
|
|
|
|
|
replace)
|
|
|
|
|
|
|
|
|
|
(define %system/home-service-type-mapping
|
|
|
|
|
;; Mapping of System to Home services.
|
|
|
|
|
(make-hash-table))
|
|
|
|
|
|
|
|
|
|
(define system->home-service-type
|
|
|
|
|
;; Map the given System service type to the corresponding Home service type.
|
|
|
|
|
(let ()
|
|
|
|
|
(define (replace type)
|
|
|
|
|
(define replacement
|
|
|
|
|
(hashq-ref %system/home-service-type-mapping type
|
|
|
|
|
*unspecified*))
|
|
|
|
|
|
|
|
|
|
(if (eq? replacement *unspecified*)
|
|
|
|
|
type
|
|
|
|
|
replacement))
|
|
|
|
|
|
|
|
|
|
(service-type-mapping replace)))
|
|
|
|
|
|
|
|
|
|
(define-syntax define-service-type-mapping
|
|
|
|
|
(syntax-rules (=>)
|
|
|
|
|
((_ system-type => home-type)
|
|
|
|
|
(hashq-set! %system/home-service-type-mapping
|
|
|
|
|
system-type home-type))))
|
|
|
|
|
|
|
|
|
|
(define-syntax define-service-type-mappings
|
|
|
|
|
(syntax-rules (=>)
|
|
|
|
|
((_ (system-type => home-type) ...)
|
|
|
|
|
(begin
|
|
|
|
|
(define-service-type-mapping system-type => home-type)
|
|
|
|
|
...))))
|
|
|
|
|
|
|
|
|
|
(define-service-type-mappings
|
|
|
|
|
(system-service-type => home-service-type)
|
|
|
|
|
(activation-service-type => home-activation-service-type)
|
|
|
|
|
(profile-service-type => home-profile-service-type))
|
|
|
|
|
|
2021-08-05 01:46:22 -04:00
|
|
|
|
|
|
|
|
|
;;;
|
|
|
|
|
;;; On-change.
|
|
|
|
|
;;;
|
|
|
|
|
|
|
|
|
|
(define (compute-on-change-gexp eval-gexps? pattern-gexp-tuples)
|
2022-02-01 14:48:35 -05:00
|
|
|
|
(with-imported-modules (source-module-closure '((guix i18n)))
|
|
|
|
|
#~(begin
|
2021-12-22 10:37:09 -05:00
|
|
|
|
(use-modules (guix i18n))
|
|
|
|
|
|
|
|
|
|
#$%initialize-gettext
|
|
|
|
|
|
2021-08-05 01:46:22 -04:00
|
|
|
|
(define (equal-regulars? file1 file2)
|
|
|
|
|
"Check if FILE1 and FILE2 are bit for bit identical."
|
|
|
|
|
(let* ((cmp-binary #$(file-append
|
|
|
|
|
(@ (gnu packages base) diffutils) "/bin/cmp"))
|
|
|
|
|
(stats1 (lstat file1))
|
|
|
|
|
(stats2 (lstat file2)))
|
|
|
|
|
(cond
|
|
|
|
|
((= (stat:ino stats1) (stat:ino stats2)) #t)
|
|
|
|
|
((not (= (stat:size stats1) (stat:size stats2))) #f)
|
|
|
|
|
|
|
|
|
|
(else (= (system* cmp-binary file1 file2) 0)))))
|
|
|
|
|
|
|
|
|
|
(define (equal-symlinks? symlink1 symlink2)
|
|
|
|
|
"Check if SYMLINK1 and SYMLINK2 are pointing to the same target."
|
|
|
|
|
(string=? (readlink symlink1) (readlink symlink2)))
|
|
|
|
|
|
|
|
|
|
(define (equal-directories? dir1 dir2)
|
|
|
|
|
"Check if DIR1 and DIR2 have the same content."
|
|
|
|
|
(define (ordinary-file file)
|
|
|
|
|
(not (or (string=? file ".")
|
|
|
|
|
(string=? file ".."))))
|
|
|
|
|
(let* ((files1 (scandir dir1 ordinary-file))
|
|
|
|
|
(files2 (scandir dir2 ordinary-file)))
|
|
|
|
|
(if (equal? files1 files2)
|
|
|
|
|
(map (lambda (file)
|
|
|
|
|
(equal-files?
|
|
|
|
|
(string-append dir1 "/" file)
|
|
|
|
|
(string-append dir2 "/" file)))
|
|
|
|
|
files1)
|
|
|
|
|
#f)))
|
|
|
|
|
|
|
|
|
|
(define (equal-files? file1 file2)
|
|
|
|
|
"Compares files, symlinks or directories of the same type."
|
|
|
|
|
(case (file-type file1)
|
|
|
|
|
((directory) (equal-directories? file1 file2))
|
|
|
|
|
((symlink) (equal-symlinks? file1 file2))
|
|
|
|
|
((regular) (equal-regulars? file1 file2))
|
|
|
|
|
(else
|
|
|
|
|
(display "The file type is unsupported by on-change service.\n")
|
|
|
|
|
#f)))
|
|
|
|
|
|
|
|
|
|
(define (file-type file)
|
|
|
|
|
(stat:type (lstat file)))
|
|
|
|
|
|
|
|
|
|
(define (something-changed? file1 file2)
|
|
|
|
|
(cond
|
|
|
|
|
((and (not (file-exists? file1))
|
|
|
|
|
(not (file-exists? file2))) #f)
|
|
|
|
|
((or (not (file-exists? file1))
|
|
|
|
|
(not (file-exists? file2))) #t)
|
|
|
|
|
|
|
|
|
|
((not (eq? (file-type file1) (file-type file2))) #t)
|
|
|
|
|
|
|
|
|
|
(else
|
|
|
|
|
(not (equal-files? file1 file2)))))
|
|
|
|
|
|
|
|
|
|
(define expressions-to-eval
|
|
|
|
|
(map
|
|
|
|
|
(lambda (x)
|
2021-08-31 08:24:25 -04:00
|
|
|
|
(let* ((file1 (string-append
|
|
|
|
|
(or (getenv "GUIX_OLD_HOME")
|
|
|
|
|
"/gnu/store/non-existing-generation")
|
|
|
|
|
"/" (car x)))
|
2021-08-05 01:46:22 -04:00
|
|
|
|
(file2 (string-append (getenv "GUIX_NEW_HOME") "/" (car x)))
|
2021-12-22 10:37:09 -05:00
|
|
|
|
(_ (format #t (G_ "Comparing ~a and\n~10t~a...") file1 file2))
|
2021-08-05 01:46:22 -04:00
|
|
|
|
(any-changes? (something-changed? file1 file2))
|
2021-12-22 10:37:09 -05:00
|
|
|
|
(_ (format #t (G_ " done (~a)\n")
|
2021-08-05 01:46:22 -04:00
|
|
|
|
(if any-changes? "changed" "same"))))
|
|
|
|
|
(if any-changes? (cadr x) "")))
|
|
|
|
|
'#$pattern-gexp-tuples))
|
|
|
|
|
|
|
|
|
|
(if #$eval-gexps?
|
|
|
|
|
(begin
|
2021-12-22 10:37:09 -05:00
|
|
|
|
;;; TRANSLATORS: 'on-change' is the name of a service type, it
|
|
|
|
|
;;; probably shouldn't be translated.
|
|
|
|
|
(display (G_ "Evaluating on-change gexps.\n\n"))
|
2021-08-05 01:46:22 -04:00
|
|
|
|
(for-each primitive-eval expressions-to-eval)
|
2021-12-22 10:37:09 -05:00
|
|
|
|
(display (G_ "On-change gexps evaluation finished.\n\n")))
|
2021-08-05 01:46:22 -04:00
|
|
|
|
(display "\
|
2021-12-22 10:37:09 -05:00
|
|
|
|
On-change gexps won't be evaluated; evaluation has been disabled in the
|
2022-02-01 14:48:35 -05:00
|
|
|
|
service configuration")))))
|
2021-08-05 01:46:22 -04:00
|
|
|
|
|
|
|
|
|
(define home-run-on-change-service-type
|
|
|
|
|
(service-type (name 'home-run-on-change)
|
|
|
|
|
(extensions
|
|
|
|
|
(list (service-extension
|
|
|
|
|
home-activation-service-type
|
|
|
|
|
identity)))
|
|
|
|
|
(compose concatenate)
|
|
|
|
|
(extend compute-on-change-gexp)
|
|
|
|
|
(default-value #t)
|
|
|
|
|
(description "\
|
|
|
|
|
G-expressions to run if the specified files have changed since the
|
|
|
|
|
last generation. The extension should be a list of lists where the
|
|
|
|
|
first element is the pattern for file or directory that expected to be
|
|
|
|
|
changed, and the second element is the G-expression to be evaluated.")))
|
2021-08-05 01:46:58 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
;;;
|
|
|
|
|
;;; Provenance tracking.
|
|
|
|
|
;;;
|
|
|
|
|
|
|
|
|
|
(define home-provenance-service-type
|
|
|
|
|
(service-type
|
|
|
|
|
(name 'home-provenance)
|
|
|
|
|
(extensions
|
|
|
|
|
(list (service-extension
|
|
|
|
|
home-service-type
|
|
|
|
|
(service-extension-compute
|
|
|
|
|
(first (service-type-extensions provenance-service-type))))))
|
|
|
|
|
(default-value #f) ;the HE config file
|
|
|
|
|
(description "\
|
|
|
|
|
Store provenance information about the home environment in the home
|
|
|
|
|
environment itself: the channels used when building the home
|
|
|
|
|
environment, and its configuration file, when available.")))
|
|
|
|
|
|
|
|
|
|
(define sexp->home-provenance sexp->system-provenance)
|
|
|
|
|
(define home-provenance system-provenance)
|
2021-08-05 01:47:40 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
;;;
|
|
|
|
|
;;; Searching
|
|
|
|
|
;;;
|
|
|
|
|
|
|
|
|
|
(define (parent-directory directory)
|
|
|
|
|
"Get the parent directory of DIRECTORY"
|
|
|
|
|
(string-join (drop-right (string-split directory #\/) 1) "/"))
|
|
|
|
|
|
|
|
|
|
(define %guix-home-root-directory
|
|
|
|
|
;; Absolute file name of the module hierarchy.
|
2021-10-09 07:52:10 -04:00
|
|
|
|
(parent-directory
|
|
|
|
|
(dirname (dirname (search-path %load-path "gnu/home/services.scm")))))
|
2021-08-05 01:47:40 -04:00
|
|
|
|
|
|
|
|
|
(define %service-type-path
|
|
|
|
|
;; Search path for service types.
|
2021-10-04 19:09:41 -04:00
|
|
|
|
(make-parameter `((,%guix-home-root-directory . "gnu/home/services"))))
|
2021-08-05 01:47:40 -04:00
|
|
|
|
|
|
|
|
|
(define (all-home-service-modules)
|
2021-10-04 19:09:41 -04:00
|
|
|
|
"Return the default set of `home service' modules."
|
2021-10-09 09:51:25 -04:00
|
|
|
|
(cons (resolve-interface '(gnu home services))
|
2021-08-05 01:47:40 -04:00
|
|
|
|
(all-modules (%service-type-path)
|
|
|
|
|
#:warn warn-about-load-error)))
|
|
|
|
|
|
|
|
|
|
(define* (fold-home-service-types proc seed)
|
|
|
|
|
(fold-service-types proc seed (all-home-service-modules)))
|
2022-06-01 10:53:01 -04:00
|
|
|
|
|
|
|
|
|
(define lookup-home-service-types
|
|
|
|
|
(let ((table
|
|
|
|
|
(delay (fold-home-service-types (lambda (type result)
|
|
|
|
|
(vhash-consq (service-type-name type)
|
|
|
|
|
type result))
|
|
|
|
|
vlist-null))))
|
|
|
|
|
(lambda (name)
|
|
|
|
|
"Return the list of services with the given NAME (a symbol)."
|
|
|
|
|
(vhash-foldq* cons '() name (force table)))))
|