Skip to content
nu_plugin_ipscan

Development

Rust checks

Section titled “Rust checks”

From the repository root, run the same checks used by continuous integration:

Terminal window
cargo fmt --check
cargo test --locked
cargo clippy --all-targets --all-features --locked -- -D warnings
cargo build --locked

The Rust crate currently requires Rust 1.95.0 or newer because that is the minimum supported by Nushell 0.115.x.

Work on the documentation site

Section titled “Work on the documentation site”

The Starlight site lives in rustdoc-ipscan/ and uses the checked-in package-lock.json:

Terminal window
cd rustdoc-ipscan
npm ci
npm run dev

Use npm run build to create the production site in rustdoc-ipscan/dist/. The build first regenerates the Rust API reference from the repository’s current source, then builds the Starlight pages around it.

Rust API generation

Section titled “Rust API generation”

To regenerate only the embedded Rustdoc files:

Terminal window
cd rustdoc-ipscan
npm run rustdoc

The generated files are placed in rustdoc-ipscan/public/rustdoc/ and should not be edited by hand. Update Rust comments in ipscan/src/ or nu-plugin-ipscan/src/ and rerun the generator when the API reference needs better context.