https://github.com/spydr06/cspydr
A static typed low-level compiled programming language inspired by Rust and C
https://github.com/spydr06/cspydr
assembly assembly-x86-64 c compiler cspydr hacktoberfest2024 proglangs-discord programming-language standard-library static-typed syntax x86-64 x86-64-linux-gnu
Last synced: 3 months ago
JSON representation
A static typed low-level compiled programming language inspired by Rust and C
- Host: GitHub
- URL: https://github.com/spydr06/cspydr
- Owner: Spydr06
- License: mit
- Created: 2021-03-03T17:09:03.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-02-09T12:53:09.000Z (9 months ago)
- Last Synced: 2025-05-19T08:12:24.190Z (6 months ago)
- Topics: assembly, assembly-x86-64, c, compiler, cspydr, hacktoberfest2024, proglangs-discord, programming-language, standard-library, static-typed, syntax, x86-64, x86-64-linux-gnu
- Language: C
- Homepage:
- Size: 4.67 MB
- Stars: 88
- Watchers: 6
- Forks: 4
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
The CSpydr Programming Language
**[📑 Documentation](https://github.com/spydr06/cspydr/wiki) |
[💾 Installation](./INSTALL.md) |
[🤝 Contributing](./CONTRIBUTING.md) |
[📜 License](./LICENSE) |
[🔄 State](#current-state)**
[](https://github.com/Spydr06/CSpydr/blob/main/LICENSE)
[](https://github.com/Spydr06/CSpydr/issues)
[](https://github.com/Spydr06/CSpydr/stargazers)
[](https://github.com/Spydr06/CSpydr/network/members)
**CSpydr** is a low-level, static typed, free and open-source, compiled programming language inspired by Rust and C. This repository contains `cspc` (the **CSpydr Programming Language Compiler**), as well as CSpydr's **Standard Library**, a [code-linting utility](./src/linter), some code examples and unit tests.
## Code Examples
Hello World
### [helloworld.csp](examples/traditional/helloworld.csp)
Fibonacci
### [fibonacci.csp](examples/traditional/fibonacci.csp)
Lambda Functions
### [lambda.csp](examples/language/lambda.csp)
Read File
### [read_file.csp](examples/std/read_file.csp)
Random Number Generator
### [random.csp](examples/std/rand.csp)
Time & Timer API
### [time.csp](examples/std/time.csp)
> More examples can be found in the [**examples**](./examples/) directory
## Current State
**A list of all the features, that are already implemented or planned.**
##### cspc Compiler features:
- [x] Assembly code generator for `x86_64 linux`
- [ ] LLVM codegen target (maybe even WASM?)
- [ ] move to an intermediate bytecode compiler
- [ ] AST to JSON converter (in progress)
- [x] C transpiler
- [x] lexing tokens
- [x] `macro` and `import` preprocessor
- [x] parsing an AST, validation of syntax and semantics
- [x] type evaluator & checking
- [x] implicit type casts
- [ ] "projects" - prebuild libraries such as the `stdlib`
- [x] CLI and error handling
- [x] memory management
##### CSpydr Language features:
- [x] primitive data types `i8` `i16` `i32` `i64` `u8` `u16` `u32` `u64` `f32` `f64` `f80` `bool` `char` `void`
- [x] pointers, arrays and c-like arrays `&` `[]` `'c[]`
- [x] custom data types `struct` `union` `enum` `{}` (tuples)
- [x] control statements `if` `match` `for` `while` `loop` `ret` `break` `continue` `noop` `with` `do-while` `do-unless` `defer`
- [x] different loop types: `for`, `while`, `do-while` and `loop`
- [x] expressions
- [x] `extern` functions and globals
- [x] type-related keywords `sizeof` `typeof` `alignof` `len`
- [x] file imports
- [x] macros and macro-overloading
- [x] default macros `__version__` `__system__` `__architecture__` `__time__` `__compile_type__` `__main_file__` `__file__` `__line__` `__func__`
- [x] namespaces, functions, globals, typedefs
- [x] inline `asm` code blocks
- [x] lambda expressions
- [ ] templates in fuctions and structs
- [x] va lists
- [x] interfaces, vtables and dynamic-dispatch for functions
- [ ] dynamic-dispatch for constants
- [ ] functions as struct members
##### CSpydr Standard library features
- [x] basic `c17` `libc`-header implementation
- [x] `glfw` and `OpenGL`/`GLU` header files
- [x] `cURL` header implementation
- [x] from-the-ground custom written `stdlib` based on linux syscalls (in progress)
## Installation
Please refer to [INSTALL.md](./INSTALL.md) for installation instructions and information about compatability
## Hello, World!
A simple [hello-world](./examples/traditional/helloworld.csp) program:
```rust
import "io.csp";
fn main(): i32
{
std::io::puts("Hello, World!");
<- 0;
}
```
Running this program is as easy as entering the following command:
```console
$ cspc run hello-world.csp
```
### Examples
> For more examples, please refer to the `examples/` directory in this repository.
## Usage
To compile a CSpydr program use the following command:
```console
$ cspc build
```
To directly run a program use this command:
```console
$ cspc run
```
To launch a special debug shell, start your program using the `debug` action:
*(not finished yet!)*
```console
$ cspc debug
```
Get help using this command:
```console
$ cspc --help
```
*(I will write a proper documentation in the future!)*
## Editor support
Editor support is found in the **[editors/](./editors)** subdirectory.
Supported editors include:
- [NeoVim/Vim](./editors/neovim)
- [VSCode](./editors/vscode)
> **Note**
> For quick installation, use the `install.sh` script in the respective subdirectory.
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update the unit tests as appropriate.
**View CONTRIBUTING.md for more information**
## License
CSpydr is licensed under the [MIT License](https://mit-license.org/).
## Resources | Reference | Inspiration
- chibicc C compiler: https://github.com/rui314/chibicc.git
- vcc: https://github.com/lemoncmd/vcc.git
- tac programming language: https://github.com/sebbekarlsson/tac.git
- summus programming language: https://github.com/igor84/summus.git
- porth programming language: https://gitlab.com/tsoding/porth.git
- cURL C library for transferring data: https://github.com/curl/curl
- tiny-regex-c as the main inspiration behind `regex.csp`: https://github.com/kokke/tiny-regex-c.git
- logo inspiration: IntelliJ IDEs (https://www.jetbrains.com/),
Haskell-Intellij Plugin (https://plugins.jetbrains.com/plugin/8258-intellij-haskell)