Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shnatsel/current_platform

Find out what platform your code is running on from Rust
https://github.com/shnatsel/current_platform

compile-time platform rust

Last synced: 24 days ago
JSON representation

Find out what platform your code is running on from Rust

Awesome Lists containing this project

README

        

## `current_platform`

**Find out what platform your code is running on, in Rust:**

```rust
use current_platform::CURRENT_PLATFORM;

fn main() {
println!("Running on {}", CURRENT_PLATFORM);
}
```

will print `Running on x86_64-unknown-linux-gnu` on desktop Linux.

Platform information is resolved **at compile time,**
based on the platform for which your code is compiled.
It incurs **zero runtime cost.**

The target triple for the platform where the code was compiled is also included
as `COMPILED_ON`. It is only different from the `CURRENT_PLATFORM` if the code
was [cross-compiled.](https://en.wikipedia.org/wiki/Cross_compiler)
This is rarely useful; if in doubt, use `CURRENT_PLATFORM`.

This crate is intentionally minimal and only provides the target triples.
You can find out other properties of the platform using crates such as
[`platforms`](https://docs.rs/platforms/latest/platforms/)
(auto-generated, always up to date) or
[`target-lexicon`](https://docs.rs/target-lexicon/latest/target_lexicon/)
(more detailed but may be missing newly added or obscure platforms).