pimbrouwers/Donald
61.1
Adequate · 24 September 2026
585
lines of production code
F#
primary language
5
measurements over time
What this system is
Donald is a .NET library that provides a functional, type-safe API for ADO.NET database interactions. It simplifies data access by offering dedicated methods for commands, parameters, and execution, while replacing generic error handling with structured exceptions for better debugging. The library supports synchronous and asynchronous workflows across various ADO.NET providers and targets .NET 6, 7, and 8.
Features
Introduce Donald, a functional ADO.NET library for safer and more succinct database interactions
The repository now includes the initial release of Donald, a .NET library designed to provide a cleaner, type-safe API for ADO.NET. The release includes a build script (Build.ps1) and deployment automation (Deploy.ps1) for packaging and pushing NuGet packages. The library exposes functional-style methods like Db.newCommand, Db.setParams, Db.query, and Db.exec to simplify data access, supporting both synchronous and asynchronous workflows across various ADO.NET providers.
(repo-wide) · high confidence
Behavioural changes
Introduce structured exception types and safe database operation wrappers
The library now defines specific exception types—DbConnectionException, DbExecutionException, DbTransactionException, and DbReaderException—each carrying contextual details like connection strings, SQL statements, or field names to aid debugging. These replace generic or monadic error handling with CLR exceptions that wrap underlying ADO.NET errors, providing clearer error messages and better resource management during database operations.
src/Donald · high confidence
Test coverage
Added initial test suite for SQL type handling
Added new tests in the \test/Donald.Tests\ directory that verify the library's ability to handle all supported SQL types, including strings, booleans, numeric types, and dates, using both the typed \setParams\ and raw \setParamsRaw\ APIs.
test · high confidence
Dependencies
Upgrade to .NET 6, 7, and 8 targets with updated dependencies
The Donald library now targets .NET 6, 7, and 8, allowing the package to be used in modern .NET applications. The project file has been updated to include these target frameworks and references FSharp.Core version 6.0.0. The test project has also been updated to target .NET 6.0 and includes updated test dependencies such as FsUnit.xUnit 4.0.4, xUnit 2.4.1, and related test SDKs.
(dependencies) · 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
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 62 → 61 (-0.7)
- Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.
Lenses
- Code Health 95 → 95 (+0.0)
- Architecture 100 → 89 (-10.8)
- Maturity 50 → 50 (+0.0)
- Readiness 54 → 55 (+1.1)
- Security 85 → 83 (-2.0)
Resolved (10)
- Dependency hygiene not measured — no supported dependency manifest was read
- High: security finding (details withheld)
- High: security finding (details withheld)
- Low coverage: Core.fs (Core.fs)
- Low coverage: IDbConnection.fs (IDbConnection.fs)
- Low coverage: IDbTransaction.fs (IDbTransaction.fs)
- No exposed public API
- Test reliability not included
- The quick start example uses IDbConnection but does not show how to pass a strongly-typed query result back into the type signature. (README.md)
- dormant codebase — no living knowledge left to concentrate
New (11)
- Documentation: no installation or build instructions (README.md)
- Documentation: no licence statement (README.md)
- Documentation: no usage examples (README.md)
- End-of-life runtime: .NET net6.0
- High: security finding (details withheld)
- High: security finding (details withheld)
- Medium: security finding (details withheld)
- Medium: security finding (details withheld)
- No dependency advisory monitoring
- Scattered collaborators
- Workflow token permissions not restricted
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
pimbrouwers/Donald 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 24 September 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 0d7b7d04d80c7181b87ffdc7f866dca659ce1cd0 — the exact code this score is about.
- Scored under rubric-2026.09.15 — the same rubric and the same method as every other entry in this index.
- Measured by watchdog.canine.dev using codehealth-analyzer preprod-923689c465cf.