Struct NpmCommand 

pub struct NpmCommand { /* private fields */ }

A validated package-manager executable plus its fixed argument prefix.

Implementations

impl NpmCommand

pub fn resolve(cwd: &Path, project_trusted: bool) -> Result<Self, String>

Resolve the effective command using .rpi, .pi, global, then npm. Project settings are considered only after the project trust gate has passed because npmCommand can name an arbitrary executable.

pub fn from_argv(argv: Option<&[String]>) -> Result<Self, String>

Build a command from Pi’s optional argv setting. A missing or empty array selects the platform npm launcher. A blank executable is invalid and never falls back to another command.

pub fn program(&self) -> &str

Executable launched as an argv command. Windows .cmd/.bat shims use the standard library’s hardened batch argument encoding.

pub fn prefix_args(&self) -> &[String]

Fixed arguments configured before each package-manager operation.

pub fn is_configured(&self) -> bool

Whether the effective command came from an explicit npmCommand.

pub fn manager_kind(&self) -> NpmManagerKind

Package-manager family used for manager-specific install flags.

pub fn combined_args(&self, operation_args: &[String]) -> Vec<String>

Prepend the fixed configured argv to one operation’s arguments.

pub fn view_args(&self, source_spec: &str) -> Result<Vec<String>, String>

Construct the complete argv for native Pi’s registry version lookup.

pub fn install_args(&self, specs: &[String], install_root: &Path) -> Vec<String>

Construct manager-specific operation args for a managed npm root. These match native Pi’s getNpmInstallArgs ordering exactly.

pub fn uninstall_args( &self, package_name: &str, install_root: &Path, ) -> Vec<String>

Construct manager-specific arguments for removing one package from a managed npm root. The ordering and flags match native Pi’s uninstallNpm implementation.

pub fn global_package_roots(&self) -> Result<Vec<PathBuf>, String>

Resolve the package-manager’s legacy global install root(s).

Native Pi uses the configured npmCommand for this lookup. The result is intentionally read-only metadata: callers may use it to discover a package that predates Pi’s managed store, but must not use it as an rpi-owned install or removal root. Every returned path is absolute, canonical, an existing directory, and ends in node_modules.

pub fn global_package_paths( &self, package_names: &[String], ) -> Result<HashMap<String, PathBuf>, String>

Locate packages in a legacy global install with one package-manager query for the whole batch.

npm/bun use <global root>/<package name>. pnpm reports the concrete virtual-store path through list -g --depth 0 --json, so that output is parsed instead of guessing a symlink layout. Returned paths are canonical read-only discovery paths; package updates must migrate into the rpi/native managed root before writing anything.

pub fn global_package_path( &self, package_name: &str, ) -> Result<Option<PathBuf>, String>

Locate one package using the same validation and bounded lookup as the batch API.

pub fn validate_global_package_path( root: &Path, package_name: &str, ) -> Option<PathBuf>

Validate a command output path without executing a package manager. This is useful to callers that cache global-root discovery and to tests; it does not grant write or delete authority.

Trait Implementations

impl Clone for NpmCommand

fn clone(&self) -> NpmCommand

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NpmCommand

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for NpmCommand

impl PartialEq for NpmCommand

fn eq(&self, other: &NpmCommand) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for NpmCommand