cron2english 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 34283e98c0f59e56d15d8c57f7d2132af6a9d128
+  data.tar.gz: 0bcb3f53e715baf34bb2fd215870958c41790d35
+SHA512:
+  metadata.gz: 29ffe6c30702396e09fcf3b4bdfe8db1c6f89f3b259e88c3aee3e613dceb5b7319dbac7f04a8ee3b3f051a25f77ca3c1f0a4754f677054adfcfe9ac0dc1cd007
+  data.tar.gz: 293f79abcea3c3c9fd3dc5168bef0b56730bd7546fc92c51c6c9cf8fc358b75ea7e49fd5e886a335c2af4e88a27aaf9d3616d3dbdb5678f25cc488c0eeb6024b

data/.gitignore

@@ -0,0 +1,52 @@
+# rcov generated
+coverage
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# bundler
+.bundle
+
+# jeweler generated
+pkg
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+#.DS_Store
+
+# For TextMate
+#*.tmproj
+#tmtags
+
+# For emacs:
+#*~
+#\#*
+#.\#*
+
+# For vim:
+.*.swp
+.*.swo
+
+# For redcar:
+#.redcar
+
+# For rubinius:
+#*.rbc
+
+tmp
+README.html

data/.rspec

@@ -0,0 +1 @@
+--color

data/.rvmrc

@@ -0,0 +1,2 @@
+rvm_gemset_create_on_use_flag=1
+rvm gemset use ruby-2.0.0-p247@cron2english

data/Gemfile

@@ -0,0 +1,23 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+gem 'rails', '>= 3.0.0'
+# gem 'rake'
+# gem 'activemodel', '= 3.0.11'
+# gem 'activesupport', '= 3.0.11'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec", "~> 2.4.0"
+  gem "bundler"
+end
+
+group :test do
+  gem 'activerecord-postgresql-adapter', :platforms => :ruby
+  gem 'activerecord-mysql2-adapter', :platforms => :ruby
+  gem 'activerecord-jdbcpostgresql-adapter', :platforms => :jruby
+  gem 'activerecord-jdbcmysql-adapter', :platforms => :jruby
+end

data/Gemfile.lock

@@ -0,0 +1,101 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (4.0.2)
+      actionpack (= 4.0.2)
+      mail (~> 2.5.4)
+    actionpack (4.0.2)
+      activesupport (= 4.0.2)
+      builder (~> 3.1.0)
+      erubis (~> 2.7.0)
+      rack (~> 1.5.2)
+      rack-test (~> 0.6.2)
+    activemodel (4.0.2)
+      activesupport (= 4.0.2)
+      builder (~> 3.1.0)
+    activerecord (4.0.2)
+      activemodel (= 4.0.2)
+      activerecord-deprecated_finders (~> 1.0.2)
+      activesupport (= 4.0.2)
+      arel (~> 4.0.0)
+    activerecord-deprecated_finders (1.0.3)
+    activerecord-mysql2-adapter (0.0.3)
+      mysql2
+    activerecord-postgresql-adapter (0.0.1)
+      pg
+    activesupport (4.0.2)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    arel (4.0.1)
+    atomic (1.1.14)
+    builder (3.1.4)
+    diff-lcs (1.1.3)
+    erubis (2.7.0)
+    hike (1.2.3)
+    i18n (0.6.9)
+    mail (2.5.4)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.25.1)
+    minitest (4.7.5)
+    multi_json (1.8.4)
+    mysql2 (0.3.14)
+    pg (0.17.1)
+    polyglot (0.3.3)
+    rack (1.5.2)
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rails (4.0.2)
+      actionmailer (= 4.0.2)
+      actionpack (= 4.0.2)
+      activerecord (= 4.0.2)
+      activesupport (= 4.0.2)
+      bundler (>= 1.3.0, < 2.0)
+      railties (= 4.0.2)
+      sprockets-rails (~> 2.0.0)
+    railties (4.0.2)
+      actionpack (= 4.0.2)
+      activesupport (= 4.0.2)
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rake (10.1.1)
+    rspec (2.4.0)
+      rspec-core (~> 2.4.0)
+      rspec-expectations (~> 2.4.0)
+      rspec-mocks (~> 2.4.0)
+    rspec-core (2.4.0)
+    rspec-expectations (2.4.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.4.0)
+    sprockets (2.10.1)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    sprockets-rails (2.0.1)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      sprockets (~> 2.8)
+    thor (0.18.1)
+    thread_safe (0.1.3)
+      atomic
+    tilt (1.4.1)
+    treetop (1.4.15)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.38)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activerecord-jdbcmysql-adapter
+  activerecord-jdbcpostgresql-adapter
+  activerecord-mysql2-adapter
+  activerecord-postgresql-adapter
+  bundler
+  rails (>= 3.0.0)
+  rspec (~> 2.4.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Paul A. Jungwirth
+
+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,69 @@
+cron2english
+============
+
+Cron2English is a Ruby library for turning crontab schedules into English text.
+
+It is roughly a Ruby port of Sean Burke's [crontab2english](http://interglacial.com/~sburke/pub/crontab2english.html) Perl script, except its interface is a Ruby method rather than an executable, and it parses only time specs, not all the other things you might find in a crontab (comments, variable definitions, and the commands to run).
+
+Usage
+-----
+
+You can convert a time spec to English like so:
+
+    english = Cron2English.parse("40 5 * * *")
+
+This will yield an array of strings, in this case the following:
+
+    ["5:40am", "every day"]
+
+These strings are chosen so as to sound vaguely human if you say:
+
+    Cron2English.parse("40 5 * * *").join(" ")
+
+Cron2English understands just about anything you'll find in a crontab, including non-POSIX extensions. It can parse:
+
+* `1-20/3 * * * *`
+* `1,2,3 * * * *`
+* `1-9,15-30 * * * *`
+* `1-9/3,15-30/4 * * * *`
+* `1 2 3 4 mON`
+* `1 2 3 jan 5`
+* `@reboot`
+* `@yearly`
+* `@annually`
+* `@monthly`
+* `@weekly`
+* `@daily`
+* `@midnight`
+* `@hourly`
+* `*/3 * * * *`
+
+Known Issues
+------------
+
+None yet!
+
+
+Contributing to Cron2English
+-----------------------------
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone hasn't already requested and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make be sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, that is fine, but please isolate that change to its own commit so I can cherry-pick around it.
+
+Commands for building/releasing/installing:
+
+* `rake build`
+* `rake install`
+* `rake release`
+
+Copyright
+---------
+
+Copyright (c) 2014 Paul A. Jungwirth.
+See LICENSE.txt for further details.
+

data/Rakefile

@@ -0,0 +1,28 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+desc 'Default: run specs'
+task :default => :spec
+
+
+Bundler::GemHelper.install_tasks
+
+
+task :readme => [] do |task|
+  `markdown README.md >README.html`
+end

data/cron2english.gemspec

@@ -0,0 +1,27 @@
+$:.push File.dirname(__FILE__) + '/lib'
+require 'cron2english/version'
+
+Gem::Specification.new do |s|
+  s.name = "cron2english"
+  s.version = Cron2English::VERSION
+  s.date = "2014-01-20"
+
+  s.summary = "Converts a crontab schedule into English text."
+
+  s.authors = ["Paul A. Jungwirth"]
+  s.homepage = "http://github.com/pjungwir/cron2english"
+  s.email = "pj@illuminatedcomputing.com"
+
+  s.licenses = ["MIT"]
+
+  s.require_paths = ["lib"]
+  s.executables = []
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- {test,spec,fixtures}/*`.split("\n")
+
+  s.add_runtime_dependency 'rails', '>= 3.0.0'
+  s.add_development_dependency 'rspec', '~> 2.4.0'
+  s.add_development_dependency 'bundler', '>= 0'
+
+end
+

data/lib/cron2english/all.rb

@@ -0,0 +1,437 @@
+module Cron2English
+
+  DAYS_OF_WEEK = %w{Sun Mon Tue Wed Thu Fri Sat}
+  MONTHS = %w{Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec}
+  MIL2AMPM = ['midnight', *(1..11).map{|i| "#{i}am"}, 'noon', *(1..11).map{|i| "#{i}pm"}]
+  DOW2NUM = Hash[DAYS_OF_WEEK.map(&:downcase).zip(0..6)]
+  NUM2DOW = Hash[(0..6).zip(DAYS_OF_WEEK) + [[7, 'Sun']]]
+  MONTH2NUM = Hash[MONTHS.map(&:downcase).zip(1..12)]
+  NUM2MONTH = Hash[(1..12).zip(MONTHS)]
+  # unshift @months, '';    # What is this about??
+  DOW_REGEX = %r{^(#{DAYS_OF_WEEK.join("|")})$}i
+  MONTH_REGEX = %r{^(#{MONTHS.join("|")}|)$}i
+  NUM2MONTH_LONG = Hash[(1..12).zip(%w{January February March April May June July August September October November December})]
+  NUM2DOW_LONG = %w{Sunday Monday Tuesday Wednesday Thursday Friday Saturday Sunday}
+  ATOM = '\d+|(?:\d+-\d+(?:/\d+)?)'
+  ATOMS_REGEX = %r{^(?:#{ATOM})(?:,#{ATOM})*$}i
+  AT_WORDS = {
+    'reboot'   => 'At reboot',
+    'yearly'   => 'Yearly (midnight on January 1st)',
+    'annually' => 'Yearly (midnight on January 1st)',
+    'monthly'  => 'Monthly (midnight on the first of every month)',
+    'weekly'   => 'Weekly (midnight every Sunday)',
+    'daily'    => 'Daily, at midnight',
+    'midnight' => 'Daily, at midnight',
+    'hourly'   => 'At the top of every hour'
+  }
+
+  def self.parse(str)
+    parser = Cron2English::Parser.new
+    parser.parse(str)
+  end
+
+  class Parser
+
+    def initialize
+      @dow = nil
+      @month = nil
+      @dow2num = {}
+      @month2num = {}
+      @num2dow = {}
+      @num2month = {}
+    end
+
+    def parse(str)
+      str = str.strip
+
+      if str =~ /^@(\w+)$/ and AT_WORDS[$1.downcase]
+        process_vixie($1)
+      else
+        bits = str.split(/[ \t]+/)
+        if bits.size == 5
+          process_trad(*bits)
+        else
+          give_up(str)
+        end
+      end
+    end
+
+    private
+
+    def process_vixie(str)
+      [str]
+    end
+
+    def process_trad(m, h, day_of_month, month, dow)
+      month = MONTH2NUM[$1.downcase] if month =~ MONTH_REGEX
+      month = month.to_s if month
+      dow = DOW2NUM[$1.downcase] if dow =~ DOW_REGEX
+      dow = dow.to_s if dow
+      bits = [m, h, day_of_month, month, dow]
+      unparseable = []
+      bits_segmented = []
+      bits.each_with_index do |bit, i|
+        segments = []
+        if bit == '*'
+          segments << ['*']
+
+        elsif bit =~ %r<^\*/(\d+)$>
+          # a hack for "*/3" etc
+          segments << ['*', $1.to_i]
+
+        elsif bit =~ ATOMS_REGEX
+          bit.split(',').each do |thang|
+            if thang =~ %r<^(?:(\d+)|(?:(\d+)-(\d+)(?:/(\d+))?))$>
+              if $1
+                segments << [$1.to_i]
+              elsif $4
+                segments << [$2.to_i, $3.to_i, $4.to_i]
+              else
+                segments << [$2.to_i, $3.to_i]
+              end
+            else
+              unparseable << ("field %s: \"%s\"" % [i + 1, bit])
+            end
+          end
+        else
+          unparseable << ("field %s: \"%s\"" % [i + 1, bit])
+        end
+        bits_segmented << segments
+      end
+
+      give_up(unparseable.join("; ")) if unparseable.size > 0
+      bits_to_english(bits_segmented)
+    end
+
+    def bits_to_english(bits)
+      # This is the deep ugly scary guts of this program.
+      # The older and eldritch among you might recognize this as sort of a
+      # parody of bad old Lisp style of data-structure handling.
+      time_lines = []
+
+
+      #######################################################################
+      # Render the minutes and hours
+      if bits[0].size   == 1   and bits[1].size    == 1 and
+        bits[0][0].size == 1   and bits[1][0].size == 1 and
+        bits[0][0][0]   != '*' and bits[1][0][0]   != '*'
+        # It's a highly simplifiable time expression!
+        # This is a very common case.  Like "46 13" -> 1:46pm
+        # Formally: when minute and hour are each a single number.
+
+        h = bits[1][0][0]
+        if bits[0][0][0] == 0
+          # Simply at the top of the hour, so just call it by the hour name.
+          time_lines << MIL2AMPM[h]
+
+        else
+          # Can't say "noon:02", so use an always-numeric time format:
+          time_lines << "%s:%02d:%s" % [
+            (h > 12) ? (h - 12) : h,
+            bits[0][0][0],
+            (h >= 12) ? 'pm' : 'am'
+          ]
+        end
+        time_lines[time_lines.size - 1] += ' on'
+
+      else
+        # It's not a highly simplifiable time expression
+
+        # First, minutes:
+        if bits[0][0][0] == '*'
+          if bits[0][0].size == 1 or bits[0][0][1] == 1
+            time_lines << 'every minute of'
+          else
+            time_lines << "every #{freq(bits[0][0][1])} minute of"
+          end
+
+        elsif bits[0].size == 1 and bits[0][0][0] == 0
+          # It's just a '0'.  Ignore it -- instead of bothering
+          # to add a "0 minutes past"
+
+        elsif bits[0].none?{|x| x.size > 1}
+          # It's all like 7,10,15. Conjoinable
+          time_lines << conj_and(bits[0].map{|x| x[0]}) + (bits[0][-1][0] == 1 ? ' minute past' : ' minutes past')
+
+        else
+          # It's just gonna be long.
+          hunks = []
+          bits[0].each do |bit|
+            if bit.size == 1  # "7"
+              hunks << (bit[0] == 1 ? '1 minute' : "#{bit[0]} minutes")
+
+            elsif bit.size == 2 # "7-9"
+              hunks << ("from %d to %d %s" % [*bit, bit[1] == 1 ? 'minute' : 'minutes'])
+
+            elsif bit.size == 3 # "7-20/2"
+              hunks << ("every %d %s from %d to %d" % [bit[2],
+                                                       bit[2] == 1 ? 'minute' : 'minutes',
+                                                       bit[0],
+                                                       bit[1]])
+            end
+          end
+          time_lines << (conj_and(hunks) + " past")
+        end
+
+        # Now hours
+        if bits[1][0][0] == '*'
+          if bits[1][0].size == 1 or bits[1][0][1] == 1
+            time_lines << 'every hour of'
+          else
+            time_lines << "every #{freq(bits[1][0][1])} hour of"
+          end
+
+        else
+          hunks = []
+          bits[1].each do |bit|
+            if bit.size == 1 # "7"
+              hunks << (MIL2AMPM[bit[0]] || "HOUR_#{bit[0]}??")
+
+            elsif bit.size == 2 # "7-9"
+              hunks << ("from %s to %s" % [MIL2AMPM[bit[0]] || "HOUR_#{bit[0]}??",
+                                           MIL2AMPM[bit[1]] || "HOUR_#{bit[1]}??"])
+
+            elsif bit.size == 3 # "7-20/2"
+              hunks << ("every %d %s from %s to %s" % [bit[2],
+                                                       bit[2] == 1 ? 'hour' : 'hours',
+                                                       MIL2AMPM[bit[0]] || "HOUR_#{bit[0]}??",
+                                                       MIL2AMPM[bit[1]] || "HOUR_#{bit[2]}??"])
+            end
+          end
+          time_lines << (conj_and(hunks) + " of")
+        end
+      end
+      # End of hours and minutes
+
+      #######################################################################
+      # Day-of-month
+
+      if bits[2][0][0] == '*'
+        time_lines[-1].gsub!(/ on$/, '')
+        if bits[2][0].size == 1 or bits[2][0][1] == 1
+          time_lines << 'every day of'
+        else
+          time_lines << "every #{freq(bits[2][0][1])} day of"
+        end
+      else
+        hunks = []
+        bits[2].each do |bit|
+          if bit.size == 1  # "7"
+            hunks << "the #{ordinate(bit[0])}"
+
+          elsif bit.size == 2 # "7-9"
+            hunks << ("from the %s to the %s" % [ordinate(bit[0]), ordinate(bit[1])])
+
+          elsif bit.size == 3 # "7-20/2"
+            hunks << ("every %d %s from the %s to the %s" % [bit[2],
+                                                             bit[2] == 1 ? 'day' : 'days',
+                                                             ordinate(bit[0]),
+                                                             ordinate(bit[1])])
+          end
+        end
+
+        # collapse the "the"s, if all the elements have one
+        if hunks.size > 1 and hunks.none?{|h| h !~ /^the /}
+          hunks = hunks.map{|h| h.gsub(/^the /, '')}
+          hunks[0] = "the #{hunks[0]}"
+        end
+
+        time_lines << "#{conj_and(hunks)} of"
+      end
+
+      #######################################################################
+      # Month
+
+      if bits[3][0][0] == '*'
+        if bits[3][0].size == 1 or bits[3][0][1] == 1
+          time_lines << 'every month'
+        else
+          time_lines << "every #{freq(bits[3][0][1])} month"
+        end
+      else
+        hunks = []
+        bits[3].each do |bit|
+          if bit.size == 1 # "7"
+            hunks << (NUM2MONTH_LONG[bit[0]] || "MONTH_#{bit[0]}??")
+
+          elsif bit.size == 2 # "7-9"
+            hunks << ("from %s to %s" % [NUM2MONTH_LONG[bit[0]] || "MONTH_#{bit[0]}??",
+                                         NUM2MONTH_LONG[bit[1]] || "MONTH_#{bit[1]}??"])
+
+          elsif bit.size == 3 # "7-20/2"
+            hunks << ("every %d %s from %s to %s" % [bit[2],
+                                                     bit[2] == 1 ? 'month' : 'months',
+                                                     NUM2MONTH_LONG[bit[0]] || "MONTH_#{bit[0]}??",
+                                                     NUM2MONTH_LONG[bit[1]] || "MONTH_#{bit[1]}??"])
+          end
+        end
+
+        time_lines << conj_and(hunks)
+      end
+
+      #######################################################################
+      # Weekday
+     #
+    #
+   #
+  #
+  # From man 5 crontab:
+  #   Note: The day of a command's execution can be specified by two fields
+  #   -- day of month, and day of week.  If both fields are restricted
+  #   (ie, aren't *), the command will be run when either field matches the
+  #   current time.  For example, "30 4 1,15 * 5" would cause a command to
+  #   be run at 4:30 am on the 1st and 15th of each month, plus every Friday.
+  #
+  # [But if both fields ARE *, then it just means "every day".
+  #  and if one but not both are *, then ignore the *'d one --
+  #  so   "1 2 3 4 *" means just 2:01, April 3rd
+  #  and  "1 2 * 4 5" means just 2:01, on every Friday in April
+  #  But  "1 2 3 4 5" means 2:01 of every 3rd or Friday in April. ]
+  #
+   #
+    #
+     #
+      # And that's a bit tricky.
+
+      if bits[4][0][0] == '*' and (bits[4][0].size == 1 or bits[4][0][1] == 1)
+        # Most common case: any weekday. Do nothing really.
+        #
+        # Hmm, does "*/1" really many "*" here, given the above note?
+
+        # Tidy things up while we're here:
+        if time_lines[-2] == 'every day of' and
+           time_lines[-1] == 'every month'
+          time_lines[-2] == 'every day'
+          time_lines.pop
+        end
+
+      else
+        # Ugh, there's some restriction on weekdays.
+
+        # Translate the DOW-expression
+        expression = nil
+        hunks = []
+        bits[4].each do |bit|
+          if bit.size == 1
+            hunks << (NUM2DOW_LONG[bit[0]] || "DOW_#{bit[0]}??")
+
+          elsif bit.size == 2
+            if bit[0] == '*'  # It's like */3
+              # hunks << ("every %s day of the week" % freq(bit[1]))
+              # The above was ambiguous: "every third day of the week"
+              # sounds synonymous with just "3"
+              if bit[1] == 2
+                # common and unambiguous case.
+                hunks << "every other day of the week"
+              else
+                # rare cases: N > 2
+                hunks << "every #{bit[1]} days of the week"
+                # sounds clunky, but it's a clunky concept
+              end
+            
+            else
+              # It's like "7-9"
+              hunks << ("%s through %s" % [NUM2DOW_LONG[bit[0]] || "DOW_#{bit[0]}??",
+                                           NUM2DOW_LONG[bit[1]] || "DOW_#{bit[1]}??"])
+            end
+
+          elsif bit.size == 3 # "7-20/2"
+            hunks << ("every %s %s from %s through %s" % [ordinate_soft(bit[2]),
+                                                          'day',
+                                                          NUM2DOW_LONG[bit[0]] || "DOW_#{bit[0]}??",
+                                                          NUM2DOW_LONG[bit[1]] || "DOW_#{bit[1]}??"])
+          end
+        end
+        expression = conj_or(hunks)
+
+        # Now figure out where to put it. . . .
+
+        if time_lines[-2] == 'every day of'
+          # Unrestricted day-of-month, hooray.
+          if time_lines[-1] == 'every month'
+            # change it to "every Thursday", killing the "of every month"
+            time_lines[-2] = "every #{expression}"
+            time_lines[-2].gsub!(%r{every every }, 'every ')
+            time_lines.pop
+          else
+            # change it to "every Thursday in"
+            time_lines[-2] = "every #{expression} in"
+            time_lines[2].gsub!(%r{every every }, 'every ')
+          end
+        else
+          # This is the messy case where there's a DOM and DOW restriction
+
+          time_lines[-2] += " -- or every #{expression} in --"
+          # Yes, dashes look very strange, but then this is a very rare case.
+          time_lines[-2].gsub!(%r{every every }, 'every ')
+        end
+      end
+      time_lines[-1].sub!(/ of$/, '')
+      return time_lines
+    end
+
+    def conj_and(bits)
+      if bits.grep(/every|from/).any?
+        # put in semicolons in case of complex constituency
+        return bits.join('; and ') if bits.size < 2
+        last = bits.pop
+        return "#{bits.join('; ')}; and #{last}"
+      else
+        return bits.join(' and ') if bits.size < 3
+        last = bits.pop
+        return "#{bits.join(', ')}, and #{last}"
+      end
+    end
+
+    def conj_or(bits)
+      if bits.grep(/every|from/).any?
+        # put in semicolons in case of complex constituency
+        return bits.join('; or ') if bits.size < 2
+        last = bits.pop
+        return "#{bits.join('; ')}; or #{last}"
+      else
+        return bits.join(' or ') if bits.size < 3
+        last = bits.pop
+        return "#{bits.join(', ')}, or #{last}"
+      end
+    end
+
+    ORDINATIONS = %w{zeroth first second third fourth fifth sixth seventh eighth ninth tenth}
+
+    def ordsuf(n=nil)
+      return 'th' if not n or n.to_i == 0
+      # 'th' for undef, 0, or anything non-number
+      n = n.abs
+      return 'th' unless n == n.to_i
+      n %= 100
+      return 'th' if n == 11 or n == 12 or n == 13
+      n %= 10
+      return 'st' if n == 1
+      return 'nd' if n == 2
+      return 'rd' if n == 3
+      return 'th'
+    end
+
+    def ordinate(n=0)
+      ORDINATIONS[n] || "#{n}#{ordsuf(n)}"
+    end
+
+    def freq(n=0)
+      # frequentive form. Like ordinal, except that 2 -> 'other'
+      # (as in every other)
+      return 'other' if n == 2
+      ORDINATIONS[n] || "#{n}#{ordsuf(n)}"
+    end
+
+    def ordinate_soft(n=0)
+      "#{n}#{ordsuf(n)}"
+    end
+
+    def give_up(str)
+      raise "Unparseable crontab spec: #{str}"
+    end
+
+
+  end
+
+end

data/lib/cron2english/version.rb

@@ -0,0 +1,3 @@
+module Cron2English
+  VERSION = '0.1.0'
+end

data/lib/cron2english.rb

@@ -0,0 +1,6 @@
+require 'cron2english/all.rb'
+
+module Cron2English
+
+end
+

data/spec/parse_spec.rb

@@ -0,0 +1,36 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Cron2English do
+
+  [
+    ["40 5 * * *", ["5:40am", "every day"]],
+    ["0 5 * * 1", ["5am", "every Monday"]],
+    ["10 8 15 * *", ["8:10:am on", "the 15th of", "every month"]],
+    ["40 5 * * *", ["5:40:am", "every day"]],
+    ["50 6 * * 1", ["6:50:am", "every Monday"]],
+    ["1 2 * apr mOn", ["2:01:am", "every Monday in", "April"]],
+    ["1 2 3 4 7", ["2:01:am on", "the third of -- or every Sunday in --", "April"]],
+    ["1-20/3 * * * *", ["every 3 minutes from 1 to 20 past", "every hour of", "every day"]],
+    ["1,2,3 * * * *", ["1, 2, and 3 minutes past", "every hour of", "every day"]],
+    ["1-9,15-30 * * * *", ["from 1 to 9 minutes; and from 15 to 30 minutes past", "every hour of", "every day"]],
+    ["1-9/3,15-30/4 * * * *", ["every 3 minutes from 1 to 9; and every 4 minutes from 15 to 30 past", "every hour of", "every day"]],
+    ["1 2 3 jan mon", ["2:01:am on", "the third of -- or every Monday in --", "January"]],
+    ["1 2 3 4 mON", ["2:01:am on", "the third of -- or every Monday in --", "April"]],
+    ["1 2 3 jan 5", ["2:01:am on", "the third of -- or every Friday in --", "January"]],
+    ["@reboot", ["reboot"]],
+    ["@yearly", ["yearly"]],
+    ["@annually", ["annually"]],
+    ["@monthly", ["monthly"]],
+    ["@weekly", ["weekly"]],
+    ["@daily", ["daily"]],
+    ["@midnight", ["midnight"]],
+    ["@hourly", ["hourly"]],
+    ["*/3 * * * *", ["every third minute of", "every hour of", "every day"]],
+  ].each do |cronspec, english|
+    it "should parse the cronspec #{cronspec}" do
+      result = Cron2English.parse(cronspec)
+      result.should == english
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'rspec/matchers'
+require 'cron2english'
+
+# Requires supporting files with custom matchers and macros, etc.,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+
+end
+

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: cron2english
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Paul A. Jungwirth
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.4.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.4.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  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: pj@illuminatedcomputing.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- cron2english.gemspec
+- lib/cron2english.rb
+- lib/cron2english/all.rb
+- lib/cron2english/version.rb
+- spec/parse_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/pjungwir/cron2english
+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.0.3
+signing_key: 
+specification_version: 4
+summary: Converts a crontab schedule into English text.
+test_files: []