duration.rb 0.5.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b6ba0b1a782117f5c6f5b7798620456110e617f5cf2f59ccedd45845cab01674
-  data.tar.gz: aa225e9b5369e6f334fc0a0962e57cb64c5a6ead3008d91fcbc74448c91fba2e
+  metadata.gz: 879170199d5fdc472851ece21f3896aa08d7767484045d281834255ca51d8c84
+  data.tar.gz: a35e1867f9712bb9aa415bcb577434e0683908c9f0c2579dfcaf27476770907c
 SHA512:
-  metadata.gz: '045846aba621660eabc73c4115457a15e5f3838a0ba8fcced57fa5381c20ce68cc73ea64b51c2acf1d5bfbe7efc3c36c4854c41f019e9d156eb2687826ad4a4a'
-  data.tar.gz: d0f3455bd9631c7f423151f3aa14fc1a0b4f9bca264a4fe83ad56e535404e4d48b246af457814d5077f429ccfcc064b3f376d9bf649995fe1abff71301d9a349
+  metadata.gz: b4ab866878939cd01e8ab62ff977fb53e974fb67b6ea2385c4837f60d2420b73e418ed75ba21aac52143487dd9b6b6c4818a11aac969ce7e14cc403ce7678928
+  data.tar.gz: 8b51e85072dbeede9062953fa1391a848242934c0d09559715a66bfc902cbd1284c7e53ef3e6811cbf859611c6f3d746d412eaf1e127e17e619c2a783446d552

data/CHANGELOG

@@ -1,5 +1,27 @@
 # CHANGELOG
 
+## 20260812
+
+0.6.0: The unit classes are now autoloaded so as to avoid circular loading messages when running the tests. It's faster too!
+
+1. + lib/duration.rb: Autoload each unit file, and Common and Relative.
+2. ~ lib/Duration/*.rb: - require_relative './Common', './Relative'
+3. ~ lib/Duration/*.rb: + require_relative '../duration'. Each unit had required both of its neighbours, so that every adjacent pair was a cycle and Ruby warned upon each under -w. The ring was connected besides, so requiring any one unit dragged in eleven files of the thirteen and no part of the gem could be left unread. Requiring one now brings five, and the rest arrive as they are named.
+4. ~ lib/duration.rb: Add a note why VERSION is required and not declared, being the one exception.
+5. ~ README.md: Add a line in the Loading section.
+6. + test/loading_test.rb: that a single unit file required alone still converts, that a unit never named is never read, that one named is, and that the whole loads without warning under -w. Each runs in a process of its own, the test helper having already loaded everything in this one.
+7. ~ Duration::VERSION: /0.5.2/0.6.0/
+
+
+## 20260812
+
+0.5.2: + gemspec test.
+
+1. + test/gemspec_test.rb: Ensure that the specification validates, that no date is pinned, that the version comes from Duration::VERSION, and that the runtime and development dependencies are those expected.
+2. ~ duration.rb.gemspec: /a description identical to the summary/a description of its own/. Found by the test above upon its first run, spec.validate having warned of it. The summary says what the gem is; the description now says how it goes about it.
+3. ~ Duration::VERSION: /0.5.1/0.5.2/
+
+
 ## 20260812
 
 0.5.1: + VERSION test.

data/README.md

@@ -52,8 +52,12 @@ require 'duration-numeric'  # opt in to the Numeric sugar (5.minutes, etc.),
 ```
 
 The examples below use the `Numeric` sugar, so they assume
-`require 'duration-numeric'`. Without it, construct durations directly with
-`Duration::Minutes.new(5)` and friends.
+`require 'duration-numeric'`. Without it durations are constructed directly with
+`Duration::Minutes.new(5)` and so on.
+
+Either require declares where the unit classes are without reading them. A unit
+file is read when its class is first named, so a program dealing in seconds and
+minutes reads the files for seconds and minutes and leaves the rest unread.
 
 ## Usage
 

data/duration.rb.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
   spec.version = Duration::VERSION
 
   spec.summary = "Objects for handling durations of time."
-  spec.description = "Objects for handling durations of time."
+  spec.description = "The unit is the class rather than a decoration upon a number of seconds, so a Minutes holds minutes and no unit is privileged as a base. Nothing is normalised at construction and conversions divide by exact ratios, so an Integer or a Rational stays exact the whole way through, with to_f left for the edge."
 
   spec.author = 'thoran'
   spec.email = 'code@thoran.com'

data/lib/Duration/Days.rb

@@ -1,10 +1,7 @@
 # Duration/Days.rb
 # Duration::Days
 
-require_relative './Common'
-require_relative './Relative'
-require_relative './Hours'
-require_relative './Weeks'
+require_relative '../duration'
 
 module Duration
   class Days

data/lib/Duration/Hours.rb

@@ -1,10 +1,7 @@
 # Duration/Hours.rb
 # Duration::Hours
 
-require_relative './Common'
-require_relative './Relative'
-require_relative './Minutes'
-require_relative './Days'
+require_relative '../duration'
 
 module Duration
   class Hours

data/lib/Duration/Microseconds.rb

@@ -1,10 +1,7 @@
 # Duration/Microseconds.rb
 # Duration::Microseconds
 
-require_relative './Common'
-require_relative './Relative'
-require_relative './Nanoseconds'
-require_relative './Milliseconds'
+require_relative '../duration'
 
 module Duration
   class Microseconds

data/lib/Duration/Milliseconds.rb

@@ -1,10 +1,7 @@
 # Duration/Milliseconds.rb
 # Duration::Milliseconds
 
-require_relative './Common'
-require_relative './Relative'
-require_relative './Microseconds'
-require_relative './Seconds'
+require_relative '../duration'
 
 module Duration
   class Milliseconds

data/lib/Duration/Minutes.rb

@@ -1,10 +1,7 @@
 # Duration/Minutes.rb
 # Duration::Minutes
 
-require_relative './Common'
-require_relative './Relative'
-require_relative './Seconds'
-require_relative './Hours'
+require_relative '../duration'
 
 module Duration
   class Minutes

data/lib/Duration/Months.rb

@@ -1,9 +1,7 @@
 # Duration/Months.rb
 # Duration::Months
 
-require_relative './Common'
-require_relative './Relative'
-require_relative './Weeks'
+require_relative '../duration'
 
 module Duration
   # A month is not a fixed quantity: its length depends on the calendar. The

data/lib/Duration/Nanoseconds.rb

@@ -1,9 +1,7 @@
 # Duration/Nanoseconds.rb
 # Duration::Nanoseconds
 
-require_relative './Common'
-require_relative './Relative'
-require_relative './Microseconds'
+require_relative '../duration'
 
 module Duration
   class Nanoseconds

data/lib/Duration/Seconds.rb

@@ -1,10 +1,7 @@
 # Duration/Seconds.rb
 # Duration::Seconds
 
-require_relative './Common'
-require_relative './Relative'
-require_relative './Milliseconds'
-require_relative './Minutes'
+require_relative '../duration'
 
 module Duration
   class Seconds

data/lib/Duration/VERSION.rb

@@ -1,3 +1,3 @@
 module Duration
-  VERSION = '0.5.1'
+  VERSION = '0.6.0'
 end

data/lib/Duration/Weeks.rb

@@ -1,10 +1,7 @@
 # Duration/Weeks.rb
 # Duration::Weeks
 
-require_relative './Common'
-require_relative './Relative'
-require_relative './Days'
-require_relative './Months'
+require_relative '../duration'
 
 module Duration
   class Weeks

data/lib/duration.rb

@@ -1,15 +1,24 @@
 # Duration.rb
 # Duration
 
-module Duration; end
-
-require_relative 'Duration/Nanoseconds'
-require_relative 'Duration/Microseconds'
-require_relative 'Duration/Milliseconds'
-require_relative 'Duration/Seconds'
-require_relative 'Duration/Minutes'
-require_relative 'Duration/Hours'
-require_relative 'Duration/Days'
-require_relative 'Duration/Weeks'
-require_relative 'Duration/Months'
+# Previously, neighbouring units which are used conversion methods used to be requires at the top of each file, so that every adjacent pair was a cycle and Ruby warned upon each under -w.
+
+# Now, a unit file is read when its class is first named and not before, which is what lets a program dealing in seconds and minutes loads only Seconds and Minutes, so that units are may easily be left unused.
+
+module Duration
+  autoload :Common,       File.expand_path('Duration/Common', __dir__)
+  autoload :Relative,     File.expand_path('Duration/Relative', __dir__)
+  autoload :Nanoseconds,  File.expand_path('Duration/Nanoseconds', __dir__)
+  autoload :Microseconds, File.expand_path('Duration/Microseconds', __dir__)
+  autoload :Milliseconds, File.expand_path('Duration/Milliseconds', __dir__)
+  autoload :Seconds,      File.expand_path('Duration/Seconds', __dir__)
+  autoload :Minutes,      File.expand_path('Duration/Minutes', __dir__)
+  autoload :Hours,        File.expand_path('Duration/Hours', __dir__)
+  autoload :Days,         File.expand_path('Duration/Days', __dir__)
+  autoload :Weeks,        File.expand_path('Duration/Weeks', __dir__)
+  autoload :Months,       File.expand_path('Duration/Months', __dir__)
+end
+
+# VERSION is required rather than autoloaded, and is the one exception, as there nothing which will load it at runtime.
+
 require_relative 'Duration/VERSION'

data/test/gemspec_test.rb

@@ -0,0 +1,27 @@
+# test/gemspec_test.rb
+
+require_relative './test_helper'
+
+describe 'duration.rb.gemspec' do
+  let(:spec){Gem::Specification.load(File.expand_path('../duration.rb.gemspec', __dir__))}
+
+  it "is a valid specification" do
+    _(spec.validate).must_equal(true)
+  end
+
+  it "does not pin a date" do
+    _(spec.date).must_equal(Gem::Specification.new.date)
+  end
+
+  it "takes its version from Duration::VERSION" do
+    _(spec.version.to_s).must_equal(Duration::VERSION)
+  end
+
+  it "declares no runtime dependencies" do
+    _(spec.runtime_dependencies.map(&:name).sort).must_equal([])
+  end
+
+  it "declares its development dependencies" do
+    _(spec.development_dependencies.map(&:name).sort).must_equal(%w{minitest minitest-spec-context rake})
+  end
+end

data/test/loading_test.rb

@@ -0,0 +1,32 @@
+# test/loading_test.rb
+
+require_relative './test_helper'
+
+# Each of these wants a process of its own. Within this one the test helper has already loaded the lot, so nothing here could tell a unit which was declared from a unit which was read.
+
+describe 'loading' do
+  def ruby(source, *flags)
+    lib = File.expand_path('../lib', __dir__)
+    IO.popen(['ruby', *flags, "-I#{lib}", '-e', source], err: [:child, :out]){|io| io.read}.strip
+  end
+
+  it "converts when a single unit file is required alone" do
+    _(ruby('require "Duration/Seconds"; print Duration::Seconds.new(90).to_minutes.to_f')) \
+      .must_equal('1.5')
+  end
+
+  it "does not read a unit which is never named" do
+    _(ruby('require "duration.rb"; Duration::Seconds; print $LOADED_FEATURES.grep(/Months/).size')) \
+      .must_equal('0')
+  end
+
+  it "reads a unit as soon as it is named" do
+    _(ruby('require "duration.rb"; Duration::Months; print $LOADED_FEATURES.grep(/Months/).size')) \
+      .must_equal('1')
+  end
+
+  it "loads without warning under -w, no unit requiring another" do
+    _(ruby('require "duration.rb"; Duration::Months.new(1).to_nanoseconds; print "ok"', '-w')) \
+      .must_equal('ok')
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: duration.rb
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.0
 platform: ruby
 authors:
 - thoran
@@ -51,7 +51,10 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Objects for handling durations of time.
+description: The unit is the class rather than a decoration upon a number of seconds,
+  so a Minutes holds minutes and no unit is privileged as a base. Nothing is normalised
+  at construction and conversions divide by exact ratios, so an Integer or a Rational
+  stays exact the whole way through, with to_f left for the edge.
 email: code@thoran.com
 executables: []
 extensions: []
@@ -89,6 +92,8 @@ files:
 - test/Duration/Seconds_test.rb
 - test/Duration/VERSION_test.rb
 - test/Duration/Weeks_test.rb
+- test/gemspec_test.rb
+- test/loading_test.rb
 - test/test_helper.rb
 homepage: http://github.com/thoran/duration.rb
 licenses: