msz/hammox

Hammox is an Elixir library that enhances unit testing by wrapping mock functions with runtime type checking based on Elixir behaviors. It validates arguments and return values against specified typespecs, raising errors on mismatches to ensure mocks adhere to their defined interfaces. The system integrates with existing Mox workflows and includes performance optimizations, telemetry support, and comprehensive test coverage for various type scenarios.

The library now provides \protect/2\ and \protect/3\ functions that wrap mock functions with runtime type checking based on Elixir behaviours. When a protected function is called, it validates arguments and return values against the specified typespecs, raising a \Hammox.TypeMatchError\ on mismatch. This adds a layer of contract testing to unit tests, ensuring mocks behave according to their defined interfaces, while retaining full compatibility with existing Mox-based mocking workflows.

lib · high confidence

The Hammox library has been refactored to improve performance and observability. A new \Hammox.Cache\ module replaces the previous Genserver-based caching with \:persistent\_term\ for faster lookups, while \Hammox.Telemetry\ introduces an opt-in telemetry system (disabled by default) that wraps \:telemetry.span\ to allow users to monitor Hammox's internal operations. The core type-matching logic has been extracted into \Hammox.TypeEngine\ to simplify the main codebase, and \Hammox.TypeMatchError\ now provides more human-readable error messages for type mismatches. Additionally, \Hammox.Protect\ offers a convenient \use\ macro for test modules to automatically protect functions against their specified behaviors.

lib/hammox · high confidence

Added test support modules for Hammox.Protect; Added tests for Hammox.Protect and telemetry behavior; Comprehensive test suite for Hammox type protection and type checking; Expanded test support fixtures for typespec validation.

This update bumps the project to version 1.0.0 and raises the minimum Elixir requirement to 1.15. It upgrades development dependencies, including ex\_doc to 0.40.3, credo to 1.7.19, and mox to 1.2.0, while adding ordinal 0.2.0 and telemetry 1.4.2 to the dependency list. The release also introduces a \mix ci\ alias to standardize formatting, dependency checks, compilation, linting, and testing, and configures package metadata for Hex publishing.

(dependencies) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 72 → 73 (+0.6)
• Rubric changed (rubric-2026.09.15 → rubric-2026.10.1) — scores are not directly comparable.

• Code Health 98 → 98 (+0.0)
• Architecture 100 → 100 (+0.0)
• Maturity 55 → 55 (+0.0)
• Readiness 77 → 78 (+1.7)
• Security 96 → 97 (+0.8)

• Documentation: no licence statement (README.md)

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

msz/hammox was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.