Changelog

Copy Markdown View Source

All notable changes to this project are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.2.1 - 2026-10-03

Changed

  • Requires Mutare 0.5 ({:mutare, "~> 0.5.0"}) and mutare_swoosh 0.2.1.

0.2.0 - 2026-09-26

Changed

  • Breaking: Mutare 0.4.1 and mutare_swoosh 0.2 or newer are required ({:mutare, "~> 0.4.1"}, {:mutare_swoosh, "~> 0.2"}). Mutare 0.4.0 hands a mutator a pipe stage as the direct call it is sugar for, and the families read the email at argument 0 in both spellings; the Function.identity() no-op stage is gone.
  • A removed pipe stage is diffed as the email it collapses to. email |> render_body(:welcome) → email, and email |> put_layout({LayoutView, :email}) → email, where the diff read render_body(:welcome) → Elixir.Function.identity(). A stage in the middle of a chain takes the chain upstream of it along (e |> render_body("welcome.html", %{}) |> deliver() reads e |> render_body("welcome.html", %{}) → e). The narrowing, format-drop and layout-off mutants still read at the stage alone. The mutants themselves, their variant labels and their notes are unchanged.

0.1.0 - 2026-09-07

Initial release.

Added

  • Two mutator families over the phoenix_swoosh template-rendering surface, each reported under its own name and independently enable-able:
    • Mutare.Phoenix.Swoosh.RenderBody (:render_body) — mutations that change which body parts are rendered. Removes a render_body/2,3 call, collapsing to the email (remove — the email is sent with no rendered body); narrows a literal atom template to each of its string forms (html_only / text_only — only the .html / only the .text body renders, testing assertions on each body part); and drops one entry per mutant from a literal put_new_formats/2 map (format — that extension stops rendering, the custom-formats form of the same gap). Both wrapper arities are supported, including the use-injected default-assigns /2 form; a string or computed template gets the removal mutant alone, and a single-entry format map produces no drop (that is the remove mutant's diff).
    • Mutare.Phoenix.Swoosh.Layout (:mail_layout) — mutations that change which layout wraps the body. Removes a layout setter, collapsing to the email: put_layout/2 (put — the previous layout stays) and put_new_layout/2 (put_new — the layout stays unset and the body renders bare); and suppresses the layout at the render site by writing layout: false into render_body's assigns (off), which is where a use-configured layout can be overridden at runtime. off is generated only where a layout is demonstrably in effect — the mailer's use line configured one, or the call's own assigns contain a truthy layout:. Literal map and keyword assigns gain the entry in place, an existing layout: entry is turned off rather than duplicated, a computed assigns argument is normalised the way phoenix_swoosh normalises it (Enum.into/2 then Map.put/3), and the default-assigns /2 form gains its assigns map without requalifying the bare call (which would skip the use wrapper's put_new_view).
  • Structural pins on phoenix_swoosh's identifier positions, via call-routing registry :raw routes covering the whole argument subtree: the template name, the layout value (tuple interior included), and put_new_formats/2's extension→field map — a perturbed value there is a missing-template crash at render, so core's value families do not generate mutants in those positions. Mutare.Phoenix.Swoosh.RenderBody can still drop a whole format-map entry as a call-level mutation.
  • A Mutare.UseExpansion extension (Mutare.Phoenix.Swoosh under :extensions) that handles expansion of use Phoenix.Swoosh and returns a whole import Phoenix.Swoosh in place of the real injected except: [render_body: 3] import + local wrapper pair — the piece that makes bare render_body calls resolvable (and their witness safe) at all. The standalone template_root: style additionally returns the import Phoenix.View its nested use would inject. The same expansion reports whether the use line configured a layout, as the Mutare.Phoenix.Swoosh.LayoutConfigured marker — the one channel a use expansion has into a mutator's context, and how a compile-time option gates a runtime mutant.
  • Every family matches its call written qualified, aliased, bare-imported, or piped (a piped removal becomes the Function.identity() no-op stage).
  • Ignore-variant labels throughout, so # mutare:ignore[family:label] can suppress one kind of mutant (e.g. [render_body:text_only], [render_body:format], [mail_layout:put], [mail_layout:off]).
  • Mutare.Phoenix.Swoosh.all/0 for splicing both families into a :mutators list, composing with the base Mutare.Swoosh.all/1 preset from mutare_swoosh (a dependency of this package).
  • Documented scope: the use Phoenix.Swoosh line's own options are compile-time configuration Mutare prunes whole, so only the runtime calls that configuration flows through are mutable; layout-name narrowing and the put_new_layout ↔ put_layout swap are written down as deferrals with their reasons; and the README includes a verified recipe for pinning core's whole-assigns-map collapse per project.