42 stable releases (3 major)

new 3.9.0 Nov 30, 2024
3.8.2 Mar 22, 2024
3.7.0 Mar 20, 2023
3.5.1 Sep 19, 2022
0.4.0 Nov 12, 2017

#11 in Operating systems

Download history 150265/week @ 2024-08-14 159321/week @ 2024-08-21 175729/week @ 2024-08-28 196115/week @ 2024-09-04 173086/week @ 2024-09-11 158318/week @ 2024-09-18 184050/week @ 2024-09-25 183686/week @ 2024-10-02 186118/week @ 2024-10-09 195435/week @ 2024-10-16 187641/week @ 2024-10-23 195376/week @ 2024-10-30 196980/week @ 2024-11-06 191627/week @ 2024-11-13 179377/week @ 2024-11-20 148896/week @ 2024-11-27

750,132 downloads per month
Used in 598 crates (110 directly)

MIT license

110KB
3K SLoC

os_info

Status: CI Coverage Dependency status

Project info: Docs.rs Latest version License

Project details: LoC Rust 1.60+ required

Overview

This project consists of two parts: the library that can be used to detect the operating system type (including version and bitness) and the command line tool that uses the library.

Library (os_info)

os_info usage

To use this crate, add os_info as a dependency to your project's Cargo.toml:

[dependencies]
os_info = "3"

This project has serde as an optional dependency, so if you don't need it, then you can speed up compilation disabling it:

[dependencies]
os_info = { version = "3", default-features = false }

Example

let info = os_info::get();

// Print full information:
println!("OS information: {info}");

// Print information separately:
println!("Type: {}", info.os_type());
println!("Version: {}", info.version());
println!("Bitness: {}", info.bitness());
println!("Architecture: {}", info.architecture());

Command line tool (os_info_cli)

A simple wrapper around the os_info library.

Installation

This tool can be installed using the following cargo command:

cargo install os_info_cli

os_info_cli usage

Despite being named os_info_cli during installation, it is actually named os_info. You can use the --help flag to see available options:

os_info --help

Supported operating systems

Right now, the following operating system types can be returned:

  • AIX
  • AlmaLinux
  • Alpaquita Linux
  • Alpine Linux
  • Amazon Linux AMI
  • Android
  • Arch Linux
  • Artix Linux
  • CachyOS
  • CentOS
  • Debian
  • DragonFly BSD
  • Emscripten
  • EndeavourOS
  • Fedora
  • FreeBSD
  • Garuda Linux
  • Gentoo Linux
  • HardenedBSD
  • illumos
  • Kali Linux
  • Linux
  • Mabox
  • macOS (Mac OS X or OS X)
  • Manjaro
  • Mariner
  • MidnightBSD
  • Mint
  • NetBSD
  • NixOS
  • Nobara Linux
  • OpenBSD
  • OpenCloudOS
  • openEuler (EulerOS)
  • openSUSE
  • Oracle Linux
  • Pop!_OS
  • Raspberry Pi OS
  • Red Hat Linux
  • Red Hat Enterprise Linux
  • Redox
  • Rocky Linux
  • Solus
  • SUSE Linux Enterprise Server
  • Ubuntu
  • Ultramarine Linux
  • Unknown
  • Void Linux
  • Windows

If you need support for more OS types, I am looking forward to your Pull Request.

License

os_info is licensed under the MIT license. See LICENSE for the details.

Dependencies

~0.4–9MB
~84K SLoC