composite_unit_measurements 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c25131e598e9fb02e3b569eeb45df0f39b254d5d85ab7e60ee729365b70c59cc
-  data.tar.gz: c659dea44b220217466355182589a808a098d1d654efbc664f55e6556198422f
+  metadata.gz: 4b3ee724bfce2ea0502643679d1779360a70977d89dc946a855457b982f7b4c9
+  data.tar.gz: 1b971b28b9a8d9d6c72476c9c4bee08de44fc97f9670497245de616f0658872f
 SHA512:
-  metadata.gz: ca73e1e52c1c40b08f95ce7196bdb5c290dbe4d955c8c9c80affc6210b5657cb05a013e5352467412a8139cb1ef927914b96cd59843565fb30462ba4ce77419f
-  data.tar.gz: 7528d84b11c1eeb86eea5b5683e581513695b816662669711fa8a567a9fba1c7b4f505d19dd250c6b1175c5e9bdea896f5f483e0096c35b38a591aa7477124fa
+  metadata.gz: 076635ea3ccbcab0c65d0baae50da36351d89c96a88f774cc0f4db579332ace45135f49974756e6f6fff4e8bc92c86fdde7ad19251cac97a82eb9b79ebaa7d64
+  data.tar.gz: 38e4adbd5231dc8d65134178f05548713f42f2709929d33f416ca4f0d1536635d42c1389e669619be193ab0d78df09b8a8908918a4d10683f27be18b4cc13bc8

data/CHANGELOG.md

@@ -1,8 +1,26 @@
-## [0.4.0](https://github.com/shivam091/composite_unit_measurements/compare/v0.2.0...v0.3.0) - 2023-11-30
+## [0.6.0](https://github.com/shivam091/composite_unit_measurements/compare/v0.5.0...v0.6.0) - 2023-12-12
 
 ### What's new
 
-- Added ability to parse `litre-millilitre` volume measurements.
+- Added support to parse `tonne-kilogramme` weight measurements.
+- Added support to parse `second-millisecond` and `year-month` time measurements.
+
+-----------
+
+## [0.5.0](https://github.com/shivam091/composite_unit_measurements/compare/v0.4.0...v0.5.0) - 2023-12-10
+
+### What's new
+
+- Added ability to parse `mile-yard` length measurement.
+- Added ability to parse `minute-second`, `week-day`, and `month-day` time measurements.
+
+-----------
+
+## [0.4.0](https://github.com/shivam091/composite_unit_measurements/compare/v0.3.0...v0.4.0) - 2023-12-08
+
+### What's new
+
+- Added ability to parse `litre-millilitre` volume measurement.
 - Updated readme with parsing examples.
 
 -----------

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    composite_unit_measurements (0.4.0)
+    composite_unit_measurements (0.6.0)
       activesupport (~> 7.0)
       unit_measurements (~> 5)
 

data/README.md

@@ -1,6 +1,6 @@
 # Composite Unit Measurements
 
-A collection of specialized parsers designed for handling composite measurement strings.
+A collection of specialized parsers designed for handling composite measurements.
 
 [![Ruby](https://github.com/shivam091/composite_unit_measurements/actions/workflows/main.yml/badge.svg)](https://github.com/shivam091/composite_unit_measurements/actions/workflows/main.yml)
 [![Gem Version](https://badge.fury.io/rb/composite_unit_measurements.svg)](https://badge.fury.io/rb/composite_unit_measurements)
@@ -9,12 +9,13 @@ A collection of specialized parsers designed for handling composite measurement
 [![Test Coverage](https://api.codeclimate.com/v1/badges/94e13b43cdd19e6c462c/test_coverage)](https://codeclimate.com/github/shivam091/composite_unit_measurements/test_coverage)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/shivam091/composite_unit_measurements/blob/main/LICENSE)
 
-**Harshal V. Ladhe, M.Sc. Computer Science.**
+**[Harshal V. Ladhe, Master of Computer Science.](https://shivam091.github.io)**
 
 ## Introduction
 
-The `composite_unit_measurements` gem offers versatile parsers for efficiently parsing
-composite measurement strings. Leveraging the power of the `unit_measurements` gem,
+The `composite_unit_measurements` gem offers versatile parsers for efficiently
+parsing composite measurements. Leveraging the power of the [`unit_measurements`]
+(https://github.com/shivam091/unit_measurements) gem,
 it enables smooth handling of composite measurements in various units.
 
 ## Minimum Requirements
@@ -41,15 +42,15 @@ Or otherwise simply install it yourself as:
 ## Usage
 
 Each packaged parser includes the `.parse` method to parse composite measurements.
-You can use an appropriate parser to these measurements and the final result of
-is returned in the leftmost unit of your measurement.
+You can use an appropriate parser to parse measurements and the final result of
+parser is returned in the leftmost unit of your measurement.
 
-The result of each parser method returns an instance of measurement on which we can
-perform any functionality offered by `unit_measurements`.
+The result of each parser method returns an instance of measurement on which we
+can perform any functionality offered by `unit_measurements`.
 
-This gem internally uses [`unit_measurements`](https://github.com/shivam091/unit_measurements)
-to perform conversions and arithmetic operations. You can build supported composite measurements
-using any [unit alias](https://github.com/shivam091/unit_measurements/blob/main/units.md).
+This gem internally uses `unit_measurements` to perform conversions and arithmetic
+operations. You can build supported composite measurements using any
+[unit alias](https://github.com/shivam091/unit_measurements/blob/main/units.md).
 
 ### Examples
 
@@ -79,7 +80,8 @@ CompositeUnitMeasurements::Volume.parse("2 l 250 ml") #=> 2.25 l
 
 ### Support for numeric types
 
-Each parser can handle various numeric types, including scientific notation, rational numbers, and complex numbers.
+Each parser can handle various numeric types, including scientific notation,
+rational numbers, and complex numbers.
 
 ```ruby
 CompositeUnitMeasurements::Length.parse("1+2i ft 12 in")    #=> 2.0+2.0i ft
@@ -91,21 +93,29 @@ CompositeUnitMeasurements::Length.parse("1e-2 ft 1+2i in")  #=> 0.09333333333333
 
 ## Packaged parsers & supported composite measurements
 
-The `composite_unit_measurements` gem supports parsing various composite measurements, including:
+The `composite_unit_measurements` gem supports parsing various composite measurements,
+including:
 
 **1. CompositeUnitMeasurements::Length**
 - metre-centimetre (6 m 50 cm)
 - kilometre-metre (5 km 500 m)
 - foot-inch (5 ft 6 in)
+- mile-yard (20 mi 220 yd)
 
 **2. CompositeUnitMeasurements::Weight**
 - kilogramme-gramme (4 kg 500 g)
 - pound-ounce (8 lb 12 oz)
 - stone-pound (2 st 6 lb)
+- tonne-kilogramme (1 t 500 kg)
 
 **3. CompositeUnitMeasurements::Time**
 - hour-minute (3 h 45 min)
 - hour-minute-second-microsecond (12:60,3600:360000000)
+- minute-second (10 min 90 s)
+- week-day (8 wk 3 d)
+- month-day (2 mo 60 d)
+- second-millisecond (8 s 500 ms)
+- year-month (3 yr 4 mo)
 
 **4. CompositeUnitMeasurements::Volume**
 - litre-millilitre (2 l 250 ml)

data/lib/composite_unit_measurements/length.rb

@@ -20,6 +20,8 @@ module CompositeUnitMeasurements
       #   CompositeUnitMeasurements::Length.parse("5 km 500 m") #=> 5.5 km
       # @example Parse 'foot-inch' measurement:
       #   CompositeUnitMeasurements::Length.parse("5 ft 6 in") #=> 5.5 ft
+      # @example Parse 'mile-yard' measurement:
+      #   CompositeUnitMeasurements::Length.parse("20 mi 220 yd") #=> 20.125 mi
       #
       # @param [String] string The string to parse for length measurement.
       # @return [UnitMeasurements::Length]
@@ -35,6 +37,7 @@ module CompositeUnitMeasurements
         when FOOT_INCH        then parse_foot_inch(string)
         when KILOMETRE_METRE  then parse_kilometre_metre(string)
         when METRE_CENTIMETRE then parse_metre_centimetre(string)
+        when MILE_YARD        then parse_mile_yard(string)
         else                       raise UnitMeasurements::ParseError, string
         end
       end
@@ -100,6 +103,26 @@ module CompositeUnitMeasurements
           UnitMeasurements::Length.new(kilometre, "km") + UnitMeasurements::Length.new(metre, "m")
         end
       end
+
+      # @private
+      # Parses a +string+ representing a length in the format of +mile-yard+
+      # into a +UnitMeasurements::Length+ object.
+      #
+      # @param [String] string
+      #   The string representing length measurement in the format of *mile-yard*.
+      # @return [UnitMeasurements::Length]
+      #   Returns a UnitMeasurements::Length object if parsing is successful.
+      #
+      # @see MILE_YARD
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.5.0
+      def parse_mile_yard(string)
+        mile, yard = string.match(MILE_YARD)&.captures
+
+        if mile && yard
+          UnitMeasurements::Length.new(mile, "mi") + UnitMeasurements::Length.new(yard, "yd")
+        end
+      end
     end
 
     # Regex pattern for aliases of +foot+ unit.
@@ -132,6 +155,18 @@ module CompositeUnitMeasurements
     # @since 0.3.0
     KILOMETRE_ALIASES = /(?:km|kilometer(?:s)?|kilometre(?:s)?)/.freeze
 
+    # Regex pattern for aliases of +mile+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.5.0
+    MILE_ALIASES = /(?:mi|mile(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +yard+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.5.0
+    YARD_ALIASES = /(?:yd|yard(?:s)?)/.freeze
+
     # Regex pattern for parsing a length measurement in the format of +foot-inch+.
     #
     # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
@@ -150,7 +185,14 @@ module CompositeUnitMeasurements
     # @since 0.3.0
     KILOMETRE_METRE = /\A#{ANY_NUMBER}\s*#{KILOMETRE_ALIASES}\s*#{ANY_NUMBER}\s*#{METRE_ALIASES}\z/.freeze
 
+    # Regex pattern for parsing a length measurement in the format of +mile-yard+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.5.0
+    MILE_YARD = /\A#{ANY_NUMBER}\s*#{MILE_ALIASES}\s*#{ANY_NUMBER}\s*#{YARD_ALIASES}\z/.freeze
+
     private_constant :FOOT_ALIASES, :INCH_ALIASES, :METRE_ALIASES, :CENTIMETRE_ALIASES,
-                     :KILOMETRE_ALIASES, :FOOT_INCH, :KILOMETRE_METRE, :METRE_CENTIMETRE
+                     :KILOMETRE_ALIASES, :MILE_ALIASES, :YARD_ALIASES, :MILE_YARD,
+                     :FOOT_INCH, :KILOMETRE_METRE, :METRE_CENTIMETRE
   end
 end

data/lib/composite_unit_measurements/time.rb

@@ -19,6 +19,16 @@ module CompositeUnitMeasurements
       # @example Parse 'duration':
       #   CompositeUnitMeasurements::Time.parse("12:60:3600,360000000") #=> 14.1 h
       #   CompositeUnitMeasurements::Time.parse("12:60:3600") #=> 14.0 h
+      # @example Parse 'minute-second' measurement:
+      #   CompositeUnitMeasurements::Time.parse("10 min 90 s") #=> 11.5 min
+      # @example Parse 'week-day' measurement:
+      #   CompositeUnitMeasurements::Time.parse("8 wk 3 d") #=> 8.428571428571429 wk
+      # @example Parse 'month-day' measurement:
+      #   CompositeUnitMeasurements::Time.parse("2 mo 60 d") #=> 3.97260057797197 mo
+      # @example Parse 'second-millisecond' measurement:
+      #   CompositeUnitMeasurements::Time.parse("8 s 500 ms") #=> 8.5 s
+      # @example Parse 'year-month' measurement:
+      #   CompositeUnitMeasurements::Time.parse("3 yr 4 mo") #=> 3.333333698630137 yr
       #
       # @param [String] string The string to parse for time measurement.
       # @return [UnitMeasurements::Time]
@@ -30,9 +40,14 @@ module CompositeUnitMeasurements
       # @since 0.2.0
       def parse(string)
         case string
-        when HOUR_MINUTE then parse_hour_minute(string)
-        when DURATION    then parse_duration(string)
-        else                  raise UnitMeasurements::ParseError, string
+        when HOUR_MINUTE        then parse_hour_minute(string)
+        when DURATION           then parse_duration(string)
+        when MINUTE_SECOND      then parse_minute_second(string)
+        when WEEK_DAY           then parse_week_day(string)
+        when MONTH_DAY          then parse_month_day(string)
+        when SECOND_MILLISECOND then parse_second_millisecond(string)
+        when YEAR_MONTH         then parse_year_month(string)
+        else                         raise UnitMeasurements::ParseError, string
         end
       end
 
@@ -76,10 +91,110 @@ module CompositeUnitMeasurements
         hour, minute, second, microsecond = string.match(DURATION)&.captures
         raise ArgumentError, "Invalid Duration" if [hour, minute, second, microsecond].all?(&:nil?)
 
-        UnitMeasurements::Time.new((hour || 0), :h) +
-          UnitMeasurements::Time.new((minute || 0), :min) +
-          UnitMeasurements::Time.new((second || 0), :s) +
-          UnitMeasurements::Time.new((microsecond || 0), :μs)
+        UnitMeasurements::Time.new((hour || 0), "h") +
+          UnitMeasurements::Time.new((minute || 0), "min") +
+          UnitMeasurements::Time.new((second || 0), "s") +
+          UnitMeasurements::Time.new((microsecond || 0), "μs")
+      end
+
+      # @private
+      # Parses a +string+ representing a time in the format of +minute-second+
+      # into a +UnitMeasurements::Time+ object.
+      #
+      # @param [String] string
+      #   The string representing time measurement in the format of *minute-second*.
+      # @return [UnitMeasurements::Time]
+      #   Returns a UnitMeasurements::Time object if parsing is successful.
+      #
+      # @see MINUTE_SECOND
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.5.0
+      def parse_minute_second(string)
+        minute, second = string.match(MINUTE_SECOND)&.captures
+
+        if minute && second
+          UnitMeasurements::Time.new(minute, "min") + UnitMeasurements::Time.new(second, "s")
+        end
+      end
+
+      # @private
+      # Parses a +string+ representing a time in the format of +week-day+
+      # into a +UnitMeasurements::Time+ object.
+      #
+      # @param [String] string
+      #   The string representing time measurement in the format of *week-day*.
+      # @return [UnitMeasurements::Time]
+      #   Returns a UnitMeasurements::Time object if parsing is successful.
+      #
+      # @see WEEK_DAY
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.5.0
+      def parse_week_day(string)
+        week, day = string.match(WEEK_DAY)&.captures
+
+        if week && day
+          UnitMeasurements::Time.new(week, "wk") + UnitMeasurements::Time.new(day, "d")
+        end
+      end
+
+      # @private
+      # Parses a +string+ representing a time in the format of +month-day+
+      # into a +UnitMeasurements::Time+ object.
+      #
+      # @param [String] string
+      #   The string representing time measurement in the format of *month-day*.
+      # @return [UnitMeasurements::Time]
+      #   Returns a UnitMeasurements::Time object if parsing is successful.
+      #
+      # @see MONTH_DAY
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.5.0
+      def parse_month_day(string)
+        month, day = string.match(MONTH_DAY)&.captures
+
+        if month && day
+          UnitMeasurements::Time.new(month, "mo") + UnitMeasurements::Time.new(day, "d")
+        end
+      end
+
+      # @private
+      # Parses a +string+ representing a time in the format of +second-millisecond+
+      # into a +UnitMeasurements::Time+ object.
+      #
+      # @param [String] string
+      #   The string representing time measurement in the format of *second-millisecond*.
+      # @return [UnitMeasurements::Time]
+      #   Returns a UnitMeasurements::Time object if parsing is successful.
+      #
+      # @see SECOND_MILLISECOND
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.6.0
+      def parse_second_millisecond(string)
+        second, millisecond = string.match(SECOND_MILLISECOND)&.captures
+
+        if second && millisecond
+          UnitMeasurements::Time.new(second, "s") + UnitMeasurements::Time.new(millisecond, "ms")
+        end
+      end
+
+      # @private
+      # Parses a +string+ representing a time in the format of +year-month+
+      # into a +UnitMeasurements::Time+ object.
+      #
+      # @param [String] string
+      #   The string representing time measurement in the format of *year-month*.
+      # @return [UnitMeasurements::Time]
+      #   Returns a UnitMeasurements::Time object if parsing is successful.
+      #
+      # @see YEAR_MONTH
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.6.0
+      def parse_year_month(string)
+        year, month = string.match(YEAR_MONTH)&.captures
+
+        if year && month
+          UnitMeasurements::Time.new(year, "yr") + UnitMeasurements::Time.new(month, "mo")
+        end
       end
     end
 
@@ -95,6 +210,42 @@ module CompositeUnitMeasurements
     # @since 0.3.0
     MINUTE_ALIASES = /(?:min|minute(?:s)?)/.freeze
 
+    # Regex pattern for aliases of +second+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.5.0
+    SECOND_ALIASES = /(?:s|sec|second(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +millisecond+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.6.0
+    MILLISECOND_ALIASES = /(?:ms|millisec|millisecond(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +day+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.5.0
+    DAY_ALIASES = /(?:d|day(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +week+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.5.0
+    WEEK_ALIASES = /(?:wk|week(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +month+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.5.0
+    MONTH_ALIASES = /(?:mo|month(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +year+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.6.0
+    YEAR_ALIASES = /(?:y|yr|year(?:s)?)/.freeze
+
     # Regex pattern for parsing a time measurement in the format of +hour-minute+.
     #
     # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
@@ -108,6 +259,39 @@ module CompositeUnitMeasurements
     # @since 0.2.0
     DURATION = /\A(?<hour>#{REAL_NUMBER}):(?<min>#{REAL_NUMBER}):(?:(?<sec>#{REAL_NUMBER}))?(?:,(?<msec>#{REAL_NUMBER}))?\z/.freeze
 
-    private_constant :HOUR_ALIASES, :MINUTE_ALIASES, :HOUR_MINUTE, :DURATION
+    # Regex pattern for parsing a time measurement in the format of +minute-second+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.5.0
+    MINUTE_SECOND = /\A#{ANY_NUMBER}\s*#{MINUTE_ALIASES}\s*#{ANY_NUMBER}\s*#{SECOND_ALIASES}\z/.freeze
+
+    # Regex pattern for parsing a time measurement in the format of +week-day+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.5.0
+    WEEK_DAY = /\A#{ANY_NUMBER}\s*#{WEEK_ALIASES}\s*#{ANY_NUMBER}\s*#{DAY_ALIASES}\z/.freeze
+
+    # Regex pattern for parsing a time measurement in the format of +month-day+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.5.0
+    MONTH_DAY = /\A#{ANY_NUMBER}\s*#{MONTH_ALIASES}\s*#{ANY_NUMBER}\s*#{DAY_ALIASES}\z/.freeze
+
+    # Regex pattern for parsing a time measurement in the format of +second-millisecond+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.6.0
+    SECOND_MILLISECOND = /\A#{ANY_NUMBER}\s*#{SECOND_ALIASES}\s*#{ANY_NUMBER}\s*#{MILLISECOND_ALIASES}\z/.freeze
+
+    # Regex pattern for parsing a time measurement in the format of +year-month.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.6.0
+    YEAR_MONTH = /\A#{ANY_NUMBER}\s*#{YEAR_ALIASES}\s*#{ANY_NUMBER}\s*#{MONTH_ALIASES}\z/.freeze
+
+    private_constant :HOUR_ALIASES, :MINUTE_ALIASES, :SECOND_ALIASES, :DAY_ALIASES,
+                     :WEEK_ALIASES, :MONTH_ALIASES, :YEAR_ALIASES, :MILLISECOND_ALIASES,
+                     :HOUR_MINUTE, :DURATION, :MINUTE_SECOND, :WEEK_DAY, :MONTH_DAY,
+                     :SECOND_MILLISECOND, :YEAR_MONTH
   end
 end

data/lib/composite_unit_measurements/version.rb

@@ -25,5 +25,5 @@
 # @since 0.1.0
 module CompositeUnitMeasurements
   # Current stable version
-  VERSION = "0.4.0"
+  VERSION = "0.6.0"
 end

data/lib/composite_unit_measurements/weight.rb

@@ -14,12 +14,14 @@ module CompositeUnitMeasurements
     class << self
       # Parses a given +string+ into a +UnitMeasurements::Weight+ object.
       #
-      # @example Parse 'kilogramme-gramme' measurement:
-      #   CompositeUnitMeasurements::Weight.parse("4 kg 500 g") #=> 4.5 kg
       # @example Parse 'pound-ounce' measurement:
       #   CompositeUnitMeasurements::Weight.parse("8 lb 12 oz") #=> 8.75 lb
       # @example Parse 'stone-pound' measurement:
       #   CompositeUnitMeasurements::Weight.parse("2 st 6 lb") #=> 2.428571428571429 st
+      # @example Parse 'kilogramme-gramme' measurement:
+      #   CompositeUnitMeasurements::Weight.parse("4 kg 500 g") #=> 4.5 kg
+      # @example Parse 'tonne-kilogramme' measurement:
+      #   CompositeUnitMeasurements::Weight.parse("1 t 500 kg") #=> 1.5 t
       #
       # @param [String] string The string to parse for weight measurement.
       # @return [UnitMeasurements::Weight]
@@ -34,6 +36,7 @@ module CompositeUnitMeasurements
         when POUND_OUNCE       then parse_pound_ounce(string)
         when STONE_POUND       then parse_stone_pound(string)
         when KILOGRAMME_GRAMME then parse_kilogramme_gramme(string)
+        when TONNE_KILOGRAMME  then parse_tonne_kilogramme(string)
         else                        raise UnitMeasurements::ParseError, string
         end
       end
@@ -99,6 +102,26 @@ module CompositeUnitMeasurements
           UnitMeasurements::Weight.new(kilogramme, "kg") + UnitMeasurements::Weight.new(gramme, "g")
         end
       end
+
+      # @private
+      # Parses a +string+ representing a weight in the format of +tonne-kilogramme+
+      # into a +UnitMeasurements::Weight+ object.
+      #
+      # @param [String] string
+      #   The string representing weight measurement in the format of *tonne-kilogramme*.
+      # @return [UnitMeasurements::Weight]
+      #   Returns a UnitMeasurements::Weight object if parsing is successful.
+      #
+      # @see TONNE_KILOGRAMME
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.6.0
+      def parse_tonne_kilogramme(string)
+        tonne, kilogramme = string.match(TONNE_KILOGRAMME)&.captures
+
+        if tonne && kilogramme
+          UnitMeasurements::Weight.new(tonne, "t") + UnitMeasurements::Weight.new(kilogramme, "kg")
+        end
+      end
     end
 
     # Regex pattern for aliases of +pound+ unit.
@@ -131,6 +154,12 @@ module CompositeUnitMeasurements
     # @since 0.3.0
     KILOGRAMME_ALIASES = /(?:kg|kilogram(?:s)?|kilogramme(?:s)?)/.freeze
 
+    # Regex pattern for aliases of +tonne+ or +metric tonne+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.6.0
+    TONNE_ALIASES = /(?:t|tonne(?:s)?|metric tonne(?:s)?)/.freeze
+
     # Regex pattern for parsing a weight measurement in the format of +pound-ounce+.
     #
     # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
@@ -149,7 +178,14 @@ module CompositeUnitMeasurements
     # @since 0.3.0
     KILOGRAMME_GRAMME = /\A#{ANY_NUMBER}\s*#{KILOGRAMME_ALIASES}\s*#{ANY_NUMBER}\s*#{GRAMME_ALIASES}\z/.freeze
 
-    private_constant :KILOGRAMME_GRAMME, :POUND_ALIASES, :OUNCE_ALIASES, :STONE_ALIASES ,
-                     :GRAMME_ALIASES, :KILOGRAMME_ALIASES, :POUND_OUNCE, :STONE_POUND
+    # Regex pattern for parsing a weight measurement in the format of +tonne-kilogramme+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.6.0
+    TONNE_KILOGRAMME  = /\A#{ANY_NUMBER}\s*#{TONNE_ALIASES}\s*#{ANY_NUMBER}\s*#{KILOGRAMME_ALIASES}\z/.freeze
+
+    private_constant :POUND_ALIASES, :OUNCE_ALIASES, :STONE_ALIASES, :GRAMME_ALIASES,
+                     :KILOGRAMME_ALIASES, :TONNE_ALIASES, :POUND_OUNCE, :STONE_POUND,
+                     :KILOGRAMME_GRAMME, :TONNE_KILOGRAMME
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: composite_unit_measurements
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Harshal LADHE
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-12-08 00:00:00.000000000 Z
+date: 2025-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport