massemanet/redbug
64.1
Adequate · 2 October 2026
2.3k
lines of production code
Erlang
primary language
2
measurements over time
What this system is
Redbug is an Erlang tracing tool and library that enables users to trace function calls, print return values, and view call stacks from the shell or command line. It provides utilities for monitoring process activity, including a dtop toggle for process statistics and support for tracing child processes and cover-compiled code. The system includes a comprehensive test suite and automated release infrastructure to ensure compatibility across various Erlang/OTP versions.
Features
Added automated release script
A new release script (bin/release.sh) has been added to automate the versioning and publishing process. This script validates the git repository state, increments the version number in the application source file based on a specified bump type (major, minor, or patch), commits the change, creates a git tag, and finally runs tests and documentation generation before publishing to Hex.
bin · high confidence
Initial release of redbug with build infrastructure and documentation
This entry introduces the redbug Erlang tracing tool, providing a new escript and library for interacting with the Erlang trace facility. Users can now trace function calls, print return values, and view call stacks either from the Erlang shell or via the command line. The release includes a Makefile for building and testing, a rebar.config with plugins for Hex publishing and ExDoc, and a rebar.config.script that dynamically configures build options based on the running Erlang/OTP version (e.g., enabling USE\_NOW or USE\_PEER macros). CI support is added via .travis.yml for OTP 20.3, 21.3, and 22.2, and the README is expanded with comprehensive usage examples.
(repo-wide) · high confidence
Behavioural changes
Added documentation for dtop, redbug, and start options
New edoc files have been added to the documentation directory, providing user-facing descriptions for the dtop toggle functionality (including max\_procs and sort configuration), the redbug tracing tool (covering its description, record handling, output formats, and usage examples), and the start/2 API (detailing Redbug Trace Pattern syntax and all available configuration options such as time, msgs, blocking, and print settings).
doc · high confidence
Redbug upgraded to version 2.1.0 with OTP 29 compatibility and escript improvements
The redbug tracing debugger has been updated to version 2.1.0, introducing compatibility fixes for OTP 29 (including handling of hidden options in net\_kernel:start and mnesia external tables) and OTP 26.1/27.0 (fixing -0.0 handling in dtop). The escript entry point now correctly opens print files in the appropriate process and uses universal time for timestamps. Additionally, the tool now supports tracing children via the 'trace\_child' option, handles cover-compiled code, and improves error handling for slow connections and improper lists.
src · high confidence
Test coverage
Added test suite for Redbug tracing and compilation features
Added new EUnit tests to verify Redbug's tracing capabilities, including timestamp formatting (milliseconds and microseconds), arity printing, buffered output, call stack reporting, and process message tracing. The suite also validates the compiler's handling of syntax errors, guard functions (is\_map\_key, map\_get, map\_size, byte\_size, bit\_size, tuple\_size), and record patterns, alongside distributed node testing.
test · high confidence
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 64 → 64 (-0.1)
- Rubric changed (rubric-2026.09.12 → rubric-2026.09.18) — scores are not directly comparable.
Lenses
- Code Health 92 → 92 (+0.0)
- Architecture 100 → 100 (+0.0)
- Maturity 54 → 54 (+0.8)
- Readiness 64 → 63 (-1.8)
- Security 67 → 67 (+0.0)
- Event Sourcing 100 → 100 (+0.0)
Resolved (5)
- Coverage not measured — no coverage collector is wired up
- Documentation: no installation or build instructions (README.md)
- Hotspot: src/redbug.erl (src/redbug.erl)
- Hotspot: src/redbug_compiler.erl (src/redbug_compiler.erl)
- Off-boarding risk: anonymized user #1
New (1)
- Off-boarding risk: anonymized user #1
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
massemanet/redbug 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 2 October 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit fec3356872bde3a0dfdb1f9ec84bc9d778d85e5c — the exact code this score is about.
- Scored under rubric-2026.09.18 — the same rubric and the same method as every other entry in this index.
- Measured by watchdog.canine.dev using codehealth-analyzer preprod-e569280dd5e2.