GUI -- Initial unit tests for Key Handler service. Still more to be done here.

Change-Id: I36e1504c571daebbcd2a147c1dffb37ef6c6beb6
diff --git a/web/gui/src/main/webapp/app/fw/lib/keys.js b/web/gui/src/main/webapp/app/fw/lib/keys.js
index 3c0a26a..c5f0a19 100644
--- a/web/gui/src/main/webapp/app/fw/lib/keys.js
+++ b/web/gui/src/main/webapp/app/fw/lib/keys.js
@@ -147,11 +147,14 @@
     onos.factory('KeyService', ['FnService', function (fs) {
         f = fs;
         return {
-            init: function () {
-                console.log('initializing keydown handler....');
-                d3.select('body').on('keydown', keyIn);
+            installOn: function (elem) {
+                elem.on('keydown', keyIn);
                 setupGlobalKeys();
-            }
+            },
+            theme: function () {
+                return theme;
+            },
+            whatKey: whatKey
         };
     }]);
 
diff --git a/web/gui/src/main/webapp/app/onos.js b/web/gui/src/main/webapp/app/onos.js
index 631464b..db104dd 100644
--- a/web/gui/src/main/webapp/app/onos.js
+++ b/web/gui/src/main/webapp/app/onos.js
@@ -29,7 +29,7 @@
     ONOS = angular.module('onosApp', ['onosMast'])
         .controller('OnosCtrl', ['KeyService', function (ks) {
             console.log('OnosCtrl has been created');
-            ks.init();
+            ks.installOn(d3.select('body'));
         }]);
 
 }());
diff --git a/web/gui/src/main/webapp/tests/README.txt b/web/gui/src/main/webapp/tests/README.txt
index 6cd2255..54830ab 100644
--- a/web/gui/src/main/webapp/tests/README.txt
+++ b/web/gui/src/main/webapp/tests/README.txt
@@ -1 +1,7 @@
 # Unit and integration tests for code under the /app directory
+
+To run these tests, karma, node.js etc needs to be installed in the
+build environment.
+
+[Details to follow]
+
diff --git a/web/gui/src/main/webapp/tests/fw/lib/fnSpec.js b/web/gui/src/main/webapp/tests/fw/lib/fn-spec.js
similarity index 100%
rename from web/gui/src/main/webapp/tests/fw/lib/fnSpec.js
rename to web/gui/src/main/webapp/tests/fw/lib/fn-spec.js
diff --git a/web/gui/src/main/webapp/tests/fw/lib/keys-spec.js b/web/gui/src/main/webapp/tests/fw/lib/keys-spec.js
new file mode 100644
index 0000000..7d53c23
--- /dev/null
+++ b/web/gui/src/main/webapp/tests/fw/lib/keys-spec.js
@@ -0,0 +1,118 @@
+/*
+ * Copyright 2014 Open Networking Laboratory
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ ONOS GUI -- Key Handler Service - Unit Tests
+
+ @author Simon Hunt
+ */
+describe('factory: fw/lib/keys.js', function() {
+    var ks,
+        fs,
+        d3Elem;
+
+    beforeEach(module('onosApp'));
+
+    beforeEach(inject(function (KeyService, FnService) {
+        ks = KeyService;
+        fs = FnService;
+        d3Elem = d3.select('body').append('p').attr('id', 'ptest');
+        ks.installOn(d3Elem);
+    }));
+
+    afterEach(function () {
+        d3.select('#ptest').remove();
+    });
+
+    it('should have injected stuff defined', function () {
+        expect(ONOS).toBeDefined();
+        expect(ks).toBeDefined();
+        expect(fs).toBeDefined();
+    });
+
+    // NOTE: kinda messy, but it seems to get the job done.
+    function jsKeyDown(element, code) {
+        var ev = document.createEvent('KeyboardEvent');
+
+        // Chromium Hack
+        if (navigator.userAgent.toLowerCase().indexOf('chrome') > -1) {
+            Object.defineProperty(ev, 'keyCode', {
+                get: function () { return this.keyCodeVal; }
+            });
+            Object.defineProperty(ev, 'which', {
+                get: function () { return this.keyCodeVal; }
+            });
+        }
+
+        if (ev.initKeyboardEvent) {
+            ev.initKeyboardEvent('keydown', true, true, document.defaultView,
+                                false, false, false, false, code, code);
+        } else {
+            ev.initKeyEvent('keydown', true, true, document.defaultView,
+                            false, false, false, false, code, 0);
+        }
+
+        ev.keyCodeVal = code;
+
+        if (ev.keyCode !== code) {
+            console.warn("keyCode mismatch " + ev.keyCode +
+                        "(" + ev.which + ") -> "+ code);
+        }
+        element.dispatchEvent(ev);
+    }
+
+    it('should start in light theme', function () {
+        expect(ks.theme()).toEqual('light');
+    });
+    it('should toggle to dark theme', function () {
+        jsKeyDown(d3Elem.node(), 84); // 'T'
+        expect(ks.theme()).toEqual('dark');
+    });
+
+    // key code lookups
+    // NOTE: should be injecting keydown events, rather than exposing whatKey()
+    it('whatKey: 13', function () {
+        expect(ks.whatKey(13)).toEqual('enter');
+    });
+    it('whatKey: 16', function () {
+        expect(ks.whatKey(16)).toEqual('shift');
+    });
+    it('whatKey: 40', function () {
+        expect(ks.whatKey(40)).toEqual('downArrow');
+    });
+    it('whatKey: 65', function () {
+        expect(ks.whatKey(65)).toEqual('A');
+    });
+    it('whatKey: 84', function () {
+        expect(ks.whatKey(84)).toEqual('T');
+    });
+    it('whatKey: 49', function () {
+        expect(ks.whatKey(49)).toEqual('1');
+    });
+    it('whatKey: 55', function () {
+        expect(ks.whatKey(55)).toEqual('7');
+    });
+    it('whatKey: 112', function () {
+        expect(ks.whatKey(112)).toEqual('F1');
+    });
+    it('whatKey: 123', function () {
+        expect(ks.whatKey(123)).toEqual('F12');
+    });
+    it('whatKey: 1', function () {
+        expect(ks.whatKey(1)).toEqual('.');
+    });
+
+});