1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
# HALK
*HALK* seeks to be a language.
I seek to fulfill its wishes.
As of yet, *HALK* is nothing.
As of yet, we are safe.
# Installation
As you have read these words, you are to install *HALK*.
1. Clone *HALK* to a computer.
2. `sudo make install`.
If you wish to remove all *HALK*-related items from your life, you can try `sudo make clean`.
There is no turning back now.
# Usage
Seeing as you have installed *HALK*, it only makes sense that you should attempt to make use of it.
You are mistaken.
Usage of *HALK* is not yet a feature of *HALK*.
One can only hope this feature will be added in the future.
# Syntax
*HALK* is a **dubiously-typed**, **procedural**, **interpreted** programming language.
Note that all syntax described is liable to sudden and violent change.
```HALK
[comments in square brackets]
[preprocessor directives]
#INCLUDE 'math.halk'; [looks for a 'math.halk' file in the cwd, then ~/halk/include]
#INCLUDE 'io' AS ''; [bring everything in 'io' into global scope]
let.hello -> 'hello, '; [variables must be given a value at declaration]
let.PI => math/PI; [namespaces are accessed with a '/']
[constants are denoted with a '=>']
fn.greeting,to -> { [functions defined with: `fn.<name>,<argument>,..., -> {<body>};`]
let.message -> strcat.hello,to; [functions are right-associative]
stdo.message; [since 'io' was brought into global scope, we
do not prefix it with a namespace/]
};
fn.sum_all._ -> { [variadic functions are possible with the reserved '_' argument,
which is treated as an array]
return.foldl.+,0,_;
};
fn.fibonacci.n -> {
if.or.(num=?.n, 0), (num=?.n, 1) -> { [functions ending in '?' should be predicates]
return.1;
};
return.+.(fibonacci. -.n, 1), (fibonacci. -.n, 2); [parens can be used to group function application]
};
fn.main -> { [where our code will begin executing]
greeting.[comments can be placed *anywhere*]"world.";
exit.0; [exit with code 0 for success]
};
```
***HALK*** **progress:** 20%
- [x] Lexer
- [ ] Abstract Syntax Tree
- [ ] Parser
- [ ] Doer
- [ ] ?? profit ??
|
