A node.js tool to automate and test Drupal using Zombie.js.
This node.js package provides an easy way to automate and test Drupal using the Zombie.js framework. It provides some helpers that make working with Drupal within Zombie.js easy and fun.
Install node.js by going to http://nodejs.org
On OS X install the OSX GCC installer. On Windows you'll need Cygwin to get access to GCC, Python, etc. Read this for detailed instructions and troubleshooting.
Since this tool requires 0.8 of node.js or earlier, you will need to install the NVM. Go to https://github.com/creationix/nvm and follow the installation section.
You can now install this library using NPM.
nvm use 0.8
npm install drupalgo
The configuration for your automation and testing should be placed within a
configuration file in *.json
form. This file contains your configurations
for your Drupal installation as well as other configurations that you would like
to include in your automation and testing, such as content creation, etc.
{
"host": "http://drupal.local/",
"user": "admin",
"nodes": [
{
"type": "article",
"title": "Hello There",
"body": "This is very cool!"
},
{
"type": "article",
"title": "This is another node",
"body": "Nice!"
}
]
}
You can now include this library in your test application and then do stuff
using the simple drupal.go
command. Since this library uses
Zombie.js for its core browser, you can
pass along any Zombie.js command from it's Zombie.js API
to the drupal.go
command like so...
drupal.go('pushButton', '#edit-submit')
This function returns a Promise to be used with the popular Async.js library making it very simple to build intuitive tests without falling into callback hell.
Here is an example of how simple it is to write some automation with this library...
Login, then create some nodes....
var async = require('async');
var drupal = require('drupalgo');
// Load the config.json file... as seen above.
var browser = drupal.load('config.json');
// Login, then create some content...
async.series([
drupal.go('login'),
drupal.go('createMultipleContent', drupal.config.get('nodes'))
], function() {
console.log('We are done!');
});
This library is super easy to extend and create your own Drupal processes. You
can do so by simply attaching them to the Drupal object and then they can be
utilized with drupal.go
like other processes. Here is an example.
var async = require('async');
var drupal = require('drupalgo');
// Add a new task to edit the node.
drupal.editNode = function(done) {
async.series([
this.do('visit', 'node/1234/edit'),
this.do('fill', '#edit-title', 'Something else!'),
this.do('pressButton', '#edit-submit')
], done);
};
// Load the config.json file... as seen above.
var browser = drupal.load('config.json');
// Login, then create some content, then EDIT A NODE!...
async.series([
drupal.go('login'),
drupal.go('createMultipleContent', drupal.config.get('nodes')),
drupal.go('editNode')
], function() {
console.log('We are done!');
});
Happy Automating....