g-andrade/locus
67.3
Weak · 15 November 2026
8.3k
lines of production code
Erlang
primary language
5
measurements over time
What this system is
This system is a database lookup service, likely for geolocation data, that supports loading from local files and HTTP sources. It provides extensibility through custom fetcher implementations and event subscribers, allowing consumers to integrate their own logic and monitor loader activities. The system includes robust error handling for invalid or corrupt data and is designed for use within Erlang/Elixir applications.
Features
Introduce custom fetcher and event subscriber APIs
Added \locus\_custom\_fetcher\ to allow consumers to provide their own database fetcher implementation via callbacks, and \locus\_event\_subscriber\ to enable subscribing to database loader events using either module-based or process-based subscribers.
src · high confidence
Removals
Removed legacy documentation and versioning scripts
The repository has removed the \hackish\_make\_docs.sh\, \version\_from\_git.py\, and \version\_from\_git.sh\ scripts. These files previously handled the generation of documentation via rebar3/edoc and the extraction of version numbers from Git tags. Their removal aligns with the project's preparation to migrate documentation hosting from GitHub to Hexdocs, indicating that the previous local build and versioning workflows are no longer used.
scripts · high confidence
Behavioural changes
Major API overhaul and documentation modernization for version 2.x
This release introduces breaking changes to the public API, requiring users to update their code: \wait\_for\_loader\ functions are replaced by \await\_loader\ (which now returns a list of failures instead of a single error), \get\_version/1\ is replaced by \get\_info/1-2\, and \analyze/1\ is replaced by \check/1\. Additionally, successful lookups in IPv4-less databases now return \not\_found\ directly instead of \{error, not\_found}\, and metadata keys in \get\_info\ results are now atoms instead of binaries. The project has also migrated its documentation from EDoc to ExDoc (using EEP-48 attributes), adopted the \erlfmt\ code formatter, and updated its build tooling to use \rebar3\ plugins like \rebar3\_hank\ and \rebar3\_lint\ with conditional support for older OTP versions.
(repo-wide) · high confidence
Test coverage
Added test fixtures for GeoLite2 database formats; Expanded test coverage for database loading, custom fetchers, and error handling.
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 68 → 67 (-0.7)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 78 → 77 (-1.6)
- Architecture 100 → 100 (+0.0)
- Maturity 63 → 63 (+0.0)
- Readiness 61 → 61 (+0.0)
- Security 92 → 87 (-5.4)
Resolved (1)
- No ADRs found
New (17)
- Edited copies of one member (3 members, 2+ corresponding lines) (src/locus_custom_fetcher.erl)
- Edited copies of one member (4 members, 10+ corresponding lines) (src/locus_loader.erl)
- Edited copies of one member (5 members, 4+ corresponding lines) (src/locus_custom_fetcher.erl)
- Edited copy of a member (10 corresponding lines) (src/locus_database.erl)
- Edited copy of a member (10 corresponding lines) (src/locus_mmdb_data_codec.erl)
- Edited copy of a member (10 corresponding lines) (src/locus_mmdb_data_codec.erl)
- Edited copy of a member (10 corresponding lines) (src/locus_mmdb_tree.erl)
- Edited copy of a member (12 corresponding lines) (src/locus_loader.erl)
- Edited copy of a member (17 corresponding lines) (src/locus_mmdb_data_codec.erl)
- Edited copy of a member (27 corresponding lines) (src/locus.erl)
- Edited copy of a member (31 corresponding lines) (src/locus_http_download.erl)
- Edited copy of a member (31 corresponding lines) (src/locus_mmdb_data_codec.erl)
- Edited copy of a member (8 corresponding lines) (src/locus_filesystem_load.erl)
- Edited copy of a member (8 corresponding lines) (src/locus_loader.erl)
- Edited copy of a member (8 corresponding lines) (src/locus_mmdb_data_codec.erl)
- Medium CVE: EEF-[CVE redacted] (rebar.lock)
- No ADRs found (rebar.config)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
g-andrade/locus 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 4fd04ea0d89ea099f13e18b9dbf8bb6057aedfac — 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.