Unity - an Elixir unit conversion calculator inspired by the Unix `units` utility

What else would you do on a weekend except build something no one asked for?

Have you ever used the Unix utility units? It’s one of those quiet, decades-old tools that’s amazing at doing unit math and conversion. You type in what you have, it tells you what you want. It looks something like this:

> 3 meters to feet
9.84252 feet

> 60 mph to km/h
96.56064 kilometers per hour

> 100 kg * 9.8 m/s^2
980 kilogram-meter-per-square-second

> 12 ft + 3 in to ft
12.25 feet

> 1 gallon to liters
3.785412 liters

> sqrt(9 m^2)
3 meters

> 1|3 cup to mL
78.862746 milliliters

It handles juxtaposition multiplication the way physicists expect (kg m / s^2 means (kg * m) / s^2), it does rational numbers with |, and it knows about over 150 unit types with all their SI-prefixed variants. You can search for units, ask what’s conformable with what, and pipe it into shell scripts.

But what you may not have guessed is that this Unity, a units clone written in Elixir.

It leverages the units-of-measure capabilities of Localize with the power of a NimbleParsec grammar and an expression interpreter. And it adds some things that GNU units never anticipated.

Like locale-aware output:

> locale de
Locale set to :de

> 1234.5 meter to kilometer
1,2345 Kilometer

> locale ja
Locale set to :ja

> 1 kilometer
1 キロメートル

Variable binding:

> let distance = 42.195 km
42.195 kilometers

> let time = 2 hours
2 hours

> distance / time
21.0975 kilometers per hour

> _ to mph
13.109 miles per hour

Measurement system conversion — just say where you want to go:

> 100 meter to US
0.062137 miles

> 100 fahrenheit to metric
37.777778 degrees Celsius

> 100 meter to preferred
0.062137 miles

> locale de
Locale set to :de

> 100 meter to preferred
0,1 Kilometer

And mixed-unit decomposition:

> 3.756 hours to h;min;s
3 hours, 45 minutes, 21.6 seconds

You never asked for this, and you’ll probably never need it. But when you do, you’ll find it at hex.pm/packages/unity.

Coda

I’m always looking for ways to test the boundaries of Localize. This fun project was intended just as a great way to exercise Localize.Unit and it did shine a light on two small bugs. And then somehow grew into something much more.

https://github.com/elixir-localize/unity

29 Likes

Amazing!

When anybody mentions units, I always recall brilliant The case of the 500-mile email. Reposting it here just in case anybody has missed it (or is too young to not have it missed :). Sorry for the offtopic, but I believe it’s worth it.

6 Likes

Awesome story, I’ll add that link to the README. And of course, as you knew I would:

Interactive Elixir (1.19.5) - press Ctrl+C to exit (type h() ENTER for help)
# Import the Gnu Units database (it has more units that Localize, but Localize can only
# localize what it knows. And we don't support non-linear conversions so not as many
# as Units. But its enough - Gnu Units knows about light seconds.
iex(1)> Unity.GnuUnitsImporter.import()
iex(2)> Unity.Repl.start()
Unity v0.1.0 — type "help" for commands, "quit" to exit

> let milli_light_second = 3 lightsecond / 1000
0.003 lightsecond
> milli_light_second to miles
558.847191 miles

That was fun, and gave me some more ideas for this lib.

2 Likes

Awesome! Reminded me of this tool I came across recently: GitHub - sharkdp/numbat: A statically typed programming language for scientific computations with first class support for physical dimensions and units · GitHub

3 Likes

Wow, yeah, Numbat looks the real deal (but in Rust, not Elixir of course). Unity is nothing like the scope of Numbat - but I may take some inspiration from their work. Thanks for the pointer.

I’m very unhappy with you @kevinschweikert. You sent me down a rabbit hole nearly all day. :slight_smile: But what a lot of fun it was too! (totaly said in jest as I hope you realise). Already on unity version 0.5.0.

It’s not Numbat for sure, but take a look at this - I think it’s a fair way towards the same scope, beyond the capabilities now of units. And surprisingly, I think it’s quite usable. Proper terminal handling, tab compeition, “did you mean” handling.

Here’s the Exploring Unity guide. See what you think. I’d welcome comments and suggestions.

7 Likes

BTW, you might check marcli for easy bold colored output. Just saying.

I get a 404 on the GitHub repo?

…and now its public!

2 Likes

BTW, you might check marcli for easy bold colored output. Just saying.

Ooooo, you know I’m a sucker for new fun things to try.

1 Like

Two cups of coffee and here is Unity version 0.6.0, Add (optional) marcli to your app and voila.

Example

3 Likes

i’m not sorry at all after i’ve seen what you’ve done with it :wink:

2 Likes

Dang, I’ve been programming for over 20 years and never knew units existed! Nice work as always, Kip!

This is awesome and fun. It also led me to discover some other unix utilities, yes, jot, and seq by going down the man page rabbit hole. Good times.

Also, you missed an opportunity to name it ExUnits! Surely that wouldn’t be confusing at all!

1 Like

Ha, I nearly did call it that before I realised that it would be a terrible idea.

Yeesh supports cowsay fwiw, so if you will ever decide to redo the unix built-ins, ping me, I’ll share the implementation.

Nowadays it might be very valuable for chats with AI assistants, for instance.

Ooooo more things to learn about. That’s the weekend gone then. Thanks! (Heavy irony).

1 Like

I just stumbled upon this picture somewhere on the internet and I could not help myself not to share it.

3 Likes

Unity isn’t able to reduce the algebraic result. I’ll have to look into that!

iex> Unity.Repl.start()
Unity v0.6.0 — type help for commands, quit to exit
> 32 gb / 5 tbsp
6.4 gb-per-tablespoon

> 32 gb / 5 tbsp in bit-per-cubic-meter
error: ** Error: Units "gb-per-tablespoon" and "bit-per-cubic-meter" are not convertible.
1 Like

I am truly sorry for that. I now have a great euphemism for answering my colleagues’ stupid questions like, “Any plans for this Sunday?”

Sure, man. I’m kiping this weekend funny.

4 Likes