hexpreview

CHANGELOG.md

# Changelog

## 2.5.0 (2025-09-24)

- This release requires Elixir ~> 1.15

- [`use Mockery.Macro`](`Mockery.Macro.__using__/1`) won't inject unnecessary code when `:mockery` isn't enabled in config

- Added `:suppress_dialyzer_warnings` option to [`use Mockery.Macro`](`Mockery.Macro.__using__/1`), see documentation for details

- Added `Mockery.Assertions.assert_called!/3` and `Mockery.Assertions.refute_called!/3`

  - New macros produce improved failure output.

- Deprecated `Mockery.Assertions.assert_called/2`, `Mockery.Assertions.assert_called/3`, `Mockery.Assertions.assert_called/4`, `Mockery.Assertions.refute_called/2`, `Mockery.Assertions.refute_called/3` and `Mockery.Assertions.refute_called/4`

  - Use `Mockery.Assertions.assert_called!/3` and `Mockery.Assertions.refute_called!/3` instead
  - Deprecation warnings include a suggested replacement showing the expected syntax (the suggestion is generated from the deprecated call). *Note:* the suggestion is best-effort and may not exactly match your current code — verify and adjust as needed.

- Improved `Mockery.mock/3`

  - Added typespecs.
  - It will now raise immediately if the mocked function does not exist. Previously, `Mockery.Error` was raised from the proxy module.
  - It will now raise immediately if a dynamic mock has an invalid arity. Previously, `Mockery.Error` was raised from the proxy module.

## 2.4.1 (2025-09-19)

- Fix: Deprecation warning for mockable/2 was crashing for Elixir < 1.14

## 2.4.0 (2025-09-09)

- Deprecated `Mockery.of/2` function.

  - Tuple calls used by this function won't be officially supported in Mockery v3.
    Users should migrate to the macro-based alternative in `Mockery.Macro`.

- `Mockery.Macro.mockable/2` based on `Mix.env/0` is deprecated.

   - Set `config :mockery, enable: true` in `config/test.exs` and recompile your project.

- Added `Mockery.Macro.defmock/2` and `Mockery.Macro.defmock/3` macros

- Added macros and functions from `Mockery.Assertions` to `locals_without_parens` in `.formatter.exs`

## 2.3.4 (2025-08-15)

- Fixed warnings (Elixir 1.18)

## 2.3.3 (2024-07-04)

- Added [`use Mockery.Macro`](`Mockery.Macro.__using__/1`) to solve new Elixir warnings

    - Replace `import Mockery.Macro` by `use Mockery.Macro`

## 2.3.2 (2024-07-03)

- Added missing () to fix warnings

## 2.3.1 (2019-10-10)

- Fixed issue preventing module attributes to be used in assert_called macros [#34](https://github.com/appunite/mockery/pull/34)

## 2.3.0 (2018-10-22)

- Allowed multiple mocks when using pipe operator or nested calls [#27](https://github.com/appunite/mockery/pull/27)
- Deprecated `Mockery.History.enable_history/1` in favor of `Mockery.History.enable_history/0` and `Mockery.History.disable_history/0`

## 2.2.0 (2018-06-17)

- Added `Mockery.Macro.mockable/2` macro as alternative way to prepare module for mocking
- Deprecated `Mockery.new/2`

## 2.1.0 (2018-02-19)

- Added `Mockery.new/2`
- Fixed typo in error message [#21](https://github.com/appunite/mockery/pull/21)
- Removed support for Elixir 1.1 and 1.2

## 2.0.2 (2017-10-25)

- Fixed `Mockery.of/2` typespecs

## 2.0.1 (2017-10-13)

- When Mix is missing, `Mockery.of/2` assumes that env is `:prod`

## 2.0.0 (2017-10-08)

- Removed `Mockery.Heritage`

  - Global mocks will be handled without macros by pure elixir modules.
  - Some new restrictions have been added for global mock modules (see global mock section in README)

- Changed `Mockery.mock/3` when value is function (dynamic mock)

  - `[function_name: arity]` syntax remains unchanged
  - `:function_name` syntax will raise error

- Changed `Mockery.of/2` output

  - run `mix compile --force` when upgrading from Mockery 1.x.x

## 1.4.0 (2017-10-02)

- `Mockery.mock/2` and `Mockery.mock/3` are now chainable

## 1.3.1 (2017-09-21)

- Minor format fix in `Mockery.History` failure messages

## 1.3.0 (2017-09-15)

- Added string version for `Mockery.of/2` (now recommended)
- Fixed mocking of erlang modules

## 1.2.0 (2017-09-13)

- Introduced `Mockery.History`

## 1.1.1 (2017-09-05)

- More descriptive errors (when args are not list) for:

  - `Mockery.Assertions.assert_called/3`
  - `Mockery.Assertions.refute_called/3`
  - `Mockery.Assertions.assert_called/4`
  - `Mockery.Assertions.refute_called/4`

- Removed unnecessary `Elixir.` namespace from module names in error messages

## 1.1.0 (2017-08-07)

- Added `Mockery.mock/2` (`Mockery.mock/3` value defaults to `:mocked`)
- Added `Mockery.Assertions.assert_called/4` macro
- Added `Mockery.Assertions.refute_called/4` macro

## 1.0.1 (2017-08-02)

- Fixed issue when mocking with `nil` or `false`

## 1.0.0 (2017-07-30)

- Added `use Mockery` for importing both `Mockery` and `Mockery.Assertions`
- Added `Mockery.Assertions.refute_called/2` and `Mockery.Assertions.refute_called/3`
- Loosen elixir version requirement from `~> 1.3` to `~> 1.1`