docl

An interpreter for do -- an assembly inspired programming language

Usage no npm install needed!

<script type="module">
  import docl from 'https://cdn.skypack.dev/docl';
</script>

README

docl

Actions Status

This is a command line tool to run code for the do programming language.

The do programming language is a small programming language that I wrote as an example language that is parseable by my lngr library (npm registry and github repository). The language specification is inspired by the simplicity of 32-bit assembly language code with Intel syntax. Note: node has a default maximum JavaScript heap allocation size. See this stackoverflow question to change how much memory it will allow.

This implementation uses a dvm (do virtual machine) to execute the code line by line and keep track of memory that is in use. It also has an interactive mode, where the user can type lines of do code and the dvm will execute them as it goes.

  • To learn more about the syntax of this language, check out the token and rule definitions in grammar.json.
  • To see some example code, check out sample.do.
  • To run code from a file, pass the filename as an argument to node index.js.
  • To build precompiled binaries, run npm run build in the root directory.

Go to the releases tab to download precompiled binaries.