mlisp/Readme.md

101 lines
3.3 KiB
Markdown

### BUGS
- (read-file "nonexisting/file.csv") shows only "could not open file" - should print filename
- error: the expression `("/usr/local/var/mlisp")` with message "cannot cast" - should add to what is casting
- better error reporting..for example ls_dir on non existing dir should prind `pwd` dir
### TODO
- add debug support, at least call stack
- documentation
- add url of source/inspiration to clib/*.cpp
- add stdtest - to test every functionality
- add -l option (no linenoise)
- add -sb option to remove sheebang line
- add instrumentation (time, nr of evals, num of atoms, debug info, debug environment etc)
- add -p (profile/performance option)
- multiline editting (kilo editor)
- execute system command should capture stderr
- add built in for and, or
- add some mem stats to benchmark
- support for (), nil, t, in lsp code replace 0 by nil in logicals
- file functions
- name it here
- string functions
- compare - needed for sorting
- uppper/lower case
- trim
- replace
- regexp functions
- date support
- decode-universal-time
- env functions
- get-env, set-env; set-env cannot be implemented in stdlib.lsp, because popen is in fact subshell
- format (sprintf)
- setq
- mapcar (funcall, apply)
- syntax highlighting do VS Code
- add hash datatype
- create pastebin like web using ml
#### Performance
- push_back - repeatedly without reserving size
- range - with for(int i...) and reserving result size can be 3times faster on (range 1 10000)
- mini_sprintf - unnecesary copying between vector and list
- (do ..) repeatedly assign to acc, maybe somewhere else
#### Install
```
cp build/ml /usr/local/bin/ml
cp stdlib/*.lsp /usr/local/var/mlisp/
```
#### Compile
```
gcc -std=c99 -c -O2 -o linenoise.o clib/linenoise.c
c++ -c -O2 -I/usr/local/opt/openssl/include -Iclib --std=c++17 ml.cpp ml_io.cpp ml_date.cpp ml_string.cpp ml_util.cpp ml_profiler.cpp clib/json11.cpp clib/csvparser.cpp clib/sslclient.cpp clib/printf.cpp
c++ -o ml -O2 -L/usr/local/lib -L/usr/local/opt/openssl/lib -lm -lstdc++ -lcrypto -lssl -Wl,-stack_size -Wl,0x1000000 *.o
```
or
cmake
### Example of use
```
time ./build/ml -c '(include "../example.lisp") (print (fact 1000))'
./build/ml -f debug.lisp
```
### Links
https://markdowntohtml.com/
https://hyperpolyglot.org/lisp
https://www.tutorialspoint.com/lisp/index.htm
https://github.com/adam-mcdaniel/wisp
http://www.ulisp.com/show?1AWG
http://journal.stuffwithstuff.com/2013/12/08/babys-first-garbage-collector/
https://github.com/dropbox/json11
#### std::vector
https://stackoverflow.com/questions/12271017/initial-capacity-of-vector-in-c
https://baptiste-wicht.com/posts/2012/12/cpp-benchmark-vector-list-deque.html
#### parse http headers in c++
```
^(?:((?:https?|s?ftp):)\/\/)([^:\/\s]+)(?::(\d*))?(?:\/([^\s?#]+)?([?][^?#]*)?(#.*)?)?
```
https://stackoverflow.com/questions/25896916/parse-http-headers-in-c
#### read stdout and stderr from popen
https://stackoverflow.com/questions/478898/how-do-i-execute-a-command-and-get-the-output-of-the-command-within-c-using-po
#### VPS providers
https://www.skysilk.com/cloud/pricing/#classId=Standard&section=2
https://contabo.com/en/
https://www.hetzner.com/de/
#### Editor
https://viewsourcecode.org/snaptoken/kilo/07.syntaxHighlighting.html
http://antirez.com/news/108
https://github.com/antirez/kilo