unitscale

Crates.iounitscale
lib.rsunitscale
version0.1.7
created_at2025-04-11 02:12:56.400202+00
updated_at2025-04-15 20:26:32.870384+00
descriptionFacade crate for statically-scaled unit macros and traits.
homepage
repositoryhttps://gitlab.com/goosegrid/unitscale
max_upload_size
id1629130
size19,824
David Kalliecharan (ddkn)

documentation

https://docs.rs/unitscale

README

unitscale

Overview

This is the public-facing facade crate that re-exports the traits and macros from unitscale_core and unitscale_macros. It is designed to be ergonomic and beginner-friendly.

Modules

  • core: Exposes all traits and types from unitscale_core.
  • macros: Exposes macros from unitscale_macros.
  • prelude: Contains common re-exports for quick onboarding.

Example

You will need to add unitscale_core and num_traits to your dependancies.

use unitscale::prelude::*;

#[unit_scale(to = 0.5)]
struct HalfUnit;

#[unit_data]
struct Percent;

let p = Percent::<HalfUnit, u8>::try_from(30.0).unwrap();
// v.to_f64() gives back 30.0 within the precision limit of the type (e.g. u8)
assert_eq!(p.scaled_value(), 60);

Use Cases

This crate is ideal for anyone working with embedded systems, battery management protocols, or anywhere you need strongly typed unit data tied to fixed encoding scales.

Licensing

For licensing information, please refer to the LICENSE file in each crate.

Commit count: 24

cargo fmt