Feature/update to use latest rooibos c

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Rooibos CHANGELOG
 
+## 2.1.3
+
+### Added
+
+### Changed
+
+ - improves documentation, explaining how to use rooibos-preprocessor from gulp/js toolchains
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+
 ## 2.1.2
 
 ### Added

docs/Rooibos.brs.html

@@ -122,7 +122,7 @@ <h1 class="page-title">Rooibos.brs</h1>
 <br class="clear">
 
 <footer>
-    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Mar 21 2019 20:05:44 GMT-0500 (-05) using the Minami theme.
+    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Apr 25 2019 18:06:17 GMT-0500 (-05) using the Minami theme.
 </footer>
 
 <script>prettyPrint();</script>

docs/Rooibos_BaseTestSuite.brs.html

@@ -2003,7 +2003,7 @@ <h1 class="page-title">Rooibos_BaseTestSuite.brs</h1>
 <br class="clear">
 
 <footer>
-    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Mar 21 2019 20:05:44 GMT-0500 (-05) using the Minami theme.
+    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Apr 25 2019 18:06:17 GMT-0500 (-05) using the Minami theme.
 </footer>
 
 <script>prettyPrint();</script>

docs/Rooibos_CommonUtils.brs.html

@@ -598,7 +598,7 @@ <h1 class="page-title">Rooibos_CommonUtils.brs</h1>
 <br class="clear">
 
 <footer>
-    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Mar 21 2019 20:05:44 GMT-0500 (-05) using the Minami theme.
+    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Apr 25 2019 18:06:17 GMT-0500 (-05) using the Minami theme.
 </footer>
 
 <script>prettyPrint();</script>

docs/Rooibos_ItemGenerator.brs.html

@@ -273,7 +273,7 @@ <h1 class="page-title">Rooibos_ItemGenerator.brs</h1>
 <br class="clear">
 
 <footer>
-    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Mar 21 2019 20:05:44 GMT-0500 (-05) using the Minami theme.
+    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Apr 25 2019 18:06:17 GMT-0500 (-05) using the Minami theme.
 </footer>
 
 <script>prettyPrint();</script>

docs/Rooibos_TestRunner.brs.html

@@ -415,7 +415,7 @@ <h1 class="page-title">Rooibos_TestRunner.brs</h1>
 <br class="clear">
 
 <footer>
-    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Mar 21 2019 20:05:44 GMT-0500 (-05) using the Minami theme.
+    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Apr 25 2019 18:06:17 GMT-0500 (-05) using the Minami theme.
 </footer>
 
 <script>prettyPrint();</script>

docs/index.html

@@ -57,7 +57,7 @@
 <br class="clear">
 
 <footer>
-    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Mar 21 2019 20:05:44 GMT-0500 (-05) using the Minami theme.
+    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Apr 25 2019 18:06:17 GMT-0500 (-05) using the Minami theme.
 </footer>
 
 <script>prettyPrint();</script>

docs/index.md

@@ -71,9 +71,47 @@ Rooibos is intentionally simple to work with. You simply copy in the `rooibosDis
 
 **For an example of how to use rooibos with gulp, see the gulpfile.ts in this project, which is used to run the framework unit tests.**
 
-### RooibosC
+### rooibos-preprocessor
+
+To get the best performance and test flexibility, rooibos leverages a typescript preprocessor, named [rooibos-preprocessor](https://github.com/georgejecook/rooibosPreprocessor), which prepares some files which get sideloaded with your tests. 
+
+### From javascript/typescript/node
+
+#### Gulp typescript example
+
+The following working gulpfile can be found in my [roku MVVM spike](https://github.com/georgejecook/rokuNavSpike/tree/feature/viewModels); but the process is as follows.
+
+ - `npm install rooibos-preprocessor --save-dev`
+ - Add the following to the top of gulpfile.ts `import { RooibosProcessor } from "rooibos-preprocessor";`
+ - Create a task to process your files, with the desired regex replacements, such as:
+
+ ```
+ export function addDevLogs(cb) {
+  let config: BurpConfig = {
+    "sourcePath": "build/.roku-deploy-staging",
+    // "sourcePath": "build/wtf",
+    "globPattern": "**/*.brs",
+    "replacements": [
+      {
+        "regex": "(^.*(logInfo|logError|logVerbose|logDebug)\\((\\s*\"))",
+        "replacement": "$1#FullPath# "
+      },
+      {
+        "regex": "(^.*(logMethod)\\((\\s*\"))",
+        "replacement": "$1#FullPath# "
+      }
+    ]
+  }
+  const processor = new BurpProcessor(config);
+  processor.processFiles();
+  cb();
+}
+```
+
+
+#### CLI usage
 
-To get the best performance and test flexibility, rooibos leverages a typescript preprocessor, named [rooibosC](https://github.com/georgejecook/rooibosPreprocessor), which prepares some files which get sideloaded with your tests. Simply: `npm install -g rooibos-preprocessor`
+You can also use rooibos-preprocessor from the command line, by installing it globally. i.e `npm install -g rooibos-preprocessor`. The CLI app is vcalled `rooibos`
 
 Then call `rooibosC -h` to check the install worked and see the help menu.
 

docs/module-BaseTestSuite.html

@@ -12420,7 +12420,7 @@ <h5>Returns:</h5>
 <br class="clear">
 
 <footer>
-    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Mar 21 2019 20:05:44 GMT-0500 (-05) using the Minami theme.
+    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Apr 25 2019 18:06:17 GMT-0500 (-05) using the Minami theme.
 </footer>
 
 <script>prettyPrint();</script>

docs/module-CommonUtils.html

@@ -5062,7 +5062,7 @@ <h5>Returns:</h5>
 <br class="clear">
 
 <footer>
-    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Mar 21 2019 20:05:44 GMT-0500 (-05) using the Minami theme.
+    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Apr 25 2019 18:06:17 GMT-0500 (-05) using the Minami theme.
 </footer>
 
 <script>prettyPrint();</script>

docs/module-ItemGenerator.html

@@ -1442,7 +1442,7 @@ <h5>Returns:</h5>
 <br class="clear">
 
 <footer>
-    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Mar 21 2019 20:05:44 GMT-0500 (-05) using the Minami theme.
+    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Apr 25 2019 18:06:17 GMT-0500 (-05) using the Minami theme.
 </footer>
 
 <script>prettyPrint();</script>

docs/module-TestRunner.html

@@ -651,7 +651,7 @@ <h4 class="name" id="Run"><span class="type-signature"></span>Run<span class="si
 <br class="clear">
 
 <footer>
-    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Mar 21 2019 20:05:44 GMT-0500 (-05) using the Minami theme.
+    Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Thu Apr 25 2019 18:06:17 GMT-0500 (-05) using the Minami theme.
 </footer>
 
 <script>prettyPrint();</script>