duration.rb 0.3.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 549fb2b2e23b0389a558e78c74a5603fc51b11b7fff627c4688a346f4fb4638e
+  data.tar.gz: 9f822311766eb84320d3a8a47b8581dae27fa0356bdb843a8ea5f385ac098616
+SHA512:
+  metadata.gz: e4ebc76e09a03f18d8181244af6036d511466491d64083db02b2cbf753fe92992a55302fa545141a08f8d49363647e2fb1bf750b41452226a16650fd2f923624
+  data.tar.gz: 62eb7d26933dbc4cbfaa16f3dbc5facb84d4db97cac9b75ccf9f4ca5ef19817c7264b9a14a1ee8d054393a26328f20c4756d980dc2202c719aa20e64491d3d06

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://www.rubygems.org'
+
+gemspec

data/README.md

@@ -0,0 +1,53 @@
+# duration.rb
+
+## Description
+
+Objects for handling durations of time.
+
+## Installation
+
+Add this line to your application's Gemfile:
+```ruby
+gem 'duration.rb'
+```
+
+And then execute:
+```shell
+$ bundle
+```
+
+Or install it yourself as:
+```shell
+$ gem install duration.rb
+```
+
+## Usage
+
+### Basic Duration Creation
+```ruby
+# Create durations using convenience methods
+1.second   # => #<Seconds: 1>
+30.minutes # => #<Minutes: 30>
+2.hours    # => #<Hours: 2>
+7.days     # => #<Days: 7>
+```
+
+### Conversions
+```ruby
+# Convert between units
+90.minutes.to_hours        # => 1.5
+1.5.hours.to_minutes       # => 90
+1.day.to_seconds           # => 86400
+```
+
+## Contributing
+
+1. Fork it (https://github.com/thoran/duration.rb/fork)
+2. Create your feature 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 a new pull request
+
+## License
+
+MIT

data/duration.rb.gemspec

@@ -0,0 +1,27 @@
+require_relative './lib/Duration/VERSION'
+
+Gem::Specification.new do |spec|
+  spec.name = 'duration.rb'
+
+  spec.version = Duration::VERSION
+  spec.date = '2025-10-23'
+
+  spec.summary = "Objects for handling durations of time."
+  spec.description = "Objects for handling durations of time."
+
+  spec.author = 'thoran'
+  spec.email = 'code@thoran.com'
+  spec.homepage = 'http://github.com/thoran/duration.rb'
+  spec.license = 'Ruby'
+
+  spec.required_ruby_version = '>= 2.5'
+
+  spec.files = [
+    'duration.rb.gemspec',
+    'Gemfile',
+    Dir['lib/**/*.rb'],
+    'README.md',
+    Dir['test/**/*.rb']
+  ].flatten
+  spec.require_paths = ['lib']
+end

data/lib/Duration/Common.rb

@@ -0,0 +1,17 @@
+# Duration/Common.rb
+# Duration::Common
+
+# 20251021
+# 0.3.1
+
+module Duration
+  module Common
+    def ago
+      Time.now - self.to_seconds.to_f
+    end
+
+    def hence
+      Time.now + self.to_seconds.to_f
+    end
+  end
+end

data/lib/Duration/Days.rb

@@ -0,0 +1,57 @@
+# Duration/Days.rb
+# Duration::Days
+
+# 20251021
+# 0.3.1
+
+require_relative './Common'
+require_relative './Hours'
+require_relative './Weeks'
+
+module Duration
+  class Days
+    include Common
+
+    def to_milliseconds
+      to_hours.to_milliseconds
+    end
+
+    def to_seconds
+      to_hours.to_seconds
+    end
+
+    def to_minutes
+      to_hours.to_minutes
+    end
+
+    def to_hours
+      Duration::Hours.new(@days * 24)
+    end
+
+    def to_days
+      self
+    end
+
+    def to_weeks
+      Duration::Weeks.new(@days/7)
+    end
+
+    def to_months
+      to_weeks.to_months
+    end
+
+    def to_i
+      @days.to_i
+    end
+
+    def to_f
+      @days
+    end
+
+    private
+
+    def initialize(days = nil)
+      @days = days.to_f
+    end
+  end
+end

data/lib/Duration/Hours.rb

@@ -0,0 +1,57 @@
+# Duration/Hours.rb
+# Duration::Hours
+
+# 20251021
+# 0.3.1
+
+require_relative './Common'
+require_relative './Minutes'
+require_relative './Days'
+
+module Duration
+  class Hours
+    include Common
+
+    def to_milliseconds
+      to_minutes.to_milliseconds
+    end
+
+    def to_seconds
+      to_minutes.to_seconds
+    end
+
+    def to_minutes
+      Duration::Minutes.new(@hours * 60)
+    end
+
+    def to_hours
+      self
+    end
+
+    def to_days
+      Duration::Days.new(@hours/24)
+    end
+
+    def to_weeks
+      to_days.to_weeks
+    end
+
+    def to_months
+      to_days.to_months
+    end
+
+    def to_i
+      @hours.to_i
+    end
+
+    def to_f
+      @hours
+    end
+
+    private
+
+    def initialize(hours = nil)
+      @hours = hours.to_f
+    end
+  end
+end

data/lib/Duration/Milliseconds.rb

@@ -0,0 +1,56 @@
+# Duration/Milliseconds.rb
+# Duration::Milliseconds
+
+# 20251021
+# 0.3.1
+
+require_relative './Common'
+require_relative './Seconds'
+
+module Duration
+  class Milliseconds
+    include Common
+
+    def to_milliseconds
+      self
+    end
+
+    def to_seconds
+      Duration::Seconds.new(@milliseconds/1000)
+    end
+
+    def to_minutes
+      to_seconds.to_minutes
+    end
+
+    def to_hours
+      to_seconds.to_hours
+    end
+
+    def to_days
+      to_seconds.to_days
+    end
+
+    def to_weeks
+      to_seconds.to_weeks
+    end
+
+    def to_months
+      to_seconds.to_months
+    end
+
+    def to_i
+      @milliseconds.to_i
+    end
+
+    def to_f
+      @milliseconds
+    end
+
+    private
+
+    def initialize(milliseconds = nil)
+      @milliseconds = milliseconds.to_f
+    end
+  end
+end

data/lib/Duration/Minutes.rb

@@ -0,0 +1,57 @@
+# Duration/Minutes.rb
+# Duration::Minutes
+
+# 20251021
+# 0.3.1
+
+require_relative './Common'
+require_relative './Seconds'
+require_relative './Hours'
+
+module Duration
+  class Minutes
+    include Common
+
+    def to_milliseconds
+      to_seconds.to_milliseconds
+    end
+
+    def to_seconds
+      Duration::Seconds.new(@minutes * 60)
+    end
+
+    def to_minutes
+      self
+    end
+
+    def to_hours
+      Duration::Hours.new(@minutes/60)
+    end
+
+    def to_days
+      to_hours.to_days
+    end
+
+    def to_weeks
+      to_hours.to_weeks
+    end
+
+    def to_months
+      to_hours.to_months
+    end
+
+    def to_i
+      @minutes.to_i
+    end
+
+    def to_f
+      @minutes
+    end
+
+    private
+
+    def initialize(minutes = nil)
+      @minutes = minutes.to_f
+    end
+  end
+end

data/lib/Duration/Months.rb

@@ -0,0 +1,56 @@
+# Duration/Months.rb
+# Duration::Months
+
+# 20251021
+# 0.3.1
+
+require_relative './Common'
+require_relative './Weeks'
+
+module Duration
+  class Months
+    include Common
+
+    def to_milliseconds
+      to_weeks.to_milliseconds
+    end
+
+    def to_seconds
+      to_weeks.to_seconds
+    end
+
+    def to_minutes
+      to_weeks.to_minutes
+    end
+
+    def to_hours
+      to_weeks.to_hours
+    end
+
+    def to_days
+      to_weeks.to_days
+    end
+
+    def to_weeks
+      Duration::Weeks.new(@months / 12 * 52)
+    end
+
+    def to_months
+      self
+    end
+
+    def to_i
+      @months.to_i
+    end
+
+    def to_f
+      @months
+    end
+
+    private
+
+    def initialize(months = nil)
+      @months = months.to_f
+    end
+  end
+end

data/lib/Duration/Numeric.rb

@@ -0,0 +1,46 @@
+# Duration/Numeric.rb
+# Duration::Numeric
+
+# 20251021
+# 0.3.1
+
+module Duration
+  module Numeric
+    def milliseconds
+      Duration::Milliseconds.new(self)
+    end
+    alias_method :millisecond, :milliseconds
+
+    def seconds
+      Duration::Seconds.new(self)
+    end
+    alias_method :second, :seconds
+
+    def minutes
+      Duration::Minutes.new(self)
+    end
+    alias_method :minute, :minutes
+
+    def hours
+      Duration::Hours.new(self)
+    end
+    alias_method :hour, :hours
+
+    def days
+      Duration::Days.new(self)
+    end
+    alias_method :day, :days
+
+    def weeks
+      Duration::Weeks.new(self)
+    end
+    alias_method :week, :weeks
+
+    def months
+      Duration::Months.new(self)
+    end
+    alias_method :month, :months
+  end
+end
+
+Numeric.include(Duration::Numeric)

data/lib/Duration/Seconds.rb

@@ -0,0 +1,57 @@
+# Duration/Seconds.rb
+# Duration::Seconds
+
+# 20251021
+# 0.3.1
+
+require_relative './Common'
+require_relative './Milliseconds'
+require_relative './Minutes'
+
+module Duration
+  class Seconds
+    include Common
+
+    def to_milliseconds
+      Duration::Milliseconds.new(@seconds * 1000)
+    end
+
+    def to_seconds
+      self
+    end
+
+    def to_minutes
+      Duration::Minutes.new(@seconds/60)
+    end
+
+    def to_hours
+      to_minutes.to_hours
+    end
+
+    def to_days
+      to_minutes.to_days
+    end
+
+    def to_weeks
+      to_minutes.to_weeks
+    end
+
+    def to_months
+      to_minutes.to_months
+    end
+
+    def to_i
+      @seconds.to_i
+    end
+
+    def to_f
+      @seconds
+    end
+
+    private
+
+    def initialize(seconds = nil)
+      @seconds = seconds.to_f
+    end
+  end
+end

data/lib/Duration/VERSION.rb

@@ -0,0 +1,3 @@
+class Duration
+  VERSION = '0.3.1'
+end

data/lib/Duration/Weeks.rb

@@ -0,0 +1,57 @@
+# Duration/Weeks.rb
+# Duration::Weeks
+
+# 20251021
+# 0.3.1
+
+require_relative './Common'
+require_relative './Days'
+require_relative './Months'
+
+module Duration
+  class Weeks
+    include Common
+
+    def to_milliseconds
+      to_days.to_milliseconds
+    end
+
+    def to_seconds
+      to_days.to_seconds
+    end
+
+    def to_minutes
+      to_days.to_minutes
+    end
+
+    def to_hours
+      to_days.to_hours
+    end
+
+    def to_days
+      Duration::Days.new(@weeks * 7)
+    end
+
+    def to_weeks
+      self
+    end
+
+    def to_months
+      Duration::Months.new(@weeks / 52 * 12)
+    end
+
+    def to_i
+      @weeks.to_i
+    end
+
+    def to_f
+      @weeks
+    end
+
+    private
+
+    def initialize(weeks = nil)
+      @weeks = weeks.to_f
+    end
+  end
+end

data/lib/Duration.rb

@@ -0,0 +1,14 @@
+# duration.rb
+# duration
+
+# 20251022
+# 0.3.1
+
+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'
+require_relative 'Duration/Numeric'

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: duration.rb
+version: !ruby/object:Gem::Version
+  version: 0.3.1
+platform: ruby
+authors:
+- thoran
+bindir: bin
+cert_chain: []
+date: 2025-10-23 00:00:00.000000000 Z
+dependencies: []
+description: Objects for handling durations of time.
+email: code@thoran.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- README.md
+- duration.rb.gemspec
+- lib/Duration.rb
+- lib/Duration/Common.rb
+- lib/Duration/Days.rb
+- lib/Duration/Hours.rb
+- lib/Duration/Milliseconds.rb
+- lib/Duration/Minutes.rb
+- lib/Duration/Months.rb
+- lib/Duration/Numeric.rb
+- lib/Duration/Seconds.rb
+- lib/Duration/VERSION.rb
+- lib/Duration/Weeks.rb
+homepage: http://github.com/thoran/duration.rb
+licenses:
+- Ruby
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.5'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: Objects for handling durations of time.
+test_files: []