Added readme
This commit is contained in:
parent
6ab8d706bb
commit
54cb61927c
1 changed files with 59 additions and 0 deletions
59
README.md
Normal file
59
README.md
Normal 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
|
||||
```
|
Loading…
Add table
Reference in a new issue