epoch 0.0.1

data/History.txt

@@ -0,0 +1,4 @@
+== 0.0.1 / 2008-12-10
+
+* 1 Epoch is born
+  * Uploaded initial setup to RubyForge

data/Manifest.txt

@@ -0,0 +1,10 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/epoch
+lib/epoch.rb
+lib/epoch/pattern.rb
+spec/epoch_spec.rb
+spec/spec_helper.rb
+test/test_epoch.rb

data/README.txt

@@ -0,0 +1,51 @@
+epoch
+    by Dan Ryan
+    http://epoch.rubyforge.org
+
+== DESCRIPTION:
+
+* Ruby library used to create patterns of time (temporal expressions)
+
+== FEATURES/PROBLEMS:
+
+* Features:  Easily grab dates matching a pattern of time (temporal expression)
+* Problems: Not entirely functional yet :)
+
+== SYNOPSIS:
+* Find all dates matching start_at date in the year.  
+  Epoch::Pattern("monthly", Date.today.beginning_of_year, Date.today.end_of_year) 
+	#=> Epoch::Pattern("monthly", "2008-01-01", "2008-12-31") 
+	
+
+== REQUIREMENTS:
+
+* Requires ActiveSupport for its Date and Time additions (may not be required in the near future)
+
+== INSTALL:
+
+* sudo gem install epoch
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 Dan Ryan 
+
+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/Rakefile

@@ -0,0 +1,27 @@
+# Look in the tasks/setup.rb file for the various options that can be
+# configured in this Rakefile. The .rake files in the tasks directory
+# are where the options are used.
+
+begin
+  require 'bones'
+  Bones.setup
+rescue LoadError
+  load 'tasks/setup.rb'
+end
+
+ensure_in_path 'lib'
+require 'epoch'
+
+task :default => 'spec:run'
+
+PROJ.name = 'epoch'
+PROJ.authors = 'Dan Ryan'
+PROJ.email = 'scriptfu@gmail.com'
+PROJ.url = 'http://epoch.rubyforge.org'
+PROJ.version = Epoch::VERSION
+PROJ.rubyforge.name = 'epoch'
+PROJ.exclude = %w(.git pkg)
+
+PROJ.spec.opts << '--color'
+
+# EOF

data/bin/epoch

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib epoch]))
+
+# Put your code here
+
+# EOF

data/lib/epoch.rb

@@ -0,0 +1,151 @@
+
+module Epoch
+
+  # :stopdoc:
+  VERSION = '0.0.1'
+  LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
+  PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
+  # :startdoc:
+
+  # Returns the version string for the library.
+  #
+  def self.version
+    VERSION
+  end
+
+  # Returns the library path for the module. If any arguments are given,
+  # they will be joined to the end of the libray path using
+  # <tt>File.join</tt>.
+  #
+  def self.libpath( *args )
+    args.empty? ? LIBPATH : ::File.join(LIBPATH, args.flatten)
+  end
+
+  # Returns the lpath for the module. If any arguments are given,
+  # they will be joined to the end of the path using
+  # <tt>File.join</tt>.
+  #
+  def self.path( *args )
+    args.empty? ? PATH : ::File.join(PATH, args.flatten)
+  end
+
+  # Utility method used to rquire all files ending in .rb that lie in the
+  # directory below this file that has the same name as the filename passed
+  # in. Optionally, a specific _directory_ name can be passed in such that
+  # the _filename_ does not have to be equivalent to the directory.
+  #
+  def self.require_all_libs_relative_to( fname, dir = nil )
+    dir ||= ::File.basename(fname, '.*')
+    search_me = ::File.expand_path(
+        ::File.join(::File.dirname(fname), dir, '*', '*.rb'))
+
+    Dir.glob(search_me).sort.each {|rb| require rb}
+  end
+
+  
+    class << self
+
+      def day_name(number)
+        Date::DAYNAMES[number]
+      end
+
+      def month_name(number)
+        Date::MONTHNAMES[number]
+      end
+
+      def format_time(date)
+        date.strftime('%I:%M%p')
+      end
+
+      def format_date(date)
+        date.ctime
+      end
+
+      def ordinalize(number)
+        if (number.to_i == -1)
+          'last'
+        elsif (number.to_i == -2)
+          'second to last'
+        elsif (11..13).include?(number.to_i % 100)
+          "#{number}th"
+        else
+          case number.to_i % 10
+          when 1: "#{number}st"
+          when 2: "#{number}nd"
+          when 3: "#{number}rd"
+          else    "#{number}th"
+          end
+        end
+      end
+    end
+
+    #DAYNAMES Constants
+    Sunday = Date::DAYNAMES[0]
+    Monday = Date::DAYNAMES[1]
+    Tuesday = Date::DAYNAMES[2]
+    Wednesday = Date::DAYNAMES[3]
+    Thursday = Date::DAYNAMES[4]
+    Friday = Date::DAYNAMES[5]
+    Saturday = Date::DAYNAMES[6]
+    #ABBR_DAYNAMES Constants
+    Sun = Date::ABBR_DAYNAMES[0]
+    Mon = Date::ABBR_DAYNAMES[1]
+    Tue = Date::ABBR_DAYNAMES[2]
+    Wed = Date::ABBR_DAYNAMES[3]
+    Thu = Date::ABBR_DAYNAMES[4]
+    Fri = Date::ABBR_DAYNAMES[5]
+    Sat = Date::ABBR_DAYNAMES[6]
+    # MONTHNAMES Constants
+    January = Date::MONTHNAMES[0]
+    February = Date::MONTHNAMES[1]
+    March = Date::MONTHNAMES[2]
+    April = Date::MONTHNAMES[3]
+    May = Date::MONTHNAMES[4]
+    June = Date::MONTHNAMES[5]
+    July = Date::MONTHNAMES[6]
+    August = Date::MONTHNAMES[7]
+    September = Date::MONTHNAMES[8]
+    October = Date::MONTHNAMES[9]
+    November = Date::MONTHNAMES[10]
+    December = Date::MONTHNAMES[11]
+  end
+
+  class Numeric
+    def microseconds
+      Float(self * (10 ** -6)) 
+    end
+    def milliseconds()
+      Float(self * (10 ** -3)) 
+    end
+    def seconds
+      self 
+    end
+    def minutes
+      60 * seconds 
+    end
+    def hours
+      60 * minutes
+    end
+    def days
+      24 * hours 
+    end
+    def weeks
+      7 * days
+    end
+    def months
+      30 * days
+    end
+    def years
+      365 * days
+    end
+    def decades
+      10 * years
+    end
+    %w{microseconds milliseconds seconds minutes hours days weeks months years decades}.each do |m|
+      alias_method m.chop, m
+    end
+end  # module Epoch
+
+Epoch.require_all_libs_relative_to(__FILE__)
+
+# EOF

data/lib/epoch/pattern.rb

@@ -0,0 +1,53 @@
+module Epoch
+  class Pattern
+    VALID_FREQUENCY = %w{ daily weekly monthly quarterly semesterly yearly}
+    
+    def initialize(frequency, start_at, end_at, interval=1)
+      raise TypeError, 'start_at should be a Date' unless start_at.kind_of?(Date)
+      raise TypeError, 'end_at should be a Date' unless end_at.kind_of?(Date)
+      unless VALID_FREQUENCY.include?(frequency)
+        raise ArgumentError, "frequency should be 'daily', 'weekly', 'monthly', or 'yearly'" 
+      end
+      @start_at = start_at
+      @end_at = end_at
+      @frequency = frequency
+      @interval = interval
+      @date_range = start_at..end_at
+    end
+    def start_at
+      @start_at
+    end
+
+    def end_at
+      @end_at
+    end
+
+    def date_range
+      @date_range
+    end
+
+    def dates
+      @dates = []
+      puts "Find dates between #{@start_at} and #{@end_at}"
+      @date_range.select do |date| 
+        case @frequency
+        when "daily"
+          date == date
+          @dates.push date
+          # puts date
+        when "weekly"
+          date.wday == @start_at.wday
+          #@dates.push date
+          # puts date
+        when "monthly"
+          date.mday == @start_at.mday
+          @dates << date
+          # puts date
+        when "yearly"
+          puts "yearly"
+        end
+      end
+      @dates
+    end
+  end
+end

data/spec/epoch_spec.rb

@@ -0,0 +1,7 @@
+
+require File.join(File.dirname(__FILE__), %w[spec_helper])
+
+describe Epoch do
+end
+
+# EOF

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib epoch]))
+
+Spec::Runner.configure do |config|
+  # == Mock Framework
+  #
+  # RSpec uses it's own mocking framework by default. If you prefer to
+  # use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+end
+
+# EOF

data/tasks/ann.rake

@@ -0,0 +1,80 @@
+
+begin
+  require 'bones/smtp_tls'
+rescue LoadError
+  require 'net/smtp'
+end
+require 'time'
+
+namespace :ann do
+
+  # A prerequisites task that all other tasks depend upon
+  task :prereqs
+
+  file PROJ.ann.file do
+    ann = PROJ.ann
+    puts "Generating #{ann.file}"
+    File.open(ann.file,'w') do |fd|
+      fd.puts("#{PROJ.name} version #{PROJ.version}")
+      fd.puts("    by #{Array(PROJ.authors).first}") if PROJ.authors
+      fd.puts("    #{PROJ.url}") if PROJ.url.valid?
+      fd.puts("    (the \"#{PROJ.release_name}\" release)") if PROJ.release_name
+      fd.puts
+      fd.puts("== DESCRIPTION")
+      fd.puts
+      fd.puts(PROJ.description)
+      fd.puts
+      fd.puts(PROJ.changes.sub(%r/^.*$/, '== CHANGES'))
+      fd.puts
+      ann.paragraphs.each do |p|
+        fd.puts "== #{p.upcase}"
+        fd.puts
+        fd.puts paragraphs_of(PROJ.readme_file, p).join("\n\n")
+        fd.puts
+      end
+      fd.puts ann.text if ann.text
+    end
+  end
+
+  desc "Create an announcement file"
+  task :announcement => ['ann:prereqs', PROJ.ann.file]
+
+  desc "Send an email announcement"
+  task :email => ['ann:prereqs', PROJ.ann.file] do
+    ann = PROJ.ann
+    from = ann.email[:from] || PROJ.email
+    to   = Array(ann.email[:to])
+
+    ### build a mail header for RFC 822
+    rfc822msg =  "From: #{from}\n"
+    rfc822msg << "To: #{to.join(',')}\n"
+    rfc822msg << "Subject: [ANN] #{PROJ.name} #{PROJ.version}"
+    rfc822msg << " (#{PROJ.release_name})" if PROJ.release_name
+    rfc822msg << "\n"
+    rfc822msg << "Date: #{Time.new.rfc822}\n"
+    rfc822msg << "Message-Id: "
+    rfc822msg << "<#{"%.8f" % Time.now.to_f}@#{ann.email[:domain]}>\n\n"
+    rfc822msg << File.read(ann.file)
+
+    params = [:server, :port, :domain, :acct, :passwd, :authtype].map do |key|
+      ann.email[key]
+    end
+
+    params[3] = PROJ.email if params[3].nil?
+
+    if params[4].nil?
+      STDOUT.write "Please enter your e-mail password (#{params[3]}): "
+      params[4] = STDIN.gets.chomp
+    end
+
+    ### send email
+    Net::SMTP.start(*params) {|smtp| smtp.sendmail(rfc822msg, from, to)}
+  end
+end  # namespace :ann
+
+desc 'Alias to ann:announcement'
+task :ann => 'ann:announcement'
+
+CLOBBER << PROJ.ann.file
+
+# EOF

data/tasks/bones.rake

@@ -0,0 +1,20 @@
+
+if HAVE_BONES
+
+namespace :bones do
+
+  desc 'Show the PROJ open struct'
+  task :debug do |t|
+    atr = if t.application.top_level_tasks.length == 2
+      t.application.top_level_tasks.pop
+    end
+
+    if atr then Bones::Debug.show_attr(PROJ, atr)
+    else Bones::Debug.show PROJ end
+  end
+
+end  # namespace :bones
+
+end  # HAVE_BONES
+
+# EOF

data/tasks/gem.rake

@@ -0,0 +1,192 @@
+
+require 'find'
+require 'rake/packagetask'
+require 'rubygems/user_interaction'
+require 'rubygems/builder'
+
+module Bones
+class GemPackageTask < Rake::PackageTask
+  # Ruby GEM spec containing the metadata for this package.  The
+  # name, version and package_files are automatically determined
+  # from the GEM spec and don't need to be explicitly provided.
+  #
+  attr_accessor :gem_spec
+
+  # Tasks from the Bones gem directory
+  attr_reader :bones_files
+
+  # Create a GEM Package task library.  Automatically define the gem
+  # if a block is given.  If no block is supplied, then +define+
+  # needs to be called to define the task.
+  #
+  def initialize(gem_spec)
+    init(gem_spec)
+    yield self if block_given?
+    define if block_given?
+  end
+
+  # Initialization tasks without the "yield self" or define
+  # operations.
+  #
+  def init(gem)
+    super(gem.name, gem.version)
+    @gem_spec = gem
+    @package_files += gem_spec.files if gem_spec.files
+    @bones_files = []
+
+    local_setup = File.join(Dir.pwd, %w[tasks setup.rb])
+    if !test(?e, local_setup)
+      Dir.glob(::Bones.path(%w[lib bones tasks *])).each {|fn| bones_files << fn}
+      gem_spec.files = (gem_spec.files +
+          bones_files.map {|fn| File.join('tasks', File.basename(fn))}).sort
+    end
+  end
+
+  # Create the Rake tasks and actions specified by this
+  # GemPackageTask.  (+define+ is automatically called if a block is
+  # given to +new+).
+  #
+  def define
+    super
+    task :prereqs
+    task :package => ['gem:prereqs', "#{package_dir_path}/#{gem_file}"]
+    file "#{package_dir_path}/#{gem_file}" => [package_dir_path] + package_files + bones_files do
+      when_writing("Creating GEM") {
+        chdir(package_dir_path) do
+          Gem::Builder.new(gem_spec).build
+          verbose(true) {
+            mv gem_file, "../#{gem_file}"
+          }
+        end
+      }
+    end
+
+    file package_dir_path => bones_files do
+      mkdir_p package_dir rescue nil
+      bones_files.each do |fn|
+        base_fn = File.join('tasks', File.basename(fn))
+        f = File.join(package_dir_path, base_fn)
+        fdir = File.dirname(f)
+        mkdir_p(fdir) if !File.exist?(fdir)
+        if File.directory?(fn)
+          mkdir_p(f)
+        else
+          raise "file name conflict for '#{base_fn}' (conflicts with '#{fn}')" if test(?e, f)
+          safe_ln(fn, f)
+        end
+      end
+    end
+  end
+  
+  def gem_file
+    if @gem_spec.platform == Gem::Platform::RUBY
+      "#{package_name}.gem"
+    else
+      "#{package_name}-#{@gem_spec.platform}.gem"
+    end
+  end
+end  # class GemPackageTask
+end  # module Bones
+
+namespace :gem do
+
+  PROJ.gem._spec = Gem::Specification.new do |s|
+    s.name = PROJ.name
+    s.version = PROJ.version
+    s.summary = PROJ.summary
+    s.authors = Array(PROJ.authors)
+    s.email = PROJ.email
+    s.homepage = Array(PROJ.url).first
+    s.rubyforge_project = PROJ.rubyforge.name
+
+    s.description = PROJ.description
+
+    PROJ.gem.dependencies.each do |dep|
+      s.add_dependency(*dep)
+    end
+
+    PROJ.gem.development_dependencies.each do |dep|
+      s.add_development_dependency(*dep)
+    end
+
+    s.files = PROJ.gem.files
+    s.executables = PROJ.gem.executables.map {|fn| File.basename(fn)}
+    s.extensions = PROJ.gem.files.grep %r/extconf\.rb$/
+
+    s.bindir = 'bin'
+    dirs = Dir["{#{PROJ.libs.join(',')}}"]
+    s.require_paths = dirs unless dirs.empty?
+
+    incl = Regexp.new(PROJ.rdoc.include.join('|'))
+    excl = PROJ.rdoc.exclude.dup.concat %w[\.rb$ ^(\.\/|\/)?ext]
+    excl = Regexp.new(excl.join('|'))
+    rdoc_files = PROJ.gem.files.find_all do |fn|
+                   case fn
+                   when excl; false
+                   when incl; true
+                   else false end
+                 end
+    s.rdoc_options = PROJ.rdoc.opts + ['--main', PROJ.rdoc.main]
+    s.extra_rdoc_files = rdoc_files
+    s.has_rdoc = true
+
+    if test ?f, PROJ.test.file
+      s.test_file = PROJ.test.file
+    else
+      s.test_files = PROJ.test.files.to_a
+    end
+
+    # Do any extra stuff the user wants
+    PROJ.gem.extras.each do |msg, val|
+      case val
+      when Proc
+        val.call(s.send(msg))
+      else
+        s.send "#{msg}=", val
+      end
+    end
+  end  # Gem::Specification.new
+
+  Bones::GemPackageTask.new(PROJ.gem._spec) do |pkg|
+    pkg.need_tar = PROJ.gem.need_tar
+    pkg.need_zip = PROJ.gem.need_zip
+  end
+
+  desc 'Show information about the gem'
+  task :debug => 'gem:prereqs' do
+    puts PROJ.gem._spec.to_ruby
+  end
+
+  desc 'Install the gem'
+  task :install => [:clobber, 'gem:package'] do
+    sh "#{SUDO} #{GEM} install --local pkg/#{PROJ.gem._spec.full_name}"
+
+    # use this version of the command for rubygems > 1.0.0
+    #sh "#{SUDO} #{GEM} install --no-update-sources pkg/#{PROJ.gem._spec.full_name}"
+  end
+
+  desc 'Uninstall the gem'
+  task :uninstall do
+    installed_list = Gem.source_index.find_name(PROJ.name)
+    if installed_list and installed_list.collect { |s| s.version.to_s}.include?(PROJ.version) then
+      sh "#{SUDO} #{GEM} uninstall --version '#{PROJ.version}' --ignore-dependencies --executables #{PROJ.name}"
+    end
+  end
+
+  desc 'Reinstall the gem'
+  task :reinstall => [:uninstall, :install]
+
+  desc 'Cleanup the gem'
+  task :cleanup do
+    sh "#{SUDO} #{GEM} cleanup #{PROJ.gem._spec.name}"
+  end
+end  # namespace :gem
+
+
+desc 'Alias to gem:package'
+task :gem => 'gem:package'
+
+task :clobber => 'gem:clobber_package'
+remove_desc_for_task 'gem:clobber_package'
+
+# EOF