Struct NuCryptoProvider

pub struct NuCryptoProvider(/* private fields */);

Stores the crypto provider used by rustls.

This struct lives in the CRYPTO_PROVIDER static.
It can’t be created manually.

Purpose

Nushell does not use the global rustls crypto provider.
You must set a provider here—otherwise, any networking command that uses rustls won’t be able to build a TLS connector.

This only matters if the rustls-tls feature is enabled.
Builds with native-tls ignore this completely.

How to set the provider

• NuCryptoProvider::default
  Uses a built-in provider that works with official nu builds.
  This might change in future versions.

• NuCryptoProvider::set
  Lets you provide your own CryptoProvider using a closure:

  use nu_command::tls::CRYPTO_PROVIDER;
  
  // Call once at startup
  CRYPTO_PROVIDER.set(|| Ok(rustls::crypto::ring::default_provider()));

Only the first successful call takes effect. Later calls do nothing and return false.

Implementations

impl NuCryptoProvider

pub fn get(&self) -> Result<Arc<CryptoProvider>, ShellError>

Returns the current CryptoProvider.

Comes from the first call to default or set.

Errors

• If no provider was set.
• If the set closure returned an error.

pub fn set( &self, f: impl FnOnce() -> Result<CryptoProvider, ShellError>, ) -> bool

Sets a custom CryptoProvider.

Call once at startup, before any TLS code runs.
The closure runs immediately and the result (either Ok or Err) is stored.
Returns whether the provider was stored successfully.

pub fn default(&self) -> bool

Sets a default CryptoProvider used in official nu builds.

Should work on most systems, but may not work in every setup.
If it fails, use set to install a custom one.
Returns whether the provider was stored successfully.

Trait Implementations

impl Debug for NuCryptoProvider

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

Formats the value using the given formatter.