mnm

Make Node Module is a build tool for making native node.js modules.

Installation

$ npm install mnm

Quick Examples

var builder = new Builder();

builder.appendUnique('CXXFLAGS', ['-Isrc/']);
builder.appendSourceDir('./src');
builder.target = "mynativemodule_bindings";

builder.compileAndLink();

Realworld Examples

• node-java - A node.js to Java bridge.
• node-shark - Wrapper around libwireshark providing network packet dissection.

Index

builder

• appendLinkerLibrary
• appendLinkerSearchDir
• appendUnique
• appendSourceDir
• appendSource
• compile
• link
• compileAndLink

command line arguments

• -v - Verbose
• -Wall - Show Warnings

API Documentation

Adds a library to the linker.

Arguments

• libname - The name of the library to add. This string should not contain the lib prefix or the extension.

Example

builder.appendLinkerLibrary('ssl');

Adds a library to the linker search path.

Arguments

• dir - The directory to add to the search path.

Example

builder.appendLinkerSearchDir('/usr/local/lib');

Adds a flag or flags to a flag group.

Arguments

• flagGroup - The flag group to add the flags to. This should be LINKFLAGS or CXXFLAGS.
• flags - A single string or array of strings to add to the group.

Example

builder.appendUnique('CXXFLAGS', '-Wall');
builder.appendUnique('CXXFLAGS', ['-Idir1', '-Idir2']);

Adds a source code directory to the list of compilable items. All files with the extensions cpp, c, cxx will be added to the compile step.

Arguments

• dir - The path to the directory containing the source files.

Example

builder.appendSourceDir('./src');

Adds a single source file to the list of compilable items.

Arguments

• fileName - The name of the file to compile.

Example

builder.appendSource('./src/myModule.cpp');

Performs the compile.

Arguments

• callback (optional) - An optional callback to be called when the compile is complete.

Example

builder.compile();

Performs the link.

Arguments

• callback (optional) - An optional callback to be called when the link is complete.

Example

builder.link();

Performs the compile and link.

Arguments

• callback (optional) - An optional callback to be called when the compile and link is complete.

Example

builder.compileAndLink();

Prints the command lines being executed along with other verbose output.

Adds the -Wall flag to the compile and prints all compiler warnings.

License

(The MIT License)

Copyright (c) 2012 Near Infinity Corporation

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.