DAOS-18304 ddb: Add Go unit tests for ddb command layer by knard38 · Pull Request #18086 · daos-stack/daos

knard38 · 2026-04-22T13:59:18Z

Description

Overview

Go unit tests for the ddb CLI command layer, building on the build-tag CGo stub infrastructure
introduced in the predecessor PR #18124.

Tests are gated behind the test_stubs build tag and run without a live VOS environment. The CGo
function stubs provided by libddb_stubs.go expose configurable return-code variables
(ddb_init_RC, ddb_pool_is_open_RC, …) and hook variables (ddb_init_Fn, …) that let tests
control stub behaviour without modifying production code.

New Files

`test_helpers.go`

Test infrastructure shared across all test files:

newTestContext: allocates a DdbContext backed by the CGo stubs.
captureStdout: redirects os.Stdout to a pipe for the duration of a function call and
returns the captured output as a string.
runCmdToStdout: calls parseOpts() with given args and captures stdout.
runMainFlow: simulates the full main() flow (parse → version check → run) without
calling os.Exit().
assertContainsAll: asserts that a string contains every element of a given slice — used by
TestManPage to avoid repetitive loops.
isArgEqual: type-safe argument comparison helper.

`ddb_commands_test.go`

Tests for the grumble command definitions:

TestHelpCmds: verifies --help output for the ls and open commands.
TestCmds: argument and option parsing for ls (--recursive, --details), open
(--vos_path, --db_path, --write_mode), feature (--enable/--disable), dtx_aggr
(mutual-exclusion validation), close, and version.
TestManPage: verifies man page output both to stdout and to a file, using a shared
expSections list.

`main_test.go`

Tests for the CLI entry-point logic:

TestParseOpts: default option values, flag parsing (--debug, --write, --vos_path,
--db_path, --version, --cmd, --cmd_file) and error cases (conflicting
--cmd/--cmd_file, missing --vos_path when --db_path is set).
TestRun: version output, unknown command detection, noAutoOpen list (feature, open,
smd_sync), auto-open via --vos_path/--db_path, ctx.Init() failure, ctx.Open() failure.
TestRunMultiLineCommandFile: verifies that a command file with multiple commands executes
all of them in order.
TestStrToLogLevels: all supported log-level string conversions.
TestNewLogger: logger creation for each log level.
TestClosePoolIfOpen: pool-not-open, successful close, and close-error paths.

Steps for the author:

Commit message follows the guidelines.
Appropriate Features or Test-tag pragmas were used.
Appropriate Functional Test Stages were run.
At least two positive code reviews including at least one code owner from each category referenced in the PR.
Testing is complete. If necessary, forced-landing label added and a reason added in a comment.

After all prior steps are complete:

Gatekeeper requested (daos-gatekeeper added as a reviewer).

github-actions · 2026-04-22T15:46:20Z

Ticket title is 'Add unit test to ddb go code'
Status is 'In Review'
https://daosio.atlassian.net/browse/DAOS-18304

daosbuild3 · 2026-05-11T10:02:59Z

Test stage Unit Test completed with status UNSTABLE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net/job/daos-stack/job/daos//view/change-requests/job/PR-18086/11/testReport/

daosbuild3 · 2026-05-11T11:13:23Z

Test stage Unit Test completed with status UNSTABLE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net/job/daos-stack/job/daos//view/change-requests/job/PR-18086/12/testReport/

daosbuild3 · 2026-05-11T13:30:57Z

Test stage Unit Test completed with status UNSTABLE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net/job/daos-stack/job/daos//view/change-requests/job/PR-18086/14/testReport/

daosbuild3 · 2026-05-12T19:56:52Z

Test stage Functional Hardware Medium MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-18086/17/execution/node/717/log

Introduce the Go test suite for the ddb CLI layer, built on top of the build-tag CGo stub infrastructure landed in #18124: - Add test_helpers.go: newTestContext(t) resets all CGo stubs via resetDdbStubs() and returns a *DdbContext ready for use in tests. Test cases set per-function _Fn hook variables directly. - All test files carry the //go:build test_stubs tag so they only compile when the stub infrastructure is present. - TestCmds: open (default, write_mode, db_path), feature (show, enable, disable), and dtx_aggr (mutual exclusion, cmt_time, cmt_date, path). Adds skipCmdLine field for flags shared between CLI and grumble layers. - TestHelpCmds: unknown-command help flow. - TestParseOpts / TestRun: CLI-level option parsing and run() dispatch, including unknown-command detection for both command-line and command-file paths. - TestNewLogger: 6 sub-cases (default level, explicit debug, invalid level, valid LogDir, non-existent LogDir, LogDir is a file). - TestClosePoolIfOpen: Close not called when already closed, called when open, Close error tolerated. Test-tag: unittest Required-githooks: yes Signed-off-by: Cedric Koch-Hofer <cedric.koch-hofer@hpe.com>

daosbuild3 · 2026-05-19T11:01:02Z

Test stage NLT completed with status UNSTABLE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net/job/daos-stack/job/daos//view/change-requests/job/PR-18086/22/testReport/

…/daos-18304-patch-002

daosbuild3 · 2026-06-04T13:41:51Z

Test stage NLT completed with status UNSTABLE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net/job/daos-stack/job/daos//view/change-requests/job/PR-18086/40/testReport/

daosbuild3 · 2026-06-04T19:49:45Z

Test stage Functional on EL 9 completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-18086/40/execution/node/983/log

…/daos-18304-patch-002

daosbuild3 · 2026-06-07T08:05:13Z

Test stage Functional Hardware Medium MD on SSD completed with status UNSTABLE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net/job/daos-stack/job/daos//view/change-requests/job/PR-18086/41/testReport/

knard38 · 2026-06-09T08:59:32Z

All CI failures in build #41 are pre-existing infrastructure or unrelated issues:

Functional test_dfuse_daos_build_wb (FAIL): dfuse rejects libtool hard links with EOPNOTSUPP when building inside a writeback-mode dfuse mount. Tracked in DAOS-19076. Also observed on daily master build DAOS-2176 rsvc: Move distributed start/stop ops into RSVC #339 and PR DAOS-17321 ddb: Add checksum dump function to ddb vos API #18293 — confirmed not introduced by this PR.

knard38 · 2026-06-09T09:12:11Z

@daos-stack/daos-gatekeeper according to my previous comment, could you land this PR with the following commit:

title: DAOS-18304 ddb: add Go unit tests for ddb command layer
body:

Introduce the Go test suite for the ddb CLI layer, built on top of the
build-tag CGo stub infrastructure introduced with commit 86f31a2bd3:

- Add test_helpers.go: newTestContext(t) resets all CGo stubs via
  resetDdbStubs() and returns a *DdbContext ready for use in tests.
  Test cases set per-function _Fn hook variables directly.
- All test files carry the //go:build test_stubs tag so they only
  compile when the stub infrastructure is present.
- TestDdb_Cmds: open (default, write_mode, db_path), feature (show,
  enable, disable), and dtx_aggr (mutual exclusion, cmt_time, cmt_date,
  path).
- TestDdb_HelpCmds: --help output for the ls and open commands.
- TestDdb_parseOpts / TestDdb_runDdb / TestDdb_runDdbCommandFile:
  CLI-level option parsing and runDdb() dispatch, including
  unknown-command detection for both command-line and command-file paths.
- TestDdb_runFileCmds: verifies that a multi-line command file executes
  all commands in order.
- TestDdb_newLogger: 6 sub-cases (default level, explicit debug, invalid
  level, valid LogDir, non-existent LogDir, LogDir is a file).
- TestDdb_closePoolIfOpen: Close not called when already closed, called
  when open, Close error tolerated.

Extract runDdb(ctx, args) as a production function containing the core
execution logic so that tests exercise the real code path without
triggering os.Exit. main() retains only OS-level setup (SetTraceback,
DisableCStdoutBuffering).

Add AssertStringContains(t, s string, substrings ...string) to
common/test/utils.go for reuse across the control-plane test suite.

…/daos-18304-patch-002 Features: recovery

daosbuild3 · 2026-06-16T01:13:45Z

Test stage Functional Hardware Medium MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-18086/42/execution/node/1342/log

daosbuild3 · 2026-06-16T08:47:24Z

Test stage Functional Hardware Large MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-18086/42/execution/node/1473/log

…/daos-18304-patch-002 Features: recovery

daltonbohning · 2026-06-16T14:38:17Z

Removing gatekeeper since CI is still running

knard38 · 2026-06-17T06:23:53Z

Removing gatekeeper since CI is still running

My bad, I forgot to remove gatekeeper after the last merge with master.
My apologies for the disturbance.

daosbuild3 · 2026-06-17T07:24:11Z

Test stage NLT completed with status UNSTABLE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net/job/daos-stack/job/daos//view/change-requests/job/PR-18086/44/testReport/

…/daos-18304-patch-002 Features: recovery

daosbuild3 · 2026-06-17T18:29:28Z

Test stage Functional on EL 9 completed with status UNSTABLE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net/job/daos-stack/job/daos//view/change-requests/job/PR-18086/45/testReport/

…/daos-18304-patch-002 Features: recovery

daosbuild3 · 2026-06-19T04:12:20Z

Test stage Functional Hardware Medium MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-18086/46/execution/node/1389/log

daosbuild3 · 2026-06-19T05:02:43Z

Test stage Functional Hardware Medium Verbs Provider MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-18086/46/execution/node/1430/log

daosbuild3 · 2026-06-22T13:12:14Z

Test stage Functional Hardware Medium Verbs Provider MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-18086/47/execution/node/420/log

daosbuild3 · 2026-06-22T14:34:28Z

Test stage Functional Hardware Medium MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-18086/47/execution/node/461/log

…/daos-18304-patch-002 Features: recovery

daosbuild3 · 2026-06-24T01:23:09Z

Test stage Functional Hardware Medium Verbs Provider MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-18086/48/execution/node/1388/log

daosbuild3 · 2026-06-24T03:16:16Z

Test stage Functional Hardware Medium MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-18086/48/execution/node/1429/log

…/daos-18304-patch-002 Features: recovery

daosbuild3 · 2026-06-24T19:35:48Z

Test stage Functional Hardware Medium MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-18086/49/execution/node/1353/log

daosbuild3 · 2026-06-24T21:14:48Z

Test stage Functional Hardware Medium Verbs Provider MD on SSD completed with status FAILURE. https://jenkins-3.daos.hpc.amslabs.hpecorp.net//job/daos-stack/job/daos/view/change-requests/job/PR-18086/49/execution/node/1428/log

knard38 self-assigned this Apr 22, 2026

knard38 mentioned this pull request Apr 22, 2026

DAOS-18304 ddb: Introduce DdbAPI interface for Go unit testing #17967

Closed

6 tasks

knard38 force-pushed the ckochhof/fix/master/daos-18304-patch-002 branch 2 times, most recently from 628036b to c58c604 Compare April 22, 2026 14:29

knard38 force-pushed the ckochhof/fix/master/daos-18304-patch-001 branch from 3c4faba to 24d96e6 Compare April 22, 2026 14:30

knard38 force-pushed the ckochhof/fix/master/daos-18304-patch-001 branch from 24d96e6 to f81f3be Compare April 23, 2026 05:02

knard38 force-pushed the ckochhof/fix/master/daos-18304-patch-002 branch 3 times, most recently from 62c66ea to 6e01e12 Compare April 23, 2026 08:20

knard38 force-pushed the ckochhof/fix/master/daos-18304-patch-002 branch from 6e01e12 to cda7452 Compare May 11, 2026 09:10

knard38 force-pushed the ckochhof/fix/master/daos-18304-patch-002 branch from 47f06b5 to a511b14 Compare May 11, 2026 10:36

knard38 force-pushed the ckochhof/fix/master/daos-18304-patch-002 branch from a511b14 to 03189b1 Compare May 11, 2026 12:35

knard38 changed the base branch from ckochhof/fix/master/daos-18304-patch-001 to ckochhof/fix/master/daos-18304-patch-001-split May 11, 2026 12:36

knard38 mentioned this pull request May 11, 2026

DAOS-18304 ddb: Introduce DdbAPI interface and fix db_path propagation #18124

Merged

6 tasks

knard38 force-pushed the ckochhof/fix/master/daos-18304-patch-002 branch 2 times, most recently from c3dd676 to bd9f1f2 Compare May 11, 2026 15:22

Base automatically changed from ckochhof/fix/master/daos-18304-patch-001-split to master May 18, 2026 14:43

knard38 force-pushed the ckochhof/fix/master/daos-18304-patch-002 branch 3 times, most recently from f6a67bd to 8b2e76b Compare May 19, 2026 09:33

knard38 force-pushed the ckochhof/fix/master/daos-18304-patch-002 branch from 8b2e76b to 658f2f3 Compare May 19, 2026 10:18

knard38 requested review from mjmac and tanabarr May 19, 2026 12:11

Merge remote-tracking branch 'origin/master' into ckochhof/fix/master…

0d3815f

…/daos-18304-patch-002

Merge remote-tracking branch 'origin/master' into ckochhof/fix/master…

b73b5ad

…/daos-18304-patch-002

knard38 requested a review from a team June 9, 2026 08:59

knard38 mentioned this pull request Jun 9, 2026

DAOS-19122 ddb: Fix flag name collision between global and subcommand parsers #18466

Open

6 tasks

Merge remote-tracking branch 'origin/master' into ckochhof/fix/master…

9b6966c

…/daos-18304-patch-002 Features: recovery

Merge remote-tracking branch 'origin/master' into ckochhof/fix/master…

036dc71

…/daos-18304-patch-002 Features: recovery

daltonbohning removed the request for review from a team June 16, 2026 14:38

Merge remote-tracking branch 'origin/master' into ckochhof/fix/master…

20fa4d6

…/daos-18304-patch-002 Features: recovery

Merge remote-tracking branch 'origin/master' into ckochhof/fix/master…

8d0d167

…/daos-18304-patch-002 Features: recovery

Merge remote-tracking branch 'origin/master' into ckochhof/fix/master…

1beebac

…/daos-18304-patch-002 Features: recovery

Merge remote-tracking branch 'origin/master' into ckochhof/fix/master…

fb82048

…/daos-18304-patch-002 Features: recovery

Uh oh!

Conversation

knard38 commented Apr 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Overview

New Files

test_helpers.go

ddb_commands_test.go

main_test.go

Steps for the author:

After all prior steps are complete:

Uh oh!

github-actions Bot commented Apr 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

daosbuild3 commented May 11, 2026

Uh oh!

daosbuild3 commented May 11, 2026

Uh oh!

daosbuild3 commented May 11, 2026

Uh oh!

daosbuild3 commented May 12, 2026

Uh oh!

daosbuild3 commented May 19, 2026

Uh oh!

daosbuild3 commented Jun 4, 2026

Uh oh!

daosbuild3 commented Jun 4, 2026

Uh oh!

daosbuild3 commented Jun 7, 2026

Uh oh!

knard38 commented Jun 9, 2026

Uh oh!

knard38 commented Jun 9, 2026

Uh oh!

daosbuild3 commented Jun 16, 2026

Uh oh!

daosbuild3 commented Jun 16, 2026

Uh oh!

daltonbohning commented Jun 16, 2026

Uh oh!

knard38 commented Jun 17, 2026

Uh oh!

daosbuild3 commented Jun 17, 2026

Uh oh!

daosbuild3 commented Jun 17, 2026

Uh oh!

daosbuild3 commented Jun 19, 2026

Uh oh!

daosbuild3 commented Jun 19, 2026

Uh oh!

daosbuild3 commented Jun 22, 2026

Uh oh!

daosbuild3 commented Jun 22, 2026

Uh oh!

daosbuild3 commented Jun 24, 2026

Uh oh!

daosbuild3 commented Jun 24, 2026

Uh oh!

daosbuild3 commented Jun 24, 2026

Uh oh!

daosbuild3 commented Jun 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

6 participants

knard38 commented Apr 22, 2026 •

edited

Loading

`test_helpers.go`

`ddb_commands_test.go`

`main_test.go`

github-actions Bot commented Apr 22, 2026 •

edited

Loading