unit_measurements 1.5.1 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aac3030ed1c46bb4bdfe831bc9bedb29ad2a8b0e28595ba4726b2a3ff5e24791
-  data.tar.gz: 9179c7b41ef7e84b6864ef98ccb45210ab34b2488830aa3de5552659b7f39039
+  metadata.gz: daf31532333a9d280d948318fe94079cfb5a8d341f6756a5c64b42843142c80f
+  data.tar.gz: 88a85aed303c4c5209330bdcf14b1ee5696e40b0e815b6b570a60ac6fd4b6db5
 SHA512:
-  metadata.gz: 5435fba092be97c1c8407b917857c1990db07d1aa1729653ecf14519d98dcec2a4c5e5ad0c4997586eb2f72b17d1099506068aa99eb592ee35ddd8da4a2f8ba7
-  data.tar.gz: 5938944868b729168d49d1f5e7e888029931bb17237fd72c66980bf6b47d7fe58f8eefdd94f1927652d9b5d1e3e480e8df746f5c7607995390ea7caeec186634
+  metadata.gz: 60febdff329999f4aeedb36fbb8aa70eccf1ab8feecc34c4318daca4949b2df16034a285ce8ac5bee2c99e59f991fe52f456154dba5ae1c945bdf6e732f2ed55
+  data.tar.gz: 8152670ce01518dac56686ccc17f51e5c3b898f6ec90710d9a5ebb66089fa234351a70a0a91a9b9e1adf02cfb0966df3490b02f625aa639239c63440d515e960

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [1.6.0](https://github.com/shivam091/unit_measurements/compare/v1.5.1...v1.6.0) - 2023-08-19
+
+## What's new
+
+- Added support to perform mathematical operations on the measurements.
+
+----------
+
 ## [1.5.1](https://github.com/shivam091/unit_measurements/compare/v1.5.0...v1.5.1) - 2023-08-18
 
 ### What's updated

data/Gemfile.lock

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

data/README.md

@@ -348,6 +348,27 @@ UnitMeasurements::Weight.new(4, :kg) / UnitMeasurements::Weight.new(2, :kg)
 #=> 2 kg
 ```
 
+### Math
+
+You can perform mathematical operations on the measurements.
+
+**Methods:**
+1. `#round` - Rounds quantity of the measurement. If `ndigits` is not specified, quantity is rounded to `Integer`.
+2. `#abs` - Returns absolute value of the measurement quantity.
+3. `#floor` - Rounds quantity of the measurement to next lower integer.
+4. `#ceil` - Rounds quantity of the measurement to next higher integer.
+
+```ruby
+UnitMeasurements::Weight.new(1, :g).convert_to(:st).round(4)
+#=> 0.0002 st
+UnitMeasurements::Length.new(-17.625, :m).abs
+#=> 17.625 m
+UnitMeasurements::Length.new(17.625, :m).floor
+#=> 17 m
+UnitMeasurements::Length.new(17.625, :m).ceil
+#=> 18 m
+```
+
 ## Units
 
 The **`UnitMeasurements::Unit`** class is used to represent the units for a measurement.

data/lib/unit_measurements/base.rb

@@ -27,6 +27,7 @@ require "unit_measurements/unit"
 require "unit_measurements/unit_group"
 require "unit_measurements/arithmetic"
 require "unit_measurements/comparison"
+require "unit_measurements/math"
 require "unit_measurements/normalizer"
 require "unit_measurements/parser"
 require "unit_measurements/formatter"

data/lib/unit_measurements/math.rb

@@ -0,0 +1,54 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+module UnitMeasurements
+  module Math
+    # Rounds quantity of the measurement. If `ndigits` is not specified,
+    # quantity is rounded to `Integer`.
+    #
+    # @example
+    #   UnitMeasurements::Weight.new(1, :g).convert_to(:st).round(4)
+    #   => 0.0002 st
+    #
+    # @param [Integer] ndigits
+    #
+    # @return [Measurement]
+    def round(ndigits = 0)
+      self.class.new(quantity.round(ndigits), unit)
+    end
+
+    # Returns absolute value of the measurement quantity.
+    #
+    # @example
+    #   UnitMeasurements::Length.new(-17.625, :m).abs
+    #   => 17.625 m
+    #
+    # @return [Measurement]
+    def abs
+      self.class.new(quantity.abs, unit)
+    end
+
+    # Rounds quantity of the measurement to next lower integer.
+    #
+    # @example
+    #   UnitMeasurements::Length.new(17.625, :m).floor
+    #   => 17 m
+    #
+    # @return [Measurement]
+    def floor(*args)
+      self.class.new(quantity.floor(*args), unit)
+    end
+
+    # Rounds quantity of the measurement to next higher integer.
+    #
+    # @example
+    #   UnitMeasurements::Length.new(17.625, :m).ceil
+    #   => 18 m
+    #
+    # @return [Measurement]
+    def ceil(*args)
+      self.class.new(quantity.ceil(*args), unit)
+    end
+  end
+end

data/lib/unit_measurements/measurement.rb

@@ -4,9 +4,10 @@
 
 module UnitMeasurements
   class Measurement
-    include Formatter
-    include Comparison
     include Arithmetic
+    include Comparison
+    include Formatter
+    include Math
 
     CONVERSION_STRING_REGEXP = /(.+?)\s?(?:\s+(?:in|to|as)\s+(.+)|\z)/i.freeze
 

data/lib/unit_measurements/unit_groups/length.rb

@@ -3,10 +3,10 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Length = UnitMeasurements.build do
-  si_unit :m, aliases: %i[meter metre meters metres]
+  si_unit :m, aliases: [:meter, :metre, :meters, :metres]
 
-  unit :in, value: "25.4 mm", aliases: %i[" inch inches]
-  unit :ft, value: "12 in", aliases: %i[' foot feet]
-  unit :yd, value: "3 ft", aliases: %i[yard yards]
-  unit :mi, value: "1760 yd", aliases: %i[mile miles]
+  unit :in, value: "25.4 mm", aliases: [:'"', :inch, :inches]
+  unit :ft, value: "12 in", aliases: [:"'", :foot, :feet]
+  unit :yd, value: "3 ft", aliases: [:yard, :yards]
+  unit :mi, value: "1760 yd", aliases: [:mile, :miles]
 end

data/lib/unit_measurements/unit_groups/weight.rb

@@ -3,8 +3,8 @@
 # -*- warn_indent: true -*-
 
 UnitMeasurements::Weight = UnitMeasurements.build do
-  si_unit :g, aliases: %i[gram grams gramme grammes]
+  si_unit :g, aliases: [:gram, :grams, :gramme, :grammes]
 
-  unit :q, value: "100 kg", aliases: %i[quintal quintals]
-  unit :t, value: "10 q", aliases: %i[tonne tonnes metric\ tonne metric\ tonnes]
+  unit :q, value: "100 kg", aliases: [:quintal, :quintals]
+  unit :t, value: "10 q", aliases: [:tonne, :tonnes, :"metric tonne", :"metric tonnes"]
 end

data/lib/unit_measurements/version.rb

@@ -3,5 +3,5 @@
 # -*- warn_indent: true -*-
 
 module UnitMeasurements
-  VERSION = "1.5.1"
+  VERSION = "1.6.0"
 end

data/units.md

@@ -5,7 +5,7 @@ bundled units before converting your measurements.
 
 **Notes:**
 1. Base unit for each unit group is highlighted.
-2. Unit numbers suffixed with `*` support all [SI prefixes](README.md#si-units-support).
+2. Unit names suffixed with `*` support all [SI prefixes](README.md#si-units-support).
 
 Below are the units which are bundled in the unit_measurements.
 
@@ -13,9 +13,9 @@ Below are the units which are bundled in the unit_measurements.
 
 These units are defined in `UnitMeasurements::Length`.
 
-| # | Symbol | Aliases |
+| # | Name | Aliases |
 |:--|:--|:--|
-| **1\*** | **m** | **meter, metre, meters, metres** |
+| **1** | **m\*** | **meter, metre, meters, metres** |
 | 2 | in | ", inch, inches |
 | 3 | ft | ', foot, feet |
 | 4 | yd | yard, yards |
@@ -25,8 +25,8 @@ These units are defined in `UnitMeasurements::Length`.
 
 These units are defined in `UnitMeasurements::Weight`.
 
-| # | Symbol | Aliases |
+| # | Name | Aliases |
 |--|--|--|
-| **1\*** | **g** | **gram, grams, gramme, grammes** |
+| **1** | **g\*** | **gram, grams, gramme, grammes** |
 | 2 | q | quintal, quintals |
 | 3 | t | tonne, tonnes, metric tonne, metric tonnes |

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unit_measurements
 version: !ruby/object:Gem::Version
-  version: 1.5.1
+  version: 1.6.0
 platform: ruby
 authors:
 - Harshal LADHE
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-09-18 00:00:00.000000000 Z
+date: 2023-09-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -110,6 +110,7 @@ files:
 - lib/unit_measurements/errors/unit_already_defined_error.rb
 - lib/unit_measurements/errors/unit_error.rb
 - lib/unit_measurements/formatter.rb
+- lib/unit_measurements/math.rb
 - lib/unit_measurements/measurement.rb
 - lib/unit_measurements/normalizer.rb
 - lib/unit_measurements/parser.rb