composite_unit_measurements 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e212c20da9787a853fef2791d5f95d0004e5e45225c3809088205a1375b600c
-  data.tar.gz: 8b2c03cfdfba50cc0e13088bbfb8910afd249b98ec4048280441131f47a310f5
+  metadata.gz: cd67813e0e00bce4c907e7076ec4a62994570585875da38dfa72bc968b3c0c20
+  data.tar.gz: c9de7ccfd6e0ede94d8cd5976174a1a60ed4f4cf3566bc613349a211ea9e4309
 SHA512:
-  metadata.gz: c1a6c264037d7db78d70676137d60a1085bb7126034674c6156de7806ef9c76263a8acd8bd4125fa3655d1c6c64c1ccec3bdd04d004dcc93dbd0e4ad6e056c86
-  data.tar.gz: 394309d1a68c9eed5548f446fe3816ae467c7f2f6c4e66428d9957ae1ca5ed376659e4c7ff4fe1adc731cee85a8ea340577d120c65038b312398cf8f10dde6af
+  metadata.gz: 7291bb98bb1e404be485f5f89de9f7594a7093f89cb98c4fd27310051804bfd22ea891acdfffed137ed466b0d9e778d6034439561dffe5e1e5b8b354093044b0
+  data.tar.gz: d86f50e73b9044cd8248bf49454c8c036a99b0bd2577fe21554b2c52ff14d1951bf19a11c388b9c0ddfed1670a1d315b054cda0d191909b1ae29cdc8793bf1e9

data/CHANGELOG.md

@@ -1,3 +1,25 @@
+## [0.3.0](https://github.com/shivam091/composite_unit_measurements/compare/v0.2.0...v0.3.0) - 2023-11-27
+
+### What's new
+
+- Added ability to parse `kilometre-metre` and `metre-centimetre` length measurements.
+- Added ability to parse `hour-minute` time measurement.
+- Added ability to parse `kilogramme-gramme` weight measurement.
+
+-----------
+
+## [0.2.0](https://github.com/shivam091/composite_unit_measurements/compare/v0.1.0...v0.2.0) - 2023-11-17
+
+### What's new
+
+- Added ability to parse composite measurements containing `real`, `scientific`,
+  `rational`, and `complex` numbers.
+- Added ability to parse `foot-inch` length measurement.
+- Added ability to parse `duration`.
+- Added ability to parse `pound-ounce` and `stone-pound` weight measurement.
+
+-----------
+
 ## 0.1.0 - 2023-11-09
 
 ### Initial release

data/Gemfile.lock

@@ -1,14 +1,14 @@
 PATH
   remote: .
   specs:
-    composite_unit_measurements (0.1.0)
+    composite_unit_measurements (0.3.0)
       activesupport (~> 7.0)
       unit_measurements (~> 5)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.1.1)
+    activesupport (7.1.2)
       base64
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.0.2)
@@ -54,7 +54,7 @@ GEM
     simplecov_json_formatter (0.1.4)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unit_measurements (5.8.0)
+    unit_measurements (5.11.1)
       activesupport (~> 7.0)
 
 PLATFORMS

data/README.md

@@ -1,6 +1,6 @@
 # Composite Unit Measurements
 
-A set of specialized parsers for dealing with composite measurement strings.
+A collection of specialized parsers designed for handling composite measurement strings.
 
 [![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)
@@ -13,17 +13,18 @@ A set of specialized parsers for dealing with composite measurement strings.
 
 ## Introduction
 
-The `CompositeUnitMeasurements` gem is a versatile solution tailored for parsing
-composite measurement strings. By harnessing the capabilities of the `unit_measurements`
-gem, it empowers you to seamlessly handle composite measurements in various units.
+The `CompositeUnitMeasurements` gem offers versatile parsers for efficiently parsing
+composite measurement strings. Leveraging the power of the `unit_measurements` gem,
+it enables smooth handling of composite measurements in various units.
 
 ## Minimum Requirements
 
-* Ruby 3.2.2+ (https://www.ruby-lang.org/en/downloads/branches/)
+* Ruby 3.2.2+ ([Download Ruby](https://www.ruby-lang.org/en/downloads/branches/))
 
 ## Installation
 
-If using bundler, first add this line to your application's Gemfile:
+To use `composite_unit_measurements-rails` in your Rails application, add the
+following line to your Gemfile:
 
 ```ruby
 gem "composite_unit_measurements"
@@ -37,13 +38,106 @@ Or otherwise simply install it yourself as:
 
 `$ gem install composite_unit_measurements`
 
+## Usage
+
+Each packaged parser includes the `#parse` method to parse composite measurements.
+You can use an appropriate parser to parse measurements. The final result of `#parse`
+is returned in the leftmost unit of your measurement.
+
+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).
+
+### Examples
+
+**Parsing length measurements:**
+
+```ruby
+CompositeUnitMeasurements::Length.parse("5 ft 6 in")
+#=> 5.5 ft
+CompositeUnitMeasurements::Length.parse("6 m 50 cm")
+#=> 6.5 m
+CompositeUnitMeasurements::Length.parse("5 km 500 m")
+#=> 5.5 km
+```
+
+**Parsing weight measurements:**
+
+```ruby
+CompositeUnitMeasurements::Weight.parse("8 lb 12 oz")
+#=> 8.75 lb
+CompositeUnitMeasurements::Weight.parse("2 st 6 lb")
+#=> 2.428571428571429 st
+CompositeUnitMeasurements::Weight.parse("2 st 6 lb")
+# 4.5 kg
+```
+
+**Parsing time measurements:**
+
+```ruby
+CompositeUnitMeasurements::Time.parse("3 h 45 min")
+#=> 3.75 hx
+CompositeUnitMeasurements::Time.parse("12:60:3600,360000000")
+#=> 14.1 h
+```
+
+### Support for numeric types
+
+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
+CompositeUnitMeasurements::Length.parse("1.5 ft 12e2 in")
+#=> 101.5 ft
+CompositeUnitMeasurements::Length.parse("1 1/2 ft 1+2i in")
+#=> 1.5833333333333333+0.16666666666666669i ft
+CompositeUnitMeasurements::Length.parse("2 ft 1+2i in")
+#=> 2.0833333333333335+0.16666666666666669i ft
+CompositeUnitMeasurements::Length.parse("1e-2 ft 1+2i in")
+#=> 0.09333333333333334+0.16666666666666669i ft
+```
+
+## Packaged parsers & supported composite measurements
+
+The `composite_unit_measurements` gem supports parsing various composite measurements, including:
+
+**1. CompositeUnitMeasurements::Length**
+- foot-inch (5 ft 6 in)
+- metre-centimetre (6 m 50 cm)
+- kilometre-metre (5 km 500 m)
+
+**2. CompositeUnitMeasurements::Weight**
+- pound-ounce (8 lb 12 oz)
+- stone-pound (2 st 6 lb)
+- kilogramme-gramme (4 kg 500 g)
+
+**3. CompositeUnitMeasurements::Time**
+- hour-minute (3 h 45 min)
+- hour-minute-second-microsecond (12:60,3600:360000000)
+
+### Specifing parsers
+
+By default, `composite_unit_measurements` includes all packaged parsers automatically
+when required in your application. However, you can opt to use specific parsers as
+needed:
+
+```ruby
+require "composite_unit_measurements/base"
+
+require "composite_unit_measurements/length"
+require "composite_unit_measurements/weight"
+```
+
 ## Contributing
 
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
+Contributions to this project are welcomed! To contribute:
+
+1. Fork this repository
+2. Create a new branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am "Add some feature"`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+4. Push the changes to your branch (`git push origin my-new-feature`)
+5. Create new **Pull Request**
 
 ## License
 

data/lib/composite_unit_measurements/base.rb

@@ -5,3 +5,53 @@
 require "unit_measurements/base"
 
 require "composite_unit_measurements/version"
+
+module CompositeUnitMeasurements
+  # Matches real numbers in the form of 31, +72, or -12.
+  REAL_NUMBER = /
+    (?:                   # Start of non-capturing group
+      [+-]?               # Optional plus (+) or minus (-) sign
+      \d+                 # One or more digits
+    )                     # End of non-capturing group
+  /x.freeze
+
+  # Matches a rational number in the form of a/b (fractional) or a b/c (mixed fractional).
+  RATIONAL_NUMBER = /
+    (?:                   # Start of optional non-capturing group
+      [+-]?               # Optional plus (+) or minus (-) sign
+      \d+                 # One or more digits
+      \s+                 # One or more whitespace
+    )?                    # End of optional non-capturing group
+    (                     # Start of capturing group for the fraction
+      (\d+)               # Capture the numerator (one or more digits)
+      \/                  # Match the forward slash, indicating division
+      (\d+)               # Capture the denominator (one or more digits)
+    )                     # End of capturing group for the fraction
+  /x.freeze
+
+  # Matches a scientific number in various formats like 1.23E+4 or -5.67e-8.
+  SCIENTIFIC_NUMBER = /
+    (?:                   # Start of non-capturing group
+      [+-]?               # Optional plus (+) or minus (-) sign
+      \d*                 # Zero or more digits (integer part)
+      \.?                 # Optional decimal point
+      \d+                 # One or more digits (fractional part)
+      (?:                 # Start of non-capturing group for exponent part
+        [Ee]              # Match 'E' or 'e' for exponentiation
+        [+-]?             # Optional plus (+) or minus (-) sign for exponent
+        \d+               # One or more digits (exponent value)
+      )?                  # End of non-capturing group of exponent part (optional)
+    )                     # End of non-capturing group
+  /x.freeze
+
+  # Matches complex numbers in the form of a+bi, where both 'a' and 'b' can be
+  # in scientific notation. It captures the real and imaginary parts.
+  COMPLEX_NUMBER = /
+    #{SCIENTIFIC_NUMBER}  # Pattern for scientific number
+    #{SCIENTIFIC_NUMBER}  # Pattern for scientific number
+    i                     # Match the letter 'i' (the imaginary unit)
+  /x.freeze
+
+  # Matches any number, including scientific, complex, rational, and real numbers.
+  ANY_NUMBER = /(?<number>#{SCIENTIFIC_NUMBER}|#{COMPLEX_NUMBER}|#{RATIONAL_NUMBER}|#{REAL_NUMBER})/.freeze
+end

data/lib/composite_unit_measurements/length.rb

@@ -0,0 +1,145 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+require "unit_measurements/unit_groups/length"
+
+module CompositeUnitMeasurements
+  # A parser handling +length+ measurements, particularly for composite units
+  # like +foot-inch+, +kilometre-metre+, +mile-yard+, etc.
+  #
+  # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+  # @since 0.2.0
+  class Length
+    class << self
+      # Parses a given +string+ into a +UnitMeasurements::Length+ object.
+      #
+      # @param [String] string The string to parse for length measurement.
+      # @return [UnitMeasurements::Length]
+      #   Returns a UnitMeasurements::Length object if parsing is successful.
+      #
+      # @raise [UnitMeasurements::ParseError]
+      #   If the string does not match any known format.
+      #
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.2.0
+      def parse(string)
+        case string
+        when FOOT_INCH        then parse_foot_inch(string)
+        when KILOMETRE_METRE  then parse_kilometre_metre(string)
+        when METRE_CENTIMETRE then parse_metre_centimetre(string)
+        else                       raise UnitMeasurements::ParseError, string
+        end
+      end
+
+      private
+
+      # @private
+      # Parses a +string+ representing a length in the format of +foot-inch+.
+      #
+      # @param [String] string
+      #   The string representing length measurement in the format of *foot-inch*.
+      # @return [UnitMeasurements::Length]
+      #   Returns a UnitMeasurements::Length object if parsing is successful.
+      #
+      # @see FOOT_INCH
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.2.0
+      def parse_foot_inch(string)
+        foot, inch = string.match(FOOT_INCH)&.captures
+
+        if foot && inch
+          UnitMeasurements::Length.new(foot, "ft") + UnitMeasurements::Length.new(inch, "in")
+        end
+      end
+
+      # @private
+      # Parses a +string+ representing a length in the format of +metre-centimetre+.
+      #
+      # @param [String] string
+      #   The string representing length measurement in the format of *metre-centimetre*.
+      # @return [UnitMeasurements::Length]
+      #   Returns a UnitMeasurements::Length object if parsing is successful.
+      #
+      # @see METRE_CENTIMETRE
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.3.0
+      def parse_metre_centimetre(string)
+        metre, centimetre = string.match(METRE_CENTIMETRE)&.captures
+
+        if metre && centimetre
+          UnitMeasurements::Length.new(metre, "m") + UnitMeasurements::Length.new(centimetre, "cm")
+        end
+      end
+
+      # @private
+      # Parses a +string+ representing a length in the format of +kilometre-metre+.
+      #
+      # @param [String] string
+      #   The string representing length measurement in the format of *kilometre-metre*.
+      # @return [UnitMeasurements::Length]
+      #   Returns a UnitMeasurements::Length object if parsing is successful.
+      #
+      # @see KILOMETRE_METRE
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.3.0
+      def parse_kilometre_metre(string)
+        kilometre, metre = string.match(KILOMETRE_METRE)&.captures
+
+        if kilometre && metre
+          UnitMeasurements::Length.new(kilometre, "km") + UnitMeasurements::Length.new(metre, "m")
+        end
+      end
+    end
+
+    private
+
+    # Regex pattern for aliases of +foot+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.2.0
+    FOOT_ALIASES = /(?:'|ft|foot|feet)/.freeze
+
+    # Regex pattern for aliases of +inch+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.2.0
+    INCH_ALIASES = /(?:"|in|inch(?:es)?)/.freeze
+
+    # Regex pattern for aliases of +metre+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.3.0
+    METRE_ALIASES = /(?:m|meter(?:s)?|metre(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +centimetre+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.3.0
+    CENTIMETRE_ALIASES = /(?:cm|centimeter(?:s)?|centimetre(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +kilometre+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.3.0
+    KILOMETRE_ALIASES = /(?:km|kilometer(?:s)?|kilometre(?:s)?)/.freeze
+
+    # Regex pattern for parsing a length measurement in the format of +foot-inch+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.2.0
+    FOOT_INCH = /\A#{ANY_NUMBER}\s*#{FOOT_ALIASES}\s*#{ANY_NUMBER}\s*#{INCH_ALIASES}\z/.freeze
+
+    # Regex pattern for parsing a length measurement in the format of +metre-centimetre+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.3.0
+    METRE_CENTIMETRE = /\A#{ANY_NUMBER}\s*#{METRE_ALIASES}\s*#{ANY_NUMBER}\s*#{CENTIMETRE_ALIASES}\z/.freeze
+
+    # Regex pattern for parsing a length measurement in the format of +kilometre-metre+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.3.0
+    KILOMETRE_METRE = /\A#{ANY_NUMBER}\s*#{KILOMETRE_ALIASES}\s*#{ANY_NUMBER}\s*#{METRE_ALIASES}\z/.freeze
+  end
+end

data/lib/composite_unit_measurements/time.rb

@@ -0,0 +1,105 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+require "unit_measurements/unit_groups/time"
+
+module CompositeUnitMeasurements
+  # A parser handling +time+ measurements, particularly for composite units
+  # like +hour:minute:second,microsecond+, +minute-second+, +hour-minute+, etc.
+  #
+  # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+  # @since 0.2.0
+  class Time
+    class << self
+      # Parses a given +string+ into a +UnitMeasurements::Time+ object.
+      #
+      # @param [String] string The string to parse for time measurement.
+      # @return [UnitMeasurements::Time]
+      #   Returns a UnitMeasurements::Time object if parsing is successful.
+      # @raise [UnitMeasurements::ParseError]
+      #   If the string does not match any known format.
+      #
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @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
+        end
+      end
+
+      private
+
+      # @private
+      # Parses a +string+ representing a time in the format of +hour-minute+.
+      #
+      # @param [String] string
+      #   The string representing time measurement in the format of *hour-minute*.
+      # @return [UnitMeasurements::Time]
+      #   Returns a UnitMeasurements::Time object if parsing is successful.
+      #
+      # @see HOUR_MINUTE
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.3.0
+      def parse_hour_minute(string)
+        hour, minute = string.match(HOUR_MINUTE)&.captures
+
+        if hour && minute
+          UnitMeasurements::Time.new(hour, "h") + UnitMeasurements::Time.new(minute, "min")
+        end
+      end
+
+      # @private
+      # Parses a +string+ representing time duration in the format of
+      # +hour:minute:second,microsecond+ or +hour:minute:second+.
+      #
+      # @param [String] string The string representing time duration.
+      # @return [UnitMeasurements::Time]
+      #   Returns a UnitMeasurements::Time object if parsing is successful.
+      # @raise [ArgumentError]
+      #   Raises an ArgumentError for an invalid duration format.
+      #
+      # @see DURATION
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.2.0
+      def parse_duration(string)
+        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)
+      end
+    end
+
+    private
+
+    # Regex pattern for aliases of +hour+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.3.0
+    HOUR_ALIASES = /(?:h|hr|hour(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +minute+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.3.0
+    MINUTE_ALIASES = /(?:min|minute(?:s)?)/.freeze
+
+    # Regex pattern for parsing a time measurement in the format of +hour-minute+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.3.0
+    HOUR_MINUTE = /\A#{ANY_NUMBER}\s*#{HOUR_ALIASES}\s*#{ANY_NUMBER}\s*#{MINUTE_ALIASES}\z/.freeze
+
+    # Regex pattern for parsing duration in the format of +hour:minute:second+ or
+    # +hour:minute:second,microsecond+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.2.0
+    DURATION = /\A(?<hour>#{REAL_NUMBER}):(?<min>#{REAL_NUMBER}):(?:(?<sec>#{REAL_NUMBER}))?(?:,(?<msec>#{REAL_NUMBER}))?\z/.freeze
+  end
+end

data/lib/composite_unit_measurements/version.rb

@@ -2,6 +2,28 @@
 # -*- frozen_string_literal: true -*-
 # -*- warn_indent: true -*-
 
+# This module provides parsers and utilities for handling composite unit measurements.
+# It allows parsing and manipulation of various composite measurements for units of
+# +length+, +weight+, +time+ etc.
+#
+# @note
+#   This module serves as a namespace for classes and utilities related to composite
+#   unit measurements. To parse such measurements, refer to individual classes like
+#   {Length}, {Weight}, {Time}, etc. within this module.
+#
+# @example
+#   CompositeUnitMeasurements::Length.parse("5 feet 12 inches")
+#   => 6.0 ft
+#
+#   CompositeUnitMeasurements::Weight.parse("8 lb 12 oz")
+#   => 8.75 lb
+#
+#   CompositeUnitMeasurements::Time.parse("3 h 45 min")
+#   => 3.75 h
+#
+# @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+# @since 0.1.0
 module CompositeUnitMeasurements
-  VERSION = "0.1.0"
+  # Current stable version
+  VERSION = "0.3.0"
 end

data/lib/composite_unit_measurements/weight.rb

@@ -0,0 +1,144 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+require "unit_measurements/unit_groups/weight"
+
+module CompositeUnitMeasurements
+  # A parser handling +weight+ measurements, particularly for composite units
+  # like +pound-ounce+, +stone-pound+, +kilogramme-gramme+, etc.
+  #
+  # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+  # @since 0.2.0
+  class Weight
+    class << self
+      # Parses a given +string+ into a +UnitMeasurements::Weight+ object.
+      #
+      # @param [String] string The string to parse for weight measurement.
+      # @return [UnitMeasurements::Weight]
+      #   Returns a UnitMeasurements::Weight object if parsing is successful.
+      # @raise [UnitMeasurements::ParseError]
+      #   If the string does not match any known format.
+      #
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.2.0
+      def parse(string)
+        case string
+        when POUND_OUNCE       then parse_pound_ounce(string)
+        when STONE_POUND       then parse_stone_pound(string)
+        when KILOGRAMME_GRAMME then parse_kilogramme_gramme(string)
+        else                        raise UnitMeasurements::ParseError, string
+        end
+      end
+
+      private
+
+      # @private
+      # Parses a +string+ representing a weight in the format of +pound-ounce+.
+      #
+      # @param [String] string
+      #   The string representing weight measurement in the format of *pound-ounce*.
+      # @return [UnitMeasurements::Weight]
+      #   Returns a UnitMeasurements::Weight object if parsing is successful.
+      #
+      # @see POUND_OUNCE
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.2.0
+      def parse_pound_ounce(string)
+        pound, ounce = string.match(POUND_OUNCE)&.captures
+
+        if pound && ounce
+          UnitMeasurements::Weight.new(pound, "lb") + UnitMeasurements::Weight.new(ounce, "oz")
+        end
+      end
+
+      # @private
+      # Parses a +string+ representing a weight in the format of +stone-pound+.
+      #
+      # @param [String] string
+      #   The string representing weight measurement in the format of *stone-pound*.
+      # @return [UnitMeasurements::Weight]
+      #   Returns a UnitMeasurements::Weight object if parsing is successful.
+      #
+      # @see STONE_POUND
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.2.0
+      def parse_stone_pound(string)
+        stone, pound = string.match(STONE_POUND)&.captures
+
+        if stone && pound
+          UnitMeasurements::Weight.new(stone, "st") + UnitMeasurements::Weight.new(pound, "lb")
+        end
+      end
+
+      # @private
+      # Parses a +string+ representing a weight in the format of +kilogramme-gramme+.
+      #
+      # @param [String] string
+      #   The string representing weight measurement in the format of *kilogramme-gramme*.
+      # @return [UnitMeasurements::Weight]
+      #   Returns a UnitMeasurements::Weight object if parsing is successful.
+      #
+      # @see KILOGRAMME_GRAMME
+      # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+      # @since 0.3.0
+      def parse_kilogramme_gramme(string)
+        kilogramme, gramme = string.match(KILOGRAMME_GRAMME)&.captures
+
+        if kilogramme && gramme
+          UnitMeasurements::Weight.new(kilogramme, "kg") + UnitMeasurements::Weight.new(gramme, "g")
+        end
+      end
+    end
+
+    private
+
+    # Regex pattern for aliases of +pound+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.2.0
+    POUND_ALIASES = /(?:#|lb|lbs|lbm|pound-mass|pound(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +ounce+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.2.0
+    OUNCE_ALIASES = /(?:oz|ounce(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +stone+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.2.0
+    STONE_ALIASES = /(?:st|stone(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +gramme+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.3.0
+    GRAMME_ALIASES = /(?:g|gram(?:s)?|gramme(?:s)?)/.freeze
+
+    # Regex pattern for aliases of +kilogramme+ unit.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.3.0
+    KILOGRAMME_ALIASES = /(?:kg|kilogram(?:s)?|kilogramme(?:s)?)/.freeze
+
+    # Regex pattern for parsing a weight measurement in the format of +pound-ounce+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.2.0
+    POUND_OUNCE = /\A#{ANY_NUMBER}\s*#{POUND_ALIASES}\s*#{ANY_NUMBER}\s*#{OUNCE_ALIASES}\z/.freeze
+
+    # Regex pattern for parsing a weight measurement in the format of +stone-pound+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.2.0
+    STONE_POUND = /\A#{ANY_NUMBER}\s*#{STONE_ALIASES}\s*#{ANY_NUMBER}\s*#{POUND_ALIASES}\z/.freeze
+
+    # Regex pattern for parsing a weight measurement in the format of +kilogramme-gramme+.
+    #
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 0.3.0
+    KILOGRAMME_GRAMME = /\A#{ANY_NUMBER}\s*#{KILOGRAMME_ALIASES}\s*#{ANY_NUMBER}\s*#{GRAMME_ALIASES}\z/.freeze
+  end
+end

data/lib/composite_unit_measurements.rb

@@ -2,8 +2,8 @@
 # -*- frozen_string_literal: true -*-
 # -*- warn_indent: true -*-
 
-require "composite_unit_measurements/version"
+require "composite_unit_measurements/base"
 
-module CompositeUnitMeasurements
-  class Error < StandardError; end
-end
+require "composite_unit_measurements/length"
+require "composite_unit_measurements/time"
+require "composite_unit_measurements/weight"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: composite_unit_measurements
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Harshal LADHE
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-11-09 00:00:00.000000000 Z
+date: 2023-11-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -121,7 +121,10 @@ files:
 - composite_unit_measurements.gemspec
 - lib/composite_unit_measurements.rb
 - lib/composite_unit_measurements/base.rb
+- lib/composite_unit_measurements/length.rb
+- lib/composite_unit_measurements/time.rb
 - lib/composite_unit_measurements/version.rb
+- lib/composite_unit_measurements/weight.rb
 homepage: https://github.com/shivam091/composite_unit_measurements
 licenses:
 - MIT