nix-super/doc/manual/src
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
..
advanced-topics rewrap lines to use one line per sentence 2023-05-31 01:32:03 +02:00
architecture Add description for file system objects (#8500) 2023-06-18 23:45:08 -04:00
command-ref list moving parts of channels 2023-07-19 10:26:25 +02:00
contributing fix broken links (#8722) 2023-07-20 17:58:14 +02:00
figures Move figures 2020-07-24 12:58:31 +02:00
installation nix actually needs c++20 now 2023-06-10 13:56:05 +02:00
language clarify wording on args@ default handling (#8596) 2023-07-19 13:07:07 +00:00
package-management remove the Channels section 2023-07-19 09:39:04 +02:00
protocols Apply suggestions from code review 2023-06-16 16:48:37 +02:00
release-notes Add parseFlakeRef and flakeRefToString builtins (#8670) 2023-07-25 17:43:33 +00:00
glossary.md Add description for file system objects (#8500) 2023-06-18 23:45:08 -04:00
introduction.md Convert short nix options to long ones 2023-05-17 08:10:30 +01:00
quick-start.md Update doc/manual/src/quick-start.md 2023-02-19 20:00:02 -05:00
SUMMARY.md.in Release notes 2023-07-24 17:19:31 +02:00