integrated test runner

README.md

@@ -16,7 +16,7 @@
 ## Requirements
 
 * Chrome
-* NodeJS v5
+* NodeJS v6
 
 ## Usage
 

alm.json

@@ -0,0 +1,7 @@
+{
+  "tests": {
+    "include": [
+      "./src/tests/**/*"
+    ]
+  }
+}

docs/SUMMARY.md

@@ -23,6 +23,7 @@
   * [HTML to TSX](/features/html-to-tsx.md)
   * [JSON to TypeScript](/features/json-to-dts.md)
   * [JavaScript Support](/features/javascript.md)
+  * [Testing](/features/testing.md)
   * [Documentation Writing](/features/docblockr.md)
 * [Configuration](/config/README.md)
   * [Editor Config](/config/editorconfig.md)

docs/contributing/README.md

@@ -10,29 +10,30 @@ You need:
 ```
 git clone https://github.com/alm-tools/alm.git
 cd alm
+npm install
 ```
 
-We highly recommend you use [`nodemon`](https://github.com/remy/nodemon), just run it from the project root:
+Now just run. It will start `alm` using nodemon:
 
 ```
-npm install nodemon -g
-nodemon
+npm start
 ```
 
-Alternatively if you want to test `alm` on another folder e.g. `your project` (i.e not our folder with our test files) you can make the dev version of `alm` avialable globally with:
+Also you can use this *build* version of `alm` on another folder e.g. `your project` (i.e not our folder with our test files) simply by running:
 
 ```
-npm install
 npm link
 ```
 
 # Workflow
 
-Once you have `nodemon` running, if you edit any front-end ts file our Webpack setup will reload the front end only. Make a change to some backend file and the app restarts :rose:
+Once you have `npm start` running, if you edit any front-end ts file our Webpack setup will reload the front end only. Make a change to some backend file and our running nodemon will make the whole app restart 🌹
 
 # IDE
 
-You are free to use any IDE but you should also run `npm run tscw` to run the same TypeScript version as alm in watch mode.
+We use alm to develop alm. Run `npm run alm` to launch a last published version of alm to develop alm.
+
+You are free to use some other IDE if you want. You can run `npm run tscw` to run the TypeScript in the background in watch mode and use your favorite IDE in the foreground.
 
 # Webpack
 All our front-end js gets minified into `bundle.js`. This is what gets npm deployed.

docs/contributing/dependencies.md

@@ -7,3 +7,9 @@ Here we mention some of the dependencies and what we use them for:
 * react: main ui framework
 * free-style: provides css style sheet features using just JavaScript. [See this blog post about it](https://medium.com/@basarat/css-modules-are-not-the-solution-1235696863d6#.ar4ydjv4m).
 * marked: markdown parser (markdown -> html)
+
+
+## Tested
+
+* `mocha`
+* `ts-node`

docs/features/omni-search.md

@@ -1,11 +1,11 @@
 
 A unified search input for the following:
 
-* [File Search](#file-search)
 * [Command Search](#command-search)
-* [Project Search](#project-search)
-* [Symbol Search](#symbol-search)
 * [Project FilePath Search](#project-filepath-search)
+* [Symbol Search](#symbol-search)
+* [File Search](#file-search)
+* [Project Search](#project-search)
 
 ## Command Search
 

docs/features/testing.md

@@ -0,0 +1,56 @@
+# Testing
+
+Having your test results integrated into the IDE is a feature that can greatly enhance any test driven development experience. We support `mocha` based testing out of the box ([mocha reigns as the king of testing frameworks][stats]).
+
+## Configuration
+
+Add a simple `alm.json` at the root working directory of your project e.g.:
+
+```json
+{
+  "tests": {
+    "include": [
+      "./src/tests/**/*_spec.ts",
+      "./src/tests/**/*_spec.tsx"
+    ]
+  }
+}
+```
+Optionally you can also provide an `exclude` pattern.
+
+> `include` and `exclude` have the same behaviour as TypeScript's tsconfig. In fact we use the ts compiler to expand these.
+
+Testing is automatically enabled if such a file is detected and disabled otherwise.
+
+## Status bar
+
+If a testing configuration is detected in `alm.json` we run the tests and show you the test count / fails / passes in the status bar.
+
+![](https://raw.githubusercontent.com/alm-tools/alm-tools.github.io/master/screens/tested/statusBarIcon.png)
+
+## Inline
+`console.log` and errors are shown inline in the editor.
+
+> TIP: you can use a test file to quickly test out some TypeScript you are writing ;)
+
+![](https://raw.githubusercontent.com/alm-tools/alm-tools.github.io/master/screens/tested/testedOverview.gif)
+
+## Gutter
+We show test statuses in the editor gutter ⚽.
+
+## Test Results View
+Clicking on the status bar section for testing or running the `Test Results View` command opens up a test browser.
+
+![](https://raw.githubusercontent.com/alm-tools/alm-tools.github.io/master/screens/tested/liveUpdates.gif)
+
+## Running without alm
+
+Install `mocha` and `ts-node` and `typescript`. Now you can add something like the following to your package.json:
+
+```
+  "test": "mocha --compilers ts:ts-node/register,tsx:ts-node/register"
+```
+
+now `npm run test` 🌹.
+
+[stats]: http://www.npmtrends.com/mocha-vs-jasmine-vs-qunit-vs-jest-vs-ava

nodemon.json

@@ -1,6 +1,7 @@
 {
     "ignore": [
         "src/app/*",
-        "tests/*"
+        "tests/*",
+        "alm.json"
     ]
 }

package.json

@@ -7,6 +7,8 @@
     "alm": "./bin/alm"
   },
   "scripts": {
+    "start": "nodemon",
+    "alm": "alm -o",
     "test": "echo \"Testing is just build at the moment, run from prepublish\"",
     "clean": "rm ./src/public/build/bundle.js",
     "prepublish": "bash ./scripts/prepublish.sh",
@@ -16,6 +18,7 @@
     "uts": "npm install typescript@next tslint@next byots@latest --save --save-exact && npm run tsc",
     "umonaco": "npm install monaco@latest monaco-css@latest monaco-languages@latest --save --save-exact && npm run tsc",
     "ureact": "npm install react@latest react-dom@latest --save-dev --save-exact",
+    "utest": "npm install ts-node@latest mocha@latest --save --save-exact && npm run tsc",
     "preversion": "npm run tsc",
     "postversion": "git push --follow-tags",
     "mochaw": "mocha ./src/tests -w"
@@ -52,6 +55,7 @@
     "glob": "^7.0.5",
     "minimist": "^1.2.0",
     "mkdirp": "^0.5.1",
+    "mocha": "3.0.2",
     "monaco": "1.201608152240.0",
     "monaco-css": "1.1.2",
     "monaco-languages": "0.3.1",
@@ -63,14 +67,15 @@
     "ora": "^0.2.0",
     "rimraf": "^2.4.2",
     "socket.io": "^1.3.6",
-    "tslint": "3.15.1",
-    "typescript": "2.1.0-dev.20160809",
+    "ts-node": "1.3.0",
+    "tslint": "3.15.0-dev.0",
+    "typescript": "2.1.0-dev.20160912",
     "update-notifier": "1.0.2"
   },
   "devDependencies": {
+    "alm": "latest",
     "clipboard": "^1.4.2",
     "css-loader": "^0.24.0",
-    "csx": "4.0.0",
     "d3": "^3.5.12",
     "file-loader": "^0.8.4",
     "font-awesome": "^4.4.0",
@@ -85,6 +90,7 @@
     "marked": "^0.3.5",
     "mocha": "^2.4.5",
     "mousetrap": "^1.5.3",
+    "nodemon": "1.10.2",
     "normalize.css": "^3.0.3",
     "onresize": "^1.0.1",
     "react": "15.3.1",