# jobslot

An implementation of the GNU make jobserver for Rust

[![CI](https://github.com/cargo-bins/jobslot/actions/workflows/main.yml/badge.svg)](https://github.com/cargo-bins/jobslot/actions/workflows/main.yml)


[![Crates.io](https://img.shields.io/crates/v/jobslot)](https://crates.io/crates/jobslot)

[Documentation](https://docs.rs/jobslot)

## Advantages over `jobserver`?

 - `jobslot` contains bug fix for [Client::configure is unsafe]
 - `jobslot` removed use of signal handling in the helper thread on unix
 - `jobslot` uses `windows-sys` on windows instead of manually declaring bindings (some of the bindings seem to be wrong)
 - `jobslot` uses `getrandom` on windows instead of making homebrew one using raw windows api
 - `jobslot::Client::from_env` can be called any number of times on Windows and Unix.

[Client::configure is unsafe]: https://github.com/alexcrichton/jobserver-rs/issues/25

## Usage

First, add this to your `Cargo.toml`:

```toml
[dependencies]
jobslot = "0.2"
```

## Use of this crate in rustc

This crate uses `getrandom` v0.2.7 on windows.
If you want to use this crate in rustc, make sure to bump `getrandom` to v0.2
to avoid pulling in different major versions of the same crate.

# License

This project is licensed under either of

 * Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or
   http://www.apache.org/licenses/LICENSE-2.0)
 * MIT license ([LICENSE-MIT](LICENSE-MIT) or
   http://opensource.org/licenses/MIT)

at your option.

### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in jobslot by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.