Test Model Reporter

JavaScript hierarchical object model Any model type can validate, generate a report and write it to the file system Currently JUnit xml and Jasmine reporters are supported:

• JUnit Generates JUnit XML files according to the junit.xsd
• Jasmine Generates spec files

How To

First create a simple model

The model can be crated using an API like so:

 var testcase,
    failure,
    testsuite = jmr.create({
        type: "model.testsuite",
        data: {
            name: "testsuite"
        }
    });
    testcase = jmr.create({
        type: "model.testcase",
        data: {
            time: "now"
        }
    });
    testcase.set("name", "This is the test name");

    failure = jmr.create({
        type: "model.failure",
        data: {
            message: "This is a faulire message",
            type: "failure"
        }
    });

    testcase.add(failure);
    testsuite.add(testcase);

With that:

You can create an HTML site using Ant Reporter.

// write your file to the tests folder
jmr.write("./tests/demoTest.xml", testsuite.compile());

// tell ant where are your tests and where to put your HTML output
// Ant will collect all your *Test.xml files from test folder
jmr.report({
        reportsdir: "tests/reports",
        testsdir: "tests"
    });

Note: Ant dependency is not installed. You can find it in the dev dependency section.

Another example

In case you generates an object with all of your data, much simpler to burst it like so:

var obj = jmr.generate({
    type: "model.testsuites",
    data: {
        disabled: "false",
        name: "test.suites",
        body: [{
            type: "model.testsuite",
            data: {
                id: "$id",
                package: "test.test",
                name: "test.suite.1",
                body: [{
                    type: "model.testcase",
                    data: {
                        classname: "class1",
                        name: "test.case",
                        time: "now",
                        body: [{
                            type: "model.failure",
                            data: {
                                type: "fail",
                                body: "body content in here..."
                            }
                        }]
                    }
                }]
            }
        }]
    }
});

Jasmine example

Note: to be able to test the specs using node run: node installer.js or install jasmine-node module.

tmr.setReporter("jasmine");

var describe = tmr.create({
    type: "model.jas.describe",
    data: {
        title: "A suite is just a function",
        body:[
            {
                type:"model.jas.code",
                data: {
                    body: "var a;"
                }
            },
            {
                type: "model.jas.it",
                data: {
                    title: "and so is a spec",
                    body: [{
                        type:"model.jas.code",
                        data: {
                            body: "a = true; expect(a).toBe(true);"
                        }
                    }]
                }
            }
        ]
    }
});        


Model types: 
* **model.jas.describe** describe method
* **model.jas.it** it method
* **model.jas.code** code snippet 

Note: WIP, other Jasmine functionality will be supported.

Browser Support

Usage

• AMD

  • See tmrwebRequire-min.js file, as an example of requirejs project style

    define([], function() {

      var jmrOnReady = function (jmr) {
          // use the "jmr" object   
      };
      return jmrOnReady;
            

    });

• None AMD

    // Use "jmr" or "testModelReporter" objects 
          
          
          

Download

• download the browser version

  • None AMD
    • with NO dependencies: tmr-min.js
      • manually download
        • Underscore
        • jsutils-min.js
    • with dependencies: tmr-min-all.js

      • underscore and js.utils are already inside

  • AMD
    • tmr-require-min.js

Troubleshooting

• Ant reporter, issue with MAC
  • After Ant Npm installed edit the ../bin/ant file according to the following fix

Reference

• create(config)
  • config {Object} The JUnit based configuration model
    • type - The type of the class model.[testsuites | testsuite | testcase | failure | error | skipped | system]
    • data - The class data
      • available specification properties (id, name, disabled, etc...)
      • body - the class children, can be a nested class or a string value

• generate(config)
  • config {Object} The JUnit based configuration model
    • type - The type of the class model.[testsuites | testsuite | testcase | failure | error | skipped | system]
    • data - The class data
      • available specification properties (id, name, disabled, etc...)
      • body - the class children, can be a nested class or a string value return an object
  • output {String} The generate output model
  • model {Object} The generated object model

JUnit Reporter configuration {reportsdir: "the output report location", testsdir: "the test folder to be scanned"}

Contribute

See ./src/reporter/junit and ./src/reporter/jasmine reporters for more information