blob: 311565d9702fafa8316b156614f134b1a018c9ad (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
# NimFunge98 : a Funge-98 interpreter written in nim
This repository contains code for a nim program that can interpret a valid [Funge-98](https://github.com/catseye/Funge-98/blob/master/doc/funge98.markdown) program. It will soon pass the [mycology test suite](https://github.com/Deewiant/Mycology).
Current limitations are :
- it is not finished!
- 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)
- [Running tests](#running-tests)
## Dependencies
nim is required. Only nim version >= 1.4.8 on linux amd64 (Gentoo) is being regularly tested.
## Quick Install
To install, clone this repository then run :
```
nimble install
```
## Usage
Launching the interpreter is as simple as :
```
nimfunge98 -f something.b98
```
The interpreter will then load and execute the specified Funge-98 program until the program normally terminates or is interrupted or killed.
## Building
For a debug build, use :
```
nimble build
```
For a release build, use :
```
nimble build -d:release
```
## Running tests
To run unit tests, use :
```
nimble tests
```
To calculate the code coverage of tests, use :
```
nimble coverage
```
To run tests only on (for example) the stack module, use :
```
nim r tests/stack.nim
```
To debug these particular tests, use :
```
nim c --debugger:on --parallelBuild:1 --debuginfo --linedir:on tests/stack.nim
gdb tests/stack
```
|