unit_measurements 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: daf31532333a9d280d948318fe94079cfb5a8d341f6756a5c64b42843142c80f
-  data.tar.gz: 88a85aed303c4c5209330bdcf14b1ee5696e40b0e815b6b570a60ac6fd4b6db5
+  metadata.gz: bbb7978f79ac8f4fac738ef87936cf1bf20397c74772c35120205aed22d1ac1c
+  data.tar.gz: 1b99cb2665a071d0e721f78cabad86fc50a39e2eda8349bd5813ba80c48afe89
 SHA512:
-  metadata.gz: 60febdff329999f4aeedb36fbb8aa70eccf1ab8feecc34c4318daca4949b2df16034a285ce8ac5bee2c99e59f991fe52f456154dba5ae1c945bdf6e732f2ed55
-  data.tar.gz: 8152670ce01518dac56686ccc17f51e5c3b898f6ec90710d9a5ebb66089fa234351a70a0a91a9b9e1adf02cfb0966df3490b02f625aa639239c63440d515e960
+  metadata.gz: 27da14501c804050def9568138cfcab08b7b81eeab9d47ba3c23117534d2f32f33ed42260c9199d95f1c5cc71e715d1844cc493be34e347989c9fb71932fb058
+  data.tar.gz: e6c5e47ab28b199599cc7b86b748205d3124c52fbbdfb83a38849876177764e280ce6d324336908ebdff0eff6a3acdb98b8cf8a8bc94ef8f325deca2d378f560

data/CHANGELOG.md

@@ -1,6 +1,15 @@
+## [1.7.0](https://github.com/shivam091/unit_measurements/compare/v1.6.0...v1.7.0) - 2023-08-20
+
+### What's new
+
+- Added support to convert the measurements to other numeric types viz.,
+  `Integer`, `BigDecimal`, `Rational`, `Complex`, and `Float`.
+
+----------
+
 ## [1.6.0](https://github.com/shivam091/unit_measurements/compare/v1.5.1...v1.6.0) - 2023-08-19
 
-## What's new
+### What's new
 
 - Added support to perform mathematical operations on the measurements.
 

data/Gemfile.lock

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

data/README.md

@@ -369,6 +369,24 @@ UnitMeasurements::Length.new(17.625, :m).ceil
 #=> 18 m
 ```
 
+### Conversions
+
+You can convert measurement quantity directly to other numeric types viz.
+`Integer`, `BigDecimal`, `Rational`, `Complex`, and `Float`.
+
+```ruby
+UnitMeasurements::Weight.new(2.25567, :kg).to_i
+#=> 2 kg
+UnitMeasurements::Weight.new(2.25567, :kg).to_f
+#=> 2.25567 kg
+UnitMeasurements::Weight.new(2.25567, :kg).to_r
+#=> 225567/100000 kg
+UnitMeasurements::Weight.new(2.25567, :kg).to_d
+#=> 2.25567 kg
+UnitMeasurements::Weight.new(2.25567, :kg).to_c
+#=> 2.25567+0i kg
+```
+
 ## 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/conversion"
 require "unit_measurements/math"
 require "unit_measurements/normalizer"
 require "unit_measurements/parser"

data/lib/unit_measurements/conversion.rb

@@ -0,0 +1,62 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+module UnitMeasurements
+  module Conversion
+    # Converts quantity of the measurement to +Integer+.
+    #
+    # @example
+    #   UnitMeasurements::Weight.new(2.25567, :kg).to_i
+    #   => 2 kg
+    #
+    # @return [Measurement]
+    def to_i
+      self.class.new(quantity.to_i, unit)
+    end
+
+    # Converts quantity of the measurement to +Float+.
+    #
+    # @example
+    #   UnitMeasurements::Weight.new(2.25567, :kg).to_f
+    #   => 2.25567 kg
+    #
+    # @return [Measurement]
+    def to_f
+      self.class.new(quantity.to_f, unit)
+    end
+
+    # Converts quantity of the measurement to +Rational+.
+    #
+    # @example
+    #   UnitMeasurements::Weight.new(2.25567, :kg).to_r
+    #   => 225567/100000 kg
+    #
+    # @return [Measurement]
+    def to_r
+      self.class.new(quantity.to_r, unit)
+    end
+
+    # Converts quantity of the measurement to +Complex+.
+    #
+    # @example
+    #   UnitMeasurements::Weight.new(2.25567, :kg).to_c
+    #   => 2.25567+0i kg
+    #
+    # @return [Measurement]
+    def to_c
+      self.class.new(quantity.to_c, unit)
+    end
+
+    # Converts quantity of the measurement to +BigDecimal+.
+    #
+    # @example
+    #   UnitMeasurements::Weight.new(2.25567, :kg).to_d
+    #   => 2.25567 kg
+    #
+    # @return [Measurement]
+    def to_d
+      self.class.new(quantity.to_d, unit)
+    end
+  end
+end

data/lib/unit_measurements/measurement.rb

@@ -6,6 +6,7 @@ module UnitMeasurements
   class Measurement
     include Arithmetic
     include Comparison
+    include Conversion
     include Formatter
     include Math
 

data/lib/unit_measurements/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unit_measurements
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Harshal LADHE
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-09-19 00:00:00.000000000 Z
+date: 2023-09-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -106,6 +106,7 @@ files:
 - lib/unit_measurements/arithmetic.rb
 - lib/unit_measurements/base.rb
 - lib/unit_measurements/comparison.rb
+- lib/unit_measurements/conversion.rb
 - lib/unit_measurements/errors/parse_error.rb
 - lib/unit_measurements/errors/unit_already_defined_error.rb
 - lib/unit_measurements/errors/unit_error.rb