1
0
Fork 0

Added readme

This commit is contained in:
Julien Dessaux 2022-09-10 19:38:29 +02:00
parent 6ab8d706bb
commit 54cb61927c
Signed by: adyxax
GPG key ID: F92E51B86E07177E

59
README.md Normal file
View file

@ -0,0 +1,59 @@
# ZigFunge98 : a Funge-98 interpreter written in zig
This repository contains code for a zig program that can interpret a valid [Funge-98](https://github.com/catseye/Funge-98/blob/master/doc/funge98.markdown) program. It passes the [mycology test suite](https://github.com/Deewiant/Mycology).
Current limitations are :
- currently does not implement any fingerprints
- does not implement concurrent execution with the `t` command
- does not implement file I/O with the `i` and `o` commands
- does not implement system execution with the `=` command
## Contents
- [Dependencies](#dependencies)
- [Quick install](#quick-install)
- [Usage](#usage)
- [Building](#building)
## Dependencies
zig is required. Only zig version >= 0.9.0 on linux amd64 (Gentoo) is being regularly tested.
## Quick Install
To get, compile then install zigfunge98, do something like:
```sh
git clone https://git.adyxax.org/adyxax/zigfunge98
cd zigfunge98
zig build
install ./zig-out/bin/zigfunge98 ~/.local/bin/
```
## Usage
Launching zigfunge98 is as simple as :
```sh
zigfunge98 something.b98
```
The interpreter will load and execute the specified Funge-98 program until the program normally terminates or is interrupted or killed.
## Building
To run tests, use :
```sh
zig build test
```
To test the coverage, use:
```sh
zig build test -Dtest-coverage
firefox kcov-output/index.html
```
For a non debug build, use either one of:
```sh
zig build -O ReleaseSafe
zig build -O ReleaseSmall
zig build -O ReleaseFast
```