halftime 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ec5f550eafbca8996051a85422fef96961fb4eb6
+  data.tar.gz: 24afbba15ed8e4046482ce8edf22e803d148eabf
+SHA512:
+  metadata.gz: 6ca382c6ad2f0a435fb59ff46da92c8ed47ae89f21f5e6183fb931567ff9fefd91521e270c7311ebccc8568dc36f75d68a7d16e909bf21d7379daf455e212478
+  data.tar.gz: fb045141667c9aa781f183137f462c2573cfe14f4cb3404f82116c1c92f9b46737ae2e8b335bd66efdc0e97ccec32c90b2f99643455fb95e84204c65091e193b

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.ruby-version

@@ -0,0 +1 @@
+2.1.4

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Carl Olof Erlandsson
+
+MIT License
+
+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,29 @@
+Halftime
+========
+
+A natural language time parser.
+
+Installation
+------------
+
+Add this line to your application's Gemfile:
+
+    gem "halftime"
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install halftime
+
+Usage
+-----
+
+    require "halftime"
+
+    Halftime::Parser.new("tomorrow at 12", now: Time.now).time
+
+If a time can not be parsed from the passed string, `Halftime::Parser#time` will
+return `nil`.

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/halftime.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'halftime/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "halftime"
+  spec.version       = Halftime::VERSION
+  spec.authors       = ["Calle Erlandsson"]
+  spec.email         = ["calle@calleerlandsson.com"]
+  spec.summary       = %q{Natural language time parser.}
+  spec.homepage      = "https://github.com/calleerlandsson/halftime"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "activesupport"
+  spec.add_dependency "parslet"
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+end

data/lib/halftime.rb

@@ -0,0 +1,2 @@
+require "halftime/version"
+require "halftime/parser"

data/lib/halftime/date_factories.rb

@@ -0,0 +1,68 @@
+module Halftime
+  module DateFactories
+    class Unambiguous
+      def initialize(year, month, day)
+        @year = year
+        @month = month
+        @day = day
+      end
+
+      def new(_)
+        Date.new(year, month, day)
+      end
+
+      def ambiguous?
+        false
+      end
+
+      private
+
+      attr_reader :year, :month, :day
+    end
+
+    class Ambiguous
+      def new
+        raise NotImplementedError
+      end
+
+      def ambiguous?
+        true
+      end
+    end
+
+    class Today < Ambiguous
+      def new(current)
+        current
+      end
+    end
+
+    class Tomorrow < Ambiguous
+      def new(current)
+        current.tomorrow
+      end
+    end
+
+    class MonthDay < Ambiguous
+      def initialize(month, day)
+        @month = month
+        @day = day
+      end
+
+      def new(current)
+        advance(Date.new(current.year, month, day), current)
+      end
+
+      private
+
+      attr_reader :month, :day
+
+      def advance(date, current)
+        if date <= current
+          date.advance(years: 1)
+        else
+          date
+        end
+      end
+    end
+  end
+end

data/lib/halftime/internal_parser.rb

@@ -0,0 +1,207 @@
+require "parslet"
+
+module Halftime
+  class InternalParser < Parslet::Parser
+    root :time_components
+
+    rule :time_components do
+      (date_and_or_time_of_day >> time_zone?).as(:time_components)
+    end
+
+    rule :date_and_or_time_of_day do
+      on? >> date >> at? >> time_of_day.maybe |
+        at? >> time_of_day >> on? >> date.maybe
+    end
+
+    rule :date do
+      (tomorrow | numerical_date | date_with_month_name).as(:date_factory)
+    end
+
+    rule :on? do
+      spaces? >> str("on").maybe >> spaces?
+    end
+
+    rule :tomorrow do
+      str("tomorrow").as(:tomorrow)
+    end
+
+    rule :numerical_date do
+      numerical_month_day >> (date_separator >> year).maybe |
+        (year >> date_separator).maybe >> numerical_month_day
+    end
+
+    rule :numerical_month_day do
+      month_number >> date_separator >> day |
+        day >> date_separator >> month_number
+    end
+
+    rule :date_with_month_name do
+      named_month_day >> (spaces >> year).maybe |
+        (year >> spaces).maybe >> named_month_day
+    end
+
+    rule :named_month_day do
+      month_name >> spaces? >> day | day >> spaces? >> month_name
+    end
+
+    rule :month_name do
+      (january | february | march | april | may | june | july | august |
+       september | october | november | december).as(:month)
+    end
+
+    rule :january do
+      (stri("January") | stri("Jan")).as(:january)
+    end
+
+    rule :february do
+      (stri("February") | stri("Feb")).as(:february)
+    end
+
+    rule :march do
+      (stri("March") | stri("Mar")).as(:march)
+    end
+
+    rule :april do
+      (stri("April") | stri("Apr")).as(:april)
+    end
+
+    rule :may do
+      stri("May").as(:may)
+    end
+
+    rule :june do
+      (stri("June") | stri("Jun")).as(:june)
+    end
+
+    rule :july do
+      (stri("July") | stri("Jul")).as(:july)
+    end
+
+    rule :august do
+      (stri("August") | stri("Aug")).as(:august)
+    end
+
+    rule :september do
+      (stri("September") | stri("Sep")).as(:september)
+    end
+
+    rule :october do
+      (stri("October") | stri("Oct")).as(:october)
+    end
+
+    rule :november do
+      (stri("November") | stri("Nov")).as(:november)
+    end
+
+    rule :december do
+      (stri("December") | stri("Dec")).as(:december)
+    end
+
+    rule :month_number do
+      one_to_twelve.as(:month)
+    end
+
+    rule :one_to_twelve do
+      (str("1") >> match("[0-2]") |
+       str("0").maybe >> match("[1-9]")).as(:integer)
+    end
+
+    rule :date_separator do
+      match("[/\-]")
+    end
+
+    rule :day do
+      one_to_thirty.as(:day)
+    end
+
+    rule :one_to_thirty do
+      (str("3") >> match("[0-1]") |
+       match("[1-2]") >> digit |
+       str("0").maybe >> match("[1-9]")).as(:integer)
+    end
+
+    rule :year do
+      digit.repeat(4).as(:integer).as(:year)
+    end
+
+    rule :digit do
+      match("[0-9]")
+    end
+
+    rule :time_of_day do
+      time_of_day_components.as(:time_of_day)
+    end
+
+    rule :time_of_day_components do
+      (hour >>
+       time_separator? >> minute? >>
+       time_separator? >> second? >>
+       spaces? >> meridiem?).as(:time_of_day_components)
+    end
+
+    rule :at? do
+      str("T") | spaces? >> (str("at") | str("@")).maybe >> spaces?
+    end
+
+    rule :hour do
+      zero_to_twentyfour.as(:hour)
+    end
+
+    rule :zero_to_twentyfour do
+      (str("2") >> match("[0-4]") |
+       match("[0-1]").maybe >> digit |
+       digit).as(:integer)
+    end
+
+    rule :time_separator? do
+      match("[:.]").maybe
+    end
+
+    rule :minute? do
+      zero_to_fiftynine.as(:minute).maybe
+    end
+
+    rule :second? do
+      zero_to_fiftynine.as(:second).maybe
+    end
+
+    rule :zero_to_fiftynine do
+      (match("[0-5]").maybe >> digit | digit).as(:integer)
+    end
+
+    rule :meridiem? do
+      (am | pm).as(:meridiem_factory).maybe
+    end
+
+    rule :am do
+      str("am").as(:am)
+    end
+
+    rule :pm do
+      str("pm").as(:pm)
+    end
+
+    rule :time_zone? do
+      (utc).as(:time_zone).maybe
+    end
+
+    rule :utc do
+      str("Z").as(:utc)
+    end
+
+    rule :spaces? do
+      spaces.maybe
+    end
+
+    rule :spaces do
+      str(" ").repeat(1)
+    end
+
+    def stri(string)
+      string.
+        split(//).
+        map! { |char| match("[#{char.upcase}#{char.downcase}]") }.
+        reduce(:>>)
+    end
+  end
+end

data/lib/halftime/meridies.rb

@@ -0,0 +1,55 @@
+module Halftime
+  module Meridies
+    class Meridiem
+      def initialize(hour)
+        @hour = hour
+      end
+
+      def unspecified?
+        raise NotImplementedError
+      end
+
+      private
+
+      attr_reader :hour
+    end
+
+    class Am < Meridiem
+      def hour
+        if super == 12
+          0
+        else
+          super
+        end
+      end
+
+      def unspecified?
+        false
+      end
+    end
+
+    class Pm < Meridiem
+      def hour
+        if super < 12
+          super + 12
+        else
+          super
+        end
+      end
+
+      def unspecified?
+        false
+      end
+    end
+
+    class Unspecified < Meridiem
+      def hour
+        super
+      end
+
+      def unspecified?
+        true
+      end
+    end
+  end
+end

data/lib/halftime/parser.rb

@@ -0,0 +1,32 @@
+require "parslet"
+require "halftime/internal_parser"
+require "halftime/transform"
+
+module Halftime
+  class Parser
+    def initialize(string, now:)
+      @string = string
+      @now = now
+      @parser = InternalParser.new
+      @transform = Transform.new
+    end
+
+    def time
+      time_factory.time(now)
+    rescue Parslet::ParseFailed
+      nil
+    end
+
+    private
+
+    def time_factory
+      transform.apply(tree)
+    end
+
+    def tree
+      parser.parse(string)
+    end
+
+    attr_reader :string, :now, :parser, :transform
+  end
+end

data/lib/halftime/time_factory.rb

@@ -0,0 +1,83 @@
+require "active_support"
+require "active_support/core_ext"
+require "halftime/date_factories"
+require "halftime/time_of_day"
+require "halftime/time_zones"
+
+module Halftime
+  class TimeFactory
+    def initialize(
+      date_factory: DateFactories::Today.new,
+      time_of_day: TimeOfDay.new,
+      time_zone: TimeZones::Current
+    )
+      @date_factory = date_factory
+      @time_of_day = time_of_day
+      @time_zone = time_zone
+    end
+
+    def time(now)
+      advance(base_time(now), now)
+    end
+
+    private
+
+    delegate :hour, :minute, :second, to: :time_of_day
+
+    def base_time(now)
+      Time.new(
+        year(now),
+        month(now),
+        day(now),
+        hour,
+        minute,
+        second,
+        offset(now),
+      )
+    end
+
+    def year(now)
+      date(now).year
+    end
+
+    def month(now)
+      date(now).month
+    end
+
+    def day(now)
+      date(now).day
+    end
+
+    def date(now)
+      date_factory.new(now.to_date)
+    end
+
+    def offset(now)
+      time_zone.new(now).offset
+    end
+
+    def advance(time, now)
+      if past?(time, now)
+        time + distance
+      else
+        time
+      end
+    end
+
+    def past?(time, now)
+      date_factory.ambiguous? &&
+        time.to_date == now.to_date &&
+        time <= now
+    end
+
+    def distance
+      if time_of_day.ambiguous? && hour.between?(1, 11)
+        12.hours
+      else
+        1.day
+      end
+    end
+
+    attr_reader :date_factory, :time_of_day, :time_zone
+  end
+end

data/lib/halftime/time_of_day.rb

@@ -0,0 +1,28 @@
+require "halftime/meridies"
+
+module Halftime
+  class TimeOfDay
+    attr_reader :minute, :second
+
+    delegate :hour, to: :meridiem
+
+    def initialize(
+      hour: 12,
+      minute: 0,
+      second: 0,
+      meridiem_factory: Meridies::Unspecified
+    )
+      @minute = minute
+      @second = second
+      @meridiem = meridiem_factory.new(hour)
+    end
+
+    def ambiguous?
+      meridiem.unspecified?
+    end
+
+    private
+
+    attr_reader :meridiem
+  end
+end

data/lib/halftime/time_zones.rb

@@ -0,0 +1,26 @@
+module Halftime
+  module TimeZones
+    class Current
+      def initialize(now)
+        @now = now
+      end
+
+      def offset
+        now.utc_offset
+      end
+
+      private
+
+      attr_reader :now
+    end
+
+    class UTC
+      def initialize(_)
+      end
+
+      def offset
+        0
+      end
+    end
+  end
+end

data/lib/halftime/transform.rb

@@ -0,0 +1,96 @@
+require "active_support"
+require "active_support/core_ext"
+require "halftime/meridies"
+require "halftime/time_factory"
+require "halftime/time_of_day"
+require "halftime/date_factories"
+require "halftime/time_zones"
+require "parslet"
+
+module Halftime
+  class Transform < Parslet::Transform
+    rule integer: simple(:string) do
+      string.to_i
+    end
+
+    rule january: simple(:january) do
+      1
+    end
+
+    rule february: simple(:january) do
+      2
+    end
+
+    rule march: simple(:march) do
+      3
+    end
+
+    rule april: simple(:april) do
+      4
+    end
+
+    rule may: simple(:may) do
+      5
+    end
+
+    rule june: simple(:june) do
+      6
+    end
+
+    rule july: simple(:july) do
+      7
+    end
+
+    rule august: simple(:august) do
+      8
+    end
+
+    rule september: simple(:september) do
+      9
+    end
+
+    rule october: simple(:october) do
+      10
+    end
+
+    rule november: simple(:november) do
+      11
+    end
+
+    rule december: simple(:december) do
+      12
+    end
+
+    rule tomorrow: simple(:tomorrow) do
+      DateFactories::Tomorrow.new
+    end
+
+    rule month: simple(:month), day: simple(:day) do
+      DateFactories::MonthDay.new(month, day)
+    end
+
+    rule month: simple(:month), day: simple(:day), year: simple(:year) do
+      DateFactories::Unambiguous.new(year, month, day)
+    end
+
+    rule am: simple(:am) do
+      Meridies::Am
+    end
+
+    rule pm: simple(:am) do
+      Meridies::Pm
+    end
+
+    rule time_of_day_components: subtree(:time_of_day_components) do
+      TimeOfDay.new(time_of_day_components)
+    end
+
+    rule utc: simple(:utc) do
+      TimeZones::UTC
+    end
+
+    rule time_components: subtree(:time_components) do
+      TimeFactory.new(time_components)
+    end
+  end
+end

data/lib/halftime/version.rb

@@ -0,0 +1,3 @@
+module Halftime
+  VERSION = "0.0.1"
+end

data/spec/lib/halftime/parser_spec.rb

@@ -0,0 +1,260 @@
+require "spec_helper"
+require "active_support"
+require "active_support/core_ext"
+require "active_support/testing/time_helpers"
+require "halftime/parser"
+
+describe Halftime::Parser do
+  include ActiveSupport::Testing::TimeHelpers
+
+  describe "#time" do
+    context "at 2014-11-14 8:00:00" do
+      def now
+        Time.new(2014, 11, 14, 8, 0, 0, 0)
+      end
+
+      context "when unparseable" do
+        it "returns nil" do
+          expect(time("this is not a time")).to eq nil
+        end
+      end
+
+      describe "hours" do
+        specify { expect(time("07")).to eq Time.new(2014, 11, 14, 19, 0, 0, 0) }
+        specify { expect(time("7")).to eq Time.new(2014, 11, 14, 19, 0, 0, 0) }
+        specify { expect(time("7am")).to eq Time.new(2014, 11, 15, 7, 0, 0, 0) }
+        specify { expect(time("7pm")).to eq Time.new(2014, 11, 14, 19, 0, 0, 0) }
+        specify { expect(time("8")).to eq Time.new(2014, 11, 14, 20, 0, 0, 0) }
+        specify { expect(time("8am")).to eq Time.new(2014, 11, 15, 8, 0, 0, 0) }
+        specify { expect(time("8pm")).to eq Time.new(2014, 11, 14, 20, 0, 0, 0) }
+        specify { expect(time("9")).to eq Time.new(2014, 11, 14, 9, 0, 0, 0) }
+        specify { expect(time("9am")).to eq Time.new(2014, 11, 14, 9, 0, 0, 0) }
+        specify { expect(time("9pm")).to eq Time.new(2014, 11, 14, 21, 0, 0, 0) }
+        specify { expect(time("22")).to eq Time.new(2014, 11, 14, 22, 0, 0, 0) }
+        specify { expect(time("22am")).to eq Time.new(2014, 11, 14, 22, 0, 0, 0) }
+        specify { expect(time("22pm")).to eq Time.new(2014, 11, 14, 22, 0, 0, 0) }
+        specify { expect(time("12")).to eq Time.new(2014, 11, 14, 12, 0, 0, 0) }
+        specify { expect(time("12am")).to eq Time.new(2014, 11, 15, 0, 0, 0, 0) }
+        specify { expect(time("12pm")).to eq Time.new(2014, 11, 14, 12, 0, 0, 0) }
+        specify { expect(time("at 3")).to eq Time.new(2014, 11, 14, 15, 0, 0, 0) }
+        specify { expect(time("at 2pm")).to eq Time.new(2014, 11, 14, 14, 0, 0, 0) }
+        specify { expect(time("at 22")).to eq Time.new(2014, 11, 14, 22, 0, 0, 0) }
+        specify { expect(time("at 04am")).to eq Time.new(2014, 11, 15, 4, 0, 0, 0) }
+        specify { expect(time("at 12")).to eq Time.new(2014, 11, 14, 12, 0, 0, 0) }
+        specify { expect(time("at 0")).to eq Time.new(2014, 11, 15, 0, 0, 0, 0) }
+        specify { expect(time("@ 4")).to eq Time.new(2014, 11, 14, 16, 0, 0, 0) }
+        specify { expect(time("@ 5am")).to eq Time.new(2014, 11, 15, 5, 0, 0, 0) }
+        specify { expect(time("@ 00")).to eq Time.new(2014, 11, 15, 0, 0, 0, 0) }
+        specify { expect(time("@ 23")).to eq Time.new(2014, 11, 14, 23, 0, 0, 0) }
+        specify { expect(time("@ 2pm")).to eq Time.new(2014, 11, 14, 14, 0, 0, 0) }
+        specify { expect(time("@1 am")).to eq Time.new(2014, 11, 15, 1, 0, 0, 0) }
+      end
+
+      describe "hours and minutes" do
+        specify { expect(time("7:01")).to eq Time.new(2014, 11, 14, 19, 1, 0, 0) }
+        specify { expect(time("7:01am")).to eq Time.new(2014, 11, 15, 7, 1, 0, 0) }
+        specify { expect(time("7:01pm")).to eq Time.new(2014, 11, 14, 19, 1, 0, 0) }
+        specify { expect(time("8:01")).to eq Time.new(2014, 11, 14, 8, 1, 0, 0) }
+        specify { expect(time("8:01am")).to eq Time.new(2014, 11, 14, 8, 1, 0, 0) }
+        specify { expect(time("8:01pm")).to eq Time.new(2014, 11, 14, 20, 1, 0, 0) }
+        specify { expect(time("9:01")).to eq Time.new(2014, 11, 14, 9, 1, 0, 0) }
+        specify { expect(time("9:01am")).to eq Time.new(2014, 11, 14, 9, 1, 0, 0) }
+        specify { expect(time("9:01pm")).to eq Time.new(2014, 11, 14, 21, 1, 0, 0) }
+        specify { expect(time("22:01")).to eq Time.new(2014, 11, 14, 22, 1, 0, 0) }
+        specify { expect(time("22:01am")).to eq Time.new(2014, 11, 14, 22, 1, 0, 0) }
+        specify { expect(time("22:01pm")).to eq Time.new(2014, 11, 14, 22, 1, 0, 0) }
+        specify { expect(time("12:01")).to eq Time.new(2014, 11, 14, 12, 1, 0, 0) }
+        specify { expect(time("12:01am")).to eq Time.new(2014, 11, 15, 0, 1, 0, 0) }
+        specify { expect(time("12:01pm")).to eq Time.new(2014, 11, 14, 12, 1, 0, 0) }
+        specify { expect(time("00:00")).to eq Time.new(2014, 11, 15, 0, 0, 0, 0) }
+        specify { expect(time("04:01pm")).to eq Time.new(2014, 11, 14, 16, 1, 0, 0) }
+        specify { expect(time("15.32pm")).to eq Time.new(2014, 11, 14, 15, 32, 0, 0) }
+        specify { expect(time("4.01")).to eq Time.new(2014, 11, 14, 16, 1, 0, 0) }
+        specify { expect(time("05.59")).to eq Time.new(2014, 11, 14, 17, 59, 0, 0) }
+        specify { expect(time("323")).to eq Time.new(2014, 11, 14, 15, 23, 0, 0) }
+        specify { expect(time("2312")).to eq Time.new(2014, 11, 14, 23, 12, 0, 0) }
+        specify { expect(time("0902")).to eq Time.new(2014, 11, 14, 9, 2, 0, 0) }
+        specify { expect(time("1123am")).to eq Time.new(2014, 11, 14, 11, 23, 0, 0) }
+        specify { expect(time("0902")).to eq Time.new(2014, 11, 14, 9, 2, 0, 0) }
+        specify { expect(time("2.06")).to eq Time.new(2014, 11, 14, 14, 6, 0, 0) }
+      end
+
+      describe "month and day" do
+        specify { expect(time("11/15")).to eq Time.new(2014, 11, 15, 12, 0, 0, 0) }
+        specify { expect(time("15/11")).to eq Time.new(2014, 11, 15, 12, 0, 0, 0) }
+        specify { expect(time("1/3")).to eq Time.new(2015, 1, 3, 12, 0, 0, 0) }
+        specify { expect(time("7/8")).to eq Time.new(2015, 7, 8, 12, 0, 0, 0) }
+        specify { expect(time("01/05")).to eq Time.new(2015, 1, 5, 12, 0, 0, 0) }
+        specify { expect(time("on 11/15")).to eq Time.new(2014, 11, 15, 12, 0, 0, 0) }
+        specify { expect(time("Nov 15")).to eq Time.new(2014, 11, 15, 12, 0, 0, 0) }
+        specify { expect(time("December 3")).to eq Time.new(2014, 12, 3, 12, 0, 0, 0) }
+        specify { expect(time("oct 30")).to eq Time.new(2015, 10, 30, 12, 0, 0, 0) }
+        specify { expect(time("july 02")).to eq Time.new(2015, 7, 2, 12, 0, 0, 0) }
+        specify { expect(time("3 Jun")).to eq Time.new(2015, 6, 3, 12, 0, 0, 0) }
+        specify { expect(time("12 January")).to eq Time.new(2015, 1, 12, 12, 0, 0, 0) }
+        specify { expect(time("28 feb")).to eq Time.new(2015, 2, 28, 12, 0, 0, 0) }
+        specify { expect(time("04 september")).to eq Time.new(2015, 9, 4, 12, 0, 0, 0) }
+        specify { expect(time("2june")).to eq Time.new(2015, 6, 2, 12, 0, 0, 0) }
+        specify { expect(time("feb09")).to eq Time.new(2015, 2, 9, 12, 0, 0, 0) }
+        specify { expect(time("tomorrow")).to eq Time.new(2014, 11, 15, 12, 0, 0, 0) }
+      end
+
+      describe "year, month and day" do
+        specify { expect(time("11/15/2016")).to eq Time.new(2016, 11, 15, 12, 0, 0, 0) }
+        specify { expect(time("2/5/1900")).to eq Time.new(1900, 2, 5, 12, 0, 0, 0) }
+        specify { expect(time("31/7/1900")).to eq Time.new(1900, 7, 31, 12, 0, 0, 0) }
+        specify { expect(time("2015/05/30")).to eq Time.new(2015, 5, 30, 12, 0, 0, 0) }
+        specify { expect(time("2015/12/05")).to eq Time.new(2015, 12, 5, 12, 0, 0, 0) }
+        specify { expect(time("2015/31/05")).to eq Time.new(2015, 5, 31, 12, 0, 0, 0) }
+        specify { expect(time("1723-04-07")).to eq Time.new(1723, 4, 7, 12, 0, 0, 0) }
+        specify { expect(time("2014-30-09")).to eq Time.new(2014, 9, 30, 12, 0, 0, 0) }
+        specify { expect(time("22-08-2013")).to eq Time.new(2013, 8, 22, 12, 0, 0, 0) }
+        specify { expect(time("07-08-2013")).to eq Time.new(2013, 7, 8, 12, 0, 0, 0) }
+        specify { expect(time("Nov 15 1923")).to eq Time.new(1923, 11, 15, 12, 0, 0, 0) }
+        specify { expect(time("December 3 2013")).to eq Time.new(2013, 12, 3, 12, 0, 0, 0) }
+        specify { expect(time("oct 30 1999")).to eq Time.new(1999, 10, 30, 12, 0, 0, 0) }
+        specify { expect(time("july 02 2020")).to eq Time.new(2020, 7, 2, 12, 0, 0, 0) }
+        specify { expect(time("3 Jun 2004")).to eq Time.new(2004, 6, 3, 12, 0, 0, 0) }
+        specify { expect(time("12 January 1787")).to eq Time.new(1787, 1, 12, 12, 0, 0, 0) }
+        specify { expect(time("28 feb 1245")).to eq Time.new(1245, 2, 28, 12, 0, 0, 0) }
+        specify { expect(time("04 september 1955")).to eq Time.new(1955, 9, 4, 12, 0, 0, 0) }
+        specify { expect(time("2009 Mar 3")).to eq Time.new(2009, 3, 3, 12, 0, 0, 0) }
+        specify { expect(time("1991 June 30")).to eq Time.new(1991, 6, 30, 12, 0, 0, 0) }
+        specify { expect(time("1756 apr 23")).to eq Time.new(1756, 4, 23, 12, 0, 0, 0) }
+        specify { expect(time("1976 august 13")).to eq Time.new(1976, 8, 13, 12, 0, 0, 0) }
+        specify { expect(time("1955 18 Sep")).to eq Time.new(1955, 9, 18, 12, 0, 0, 0) }
+        specify { expect(time("1233 12 March")).to eq Time.new(1233, 3, 12, 12, 0, 0, 0) }
+        specify { expect(time("1959 21 nov")).to eq Time.new(1959, 11, 21, 12, 0, 0, 0) }
+        specify { expect(time("1877 08 october")).to eq Time.new(1877, 10, 8, 12, 0, 0, 0) }
+        specify { expect(time("on 1923 23july")).to eq Time.new(1923, 7, 23, 12, 0, 0, 0) }
+        specify { expect(time("on 2134 mar14")).to eq Time.new(2134, 3, 14, 12, 0, 0, 0) }
+      end
+
+      describe "month, day and hours" do
+        specify { expect(time("7/8 9pm")).to eq Time.new(2015, 7, 8, 21, 0, 0, 0) }
+        specify { expect(time("10/8 1")).to eq Time.new(2015, 10, 8, 1, 0, 0, 0) }
+        specify { expect(time("10/5 @ 3pm")).to eq Time.new(2015, 10, 5, 15, 0, 0, 0) }
+        specify { expect(time("on 11/15 at 3")).to eq Time.new(2014, 11, 15, 3, 0, 0, 0) }
+        specify { expect(time("@ 3pm 10/5")).to eq Time.new(2015, 10, 5, 15, 0, 0, 0) }
+        specify { expect(time("Jul 03 3")).to eq Time.new(2015, 7, 3, 3, 0, 0, 0) }
+        specify { expect(time("February 14 4pm")).to eq Time.new(2015, 2, 14, 16, 0, 0, 0) }
+        specify { expect(time("dec 23 @ 22")).to eq Time.new(2014, 12, 23, 22, 0, 0, 0) }
+        specify { expect(time("august 02 at 1")).to eq Time.new(2015, 8, 2, 1, 0, 0, 0) }
+        specify { expect(time("on 16 Mar 3")).to eq Time.new(2015, 3, 16, 3, 0, 0, 0) }
+        specify { expect(time("5 March @ 1am")).to eq Time.new(2015, 3, 5, 1, 0, 0, 0) }
+        specify { expect(time("28 dec 14")).to eq Time.new(2014, 12, 28, 14, 0, 0, 0) }
+        specify { expect(time("04 july at 5am")).to eq Time.new(2015, 7, 4, 5, 0, 0, 0) }
+        specify { expect(time("12pm Dec 04")).to eq Time.new(2014, 12, 4, 12, 0, 0, 0) }
+        specify { expect(time("1am August 12")).to eq Time.new(2015, 8, 12, 1, 0, 0, 0) }
+        specify { expect(time("03 on apr 19")).to eq Time.new(2015, 4, 19, 3, 0, 0, 0) }
+        specify { expect(time("@ 20 january 22")).to eq Time.new(2015, 1, 22, 20, 0, 0, 0) }
+        specify { expect(time("3 12 Feb")).to eq Time.new(2015, 2, 12, 3, 0, 0, 0) }
+        specify { expect(time("8pm on 16 October")).to eq Time.new(2015, 10, 16, 20, 0, 0, 0) }
+        specify { expect(time("13 02 mar")).to eq Time.new(2015, 3, 2, 13, 0, 0, 0) }
+        specify { expect(time("@ 11 on 04 november")).to eq Time.new(2015, 11, 4, 11, 0, 0, 0) }
+        specify { expect(time("tomorrow @ 1pm")).to eq Time.new(2014, 11, 15, 13, 0, 0, 0) }
+        specify { expect(time("tomorrow 20")).to eq Time.new(2014, 11, 15, 20, 0, 0, 0) }
+        specify { expect(time("tomorrow at 01")).to eq Time.new(2014, 11, 15, 1, 0, 0, 0) }
+        specify { expect(time("4am tomorrow")).to eq Time.new(2014, 11, 15, 4, 0, 0, 0) }
+        specify { expect(time("17 tomorrow")).to eq Time.new(2014, 11, 15, 17, 0, 0, 0) }
+        specify { expect(time("@ 3 tomorrow")).to eq Time.new(2014, 11, 15, 3, 0, 0, 0) }
+      end
+
+      describe "month, day, hours and minutes" do
+        specify { expect(time("11/14 04:23")).to eq Time.new(2015, 11, 14, 4, 23, 0, 0) }
+        specify { expect(time("11/15 05:44")).to eq Time.new(2014, 11, 15, 5, 44, 0, 0) }
+        specify { expect(time("15/11 1533")).to eq Time.new(2014, 11, 15, 15, 33, 0, 0) }
+        specify { expect(time("1/3 13.00")).to eq Time.new(2015, 1, 3, 13, 0, 0, 0) }
+        specify { expect(time("01/05 0213")).to eq Time.new(2015, 1, 5, 2, 13, 0, 0) }
+        specify { expect(time("Jul 03 3")).to eq Time.new(2015, 7, 3, 3, 0, 0, 0) }
+        specify { expect(time("February 14 423pm")).to eq Time.new(2015, 2, 14, 16, 23, 0, 0) }
+        specify { expect(time("dec 23 @ 22:11")).to eq Time.new(2014, 12, 23, 22, 11, 0, 0) }
+        specify { expect(time("august 02 at 112")).to eq Time.new(2015, 8, 2, 11, 2, 0, 0) }
+        specify { expect(time("on 16 Mar 303")).to eq Time.new(2015, 3, 16, 3, 3, 0, 0) }
+        specify { expect(time("5 March @ 1.42")).to eq Time.new(2015, 3, 5, 1, 42, 0, 0) }
+        specify { expect(time("28 dec 14:59")).to eq Time.new(2014, 12, 28, 14, 59, 0, 0) }
+        specify { expect(time("04 july at 5:10am")).to eq Time.new(2015, 7, 4, 5, 10, 0, 0) }
+        specify { expect(time("1238pm Dec 04")).to eq Time.new(2014, 12, 4, 12, 38, 0, 0) }
+        specify { expect(time("1:54am August 12")).to eq Time.new(2015, 8, 12, 1, 54, 0, 0) }
+        specify { expect(time("0300 on apr 19")).to eq Time.new(2015, 4, 19, 3, 0, 0, 0) }
+        specify { expect(time("@ 20.10 january 22")).to eq Time.new(2015, 1, 22, 20, 10, 0, 0) }
+        specify { expect(time("3.56 12 Feb")).to eq Time.new(2015, 2, 12, 3, 56, 0, 0) }
+        specify { expect(time("841pm on 16 October")).to eq Time.new(2015, 10, 16, 20, 41, 0, 0) }
+        specify { expect(time("13.11 02 mar")).to eq Time.new(2015, 3, 2, 13, 11, 0, 0) }
+        specify { expect(time("@ 1101 on 04 november")).to eq Time.new(2015, 11, 4, 11, 1, 0, 0) }
+        specify { expect(time("tomorrow 14:23")).to eq Time.new(2014, 11, 15, 14, 23, 0, 0) }
+        specify { expect(time("tomorrow at 0300")).to eq Time.new(2014, 11, 15, 3, 0, 0, 0) }
+        specify { expect(time("tomorrow 345pm")).to eq Time.new(2014, 11, 15, 15, 45, 0, 0) }
+        specify { expect(time("@ 0353 tomorrow")).to eq Time.new(2014, 11, 15, 3, 53, 0, 0) }
+        specify { expect(time("at19.33 tomorrow")).to eq Time.new(2014, 11, 15, 19, 33, 0, 0) }
+        specify { expect(time("1130 tomorrow")).to eq Time.new(2014, 11, 15, 11, 30, 0, 0) }
+      end
+
+      describe "year, month, day and hours" do
+        specify { expect(time("22-08-2013 11")).to eq Time.new(2013, 8, 22, 11, 0, 0, 0) }
+        specify { expect(time("07-08-2013 12")).to eq Time.new(2013, 7, 8, 12, 0, 0, 0) }
+        specify { expect(time("2/5/1900 2am")).to eq Time.new(1900, 2, 5, 2, 0, 0, 0) }
+        specify { expect(time("31/7/1900 12am")).to eq Time.new(1900, 7, 31, 0, 0, 0, 0) }
+        specify { expect(time("2015-12-22 at 10")).to eq Time.new(2015, 12, 22, 10, 0, 0, 0) }
+        specify { expect(time("at 10 2015-12-22")).to eq Time.new(2015, 12, 22, 10, 0, 0, 0) }
+        specify { expect(time("Nov 15 1923 13")).to eq Time.new(1923, 11, 15, 13, 0, 0, 0) }
+        specify { expect(time("5pm December 3 2013")).to eq Time.new(2013, 12, 3, 17, 0, 0, 0) }
+        specify { expect(time("oct 30 1999 @ 1")).to eq Time.new(1999, 10, 30, 1, 0, 0, 0) }
+        specify { expect(time("20 on july 02 2020")).to eq Time.new(2020, 7, 2, 20, 0, 0, 0) }
+        specify { expect(time("3 Jun 2004 8am")).to eq Time.new(2004, 6, 3, 8, 0, 0, 0) }
+        specify { expect(time("23pm 12 January 1787")).to eq Time.new(1787, 1, 12, 23, 0, 0, 0) }
+        specify { expect(time("28 feb 1245 at 11")).to eq Time.new(1245, 2, 28, 11, 0, 0, 0) }
+        specify { expect(time("@ 7am 04 september 1955")).to eq Time.new(1955, 9, 4, 7, 0, 0, 0) }
+        specify { expect(time("on 2009 Mar 3 @ 4")).to eq Time.new(2009, 3, 3, 4, 0, 0, 0) }
+        specify { expect(time("1991 June 30 at 7")).to eq Time.new(1991, 6, 30, 7, 0, 0, 0) }
+        specify { expect(time("10 on 1756 apr 23")).to eq Time.new(1756, 4, 23, 10, 0, 0, 0) }
+        specify { expect(time("1976 august 13 at 6pm")).to eq Time.new(1976, 8, 13, 18, 0, 0, 0) }
+        specify { expect(time("2am 1955 18 Sep")).to eq Time.new(1955, 9, 18, 2, 0, 0, 0) }
+        specify { expect(time("1233 12 March 4")).to eq Time.new(1233, 3, 12, 4, 0, 0, 0) }
+        specify { expect(time("@ 04 1959 21 nov")).to eq Time.new(1959, 11, 21, 4, 0, 0, 0) }
+        specify { expect(time("1877 08 october 03pm")).to eq Time.new(1877, 10, 8, 15, 0, 0, 0) }
+      end
+
+      describe "year, month, day, hour and minutes" do
+        specify { expect(time("11/15/2016 333pm")).to eq Time.new(2016, 11, 15, 15, 33, 0, 0) }
+        specify { expect(time("2015/05/30 1300")).to eq Time.new(2015, 5, 30, 13, 0, 0, 0) }
+        specify { expect(time("2015/12/05 730")).to eq Time.new(2015, 12, 5, 7, 30, 0, 0) }
+        specify { expect(time("2015/31/05 0000")).to eq Time.new(2015, 5, 31, 0, 0, 0, 0) }
+        specify { expect(time("1723-04-07 22:59")).to eq Time.new(1723, 4, 7, 22, 59, 0, 0) }
+        specify { expect(time("2014-30-09 11.2")).to eq Time.new(2014, 9, 30, 11, 2, 0, 0) }
+        specify { expect(time("Nov 15 1923 13:10")).to eq Time.new(1923, 11, 15, 13, 10, 0, 0) }
+        specify { expect(time("523pm December 3 2013")).to eq Time.new(2013, 12, 3, 17, 23, 0, 0) }
+        specify { expect(time("oct 30 1999 @ 0100")).to eq Time.new(1999, 10, 30, 1, 0, 0, 0) }
+        specify { expect(time("20:54 on july 02 2020")).to eq Time.new(2020, 7, 2, 20, 54, 0, 0) }
+        specify { expect(time("3 Jun 2004 8.15am")).to eq Time.new(2004, 6, 3, 8, 15, 0, 0) }
+        specify { expect(time("23.1pm 12 January 1787")).to eq Time.new(1787, 1, 12, 23, 1, 0, 0) }
+        specify { expect(time("28 feb 1245 at 1112")).to eq Time.new(1245, 2, 28, 11, 12, 0, 0) }
+        specify { expect(time("@ 7.45am 04 september 1955")).to eq Time.new(1955, 9, 4, 7, 45, 0, 0) }
+        specify { expect(time("on 2009 Mar 3 @ 4:59")).to eq Time.new(2009, 3, 3, 4, 59, 0, 0) }
+        specify { expect(time("1991 June 30 at 7.3")).to eq Time.new(1991, 6, 30, 7, 3, 0, 0) }
+        specify { expect(time("10:34 on 1756 apr 23")).to eq Time.new(1756, 4, 23, 10, 34, 0, 0) }
+        specify { expect(time("1976 august 13 at 620pm")).to eq Time.new(1976, 8, 13, 18, 20, 0, 0) }
+        specify { expect(time("0203am 1955 18 Sep")).to eq Time.new(1955, 9, 18, 2, 3, 0, 0) }
+        specify { expect(time("1233 12 March 444")).to eq Time.new(1233, 3, 12, 4, 44, 0, 0) }
+        specify { expect(time("@ 04.37 1959 21 nov")).to eq Time.new(1959, 11, 21, 4, 37, 0, 0) }
+        specify { expect(time("1877 08 october 03:18pm")).to eq Time.new(1877, 10, 8, 15, 18, 0, 0) }
+        specify { expect(time("2014-11-20T18:46:41Z")).to eq Time.new(2014, 11, 20, 18, 46, 41, 0) }
+        specify { expect(time("2014-11-14T07:00:00Z")).to eq Time.new(2014, 11, 14, 7, 0, 0, 0) }
+      end
+    end
+
+    context "at 2014-12-31 13:00:00" do
+      def now
+        Time.new(2014, 12, 31, 13, 0, 0, 0)
+      end
+
+      describe "month and day" do
+        specify { expect(time("tomorrow")).to eq Time.new(2015, 1, 1, 12, 0, 0, 0) }
+      end
+    end
+
+    def time(string)
+      described_class.new(string, now: now).time
+    end
+  end
+end

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification
+name: halftime
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Calle Erlandsson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-11-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: parslet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- calle@calleerlandsson.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".ruby-version"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- halftime.gemspec
+- lib/halftime.rb
+- lib/halftime/date_factories.rb
+- lib/halftime/internal_parser.rb
+- lib/halftime/meridies.rb
+- lib/halftime/parser.rb
+- lib/halftime/time_factory.rb
+- lib/halftime/time_of_day.rb
+- lib/halftime/time_zones.rb
+- lib/halftime/transform.rb
+- lib/halftime/version.rb
+- spec/lib/halftime/parser_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/calleerlandsson/halftime
+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.2.2
+signing_key: 
+specification_version: 4
+summary: Natural language time parser.
+test_files:
+- spec/lib/halftime/parser_spec.rb
+- spec/spec_helper.rb