;;; GNU Guix --- Functional package management for GNU ;;; Copyright © 2013-2016, 2019, 2021, 2024 Ludovic Courtès ;;; Copyright © 2013 Andreas Enge ;;; Copyright © 2013 Nikita Karetnikov ;;; Copyright © 2016 David Craven ;;; Copyright © 2019 Ivan Petkov ;;; Copyright © 2020 Jakub Kądziołka ;;; Copyright © 2021 Efraim Flashner ;;; ;;; 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 . (define-module (guix build-system cargo) #:use-module (guix search-paths) #:use-module (guix store) #:use-module (guix utils) #:use-module (guix gexp) #:use-module (guix monads) #:use-module (guix packages) #:use-module (guix build-system) #:use-module (guix build-system gnu) #:use-module (ice-9 match) #:use-module (ice-9 vlist) #:use-module (srfi srfi-1) #:use-module (srfi srfi-26) #:export (%cargo-build-system-modules %cargo-utils-modules cargo-build-system %crate-base-url crate-url crate-url? crate-uri)) (define %crate-base-url (make-parameter "https://crates.io")) (define crate-url (string-append (%crate-base-url) "/api/v1/crates/")) (define crate-url? (cut string-prefix? crate-url <>)) (define (crate-uri name version) "Return a URI string for the crate package hosted at crates.io corresponding to NAME and VERSION." (string-append crate-url name "/" version "/download")) (define (default-rust target) "Return the default Rust package." ;; Lazily resolve the binding to avoid a circular dependency. (let ((rust (resolve-interface '(gnu packages rust)))) (module-ref rust 'rust))) (define (default-rust-sysroot target) "Return the default Rust sysroot for ." ;; Lazily resolve the binding to avoid a circular dependency. (let ((module (resolve-interface '(gnu packages rust)))) (module-ref module 'make-rust-sysroot))) (define %cargo-utils-modules ;; Build-side modules imported by default. `((guix build cargo-utils) ,@%default-gnu-imported-modules)) (define %cargo-build-system-modules ;; Build-side modules imported by default. `((guix build cargo-build-system) (guix build json) ,@%cargo-utils-modules)) (define* (cargo-build name inputs #:key source (tests? #t) (test-target #f) (vendor-dir "guix-vendor") (cargo-build-flags ''("--release")) (cargo-test-flags ''("--release")) (cargo-package-flags ''("--no-metadata" "--no-verify")) (features ''()) (skip-build? #f) (install-source? #t) (phases '%standard-phases) (outputs '("out")) (search-paths '()) (system (%current-system)) (guile #f) (imported-modules %cargo-build-system-modules) (modules '((guix build cargo-build-system) (guix build utils)))) "Build SOURCE using CARGO, and with INPUTS." (define builder (with-imported-modules imported-modules #~(begin (use-modules #$@(sexp->gexp modules)) (cargo-build #:name #$name #:source #+source #:system #$system #:test-target #$test-target #:vendor-dir #$vendor-dir #:cargo-build-flags #$(sexp->gexp cargo-build-flags) #:cargo-test-flags #$(sexp->gexp cargo-test-flags) #:cargo-package-flags #$(sexp->gexp cargo-package-flags) #:features #$(sexp->gexp features) #:skip-build? #$skip-build? #:install-source? #$install-source? #:tests? #$(and tests? (not skip-build?)) #:phases #$(if (pair? phases) (sexp->gexp phases) phases) #:outputs #$(outputs->gexp outputs) #:inputs #$(input-tuples->gexp inputs) #:search-paths '#$(sexp->gexp (map search-path-specification->sexp search-paths)))))) (gexp->derivation name builder #:system system #:target #f #:graft? #f #:guile-for-build guile)) (define* (cargo-cross-build name #:key source target build-inputs target-inputs host-inputs (tests? #f) (test-target #f) (vendor-dir "guix-vendor") (cargo-build-flags ''("--release")) (cargo-test-flags ''("--release")) (cargo-package-flags ''("--no-metadata" "--no-verify")) (features ''()) (skip-build? #f) (install-source? (not (target-mingw? target))) (phases '%standard-phases) (outputs '("out")) (search-paths '()) (native-search-paths '()) (system (%current-system)) (guile #f) (imported-modules %cargo-build-system-modules) (modules '((guix build cargo-build-system) (guix build utils)))) "Cross-build SOURCE using CARGO, and with INPUTS." (define builder (with-imported-modules imported-modules #~(begin (use-modules #$@(sexp->gexp modules)) (cargo-build #:name #$name #:source #+source #:target #+target #:system #$system #:test-target #$test-target #:vendor-dir #$vendor-dir #:cargo-build-flags #$(sexp->gexp cargo-build-flags) #:cargo-test-flags #$(sexp->gexp cargo-test-flags) #:cargo-package-flags #$(sexp->gexp cargo-package-flags) #:features #$(sexp->gexp features) #:skip-build? #$skip-build? #:install-source? #$install-source? #:tests? #$(and tests? (not skip-build?)) #:phases #$(if (pair? phases) (sexp->gexp phases) phases) #:outputs #$(outputs->gexp outputs) #:inputs (append #$(input-tuples->gexp host-inputs) #+(input-tuples->gexp target-inputs)) #:native-inputs #+(input-tuples->gexp build-inputs) #:make-dynamic-linker-cache? #f ;cross-compiling #:search-paths '#$(sexp->gexp (map search-path-specification->sexp search-paths)) #:native-search-paths '#$(sexp->gexp (map search-path-specification->sexp native-search-paths)))))) (gexp->derivation name builder #:system system #:target target #:graft? #f #:guile-for-build guile)) (define (package-cargo-inputs p) (apply (lambda* (#:key (cargo-inputs '()) #:allow-other-keys) cargo-inputs) (package-arguments p))) (define (package-cargo-development-inputs p) (apply (lambda* (#:key (cargo-development-inputs '()) #:allow-other-keys) cargo-development-inputs) (package-arguments p))) (define (crate-closure inputs) "Return the closure of INPUTS when considering the 'cargo-inputs' and 'cargod-dev-deps' edges. Omit duplicate inputs, except for those already present in INPUTS itself. This is implemented as a breadth-first traversal such that INPUTS is preserved, and only duplicate extracted inputs are removed. Forked from ((guix packages) transitive-inputs) since this extraction uses slightly different rules compared to the rest of Guix (i.e. we do not extract the conventional inputs)." (define (seen? seen item) ;; FIXME: We're using pointer identity here, which is extremely sensitive ;; to memoization in package-producing procedures; see ;; . (vhash-assq item seen)) (let loop ((inputs inputs) (result '()) (propagated '()) (seen vlist-null)) (match inputs (() (if (null? propagated) (reverse result) (loop (reverse (concatenate propagated)) result '() seen))) (((and input (label (? package? package))) rest ...) (if (seen? seen package) (loop rest result propagated seen) (loop rest (cons input result) (cons (package-cargo-inputs package) propagated) (vhash-consq package package seen)))) ((input rest ...) (loop rest (cons input result) propagated seen))))) (define (expand-crate-sources cargo-inputs cargo-development-inputs) "Extract all transitive sources for CARGO-INPUTS and CARGO-DEVELOPMENT-INPUTS along their 'cargo-inputs' edges. Cargo requires all transitive crate dependencies' sources to be available in its index, even if they are optional (this is so it can generate deterministic Cargo.lock files regardless of the target platform or enabled features). Thus we need all transitive crate dependencies for any cargo dev-dependencies, but this is only needed when building/testing a crate directly (i.e. we will never need transitive dev-dependencies for any dependency crates). Another complication arises due potential dependency cycles from Guix's perspective: Although cargo does not permit cyclic dependencies between crates, however, it permits cycles to occur via dev-dependencies. For example, if crate X depends on crate Y, crate Y's tests could pull in crate X to to verify everything builds properly (this is a rare scenario, but it it happens for example with the `proc-macro2` and `quote` crates). This is allowed by cargo because tests are built as a pseudo-crate which happens to depend on the X and Y crates, forming an acyclic graph. We can side step this problem by only considering regular cargo dependencies since they are guaranteed to not have cycles. We can further resolve any potential dev-dependency cycles by extracting package sources (which never have any dependencies and thus no cycles can exist). There are several implications of this decision: * Building a package definition does not require actually building/checking any dependent crates. This can be a benefits: - For example, sometimes a crate may have an optional dependency on some OS specific package which cannot be built or run on the current system. This approach means that the build will not fail if cargo ends up internally ignoring the dependency. - It avoids waiting for quadratic builds from source: cargo always builds dependencies within the current workspace. This is largely due to Rust not having a stable ABI and other resolutions that cargo applies. This means that if we have a dependency chain of X -> Y -> Z and we build each definition independently the following will happen: * Cargo will build and test crate Z * Cargo will build crate Z in Y's workspace, then build and test Y * Cargo will build crates Y and Z in X's workspace, then build and test X * But there are also some downsides with this approach: - If a dependent crate is subtly broken on the system (i.e. it builds but its tests fail) the consuming crates may build and test successfully but actually fail during normal usage (however, the CI will still build all packages which will give visibility in case packages suddenly break). - Because crates aren't declared as regular inputs, other Guix facilities such as tracking package graphs may not work by default (however, this is something that can always be extended or reworked in the future)." (filter-map (match-lambda ((label (? package? p)) (list label (package-source p))) ((label input) (list label input))) (crate-closure (append cargo-inputs cargo-development-inputs)))) (define* (lower name #:key source inputs native-inputs outputs system target (rust (default-rust target)) (rust-sysroot (default-rust-sysroot target)) (cargo-inputs '()) (cargo-development-inputs '()) #:allow-other-keys #:rest arguments) "Return a bag for NAME." (define private-keywords `(#:rust #:inputs #:native-inputs #:outputs #:cargo-inputs #:cargo-development-inputs #:rust-sysroot ,@(if target '() '(#:target)))) (bag (name name) (system system) (target target) (host-inputs `(,@(if source `(("source" ,source)) '()) ;,@(if target '() inputs) ,@(if target inputs '()) ,@(expand-crate-sources cargo-inputs cargo-development-inputs))) (build-inputs `(("cargo" ,rust "cargo") ("rustc" ,rust) ,@native-inputs ;,@(if target inputs '()) ,@(if target '() inputs) ;,@inputs ,@(if target ;; Use the standard cross inputs of ;; 'gnu-build-system'. (standard-cross-packages target 'host) '()) ;; Keep the standard inputs of 'gnu-build-system' ,@(standard-packages))) (target-inputs `(,@(if target (standard-cross-packages target 'target) '()) ;; This provides a separate sysroot for the regular rustc ,@(if target `(("rust-sysroot" ,(rust-sysroot target))) '()))) (outputs outputs) (build (if target cargo-cross-build cargo-build)) (arguments (strip-keyword-arguments private-keywords arguments)))) (define cargo-build-system (build-system (name 'cargo) (description "Cargo build system, to build Rust crates") (lower lower)))