generator-napi-module

generator-napi-module

A yeoman generator to create a next-generation Node native module using N-API

Use this module to quickly generate a skeleton module using N-API, the new API for Native addons introduced in Node 8. This module automatically sets up your gyp files to use node-addon-api, the C++ wrappers for N-API and generates a wrapper JS module. Optionally, it can even configure the generated project to use TypeScript instead!

Installation

First, install Yeoman and generator-napi-module using npm (we assume you have pre-installed node.js).

npm install -g yo
npm install -g generator-napi-module

Create a directory for your N-API module:

mkdir <moduleName>
cd <moduleName>

Then generate your new project:

yo napi-module

This will generate a really simple N-API module- think of this as the Hello world of N-API modules. If you want a slightly more complicated module that is similar to what you'd write in a real world N-API module, run the following command:

yo napi-module --intermediate

Getting To Know Yeoman

• Yeoman has a heart of gold.
• Yeoman is a person with feelings and opinions, but is very easy to work with.
• Yeoman can be too opinionated at times but is easily convinced not to be.
• Feel free to learn more about Yeoman.

Contributing

This project accepts pull requests! To contribute a change:

• Fork this repo
• Run npm install to install your dependencies
• Make your changes
• Run npm run build to compile the TypeScript file
• Run npm run test to verify that the unit tests pass
• Run npm link to "install" your generator
• Create a scratch directory: 7.1. Run yo napi-module 7.2. Run npm test

If all looks good, submit your PR!

License

MIT © Hitesh Kanwathirtha