README

fake chocolate, mock objects and test spies.

mockolate.org Documentation, examples, elaboration. Drew Bourne Contact.

This tagline is probably a hint that Mockolate is most useful when testing software. Whether you are doing test-driven-development, post-crunch-time fill-in-the-gaps, or exploratory-I-have-no-idea-what-is-going-on testing Mockolate can help.

Mock Objects

A mock object can be used to simulate the behaviour of complex, real (non-mock) objects when using the real object would be impractical or impossible. Situations where a mock object would be useful:

When an object is slow (like a database or webservice),
is non-deterministic (like the current time),
has states that are difficult to reproduce (like network connections)

The above is mostly appropriated from Mock Objects at Wikipedia. I could keep rewriting it here, but it's really quite a good read.

Test Spies

In espionage, spies infiltrate a system, recording and relaying information to their handlers. The handlers may use that information to check facts, inform others, or take action.

In testing, a Test Spy records which methods are called, which getters are got, which setters are set. The handler (typically a testcase) can then check the facts against what should or should not have happened and take action (typically an assertion).

Mockolate?

clean consistent syntax
expectation-based or record-replay
dynamically generates proxy Classes
supports handcoded proxy Classes
provides a FlexUnit 4 Rule and Runner
uses proven libraries, FlexUnit 4, FLoxy and Hamcrest-as3

Head over to http://mockolate.org/ for documentation and examples:

Thanks

Richard Szalay with FLoxy, and Maxim Porges with Loom for their work on Class proxy generation.

Brian LeGros for hassling me about -mock-as3- enough that I added class proxy generation to it. Except you can ignore that project in favour of Mockolate.

jeroendelau / mockolate

Maintainers

Details