Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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 compilation compiler compiler-construction csp cspydr hacktoberfest language low-level proglangs-discord programming-language rust standard-library static-typed stdlib syntax x86-64 x86-64-linux-gnu

Last synced: about 14 hours 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 3 years ago)
Default Branch: main
Last Pushed: 2024-10-20T21:32:35.000Z (26 days ago)
Last Synced: 2024-10-21T05:36:50.820Z (26 days ago)
Topics: assembly, assembly-x86-64, c, compilation, compiler, compiler-construction, csp, cspydr, hacktoberfest, language, low-level, proglangs-discord, programming-language, rust, standard-library, static-typed, stdlib, syntax, x86-64, x86-64-linux-gnu
Language: C
Homepage:
Size: 4.67 MB
Stars: 84
Watchers: 5
Forks: 2
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)**

[![License](https://img.shields.io/github/license/spydr06/cspydr?style=flat-square)](https://github.com/Spydr06/CSpydr/blob/main/LICENSE)

[![Issues](https://img.shields.io/github/issues/spydr06/cspydr?style=flat-square)](https://github.com/Spydr06/CSpydr/issues)

![GitHub pull requests](https://img.shields.io/github/issues-pr/spydr06/cspydr?style=flat-square)

![Platform](https://img.shields.io/badge/platform-linux_x86__64-blueviolet?style=flat-square)

[![Stars](https://img.shields.io/github/stars/spydr06/cspydr?style=flat-square)](https://github.com/Spydr06/CSpydr/stargazers)

[![Forks](https://img.shields.io/github/forks/spydr06/cspydr?style=flat-square)](https://github.com/Spydr06/CSpydr/network/members)

![GitHub repo size](https://img.shields.io/github/repo-size/spydr06/cspydr?style=flat-square)

![Lines of code](https://raster.shields.io/tokei/lines/github/spydr06/CSpydr?style=flat-square)



**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)

![](examples/assets/img/helloworld.png)

Fibonacci

### [fibonacci.csp](examples/traditional/fibonacci.csp)

![](examples/assets/img/fibonacci.png)

Lambda Functions

### [lambda.csp](examples/language/lambda.csp)

![](examples/assets/img/lambda.png)

Read File

### [read_file.csp](examples/std/read_file.csp)

![](examples/assets/img/read_file.png)

Random Number Generator

### [random.csp](examples/std/rand.csp)

![](examples/assets/img/random.png)

Time & Timer API

### [time.csp](examples/std/time.csp)

![](examples/assets/img/time.png)

> 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)