15 releases (9 breaking)

Uses old Rust 2015

0.11.0 Feb 6, 2022
0.10.3 Oct 11, 2018
0.10.2 Mar 24, 2018
0.6.0 Oct 14, 2017
0.2.1 Jul 1, 2015

#8 in Value formatting

Download history 115/week @ 2022-03-16 133/week @ 2022-03-23 61/week @ 2022-03-30 95/week @ 2022-04-06 45/week @ 2022-04-13 44/week @ 2022-04-20 169/week @ 2022-04-27 136/week @ 2022-05-04 288/week @ 2022-05-11 97/week @ 2022-05-18 93/week @ 2022-05-25 201/week @ 2022-06-01 61/week @ 2022-06-08 51/week @ 2022-06-15 66/week @ 2022-06-22 70/week @ 2022-06-29

250 downloads per month
Used in 5 crates

MIT license

220KB
5.5K SLoC

Type-safe units of measure for Rust

Build Status

Why should I care? I already have numbers...

Working with units can be very error prone. If one person is working in feet and one person is working in meters, what happens?

Doing all of your math in raw numerical types can be unsafe and downright confusing. What can we do to help?

Typed measurements to the rescue!

Working in typed measurements increases safety by dealing with what you really care about: units of measure.

Conversions to and from different units are simple, and operator overrides allow you to work with the measurements directly.

Currently available measurement types

  • Acceleration
  • Angle
  • Angular Velocity
  • Area
  • Current
  • Data (bytes, etc)
  • Density
  • Energy
  • Force
  • Frequency
  • Length
  • Humidity
  • Mass
  • Power
  • Pressure
  • Resistance
  • Speed
  • Temperature
  • Torque
  • Voltage
  • Volume

Examples

In your Cargo.toml add the dependency...

[dependencies]
measurements = "0.11"

In your code...

extern crate measurements;

use measurements::{Length, Pressure, Temperature, Volume, Weight};

fn main() {
    // Lengths!
    let football_field = Length::from_yards(100.0);
    let meters = football_field.as_meters();
    println!("There are {} meters in a football field.", meters);

    /// Temperatures!
    let boiling_water = Temperature::from_celsius(100.0);
    let fahrenheit = boiling_water.as_fahrenheit();
    println!("Boiling water measures at {} degrees fahrenheit.", fahrenheit);

    // Weights!
    let metric_ton = Weight::from_metric_tons(1.0);
    let united_states_tons = metric_ton.as_short_tons();
    let united_states_pounds = metric_ton.as_pounds();
    println!("One metric ton is {} U.S. tons - that's {} pounds!", united_states_tons, united_states_pounds);

    // Volumes!
    let gallon = Volume::from_gallons(1.0);
    let pint = Volume::from_pints(1.0);
    let beers = gallon / pint;
    println!("A gallon of beer will pour {:.1} pints!", beers);

    // Pressures!
    let atmosphere = Pressure::from_atmospheres(1.0);
    println!("Earth's atmosphere is usually {} psi", atmosphere.as_psi());
}

Features

The crate contains few features to disable or enable certain functionalities:

  • std
    • Enables functionality that Rust standard library provides instead of using libm for some math functions
  • from_str
    • Allows creating measurement units from string input

References

I am by no means a measurement or math expert, I simply wanted to do something useful while learning Rust. Thank you to these sites and their authors for the great reference material used in building this library.

Dependencies

~0.4–0.8MB
~19K SLoC