browsertap

apuppet =======

Apuppet is an utility which allows you to easily launch, and control applications from the command line. It was built to launch different browser versions for cross-browser testing.

  Usage: browsertap [options] [command]
 
  Commands:
 
    start <appName> [args] starts an application
 
  Options:
 
    -h, --help           output usage information
    -c, --config <path>  browsertap configuration file

Launching chrome 25

browsertap start chrome@25 http://google.com

Launching multiple applications:

browsertap start chrome@25+firefox@18 http://google.com

In /usr/local/etc/browsertap/config.json

{
  "directory": "/path/to/apps/dir"
}

Structure of /path/to/apps/dir:

apps/

  • chrome/ - application name
    • index.coffee - application driver
    • versions/ - application driver
      • 10.lnk
      • 11.lnk
    • settings/
      • 10 11 12/
  • safari/
    • index.coffee
    • version/
      • ...
    • settings/
      • ...
var browsertap = require("browsertap")({
  directory: "./path/to/apps"
});

Returns all the loaded applications

Starts an application

A basic application driver looks like this:

 
class ChromeDriver extends AppDriver
  
  ###
   starts 
  ###
 
  start: (options, callback) ->
    callback nullnew AppProcess @callback
 

options

  • version - application version to run
  • args - arguments to pass to the command line

callback - called when the application has successfuly spawned

Returns the running processes

Stops the application process

executes a command against the running process

Restarts the application process

TRUE if the application is running

Adds an event listener to the application process

stop - emitted when the process exits start - emitted when the application starts

module.exports = ChromeDriver