Struct NodeMaintainerOptions

pub struct NodeMaintainerOptions { /* private fields */ }

Implementations

impl NodeMaintainerOptions

pub fn new() -> Self

Create a new builder for NodeMaintainer.

pub fn cache(self, cache: impl AsRef<Path>) -> Self

Configure the cache location that NodeMaintainer will use.

pub fn concurrency(self, concurrency: usize) -> Self

Controls number of concurrent operations during various apply steps (resolution fetches, extractions, etc). Tuning this might help reduce memory usage.

pub fn locked(self, locked: bool) -> Self

Make the resolver error if the newly-resolved tree would defer from an existing lockfile.

pub fn script_concurrency(self, concurrency: usize) -> Self

Controls number of concurrent script executions while running run_script. This option is separate from concurrency because executing concurrent scripts is a much heavier operation.

pub fn kdl_lock( self, kdl_lock: impl IntoKdl, ) -> Result<Self, NodeMaintainerError>

Configure the KDL lockfile that NodeMaintainer will use.

If this option is not specified, NodeMaintainer will try to read the lockfile from <root>/package-lock.kdl.

pub fn npm_lock( self, npm_lock: impl AsRef<str>, ) -> Result<Self, NodeMaintainerError>

Configure the NPM lockfile that NodeMaintainer will use.

If this option is not specified, NodeMaintainer will try to read the lockfile from <root>/package-lock.json.

pub fn registry(self, registry: Url) -> Self

Registry used for unscoped packages.

Defaults to https://registry.npmjs.org.

pub fn scope_registry(self, scope: impl AsRef<str>, registry: Url) -> Self

Registry to use for a given @scope. That is, what registry to use when looking up a package like @foo/pkg. This option can be provided multiple times.

pub fn basic_auth( self, registry: Url, username: impl AsRef<str>, password: Option<impl AsRef<str>>, ) -> Self

Sets basic auth credentials for a registry.

pub fn token_auth(self, registry: Url, token: impl AsRef<str>) -> Self

Sets bearer token credentials for a registry.

pub fn legacy_auth( self, registry: Url, legacy_auth_token: impl AsRef<str>, ) -> Self

Sets the legacy, pre-encoded auth token for a registry.

pub fn root(self, path: impl AsRef<Path>) -> Self

Root directory of the project.

pub fn default_tag(self, tag: impl AsRef<str>) -> Self

Default dist-tag to use when resolving package versions.

pub fn nassun(self, nassun: Nassun) -> Self

Provide a pre-configured Nassun instance. Using this option will disable all other nassun-related configurations.

pub fn prefer_copy(self, prefer_copy: bool) -> Self

When extracting packages, prefer to copy files instead of linking them.

This option has no effect if hard linking fails (for example, if the cache is on a different drive), or if the project is on a filesystem that supports Copy-on-Write (zfs, btrfs, APFS (macOS), etc).

pub fn hoisted(self, hoisted: bool) -> Self

Use the hoisted installation mode, where all dependencies and their transitive dependencies are installed as high up in the node_modules tree as possible. This can potentially mean that packages have access to dependencies they did not specify in their package.json, but it might be useful for compatibility.

pub fn proxy(self, proxy: bool) -> Self

pub fn proxy_url( self, proxy_url: impl AsRef<str>, ) -> Result<Self, NodeMaintainerError>

pub fn no_proxy_domain(self, no_proxy_domain: impl AsRef<str>) -> Self

pub fn on_resolution_added<F>(self, f: F) -> Self

where F: Fn() + Send + Sync + 'static,

pub fn on_resolve_progress<F>(self, f: F) -> Self

where F: Fn(&Package, Duration) + Send + Sync + 'static,

pub fn on_prune_progress<F>(self, f: F) -> Self

where F: Fn(&Path) + Send + Sync + 'static,

pub fn on_extract_progress<F>(self, f: F) -> Self

where F: Fn(&Package, Duration) + Send + Sync + 'static,

pub fn on_script_start<F>(self, f: F) -> Self

where F: Fn(&Package, &str) + Send + Sync + 'static,

pub fn on_script_line<F>(self, f: F) -> Self

where F: Fn(&str) + Send + Sync + 'static,

pub async fn resolve_manifest( self, root: CorgiManifest, ) -> Result<NodeMaintainer, NodeMaintainerError>

Resolves a NodeMaintainer using an existing CorgiManifest.

pub async fn resolve_spec( self, root_spec: impl AsRef<str>, ) -> Result<NodeMaintainer, NodeMaintainerError>

Resolves a NodeMaintainer using a particular package spec (for example, foo@1.2.3 or ./root) as its “root” package.

Trait Implementations

impl Clone for NodeMaintainerOptions

fn clone(&self) -> NodeMaintainerOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for NodeMaintainerOptions

fn default() -> Self

Returns the “default value” for a type.