NAME

cpan - private built-in command wrapper for Developer Dashboard

SYNOPSIS

dashboard cpan <Module...>

DESCRIPTION

This private helper is staged under ~/.developer-dashboard/cli/dd/ so the public dashboard entrypoint can stay a thin switchboard.

PURPOSE

This staged helper exposes dashboard cpan, the runtime-local dependency installer. It lets a project or home runtime add optional Perl modules such as DBD::SQLite or DBD::ODBC without changing the base distribution dependencies.

WHY IT EXISTS

It exists because the dashboard intentionally does not bundle every optional database driver or feature dependency. The staged helper gives users a first-class way to extend their runtime locally while keeping the base install small.

WHEN TO USE

Use this file when changing the CLI contract for runtime-local dependency installation, driver convenience behavior such as DBD::* handling, or the handoff into the dependency-management implementation.

HOW TO USE

Users run dashboard cpan <Module...> from the runtime they want to extend. The staged helper forwards that request into the private runtime, which updates the runtime-local cpanfile and installs into local/.

WHAT USES IT

It is used by developers enabling optional SQL dashboard drivers and by tests and docs that verify runtime-local dependency installation instead of shipping those modules by default.

EXAMPLES

Example 1:

dashboard cpan DBD::SQLite

Run the public built-in command path that stages or re-enters this helper.

Example 2:

~/.developer-dashboard/cli/dd/cpan --help

Inspect the staged helper directly after dashboard init or helper extraction has populated the home runtime.

Example 3:

prove -lv t/05-cli-smoke.t t/30-dashboard-loader.t

Rerun the focused staged-helper and thin-loader tests after changing helper dispatch behavior.

Example 4:

prove -lr t

Verify that the helper still behaves correctly inside the complete repository suite.