File: bu.sh 1 #!/bin/sh 2 3 # The MIT License (MIT) 4 # 5 # Copyright © 2024 pacman64 6 # 7 # Permission is hereby granted, free of charge, to any person obtaining a copy 8 # of this software and associated documentation files (the “Software”), to deal 9 # in the Software without restriction, including without limitation the rights 10 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 11 # copies of the Software, and to permit persons to whom the Software is 12 # furnished to do so, subject to the following conditions: 13 # 14 # The above copyright notice and this permission notice shall be included in 15 # all copies or substantial portions of the Software. 16 # 17 # THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 18 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 19 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 20 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 21 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 22 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 23 # SOFTWARE. 24 25 26 # bu [time] 27 # bu [quantity] [unit] 28 # bu [quantity] ft [quantity] in 29 # bu [quantity] lb [quantity] oz 30 # 31 # Better Units 32 # 33 # 34 # Turn common measurement units used in the US into their international 35 # counterparts. Even the mixed-unit cases ft-in and lb-oz are accepted, 36 # when given 2 number-unit pairs. 37 # 38 # Besides those, time units in common use, such as minutes, hours, days, 39 # and weeks have been added for convenience: these are all turned into 40 # seconds. 41 # 42 # Even time-formats HH:MM:SS and MM:SS are supported: the seconds part 43 # can optionally have decimal digits, and no unit is needed, as those 44 # formats clearly identify their time-related units by themselves. 45 # 46 # 47 # You may also want to use the shortcut below, instead of using this 48 # script directly. 49 # 50 # # Change Units converts common units into more convenient equivalents 51 # cu() { bu "$@" | awk '{ print $(NF-1), $NF }'; } 52 53 54 # handle help options 55 case "$1" in 56 -h|--h|-help|--help) 57 awk '/^# +bu/, /^$/ { gsub(/^# ?/, ""); print }' "$0" 58 exit 0 59 ;; 60 esac 61 62 if [ -z "$1" ]; then 63 awk '/^# +bu/, /^$/ { gsub(/^# ?/, ""); print }' "$0" 64 exit 0 65 fi 66 67 # normalize the unit name right away, to avoid re-running the same apps 68 unitname="$(echo "${2}" | tr "[:upper:]" "[:lower:]" | tr -d - | tr -d _)" 69 70 case "${unitname}" in 71 # handle that mixed-unit abomination using feet and inches 72 ft|feet|foot) 73 case "$(echo "${4}" | tr "[:upper:]" "[:lower:]")" in 74 in|inch|inches) 75 y=$(echo "scale=4; 0.3048*${1} + 0.0254*${3}" | bc) 76 printf "%12.4f ft %12.4f in = %12.4f m\n" \ 77 "${1}" "${3}" "${y}" 78 exit $? 79 ;; 80 esac 81 ;; 82 83 # handle hertz, megahertz, and gigahertz: even some old-fashioned names 84 # are supported; the name `cycle` is handled as an angular unit instead 85 hz|hertz) 86 y=$(echo "scale=4; 1/${1}" | bc) 87 printf "%12.4f hz = %12.4f s\n" "${1}" "${y}" 88 exit $? 89 ;; 90 mhz|megahertz|megacycle|megacycles) 91 y=$(echo "scale=12; 1/(1000000*${1})" | bc) 92 printf "%12.4f hz = %12.12f s\n" "${1}" "${y}" 93 exit $? 94 ;; 95 ghz|gigahertz|gigacycle|gigacycles) 96 y=$(echo "scale=12; 1/(1000000000*${1})" | bc) 97 printf "%12.4f hz = %12.12f s\n" "${1}" "${y}" 98 exit $? 99 ;; 100 101 # handle that mixed-unit abomination using pounds and weight-ounces 102 lb|lbs|pound|pounds) 103 case "$(echo "${4}" | tr "[:upper:]" "[:lower:]")" in 104 oz|ozs|ounce|ounces) 105 y=$(echo "scale=4; 0.45359237*${1} + 0.028349523*${3}" | bc) 106 printf "%12.4f lb %12.4f oz = %12.4f kg\n" \ 107 "${1}" "${3}" "${y}" 108 exit $? 109 ;; 110 esac 111 ;; 112 113 # handle converting numbers from base 2 into base-10 ones 114 bin|binary|base2|b2|0b|bit|bits|2) 115 # check for valid binary values, quitting whole script on failure 116 if echo "$1" | grep -E -q '.*[^01].*'; then 117 printf "\x1b[31minvalid binary number %s\x1b[0m\n" "$1" \ 118 > "/dev/stderr" 119 exit 1 120 fi 121 122 decval=$(echo "ibase=2; ${1}" | bc) 123 printf "%s bin = %s dec\n" "${1}" "${decval}" 124 exit $? 125 ;; 126 127 # handle converting numbers from base 8 into base-10 ones 128 oct|octal|base8|b8|0o|o|8) 129 # check for valid binary values, quitting whole script on failure 130 if echo "$1" | grep -E -q '.*[^0-7].*'; then 131 printf "\x1b[31minvalid octal number %s\x1b[0m\n" "$1" \ 132 > "/dev/stderr" 133 exit 1 134 fi 135 136 decval=$(echo "ibase=8; ${1}" | bc) 137 printf "%s oct = %s dec\n" "${1}" "${decval}" 138 exit $? 139 ;; 140 141 # handle converting numbers from base 16 into base-10 ones 142 hex|hexa|hexadec|hexadecimal|base16|b16|0x|x|16) 143 hexval=$(echo "${1}" | sed 's-^0x--' | tr '[:lower:]' '[:upper:]') 144 if echo "${hexval}" | grep -E -q '.*[^0-9a-fA-F].*'; then 145 printf "\x1b[31minvalid octal number %s\x1b[0m\n" "$1" \ 146 > "/dev/stderr" 147 exit 1 148 fi 149 150 decval=$(echo "ibase=16; ${hexval}" | bc) 151 printf "%s hex = %s dec\n" "${hexval}" "${decval}" 152 exit $? 153 ;; 154 esac 155 156 # warn users who might wrongly think multiple pairs of args are allowed 157 # in general: only ft/in and lb/oz are allowed 158 if [ $# -gt 2 ]; then 159 printf "\x1b[31m" >&2 160 printf "only 1 or 2 args allowed, unless using ft/in or " >&2 161 printf "lb/oz mixed-units value-pairs" >&2 162 printf "\x1b[0m\n" >&2 163 exit 1 164 fi 165 166 # handle all other unit-conversions 167 awk -v x="${1}" -v unit="${unitname}" ' 168 # normalize both quantities and units, and handle special cases for units 169 BEGIN { 170 # ignore underscores in numbers, thus `allowing` them for convenience 171 gsub(/[_]/, "", x) 172 173 # normalize unit names for later lookup 174 unit = tolower(unit) 175 gsub(/[ _.-]/, "", unit) 176 177 # handle fahrenheit temperatures 178 if (unit == "f" || unit == "fahrenheit") { 179 printf "%12.4f °F = %12.4f °C\n", x, (x - 32) * (5.0/9.0) 180 ok = 1 181 exit 0 182 } 183 184 # handle kelvin temperatures 185 if (unit == "k" || unit == "kelvin") { 186 printf "%12.4f °K = %12.4f °C\n", x, x - 273.15 187 ok = 1 188 exit 0 189 } 190 191 # handle the mm:ss time format 192 if (match(x, /^[0-9]+:[0-9]{1,2}(\.[0-9]*)?$/)) { 193 split(x, hms, ":") 194 printf "%s = %12.4f s\n", x, 60*hms[1] + hms[2] 195 ok = 1 196 exit 0 197 } 198 199 # handle the hh:mm:ss time format 200 if (match(x, /^[0-9]+:[0-9]{1,2}:[0-9]{1,2}(\.[0-9]*)?$/)) { 201 split(x, hms, ":") 202 printf "%s = %12.4f s\n", x, 3600*hms[1] + 60*hms[2] + hms[3] 203 ok = 1 204 exit 0 205 } 206 207 # handle seconds, turning the number into the hh:mm:ss time format 208 if (unit == "s") { 209 h = (x - x % 3600) / 3600 210 m = (x % 3600) / 60 211 s = x % 60 212 printf "%s s = %02d:%02d:%05.2f\n", x, h, m, s 213 ok = 1 214 exit 0 215 } 216 } 217 218 # match the unit given to its built-in entry, if present 219 $1 == unit { 220 printf "%12.4f %s = %12.4f %s\n", x, $2, $3*x, $4 221 ok = 1 222 exit 0 223 } 224 225 # tell user when no match was found, and fail the whole surrounding tool if so 226 END { 227 if (!ok) { 228 fs = "\x1b[31munit name/alias `%s` not supported\n\x1b[0m" 229 printf fs, unit > "/dev/stderr" 230 exit 1 231 } 232 } 233 ' << 'EOF' 234 ac ac 4046.8564224 m² 235 acre ac 4046.8564224 m² 236 acres ac 4046.8564224 m² 237 angle deg 0.0174532925199 rad 238 andeg deg 0.0174532925199 rad 239 angdeg deg 0.0174532925199 rad 240 angular deg 0.0174532925199 rad 241 angulardeg deg 0.0174532925199 rad 242 angulardegree deg 0.0174532925199 rad 243 angulardegrees deg 0.0174532925199 rad 244 angledeg deg 0.0174532925199 rad 245 angledegree deg 0.0174532925199 rad 246 angledegrees deg 0.0174532925199 rad 247 barrel bbl 158.9873 L 248 barrels bbl 158.9873 L 249 bbl bbl 158.9873 L 250 cfeet ft³ 0.028316846592 m³ 251 cfoot ft³ 0.028316846592 m³ 252 cft ft³ 0.028316846592 m³ 253 cufeet ft³ 0.028316846592 m³ 254 cufoot ft³ 0.028316846592 m³ 255 cuft ft³ 0.028316846592 m³ 256 cup cup 0.23658824 L 257 cups cup 0.23658824 L 258 cyc tr 6.2831853071796 rad 259 cycle tr 6.2831853071796 rad 260 cycles tr 6.2831853071796 rad 261 d day 86400 s 262 day day 86400 s 263 days day 86400 s 264 deg deg 0.0174532925199 rad 265 degree deg 0.0174532925199 rad 266 degrees deg 0.0174532925199 rad 267 in in 2.54 cm 268 inch in 2.54 cm 269 inches in 2.54 cm 270 ft ft 0.3048 m 271 ft2 ft² 0.09290304 m² 272 ft3 ft³ 0.028316846592 m³ 273 ft² ft² 0.09290304 m² 274 ft³ ft³ 0.028316846592 m³ 275 feet ft 0.3048 m 276 feet2 ft² 0.09290304 m² 277 feet3 ft³ 0.028316846592 m³ 278 feet² ft² 0.09290304 m² 279 feet³ ft³ 0.028316846592 m³ 280 floz floz 29.5735295625 mL 281 foot ft 0.3048 m 282 foot2 ft² 0.09290304 m² 283 foot3 ft³ 0.028316846592 m³ 284 foot² ft² 0.09290304 m² 285 foot³ ft³ 0.028316846592 m³ 286 ga gal 3.785411784 L 287 gal gal 3.785411784 L 288 gallon gal 3.785411784 L 289 gallons gal 3.785411784 L 290 gb gb 1073741824 bytes 291 gib gb 1073741824 bytes 292 gon grad 0.0157079632679 rad 293 gons grad 0.0157079632679 rad 294 grad grad 0.0157079632679 rad 295 gradian grad 0.0157079632679 rad 296 gradians grad 0.0157079632679 rad 297 h hr 3600 s 298 hour hr 3600 s 299 hours hr 3600 s 300 hr hr 3600 s 301 hrs hr 3600 s 302 kb kb 1024 bytes 303 kib kb 1024 bytes 304 lb lb 0.45359237 kg 305 lbs lb 0.45359237 kg 306 mb mb 1048576 bytes 307 mi mi 1.609344 km 308 mib mb 1048576 bytes 309 mih mph 1.609344 kph 310 mi2 mi² 2.5899881103360 km² 311 mi² mi² 2.5899881103360 km² 312 mil mrad 0.001 rad 313 millirad mrad 0.001 rad 314 milliradian mrad 0.001 rad 315 milliradians mrad 0.001 rad 316 mile mi 1.609344 km 317 mile² mi² 2.5899881103360 km² 318 miles mi 1.609344 km 319 miles² mi² 2.5899881103360 km² 320 min min 60 s 321 minute min 60 s 322 minutes min 60 s 323 mpg mpg 0.425143707 kpl 324 mph mph 1.609344 kph 325 mrad mrad 0.001 rad 326 nmi nmi 1.852 km 327 nmile nmi 1.852 km 328 nmiles nmi 1.852 km 329 oilbarrel bbl 158.9873 L 330 oilbarrels bbl 158.9873 L 331 oz oz 28.349523125 g 332 ounce oz 28.349523125 g 333 ounces oz 28.349523125 g 334 pint pt 473.176473 mL 335 pla tr 6.2831853071796 rad 336 pound lb 0.45359237 kg 337 pounds lb 0.45359237 kg 338 psi psi 6894.757293168 Pa 339 pt pt 473.176473 mL 340 rad rad 57.295779513082 deg 341 radian rad 57.295779513082 deg 342 radians rad 57.295779513082 deg 343 rev tr 6.2831853071796 rad 344 revolution tr 6.2831853071796 rad 345 revolutions tr 6.2831853071796 rad 346 sfeet ft² 0.09290304 m² 347 sfoot ft² 0.09290304 m² 348 sft ft² 0.09290304 m² 349 smi mi² 2.5899881103360 km² 350 smile mi² 2.5899881103360 km² 351 smiles mi² 2.5899881103360 km² 352 syard yd² 0.83612736 m² 353 syards yd² 0.83612736 m² 354 syd yd² 0.83612736 m² 355 syds yd² 0.83612736 m² 356 sqfeet ft² 0.09290304 m² 357 sqfoot ft² 0.09290304 m² 358 sqft ft² 0.09290304 m² 359 sqmi mi² 2.5899881103360 km² 360 sqmile mi² 2.5899881103360 km² 361 sqmiles mi² 2.5899881103360 km² 362 sqyard yd² 0.83612736 m² 363 sqyards yd² 0.83612736 m² 364 sqyd yd² 0.83612736 m² 365 sqyds yd² 0.83612736 m² 366 tb tb 1099511627776 bytes 367 tib tb 1099511627776 bytes 368 ton ton 907.18474 kg 369 tr tr 6.2831853071796 rad 370 turn tr 6.2831853071796 rad 371 turns tr 6.2831853071796 rad 372 ukpint ukpt 568.26125 mL 373 ukpt ukpt 568.26125 mL 374 uspint pt 473.176473 mL 375 uspt pt 473.176473 mL 376 w wk 604800 s 377 week wk 604800 s 378 weeks wk 604800 s 379 wk wk 604800 s 380 wks wk 604800 s 381 yard yd 0.9144 m 382 yard2 yd² 0.83612736 m² 383 yards yd 0.9144 m 384 yards2 yd² 0.83612736 m² 385 yd yd 0.9144 m 386 yds yd 0.9144 m 387 yd² yd² 0.83612736 m² 388 yds² yd² 0.83612736 m² 389 EOF