unit_measurements 3.8.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d1f5b33a4d36085c2a15c637a565132cfa411810b29272bac86e079892a7c8ee
-  data.tar.gz: db220a3d6272793892f82d1bcb3a8ecea8e499792230403318ce18566fc5afa0
+  metadata.gz: df02b48d8940d23d2ef2462c58fbdfdd63c5d5d7fbfade71a40a7ddb1508f7b0
+  data.tar.gz: d3773e766bd46d8fdc4c3375bfd195506082d6125aaea66f48dd23891a009ae6
 SHA512:
-  metadata.gz: 7cfa24b914b602f492657014bacdd4ebb445c412aa06a99b73adb43c5e5f7c92213677c7b7487d7750f20e1877d83a5385cd57b1c29217993d774c40893ad7a6
-  data.tar.gz: c5f3e296d5c475889350139ef26830983d9515394ee8885854df32cfc6c27ec4f4ccb22e676637df557dbb827d6ecec04ebf3bbe7d7e9418fc1107b6258d4a68
+  metadata.gz: ec6a76228693aff998a8ea032a0f8f03732ee137a55ac9a29708b2f346919a5f134463ce117ffefa3374c0b7f2fe13ad5ff699b4f68f7c03703903d2c1b6f94f
+  data.tar.gz: e7de3fa4e74ed1e426b19dcec1e7a08d3f3cebf72b608f841a4a4a95302006a4da4b4b4e8421646f6c1a0345419cb0febe079fd0c033fe02a93f0b4dd498f84a

data/CHANGELOG.md

@@ -1,4 +1,28 @@
-## [3.8.0](https://github.com/shivam091/unit_measurements/compare/v3.7.0...v3.8.0) - 2023-10-02
+## [4.0.0](https://github.com/shivam091/unit_measurements/compare/v3.8.0...v4.0.0) - 2023-10-04
+
+### What's new
+
+- Added support to set `primitive` unit for each unit group.
+- Added support to set `system` in `Unit` metadata.
+- Added `UnitMeasurements::PrimitiveUnitAlreadySetError` error if `primitive` unit is defined more than one time in the unit group.
+
+### What's changed
+
+- Renamed `Voltage` unit group class to `ElectricPotential`.
+- Renamed `Conductance` unit group class to `ElectricConductance`.
+- Renamed `Resistance` unit group class to `ElectricalResistance`.
+- Renamed `Elastance` unit group class to `ElectricalElastance`.
+- Renamed `Capacitance` unit group class to `ElectricalCapacitance`.
+- Renamed `Inductance` unit group class to `ElectricalInductance`.
+
+### What's removed
+
+- Removed support to build `UnitSystem` instances for each system within the unit group.
+- Removed support to set `primitive` unit for each unit system within the unit group.
+
+----------
+
+## [3.8.0](https://github.com/shivam091/unit_measurements/compare/v3.7.0...v3.8.0) - 2023-10-03
 
 ### What's new
 
@@ -7,7 +31,7 @@
 
 ----------
 
-## [3.7.0](https://github.com/shivam091/unit_measurements/compare/v3.6.0...v3.7.0) - 2023-10-01
+## [3.7.0](https://github.com/shivam091/unit_measurements/compare/v3.6.0...v3.7.0) - 2023-10-02
 
 ### What's new
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    unit_measurements (3.8.0)
+    unit_measurements (4.0.0)
       activesupport (~> 7.0)
 
 GEM

data/README.md

@@ -64,7 +64,7 @@ viz., `UnitMeasurements::Weight`, `UnitMeasurements::Length`, etc.
 **Initialize a measurement:**
 
 ```ruby
-UnitMeasurements::Length.new(1, :km)
+UnitMeasurements::Length.new(1, "km")
 #=> 1 km
 ```
 
@@ -76,21 +76,21 @@ This gem allows you to convert among units of same unit group. You can convert m
 You can use `#convert_to` as:
 
 ```ruby
-UnitMeasurements::Length.new(1, :km).convert_to(:m)
+UnitMeasurements::Length.new(1, "km").convert_to("m")
 #=> 1000.0 m
 ```
 
 If you want to modify measurement object itself, you can use `#convert_to!` method as:
 
 ```ruby
-UnitMeasurements::Length.new(1, :km).convert_to!(:m)
+UnitMeasurements::Length.new(1, "km").convert_to!("m")
 #=> 1000.0 m
 ```
 
 You can also chain call of `#convert_to` and `#convert_to!` methods as:
 
 ```ruby
-UnitMeasurements::Length.new(100, :m).convert_to(:ft).convert_to!(:in)
+UnitMeasurements::Length.new(100, "m").convert_to("ft").convert_to!("in")
 #=> 3937.00787401574071916010498688 in
 ```
 
@@ -113,11 +113,11 @@ UnitMeasurements::Length.parse("1 km to m")
 **Parse scientific numbers, source unit, and (or) target unit:**
 
 ```ruby
-UnitMeasurements::Length.new(BigDecimal(2), :km).convert_to(:m)
+UnitMeasurements::Length.new(BigDecimal(2), "km").convert_to("m")
 #=> 20000.0 m
-UnitMeasurements::Length.new("2e+2", :km).convert_to(:m)
+UnitMeasurements::Length.new("2e+2", "km").convert_to("m")
 #=> 200000.0 m
-UnitMeasurements::Length.parse("2e² km").convert_to(:m)
+UnitMeasurements::Length.parse("2e² km").convert_to("m")
 #=> 200000.0 m
 UnitMeasurements::Length.parse("2e+2 km to m")
 #=> 200000.0 m
@@ -130,11 +130,11 @@ Supported special characters for exponents are `⁰`, `¹`, `²`, `³`, `⁴`, `
 **Parse complex numbers, source unit, and (or) target unit:**
 
 ```ruby
-UnitMeasurements::Length.new(Complex(2, 3), :km).convert_to(:m)
+UnitMeasurements::Length.new(Complex(2, 3), "km").convert_to("m")
 #=> 2000.0+3000.0i m
-UnitMeasurements::Length.new("2+3i", :km).convert_to(:m)
+UnitMeasurements::Length.new("2+3i", "km").convert_to("m")
 #=> 2000.0+3000.0i m
-UnitMeasurements::Length.parse("2+3i km").convert_to(:m)
+UnitMeasurements::Length.parse("2+3i km").convert_to("m")
 #=> 2000.0+3000.0i m
 UnitMeasurements::Length.parse("2+3i km to m")
 #=> 2000.0+3000.0i m
@@ -143,19 +143,19 @@ UnitMeasurements::Length.parse("2+3i km to m")
 **Parse fractional/mixed fractional numbers, source unit, and (or) target unit:**
 
 ```ruby
-UnitMeasurements::Length.new(Rational(2, 3), :km).convert_to(:m)
+UnitMeasurements::Length.new(Rational(2, 3), "km").convert_to("m")
 #=> 666.666666666667 m
-UnitMeasurements::Length.new("2/3", :km).convert_to(:m)
+UnitMeasurements::Length.new("2/3", "km").convert_to("m")
 #=> 666.666666666667 m
-UnitMeasurements::Length.new("½", :km).convert_to(:m)
+UnitMeasurements::Length.new("½", "km").convert_to("m")
 #=> 500.0 m
-UnitMeasurements::Length.parse("2 ½ km").convert_to(:m)
+UnitMeasurements::Length.parse("2 ½ km").convert_to("m")
 #=> 2500.0 m
-UnitMeasurements::Length.parse("2/3 km").convert_to(:m)
+UnitMeasurements::Length.parse("2/3 km").convert_to("m")
 #=> 666.666666666667 m
 UnitMeasurements::Length.parse("2/3 km to m")
 #=> 666.666666666667 m
-UnitMeasurements::Length.parse("2 1/2 km").convert_to(:m)
+UnitMeasurements::Length.parse("2 1/2 km").convert_to("m")
 #=> 2500.0 m
 UnitMeasurements::Length.parse("2 ½ km to m")
 #=> 2500.0 m
@@ -166,9 +166,9 @@ Supported special characters for fractional notations are `¼`, `½`, `¾`, `⅓
 **Parse ratios, source unit, and (or) target unit:**
 
 ```ruby
-UnitMeasurements::Length.new("1:2", :km).convert_to(:m)
+UnitMeasurements::Length.new("1:2", "km").convert_to("m")
 #=> 500.0 m
-UnitMeasurements::Length.parse("1:2 km").convert_to(:m)
+UnitMeasurements::Length.parse("1:2 km").convert_to("m")
 #=> 500.0 m
 UnitMeasurements::Length.parse("1:2 km to m")
 #=> 500.0 m
@@ -180,112 +180,99 @@ If you want to format measurement to certain format, you can use `#format` metho
 If format is not specified, it defaults to `"%.2<value>f %<unit>s"`.
 
 ```ruby
-UnitMeasurements::Length.new(100, :m).to(:in).format
+UnitMeasurements::Length.new(100, "m").to("in").format
 #=> "3937.01 in"
-UnitMeasurements::Length.new(100, :m).to(:in).format("%.4<quantity>f %<unit>s")
+UnitMeasurements::Length.new(100, "m").to("in").format("%.4<quantity>f %<unit>s")
 #=> "3937.0079 in"
-UnitMeasurements::Length.new(100, :m).to(:in).format("%.4<quantity>f")
+UnitMeasurements::Length.new(100, "m").to("in").format("%.4<quantity>f")
 #=> "3937.0079"
 ```
 
 **Extract the unit and the quantity from measurement:**
 
 ```ruby
-length = UnitMeasurements::Length.new(1, :km)
+length = UnitMeasurements::Length.new(1, "km")
 length.quantity
 #=> 1
 length.unit
 #=> #<UnitMeasurements::Unit: km (kilometer, kilometers, kilometre, kilometres)>
 ```
 
-**See all unit systems defined in the unit group:**
+**See primitive unit of the unit group:**
 
 ```ruby
-UnitMeasurements::Length.systems
-#=> [#<UnitMeasurements::UnitSystem:0x00007fa1a46d11c0 @name=:metric, @primitive=#<UnitMeasurements::Unit: m (meter, meters, metre, metres)>, @units=[]>, ...]
-```
-
-**Finding unit system within the unit group:**
-
-```ruby
-UnitMeasurements::Length.system_for(:imperial)
-#=> #<UnitMeasurements::UnitSystem:0x00007f87a348e680
-#     @name=:imperial,
-#     @primitive=#<UnitMeasurements::Unit: in (", inch, inches)>,
-#     @units=[#<UnitMeasurements::Unit: in (", inch, inches)>, #<UnitMeasurements::Unit: ft (', feet, foot)>, ...]>
+UnitMeasurements::Length.primitive
+#=> #<UnitMeasurements::Unit: m (meter, meters, metre, metres)>
 ```
 
-**_Note: The `UnitMeasurements::UnitGroup` and `UnitMeasurements::UnitSystem` instances share the same set of methods for unit handling.
-You can use these methods interchangeably between the two classes._**
-
-**See all units of the unit group/unit system:**
+**See all units of the unit group:**
 
 ```ruby
 UnitMeasurements::Length.units
 #=> [#<UnitMeasurements::Unit: m (meter, meters, metre, metres)>, ..., ...]
 ```
 
-**See names of all valid units of the unit group/unit system:**
+**See names of all valid units of the unit group:**
 
 ```ruby
 UnitMeasurements::Length.unit_names
 #=> ["m", "km", "mi", "ft", "in", "yd", ...]
 ```
 
-**See all valid units of the unit group/unit system along with their aliases:**
+**See all valid units of the unit group along with their aliases:**
 
 ```ruby
 UnitMeasurements::Length.unit_names_with_aliases
 #=> ["g", "meter", "metre", "meters", "metres", "km", "kilometer", "kilometre", "kilometers", "kilometres", "in", "inch", "inches", "yd", "yard", "yards", ...]
 ```
 
-**Finding units within the unit group/unit system:**
+**Finding units within the unit group:**
 
 You can use `#unit_for` or `#unit_for!` (aliased as `#[]`) to find units within
 the unit group. `#unit_for!` method returns error if a unit is not present in the
 unit group.
 
 ```ruby
-UnitMeasurements::Length.unit_for(:m)
+UnitMeasurements::Length.unit_for("m")
 #=> #<UnitMeasurements::Unit: m (meter, meters, metre, metres)>
-UnitMeasurements::Length.unit_for(:z)
+UnitMeasurements::Length.unit_for("z")
 #=> nil
-UnitMeasurements::Length.unit_for!(:m)
+UnitMeasurements::Length.unit_for!("m")
 #=> #<UnitMeasurements::Unit: m (meter, meters, metre, metres)>
-UnitMeasurements::Length.unit_for!(:z)
+UnitMeasurements::Length.unit_for!("z")
 #=> Invalid unit: 'z'. (UnitMeasurements::UnitError)
 ```
 
-**Finding whether the unit is defined within the unit group/unit system:**
+**Finding whether the unit is defined within the unit group:**
 
 ```ruby
-UnitMeasurements::Length.defined?(:m)
+UnitMeasurements::Length.defined?("m")
 #=> true
-UnitMeasurements::Length.defined?(:metre)
+UnitMeasurements::Length.defined?("metre")
 #=> false
 ```
 
-**Check if the unit is a valid unit or alias within the unit group/unit system:**
+**Check if the unit is a valid unit or alias within the unit group:**
 
 ```ruby
-UnitMeasurements::Length.unit_or_alias?(:m)
+UnitMeasurements::Length.unit_or_alias?("m")
 #=> true
-UnitMeasurements::Length.unit_or_alias?(:metre)
+UnitMeasurements::Length.unit_or_alias?("metre")
 #=> true
 ```
 
 ### Comparisons
 
 You have ability to compare the measurements with the same or different units within the same unit group.
-For example, comparing weight with weight will work, comparing a weight with a area would fail.
+For example, comparing length with length will work, comparing a length with a area would fail.
 Supported comparisons and methods are `==`, `!=`, `<`, `>`, `<=`, `>=`, `between?`, and `clamp`.
 
 ```ruby
-UnitMeasurements::Length.new(1, "km") == UnitMeasurements::Length.new(1, :km)
+UnitMeasurements::Length.new(1, "km") == UnitMeasurements::Length.new(1, "km")
 #=> true
 UnitMeasurements::Length.parse("1 km") <= UnitMeasurements::Length.parse("0.5 km")
 #=> false
-UnitMeasurements::Length.new(1, :ft).between?(UnitMeasurements::Length.new(12, :in), UnitMeasurements::Length.new(24, :in))
+UnitMeasurements::Length.new(1, "ft").between?(UnitMeasurements::Length.new(12, "in"), UnitMeasurements::Length.new(24, "in"))
 #=> true
 ```
 
@@ -303,13 +290,13 @@ In cases of different units, the left hand side takes precedence:
 4. `#/` - Divides the measurement quantity by other measurement quantity or number.
 
 ```ruby
-UnitMeasurements::Length.new(1, :km) + UnitMeasurements::Length.new(1, :m)
+UnitMeasurements::Length.new(1, "km") + UnitMeasurements::Length.new(1, "m")
 #=> 1.001 km
-UnitMeasurements::Length.new(2, :km) - 1
+UnitMeasurements::Length.new(2, "km") - 1
 #=> 1 km
-UnitMeasurements::Length.new(2, :km) * 2
+UnitMeasurements::Length.new(2, "km") * 2
 #=> 4 km
-UnitMeasurements::Length.new(4, :km) / UnitMeasurements::Length.new(2, :km)
+UnitMeasurements::Length.new(4, "km") / UnitMeasurements::Length.new(2, "km")
 #=> 2 km
 ```
 
@@ -324,13 +311,13 @@ You can perform mathematical operations on the measurements.
 4. `#ceil` - Rounds quantity of the measurement to next higher integer.
 
 ```ruby
-UnitMeasurements::Length.new(1, :m).to(:in).round(4)
+UnitMeasurements::Length.new(1, "m").to("in").round(4)
 #=> 39.3701 in
-UnitMeasurements::Length.new(-17.625, :m).abs
+UnitMeasurements::Length.new(-17.625, "m").abs
 #=> 17.625 m
-UnitMeasurements::Length.new(17.625, :m).floor
+UnitMeasurements::Length.new(17.625, "m").floor
 #=> 17 m
-UnitMeasurements::Length.new(17.625, :m).ceil
+UnitMeasurements::Length.new(17.625, "m").ceil
 #=> 18 m
 ```
 
@@ -340,15 +327,15 @@ You can convert measurement quantity directly to other numeric types viz.
 `Integer`, `BigDecimal`, `Rational`, `Complex`, and `Float`.
 
 ```ruby
-UnitMeasurements::Length.new(2.25567, :km).to_i
+UnitMeasurements::Length.new(2.25567, "km").to_i
 #=> 2 km
-UnitMeasurements::Length.new(2.25567, :km).to_f
+UnitMeasurements::Length.new(2.25567, "km").to_f
 #=> 2.25567 km
-UnitMeasurements::Length.new(2.25567, :km).to_r
+UnitMeasurements::Length.new(2.25567, "km").to_r
 #=> 225567/100000 km
-UnitMeasurements::Length.new(2.25567, :km).to_d
+UnitMeasurements::Length.new(2.25567, "km").to_d
 #=> 2.25567 km
-UnitMeasurements::Length.new(2.25567, :km).to_c
+UnitMeasurements::Length.new(2.25567, "km").to_c
 #=> 2.25567+0i km
 ```
 
@@ -356,10 +343,10 @@ UnitMeasurements::Length.new(2.25567, :km).to_c
 
 The **`UnitMeasurements::Unit`** class is used to represent the units for a measurement.
 
-### SI units support
+### Support for SI decimal prefixes
 
-There is support for SI units through the use of `si_unit` method.
-Units declared through it will have automatic support for all SI prefixes:
+There is support for SI decimal prefixes through the use of `si_unit` method.
+Units declared through it will have automatic support for all decimal prefixes:
 
 | Multiplying Factor                        | SI Prefix  | Scientific Notation |
 | ----------------------------------------- | ---------- | ------------------- |
@@ -430,25 +417,26 @@ gem "unit_measurements", require: ["unit_measurements/base", "unit_measurements/
 ### Building new unit groups
 
 This library provides simpler way to build your own unit groups. To build new unit group,
-use `UnitMeasurements.build` method in order to define units and unit systems within it:
+use `UnitMeasurements.build` method in order to define units within it:
 
-For convenience, you also have ability to group units by the unit system and set primitive unit for each unit system using `system` and `primitive` methods.
+For convenience, you also have ability to group units by the unit system using `system` method
+and set primitive unit for each unit group using `primitive` method.
 
 ```ruby
 UnitMeasurements::Time = UnitMeasurements.build do
-  # Group units by the unit system name.
-  system :metric do
-    # Set primitive unit for the unit system.
-    primitive :s
+  # Set primitive unit for the unit group.
+  primitive "s"
 
+  # Group units by the unit system.
+  system :metric do
     # Add a SI unit to the unit group.
-    si_unit :s, aliases: [:second, :seconds]
+    si_unit "s", aliases: ["second", "seconds"]
 
     # Add units to the group, along with their conversion multipliers.
-    unit :min, value: "60 s", aliases: [:hour, :hours]
+    unit "min", value: "60 s", aliases: ["hour", "hours"]
 
     # You can also specify unit value as an array.
-    unit :h, value: [60, :min], aliases: [:day, :days]
+    unit :h, value: [60, "min"], aliases: ["day", "days"]
   end
 end
 ```

data/lib/unit_measurements/arithmetic.rb

@@ -9,7 +9,7 @@ module UnitMeasurements
     # @param [Numeric or Measurement] other
     #
     # @example
-    #   UnitMeasurements::Weight.new(1, :kg) + UnitMeasurements::Weight.new(1, :g)
+    #   UnitMeasurements::Weight.new(1, "kg") + UnitMeasurements::Weight.new(1, "g")
     #   => 1.001 kg
     #
     # @return [Measurement]
@@ -22,7 +22,7 @@ module UnitMeasurements
     # @param [Numeric or Measurement] other
     #
     # @example
-    #   UnitMeasurements::Weight.new(2, :kg) - 1
+    #   UnitMeasurements::Weight.new(2, "kg") - 1
     #   => 1 kg
     #
     # @return [Measurement]
@@ -35,7 +35,7 @@ module UnitMeasurements
     # @param [Numeric or Measurement] other
     #
     # @example
-    #   UnitMeasurements::Weight.new(2, :kg) * 2
+    #   UnitMeasurements::Weight.new(2, "kg") * 2
     #   => 4 kg
     #
     # @return [Measurement]
@@ -48,7 +48,7 @@ module UnitMeasurements
     # @param [Numeric or Measurement] other
     #
     # @example
-    #   UnitMeasurements::Weight.new(4, :kg) / UnitMeasurements::Weight.new(2, :kg)
+    #   UnitMeasurements::Weight.new(4, "kg") / UnitMeasurements::Weight.new(2, "kg")
     #   => 2 kg
     #
     # @return [Measurement]

data/lib/unit_measurements/base.rb

@@ -24,8 +24,6 @@ end
 
 require "unit_measurements/unit_group_builder"
 require "unit_measurements/unit"
-require "unit_measurements/unit_methods"
-require "unit_measurements/unit_system"
 require "unit_measurements/unit_group"
 require "unit_measurements/arithmetic"
 require "unit_measurements/comparison"
@@ -37,5 +35,6 @@ require "unit_measurements/formatter"
 require "unit_measurements/measurement"
 
 require "unit_measurements/errors/unit_error"
-require "unit_measurements/errors/unit_already_defined_error"
 require "unit_measurements/errors/parse_error"
+require "unit_measurements/errors/unit_already_defined_error"
+require "unit_measurements/errors/primitive_unit_already_set_error"

data/lib/unit_measurements/comparison.rb

@@ -6,7 +6,8 @@ module UnitMeasurements
   module Comparison
     include Comparable
 
-    # Compares the quantities of two measurements within the same unit group.
+    # Implements +Comparable+ methods on the quantities of two measurements of
+    # the same unit group.
     #
     # @example
     #   UnitMeasurements::Weight.new(1, "kg") == UnitMeasurements::Weight.new(1, :kg)

data/lib/unit_measurements/conversion.rb

@@ -7,7 +7,7 @@ module UnitMeasurements
     # Converts quantity of the measurement to +Integer+.
     #
     # @example
-    #   UnitMeasurements::Weight.new(2.25567, :kg).to_i
+    #   UnitMeasurements::Weight.new(2.25567, "kg").to_i
     #   => 2 kg
     #
     # @return [Measurement]
@@ -18,7 +18,7 @@ module UnitMeasurements
     # Converts quantity of the measurement to +Float+.
     #
     # @example
-    #   UnitMeasurements::Weight.new(2.25567, :kg).to_f
+    #   UnitMeasurements::Weight.new(2.25567, "kg").to_f
     #   => 2.25567 kg
     #
     # @return [Measurement]
@@ -29,7 +29,7 @@ module UnitMeasurements
     # Converts quantity of the measurement to +Rational+.
     #
     # @example
-    #   UnitMeasurements::Weight.new(2.25567, :kg).to_r
+    #   UnitMeasurements::Weight.new(2.25567, "kg").to_r
     #   => 225567/100000 kg
     #
     # @return [Measurement]
@@ -40,7 +40,7 @@ module UnitMeasurements
     # Converts quantity of the measurement to +Complex+.
     #
     # @example
-    #   UnitMeasurements::Weight.new(2.25567, :kg).to_c
+    #   UnitMeasurements::Weight.new(2.25567, "kg").to_c
     #   => 2.25567+0i kg
     #
     # @return [Measurement]
@@ -51,7 +51,7 @@ module UnitMeasurements
     # Converts quantity of the measurement to +BigDecimal+.
     #
     # @example
-    #   UnitMeasurements::Weight.new(2.25567, :kg).to_d
+    #   UnitMeasurements::Weight.new(2.25567, "kg").to_d
     #   => 2.25567 kg
     #
     # @return [Measurement]

data/lib/unit_measurements/errors/primitive_unit_already_set_error.rb

@@ -0,0 +1,11 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+module UnitMeasurements
+  class PrimitiveUnitAlreadySetError < BaseError
+    def initialize
+      super("The primitive unit is already set for the unit group.")
+    end
+  end
+end

data/lib/unit_measurements/formatter.rb

@@ -12,9 +12,9 @@ module UnitMeasurements
     # formatting the measurement
     #
     # @example
-    #   UnitMeasurements::Weight.parse("2 kg").to(:st).format
+    #   UnitMeasurements::Weight.parse("2 kg").to("st").format
     #   => "0.31 st"
-    #   UnitMeasurements::Weight.parse("2 kg").to(:st).format("%.4<quantity>f %<unit>s")
+    #   UnitMeasurements::Weight.parse("2 kg").to("st").format("%.4<quantity>f %<unit>s")
     #   => "0.3149 st"
     #
     # @param [String] format

data/lib/unit_measurements/math.rb

@@ -5,10 +5,10 @@
 module UnitMeasurements
   module Math
     # Rounds quantity of the measurement. If `ndigits` is not specified,
-    # quantity is rounded to `Integer`.
+    # quantity is rounded to +Integer+.
     #
     # @example
-    #   UnitMeasurements::Weight.new(1, :g).convert_to(:st).round(4)
+    #   UnitMeasurements::Weight.new(1, "g").convert_to("st").round(4)
     #   => 0.0002 st
     #
     # @param [Integer] ndigits
@@ -21,7 +21,7 @@ module UnitMeasurements
     # Returns absolute value of the measurement quantity.
     #
     # @example
-    #   UnitMeasurements::Length.new(-17.625, :m).abs
+    #   UnitMeasurements::Length.new(-17.625, "m").abs
     #   => 17.625 m
     #
     # @return [Measurement]
@@ -32,7 +32,7 @@ module UnitMeasurements
     # Rounds quantity of the measurement to next lower integer.
     #
     # @example
-    #   UnitMeasurements::Length.new(17.625, :m).floor
+    #   UnitMeasurements::Length.new(17.625, "m").floor
     #   => 17 m
     #
     # @return [Measurement]
@@ -43,7 +43,7 @@ module UnitMeasurements
     # Rounds quantity of the measurement to next higher integer.
     #
     # @example
-    #   UnitMeasurements::Length.new(17.625, :m).ceil
+    #   UnitMeasurements::Length.new(17.625, "m").ceil
     #   => 18 m
     #
     # @return [Measurement]

data/lib/unit_measurements/measurement.rb

@@ -31,9 +31,7 @@ module UnitMeasurements
 
       self.class.new((quantity * conversion_factor), target_unit)
     end
-    alias_method :to, :convert_to
-    alias_method :in, :convert_to
-    alias_method :as, :convert_to
+    [:to, :in, :as].each { |method_alias| alias_method method_alias, :convert_to }
 
     def convert_to!(target_unit)
       measurement = convert_to(target_unit)
@@ -41,14 +39,10 @@ module UnitMeasurements
 
       self
     end
-    alias_method :to!, :convert_to!
-    alias_method :in!, :convert_to!
-    alias_method :as!, :convert_to!
+    [:to!, :in!, :as!].each { |method_alias| alias_method method_alias, :convert_to! }
 
     def inspect(dump: false)
-      return super() if dump
-
-      to_s
+      dump ? super() : to_s
     end
 
     def to_s
@@ -71,9 +65,9 @@ module UnitMeasurements
         raise BaseError, "`Measurement` does not have a `unit_group` object. You cannot directly use `Measurement`. Instead, build a new unit group by calling `UnitMeasurements.build`."
       end
 
-      def_delegators :unit_group, :units, :unit_names, :unit_with_name_and_aliases,
+      def_delegators :unit_group, :primitive, :units, :unit_names, :unit_with_name_and_aliases,
                      :unit_names_with_aliases, :unit_for, :unit_for!, :defined?,
-                     :unit_or_alias?, :[], :systems, :system_for
+                     :unit_or_alias?, :[]
 
       def parse(input)
         input = Normalizer.normalize(input)