133 lines
5.9 KiB
Markdown
133 lines
5.9 KiB
Markdown
# The Core Language
|
|
|
|
A compiled language that assumes C as base reality but it also has lots of ideas taken from Jai, Go like type system, order indepent declarations using Ion algorithm. Syntax currently is whitespace significant. Made to practice language development, **it's not supposed to be used**. It has lot's of ideas from modern programming languages that you would not find in any compiler book. It supports **modules** combined with **ordered independent declarations** and **lazy typechecking**. Also **runtime reflection**, **slices** and other standard features you would find in C.
|
|
|
|
The language is currently **very debuggable**. It can produce readable C code with line directives. This allows you to debug the programs with Visual Studio with full source mapping, exactly like you would debug C programs.
|
|
|
|
## Language example code
|
|
|
|
``` C
|
|
W :: #import "Windows.kl"
|
|
#import "base.kl"
|
|
|
|
PAGE_SIZE :: 4096
|
|
Memory :: struct
|
|
commit : SizeU
|
|
reserve: SizeU
|
|
data : *U8
|
|
|
|
reserve :: (size: SizeU): Memory
|
|
result := Memory{reserve=align_up(size, PAGE_SIZE)}
|
|
result.data = W.VirtualAlloc(
|
|
flProtect = W.PAGE_READWRITE,
|
|
dwSize = result.reserve,
|
|
flAllocationType = W.MEM_RESERVE,
|
|
lpAddress = 0)->*U8
|
|
return result
|
|
|
|
commit :: (m: *Memory, size: SizeU): Bool
|
|
commit_size := align_up(size, PAGE_SIZE)
|
|
total_commit := m.commit + commit_size
|
|
clamped_commit := clamp_top_sizeu(total_commit, m.reserve)
|
|
adjusted_commit := clamped_commit - m.commit
|
|
if adjusted_commit != 0
|
|
result := W.VirtualAlloc(
|
|
lpAddress = (m.data + m.commit)->*void,
|
|
dwSize = adjusted_commit,
|
|
flAllocationType = W.MEM_COMMIT,
|
|
flProtect = W.PAGE_READWRITE,
|
|
)
|
|
m.commit += adjusted_commit
|
|
return true
|
|
return false
|
|
|
|
// Examples that showcase language features can be found in /examples
|
|
```
|
|
|
|
## Features
|
|
|
|
* Order independent declarations
|
|
* Module system
|
|
* #import for lazy loading(unused code is not compiled, big win)
|
|
* #load for normal loading
|
|
* Types as first class values and runtime reflection
|
|
* Any type
|
|
* Type type
|
|
* Slices
|
|
* Whitespace significant syntax
|
|
* Debuggable(emitting proper line directives)
|
|
|
|
## Building
|
|
|
|
1. Install **Visual Studio** and **Clang**
|
|
1. Run **build.bat**
|
|
|
|
## Resources
|
|
|
|
Stuff that helped me a lot programming the compiler. Hopefully they also will be helpful to you!
|
|
|
|
* https://bitwise.handmade.network/ - series by Per Vognsen where he actually creates a C like language, very helpful, very hands on!
|
|
* https://hero.handmade.network/episode/code/day206/ - this episode of handmade hero started me on the entire compiler journey a long, long time ago.
|
|
* https://www.youtube.com/watch?v=TH9VCN6UkyQ&list=PLmV5I2fxaiCKfxMBrNsU1kgKJXD3PkyxO - I have rewatched this playlist many this, searching for keywords and ideas. Jonathan Blow's compiler was a big inspiration of mine when learning programming languages.
|
|
* A Retargetable C Compiler: Design and Implementation by Christopher W. Fraser and David R. Hanson - sometimes looked at this as a reference to figure stuff out. Very helpful resource on compiler construction, the way it's written reads more like documentation but you use what you have.
|
|
* https://github.com/JoshuaManton/sif - looked at this as a reference from time to time, author seems like a Jonathan Blow fan so it was a good resource informed by similar resources as I used.
|
|
* https://github.com/c3lang/c3c - I sometimes looked at C3 compiler as a reference, the author also let me use his big int library he wrote sometime in the past! Thanks a lot!
|
|
* https://go.dev/blog/constants - article on golang type system, untyped types, constants that kind of stuff.
|
|
|
|
## Done
|
|
|
|
- [x] Constant evaluation and constant folding - Folding and precomputing every expression that can be calculated at compile time. Which allows to check if a given constant expression is actually something that can be computed at compile time.
|
|
- [ ] Constant expressions with types specified by the user.
|
|
|
|
- [x] Untyped types - Context dependent type assignment of constant expressions, this is a feature I really loved in Go, it makes constants work very well with a very strict type system and it makes errors like overflow of constants in C due to bad size specifier impossible.
|
|
- [x] Infinite precision integers in constants.
|
|
- [x] Resolution of all untyped types in the typechecking stage.
|
|
- [x] Special case of booleans and their type propagation.
|
|
|
|
- [x] Module system
|
|
- [x] Lazy evaluation of modules (unused code is not compiled or typechecked)
|
|
- [x] Import module, load project file distinction
|
|
|
|
- [x] Order independent declarations - The ordering of functions in code files or modules does not matter, compiler figures all that stuff out for you. "main" can be wherever you want it to be and all functions should be available without problems.
|
|
- [ ] Should constants and others be disallowed inside of structs?
|
|
|
|
- [x] Synchronize generated C code with original source using line directives so that debuggers work.
|
|
|
|
- [ ] Expressions
|
|
- [x] Compounds with named fields and numbered fields
|
|
- [x] Functions calls with named arguments
|
|
- [x] All the standard binary, unary expressions
|
|
- [ ] Dot access expression needs a redesign
|
|
- [ ] Casting might need a redesign not sure
|
|
- [x] Pointer arithmetic and pointer as array
|
|
|
|
- [ ] Tuples
|
|
- [x] Multiple return values from a function
|
|
- [ ] Some kind of tuple expressions
|
|
- [ ] Using tuples as single values without unpacking
|
|
|
|
- [x] Runtime reflection
|
|
- [x] Dumping info
|
|
- [ ] Is the design of this correct? That's a lot of data.
|
|
|
|
- [ ] Builtin data structures
|
|
- [x] Arrays
|
|
- [x] Slices
|
|
- [ ] Dynamic arrays
|
|
- [ ] Hash tables
|
|
|
|
- [ ] Generics / Parametric polymorphism
|
|
|
|
- [ ] Platforms
|
|
- [x] Windows
|
|
- [ ] Unix based
|
|
|
|
- [ ] Language constructs
|
|
- [x] If
|
|
- [x] For loops
|
|
- [x] Functions
|
|
- [x] Structures
|
|
- [ ] Unions (or something like unions)
|
|
- [x] Switch (but maybe needs redesign?)
|
|
- [ ] Unnamed blocks
|