Struct NodeJsRelInfo

Source

pub struct NodeJsRelInfo {
    pub os: NodeJsOs,
    pub arch: NodeJsArch,
    pub ext: NodeJsPkgExt,
    pub version: String,
    pub filename: String,
    pub sha256: String,
    pub url: String,
    /* private fields */
}

Expand description

Metadata describing a single Node.js distributable

Build one with new or from_env, narrow it with the builder methods (e.g. macos, arm64), then call fetch to populate filename, sha256 and url from the downloads server

Fields§

§os: NodeJsOs

The operating system for the Node.js distributable you are targeting

§arch: NodeJsArch

The CPU architecture for the Node.js distributable you are targeting

§ext: NodeJsPkgExt

The file extension for the Node.js distributable you are targeting

§version: String

The version of Node.js you are targeting as a semver string

§filename: String

The filename of the Node.js distributable (populated after fetching)

§sha256: String

The hash for the Node.js distributable (populated after fetching)

§url: String

The fully qualified url for the Node.js distributable (populated after fetching)

Implementations§

Source §

impl NodeJsRelInfo

Source

pub fn new<T: AsRef<str>>(semver: T) -> Self

Creates a new instance using default settings

§Arguments

semver - The Node.js version you are targeting (String / &str)

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0");

Source

pub fn from_env<T: AsRef<str>>( semver: T, ) -> Result<NodeJsRelInfo, NodeJsRelInfoError>

Creates a new instance mirroring current environment based on std::env::consts::OS and std::env::consts::ARCH

§Arguments

semver - The Node.js version you are targeting (String / &str)

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::from_env("24.19.0");

Source

pub fn macos(self) -> Self

Sets instance os field to darwin

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").macos();

Source

pub fn linux(self) -> Self

Sets instance os field to linux

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").linux();

Source

pub fn windows(self) -> Self

Sets instance os field to windows

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").windows();

Source

pub fn aix(self) -> Self

Sets instance os field to aix

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").aix();

Source

pub fn x64(self) -> Self

Sets instance arch field to x64

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").x64();

Source

pub fn x86(self) -> Self

Sets instance arch field to x86

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").x86();

Source

pub fn arm64(self) -> Self

Sets instance arch field to arm64

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").arm64();

Source

pub fn armv7l(self) -> Self

Sets instance arch field to armv7l

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").armv7l();

Source

pub fn ppc64(self) -> Self

Sets instance arch field to ppc64

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").ppc64();

Source

pub fn ppc64le(self) -> Self

Sets instance arch field to ppc64le

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").ppc64le();

Source

pub fn s390x(self) -> Self

Sets instance arch field to s390x

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").s390x();

Source

pub fn tar_gz(self) -> Self

Sets instance ext field to tar.gz

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").tar_gz();

Source

pub fn tar_xz(self) -> Self

Sets instance ext field to tar.xz

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").tar_xz();

Source

pub fn zip(self) -> Self

Sets instance ext field to zip

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").zip();

Source

pub fn s7z(self) -> Self

Sets instance ext field to 7z

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").s7z();

Source

pub fn msi(self) -> Self

Sets instance ext field to msi

§Examples

use node_js_release_info::NodeJsRelInfo;
let info = NodeJsRelInfo::new("24.19.0").msi();

Source

pub async fn fetch(self) -> Result<Self, NodeJsRelInfoError>

Creates owned data from reference for convenience when chaining

Fetches Node.js metadata for specified configuration from the releases download server

§Errors

Returns InvalidVersion when version is not valid semver, UnrecognizedVersion when the release does not exist, UnrecognizedConfiguration when the release exists but ships no such os/arch/ext combination, and HttpError when the request fails

§Examples

use node_js_release_info::{NodeJsRelInfo, NodeJsRelInfoError};

#[tokio::main]
async fn main() -> Result<(), NodeJsRelInfoError> {
  let info = NodeJsRelInfo::new("24.19.0").macos().arm64().fetch().await?;
  assert_eq!(info.version, "24.19.0");
  assert_eq!(info.filename, "node-v24.19.0-darwin-arm64.tar.gz");
  assert_eq!(info.sha256, "8294b7aa9b03997481c06babf1e8b270c859358f27da57a11509afe537ac381d");
  assert_eq!(info.url, "https://nodejs.org/download/release/v24.19.0/node-v24.19.0-darwin-arm64.tar.gz");
  Ok(())
}

Source

pub async fn fetch_all(&self) -> Result<Vec<NodeJsRelInfo>, NodeJsRelInfoError>

Fetches Node.js metadata for all supported configurations from the releases download server

§Examples

use node_js_release_info::{NodeJsRelInfo, NodeJsRelInfoError};

#[tokio::main]
async fn main() -> Result<(), NodeJsRelInfoError> {
  let info = NodeJsRelInfo::new("24.19.0");
  let all = info.fetch_all().await?;
  assert_eq!(all.len(), 19);
  assert_eq!(all[2].version, "24.19.0");
  assert_eq!(all[2].filename, "node-v24.19.0-darwin-arm64.tar.gz");
  assert_eq!(all[2].sha256, "8294b7aa9b03997481c06babf1e8b270c859358f27da57a11509afe537ac381d");
  assert_eq!(all[2].url, "https://nodejs.org/download/release/v24.19.0/node-v24.19.0-darwin-arm64.tar.gz");
  Ok(())
}