ersatz's Introduction

Ersatz

Ersatz is a library for defining mocks in Elixir.

Contributions welcome :-)

Ersatz in a fork of Mox and follows mosts of principles outlined in "Mocks and explicit contracts".

But why a fork ?

Usage

Mocks are generated based on behaviours during configuration and injected using env variables.
Add the mock behaviour by specifying functions to be used during tests with Ersatz.set_mock_implementation/3.
Test your code's actions on the mock dependency using Ersatz.get_mock_calls/1 or the Espec custom matchers.

See the documentation for more information.

Installation

Add ersatz to your list of dependencies in mix.exs:

def deps do
  [
    {:ersatz, "~> 0.2", only: :test}
  ]
end

To Do

clarify documentation
function to clear all previous calls
add custom assertions for ExUnit
function to configure only a return value instead of a complete function
Test concurrency support. (should be ok, but... )
add configuration for initializing mocks before start of application under test

License

Ersatz is a fork of Plataformatec Mox library.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Recommend Projects