Return an object representing the store item NAME, a file or directory computed by GEXP. When LOCAL-BUILD? is #t (the default), it ensures the corresponding derivation is built locally. OPTIONS may be used to pass additional arguments to 'gexp->derivation'.

This is the declarative counterpart of 'gexp->derivation'.

*Note: This API is subject to change; use at your own risk!*

Lower EXP, a gexp, instantiating it for SYSTEM and TARGET. Return a <lowered-gexp> ready to be used.

Lowered gexps are an intermediate representation that's useful for applications that deal with gexps outside in a way that is disconnected from derivations--e.g., code evaluated for its side effects.

Turn SEXP into a gexp without any references.

Using this is a way for the caller to tell that SEXP doesn't need to be scanned for file-like objects, thereby reducing processing costs. This is particularly useful if SEXP is a long list or a deep tree.

Return #t if OBJECT leads to a file in the store once unquoted in a G-expression; otherwise return #f.

Return as a monadic value a derivation that builds a text file containing all of TEXT. TEXT may list, in addition to strings, objects of any type that can be used in a gexp: packages, derivations, local file objects, etc. The resulting store file holds references to all these.

Import FILES into the store and return the resulting derivation or store file name (a derivation is created if and only if some elements of FILES are file-like objects and not local file names.) FILES must be a list of (FINAL-PATH . FILE) pairs. Each FILE is mapped to FINAL-PATH in the resulting store path. FILE can be either a file name, or a file-like object, as returned by 'local-file' for example.

Return an object representing a text file called NAME with the given CONTENT (a string) to be added to the store.

This is the declarative counterpart of 'text-file'.

Return as a monadic value a gexp that sets '%load-path' and '%load-compiled-path' to point to MODULES, a list of module names. MODULES are searched for in PATH. Return #f when MODULES and EXTENSIONS are empty. Assume MODULES are compiled with GUILE.

Return a derivation that contains the source files of MODULES, a list of module names such as `(ice-9 q)'. All of MODULES must be either names of modules to be found in the MODULE-PATH search path, or a module name followed by an arrow followed by a file-like object. For example:

(imported-modules `((guix build utils) (guix gcrypt) ((guix config) => ,(scheme-file …))))

In this example, the first two modules are taken from MODULE-PATH, and the last one is created from the given <scheme-file> object.

Return a directory that is the union of THINGS, where THINGS is a list of file-like objects denoting directories. For example:

(directory-union "guile+emacs" (list guile emacs))

yields a directory that is the union of the 'guile' and 'emacs' packages.

Call RESOLVE-COLLISION when several files collide, passing it the list of colliding files. RESOLVE-COLLISION must return the chosen file or #f, in which case the colliding entry is skipped altogether.

When COPY? is true, copy files instead of creating symlinks. When QUIET? is true, the derivation will not print anything.

Return an object representing the executable store item NAME that runs GEXP. GUILE is the Guile package used to execute that script. Imported modules of GEXP are looked up in MODULE-PATH.

This is the declarative counterpart of 'gexp->script'.

Return an object representing the Scheme file NAME that contains GEXP.

This is the declarative counterpart of 'gexp->file'.