lpgauth/foil

Foil is a caching system that supports storing and retrieving both literal and non-literal terms, such as maps, PIDs, and ports. It provides a dual-language API, allowing direct interaction from both Erlang and Elixir, and includes utilities for namespace management and safe module execution. The system emphasizes robust error handling and state introspection capabilities.

Foil now includes an Elixir shim module (\Foil\) allowing the full API to be called directly from Elixir without extra dependencies. The \foil:namespaces/0\ function has been added to return a list of registered namespaces, simplifying state introspection. Additionally, \foil\_compiler:to\_syntax/1\ now supports maps and non-representable terms (pids, ports, funs, etc.), allowing these values to be cached and returned unchanged. The project also modernized its tooling by migrating CI to GitHub Actions, updating documentation generation to \rebar3\_ex\_doc\, and bumping the \metal\ dependency to 0.1.2.

(repo-wide) · high confidence

Users can now call the Foil API directly from Elixir via the new Elixir.Foil module, which exposes functions like lookup, insert, and all. The core Erlang API gains a new all/1 function to retrieve all keys in a namespace and a namespaces/0 function to list available namespaces. Additionally, the compiler now supports storing and retrieving maps and non-representable terms (such as references, pids, and ports) by smuggling them through integer syntax nodes, and the application version has been bumped to 0.1.7 with added compiler and syntax\_tools dependencies.

src · high confidence

The \include/foil.hrl\ header now defines a specific \error\_reason()\ type (covering \foil\_not\_started\, \key\_not\_found\, \module\_exists\, and \module\_not\_found\) replacing the generic \atom()\ error type, and introduces a \WITH\_MODULE\ macro for safely looking up and executing code in runtime-compiled modules. Additionally, all generated documentation files in \doc/\ (including \edoc-info\ and module-specific markdown files) have been removed.

bin, doc, include · high confidence

Added tests for error handling, non-literal terms, Elixir shim, and namespaces

test · high confidence

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

• CAI 69 → 69 (+0.6)
• Rubric changed (rubric-2026.09.12 → rubric-2026.09.18) — scores are not directly comparable.

• Code Health 100 → 100 (+0.0)
• Architecture 69 → 69 (+0.0)
• Maturity 59 → 59 (+0.0)
• Readiness 78 → 80 (+2.3)
• Security 92 → 96 (+4.0)

• Coverage not measured — no coverage collector is wired up
• 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.

lpgauth/foil 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.