139 releases (75 stable)

8.0.0 Oct 29, 2024
7.3.1 Sep 11, 2024
7.3.0 Jun 28, 2024
7.2.2 Mar 17, 2024
0.1.3 Mar 22, 2021

#154 in Operating systems

Download history 280/week @ 2024-07-17 310/week @ 2024-07-24 284/week @ 2024-07-31 253/week @ 2024-08-07 260/week @ 2024-08-14 240/week @ 2024-08-21 304/week @ 2024-08-28 266/week @ 2024-09-04 1132/week @ 2024-09-11 392/week @ 2024-09-18 415/week @ 2024-09-25 313/week @ 2024-10-02 334/week @ 2024-10-09 286/week @ 2024-10-16 567/week @ 2024-10-23 504/week @ 2024-10-30

1,747 downloads per month
Used in 10 crates (8 directly)

MIT and maybe GPL-3.0-only

190KB
4.5K SLoC

libmacchina

A library providing access to all sorts of system information.

Linux • macOS • Windows • NetBSD • FreeBSD • Android • OpenWrt

version docs

Disclaimer

libmacchina utilizes unsafe code in the form of calls to system libraries that haven't been natively implemented in Rust, we do this for performance reasons.

Usage

Add the following to your project's Cargo.toml file:

libmacchina = "7"

Notes

On distributions like openSUSE that use the ndb RPM database format, librpm (which is usually provided by the rpm-devel package) is required for the RPM package count readout to work.

Examples

// Let's import two of the several available types.
use libmacchina::{GeneralReadout, MemoryReadout};

fn main() {
    // Let's import the GeneralReadout trait so we
    // can fetch some general information about the host.
    use libmacchina::traits::GeneralReadout as _;

    let general_readout = GeneralReadout::new();

    // There are many more metrics we can query
    // i.e. username, distribution, terminal, shell, etc.
    let cpu_cores = general_readout.cpu_cores().unwrap(); // 8 [logical cores]
    let cpu = general_readout.cpu_model_name().unwrap();  // Intel(R) Core(TM) i5-8265U CPU @ 1.60GHz
    let uptime = general_readout.uptime().unwrap();       // 1500 [in seconds]

    // Now we'll import the MemoryReadout trait to get an
    // idea of what the host's memory usage looks like.
    use libmacchina::traits::MemoryReadout as _;

    let memory_readout = MemoryReadout::new();

    let total_mem = memory_readout.total(); // 20242204 [in kB]
    let used_mem = memory_readout.used();   // 3894880 [in kB]
}

Dependencies

~0.7–46MB
~646K SLoC