[#594] Use Gulp to Run a BrowserSync Proxy Server

Refs #594: Add a Task Runner

Author: prikhi

README.rst

@@ -40,6 +40,27 @@ Create the database and start the dev server::
     ./manage.py runserver 0.0.0.0:8000
 
 
+BrowserSync
+------------
+
+BrowserSync lets you sync up actions betweens browsers & automatically reloads
+your browsers when a source file has been modified.
+
+You'll need ``npm`` & ``gulp`` installed::
+
+    pacman -S npm
+    npm install -g gulp
+
+Then install our Gulp dependencies & run ``gulp`` in the project's base
+directory::
+
+    npm install
+    gulp
+
+Gulp will start the Django server for you along with a proxy server that
+injects the BrowserSync code at http://localhost:8010.
+
+
 Documentation
 --------------
 

gulpfile.js

@@ -0,0 +1,36 @@
+var browserSync = require('browser-sync').create();
+var exec = require('child_process').exec;
+var gulp = require('gulp');
+
+
+var virtualEnvActivate = '~/.virtualenvs/fec/bin/activate';
+
+var watchPaths = [
+  'fec/**/*.css',
+  'fec/**/*.html',
+  'fec/**/*.js',
+  'fec/**/*.less',
+  'fec/**/*.py',
+];
+
+
+gulp.task('default', ['django-server', 'proxy-server']);
+
+gulp.task('django-server', function(cb) {
+  var proc = exec(
+    'source ' + virtualEnvActivate + '; ' +
+    'cd fec; PYTHONUNBUFFERED=1 python manage.py runserver 0.0.0.0:8000'
+  );
+  proc.stdout.on('data', function(data) { process.stdout.write(data); });
+  proc.stderr.on('data', function(data) { process.stdout.write(data); });
+  return cb();
+});
+
+gulp.task('proxy-server', function() {
+  return browserSync.init(watchPaths, {
+    proxy: '0.0.0.0:8000',
+    port: 8010,
+    open: false,
+  });
+});
+

package.json

@@ -0,0 +1,30 @@
+{
+  "name": "fec-website",
+  "version": "0.4.0",
+  "description": "The mezzanine project that powers thefec.org",
+  "main": "gulpfile.js",
+  "directories": {
+    "doc": "docs"
+  },
+  "devDependencies": {
+    "browser-sync": "^2.7.6",
+    "gulp": "^3.9.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/FederationOfEgalitarianCommunities/FECWebsite.git"
+  },
+  "author": "Pavan Rikhi <[email protected]> (http://sleepanarchy.com)",
+  "license": "GPL-3.0",
+  "bugs": "http://bugs.sleepanarchy.com/projects/fec/issues",
+  "keywords": [
+    "federation",
+    "egalitarian",
+    "communities",
+    "mezzanine",
+    "python",
+    "django",
+    "website",
+    "fec"
+  ]
+}

requirements/local.txt

@@ -8,3 +8,4 @@ pylint-django>=0.5
 
 Sphinx>=1.2
 sphinx-bootstrap-theme>=0.4
+django-livereload>=1.2