picoc-js

This is Picoc recompiled to WASM and distributed as a npm package.

Overview

Original Repo: https://gitlab.com/zsaleeba/picoc/

PicoC is a very small C interpreter for scripting. It was originally written as a script language for a UAV's on-board flight system. It's also very suitable for other robotic, embedded and non-embedded applications.

The core C source code is around 3500 lines of code. It's not intended to be a complete implementation of ISO C but it has all the essentials. When compiled it only takes a few k of code space and is also very sparing of data space. This means it can work well in small embedded devices. It's also a fun example of how to create a very small language implementation while still keeping the code readable.

picoc is now feature frozen. Since it's important that it remain small it's intended that no more major features will be added from now on. It's been tested on x86-32, x86-64, powerpc, arm, ultrasparc, HP-PA and blackfin processors and is easy to port to new targets.

Installation

Node.JS

npm i picoc-js

or

yarn add picoc-js

Browser

<script src="https://unpkg.com/[email protected]/dist/bundle.umd.js" type="text/javascript" charset="utf-8"></script>

Example Usage

Node.JS

import {runC} from 'picoc-js';

const cprog = `
#include <stdio.h>
int main() {
   // printf() displays the string inside quotation
   printf("Hello, World!\n");
   return 0;
}
`;

runC(cprog, (output) => { console.log("StdOut: " + output);});

Browser

<script>
const cprog = `
#include <stdio.h>
int main() {
   // printf() displays the string inside quotation
   printf("Hello, World!\n");
   return 0;
}
`;

picocjs.runC(cprog, (output) => { console.log(output) });
</script>

Building Project

Make sure emscripten is installed and sourced. Then you can simply run:

yarn build

Should build the latest version and compile it into bundle.js