wiring-preprocessor
v2.3.0
Published
Preprocess Wiring (ino) files to C++ (cpp)
Downloads
342
Readme
Wiring Preprocessor
This Javascript library preprocesses .ino
files into .cpp
.
Overview | Installation | Development | Examples | Releasing | License
Overview
The preprocessor automatically adds the line #include "Particle.h"
to the top of the file, unless your file already includes "Particle.h"
, "Arduino.h"
or "application.h"
.
The preprocessor adds prototypes for your functions so your code can call functions declared later in the source code. The function prototypes are added at the top of the file, below #include
statements.
If you define custom classes, structs or enums in your code, the preprocessor will not add prototypes for functions with those custom types as arguments. This is to avoid putting the prototype before the type definition. This doesn't apply to functions with types defined in libraries. Those functions will get a prototype.
If you are getting unexpected errors when compiling valid code, it could be the preprocessor causing issues in your code. You can disable the preprocessor by adding #pragma PARTICLE_NO_PREPROCESSOR
to your file. Be sure to add #include "Particle.h"
and the function prototypes to your code.
Installation
npm install wiring-preprocessor
Development
- Install Node.js [
node@16
andnpm@8
are required] - Clone this repository
$ git clone [email protected]:particle-iot/wiring-preprocessor.git && cd ./wiring-preprocessor
- Install dependencies
$ npm install
- View available commands
$ npm run
- Run the tests
$ npm test
- Start Hacking!
Examples
const preprocessor = require('wiring-preprocessor');
const inoFile = fs.readFileSync('app.ino', 'utf8');
const cppFile = preprocessor.processFile('app.ino', inoFile);
fs.writeFileSync('app.cpp', cppFile);
Run tests
npm test
Releasing
See the release process in the RELEASE.md file.