mirrors/ciel
1
Fork 0
mirror of https://gitlab.com/vindarel/ciel.git synced 2025-12-06 02:30:39 -08:00
Code Issues Projects Releases Packages Wiki Activity

doc script++

Browse source
This commit is contained in:
vindarel 2022-12-09 16:20:21 +01:00
parent 2ca812a9cc
commit c0ee6f5921
2 changed files with 18 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

22
docs/scripting.md
View file

@ -14,19 +14,24 @@ An example script:
;; Start your script with this to access all CIEL goodies:
(in-package :ciel-user)
;; We have access to the STR library:
(print (str:join "-" (list "I" "am" "a" "lisper")))
(defun hello (name)
"Say hello."
;; format! prints on standard output and flushes the streams.
(format! t "Hello ~a!~&" name))
;; Access CLI args:
(hello (second (uiop:command-line-arguments)))
;; We have access to the DICT notation for hash-tables:
(print "testing dict:")
(print (dict :a 1 :b 2))
;; format! prints on standard output and flushes the streams.
(format! t "cmd?")
;; We can run shell commands:
(cmd:cmd "ls")
;; Access environment variables:
(hello (uiop:getenv "USER"))
(format! t "Let's define an alias to run shell commands with '!'. This gives: ")
(defalias ! #'cmd:cmd)
(! "pwd")
@ -42,8 +47,12 @@ An example script:
Output:
```
"I-am-a-lisper"
$ ciel myscript.lisp you
=>
Hello you!
"testing dict:"
(dict
@ -53,6 +62,7 @@ Output:
cmd? ABOUT.org ciel ciel-core
bin docs src
[…]
Hello vindarel!
Let's define an alias to run shell commands with '!'. This gives:
/home/vindarel/projets/ciel
ciel-user>