Deprecate history and provide history digging functions instead

[horkhe]

Test writers do not need entire history. They need a convenient way to find out some specific facts about the history like called and num_calls functions. By providing them entire history we kind of forcing them to write custom information retrieval and verification functions.

I believe a better way would be to provide a comprehancive set of history digging functions, such as:

• verify - a unified version of called and num_calls that allows complex number of calls verification, argument matching using standard Erlang patterns and possibly Hamcrest matchers. It will also support verification of the order in which functions were called;
• capture - provides a way to retrieve a particular argument value that a particular function was called with.

That probably covers everything a testing human being might need.

[eproxus]

+1

Although history/1 should probably be left since people might want to build their own hacks on top of it (but with the documented caveat that the return format might change in future versions).

[horkhe]

We won't delete it, we will just deprecate it.

[eproxus]

I would like it to stay as not deprecated, perhaps hidden or just "marked" as non-reliable (between versions).

[eproxus]

Closing and documenting in the wiki instead: https://github.com/eproxus/meck/wiki#feature-ideas

Please comment here if you have information or requests to add, and/or want to discuss a PR or possible implementation proposal.