Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
fork of the acts_as_range Rails plugin for interval AR queries, we wrote this in 2005-7 (BSD-licensed release from our old employer)
Ruby
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib/centerstone
test
CHANGELOG
MIT-LICENSE
README
RUNNING_UNIT_TESTS
Rakefile
init.rb

README

= acts_as_range was originally derived from acts_as_paranoid

= acts_as_range, acts_as_end_dated

Provides date range support methods to ActiveRecord models.

add new options to Foo.find:
    :contain      => t1 .. t2 - return objects whose spans contain this time interval
    :contained_by => t1 .. t2 - return objects whose spans are contained by this time interval
    :overlapping  => t1 .. t2 - return objects whose spans overlap this time interval
    :on           => t1       - return objects whose spans contain this time point
    :before       => t1       - return objects whose spans are completed on or before this time point
    :after        => t1       - return objects whose spans begin on or after this time point 

Note that each of the time interval methods will also take an object of this
class and will use the time interval from that object as search parameters.

The acts_as_range class method takes a hash as a parameters, the values it uses are
  :begin   => The column name that represents the start time of the interval(Defaults :begin_date)
  :end     => The column name that represents the end time of the interval(Defaults :end_date),
  :default => A proc you'd like to constrain the default time used in finds to(ActiveRecord::Base.end_dated_association_date = Proc.new { 1.day.ago }

The acts_as_end_dated class method works similarly to acts_as_range, but it
excludes end dated models from find results.  So if the column that the :end
parameter maps to above has a date in the past, it will not be found by the
default search

We also define an instance method which will scope queries to the date range for that object:

  object.limit_date_range do
    object.friends.enemies  # the find()s of any date_ranged / end_dated classes are limited to :overlaps => object
  end

== Resources

Install

* gem install acts_as_range

Subversion

*  svn://svn.caboo.se/plugins/atmos/acts_as_range

Something went wrong with that request. Please try again.