diff options
author | sterni <sternenseemann@systemli.org> | 2021-08-26T10·34+0200 |
---|---|---|
committer | sterni <sternenseemann@systemli.org> | 2021-08-26T11·26+0000 |
commit | ea6ee1e2196516775a41adc6d698fe4f83e5cbb2 (patch) | |
tree | 93a1fcfe3e0d4e6a4a9791cab841b575a7524798 /nix | |
parent | 2dd8bc7977aae7c5f545f8f61415f0bcfc30e02b (diff) |
docs(nix/buildLisp): move example further up r/2778
Make "Example" the second section again since it got a bit buried under a lot of detailed documentation you won't necessarily need right away. Change-Id: I481354d1761c590e5872dfce8c3cf9934e278673 Reviewed-on: https://cl.tvl.fyi/c/depot/+/3421 Reviewed-by: tazjin <mail@tazj.in> Tested-by: BuildkiteCI
Diffstat (limited to 'nix')
-rw-r--r-- | nix/buildLisp/README.md | 58 |
1 files changed, 29 insertions, 29 deletions
diff --git a/nix/buildLisp/README.md b/nix/buildLisp/README.md index 76fe5ca9e416..02435595ff1b 100644 --- a/nix/buildLisp/README.md +++ b/nix/buildLisp/README.md @@ -88,6 +88,35 @@ the `expression` parameter should be a Lisp expression and will be evaluated after loading all sources and dependencies (including library/program dependencies). It must return a non-`NIL` value if the test suite has passed. +## Example + +Using buildLisp could look like this: + +```nix +{ buildLisp, lispPkgs }: + +let libExample = buildLisp.library { + name = "lib-example"; + srcs = [ ./lib.lisp ]; + + deps = with lispPkgs; [ + (buildLisp.bundled "sb-posix") + iterate + cl-ppcre + ]; +}; +in buildLisp.program { + name = "example"; + deps = [ libExample ]; + srcs = [ ./main.lisp ]; + tests = { + deps = [ lispPkgs.fiveam ]; + srcs = [ ./tests.lisp ]; + expression = "(fiveam:run!)"; + }; +} +``` + ## Development REPLs `buildLisp` builds loadable variants of both `program` and `library` derivations @@ -195,35 +224,6 @@ This only influences `meta.targets` which is read by depot's CI to check which variants (see "Implementations") of the derivation to build, so it may not be useful outside of depot. -## Example - -Using buildLisp could look like this: - -```nix -{ buildLisp, lispPkgs }: - -let libExample = buildLisp.library { - name = "lib-example"; - srcs = [ ./lib.lisp ]; - - deps = with lispPkgs; [ - (buildLisp.bundled "sb-posix") - iterate - cl-ppcre - ]; -}; -in buildLisp.program { - name = "example"; - deps = [ libExample ]; - srcs = [ ./main.lisp ]; - tests = { - deps = [ lispPkgs.fiveam ]; - srcs = [ ./tests.lisp ]; - expression = "(fiveam:run!)"; - }; -} -``` - [sbcl]: http://www.sbcl.org/ [ccl]: https://ccl.clozure.com/ [ecl]: https://common-lisp.net/project/ecl/ |