Giter Club home page Giter Club logo

node-rinuts's Introduction

rinuts

A service which exposes tests through a RESTful api. Allows for remote querying and running tests on the service, by using http requests", as well as retrieving a detailed run information

built on node and express

Installation

Install with [npm](http://github.com/isaacs/npm):

    $ npm install rinuts

Usage

Starting the service:

var path = require('path'),
    rinuts = require('rinuts'),
    someDriver = require('rinuts-someDriver'),
    service;
    
    // what ever api the driver has to load tests
    someDriver.addTests(*TESTS*);
            
    service = new rinuts(someDriver);
    service.listen(3333);

Service API:

* *ctor*  (driver, context)
    Constructor. Loads a driver which implementes 'enumTests' and 'runTest'.
    [Argument] driver - The driver        
	[Argument] context - (optional) An object being the context of each test run.         

HTTP exposed API:

*	GET /tests : JSON response with a list of the tests exposed. Each test includes it's unique name and a POST URL which can be used to execute it. The list structure is as follows:
        {
            "*testName*": {
                "name": "*testName*",                    
                "url":"/tests/*testName*"
                }
            ...
        }

*	GET /tests/:testName : Returns an individual entry from the list above. has the form of:
		{
			"name": "*testName*",				
			"url": "/tests/*testName*"}

*	POST /tests/:testName : Executes the individual test and returns the test run summary, in the following structure (can be expanded by the driver):            
        {
            "name": *testName*,                
            "state": *true|false*                
        }
		
	Adding context to the request(Optional):		
		HTTP-Headers: "Content-Type: application/json"
		HTTP-Body: {"context": *whatEver*}" - a JSON notated object
	
	note - added context will override context supplied to the *ctor* of rinuts.

Driver interface:

Drivers for rinuts should export the following methods inorder to enable 'rinuts' to 
enumarate the driver's tests as a reponse for 'GET' request and to run a speicific test per 'POST' request:
 
 *  'enumTests' (callback): applies *callback* on an array containing the tests to be exposed. each array element has the form:
        {
            name: *the name of the test*,
            identifier: *the unique identifier of the test. will be appended to the test url in the get reponse, e.g, \tests\testoddnumbers*
        }
 *  'runTest' (identifier, callback, context) : runs the test matching 'identifier', with 'context' if supplied in the in the POST request,
        and applies callback on the testresult.

node-rinuts's People

Contributors

saary avatar urigolani avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar

Forkers

dineshkummarc

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.