appcues/exconstructor
61.2
Adequate · 15 November 2026
263
lines of production code
Elixir
primary language
5
measurements over time
What this system is
ExConstructor is an Elixir library that simplifies instantiating structs from external data by automatically handling key format conversions between strings, atoms, and various casing styles. It provides a configurable macro that allows users to define custom constructors and control which key formats are accepted. The system includes comprehensive test coverage and supports modern Elixir configuration standards.
Features
Initial release of ExConstructor library
This change introduces the ExConstructor library, an Elixir tool that simplifies instantiating structs from external data (like JSON) by automatically handling map vs. keyword lists, string vs. atom keys, and camelCase vs. snake\_case conversions. The commit establishes the project structure with a new .formatter.exs, .tool-versions (Elixir 1.19.4, Erlang 28.2), and a comprehensive README explaining the \use ExConstructor\ macro. It also sets the initial version to 1.0.0 in the CHANGELOG and includes the MIT license.
(repo-wide) · high confidence
Behavioural changes
Migrate configuration syntax to Elixir 1.10+ import Config
The application configuration has been updated to use the modern \import Config\ syntax instead of the deprecated \use Mix.Config\. This change aligns the codebase with current Elixir standards, ensuring compatibility with newer versions of the language and its build tools while maintaining the same configuration behavior for the user.
config · high confidence
Support for UpperCamelCase keys and configurable key-format options
ExConstructor now automatically maps struct fields from input data using UpperCamelCase keys (e.g., \FieldFour\) in addition to the existing camelCase, snake\_case, and atom support. This capability is controlled by the new \Options\ struct, which allows users to enable or disable specific key-format checks (strings, atoms, camelcase, uppercamelcase, underscore) via the \use ExConstructor\ macro or by passing options to \populate\struct/3\. The library also introduces a \\\using\\_/1\ macro that supports passing a custom constructor name or a keyword list of default options, making the constructor behavior configurable per module.
lib · high confidence
Test coverage
Added comprehensive test suite for ExConstructor
Added extensive unit tests for the ExConstructor library, covering the \populate\_struct\ function's handling of various input formats (maps with string/atom keys, camelCase/underscore conversions, keyword lists) and its \Options\ configuration. The tests also verify multiple invocation styles (\use ExConstructor\, \define\constructor\, \\\using\\_\), custom constructor names, error handling for invalid inputs, and compatibility with \@enforce\_keys\ and struct definition ordering.
test · high confidence
Dependencies
Upgrade to Elixir 1.18 and update project dependencies
The project now requires Elixir 1.18 and has been versioned to 1.3.4. Several development dependencies have been updated to their latest compatible versions: dialyxir to 1.4, ex\_doc to 0.40.4, and earmark to 1.4.49. The project metadata has also been enriched with a description, package information (maintainers, license, links), and test coverage configuration using ExCoveralls.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 61 → 61 (-0.1)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 100 → 100 (+0.0)
- Architecture 69 → 69 (+0.0)
- Maturity 43 → 43 (+0.0)
- Readiness 77 → 77 (-0.1)
- Security 96 → 95 (-1.7)
New (1)
- Outdated: dialyxir
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
appcues/exconstructor 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.
About this page
- The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 3db3a96ad615db0850877221eee66cb4968517d4 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.