https://github.com/azer0s/hummus
A gluten free LISP (ish) interpreter powered by black magic
https://github.com/azer0s/hummus
actor-model black-magic concurrent-programming gluten-free hacktoberfest interpreter lisp scripting-language
Last synced: 4 days ago
JSON representation
A gluten free LISP (ish) interpreter powered by black magic
- Host: GitHub
- URL: https://github.com/azer0s/hummus
- Owner: Azer0s
- License: mit
- Created: 2017-08-16T12:32:00.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-02-23T20:53:58.000Z (2 months ago)
- Last Synced: 2025-04-06T12:06:20.491Z (29 days ago)
- Topics: actor-model, black-magic, concurrent-programming, gluten-free, hacktoberfest, interpreter, lisp, scripting-language
- Language: Go
- Homepage:
- Size: 484 KB
- Stars: 14
- Watchers: 1
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Getting started
```bash
git clone https://github.com/Azer0s/Hummus.git
cd Hummus
```
### Running locally
```bash
make all
echo "export PATH=\"$(pwd)/bin:\$PATH"\" >> ~/.bashrc
```
### Creating a Hummus project
```bash
hummus init helloworld
cd helloworld
hummus run
```
### Running on docker
```bash
docker build -t azer0s/hummus:latest .
docker run --rm -it azer0s/hummus:latest
```
Or get the edge image:
```bash
docker run --rm -it azer0s/hummus:edge
```
## Examples
### Variable assignment
```clojure
(def a "Hello world")
```
### Function assignment
```clojure
(def square (fn x
(* x x)))
```
### Anonymous function
```clojure
((fn x (* x x)) 4)
```
### Use function
```clojure
(out (square 4))
```
### Structs
```clojure
(use :)
(def Animal (struct
:name
:age
:race
))
(def tom (Animal
"Tom"
1
:cat
))
(out (:name tom) " is a " (` (:race tom))) ; prints Tom is a cat
```
### Parallel processing
````clojure
(use :)
(use :)
(def square (fn x
(* x x)))
(pipe/parallel-do 4 out square)
````
### Maps
```clojure
(use :)
(def prices ({}
(:tea :1.5$)
(:coffee :2$)
(:cake :3$)
))
(out "Cake costs " (` (:cake prices)))
(out "Tea costs " (` ([] :tea prices)))
```
### Macros
```clojure
(def dotimes (macro times |action|
; || tells Hummus to not evaluate this argument but to
; literally take the AstNode as it's input parameter
(map (.. 1 times) (fn _ (identity action)))
))
(dotimes 3 (out "Hello world"))
; Same as writing
; (out "Hello world")
; (out "Hello world")
; (out "Hello world")
(def when (macro |cond| |action|
(' :if cond action)
))
(when (> 4 3) (out "A"))
; same as writing
; (if (> 4 3)
; (out "A"))
```
### Actor model
```clojure
(use :)
(use :)
(def ping (fn
(for true
(def msg (receive))
(def type (nth 0 msg))
(def sender (nth 1 msg))
(if (= type :pong)
((fn
(out "PONG")
(sync/sleep 1 :s)
(send sender (list :ping self))
))
(out "Invalid message!")
)
)
))
(def pong (fn
(for true
(def msg (receive))
(def type (nth 0 msg))
(def sender (nth 1 msg))
(if (= type :ping)
((fn
(out "PING")
(sync/sleep 1 :s)
(send sender (list :pong self))
))
(out "Invalid message!")
)
)
))
(def pingPid (spawn ping))
(def pongPid (spawn pong))
(send pongPid (list :ping pingPid))
(in)
```
### Map ⇄ Filter ⇄ Reduce
```clojure
(use :)
(use :)
(def pilots (list
({}
(:id 2)
(:name "Wedge Antilles")
(:faction "Rebels")
)
({}
(:id 8)
(:name "Ciena Ree")
(:faction "Empire")
)
({}
(:id 40)
(:name "Iden Versio")
(:faction "Empire")
)
({}
(:id 66)
(:name "Thane Kyrell")
(:faction "Rebels")
)
))
(each
(map pilots (fn x
(str/concat (` (:name x)) " => " (` (:faction x)))
))
(fn x
(out x)
))
(each
(filter pilots (fn x
(= (:faction x) "Empire")
))
(fn x
(out (:name x))
))
(out (reduce pilots (fn x acc
(if (= (:faction x) "Empire")
(+ acc 1)
acc
)
) 0))
```
### Function composition
```clojure
(use :)
(use :)
(use :)
(def add (fn a b
(+ a b)
))
(def square(fn x
(* x x)
))
(def add-square-out (|> add square out))
(add-square-out 3 1) ; prints 16
(pipe/do pilots
(map.. (fn x
(str/concat (` (:name x)) " => " (` (:faction x)))
))
(each.. (fn x
(out x)
))
)
(pipe/do pilots
(filter.. (fn x
(= (:faction x) "Empire")
))
(map.. (fn x
(:name x)
))
(each.. (fn x
(out x)
))
)
(pipe/do pilots
(reduce.. (fn x acc
(if (= (:faction x) "Empire")
(+ acc 1)
acc
)
) 0)
out
)
```
### HTTP Server
```clojure
(use :)
(use :)
(http/handle "/" (fn req
(str/concat "
Hello " (:method req) "
")
))
(http/handle "/test" (fn req
"
Test
"
))
(http/serve ":8080")
```
### Examples
```clojure
(use :)
(use :)
(def fib (fn n
(if (< n 2)
1
(+ (fib (- n 2)) (fib (- n 1)))
)
))
(for (range x (list "Hello" "World"))
(out x)
)
(for (range x (to 10))
(out x)
)
(for true
(out "Hello world")
)
(str/concat "String functions go b" (str/repeat "r" 10))
```
## Get help
```clojure
(use :)
(hummus/info-group log)
```
## Exit the application
```clojure
(exit)
```
## License
[MIT](https://choosealicense.com/licenses/mit/)
## Credits
* peterh/liner - used for REPL
* sirupsen/logrus - used in the log stdlib