unitsdb-ruby

View on GitHub

A Ruby library for accessing and manipulating UnitsDB content. The gem ships with UnitsDB YAML data files bundled internally — no separate data source configuration needed.

Installation

gem install unitsdb

Usage

require 'unitsdb'

# Access the bundled database
db = Unitsdb.database

# Query units
unit = db.units.find { |u| u.name == "metre" }
puts unit.id          # => "NISTu1"
puts unit.symbols     # => "m"

# Query quantities
length = db.quantities.find { |q| q.name == "length" }

# Browse unit systems, dimensions, prefixes, and scales
db.unit_systems.each { |sys| puts sys.name }

Features

Bundled Data

UnitsDB YAML data files are included in the gem. No external configuration or data download required.

Full Database API

Programmatic access to all 716 entities — units, quantities, dimensions, prefixes, scales, and unit systems.

Validated Data

YAML schema validation ensures data integrity. The gem and data versions are managed independently.