Commit graph

15701 commits

Author SHA1 Message Date
Qyriad 67685eef90 now for the new cli 2024-05-22 22:32:10 -06:00
Qyriad 811a9bdea0 docs: document the cursed file syntax for new CLI
This documents that all installables in the nix3 commands, in their
--file/-f form accept an extended syntax for the file argument,
which is the same as it is for nix-build and friends, some of which were
well known in their nix-build forms (e.g. `nix-build '<nixpkgs>' -A hello)
but are not well known in their nix3 forms (people rarely know that you
can `nix build -f '<nixpkgs>' firefox`).

Like the old CLI syntax, as documented in [1], file arguments also
accept https:// tarball URLs, `flake:` prefixed flakerefs, and the
cursed `channel:` prefixed hardened URLs.

[1]: Ib6d68594a16132805ba5d97526e16f7b3633117e

Change-Id: Ib81a5db1f60d5916f0f792d82054f3ac65717121
2024-05-22 22:32:02 -06:00
Qyriad 90a6b4042b docstrings: NixRepl::getDerivationPath: exceptions directly thrown
getDerivationPath() directly throws nix::Error for invalid derivations

Change-Id: I81ead950060b789794fa683b61c6349fece1690d
2024-05-22 22:32:02 -06:00
Qyriad 3f8c4bf77e docs: document the cursed file syntax for old cli
This documents the fact that nix-build, nix-env, nix-instantiate, and
nix-shell accept an extended syntax for their file arguments, including
some well-known (but not well documented) aspects, like being able to
specify `<nixpkgs>`, but also https:// tarball URLs, `flake:` prefixed
flakerefs, and the cursed `channel:` prefixed hardcoded URLs

Same thing for the new CLI incoming :)

Change-Id: Ib6d68594a16132805ba5d97526e16f7b3633117e
2024-05-22 22:32:02 -06:00
Qyriad 010c158a03 readline vs editline stuff 2024-05-22 19:03:10 -06:00
Qyriad 9dc5a17107 docs: linkify nix3-build mention in nix-build.md
Change-Id: I462a8cf0da42b5045ce84b48dc1841ecdccbb89e
2024-05-22 19:02:57 -06:00
Qyriad ea04545e7a docstrings: NixRepl::getDerivationPath: exceptions directly thrown
getDerivationPath() directly throws nix::Error for invalid derivations

Change-Id: I81ead950060b789794fa683b61c6349fece1690d
2024-05-22 19:02:57 -06:00
Qyriad 87cf830e10 build: make internal-api-docs PHONY
Since we're skipping Meson's dependency tracking, for the
internal-api-docs custom target, we should just consider it a phony
target and build it on every request.

Change-Id: I3b0bcea30ee9a4830023ccc5bededf995e96cccc
2024-05-22 19:02:57 -06:00
Qyriad b4adc68c54 docs: document the cursed file syntax for old cli
This documents the fact that nix-build, nix-env, nix-instantiate, and
nix-shell accept an extended syntax for their file arguments, including
some well-known (but not well documented) aspects, like being able to
specify `<nixpkgs>`, but also https:// tarball URLs, `flake:` prefixed
flakerefs, and the cursed `channel:` prefixed hardcoded URLs

Same thing for the new CLI incoming :)

Change-Id: Ib6d68594a16132805ba5d97526e16f7b3633117e
2024-05-22 19:02:57 -06:00
Qyriad 291ecb97da cleanup lookupFileArg
Change-Id: I2acd56e7a542b12138f43c95af78fdd50e944619
2024-05-22 19:02:57 -06:00
Qyriad bbc6e99e79 add docstring to lookupFileArg
Change-Id: Ifc149764f5a15725d3d630677c6da29def4b0f3e
2024-05-22 19:02:57 -06:00
Qyriad 923e501bf7 add libcmd test for lookupFileArg
Change-Id: I9e2ef170ffe916f902daec8b5630d29434c5d5f2
2024-05-22 19:02:57 -06:00
Qyriad ab427b4ac5 repl: log errors writing to history file
These errors are now logged and explicitly ignored, rather than
implicitly ignored.

Change-Id: Ia26015466a17f2b11952df5317a4d150d79dc184
2024-05-22 19:02:57 -06:00
Qyriad 125f643198 hopefully finish nix-build docs thing 2024-05-22 18:25:52 -06:00
Qyriad 2a606e96c4 docstrings: NixRepl::getDerivationPath: exceptions directly thrown
getDerivationPath() directly throws nix::Error for invalid derivations

Change-Id: I81ead950060b789794fa683b61c6349fece1690d
2024-05-22 18:17:58 -06:00
Qyriad ec0f49ec43 docs: document the cursed file syntax for old cli
This documents the fact that nix-build, nix-env, nix-instantiate, and
nix-shell accept an extended syntax for their file arguments, including
some well-known (but not well documented) aspects, like being able to
specify `<nixpkgs>`, but also https:// tarball URLs, `flake:` prefixed
flakerefs, and the cursed `channel:` prefixed hardcoded URLs

Same thing for the new CLI incoming :)

Change-Id: Ib6d68594a16132805ba5d97526e16f7b3633117e
2024-05-22 18:17:58 -06:00
Qyriad 5dc33dba37 fix phony spell 2024-05-22 17:58:44 -06:00
Qyriad 12c0cc7b0e docs: linkify nix3-build mention in nix-build.md
Change-Id: I462a8cf0da42b5045ce84b48dc1841ecdccbb89e
2024-05-22 17:58:32 -06:00
Qyriad f567e571c1 docstrings: NixRepl::getDerivationPath: exceptions directly thrown
getDerivationPath() directly throws nix::Error for invalid derivations

Change-Id: I81ead950060b789794fa683b61c6349fece1690d
2024-05-22 17:58:32 -06:00
Qyriad c42f8ffa7f build: make internal-api-docs PHONY
Since we're skipping Meson's dependency tracking, for the
internal-api-docs custom target, we should just consider it a phony
target and build it on every request.

Change-Id: I3b0bcea30ee9a4830023ccc5bededf995e96cccc
2024-05-22 17:58:32 -06:00
Qyriad 895767bced docs: document the file syntax things like nix-build take
Change-Id: Ib6d68594a16132805ba5d97526e16f7b3633117e
2024-05-22 17:58:32 -06:00
Qyriad aa30db5f9f NixRepl::getDerivationPath() docstring 2024-05-22 17:18:42 -06:00
Qyriad ef3a6bb464 docstrings: NixRepl::getDerivationPath: exceptions directly thrown
getDerivationPath() directly throws nix::Error for invalid derivations

Change-Id: I81ead950060b789794fa683b61c6349fece1690d
2024-05-22 17:15:45 -06:00
Qyriad 6d1968a7b1 switch to include for the summary 2024-05-21 15:37:21 -06:00
Qyriad b07878bfe9 docs: document lookupFileArg syntax command refs
Change-Id: Ib6d68594a16132805ba5d97526e16f7b3633117e
2024-05-21 15:37:08 -06:00
Qyriad a88f3e4510 document for nix-instantiate too 2024-05-21 14:39:51 -06:00
Qyriad 36912b3b45 docs: document lookupFileArg syntax command refs
Change-Id: Ib6d68594a16132805ba5d97526e16f7b3633117e
2024-05-21 14:39:25 -06:00
Qyriad 09ebcff373 better commit msg for PHONEY internal-api-docs 2024-05-21 12:44:58 -06:00
Qyriad 5c6d4f903c docs: linkify nix3-build mention in nix-build.md
Change-Id: I462a8cf0da42b5045ce84b48dc1841ecdccbb89e
2024-05-21 12:43:56 -06:00
Qyriad 1796c9fb20 docs: document lookupFileArg syntax in nix-build
Change-Id: Ib6d68594a16132805ba5d97526e16f7b3633117e
2024-05-21 12:43:56 -06:00
Qyriad cab1fb0b05 build: make internal-api-docs PHONEY
Since we're skipping Meson's dependency tracking, for the
internal-api-docs custom target, we should just consider it a phoney
target and build it on every request.

Change-Id: I3b0bcea30ee9a4830023ccc5bededf995e96cccc
2024-05-21 12:43:56 -06:00
Qyriad a263a1fd5a maybe? 2024-05-21 12:35:09 -06:00
Qyriad d45deb373c docs: document lookupFileArg syntax in nix-build
Change-Id: Ib6d68594a16132805ba5d97526e16f7b3633117e
2024-05-21 12:34:14 -06:00
Qyriad 5b31d71f6f cleanup lookupFileArg
Change-Id: I2acd56e7a542b12138f43c95af78fdd50e944619
2024-05-21 12:34:13 -06:00
Qyriad 1818752c5c docs: linkify nix3-build mention in nix-build.md
Change-Id: I462a8cf0da42b5045ce84b48dc1841ecdccbb89e
2024-05-21 12:34:13 -06:00
Qyriad 7424fe910a add docstring to lookupFileArg
Change-Id: Ifc149764f5a15725d3d630677c6da29def4b0f3e
2024-05-21 12:34:13 -06:00
Qyriad 2bc2688b04 build: make internal-api-docs PHONEY
Change-Id: I3b0bcea30ee9a4830023ccc5bededf995e96cccc
2024-05-21 12:34:13 -06:00
Qyriad 590884e7a0 add libcmd test for lookupFileArg
Change-Id: I9e2ef170ffe916f902daec8b5630d29434c5d5f2
2024-05-21 12:34:12 -06:00
Qyriad ae355b8f42 repl: log errors writing to history file
These errors are now logged and explicitly ignored, rather than
implicitly ignored.

Change-Id: Ia26015466a17f2b11952df5317a4d150d79dc184
2024-05-21 12:34:12 -06:00
Qyriad b8cbf0707f minor tweak to the test 2024-05-21 12:33:13 -06:00
Qyriad 222000f908 docs: document lookupFileArg syntax in nix-build
Change-Id: Ib6d68594a16132805ba5d97526e16f7b3633117e
2024-05-21 12:33:01 -06:00
Qyriad de180c0356 docs: linkify nix3-build mention in nix-build.md
Change-Id: I462a8cf0da42b5045ce84b48dc1841ecdccbb89e
2024-05-21 12:33:01 -06:00
Qyriad 53dea1c06e build: make internal-api-docs PHONEY
Change-Id: I3b0bcea30ee9a4830023ccc5bededf995e96cccc
2024-05-21 12:33:01 -06:00
Qyriad 1e0ca2d55e cleanup lookupFileArg
Change-Id: I2acd56e7a542b12138f43c95af78fdd50e944619
2024-05-21 12:33:01 -06:00
Qyriad 75634a86f0 add docstring to lookupFileArg
Change-Id: Ifc149764f5a15725d3d630677c6da29def4b0f3e
2024-05-21 12:33:01 -06:00
Qyriad 6c3aea2922 add libcmd test for lookupFileArg
Change-Id: I9e2ef170ffe916f902daec8b5630d29434c5d5f2
2024-05-21 12:33:01 -06:00
Qyriad 0e1e135194 oops we fucked up the repl thing 2024-05-21 12:23:43 -06:00
Qyriad 13bf168d0e docs: document lookupFileArg syntax in nix-build
Change-Id: Ib6d68594a16132805ba5d97526e16f7b3633117e
2024-05-21 12:23:34 -06:00
Qyriad e7b0867605 docs: linkify nix3-build mention in nix-build.md
Change-Id: I462a8cf0da42b5045ce84b48dc1841ecdccbb89e
2024-05-21 12:23:34 -06:00
Qyriad e491f8029a build: make internal-api-docs PHONEY
Change-Id: I3b0bcea30ee9a4830023ccc5bededf995e96cccc
2024-05-21 12:23:34 -06:00