;;; GNU Guix --- Functional package management for GNU
;;; Copyright © 2019 David Thompson <davet@gnu.org>
;;; Copyright © 2019 Jakob L. Kreuze <zerodaysfordays@sdf.lonestar.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 machine)
  #:use-module (gnu system)
  #:use-module (guix derivations)
  #:use-module (guix monads)
  #:use-module (guix records)
  #:use-module (guix store)
  #:use-module ((guix utils) #:select (source-properties->location))
  #:export (environment-type
            environment-type?
            environment-type-name
            environment-type-description
            environment-type-location

            machine
            machine?
            this-machine

            machine-system
            machine-environment
            machine-configuration
            machine-display-name

            deploy-machine
            machine-remote-eval))

;;; Commentary:
;;;
;;; This module provides the types used to declare individual machines in a
;;; heterogeneous Guix deployment. The interface allows users of specify system
;;; configurations and the means by which resources should be provisioned on a
;;; per-host basis.
;;;
;;; Code:


;;;
;;; Declarations for resources that can be provisioned.
;;;

(define-record-type* <environment-type> environment-type
  make-environment-type
  environment-type?

  ;; Interface to the environment type's deployment code. Each procedure
  ;; should take the same arguments as the top-level procedure of this file
  ;; that shares the same name. For example, 'machine-remote-eval' should be
  ;; of the form '(machine-remote-eval machine exp)'.
  (machine-remote-eval environment-type-machine-remote-eval) ; procedure
  (deploy-machine      environment-type-deploy-machine)      ; procedure

  ;; Metadata.
  (name        environment-type-name)       ; symbol
  (description environment-type-description ; string
               (default #f))
  (location    environment-type-location    ; <location>
               (default (and=> (current-source-location)
                               source-properties->location))
               (innate)))


;;;
;;; Declarations for machines in a deployment.
;;;

(define-record-type* <machine> machine
  make-machine
  machine?
  this-machine
  (system        machine-system)       ; <operating-system>
  (environment   machine-environment)  ; symbol
  (configuration machine-configuration ; configuration object
                 (default #f)))        ; specific to environment

(define (machine-display-name machine)
  "Return the host-name identifying MACHINE."
  (operating-system-host-name (machine-system machine)))

(define (machine-remote-eval machine exp)
  "Evaluate EXP, a gexp, on MACHINE. Ensure that all the elements EXP refers to
are built and deployed to MACHINE beforehand."
  (let ((environment (machine-environment machine)))
    ((environment-type-machine-remote-eval environment) machine exp)))

(define (deploy-machine machine)
  "Monadic procedure transferring the new system's OS closure to the remote
MACHINE, activating it on MACHINE and switching MACHINE to the new generation."
  (let ((environment (machine-environment machine)))
    ((environment-type-deploy-machine environment) machine)))
='/guix/commit/gnu/packages/spice.scm?id=4d5f7986d687f997ae8f1875cef36441e9bea035'>gnu: libcacard: Update to 2.8.1.</a><span class='msg-avail'>...</span></td><td>Tobias Geerinckx-Rice</td></tr>
<tr><td><span title='2021-08-12 00:30:27 +0200'>2021-08-12</span></td><td><a href='/guix/commit/gnu/packages/spice.scm?id=c4133c43c7cfe2476ebfae87f9e4d10d96de9bc7'>Merge branch 'master' into core-updates-frozen</a><span class='msg-avail'>...</span></td><td>Marius Bakke</td></tr>
<tr><td><span title='2021-08-10 11:55:51 +0300'>2021-08-10</span></td><td><a href='/guix/commit/gnu/packages/spice.scm?id=9987cb9f409064a2b9306c7d530ba2cfd7a4247e'>gnu: libcacard: Fix building.</a><span class='msg-avail'>...</span></td><td>Efraim Flashner</td></tr>
<tr><td><span title='2021-08-11 00:41:45 +0200'>2021-08-11</span></td><td><a href='/guix/commit/gnu/packages/spice.scm?id=207cfa3467867bb5b21d5f632b1ae3551aa905a5'>gnu: libcacard: Enable PC/SC support.</a><span class='msg-avail'>...</span></td><td>Marius Bakke</td></tr>
<tr><td><span title='2021-07-24 16:23:23 +0200'>2021-07-24</span></td><td><a href='/guix/commit/gnu/packages/spice.scm?id=377e9453caf16417fc4ec8a2b65db1ac4ba0d5ff'>gnu: Use 'search-input-file' when looking for *.so and *.a.</a><span class='msg-avail'>...</span></td><td>Ludovic Courtès</td></tr>