unit_measurements 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 330be281aba063532010cf47f1e0065c35390510749002f368ff3139a22e6b5c
-  data.tar.gz: 26a8aa9db580205a117b11a8b653a5c609d1972be7b3eb76e2b91ec20f02b7be
+  metadata.gz: 3562e30ce7bfed682e67fbdc5c9d8d30b011a6cd16996b7efe6860622abf25d5
+  data.tar.gz: af4224714284377ebd6aea3a78c4842078f708eeaf06500658ef45f151192373
 SHA512:
-  metadata.gz: 2d67ddc3a66baec5ce04878b046541dd7b9f3d8da65a18fcf84179f4178c467b3e2276f1a236e22caac9d170815d6529be842fdac2ac45aed79e48b32d136de7
-  data.tar.gz: 331afbfc4616fd9cbccf13ed6c3d01266ba6fd49e9fe4ae06c9f8ed311210a77381056d0037415b4fc4c48477a5fcda48d2d64397c8df3888bcacf1b965c79c8
+  metadata.gz: 22a6a8f0b97a5ef1845448bcf219fbd2d0228b3d74b409e93ce596f7648d67207ea5caa64f39e0c0dd9083bf6425c1012bbf11f25624faf718f377307b698309
+  data.tar.gz: 1a436d77f1a99a7eb838e397b0038b7aba73fe19d3acf7aa0e02dbd3d482beeb2fd6b33b648d2b02514681ba6b792076596f761dbca41fb0eab3985d84209f27

data/CHANGELOG.md

@@ -1,8 +1,16 @@
+## [1.3.0](https://github.com/shivam091/unit_measurements/compare/v1.2.0...v1.3.0) - 2023-08-16
+
+### What's new
+
+- Added ability to compare two measurements of the same unit group.
+
+----------
+
 ## [1.2.0](https://github.com/shivam091/unit_measurements/compare/v1.1.0...v1.2.0) - 2023-08-15
 
 ### What's new
 
-- Added support to specify unit value as an `array` of number and unit. viz.,
+- Added support to specify unit value as an `array` of number and unit.
 
 ----------
 

data/Gemfile.lock

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

data/README.md

@@ -303,6 +303,25 @@ UnitMeasurements::Weight.unit_or_alias?(:gramme)
 #=> 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.
+Allowed comparisons are `==`, `!=`, `>`, `>=`, `<`, and `<=`.
+
+```ruby
+UnitMeasurements::Weight.new(1, "kg") == UnitMeasurements::Weight.new(1, :kg)
+#=> true
+UnitMeasurements::Weight.parse("1 kg") == UnitMeasurements::Weight.parse("1000 g")
+#=> true
+UnitMeasurements::Weight.parse("1 kg") != UnitMeasurements::Weight.parse("1 g")
+#=> true
+UnitMeasurements::Weight.parse("1 kg") <= UnitMeasurements::Weight.parse("0.5 kg")
+#=> false
+UnitMeasurements::Weight.parse("1 kg") >= UnitMeasurements::Weight.parse("0.5 kg")
+#=> true
+```
+
 ## Units
 
 The **`UnitMeasurements::Unit`** class is used to represent the units for a measurement.

data/lib/unit_measurements/base.rb

@@ -28,6 +28,7 @@ require "unit_measurements/unit_group"
 require "unit_measurements/normalizer"
 require "unit_measurements/parser"
 require "unit_measurements/formatter"
+require "unit_measurements/comparison"
 require "unit_measurements/measurement"
 
 require "unit_measurements/errors/unit_error"

data/lib/unit_measurements/comparison.rb

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+module UnitMeasurements
+  module Comparison
+    include Comparable
+
+    # Compares the quantities of two measurements within the same unit group.
+    #
+    # @example
+    #   UnitMeasurements::Weight.new(1, "kg") == UnitMeasurements::Weight.new(1, :kg)
+    #   => true
+    #
+    # @return [Boolean]
+    def <=>(object)
+      return nil unless object.is_a?(self.class)
+
+      quantity <=> object.convert_to(unit.name).quantity
+    end
+  end
+end

data/lib/unit_measurements/measurement.rb

@@ -5,6 +5,8 @@
 module UnitMeasurements
   class Measurement
     include Formatter
+    include Comparison
+
     CONVERSION_STRING_REGEXP = /(.+?)\s?(?:\s+(?:in|to|as)\s+(.+)|\z)/i.freeze
 
     attr_reader :quantity, :unit

data/lib/unit_measurements/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unit_measurements
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Harshal LADHE
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-09-15 00:00:00.000000000 Z
+date: 2023-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -104,6 +104,7 @@ files:
 - Rakefile
 - lib/unit_measurements.rb
 - lib/unit_measurements/base.rb
+- lib/unit_measurements/comparison.rb
 - lib/unit_measurements/errors/parse_error.rb
 - lib/unit_measurements/errors/unit_already_defined_error.rb
 - lib/unit_measurements/errors/unit_error.rb