Adds node_library and examples.

- Node_library dynamically packages and installs your js files as a
  local npm repository.
- Adds 0.3.2rc2 to build matrix.

Author: pcj

.travis.yml

@@ -4,6 +4,7 @@ language: node_js
 
 env:
   - V=HEAD URL=http://ci.bazel.io/job/Bazel/JAVA_VERSION=1.8,PLATFORM_NAME=linux-x86_64/lastSuccessfulBuild/artifact/output/ci/bazel--installer.sh FLAGS='--worker_verbose --strategy=Javac=worker --strategy=JsChecker=worker'
+  - V=0.3.2rc2 URL=https://storage.googleapis.com/bazel/0.3.2/rc2/bazel-0.3.2rc2-installer-linux-x86_64.sh FLAGS=''
   - V=0.3.1 URL=https://github.com/bazelbuild/bazel/releases/download/0.3.1/bazel-0.3.1-installer-linux-x86_64.sh FLAGS=''
 
 before_install:

README.md

@@ -1,10 +1,18 @@
-# `rules_node` [![Build Status](https://travis-ci.org/pubref/rules_node.svg?branch=master)](https://travis-ci.org/pubref/rules_node)
+<table><tr>
+<td><img src="https://github.com/pubref/rules_protobuf/blob/master/images/bazel.png" width="120"/></td>
+<td><img src="https://node-os.com/images/nodejs.png" width="120"/></td>
+<td><img src="https://www.npmjs.com/static/images/npm-logo.svg" width="120"/></td>
+</tr><tr>
+<td>Bazel</td>
+<td>NodeJs</td>
+<td>npm</td>
+</tr></table>
 
-# Installation
+# `rules_node` [![Build Status](https://travis-ci.org/pubref/rules_node.svg?branch=master)](https://travis-ci.org/pubref/rules_node)
 
 Put `rules_node` in your `WORKSPACE` and load the main repository
 dependencies.  This will download the nodejs toolchain including
-`node` and `npm`.
+`node` (6.6.x) and `npm`.
 
 ```python
 git_repository(
@@ -23,7 +31,8 @@ node_repositories()
 | Rule | Description |
 | ---: | :---------- |
 | [node_repositories](#node_repositories) | Install node toolchain. |
-| [npm_library](#npm_library) | Declare an npm dependency. |
+| [npm_library](#npm_library) | Declare an external npm dependency. |
+| [node_library](#node_library) | Define a local npm module. |
 | [node_binary](#node_binary) | Build or execute a nodejs script. |
 
 # Example
@@ -56,9 +65,8 @@ WORKSPACE rule.  No current options.
 
 ## npm_library
 
-BUILD rule.  Declares a set of npm dependencies.  Functionally
-equivalent to `npm install --global` (global being relative to the npm
-toolchain installed in your WORKSPACE.
+Declares a set of npm dependencies.  Functionally equivalent to `npm
+install ...`.
 
 Takes two forms:
 
@@ -67,14 +75,70 @@ Takes two forms:
 1. **Multiple import**: uses a string_dict declaring the
    `name@version` dependency. (see `react-stack` above).
 
+## node_library
+
+This rule accepts a list of `srcs` (`*.js`) and other configuration
+attributes. When depended upon, it generates a `package.json` file
+describing the module and the `npm install`'s it in a local
+`node_modules` folder.  The name of the module is the package label,
+substituting `/` (slash) with `-` (dash). For example:
+
+```python
+load("//node:rules.bzl", "node_library")
+
+node_library(
+    name = "baz",
+    main_script = "index.js",
+    srcs = [
+        "qux.js"
+    ],
+    npm_deps = ["glob"],
+    use_prefix = False,
+)
+```
+
+Is installed as:
+
+```sh
+INFO: From NpmInstallLocal examples/baz/lib/node_modules/examples-baz/package.json:
+/private/var/tmp/_bazel_user/178d7438552046b1be3cba61fe7b75a8/execroot/rules_node/bazel-out/local-fastbuild/bin/examples/baz/lib
+`-- [email protected]
+  `-- [email protected]
+    +-- [email protected]
+    +-- [email protected]
+    | `-- [email protected]
+    +-- [email protected]
+    +-- [email protected]
+    | `-- [email protected]
+    |   +-- [email protected]
+    |   `-- [email protected]
+    +-- [email protected]
+    `-- [email protected]
+```
+
+And can be `require()`'d in another module as follows:
+
+```js
+var baz = require("examples-baz");
+console.log('Hello, ' + baz());
+```
+
+This packaging/install cycle occurs on demand and is a nicer way to
+develop nodejs applications with clear dependency requirements.  Bazel
+makes this very clean and convenient.
+
 ## node_binary
 
-BUILD rule.  Create an executable script that will run the file named
-in the `main_script` attribute.
+Creates an executable script that will run the file named in the
+`main_script` attribute.  Paths to dependent `node_library` and
+`npm_library` rules (each one having a `node_modules` subdirectory)
+are used to construct a `NODE_PATH` environment variable that the
+`node` executable will use to fulfill `require` dependencies.
 
+---
 
-> **WARNING**: these rules are not hermetic or secure!  It trusts that
-> the `npm install` command does what is it supposed to do.  There is
-> no current support for valdating that a particular npm package(s)
-> matches a sha256 (this is the the norm for npm, but it is
-> sub-standard for bazel).
+> **WARNING**: these rules are not hermetic (or by that measure,
+> secure)!  It trusts that the `npm install` command does what is it
+> supposed to do, and there is no current support for validating that
+> a particular npm package(s) matches a sha256 (this is the the norm
+> for npm, but it's sub-standard for bazel).

WORKSPACE

@@ -1,4 +1,4 @@
 workspace(name = "org_pubref_rules_node")
 
-load("//node:rules.bzl", "node_repositories", "npm_repository")
+load("//node:rules.bzl", "node_repositories")
 node_repositories()

examples/bar/BUILD

@@ -0,0 +1,11 @@
+load("//node:rules.bzl", "node_binary", "npm_library", "node_library")
+
+npm_library(
+    name = "glob",
+)
+
+node_binary(
+    name = "bar",
+    main_script = "bar.js",
+    npm_deps = ["glob"],
+)

examples/bar.js examples/bar/bar.jsexamples/bar.js renamed to examples/bar/bar.js

@@ -0,0 +1,15 @@
+package(default_visibility = ["//visibility:public"])
+
+load("//node:rules.bzl", "node_binary", "npm_library", "node_library")
+
+npm_library(name = "glob")
+
+node_library(
+    name = "baz",
+    main_script = "index.js",
+    srcs = [
+        "qux.js"
+    ],
+    npm_deps = ["glob"],
+    use_prefix = False,
+)

examples/baz/BUILD

@@ -0,0 +1,5 @@
+var qux = require("./qux.js");
+
+module.exports = function() {
+  return "Baz! (and " + qux() + ")";
+};

examples/baz/index.js

@@ -0,0 +1,5 @@
+var glob = require("glob");
+
+module.exports = function() {
+  return "Qux!!";
+};

examples/baz/qux.js

@@ -1,4 +1,9 @@
-load("//node:rules.bzl", "node_binary", "npm_library")
+load("//node:rules.bzl", "node_binary", "npm_library", "npm_registry")
+
+npm_registry(
+    name = "private",
+    url = "http://localhost:3000",
+)
 
 npm_library(
     name = "glob",
@@ -16,4 +21,7 @@ node_binary(
     name = "foo",
     main_script = "foo.js",
     npm_deps = ["glob", "react-stack"],
+    deps = [
+        "//examples/baz",
+    ]
 )