lix/doc/manual/src
John Ericson ea0adfc582 Get rid of .drv special-casing for store path installables
The release notes document the change in behavior, I don't include it
here so there is no risk to it getting out of sync.

> Motivation

>> Plumbing CLI should be simple

Store derivation installations are intended as "plumbing": very simple
utilities for advanced users and scripts, and not what regular users
interact with. (Similarly, regular Git users will use branch and tag
names not explicit hashes for most things.)

The plumbing CLI should prize simplicity over convenience; that is its
raison d'etre. If the user provides a path, we should treat it the same
way not caring what sort of path it is.

>> Scripting

This is especially important for the scripting use-case. when arbitrary
paths are sent to e.g. `nix copy` and the script author wants consistent
behavior regardless of what those store paths are. Otherwise the script
author needs to be careful to filter out `.drv` ones, and then run `nix
copy` again with those paths and `--derivation`. That is not good!

>> Surprisingly low impact

Only two lines in the tests need changing, showing that the impact of
this is pretty light.

Many command, like `nix log` will continue to work with just the
derivation passed as before. This because we used to:

- Special case the drv path and replace it with it's outputs (what this
  gets rid of).

- Turn those output path *back* into the original drv path.

Now we just skip that entire round trip!

> Context

Issue #7261 lays out a broader vision for getting rid of `--derivation`,
and has this as one of its dependencies. But we can do this with or
without that.

`Installable::toDerivations` is changed to handle the case of a
`DerivedPath::Opaque` ending in `.drv`, which is new: it simply doesn't
need to do any extra work in that case. On this basis, commands like
`nix {show-derivation,log} /nix/store/...-foo.drv` still work as before,
as described above.

When testing older daemons, the post-build-hook will be run against the
old CLI, so we need the old version of the post-build-hook to support
that use-case.

Co-authored-by: Travis A. Everett <travis.a.everett@gmail.com>
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-02-28 17:07:05 -05:00
..
advanced-topics Merge branch 'master' into remove-repeat 2022-12-07 16:04:47 +01:00
architecture doc/manual: Fix broken internal links 2023-01-10 22:30:41 +01:00
command-ref Merge pull request #5588 from tweag/balsoft/xdg 2023-02-10 18:05:50 +01:00
contributing doc/cli-guideline: Improve examples 2023-02-28 16:35:47 +01:00
figures Move figures 2020-07-24 12:58:31 +02:00
installation Make install command in documentation compatible with fish shell (#7474) 2023-02-07 22:32:27 +00:00
language Fix minor syntax issue in the one of the examples. 2023-02-10 12:01:44 +02:00
package-management Update binary-cache-substituter.md (#7628) 2023-01-18 15:08:20 +00:00
release-notes Get rid of .drv special-casing for store path installables 2023-02-28 17:07:05 -05:00
glossary.md add "instantiate" to glossary 2023-02-07 12:09:26 +01:00
introduction.md manual: build action -> build task 2022-11-06 13:28:18 +01:00
quick-start.md Make install command in documentation compatible with fish shell (#7474) 2023-02-07 22:32:27 +00:00
SUMMARY.md.in Release notes 2023-02-28 13:44:14 +01:00