README.md

Writing unit tests can be hard and sometimes good design has to be sacrificed for the sole purpose of testability. Often testability corresponds to good design, but this is not always the case. For example final classes and methods cannot be used, private methods sometimes need to be protected or unnecessarily moved to a collaborator, static methods should be avoided completely and so on simply because of the limitations of existing frameworks.

PowerMock is a framework that extends other mock libraries such as EasyMock with more powerful capabilities. PowerMock uses a custom classloader and bytecode manipulation to enable mocking of static methods, constructors, final classes and methods, private methods, removal of static initializers and more. By using a custom classloader no changes need to be done to the IDE or continuous integration servers which simplifies adoption. Developers familiar with the supported mock frameworks will find PowerMock easy to use, since the entire expectation API is the same, both for static methods and constructors. PowerMock aims to extend the existing API's with a small number of methods and annotations to enable the extra features. Currently PowerMock supports EasyMock and Mockito.

When writing unit tests it is often useful to bypass encapsulation and therefore PowerMock includes several features that simplifies reflection specifically useful for testing. This allows easy access to internal state, but also simplifies partial and private mocking.

Please note that PowerMock is mainly intended for people with expert knowledge in unit testing. Putting it in the hands of junior developers may cause more harm than good.

News

• 2015-07-25: PowerMock has moved to GitHub. From now on the old Google Code page should not be used anymore. All issues are reported here on GitHub and the documentation is migrated.
• 2015-03-16: PowerMock 1.6.2 has been released. See change log for details.
• 2015-01-03: PowerMock 1.6.1 has been released with support for JUnit 4.12. See change log for details.

Older News

Documentation

• Getting Started
• Downloads
• Motivation
• Javadoc
  • EasyMock API extension (PowerMock class)
  • Mockito API extension (PowerMockito class)
  • PowerMock Reflect (Whitebox class)
• EasyMock
  • Mock Static
  • Mock Final
  • Mock Private
  • Mock New
  • Mock Partial
  • Replay and verify all
• Mockito (Legacy)
• Common
  • Bypass Encapsulation
  • Suppress Unwanted Behavior
  • Test Listeners
  • Mock Policies
  • Mock system classes
• TestNG
• Delegate to another JUnit Runner
• Tutorial
• Experimental
  • Bootstrap using a JUnit Rule
  • Bootstrap using a Java Agent
• OSGi
• Release Notes
• FAQ

Support and discussion

Join the mailing-list here for questions, feedback and support.

Links

• Change log
• PowerMock on Ohloh
• Mailing list for questions and support

Sponsored by: