Moq – The simplest mocking library for .NET and Silverlight

现在的位置: 首页 > 综合 > 正文

Moq – The simplest mocking library for .NET and Silverlight

2014年01月31日 ⁄ 综合 ⁄ 共 4501字 ⁄ 字号小中大 ⁄ 评论关闭

Update: Development of this project has moved to GitHub. New releases and bug fixes will be published there.

var mock = new Mock<ILoveThisFramework>();

// WOW! No record/replay weirdness?!  
mock.Setup(framework => framework.DownloadExists("2.0.0.0"))
    .Returns(true)
    .AtMostOnce();

// Hand mock.Object as a collaborator and exercise it, 
// like calling methods on it...
ILoveThisFramework lovable = mock.Object;
bool download = lovable.DownloadExists("2.0.0.0");

// Verify that the given method was indeed called with the expected value
mock.Verify(framework => framework.DownloadExists("2.0.0.0"));

Checkout the QuickStart for more examples!

What?

Moq (pronounced "Mock-you" or just "Mock") is the only mocking library for .NET developed from scratch to take full advantage of .NET 3.5 (i.e. Linq expression trees) and C# 3.0 features (i.e. lambda expressions) that make it the most productive, type-safe
and refactoring-friendly mocking library available. And it supports mocking interfaces as well as classes. Its API is extremely simple and straightforward, and doesn't require any prior knowledge or experience with mocking concepts.

Why?

The library was created mainly for developers who aren't currently using any mocking library (or are displeased with the complexities of some other implementation), and who are typically manually
writing their own mocks (with more or less "fanciness"). Most developers in this situation also happen to be quite
pragmatic and adhere to state (or classic) TDD. It's the result of feeling that the barrier of entry from other mocking libraries is a bit high, and a simpler, more lightweight and elegant approach is possible. Moq achieves all this by taking full advantage
of the elegant and compact C# 3.0 language features collectively known as LINQ (they are not just for queries, as the acronym implies).

Moq is designed to be a very practical, unobtrusive and straight-forward way to quickly setup dependencies for your tests. Its API design helps even novice users to fall in the "pit of success" and avoid most common misuses/abuses of mocking.

Currently, it's the only mocking library that goes against the generalized and somewhat unintuitive (especially for novices) Record/Replay approach from all other frameworks (and this
might be a good thing ;)).

Not using Record/Replay also means that it's straightforward to move common expectations to a fixture setup method and even override those expectations when needed in a specific unit test.

You can read more about the "why" and see some nice screenshots at kzu's blog.

Where?

See our QuickStart examples to get a feeling of the extremely simple API and download
the latest binaries, source code and help file.

Read about the announcement at kzu's blog. Get some background on the
state of mock libraries from Scott Hanselman.

Browse the API documentation to get a feeling of how extremely simple it is to use.

Who?

Moq was jointly developed by Clarius, Manas and InSTEDD.
You can read more about it at InSTEDD Moq page.

Moq uses Castle DynamicProxy internally as the interception mechanism to enable mocking. It's merged into Moq binaries, so you don't need to do anything
other than referencing Moq.dll, though.

Moq team uses VisualSVN to easily work with the SVN repository. It makes development a breeze!

Features at a glance

Moq offers the following features:

Strong-typed: no strings for expectations, no object-typed return values or constraints
Unsurpassed VS intellisense integration: everything supports full VS intellisense, from setting expectations, to specifying method call arguments, return values, etc.
No Record/Replay idioms to learn. Just construct your mock, set it up, use it and optionally verify calls to it (you may not verify mocks when they act as stubs only, or when you are doing more classic state-based testing by
checking returned values from the object under test)
VERY low learning curve as a consequence of the previous three points. For the most part, you don't even need to ever read the documentation.
Granular control over mock behavior with a simple MockBehavior enumeration (no need to learn what's the theoretical
difference between a mock, a stub, a fake, a dynamic mock, etc.)
Mock both interfaces and classes
Override expectations: can set default expectations in a fixture setup, and override as needed on tests
Pass constructor arguments for mocked classes
Intercept and raise events on mocks
Intuitive support for out/ref arguments

Check the ChangeLog to learn about features introduced with each version.

Who's using this?

Checkout some adoption stats, and hear what Moq users have to say in ILoveMoq.

Need a commercial license or premium support?

You don't need a commercial license just to use Moq, even if it is for a commercial product, unless your company just doesn't use "open source software", in which case, a commercial license means they are buying the product like they would any other piece of
software for the company.

If you still think you need a commercial license or just want premium support, contact us.