Duckface

Javascript interfaces by duck typing!

Installation

Use Bower to install Duckface into your project:

$ bower install duckface

Then use RequireJS to use the library:

require(['duckface']);

Usage

Define a Duckface without arguments checking:

var ApiDriver = new Duckface('ApiDriver', ['fetchItems', 'addItem']);

This will define a Duckface, with only a list of methods that should be implemented. How the methods are implemented is left to the implementing object.

Define a Duckface with strict arguments checking:

var ApiDriver = new Duckface('ApiDriver', {
    fetchItems : function(page) {},
    addItem : function(title, content, author) {}
});

This will define a Duckface, with dummy methods on an object. The arguments of the dummy methods are strictly checked in the implementing object to ensure the defined contract is upheld.

Check if an object implements correct interface:

function Raffler(driver)
{
    Duckface.ensureImplements(driver, ApiDriver);
}

Contributing

Workflow

1. Create an issue in the issue tracker of this repository
2. Fork this repository into your own account

3. Implement your bugfix/feature/… in a separate branch

   1. If it’s a feature, use feature/ prefix for you branch, followed by the issue number in the tracker. E.g. feature/#9
   2. If it’s not a feature, use issue/ prefix for your branch, followed by the issue number in the tracker. E.g. issue/#12

4. Create additional unit tests, or update existing ones

5. Do a merge request back to this repository and wait for your PR to be accepted/declined

Unit testing

We aim to keep Duckface code coverage in unit tests as close to 100% as possible. When contributing to Duckface you are strongly encouraged to keep the current code coverage from regressing.

Mocha is used as the unit testing framework. Install it using NPM:

$ npm install

This will install required NodeJS modules.

To run the tests, perform from the project root:

$ make test