batman-rails-flo 0.0.1

data/vendor/assets/javascripts/batman_rails_flo/node_modules/fb-flo/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "fb-flo",
+  "version": "0.2.1",
+  "description": "Modify running web apps without reloading",
+  "main": "index.js",
+  "scripts": {
+    "test": "mocha test/**/*_test.js --bail"
+  },
+  "author": "",
+  "license": "BSD-2-Clause",
+  "dependencies": {
+    "websocket": "~1.0.8",
+    "sane": "~0.5.1"
+  },
+  "devDependencies": {
+    "mocha": "~1.17.1"
+  },
+  "bin": {
+    "fb-flo": "./bin/flo"
+  },
+  "readme": "fb-flo\n---\n\nfb-flo is a Chrome extension that lets you modify running apps without reloading. It's easy to integrate with your build system, dev environment, and can be used with your favorite editor.\n\n## Usage\n\nfb-flo is made up of a server and client component. This will guide through configuring your server for your project and installing the Chrome extension.\n\n### 1. Configure fb-flo server\n\n```\n$ npm install fb-flo\n```\n\nfb-flo exports a single `fb-flo` function to start the server. Here is an example where you have your source JavaScript and CSS files in the root directory and your build step involves bundling both into a respective `bundle.js`, `bundle.css`.\n\n```js\nvar flo = require('fb-flo'),\n    path = require('path'),\n    fs = require('fs');\n\nvar server = flo(\n  sourceDirToWatch,\n  {\n    port: 8888,\n    host: 'localhost',\n    verbose: false,\n    glob: [\n       // All JS files in `sourceDirToWatch` and subdirectories\n      '**/*.js',\n       // All CSS files in `sourceDirToWatch` and subdirectories\n      '**/*.css'\n    ]\n  },\n  function resolver(filepath, callback) {\n    // 1. Call into your compiler / bundler.\n    // 2. Assuming that `bundle.js` is your output file, update `bundle.js`\n    //    and `bundle.css` when a JS or CSS file changes.\n    callback({\n      resourceURL: 'bundle.js' + path.extname(filepath),\n      // any string-ish value is acceptable. i.e. strings, Buffers etc.\n      contents: fs.readFileSync(filepath)\n    });\n  }\n);\n```\n\n`flo` takes the following arguments.\n\n* `sourceDirToWatch`: absolute or relative path to the directory to watch that contains the source code that will be built.\n* `options` hash of options:\n    * `port` port to start the server on (defaults to 8888).\n    * `host` to listen on.\n    * `verbose` `true` or `false` value indicating if flo should be noisy.\n    * `glob` a glob string or array of globs to match against the files to watch.\n    * `useFilePolling` some platforms that do not support native file watching, you can force the file watcher to work in polling mode.\n    * `pollingInterval` if in polling mode (useFilePolling) then you can set the interval at which to poll for file changes.\n* `resolver` a function to map between files and resources.\n\nThe resolver callback is called with two arguments:\n\n* `filepath` path to the file that changed relative to the watched directory.\n* `callback` called to update a resource file in the browser. Should be called with an object with the following properties:\n  * `resourceURL` used as the resource identifier in the browser.\n  * `contents` any string-ish value representing the source of the updated file. i.e. strings, Buffers etc.\n  * `reload` (optional) forces a full page reload. Use this if you're sure the changed code cannot be hotswapped.\n  * `match` (optional, defaults to: indexOf) identifies the matching function to be performed on the resource URL in the browser. Could be one of the following:\n    * `\"equal\"` test the updated resource `resourceURL` against existing browser resources using an equality check.\n    * `\"indexOf\"` use `String.prototype.indexOf` check\n    * `/regexp/` a regexp object to exec.\n\n### 2. Install the Chrome Extension\n\nGrab the [fb-flo Chrome extension](https://chrome.google.com/webstore/detail/ahkfhobdidabddlalamkkiafpipdfchp). This will add a new tab in your Chrome DevTools called 'flo'.\n\n### 3. Activate fb-flo\n\nTo activate fb-flo from the browser:\n\n* Open Chrome DevTools.\n* Click on the new 'fb-flo' pane.\n* Click on 'Activate for this site'\n\nSee screenshot:\n\n![](http://i.imgur.com/SamY32i.png)\n\n### Example\n\nSay you have a Makefile program that builds your JavaScript and CSS into `build/build.js` and `build/build.css` respectively, this how you'd configure your fb-flo server:\n\n```js\nvar flo = require('fb-flo');\nvar fs = require('fs');\nvar exec = require('child_process').exec;\n\nvar server = flo('./lib/', {\n  port: 8888,\n  dir: './lib/',\n  glob: ['./lib/**/*.js', './lib/**/*.css']\n}, resolver);\n\nserver.once('ready', function() {\n  console.log('Ready!');\n});\n\nfunction resolver(filepath, callback) {\n    exec('make', function (err) {\n      if (err) throw err;\n      if (filepath.match(/\\.js$/)) {\n        callback({\n          resourceURL: 'build/build.js',\n          contents: fs.readFileSync('build/build.js').toString()\n        })\n      } else {\n        callback({\n          resourceURL: 'build/build.css',\n          contents: fs.readFileSync('build/build.css').toString()\n        })\n      }\n    });\n}\n```\n",
+  "readmeFilename": "README.md",
+  "_id": "fb-flo@0.2.1",
+  "_from": "fb-flo@"
+}

data/vendor/assets/javascripts/batman_rails_flo/node_modules/fb-flo/test/client/browser_websocket.js

@@ -0,0 +1,63 @@
+/**
+ *  Copyright (c) 2014, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+var WebSocketClient = require('websocket').client;
+
+function WebSocket(url) {
+  this.readyState = 0;
+  var client = new WebSocketClient();
+  this.onconnect = this.onconnect.bind(this);
+  client.once('connect', this.onconnect);
+  client.once('connectFailed', this.emit.bind(this, 'close'));
+  client.connect(url);
+}
+
+WebSocket.prototype.onconnect = function(connection) {
+  this.readyState = 1;
+  this.socket = connection;
+  this.socket.on('error', this.emit.bind(this, 'close'));
+  this.socket.on('close', function() {
+    this.readyState = 3;
+    this.emit('close', {});
+  }.bind(this));
+  this.socket.on('message', function(msg) {
+    var data = msg.utf8Data;
+    this.emit('message', {data: data});
+  }.bind(this));
+  this.emit('open');
+};
+
+WebSocket.prototype.send = function(arg) {
+  this.socket.sendUTF(arg);
+};
+
+WebSocket.prototype.close = function() {
+  this.readyState = 2;
+  this.socket.close();
+};
+
+WebSocket.prototype.emit = function(event) {
+  var handler = this['on' + event];
+  if (typeof handler === 'function') {
+    handler.apply(this, [].slice.call(arguments, 1));
+  }
+};
+
+var states = {
+  CONNECTING: 0,
+  OPEN: 1,
+  CLOSING: 2,
+  CLOSED: 3
+};
+
+Object.keys(states).forEach(function(state) {
+  WebSocket.prototype[state] = states[state];
+});
+
+module.exports = WebSocket;

data/vendor/assets/javascripts/batman_rails_flo/node_modules/fb-flo/test/client/connection_test.js

@@ -0,0 +1,57 @@
+/**
+ *  Copyright (c) 2014, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+var assert = require('assert');
+var Connection = require('../../client/connection');
+var Server = require('../../lib/server');
+var WebSocket = require('./browser_websocket');
+var mockLogger = require('./logger_mock');
+global.WebSocket = WebSocket;
+
+describe('Connection', function() {
+  var port = 8543;
+  var server;
+  afterEach(function() {
+    server.close();
+    con.disconnect();
+  });
+
+  it('should connect to server', function(done) {
+    server = new Server({
+      port: port
+    });
+    con = new Connection('localhost', port, mockLogger)
+      .onopen(function() {
+        server.broadcast({hi: 1});
+      })
+      .onmessage(function(msg) {
+        assert.deepEqual(msg, {
+          hi: 1
+        });
+        done();
+      })
+      .onerror(done)
+      .connect();
+  });
+
+  it('should retry to connect', function(done) {
+    con = new Connection('localhost', port, mockLogger)
+      .onopen(function() {
+        done();
+      })
+      .onretry(function(){
+        server = new Server({
+          port: port
+        });
+      })
+      .onerror(done)
+      .connect();
+  });
+
+});

data/vendor/assets/javascripts/batman_rails_flo/node_modules/fb-flo/test/client/logger_mock.js

@@ -0,0 +1,15 @@
+/**
+ *  Copyright (c) 2014, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+module.exports = function loggerMock() {
+  return {
+    error: function(){},
+    log: function() {}
+  }
+}

data/vendor/assets/javascripts/batman_rails_flo/node_modules/fb-flo/test/client/session_test.js

@@ -0,0 +1,194 @@
+/**
+ *  Copyright (c) 2014, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+var assert = require('assert');
+var Server = require('../../lib/server');
+var Session = require('../../client/session');
+var WebSocket = require('./browser_websocket')
+var Connection = require('../../client/connection');
+var mockLogger = require('./logger_mock');
+
+global.Connection = Connection;
+global.WebSocket = WebSocket;
+
+var nop = function() {};
+
+describe('Session', function() {
+
+  beforeEach(function() {
+    this.server = new Server({ port: port });
+    global.chrome = {
+      devtools: {
+        inspectedWindow: {
+          getResources: function(callback) {
+            callback();
+          },
+          onResourceAdded: {
+            addListener: nop,
+            removeListener: nop
+          }
+        },
+        network: {
+          onNavigated: {
+            addListener: nop,
+            removeListener: nop
+          }
+        }
+      },
+    };
+  });
+  afterEach(function() {
+    this.server.close();
+    this.session.destroy();
+  });
+
+  var port = 8543;
+  it('should start', function(done) {
+    var i = 0;
+    function status(state) {
+      if (++i == 1) {
+        assert.equal(state, 'connecting');
+      } else if (i == 2) {
+        assert.equal(state, 'connected');
+      } else {
+        assert.equal(state, 'started');
+        done();
+      }
+    }
+    this.session = new Session('localhost', port, status, mockLogger);
+    this.session.start();
+  });
+
+  it('should clean properly', function() {
+    var status = function(state) {
+      if (state !== 'started') return;
+      var called = 0;
+      chrome.devtools.inspectedWindow.onResourceAdded.removeListener =
+      chrome.devtools.network.onNavigated.removeListener =
+        function() { called++; };
+
+      this.session.destroy(function() {
+        assert(!this.server.connections.length);
+        assert.equal(called, 2);
+      }.bind(this));
+    }.bind(this);
+
+    this.session = new Session('localhost', port, status, mockLogger);
+    this.session.start();
+  });
+
+  describe('resource manipulation', function() {
+    beforeEach(function() {
+      chrome.devtools.inspectedWindow.getResources = function(callback) {
+        callback([{
+          url: 'http://wat',
+          setContent: function() {
+            this.setContent.apply(this, arguments)
+          }.bind(this)
+        }]);
+      }.bind(this);
+      this.session = new Session('localhost', port, function(state) {
+        if (state === 'started') this.started();
+      }.bind(this), mockLogger);
+      this.session.start();
+    });
+
+    it('should change resources using equal matcher', function(done) {
+      this.started = function() {
+        this.server.broadcast({
+          resourceURL: 'http://wat',
+          match: 'equal',
+          contents: 'foo'
+        });
+      }.bind(this);
+      this.setContent = function(contents, callback) {
+        assert.equal(contents, 'foo');
+        done();
+      };
+    });
+
+    it('should change resource using regexp matcher', function(done) {
+      this.started = function() {
+        this.server.broadcast({
+          resourceURL: 'http://wat',
+          match: {
+            type: 'regexp',
+            source: 'waT',
+            ignoreCase: true
+          },
+          contents: 'foo'
+        });
+      }.bind(this);
+
+      this.setContent = function(contents, callback) {
+        assert.equal(contents, 'foo');
+        done();
+      };
+    });
+
+    it('should change resource using regexp matcher', function(done) {
+      this.started = function() {
+        this.server.broadcast({
+          resourceURL: 'http://wat',
+          match: {
+            type: 'regexp',
+            source: 'waT',
+            ignoreCase: true
+          },
+          contents: 'foo'
+        });
+      }.bind(this);
+
+      this.setContent = function(contents, callback) {
+        assert.equal(contents, 'foo');
+        done();
+      };
+    });
+
+    it('should change resource using indexOf matcher', function(done) {
+      this.started = function() {
+        this.server.broadcast({
+          resourceURL: 'http://w',
+          match: 'indexOf',
+          contents: 'foo'
+        });
+      }.bind(this);
+
+      this.setContent = function(contents, callback) {
+        assert.equal(contents, 'foo');
+        done();
+      };
+    });
+
+    it('should trigger an event when matched', function(done) {
+      chrome.devtools.inspectedWindow.eval = function(expr) {
+        assert(expr.match(/var event = new Event\('fb-flo-reload'\);/),
+          "event creation");
+        assert(expr.match(/event.data = \{"url":"http:\/\/w","contents":"foo"}/),
+          "event data");
+        assert(expr.match(/window.dispatchEvent\(event\);/),
+          "event dispatch");
+        done();
+      };
+
+      this.setContent = function(contents, bool, callback) {
+        callback({ code: 'OK' });
+      };
+
+      this.started = function() {
+        this.server.broadcast({
+          resourceURL: 'http://w',
+          match: 'indexOf',
+          contents: 'foo'
+        });
+      }.bind(this);
+    });
+  });
+
+});

data/vendor/assets/javascripts/batman_rails_flo/node_modules/fb-flo/test/server/flo_test.js

@@ -0,0 +1,211 @@
+/**
+ *  Copyright (c) 2014, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ */
+
+var os = require('os');
+var fs = require('fs');
+var flo = require('../../');
+var assert = require('assert');
+var WebSocketClient = require('websocket').client;
+var path = require('path');
+
+var tmpDir = os.tmpDir();
+var testDir = path.join(tmpDir, 'flo_test');
+
+function client(connectFailed, connect, message) {
+  var client = new WebSocketClient();
+  client.connect('ws://localhost:8888/');
+  client.on('connectFailed', connectFailed);
+  client.on('connect', function (connection) {
+    if (connect) connect(connection);
+    connection.on('message', function (msg) {
+      var data = msg.utf8Data;
+      data = JSON.parse(data);
+      if (message) message(data);
+    });
+  });
+  return client;
+}
+
+describe('flo(dir)', function() {
+  var f;
+
+  beforeEach(function(done) {
+    fs.mkdir(testDir, function (err) {
+      fs.writeFileSync(path.join(testDir,'foo.js'), 'alert("wow")');
+      setTimeout(done, 300);
+    });
+  });
+
+  afterEach(function() {
+    f.close();
+  });
+
+  it('should start a server', function(done) {
+    f = flo(testDir);
+    f.on('added', console.log)
+    f.on('ready', function () {
+      var c = client(
+        done.bind(null, new Error('Failed to connect')),
+        done.bind(null, null)
+      );
+    });
+  });
+
+  it('should send resource to the client when changed', function(done) {
+    f = flo(testDir);
+    f.on('ready', function () {
+      var c = client(
+        done.bind(null, new Error('Failed to connect')),
+        null,
+        function (msg) {
+          assert.deepEqual(msg, {
+            contents: 'alert("hi")',
+            resourceURL: 'foo.js',
+            match: 'indexOf'
+          });
+          done();
+        }
+      );
+      fs.writeFileSync(path.join(testDir,'foo.js'), 'alert("hi")');
+    });
+  });
+
+  it('should work with css', function(done) {
+    fs.writeFileSync(path.join(testDir,'bar.css'), 'bar {color: red}');
+    f = flo(testDir);
+    f.on('ready', function () {
+      var c = client(
+        done.bind(null, new Error('Failed to connect')),
+        null,
+        function(msg) {
+          assert.deepEqual(msg, {
+            contents: 'bar {color: blue}',
+            resourceURL: 'bar.css',
+            match: 'indexOf'
+          });
+          done();
+        }
+      );
+      fs.writeFileSync(path.join(testDir,'bar.css'), 'bar {color: blue}');
+    });
+  });
+
+  it('should send resource to multiple clients when changed', function(done) {
+    f = flo(testDir);
+    f.on('ready', function () {
+      var i = 0;
+      function handler(connection) {
+        connection.on('message', function(msg) {
+          var data = msg.utf8Data;
+          var msg = JSON.parse(data);
+          assert.deepEqual(msg, {
+            contents: 'alert("hi")',
+            resourceURL: 'foo.js',
+            match: 'indexOf'
+          });
+          if (++i == 2) {
+            done();
+          } else {
+            // make sure we handle disconnects.
+            connection.close();
+          }
+        });
+      }
+
+      var c1 = client(
+        done.bind(null, new Error('Failed to connect')),
+        handler
+      );
+      var c2 = client(
+        done.bind(null, new Error('Failed to connect')),
+        handler
+      );
+
+      fs.writeFileSync(path.join(testDir,'foo.js'), 'alert("hi")');
+    });
+  });
+});
+
+ describe('flo(dir, resolver)', function() {
+  var f;
+
+  beforeEach(function(done) {
+      fs.mkdir(testDir, function (err) {
+          fs.writeFileSync(path.join(testDir,'foo.js'), 'alert("wow")');
+          setTimeout(done, 300);
+      });
+  });
+
+  afterEach(function() {
+    f.close();
+  });
+
+  it('should work with a custom resolver', function(done) {
+    f = flo(testDir, function (filepath, callback) {
+      assert.equal(filepath, 'foo.js');
+      callback({
+        contents: 'foobar',
+        resourceURL: path.sep === '\\' ? 'custom\\url' : 'custom/url'
+      });
+    });
+
+    f.on('ready', function() {
+      var c = client(
+        done.bind(null, new Error('Failed to connect')),
+        null,
+        function(msg) {
+          assert.deepEqual(msg, {
+            contents: 'foobar',
+            resourceURL: 'custom/url',
+            match: 'indexOf'
+          });
+          done();
+        }
+      );
+
+      fs.writeFileSync(path.join(testDir,'foo.js'), 'hmmmm');
+    });
+  });
+
+  describe('resolver match property', function() {
+    it('should serialize regexp objects', function(done) {
+      f = flo(testDir, function (filepath, callback) {
+        assert.equal(filepath, 'foo.js');
+        callback({
+          contents: 'foobar',
+          resourceURL: 'customurl',
+          match: /a(b)+/gi
+        });
+      });
+
+      f.on('ready', function() {
+        var c = client(
+          done.bind(null, new Error('Failed to connect')),
+          null,
+          function(msg) {
+            assert.deepEqual(msg, {
+              contents: 'foobar',
+              resourceURL: 'customurl',
+              match: {
+                type: 'regexp',
+                global: true,
+                ignoreCase: true,
+                multiline: false,
+                source: 'a(b)+'
+              }
+            });
+            done();
+          }
+        );
+
+        fs.writeFileSync(path.join(testDir,'foo.js'), 'hmmmm');
+      });
+    });
+  });
+});