Publish Vulpes Preview 15 sources for desktop, Android and Tundra

Share Gaia assets and adapters, keep private profiles and development documents local, and update both public READMEs.

gaia/tools/html_transformer/html_transformer.js

@@ -0,0 +1,110 @@
+/**
+ * @fileoverview A collection of utilities for performing static analysis on
+ *     and transforming apps' html files.
+ */
+var Promise = require('es6-promise').Promise;
+var jsdom = require('jsdom');
+
+function load(filename) {
+  return new Promise(function(resolve, reject) {
+    jsdom.env(filename, function(errors, window) {
+      if (errors && errors.length) {
+        return reject(errors[0]);
+      }
+
+      return resolve(new HTMLTransformer(window));
+    });
+  });
+};
+
+function HTMLTransformer(window) {
+  this.window = window;
+}
+
+HTMLTransformer.prototype = {
+  getSharedDependencies: function() {
+    var doc = this.window.document;
+    var links = getSharedElements(doc, 'link');
+    var scripts = getSharedElements(doc, 'script');
+    var commented = flatmap(getComments(doc), getSharedElementsFromComment);
+    return links.concat(scripts).concat(commented);
+  }
+};
+
+function getSharedElements(doc, selector) {
+  return querySelectorAll(doc, selector).map(getShared).filter(function(x) {
+    return !!x;
+  });
+}
+
+function getSharedElementsFromComment(comment) {
+  var sharedLink = /<link\s.*href="(app:\/\/.+\.gaiamobile\.org)?\/?(shared\/.+)".*>/;
+  var sharedScript = /<script\s.*src="(app:\/\/.+\.gaiamobile\.org)?\/?(shared\/.+)".*>/;
+
+  return flatmap(comment.split(/\n/), function(commentLine) {
+    var links = commentLine.match(sharedLink) || [];
+    var scripts = commentLine.match(sharedScript) || [];
+    var results = links.concat(scripts);
+    return results.filter(function(result) {
+      return result && result.indexOf('shared') === 0;
+    });
+  });
+};
+
+// Neither document.createTreeWalker nor document.createNodeIterator
+// are supported by jsdom so we're going to do this the old fashioned way...
+function getComments(doc) {
+  var results = [];
+  var queue = [doc.body];
+  while (queue.length) {
+    var next = queue.shift();
+    if (next.nodeType === 8 /* COMMENT_NODE */) {
+      results.push(next.textContent);
+    }
+
+    var children = next.childNodes;
+    if (children && children.length) {
+      for (var i = 0; i < children.length; i++) {
+        queue.push(children[i]);
+      }
+    }
+  }
+
+  return results;
+}
+
+function querySelectorAll(doc, selector) {
+  return Array.prototype.slice.call(doc.querySelectorAll(selector));
+}
+
+function getShared(node) {
+  var sharedUrl = /^(app:\/\/.+\.gaiamobile\.org)?\/?(shared\/.+)/;
+  var match;
+  switch (node.nodeName) {
+    case 'LINK':
+      match = node.href.match(sharedUrl);
+      break;
+    case 'SCRIPT':
+      match = node.src.match(sharedUrl);
+      break;
+    default:
+      return false;
+  }
+
+  return (match && match.length) ? match.filter(function(str) {
+    return str && str.indexOf('shared') === 0;
+  })[0] : false;
+}
+
+function flatmap(array, fn) {
+  var result = [];
+  array.map(fn).forEach(function(subresult) {
+    if (Array.isArray(subresult)) {
+      result = result.concat(subresult);
+    }
+  });
+
+  return result;
+}
+
+module.exports = { HTMLTransformer: HTMLTransformer, load: load };

gaia/tools/html_transformer/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "html-transformer",
+  "version": "0.0.1",
+  "description": "Figures out app shared deps, localizes your strings, other mischief",
+  "main": "html_transformer.js",
+
+  "dependencies": {
+    "es6-promise": "^2.3.0",
+    "jsdom": "^3"
+  },
+
+  "devDependencies": {
+    "chai": "^3.0.0",
+    "mocha": "^2.2.5"
+  },
+
+  "scripts": {
+    "test": "./node_modules/.bin/mocha"
+  }
+}

gaia/tools/html_transformer/test/fixtures/basic.html

@@ -0,0 +1,18 @@
+<html>
+<head>
+  <title>Basic html page</title>
+</head>
+<body>
+  <!-- hello -->
+  <p>A really great thing to say</p>
+  <link rel="stylesheet" type="text/css" href="/shared/style/icons.css">
+  <link rel="stylesheet" type="text/css" href="app://theme.gaiamobile.org/shared/elements/gaia-theme/style.css">
+  <script defer src="shared/js/component_utils.js"></script>
+  <script defer src="shared/elements/gaia_subheader/script.js"></script>
+  <!--
+  <link rel="stylesheet" type="text/css" href="shared/style/tabs.css">
+  <link rel="stylesheet" type="text/css" href="app://theme.gaiamobile.org/shared/elements/gaia-theme/other.css">
+  <script defer src="/shared/js/gesture_detector.js"></script>
+  -->
+</body>
+</html>

gaia/tools/html_transformer/test/html_transformer_test.js

@@ -0,0 +1,38 @@
+var expect = require('chai').expect;
+var htmlTransformer = require('../html_transformer');
+
+suite('htmlTransformer', function() {
+  var subject;
+
+  setup(function() {
+    return htmlTransformer.load(__dirname + '/fixtures/basic.html')
+    .then(function(result) {
+      subject = result;
+    });
+  });
+
+  test('should be an HTMLTransformer', function() {
+    expect(subject).to.be.an.instanceOf(htmlTransformer.HTMLTransformer);
+  });
+
+  test('should load html', function() {
+    var doc = subject.window.document;
+    var p = doc.querySelector('p');
+    expect(p.textContent).to.equal('A really great thing to say');
+  });
+
+  test('#getSharedDependencies', function() {
+    expect(subject.getSharedDependencies())
+      .to
+      .deep
+      .equal([
+        'shared/style/icons.css',
+        'shared/elements/gaia-theme/style.css',
+        'shared/js/component_utils.js',
+        'shared/elements/gaia_subheader/script.js',
+        'shared/style/tabs.css',
+        'shared/elements/gaia-theme/other.css',
+        'shared/js/gesture_detector.js'
+      ]);
+  });
+});

gaia/tools/html_transformer/test/mocha.opts

@@ -0,0 +1 @@
+--ui tdd