binstalk 0.28.70

The binstall toolkit (library interface)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

use std::{num::NonZeroUsize, thread::available_parallelism};

use jobslot::Client;
use tokio::sync::OnceCell;

use crate::errors::BinstallError;

#[derive(Debug)]
pub struct LazyJobserverClient(OnceCell<Client>);

impl LazyJobserverClient {
    /// This must be called at the start of the program since
    /// `Client::from_env` requires that.
    #[allow(clippy::new_without_default)]
    pub fn new() -> Self {
        // Safety:
        //
        // Client::from_env is unsafe because from_raw_fd is unsafe.
        // It doesn't do anything that is actually unsafe, like
        // dereferencing pointer.
        let opt = unsafe { Client::from_env() };
        Self(OnceCell::new_with(opt))
    }

    pub async fn get(&self) -> Result<&Client, BinstallError> {
        self.0
            .get_or_try_init(|| async {
                let ncore = available_parallelism().map(NonZeroUsize::get).unwrap_or(1);
                Ok(Client::new(ncore)?)
            })
            .await
    }
}