yusb 0.1.2

Rust library for accessing USB devices.
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

// yusb/src/version.rs
//
// Copyright (c) 2015, David Cuddeback
//               2019, Ilya Averyanov
//               2023, Frank Pagliughi
//
// Licensed under the MIT license:
//   <LICENSE or http://opensource.org/licenses/MIT>
// This file may not be copied, modified, or distributed except according
// to those terms.
//

use libusb1_sys as ffi;
use std::{ffi::CStr, fmt, str};

/// A structure that describes the version of the underlying `libusb` library.
#[allow(missing_copy_implementations)]
pub struct LibraryVersion(&'static ffi::libusb_version);

impl LibraryVersion {
    /// Library major version.
    pub fn major(&self) -> u16 {
        self.0.major
    }

    /// Library minor version.
    pub fn minor(&self) -> u16 {
        self.0.minor
    }

    /// Library micro version.
    pub fn micro(&self) -> u16 {
        self.0.micro
    }

    /// Library nano version.
    pub fn nano(&self) -> u16 {
        self.0.nano
    }

    /// Library release candidate suffix string, e.g., `"-rc4"`.
    pub fn rc(&self) -> Option<&'static str> {
        let cstr = unsafe { CStr::from_ptr(self.0.rc) };

        match str::from_utf8(cstr.to_bytes()) {
            Ok(s) if !s.is_empty() => Some(s),
            _ => None,
        }
    }
}

impl fmt::Debug for LibraryVersion {
    fn fmt(&self, fmt: &mut fmt::Formatter) -> Result<(), fmt::Error> {
        let mut debug = fmt.debug_struct("LibraryVersion");

        debug.field("major", &self.major());
        debug.field("minor", &self.minor());
        debug.field("micro", &self.micro());
        debug.field("nano", &self.nano());
        debug.field("rc", &self.rc());

        debug.finish()
    }
}

/// Returns a structure with the version of the running libusb library.
pub fn version() -> LibraryVersion {
    let version: &'static ffi::libusb_version = unsafe { &*ffi::libusb_get_version() };
    LibraryVersion(version)
}