lix-releng-staging/doc/manual
Alex Ameen 2d1d81114d
Add parseFlakeRef and flakeRefToString builtins (#8670)
Over the last year or so I've run into several use cases where I need to
parse and/or serialize URLs for use by `builtins.fetchTree` or
`builtins.getFlake`, largely in order to produce _lockfile-like_ files
for lang2nix frameworks or tools which use `nix` internally to drive
builds.

I've gone through the painstaking process of emulating
`nix::FlakeRef::fromAttrs` and `nix::parseFlakeRef` several times with
mixed success; but these are difficult to create and even harder to
maintain if I hope to stay aligned with changes to the real
parser/serializer.

I understand why adding new `builtins` isn't something we want to do
flagrantly. I'm recommending this addition simply because I keep
encountering use cases where I need to parse/serialize these URIs in
`nix` expressions, and I want a reliable solution.

Co-authored-by: Eelco Dolstra <edolstra@gmail.com>
Co-authored-by: John Ericson <git@JohnEricson.me>
2023-07-25 17:43:33 +00:00
..
src Add parseFlakeRef and flakeRefToString builtins (#8670) 2023-07-25 17:43:33 +00:00
theme doc/manual: don't need to copy highlight.js manually 2021-08-04 19:47:05 -07:00
anchors.jq doc: Port anchors preprocessor to jq script 2022-05-26 18:17:21 +02:00
book.toml manual: Check links 2023-01-10 22:30:41 +01:00
custom.css disallow selecting shell prompt in code samples 2022-12-05 11:01:46 +01:00
generate-builtin-constants.nix revert anchor prefix for builtin constants 2023-07-20 10:27:38 +02:00
generate-builtins.nix Automatically document builtin constants 2023-06-27 09:37:54 -04:00
generate-manpage.nix doc rendering: add functions to scope explicitly (#7378) 2023-05-03 07:16:29 +00:00
generate-xp-features-shortlist.nix Single page for experimental feature descriptions 2023-04-09 11:01:23 -04:00
generate-xp-features.nix Single page for experimental feature descriptions 2023-04-09 11:01:23 -04:00
local.mk Automatically document builtin constants 2023-06-27 09:37:54 -04:00
quote-literals.xsl Generate release notes again 2014-03-12 14:24:29 +01:00
redirects.js fix broken links 2023-07-19 11:01:48 +02:00
utils.nix Mark experimental configuration settings programmatically 2023-04-16 10:58:04 -04:00