Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
40 lines (28 loc) · 1.46 KB

CONTRIBUTING.md

File metadata and controls

40 lines (28 loc) · 1.46 KB

CONTRIBUTING

This page provides some general technical information about concepts and tools used in this project. We hope this will help guide future contributors to helpful resources.

What is a binding

A binding makes it easier for a Node.js application to take advantage of the ZMQ C++ library, libzmq. The binding provides native JavaScript support to use the ZMQ library.

What is libzmq

Libzmq is the low-level library behind most of the different language bindings, including zeromq.js. Libzmq exposes a C-API and is implemented in C++.

How to create the binding

To create the binding, use node-gyp Node.js native addon build tool. node-gyp is a cross-platform command-line tool written in Node.js for compiling native addon modules for Node.js.

  • npm install -g node-gyp to install
  • node-gyp configure
  • node-gyp build
  • For a debug build add --debug to the configure and build commands

What is a binding.gyp file

A binding.gyp file describes the configuration to build your module. This file gets placed in the root of your package, alongside package.json.

GYP, short for Generate Your Project, is a build tool similar to Cmake. GYP was originally created to generate native IDE project files (Visual Studio, Xcode) for building Chromium.

The .gyp file is structured as a Python dictionary.