29de2edfbb
This guides newcomers who might stick a single (service …) form in this field. * gnu/services.scm (validate-service-list): New macro. (%validate-service-list): New procedure. * gnu/system.scm (<operating-system>)[services]: Add ‘sanitize’. * gnu/home.scm (<home-environment>)[services]: Add ‘sanitize’. Change-Id: I9e29bd9a078e87b627ab766fd669ba9de79f8473
154 lines
5.9 KiB
Scheme
154 lines
5.9 KiB
Scheme
;;; GNU Guix --- Functional package management for GNU
|
|
;;; Copyright © 2021 Andrew Tropin <andrew@trop.in>
|
|
;;; Copyright © 2022, 2024 Ludovic Courtès <ludo@gnu.org>
|
|
;;;
|
|
;;; 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/>.
|
|
|
|
(define-module (gnu home)
|
|
#:use-module (gnu home services)
|
|
#:use-module (gnu home services symlink-manager)
|
|
#:use-module (gnu home services shells)
|
|
#:use-module (gnu home services xdg)
|
|
#:use-module (gnu home services fontutils)
|
|
#:use-module (gnu services)
|
|
#:use-module (guix records)
|
|
#:use-module (guix diagnostics)
|
|
#:use-module (guix gexp)
|
|
#:use-module (guix store)
|
|
#:use-module (ice-9 match)
|
|
#:use-module (ice-9 regex)
|
|
#:export (home-environment
|
|
home-environment?
|
|
this-home-environment
|
|
|
|
home-environment-derivation
|
|
home-environment-packages
|
|
home-environment-user-services
|
|
home-environment-essential-services
|
|
home-environment-services
|
|
home-environment-location
|
|
|
|
home-environment-with-provenance
|
|
|
|
home-generation-base))
|
|
|
|
;;; Comment:
|
|
;;;
|
|
;;; This module provides a <home-environment> record for managing
|
|
;;; per-user packages and configuration files in the similar way as
|
|
;;; <operating-system> do for system packages and configuration files.
|
|
;;;
|
|
;;; Code:
|
|
|
|
(define-record-type* <home-environment> home-environment
|
|
make-home-environment
|
|
home-environment?
|
|
this-home-environment
|
|
|
|
(packages home-environment-packages ; list of (PACKAGE OUTPUT...)
|
|
(default '()))
|
|
|
|
(essential-services home-environment-essential-services ; list of services
|
|
(thunked)
|
|
(default (home-environment-default-essential-services
|
|
this-home-environment)))
|
|
|
|
(services home-environment-user-services
|
|
(default '())
|
|
(sanitize validate-service-list))
|
|
|
|
(location home-environment-location ; <location>
|
|
(default (and=> (current-source-location)
|
|
source-properties->location))
|
|
(innate)))
|
|
|
|
(define (home-environment-default-essential-services he)
|
|
"Return the list of essential services for home environment."
|
|
(list
|
|
(service home-run-on-first-login-service-type)
|
|
(service home-activation-service-type)
|
|
(service home-environment-variables-service-type)
|
|
|
|
(service home-symlink-manager-service-type)
|
|
|
|
(service home-fontconfig-service-type)
|
|
(service home-xdg-base-directories-service-type)
|
|
(service home-shell-profile-service-type)
|
|
|
|
(service home-service-type)
|
|
(service home-profile-service-type (home-environment-packages he))))
|
|
|
|
(define* (home-environment-services he)
|
|
"Return all the services of home environment."
|
|
(instantiate-missing-services
|
|
(append (home-environment-user-services he)
|
|
(home-environment-essential-services he))))
|
|
|
|
(define* (home-environment-derivation he)
|
|
"Return a derivation that builds home environment."
|
|
(let* ((services (home-environment-services he))
|
|
(home (fold-services services
|
|
#:target-type home-service-type)))
|
|
(service-value home)))
|
|
|
|
|
|
(define (home-environment-configuration-file he)
|
|
"Return the configuration file of HE, based on its 'location' field, or #f
|
|
if it could not be determined."
|
|
(let ((file (and=> (home-environment-location he)
|
|
location-file)))
|
|
(and file
|
|
(or (and (string-prefix? "/" file) file)
|
|
(search-path %load-path file)))))
|
|
|
|
(define* (home-environment-with-provenance he
|
|
#:optional
|
|
(config-file
|
|
(home-environment-configuration-file
|
|
he)))
|
|
"Return a variant of HE that stores its own provenance information,
|
|
including CONFIG-FILE, if available. This is achieved by adding an instance
|
|
of HOME-PROVENANCE-SERVICE-TYPE to its services."
|
|
(home-environment
|
|
(inherit he)
|
|
(services (cons (service home-provenance-service-type config-file)
|
|
(home-environment-user-services he)))))
|
|
|
|
(define-gexp-compiler (home-environment-compiler (he <home-environment>)
|
|
system target)
|
|
((store-lift
|
|
(lambda (store)
|
|
(run-with-store store (home-environment-derivation he)
|
|
#:system system
|
|
#:target target)))))
|
|
|
|
(define %profile-generation-rx
|
|
;; Regexp that matches profile generation.
|
|
(make-regexp "(.*)-([0-9]+)-link$"))
|
|
|
|
(define (home-generation-base file)
|
|
"If FILE is a Home generation GC root such as \"guix-home-42-link\",
|
|
return its corresponding base---e.g., \"guix-home\". Otherwise return #f.
|
|
|
|
This is similar to the 'generation-profile' procedure but applied to Home
|
|
generations."
|
|
(match (regexp-exec %profile-generation-rx file)
|
|
(#f #f)
|
|
(m (let ((profile (match:substring m 1)))
|
|
;; Distinguish from a "real" profile and from a system generation.
|
|
(and (file-exists? (string-append profile "/on-first-login"))
|
|
(file-exists? (string-append profile "/profile/manifest"))
|
|
profile)))))
|