https://github.com/benhoyt/loxlox

Lox interpreter written in Lox
https://github.com/benhoyt/loxlox

crafting-interpreters interpreter lox meta

Last synced: 5 days ago
JSON representation

Lox interpreter written in Lox

• Host: GitHub
• URL: https://github.com/benhoyt/loxlox
• Owner: benhoyt
• License: mit
• Created: 2018-10-01T12:56:59.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2023-06-27T10:02:42.000Z (over 1 year ago)
• Last Synced: 2024-10-31T21:25:20.118Z (12 days ago)
• Topics: crafting-interpreters, interpreter, lox, meta
• Language: Python
• Homepage:
• Size: 98.6 KB
• Stars: 114
• Watchers: 6
• Forks: 10
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        

LoxLox

======

LoxLox is an interpreter for [Crafting Interpreters'](http://www.craftinginterpreters.com/) [Lox](http://www.craftinginterpreters.com/the-lox-language.html) language written in ... Lox.

Below are a few notes about running LoxLox, but you can [**read more about LoxLox here**](https://benhoyt.com/writings/loxlox/).

## How to run LoxLox

First clone the LoxLox repo as well as the Crafting Interpreters one:

```

$ git clone https://github.com/benhoyt/loxlox

$ git clone https://github.com/munificent/craftinginterpreters

```

### JLox

Then patch the Crafting Interpreters repo to add the required builtins to JLox (`getc`, `chr`, etc) and build JLox:

```

$ cd craftinginterpreters

$ git apply ../loxlox/jlox_diff.patch

$ make jlox

$ cd ../loxlox

```

Now you're ready to run LoxLox (input is passed to LoxLox on stdin):

```

$ 

$ ./jlox lox.lox < example.lox

1

4

9

16

Waddles quacks

6

105

$ ./jlox lox.lox < sum.lox 

4.99995E9

$ echo 'print "Hello world!";' | ./jlox lox.lox 

Hello world!

```

### CLox

Thanks to [gloria-mundi](https://github.com/gloria-mundi)'s [patch](https://github.com/benhoyt/loxlox/blob/master/clox_diff.patch), you can now even run LoxLox under CLox. Patch the Crafting Interpreters repo in much the same way as above:

```

$ cd ../craftinginterpreters

$ git apply ../loxlox/clox_diff.patch

$ make clox

$ cd ../loxlox

```

You should now be able to run the examples the same way as above, but replace `./jlox` with `./clox`. It's about 6x as fast -- see the [benchmarks](https://github.com/benhoyt/loxlox/pull/3)!

## Running the tests

To run the Lox test suite under LoxLox, use this command:

```

$ python3 test.py

```

Note that several tests will fail. That's expected -- the code works; the remaining failures are only from differences in the runtime error messages between JLox and LoxLox.

To run the tests and diff against the git-committed failures file (should be no diffs):

```

$ python3 test.py > failures

$ git diff failures

```

## Contact me

[Contact me](https://benhoyt.com/) if you have any feedback or suggestions. And if you get LoxLox to run under LoxLox ... mind blown.