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… 8.times { |x| puts 1000.**(x.next).to_s << ‘.00’ }

1000.00
MEGA = 
1000000.00
GIGA = 
1000000000.00
TERA = 
1000000000000.00
PETA = 
1000000000000000.00
EXA = 
1000000000000000000.00
ZETTA = 
1000000000000000000000.00
YOTTA = 
1000000000000000000000000.00
KIBI =

Binary suffixes 8.times { |x| puts 1024.**(x.next).to_s << ‘.00’ }

1024.00
MEBI = 
1048576.00
GIBI = 
1073741824.00
TEBI = 
1099511627776.00
PEBI = 
1125899906842624.00
EXBI = 
1152921504606846976.00
ZEBI = 
1180591620717411303424.00
YOBI = 
1208925819614629174706176.00

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”



92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
 
# File 'lib/linux_stat/prettify_bytes.rb', line 92

def convert_binary(n, precision: 2)
	if n < KIBI
		"#{"%.#{precision}f" % n} byte#{?s.freeze if n != 1}"
	elsif n < MEBI
		n /= KIBI
		"#{"%.#{precision}f" % n} kibibyte#{?s.freeze if n != 1}"
	elsif n < GIBI
		n /= MEBI
		"#{"%.#{precision}f" % n} mebibyte#{?s.freeze if n != 1}"
	elsif n < TEBI
		n /= GIBI
		"#{"%.#{precision}f" % n} gibibyte#{?s.freeze if n != 1}"
	elsif n < PEBI
		n /= TEBI
		"#{"%.#{precision}f" % n} tebibyte#{?s.freeze if n != 1}"
	elsif n < EXBI
		n /= PEBI
		"#{"%.#{precision}f" % n} pebibyte#{?s.freeze if n != 1}"
	elsif n < ZEBI
		n /= EXBI
		"#{"%.#{precision}f" % n} exbiyte#{?s.freeze if n != 1}"
	elsif n < YOBI
		n /= ZEBI
		"#{"%.#{precision}f" % n} zebibyte#{?s.freeze if n != 1}"
	else
		n /= YOBI
		"#{"%.#{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”



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
 
# File 'lib/linux_stat/prettify_bytes.rb', line 48

def convert_decimal(n, precision: 2)
	if n < KILO
		"#{"%.#{precision}f" % n} byte#{?s.freeze if n != 1}"
	elsif n < MEGA
		n /= KILO
		"#{"%.#{precision}f" % n} kilobyte#{?s.freeze if n != 1}"
	elsif n < GIGA
		n /= MEGA
		"#{"%.#{precision}f" % n} megabyte#{?s.freeze if n != 1}"
	elsif n < TERA
		n /= GIGA
		"#{"%.#{precision}f" % n} gigabyte#{?s.freeze if n != 1}"
	elsif n < PETA
		n /= TERA
		"#{"%.#{precision}f" % n} terabyte#{?s.freeze if n != 1}"
	elsif n < EXA
		n /= PETA
		"#{"%.#{precision}f" % n} petabyte#{?s.freeze if n != 1}"
	elsif n < ZETTA
		n /= EXA
		"#{"%.#{precision}f" % n} exabyte#{?s.freeze if n != 1}"
	elsif n < YOTTA
		n /= ZETTA
		"#{"%.#{precision}f" % n} zettabyte#{?s.freeze if n != 1}"
	else
		n /= YOTTA
		"#{"%.#{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”



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

def convert_short_binary(n, precision: 2)
	if n < KIBI
		"#{"%.#{precision}f" % n} B"
	elsif n < MEBI
		n /= KIBI
		"#{"%.#{precision}f" % n} KiB"
	elsif n < GIBI
		n /= MEBI
		"#{"%.#{precision}f" % n} MiB"
	elsif n < TEBI
		n /= GIBI
		"#{"%.#{precision}f" % n} GiB"
	elsif n < PEBI
		n /= TEBI
		"#{"%.#{precision}f" % n} TiB"
	elsif n < EXBI
		n /= PEBI
		"#{"%.#{precision}f" % n} PiB"
	elsif n < ZEBI
		n /= EXBI
		"#{"%.#{precision}f" % n} EiB"
	elsif n < YOBI
		n /= ZEBI
		"#{"%.#{precision}f" % n} ZiB"
	else
		n /= YOBI
		"#{"%.#{precision}f" % n} 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”



136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
 
# File 'lib/linux_stat/prettify_bytes.rb', line 136

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