Skip to content
CAI
Software that uses CAICheck a score

appcues/exconstructor

61.2

Adequate · 15 November 2026

263

lines of production code

Elixir

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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.