cmake-js

What is cmake-js?

The cmake-js npm package is a tool that simplifies the process of building native C++ addons for Node.js using CMake. It provides a seamless integration between Node.js and CMake, allowing developers to leverage the powerful build system of CMake while working within the Node.js ecosystem.

What are cmake-js's main functionalities?

Building Native Addons

This feature allows you to build native C++ addons for Node.js using CMake. The code sample demonstrates how to use cmake-js to build a target named 'myAddon' in debug mode.

const cmake = require('cmake-js');

cmake.build({
  target: 'myAddon',
  debug: true
}).then(() => {
  console.log('Build complete');
}).catch(err => {
  console.error('Build failed', err);
});

Configuring Build Options

This feature allows you to configure various build options for your CMake project. The code sample shows how to set the build type to 'Release' and specify an installation prefix.

const cmake = require('cmake-js');

cmake.configure({
  CMAKE_BUILD_TYPE: 'Release',
  CMAKE_INSTALL_PREFIX: '/usr/local'
}).then(() => {
  console.log('Configuration complete');
}).catch(err => {
  console.error('Configuration failed', err);
});

Running CMake Commands

This feature allows you to run arbitrary CMake commands. The code sample demonstrates how to run a CMake build command to install the target.

const cmake = require('cmake-js');

cmake.run(['--build', '.', '--target', 'install']).then(() => {
  console.log('CMake command executed successfully');
}).catch(err => {
  console.error('CMake command failed', err);
});

Other packages similar to cmake-js

node-gyp

node-gyp is a cross-platform command-line tool written in Node.js for compiling native addon modules for Node.js. It uses the gyp build system instead of CMake. While node-gyp is widely used and well-supported, it lacks the flexibility and advanced features of CMake, which cmake-js leverages.

node-pre-gyp

node-pre-gyp is a tool that makes it easy to publish and install Node.js C++ addons from binaries. It is built on top of node-gyp and provides additional features like binary hosting and pre-built binary distribution. However, it does not offer the same level of integration with CMake as cmake-js.

neon-cli

neon-cli is a tool for building fast and safe native Node.js modules using Rust instead of C++. It provides a high-level abstraction over the Node.js C++ API and offers a more modern and safer language for writing native modules. While it is not directly comparable to cmake-js, it serves a similar purpose of enabling native module development for Node.js.

README

CMake.js

CMake.js - a Node.js/io.js native addon build tool.

Readme and tutorials are gonna be available soon. Until then please refer the help and take a look at the example projects in the tests directory.

Install:

npm install -g cmake-js

Help:

cmake-js --help