#byte #utility #human-readable #format #byte-size

bytesize

an utility for human-readable bytes representations

11 releases (1 stable)

1.0.0 Jun 28, 2018
0.2.4 May 8, 2018
0.2.0 Mar 24, 2018
0.1.3 Nov 13, 2016
0.0.1 Apr 19, 2015

#8 in Value formatting

Download history 8893/week @ 2019-01-20 8309/week @ 2019-01-27 10506/week @ 2019-02-03 10499/week @ 2019-02-10 8688/week @ 2019-02-17 10057/week @ 2019-02-24 8420/week @ 2019-03-03 9168/week @ 2019-03-10 7706/week @ 2019-03-17 8876/week @ 2019-03-24 9754/week @ 2019-03-31 10740/week @ 2019-04-07 9176/week @ 2019-04-14 9025/week @ 2019-04-21 9402/week @ 2019-04-28

41,070 downloads per month
Used in 44 crates (8 directly)

Apache-2.0

13KB
258 lines

ByteSize

Build Status Crates.io Version

ByteSize is an utility for human-readable byte count representation.

API Documentation

Usage

Add this to your Cargo.toml:

[dependencies]
bytesize = "1.0.0"

and this to your crate root:

extern crate bytesize;

Example

Human readable representations (SI unit and Binary unit)

#[allow(dead_code)]
fn assert_display(expected: &str, b: ByteSize) {
  assert_eq!(expected, format!("{}", b));
}

#[test]
  fn test_display() {
    assert_display("215 B", ByteSize(215));
    assert_display("215 B", ByteSize::b(215));
    assert_display("1.0 KB", ByteSize::kb(1));
    assert_display("301.0 KB", ByteSize::kb(301));
    assert_display("419.0 MB", ByteSize::mb(419));
    assert_display("518.0 GB", ByteSize::gb(518));
    assert_display("815.0 TB", ByteSize::tb(815));
    assert_display("609.0 PB", ByteSize::pb(609));
  }

  fn assert_to_string(expected: &str, b: ByteSize, si: bool) {
    assert_eq!(expected.to_string(), b.to_string_as(si));
  }

  #[test]
  fn test_to_string() {
    assert_to_string("215 B", ByteSize(215), true);
    assert_to_string("215 B", ByteSize(215), false);
  
    assert_to_string("215 B", ByteSize::b(215), true);
    assert_to_string("215 B", ByteSize::b(215), false);

    assert_to_string("1.0 kiB", ByteSize::kib(1), true);
    assert_to_string("1.0 KB", ByteSize::kib(1), false);

    assert_to_string("293.9 kiB", ByteSize::kb(301), true);
    assert_to_string("301.0 KB", ByteSize::kb(301), false);

    assert_to_string("1.0 MiB", ByteSize::mib(1), true);
    assert_to_string("1048.6 KB", ByteSize::mib(1), false);

    assert_to_string("399.6 MiB", ByteSize::mb(419), true);
    assert_to_string("419.0 MB", ByteSize::mb(419), false);

    assert_to_string("482.4 GiB", ByteSize::gb(518), true);
    assert_to_string("518.0 GB", ByteSize::gb(518), false);

    assert_to_string("741.2 TiB", ByteSize::tb(815), true);
    assert_to_string("815.0 TB", ByteSize::tb(815), false);

    assert_to_string("540.9 PiB", ByteSize::pb(609), true);
    assert_to_string("609.0 PB", ByteSize::pb(609), false);
}

Arithmetic operations

extern crate bytesize;

use bytesize::ByteSize;

fn byte_arithmetic_operator() {
  let x = ByteSize::mb(1);
  let y = ByteSize::kb(100);

  let plus = x + y;
  print!("{}", plus);

  let minus = ByteSize::tb(100) + ByteSize::gb(4);
  print!("{}", minus);
}

Dependencies