just_time 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6aec9eb51451cdafe294c8581bed1e22afbe1cf4
+  data.tar.gz: 474f870b572860db415c67fbfe02d290e563877c
+SHA512:
+  metadata.gz: a98dc5f5fa4e586335e2ad8b659137ac1ecacc77748dd6540188e8c98b8d32f57b2e8b3654698823914d1f061eadf08ac83513703a3d2dfe012af513c4879e2c
+  data.tar.gz: 2b11c2ba8034d0fa0d196365ae6bcd4793a21fce0208f4ad1cf36e93b24bcc485d0080f0f84e0d862be3d77641970d363dfa6e3dd03334c9bce8d3a3d4ede1c2

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.0
+before_install: gem install bundler -v 1.15.1

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in just_time.gemspec
+gemspec

data/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Andrew Jones
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,49 @@
+# JustTime
+
+A class to represent a time object without a date. Ruby doesn't have one, and if you don't want to
+rely on, eg, Sequel.SQLTime, then you have to roll your own.
+
+Or you can use mine. ;)
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'just_time'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install just_time
+
+
+## Usage
+
+The code is very short and hopefully the whole thing is pretty obvious. Some example code:
+
+```ruby
+
+jt1 = JustTime.new("12:34:56")
+jt2 = JustTime.from_time(Time.now - 120)
+jt3 = JustTime.now
+
+jt4 = jt1 - jt2
+puts jt2.to_s(:hhmm)
+date = jt2.to_time(Date.today)
+
+```
+
+
+## Thanks
+
+This code was developed, by me, during working hours at [James Hall & Co.
+Ltd](https://www.jameshall.co.uk/). I'm incredibly greatful that they have permitted me to
+open-source it.
+
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "just_time"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/just_time.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "just_time"
+
+Gem::Specification.new do |spec|
+  spec.name     = "just_time"
+  spec.version  = JustTime::VERSION
+  spec.authors  = ["Andy Jones"]
+  spec.email    = ["andy@twosticksconsulting.co.uk"]
+
+  spec.summary  = %q|a little class to handle time-without-date|
+  spec.homepage = "https://bitbucket.org/andy-twosticks/just_time"
+  spec.license  = "MIT"
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rspec", "~> 3.8"
+end

data/lib/just_time.rb

@@ -0,0 +1,134 @@
+require 'date'
+require 'time'
+
+
+##
+# A class to represent a time object without a date
+# Ruby doesn't have one, and I don't want to rely on, eg, Sequel.SQLTime.
+#
+class JustTime
+  include Comparable
+
+  VERSION = "0.1.1"
+
+  attr_reader :ssm # Seconds Since Midnight
+
+  class << self
+
+    def from_time(time)
+      return nil if time.nil?
+      secs = ( time - midnight(time) ).to_i 
+      self.new(secs)
+    end
+
+    def parse(string)
+      return nil if (string.nil? || string =~ /\A\s*\Z/)
+
+      begin
+        parts = string.split(":").map{|s| Integer(s, 10) }
+        raise if parts.size < 2
+      rescue
+        raise ArgumentError,
+              "Bad parameters passed to JustTime.parse - '#{string}'"
+
+      end
+
+      self.new(*parts)
+    end
+
+    def now
+      secs = (Time.now - midnight).to_i
+      self.new(secs)
+    end
+    
+    def midnight(time=Time.now)
+      Time.new(time.year, time.month, time.day)
+    end
+
+  end # of class << self
+
+  def initialize(*arg)
+    fail_bad_params("new", arg) unless arg.all?{|a| a.kind_of?(Fixnum) }
+    fail_bad_params("new", arg) if arg.size > 1 && arg.any?{|a| a < 0}
+
+    @ssm = 
+      case arg.size
+        when 1 
+          @ssm = arg.first
+        when 2 
+          fail_bad_params("new", arg) if arg.first > 24 || arg.last > 59
+          @ssm = arg.last * 60 + arg.first * 60 * 60
+        when 3
+          fail_bad_params("new", arg) if arg[0] > 24 || arg[1] > 59 || arg[2] > 59
+          @ssm = arg[2] + arg[1] * 60 + arg[0] * 60 * 60
+        else
+          fail_bad_params("new", arg)
+        end
+
+  end
+
+  def minutes
+    ssm / 60 % 60
+  end
+
+  alias mins minutes
+  alias minute minutes
+
+  def hours 
+    ssm / (60 * 60)
+  end
+
+  alias hrs hours
+  alias hour hours
+
+  def seconds
+    ssm % 60
+  end
+
+  alias secs seconds
+  alias second seconds
+
+  ## 
+  # If you want to turn a JustTime into a Time, you might want to supply a date.
+  #
+  def to_time(date=Date.today)
+    Time.new(date.year, date.month, date.day, hours, minutes, seconds)
+  end
+
+  def to_s(mode=:hhmmss)
+    case mode
+      when :hhmm then "%02d:%02d" % [ hours, minutes ]
+      else "%02d:%02d:%02d" % [ hours, minutes, seconds ]
+    end
+  end
+
+  def inspect
+    "#<JustTime #{to_s}>"
+  end
+
+  def -(other)
+    o = other.kind_of?(JustTime) ? other.ssm : other
+    JustTime.new(ssm - o)
+  end
+
+  def +(other)
+    o = other.kind_of?(JustTime) ? other.ssm : other
+    JustTime.new(ssm + o)
+  end
+
+  def <=>(other)
+    return 0 unless other.kind_of? JustTime
+    ssm <=> other.ssm
+  end
+
+  private
+
+  def fail_bad_params(method, para)
+    raise ArgumentError,
+          "Bad parameters passed to JustTime.#{method} - '#{para.inspect}'",
+          caller
+
+  end
+
+end # of JustTime
+

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: just_time
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Andy Jones
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-12-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+description: 
+email:
+- andy@twosticksconsulting.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- just_time.gemspec
+- lib/just_time.rb
+homepage: https://bitbucket.org/andy-twosticks/just_time
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: a little class to handle time-without-date
+test_files: []