sy 2.0.22 → 2.0.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ea2f55f3a2deb6fb8766eff1c6e72d10085e761f
-  data.tar.gz: 01725b3cb13367650ca24a01037bf00214454cf1
+  metadata.gz: cdeb385f6bac717c48b1b299826a59503b248ca1
+  data.tar.gz: 687fdab4cf0ae4852ab2742e75a9728c3e509a0c
 SHA512:
-  metadata.gz: 13ea62aae24ced86d136b1a62f561321f7ae05c26d38aff7b0cd2dbbfcc01f5a7f8346caa3bcab67de6452bf3608ccfadd612d64957821bfb1457ae3dabebfc5
-  data.tar.gz: 3a471bda9369293a74d3e056663b32efd4b1d68725b585f6b212468123b7d2296d3352e3980c2fbf866c20f3cfc220da319955f70f797952f9a93eaa491d8526
+  metadata.gz: c10acf0527df8ce1dab0afdfa9f4f65e526ac37a68ab4d8528fb48379ce5603c1049b6bbc14df3d75ef5a01450698c79c334aae448537707c9207cb9c99c7921
+  data.tar.gz: 560381bf7c8fd643037c50627a0d2a9241004e5cce6f19e9642261d4d71ccd42524ae5d77ba1d418340e35d965ec83e8f695b803fd0d61483ab0f6201047f7c7

data/README.md

@@ -1,6 +1,8 @@
-# SY - The physical units library.
+# SY - a physical units gem
 
-`SY` is a domain model of physical units. It can be used in two modes:
+`SY` is a domain model of physical units (magnitudes, quantities, dimensions...).
+In `SY`, I (would like to) emphasize the domain model correctness and ease of use
+over the ease of implementation. `SY` can be used in two modes:
 
   * When loaded by `require 'sy'`, Numeric class is extended with methods
     corresponding to units and their abbreviations.
@@ -8,18 +10,18 @@
     while physical magnitudes can still be contructed explicitly from the
     appropriate physical quantities.
 
-At this place, good manners require me to mention the other good library of
-physical units in Ruby, [phys-units](https://github.com/masa16/phys-units).
+Good manners require me to also mention another good library of physical units in
+Ruby, [phys-units](https://github.com/masa16/phys-units).
 
 ## Usage
 
 Upon `require 'sy'`, we can say `5.metre`, or `Rational( 5, 2 ).metre`, and the
-computer will understand, that these numbers represent magnitudes of the
-physical quantity `SY::Length` expressed in the unit `SY::METRE`. Equally,
-we can use abbreviations (such as `5.m`, `2.5.m`), prefixes (such as `5.km`,
-`5.kilometre`, `5.km`), exponents (such as `5.m²` for 5 square metres), and
-chaining (such as `5.m.s⁻¹` to denote speed of 5 metres per second). Please
-read also the code file lib/sy.rb for the DSL statements defining default
+computer will understand, that these numbers represent magnitudes of the physical
+quantity `SY::Length` expressed in the unit `SY::METRE`. Equally, we can use
+abbreviations (such as `5.m`, `2.5.m`), prefixes (such as `5.km`, `5.kilometre`,
+`5.km`), exponents (such as `5.m²` for 5 square metres), and chaining (such as
+`5.m.s⁻¹` to denote speed of 5 metres per second). Please read also the code file
+[https:://github.com/boris-s/lib/sy.rb] for the DSL statements defining default
 quantities and their units.
 
 ## Unicode exponents

data/lib/sy.rb

@@ -271,6 +271,9 @@ module SY
   # of its dimension.
   Speed = ( Length / Time ).standard!
 
+  # Common constant
+  SPEED_OF_LIGHT = 299_792_458 * METRE / SECOND
+
   # Similar for SY::Acceleration:
   Acceleration = ( Speed / Time ).standard!
 

data/lib/sy/imperial.rb

@@ -10,7 +10,8 @@ module SY
   # short: 'in' would be ambiguous
   FOOT = Unit.of Length, short: 'ft', amount: 12 * INCH
   YARD = Unit.of Length, short: 'yd', amount: 3 * FOOT
-  # forget CHAIN and FURLONG
+  # forget CHAIN
+  FURLONG = Unit.of Length, short: 'fur', amount: 220 * YARD
   MILE = Unit.of Length, short: 'mi', amount: 5_280 * FOOT
   FATHOM = Unit.of Length, short: 'ftm', amount: 1.853184 * METRE
   NAUTICAL_MILE = Unit.of Length, amount: 1000 * FATHOM
@@ -29,5 +30,9 @@ module SY
   POUND = Unit.of Mass, short: 'lb', amount: 453.59237 * GRAM
   OUNCE = Unit.of Mass, short: 'oz', amount: ( 1.0 / 16 ) * POUND
   STONE = Unit.of Mass, amount: 14 * POUND
+  FIRKIN = Unit.of Mass, short: 'fir', amount: 90 * POUND
   IMPERIAL_TON = Unit.of Mass, amount: 2240 * POUND
+
+  # === Time
+  FORTNIGHT = Unit.of Time, short: 'ftn', amount: 1_209_600 * SECOND
 end

data/lib/sy/version.rb

@@ -1,5 +1,5 @@
 module SY
-  VERSION = "2.0.22"
+  VERSION = "2.0.23"
   DEBUG = false # debug mode switch - sometimes there are lines like
   # puts "something" if SY::DEBUG
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sy
 version: !ruby/object:Gem::Version
-  version: 2.0.22
+  version: 2.0.23
 platform: ruby
 authors:
 - boris