grpc-node/packages/grpc-native-core
murgatroid99 efa3d430dd Add deprecation notice to grpc.load 2018-06-11 15:05:47 -07:00
..
deps Update grpc submodule on master 2018-06-05 17:08:21 -07:00
ext typo 2018-04-23 17:28:47 +08:00
src Merge pull request #207 from theogravity/master 2018-03-13 17:13:52 -07:00
templates Ensuring the presence of node-pre-gyp before publishing. 2018-05-24 23:57:17 +02:00
test Start server after adding server ports 2018-04-03 10:57:04 -07:00
tools Split native and cross compilers into two docker images. 2018-05-18 09:44:53 +02:00
.jshintignore Moving files into their new location. 2017-09-12 01:33:18 +02:00
.npmignore Remove some unnecessary files from the native npm package 2017-09-19 11:18:00 -07:00
README.md Update package descriptions in README, add API docs link 2017-09-14 13:03:21 -07:00
binding.gyp Update grpc submodule on master 2018-06-05 17:08:21 -07:00
build.yaml Bumping to 1.12.2. 2018-05-24 05:34:25 +02:00
gulpfile.js Increasing mocha timeout to 5s up from 2s. 2018-05-25 19:16:04 +02:00
index.d.ts optional value for covenience 2018-05-06 14:57:12 +08:00
index.js Add deprecation notice to grpc.load 2018-06-11 15:05:47 -07:00
jsdoc_conf.json Move dependencies around, add gulp target for document generation 2017-09-20 12:39:16 -07:00
package.json Merge branch 'v1.12.x' of https://github.com/grpc/grpc-node into 1.12.2-upmerge 2018-05-25 01:26:52 +02:00

README.md

npm

Node.js gRPC Library

PREREQUISITES

  • node: This requires node to be installed, version 4.0 or above. If you instead have the nodejs executable on Debian, you should install the nodejs-legacy package.

  • Note: If you installed node via a package manager and the version is still less than 4.0, try directly installing it from nodejs.org.

INSTALLATION

Install the gRPC NPM package

npm install grpc

BUILD FROM SOURCE

  1. Clone the grpc Git Repository.
  2. Run npm install --build-from-source from the repository root.
  • Note: On Windows, this might fail due to nodejs issue #4932 in which case, you will see something like the following in npm install's output (towards the very beginning):

     ..
     Building the projects in this solution one at a time. To enable parallel build, please add the "/m" switch.
     WINDOWS_BUILD_WARNING
      "..\IMPORTANT: Due to https:\github.com\nodejs\node\issues\4932, to build this library on Windows, you must first remove C:\Users\jenkins\.node-gyp\4.4.0\include\node\openssl"
      ...
      ..
    

    To fix this, you will have to delete the folder C:\Users\<username>\.node-gyp\<node_version>\include\node\openssl and retry npm install

API DOCUMENTATION

See the API Documentation.

TESTING

To run the test suite, simply run npm test in the install location.