Module: LinuxStat::PrettifyBytes

Defined in:
lib/linux_stat/prettify_bytes.rb

Overview

Helps you convert bytes to a unit like:

  1. kilobyte, megabyte, gigabyte, terabyte, petabyte, exabyte, zettabyte, yottabyte

  2. kibibyte, mebibyte, gibibyte, tebibyte, pebibyte, exbibyte, zebibyte, yobibyte

  3. kB, MB, GB, TB, PB, EB, ZB, YB

  4. kiB, MiB, GiB, TiB, PiB, EiB, ZiB, YiB

Constant Summary collapse

KILO =

Kilo = Kilobyte (1000 - 1), and so on…

1e3
MEGA = 
1e6
GIGA = 
1e9
TERA = 
1e12
PETA = 
1e15
EXA = 
1e18
ZETTA = 
1e21
YOTTA = 
1e24
KIBI =

Binary suffixes

1024.0
MEBI = 
KIBI ** 2
GIBI = 
KIBI ** 3
TEBI = 
KIBI ** 4
PEBI = 
KIBI ** 5
EXBI = 
KIBI ** 6
ZEBI = 
KIBI ** 7
YOBI = 
KIBI ** 8

Class Method Summary collapse

Class Method Details

.convert_binary(n, precision: 2) ⇒ Object

Converts a number to binary byte units and outputs with the IEC prefix For example,

LinuxStat::PrettifyBytes.convert_binary(1000)

> “1000.0 bytes”

LinuxStat::PrettifyBytes.convert_binary(1000 ** 3)

> “953.67 mebibytes”

LinuxStat::PrettifyBytes.convert_binary(1024 ** 3)

> “1.0 gibibyte”



98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
 
# File 'lib/linux_stat/prettify_bytes.rb', line 98

def convert_binary(n, precision: 2)
	if n < KIBI
		%Q(#{"%.#{precision}f" % n} byte#{?s.freeze if n != 1})
	elsif n < MEBI
		n /= KIBI
		n = n.round(precision)
		%Q(#{"%.#{precision}f" % n} kibibyte#{?s.freeze if n != 1})
	elsif n < GIBI
		n /= MEBI
		n = n.round(precision)
		%Q(#{"%.#{precision}f" % n} mebibyte#{?s.freeze if n != 1})
	elsif n < TEBI
		n /= GIBI
		n = n.round(precision)
		%Q(#{"%.#{precision}f" % n} gibibyte#{?s.freeze if n != 1})
	elsif n < PEBI
		n /= TEBI
		n = n.round(precision)
		%Q(#{"%.#{precision}f" % n} tebibyte#{?s.freeze if n != 1})
	elsif n < EXBI
		n /= PEBI
		n = n.round(precision)
		%Q(#{"%.#{precision}f" % n} pebibyte#{?s.freeze if n != 1})
	elsif n < ZEBI
		n /= EXBI
		n = n.round(precision)
		%Q(#{"%.#{precision}f" % n} exbiyte#{?s.freeze if n != 1})
	elsif n < YOBI
		n /= ZEBI
		n = n.round(precision)
		%Q(#{"%.#{precision}f" % n} zebibyte#{?s.freeze if n != 1})
	else
		n /= YOBI
		n = n.round(precision)
		%Q(#{"%.#{precision}f" % n} yobibyte#{?s.freeze if n != 1})
	end
end

.convert_decimal(n, precision: 2) ⇒ Object

Converts a number to decimal byte units and outputs with the metric prefix For example,

LinuxStat::PrettifyBytes.convert_decimal(1000)

> “1.0 kilobyte”

LinuxStat::PrettifyBytes.convert_decimal(1000 ** 3)

> “1.0 gigabyte”

LinuxStat::PrettifyBytes.convert_decimal(1024 ** 3)

> “1.07 gigabytes”



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
71
72
73
74
75
76
77
78
79
80
81
82
 
# File 'lib/linux_stat/prettify_bytes.rb', line 46

def convert_decimal(n, precision: 2)
	if n < KILO
		"#{"%.#{precision}f" % n} byte#{?s.freeze if n != 1}"
	elsif n < MEGA
		n /= KILO
		n = n.round(precision)
		%(#{"%.#{precision}f" % n} kilobyte#{?s.freeze if n. != 1})
	elsif n < GIGA
		n /= MEGA
		n = n.round(precision)
		%(#{"%.#{precision}f" % n} megabyte#{?s.freeze if n != 1})
	elsif n < TERA
		n /= GIGA
		n = n.round(precision)
		%(#{"%.#{precision}f" % n} gigabyte#{?s.freeze if n != 1})
	elsif n < PETA
		n /= TERA
		n = n.round(precision)
		%(#{"%.#{precision}f" % n} terabyte#{?s.freeze if n != 1})
	elsif n < EXA
		n /= PETA
		n = n.round(precision)
		%(#{"%.#{precision}f" % n} petabyte#{?s.freeze if n != 1})
	elsif n < ZETTA
		n /= EXA
		n = n.round(precision)
		%(#{"%.#{precision}f" % n} exabyte#{?s.freeze if n != 1})
	elsif n < YOTTA
		n /= ZETTA
		n = n.round(precision)
		%(#{"%.#{precision}f" % n} zettabyte#{?s.freeze if n != 1})
	else
		n /= YOTTA
		n = n.round(precision)
		%(#{"%.#{precision}f" % n} yottabyte#{?s.freeze if n != 1})
	end
end

.convert_short_binary(n, precision: 2) ⇒ Object

Converts a number to binary byte units

For example,

LinuxStat::PrettifyBytes.convert_short_binary(1000)

> “1000 B”

LinuxStat::PrettifyBytes.convert_short_binary(1000 ** 3)

> “953.67 MiB”

LinuxStat::PrettifyBytes.convert_short_binary(1024 ** 3)

> “1.0 GiB”



188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
 
# File 'lib/linux_stat/prettify_bytes.rb', line 188

def convert_short_binary(n, precision: 2)
	if n < KIBI
		%(#{"%.#{precision}f" % n} B)
	elsif n < MEBI
		%(#{"%.#{precision}f" % n.fdiv(KIBI)} KiB)
	elsif n < GIBI
		%(#{"%.#{precision}f" % n.fdiv(MEBI)} MiB)
	elsif n < TEBI
		%(#{"%.#{precision}f" % n.fdiv(GIBI)} GiB)
	elsif n < PEBI
		%(#{"%.#{precision}f" % n.fdiv(TEBI)} TiB)
	elsif n < EXBI
		%(#{"%.#{precision}f" % n.fdiv(PEBI)} PiB)
	elsif n < ZEBI
		%(#{"%.#{precision}f" % n.fdiv(EXBI)} EiB)
	elsif n < YOBI
		%(#{"%.#{precision}f" % n.fdiv(ZEBI)} ZiB)
	else
		%(#{"%.#{precision}f" % n.fdiv(YOBI)} YiB)
	end
end

.convert_short_decimal(n, precision: 2) ⇒ Object

Converts a number to decimal byte units For example,

LinuxStat::PrettifyBytes.convert_short_decimal(1000)

> “1.0 kB”

LinuxStat::PrettifyBytes.convert_short_decimal(1000 ** 3)

> “1.0 GB”

LinuxStat::PrettifyBytes.convert_short_decimal(1024 ** 3)

> “1.07 GB”



150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
 
# File 'lib/linux_stat/prettify_bytes.rb', line 150

def convert_short_decimal(n, precision: 2)
	if n < KILO
		"#{"%.#{precision}f" % n} B"
	elsif n < MEGA
		%(#{"%.#{precision}f" % n.fdiv(KILO)} kB)
	elsif n < GIGA
		%(#{"%.#{precision}f" % n.fdiv(MEGA)} MB)
	elsif n < TERA
		%(#{"%.#{precision}f" % n.fdiv(GIGA)} GB)
	elsif n < PETA
		%(#{"%.#{precision}f" % n.fdiv(TERA)} TB)
	elsif n < EXA
		%(#{"%.#{precision}f" % n.fdiv(PETA)} PB)
	elsif n < ZETTA
		%(#{"%.#{precision}f" % n.fdiv(EXA)} EB)
	elsif n < YOTTA
		%(#{"%.#{precision}f" % n.fdiv(ZETTA)} ZB)
	else
		%(#{"%.#{precision}f" % n.fdiv(YOTTA)} YB)
	end
end