unit_measurements 5.14.0 → 5.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d59abc6cd3128c515be37c2e7bcc40cbbaa73530a4a5ed1ce6d5e7093202e063
-  data.tar.gz: 22091e2ce789b4a064fb0f06fb704805b69cc86601334ab4d9f8a7afe9c6a0fd
+  metadata.gz: fcdf50759b2e50022f7dc5b4661a5ad149c781f0cc39f1f6f1c21825b8dec89d
+  data.tar.gz: 6ca3e101ab49cce3c7f6b6c177373cf70187e677135f9daee6ee33d7a8154bf2
 SHA512:
-  metadata.gz: 4e16e3e25e06d155664fab616cf4e3147d75cf4aef71c15c6312572418fd124d11436c402fbe7e83e984e483c737a073ad180947f0ee071fab170a59c8f880a4
-  data.tar.gz: b6e6bd19810a115b48d7107859b82e21d8b5dc231455d8a995a9ea5157c44d38c53c287a15945a342f1b376fcfe80b539de29ad1be9ca112e5750ac866013cbc
+  metadata.gz: 80b49c55971a01de943c2b7b5638debc16a49c9c68ee38bf84df62168a1d366fa80c12870cf483564350127b7bbc17cbb012e9947ecba7076699e4300458f248
+  data.tar.gz: c185e222fc88a2bc91ad232a004ef31e22669b16c4690eaefeff12b16e665d9cb6964f2504339fb0a70d0aa5f668fd085113a7232b9b08df93217f72f273bcd0

data/CHANGELOG.md

@@ -1,8 +1,24 @@
+## [5.16.0](https://github.com/shivam091/unit_measurements/compare/v5.15.0...v5.16.0) - 2023-12-13
+
+### What's new
+
+- Added planck units and their conversions.
+
+----------
+
+## [5.15.0](https://github.com/shivam091/unit_measurements/compare/v5.14.0...v5.15.0) - 2023-12-11
+
+### What's new
+
+- Added `.define_conversion_methods` method to define conversion helper methods for units.
+
+----------
+
 ## [5.14.0](https://github.com/shivam091/unit_measurements/compare/v5.13.0...v5.14.0) - 2023-11-29
 
 ### What's new
 
-- Added `.define_numeric_methods` support to define numeric extension methods for units.
+- Added `.define_numeric_methods` method to define numeric extension methods for units.
 
 ----------
 

data/Gemfile.lock

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

data/README.md

@@ -9,7 +9,7 @@ A library that encapsulate measurements and their units in Ruby.
 [![Test Coverage](https://api.codeclimate.com/v1/badges/b8aec9bffa356d108784/test_coverage)](https://codeclimate.com/github/shivam091/unit_measurements/test_coverage)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/shivam091/unit_measurements/blob/main/LICENSE.md)
 
-[Harshal V. Ladhe, Master of Computer Science.](https://shivam091.github.io)
+**[Harshal V. Ladhe, Master of Computer Science.](https://shivam091.github.io)**
 
 ## Introduction
 
@@ -43,11 +43,11 @@ Users are advised to cross-verify conversions for their specific use cases._
 
 ## 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 `unit_measurements` in your Rails application, add the following line to your Gemfile:
 
 ```ruby
 gem "unit_measurements"
@@ -87,8 +87,7 @@ viz., `UnitMeasurements::Weight`, `UnitMeasurements::Length`, etc.
 **Initialize a measurement:**
 
 ```ruby
-UnitMeasurements::Length.new(1, "km")
-#=> 1 km
+UnitMeasurements::Length.new(1, "km") #=> 1 km
 ```
 
 **Converting to other units:**
@@ -102,22 +101,19 @@ These methods provide `use_cache` parameter which defaults to `false` to indicat
 You can use `#convert_to` as:
 
 ```ruby
-UnitMeasurements::Length.new(1, "km").convert_to("m", use_cache: true)
-#=> 1000.0 m
+UnitMeasurements::Length.new(1, "km").convert_to("m", use_cache: true) #=> 1000.0 m
 ```
 
 If you want to modify measurement object itself, you can use `#convert_to!` method as:
 
 ```ruby
-UnitMeasurements::Length.new(1, "km").convert_to!("m")
-#=> 1000.0 m
+UnitMeasurements::Length.new(1, "km").convert_to!("m") #=> 1000.0 m
 ```
 
 You can convert the measurement directly to the `primitive` unit of the unit group as:
 
 ```ruby
-UnitMeasurements::Length.new(1, "cm").to_primitive
-#=> 0.01 m
+UnitMeasurements::Length.new(1, "cm").to_primitive #=> 0.01 m
 ```
 
 Note: `#to_primitive` method is aliased as `#in_primitive` and `#as_primitive`.
@@ -127,8 +123,7 @@ Note: `#to_primitive` method is aliased as `#in_primitive` and `#as_primitive`.
 This method provides `use_cache` parameter which defaults to `false` to indicate whether the caching of conversion factors should happen.
 
 ```ruby
-UnitMeasurements::Length.parse("1 km")
-#=> 1.0 km
+UnitMeasurements::Length.parse("1 km") #=> 1.0 km
 ```
 
 **Parse string that mentions quantity, source unit, and target unit:**
@@ -136,17 +131,14 @@ UnitMeasurements::Length.parse("1 km")
 A source unit can be separated from the target unit using the `in`, `to`, or `as` operators.
 
 ```ruby
-UnitMeasurements::Length.parse("1 km to m")
-#=> 1000.0 m
+UnitMeasurements::Length.parse("1 km to m") #=> 1000.0 m
 ```
 
 **Parse scientific numbers, source unit, and (or) target unit:**
 
 ```ruby
-UnitMeasurements::Length.parse("2e+2 km").convert_to("m")
-#=> 200000.0 m
-UnitMeasurements::Length.parse("2e+2 km to m")
-#=> 200000.0 m
+UnitMeasurements::Length.parse("2e+2 km").convert_to("m") #=> 200000.0 m
+UnitMeasurements::Length.parse("2e+2 km to m") #=> 200000.0 m
 ```
 You can check supported special characters for exponents
 [here](https://shivam091.github.io/unit_measurements/UnitMeasurements/Normalizer.html).
@@ -154,19 +146,15 @@ You can check supported special characters for exponents
 **Parse complex numbers, source unit, and (or) target unit:**
 
 ```ruby
-UnitMeasurements::Length.parse("2+3i km").convert_to("m")
-#=> 2000.0+3000.0i m
-UnitMeasurements::Length.parse("2+3i km to m")
-#=> 2000.0+3000.0i m
+UnitMeasurements::Length.parse("2+3i km").convert_to("m") #=> 2000.0+3000.0i m
+UnitMeasurements::Length.parse("2+3i km to m") #=> 2000.0+3000.0i m
 ```
 
 **Parse fractional/mixed fractional numbers, source unit, and (or) target unit:**
 
 ```ruby
-UnitMeasurements::Length.parse("2 ½ km").convert_to("m")
-#=> 2500.0 m
-UnitMeasurements::Length.parse("2/3 km to m")
-#=> 666.666666666667 m
+UnitMeasurements::Length.parse("2 ½ km").convert_to("m") #=> 2500.0 m
+UnitMeasurements::Length.parse("2/3 km to m") #=> 666.666666666667 m
 ```
 
 You can check supported special characters for fractional notations
@@ -175,17 +163,14 @@ You can check supported special characters for fractional notations
 **Parse ratios, source unit, and (or) target unit:**
 
 ```ruby
-UnitMeasurements::Length.parse("1:2 km").convert_to("m")
-#=> 500.0 m
-UnitMeasurements::Length.parse("1:2 km to m")
-#=> 500.0 m
+UnitMeasurements::Length.parse("1:2 km").convert_to("m") #=> 500.0 m
+UnitMeasurements::Length.parse("1:2 km to m") #=> 500.0 m
 ```
 
 **Calculate the ratio between two units:**
 
 ```ruby
-UnitMeasurements::Length.ratio("in", "ft")
-#=> "12.0 in/ft"
+UnitMeasurements::Length.ratio("in", "ft") #=> "12.0 in/ft"
 ```
 
 **Formatting measurement:**
@@ -194,8 +179,7 @@ If you want to format the measurement to certain format, you can use `#to_fs` me
 If format is not specified, it defaults to `"%.2<value>f %<unit>s"`.
 
 ```ruby
-UnitMeasurements::Length.new(100, "m").to("in").to_fs("%.4<quantity>f %<unit>s")
-#=> "3937.0079 in"
+UnitMeasurements::Length.new(100, "m").to("in").to_fs("%.4<quantity>f %<unit>s") #=> "3937.0079 in"
 ```
 
 You can check more about formatting along with their examples
@@ -205,26 +189,23 @@ You can check more about formatting along with their examples
 
 ```ruby
 length = UnitMeasurements::Length.new(1, "km")
-length.quantity
-#=> 1
-length.unit
-#=> #<UnitMeasurements::Unit: km (kilometer, kilometers, kilometre, kilometres)>
+length.quantity #=> 1
+length.unit #=> #<UnitMeasurements::Unit: km (kilometer, kilometers, kilometre, kilometres)>
 ```
 
 Unit object can be interrogated for a range of attributes:
 
 ```ruby
-length.unit.aliases # Alternative names for the unit.
-#=> #<Set: {"kilometer", "kilometers", "kilometre", "kilometres"}>
-length.unit.conversion_factor # Conversion factor relative to primitive unit.
-#=> 1000.0
+# Alternative names for the unit.
+length.unit.aliases #=> #<Set: {"kilometer", "kilometers", "kilometre", "kilometres"}>
+# Conversion factor relative to primitive unit.
+length.unit.conversion_factor #=> 1000.0
 ```
 
 **See primitive unit of the unit group:**
 
 ```ruby
-UnitMeasurements::Length.primitive
-#=> #<UnitMeasurements::Unit: m (meter, meters, metre, metres)>
+UnitMeasurements::Length.primitive #=> #<UnitMeasurements::Unit: m (meter, meters, metre, metres)>
 ```
 
 **See all units of the unit group:**
@@ -237,8 +218,7 @@ UnitMeasurements::Length.units
 **See names of all valid units of the unit group:**
 
 ```ruby
-UnitMeasurements::Length.unit_names
-#=> ["ft", "in", "m", "mi", "yd"]
+UnitMeasurements::Length.unit_names #=> ["ft", "in", "m", "mi", "yd"]
 ```
 
 **See all valid units of the unit group along with their aliases:**
@@ -251,8 +231,7 @@ UnitMeasurements::Length.unit_names_with_aliases
 **See list of unit systems defined within the unit group:**
 
 ```ruby
-UnitMeasurements::Length.systems
-#=> ["metric", "imperial", "us_customary", "astronomical"]
+UnitMeasurements::Length.systems #=> ["metric", "imperial", "us_customary", "astronomical"]
 ```
 
 **See list of units within the unit system:**
@@ -269,34 +248,26 @@ UnitMeasurements::Length.units_for("metric")
 **Finding units within the unit group:**
 
 You can use `#unit_for` or `#unit_for!` (aliased as `#[]`) methods to find units
-within the unit group. `#unit_for!` method returns an error if a unit is not present
-in the unit group.
+within the unit group. `#unit_for!` method returns an error if a unit system is not defined within the unit group.
 
 ```ruby
-UnitMeasurements::Length.unit_for("m")
-#=> #<UnitMeasurements::Unit: m (meter, meters, metre, metres)>
-UnitMeasurements::Length.unit_for("z")
-#=> nil
-UnitMeasurements::Length.unit_for!("z")
-#=> Invalid unit: 'z'. (UnitMeasurements::UnitError)
+UnitMeasurements::Length.unit_for("m") #=> #<UnitMeasurements::Unit: m (meter, meters, metre, metres)>
+UnitMeasurements::Length.unit_for("z") #=> nil
+UnitMeasurements::Length.unit_for!("z") #=> Invalid unit: 'z'. (UnitMeasurements::UnitError)
 ```
 
 **Finding whether the unit is defined within the unit group:**
 
 ```ruby
-UnitMeasurements::Length.defined?("m")
-#=> true
-UnitMeasurements::Length.defined?("metre")
-#=> false
+UnitMeasurements::Length.defined?("m") #=> true
+UnitMeasurements::Length.defined?("metre") #=> false
 ```
 
 **Check if the unit is a valid unit or alias within the unit group:**
 
 ```ruby
-UnitMeasurements::Length.unit_or_alias?("m")
-#=> true
-UnitMeasurements::Length.unit_or_alias?("metre")
-#=> true
+UnitMeasurements::Length.unit_or_alias?("m") #=> true
+UnitMeasurements::Length.unit_or_alias?("metre") #=> true
 ```
 
 **Clear cached data for the unit group:**
@@ -311,8 +282,7 @@ You have ability to compare the measurements with the same or different units wi
 For example, comparing length with length will work, comparing a length with a area would fail.
 
 ```ruby
-UnitMeasurements::Length.parse("1 km") != UnitMeasurements::Length.parse("1 m")
-#=> true
+UnitMeasurements::Length.parse("1 km") != UnitMeasurements::Length.parse("1 m") #=> true
 ```
 
 You can check supported comparisons along with their examples
@@ -326,10 +296,8 @@ measurement by either other measurement with compatible unit or numeric value.
 In cases of different units, the left hand side takes precedence.
 
 ```ruby
-UnitMeasurements::Length.new(1, "km") + UnitMeasurements::Length.new(1, "m")
-#=> 1.001 km
-UnitMeasurements::Length.new(2, "km") * 2+2i
-#=> 4+2i km
+UnitMeasurements::Length.new(1, "km") + UnitMeasurements::Length.new(1, "m") #=> 1.001 km
+UnitMeasurements::Length.new(2, "km") * 2+2i #=> 4+2i km
 ```
 
 You can check supported arithmetic operations along with their examples
@@ -340,8 +308,7 @@ You can check supported arithmetic operations along with their examples
 You can perform mathematical functions on the measurements.
 
 ```ruby
-UnitMeasurements::Length.new(17.625, "m").round
-#   => 18 m
+UnitMeasurements::Length.new(17.625, "m").round #=> 18 m
 ```
 
 You can check supported mathematical functions along with their examples
@@ -353,8 +320,7 @@ You can convert measurement quantity directly to other numeric types viz.
 `Integer`, `BigDecimal`, `Rational`, `Complex`, and `Float`.
 
 ```ruby
-UnitMeasurements::Length.new(2.25567, "km").to_i
-#=> 2 km
+UnitMeasurements::Length.new(2.25567, "km").to_i #=> 2 km
 ```
 
 You can check more about them along with their examples
@@ -484,13 +450,12 @@ Volume = UnitMeasurements::Volume
 
 ## Extras
 
-### Numeric extension methods
+### Numeric methods
 
-The `.define_numeric_methods` method allows you to instantiate measurements in a
-manner similar to how `ActiveSupport::Duration` objects are created in Rails,
-providing a familiar syntax and functionality.
+The `.define_numeric_methods` method allows you to define numeric methods that help you to initialize measurements in a
+manner similar to how `ActiveSupport::Duration` objects are created in Rails, providing a familiar syntax and functionality.
 
-To define numeric extension methods for specific units within a unit group, use
+To define numeric methods for specific units within the unit group, use
 the following syntax:
 
 ```ruby
@@ -500,21 +465,46 @@ UnitMeasurements::Length.define_numeric_methods("metre", "foot", "inch")
 This will enable the usage of these units as methods to instantiate and use measurements:
 
 ```ruby
-1.m                 #=> Instantiate a measurement representing 1 metre.
-5.feet              #=> Instantiate a measurement representing 5 feet.
-10.inches           #=> Instantiate a measurement representing 10 inches.
-1.foot == 12.inches #=> equality comparison between two measurements.
-1.ft + 12.in        #=> adds quantity of two measurements.
+# Initialize a measurement
+1.m       #=> 1 m
+5.feet    #=> 5 ft
+10.inches #=> 10 in
+
+# Usage
+## Equality comparison
+1.foot == 12.inches #=> true
+## Arithmetic operation
+1.ft + 12.in        #=> 2.0 ft
+```
+
+### Conversion methods
+
+The `.define_conversion_methods` method allows you to define conversion methods that
+help you to easily convert measurements to a different unit.
+
+To define conversion methods for specific units within the unit group, use the following syntax:
+
+```ruby
+UnitMeasurements::Length.define_conversion_methods("metre", "foot", "inch")
+```
+
+This will enable you to convert units as:
+
+```ruby
+UnitMeasurements::Length.new(1, "ft").in_inches #=> 12.0 in
+12.in.in_foot                                   #=> 1.0 ft
 ```
 
 ## 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
 
-Copyright 2023 [Harshal V. LADHE]((https://shivam091.github.io)), Released under the [MIT License](http://opensource.org/licenses/MIT).
+Copyright 2023 [Harshal V. LADHE](https://shivam091.github.io), Released under the [MIT License](http://opensource.org/licenses/MIT).

data/lib/unit_measurements/base.rb

@@ -152,6 +152,7 @@ end
 
 # The following requires load various components of the unit measurements library.
 require "unit_measurements/extras/numeric_methods"
+require "unit_measurements/extras/conversion_methods"
 
 require "unit_measurements/configuration"
 require "unit_measurements/cache"

data/lib/unit_measurements/extras/conversion_methods.rb

@@ -0,0 +1,87 @@
+# -*- encoding: utf-8 -*-
+# -*- frozen_string_literal: true -*-
+# -*- warn_indent: true -*-
+
+module UnitMeasurements
+  # This module provides functionality to define conversion methods for a list
+  # of units within a unit group. If units are empty, it defaults to defining
+  # methods for all units in the unit group. These methods allow easy conversion
+  # between different units within a given unit group.
+  #
+  # This module is included in the +Measurement+ class to allow defining conversion
+  # methods for specified units.
+  #
+  # @see Measurement
+  #
+  # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+  # @since 5.15.0
+  module ConversionMethods
+    # @scope class
+    # Defines conversion methods for specified +units+ within the unit group.
+    # If +units+ are empty, it defaults to defining methods for all units within
+    # the unit group.
+    #
+    # @example Define conversion methods for metres, centimetres, and millimetres:
+    #   UnitMeasurements::Length.define_conversion_methods("metres", :cm, :mm)
+    #
+    # @example Define conversion methods for all units within the unit group:
+    #   UnitMeasurements::Length.define_conversion_methods
+    #
+    # @param [Array<String|Symbol>, optional] units
+    #   An array of units' names for which conversion methods need to be defined.
+    #   If empty, methods will be defined for all units within the unit group.
+    #
+    # @return [Array<Unit>]
+    #   An array of units for which the conversion methods were defined.
+    #
+    # @note
+    #   This method defines a conversion methods specifically for units that contain
+    #   alphabetic characters in their names.
+    #
+    # @see .define_conversion_method_for
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 5.15.0
+    def define_conversion_methods(*units)
+      unit_group = self
+      units = units.empty? ? unit_group.units : units
+
+      units.inject([]) do |units, unit|
+        units << define_conversion_method_for(unit, unit_group)
+      end
+    end
+
+    private
+
+    # @private
+    # @scope class
+    # Defines conversion methods for a specific +unit+ within a +unit_group+.
+    # These methods are defined dynamically using +define_method+.
+    #
+    # @param [String|Symbol|Unit] unit
+    #   The unit (or its name) for which the conversion methods need to be defined.
+    # @param [UnitGroup] unit_group The unit group to which the unit belongs.
+    #
+    # @return [Unit]
+    #   The unit instance for which the conversion methods were defined.
+    #
+    # @see .define_conversion_methods
+    # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
+    # @since 5.15.0
+    def define_conversion_method_for(unit, unit_group)
+      unit = unit.is_a?(Unit) ? unit : unit_group.unit_for!(unit)
+
+      unit.names.each do |method_name|
+        # Check if the name contains alphabetic characters
+        next unless method_name =~ /^[a-zA-Z]+$/
+
+        define_method("in_#{method_name}") do |use_cache: false|
+          convert_to(unit, use_cache: use_cache)
+        end
+        alias_method "to_#{method_name}", "in_#{method_name}"
+        alias_method "as_#{method_name}", "in_#{method_name}"
+      end
+
+      unit
+    end
+  end
+end

data/lib/unit_measurements/extras/numeric_methods.rb

@@ -3,12 +3,12 @@
 # -*- warn_indent: true -*-
 
 module UnitMeasurements
-  # This module provides methods to define +Numeric+ extension methods for a list
-  # of units within a unit group. If units are empty, it defaults to defining
-  # methods for all units in the unit group.
+  # This module provides methods to define +Numeric+ methods for a list of units
+  # within a unit group. If units are empty, it defaults to defining methods for
+  # all units in the unit group.
   #
   # This module is included in the +Measurement+ class to allow defining numeric
-  # extension methods for specified units.
+  # methods for specified units.
   #
   # @see Measurement
   #
@@ -16,23 +16,27 @@ module UnitMeasurements
   # @since 5.14.0
   module NumericMethods
     # @scope class
-    # Defines +Numeric+ extension methods for specified units within the unit
-    # group. If units are empty, it defaults to defining methods for all units
-    # within the unit group.
-    #
-    # @param [Array<String|Symbol>] units
-    #   An array of units' names for which numeric methods need to be defined.
-    #   If empty, methods will be defined for all units in the unit group.
-    #
-    # @return [Array<Unit>] An array of units for which methods are defined.
+    # Defines +Numeric+ methods for specified +units+ within the unit group. If
+    # +units+ are empty, it defaults to defining methods for all units within
+    # the unit group.
     #
     # @example Define numeric methods for metres, centimetres, and millimetres:
     #   UnitMeasurements::Length.define_numeric_methods("metres", :cm, :mm)
     #
-    # @example Define numeric methods for all units in the unit group:
+    # @example Define numeric methods for all units within the unit group:
     #   UnitMeasurements::Length.define_numeric_methods
     #
-    # @see #define_numeric_method_for
+    # @param [Array<String|Symbol>, optional] units
+    #   An array of units' names for which numeric methods need to be defined.
+    #   If empty, methods will be defined for all units within the unit group.
+    #
+    # @return [Array<Unit>] An array of units for which numeric methods were defined.
+    #
+    # @note
+    #   This method defines a numeric methods specifically for units that contain
+    #   alphabetic characters in their names.
+    #
+    # @see .define_numeric_method_for
     #
     # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
     # @since 5.14.0
@@ -49,17 +53,17 @@ module UnitMeasurements
 
     # @private
     # @scope class
-    # This method defines a numeric method for a specific unit within a unit group.
-    # The method is defined dynamically using +define_method+ and associates the
-    # unit with the numeric value.
+    # Defines a numeric method for a specific +unit+ within a +unit_group+. The
+    # method is defined dynamically using +define_method+ and associates the unit
+    # with the numeric value.
     #
     # @param [String|Symbol|Unit] unit
-    #   The unit for which the numeric method is defined.
+    #   The unit (or its name) for which the numeric method needs to be defined.
     # @param [UnitGroup] unit_group The unit group to which the unit belongs.
     #
     # @return [Unit] The unit instance for which the method was defined.
     #
-    # @see #define_numeric_methods
+    # @see .define_numeric_methods
     #
     # @author {Harshal V. Ladhe}[https://shivam091.github.io/]
     # @since 5.14.0

data/lib/unit_measurements/measurement.rb

@@ -34,6 +34,7 @@ module UnitMeasurements
     include Math
 
     extend NumericMethods
+    extend ConversionMethods
 
     # Regular expression to match conversion strings.
     #

data/lib/unit_measurements/unit_groups/acceleration.rb

@@ -32,4 +32,8 @@ UnitMeasurements::Acceleration = UnitMeasurements.build do
   system :centimetre_gram_second do
     unit "Gal", value: "1e-2 m/s²", aliases: ["gal", "galileo"]
   end
+
+  system :planck_units do
+    unit "aₚ", value: "5.5608e+51 m/s²", aliases: ["planck acceleration", "quantum acceleration"]
+  end
 end

data/lib/unit_measurements/unit_groups/area.rb

@@ -36,6 +36,10 @@ UnitMeasurements::Area = UnitMeasurements.build do
     unit "ch² (US)", value: "404.6873 m²", aliases: ["ch^2 (US)", "sq ch (US)", "square chain (US)", "square chains (US)"]
   end
 
+  system :planck_units do
+    unit "Aₚ", value: "2.6121e-70 m²", aliases: ["planck area", "quantum area"]
+  end
+
   unit "bd", value: "0.00774192 m²", aliases: ["board", "boards"]
   unit "ro", value: "1/4 ac", aliases: ["rood"]
 end

data/lib/unit_measurements/unit_groups/density.rb

@@ -26,4 +26,8 @@ UnitMeasurements::Density = UnitMeasurements.build do
     unit "slug/ft³", value: "515.3788184 kg/m³", aliases: ["slug/ft^3", "slug per cubic foot", "slugs per cubic foot"]
     unit "slug/in³", value: "890574.582782 kg/m³", aliases: ["slug/in^3", "slug per cubic inch", "slugs per cubic inch"]
   end
+
+  system :planck_units do
+    unit "ρₚ", value: "5.1550e+96 kg/m³", aliases: ["planck density", "quantum density"]
+  end
 end

data/lib/unit_measurements/unit_groups/electric_charge.rb

@@ -15,4 +15,8 @@ UnitMeasurements::ElectricCharge = UnitMeasurements.build do
     unit "abC", value: "10 C", aliases: ["abcoulomb", "abcoulombs"]
     unit "statC", value: "3.335641e-10 C", aliases: ["statcoulomb", "statcoulombs"]
   end
+
+  system :planck_units do
+    unit "qₚ", value: "1.875545956e-18 C", aliases: ["planck length", "quantum length"]
+  end
 end

data/lib/unit_measurements/unit_groups/electric_current.rb

@@ -14,4 +14,8 @@ UnitMeasurements::ElectricCurrent = UnitMeasurements.build do
     unit "abA", value: "10 A", aliases: ["abampere", "abamperes"]
     unit "statA", value: "3.33564e-10 A", aliases: ["statampere", "statamperes"]
   end
+
+  system :planck_units do
+    unit "Iₚ", value: "3.4789e+25 A", aliases: ["planck current", "quantum current"]
+  end
 end

data/lib/unit_measurements/unit_groups/energy.rb

@@ -46,6 +46,10 @@ UnitMeasurements::Energy = UnitMeasurements.build do
     unit "hp⋅h", value: "2.685e+13 erg", aliases: ["hp*h", "horsepower-hour"]
   end
 
+  system :planck_units do
+    unit "Eₚ", value: "1.9561e+9 J", aliases: ["planck energy", "quantum energy"]
+  end
+
   unit "Ry", value: "2.179872e-18 J", aliases: ["rydberg"]
   unit "Ha", value: "4.359744e-18 J", aliases: ["hartree", "atomic unit of energy"]
   unit "boe", value: "5.86152 GJ", aliases: ["barrel of oil equivalent", "barrels of oil equivalent"]

data/lib/unit_measurements/unit_groups/force.rb

@@ -43,4 +43,8 @@ UnitMeasurements::Force = UnitMeasurements.build do
     unit "(lb⋅ft)/s²", value: "0.138254954376 N", aliases: ["(lb*ft)/s^2", "pound foot per second squared"]
     unit "(lb⋅in)/s²", value: "0.011521246198	N", aliases: ["(lb*in)/s^2", "pound inch per second squared"]
   end
+
+  system :planck_units do
+    unit "Fₚ", value: "1.2103e+44 N", aliases: ["planck force", "quantum force"]
+  end
 end

data/lib/unit_measurements/unit_groups/length.rb

@@ -56,4 +56,8 @@ UnitMeasurements::Length = UnitMeasurements.build do
     unit "lm", value: "30 ld", aliases: ["light-month", "light-months"]
     unit "ly", value: "365.25 ld", aliases: ["light-year", "light-years"]
   end
+
+  system :planck_units do
+    unit "lₚ", value: "1.616255e-35 m", aliases: ["planck length", "quantum length"]
+  end
 end

data/lib/unit_measurements/unit_groups/power.rb

@@ -49,5 +49,9 @@ UnitMeasurements::Power = UnitMeasurements.build do
     unit "erg/s", value: "1e-7 W", aliases: ["erg per second", "ergs per second"]
   end
 
+  system :planck_units do
+    unit "Pₚ", value: "3.6283e+52 W", aliases: ["planck power", "quantum power"]
+  end
+
   unit "lusec", value: "133.3224 μW", aliases: ["lusecs"]
 end

data/lib/unit_measurements/unit_groups/pressure.rb

@@ -56,4 +56,8 @@ UnitMeasurements::Pressure = UnitMeasurements.build do
   system :gravitational_metric do
     unit "at", value: "98066.5 Pa", aliases: ["technical atmosphere", "technical atmospheres"]
   end
+
+  system :planck_units do
+    unit "Pₚ", value: "4.63309e+113 Pa", aliases: ["planck pressure", "quantum pressure"]
+  end
 end

data/lib/unit_measurements/unit_groups/temperature.rb

@@ -12,4 +12,8 @@ UnitMeasurements::Temperature = UnitMeasurements.build do
   system :english_engineering do
     unit "°R", value: "5/9 K", aliases: ["R", "°Ra", "Ra", "rankine"]
   end
+
+  system :planck_units do
+    unit "Tₚ", value: "1.416784e+32 K", aliases: ["planck temperature", "quantum temperature"]
+  end
 end

data/lib/unit_measurements/unit_groups/time.rb

@@ -13,6 +13,10 @@ UnitMeasurements::Time = UnitMeasurements.build do
     unit "min", value: "60 s", aliases: ["minute", "minutes"]
   end
 
+  system :planck_units do
+    unit "tₚ", value: "5.391247e-44 s", aliases: ["planck time", "quantum time"]
+  end
+
   unit "wk", value: "7 d", aliases: ["week", "weeks"]
   unit "mo", value: "30.4167 d", aliases: ["month", "months"]
   unit "yr", value: "365 d", aliases: ["y", "year", "years"]

data/lib/unit_measurements/unit_groups/volume.rb

@@ -57,4 +57,8 @@ UnitMeasurements::Volume = UnitMeasurements.build do
 
     unit "cd-ft", value: "1/8 cd", aliases: ["cord-foot", "cord-feet"]
   end
+
+  system :planck_units do
+    unit "Vₚ", value: "4.2217e-105 m³", aliases: ["planck volume", "quantum volume"]
+  end
 end

data/lib/unit_measurements/unit_groups/weight.rb

@@ -45,4 +45,8 @@ UnitMeasurements::Weight = UnitMeasurements.build do
   system :foot_pound_second do
     unit "slug", value: "32.17404856 lb", aliases: ["slugs"]
   end
+
+  system :planck_units do
+    unit "mₚ", value: "2.176434e-8 kg", aliases: ["planck mass", "quantum mass"]
+  end
 end

data/lib/unit_measurements/version.rb

@@ -4,5 +4,5 @@
 
 module UnitMeasurements
   # Current stable version.
-  VERSION = "5.14.0"
+  VERSION = "5.16.0"
 end

data/units.md

@@ -49,6 +49,7 @@ These units are defined in `UnitMeasurements::Length`.
 | 30 | lmin | light-minute, light-minutes |
 | 31 | cb (M) | CBL. (M), cable length (M) |
 | 32 | cb (US) | CBL. (US), cable length (US) |
+| 33 | lₚ | planck length, quantum length |
 
 ## 2. Weight or mass
 
@@ -78,6 +79,7 @@ These units are defined in `UnitMeasurements::Weight`.
 | 20 | cwt | hundredweight, long hundredweight, imperial hundredweight |
 | 21 | slug | slugs |
 | 22 | cwt (US) | hundredweight (US), short hundredweight |
+| 23 | mₚ | planck mass, quantum mass |
 
 ## 3. Time or duration
 
@@ -96,6 +98,7 @@ These units are defined in `UnitMeasurements::Time`.
 | 9 | qtr | quarter, quarters |
 | 10 | dec | decade, decades |
 | 11 | cent | century, centuries |
+| 12 | tₚ | planck time, quantum time |
 
 ## 4. Amount of substance
 
@@ -116,6 +119,7 @@ These units are defined in `UnitMeasurements::ElectricCurrent`.
 | 2 | abA | abampere, abamperes |
 | 3 | Bi | biot, biots |
 | 4 | statA | statampere, statamperes |
+| 5 | Iₚ | planck current, quantum current |
 
 ## 6. Luminous intensity
 
@@ -134,6 +138,7 @@ These units are defined in `UnitMeasurements::Temperature`.
 |:--|:--|:--|
 | _1_ | _K*_ | _kelvin, kelvins_ |
 | 2 | °R | R, °Ra, Ra, rankine |
+| 3 | Tₚ | planck temperature, quantum temperature |
 
 ## 8. Area
 
@@ -161,6 +166,7 @@ These units are defined in `UnitMeasurements::Area`.
 | 18 | ft² (US) | ft^2 (US), sq ft (US), square foot (US), square feet (US) |
 | 19 | mi² (US) | mi^2 (US), sq mi (US), square mile (US), square miles (US) |
 | 20 | ch² (US) | ch^2 (US), sq ch (US), square chain (US), square chains (US) |
+| 21 | Aₚ | planck area, quantum area |
 
 ## 9. Volume & capacity
 
@@ -203,6 +209,7 @@ These units are defined in `UnitMeasurements::Volume`.
 | 33 | ac⋅ft | acre-foot, acre-feet |
 | 34 | ac⋅in | acre-inch, acre-inches |
 | 35 | cd-ft | cord-foot, cord-feet |
+| 36 | Vₚ | planck volume, quantum volume |
 
 ## 10. Density
 
@@ -223,6 +230,7 @@ These units are defined in `UnitMeasurements::Density`.
 | 11 | lb/gal | pound per gallon, pounds per gallon |
 | 12 | slug/ft³ | slug/ft^3, slug per cubic foot, slugs per cubic foot |
 | 13 | slug/in³ | slug/in^3, slug per cubic inch, slugs per cubic inch |
+| 14 | ρₚ | planck density, quantum density |
 
 ## 11. Quantity
 
@@ -302,7 +310,8 @@ These units are defined in `UnitMeasurements::Force`.
 | 14 | kipf | kip, klbf, kip-force |
 | 15 | (lb⋅m)/s² | (lb*m)/s^2, pound meter per second squared, pound metre per second squared |
 | 16 | (lb⋅ft)/s² | (lb*ft)/s^2, pound foot per second squared |
-| 17 | (lb⋅in)/s² | (lb*in)/s^2, pound inch per second squared |
+| 17 | (lb⋅in)/s² | (lb\*in)/s^2, pound inch per second squared |
+| 18 | Fₚ | planck force, quantum force |
 
 ## 16. Velocity or speed
 
@@ -343,6 +352,7 @@ These units are defined in `UnitMeasurements::Acceleration`.
 | 10 | mpm/s | mi/(min⋅s), mile per minute per second, miles per minute per second |
 | 11 | mph/s | mi/(h⋅s), mile per hour per second, miles per hour per second |
 | 12 | Kn/s | knot per second, knots per second |
+| 13 | aₚ | planck acceleration, quantum acceleration |
 
 ## 18. Angular velocity or rotational speed
 
@@ -396,6 +406,7 @@ These units are defined in `UnitMeasurements::ElectricCharge`.
 | 3 | statC | statcoulomb, statcoulombs |
 | 4 | Fr | franklin, franklins |
 | 5 | Fd | faraday, faradays |
+| 6 | qₚ | planck charge, quantum charge |
 
 ## 22. Electrical capacitance
 
@@ -541,6 +552,7 @@ These units are defined in `UnitMeasurements::Pressure`.
 | 25 | kgf/m² | kgf/m^2, kilogram-force per square metre, kilogramme-force per square metre |
 | 26 | kgf/mm² | kgf/mm^2, kilogram-force per square millimetre, kilogramme-force per square millimetre |
 | 27 | kgf/dm² | kgf/dm^2, kilogram-force per square decimetre, kilogramme-force per square decimetre |
+| 28 | Pₚ | planck pressure, quantum pressure |
 
 ## 34. Torque or moment of force
 
@@ -639,7 +651,8 @@ These units are defined in `UnitMeasurements::Power`.
 | 22 | lusec | lusecs |
 | 23 | atm⋅ft³/s | atm*ft^3/s, atmosphere-cubic foot per second |
 | 24 | atm⋅ft³/min | atm*ft^3/min, atmosphere-cubic foot per minute |
-| 25 | atm⋅ft³/h | atm*ft^3/h, atmosphere-cubic foot per hour |
+| 25 | atm⋅ft³/h | atm\*ft^3/h, atmosphere-cubic foot per hour |
+| 26 | Pₚ | planck power, quantum power |
 
 ## 40. Energy
 
@@ -671,6 +684,7 @@ These units are defined in `UnitMeasurements::Energy`.
 | 22 | in⋅lbf | in\*lbf, in⋅lb, in\*lb, inch-pound force |
 | 23 | ft⋅pdl | ft*pdl, foot-poundal |
 | 24 | gal⋅atm | gal*atm, gallon-atmosphere |
+| 25 | Eₚ | planck energy, quantum energy |
 
 ## 41. Dynamic viscosity
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unit_measurements
 version: !ruby/object:Gem::Version
-  version: 5.14.0
+  version: 5.16.0
 platform: ruby
 authors:
 - Harshal LADHE
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-11-29 00:00:00.000000000 Z
+date: 2023-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -118,6 +118,7 @@ files:
 - lib/unit_measurements/errors/primitive_unit_already_set_error.rb
 - lib/unit_measurements/errors/unit_already_defined_error.rb
 - lib/unit_measurements/errors/unit_error.rb
+- lib/unit_measurements/extras/conversion_methods.rb
 - lib/unit_measurements/extras/numeric_methods.rb
 - lib/unit_measurements/formatter.rb
 - lib/unit_measurements/math.rb