Skip to content

conanite/reservation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Reservation

A gem for managing reservations. Provides the notion of "Event", which is basically an interval in time, and a "Reservation", which is a many-to-many association model between Event and your objects.

There is no privileged event "owner", all associations are considered equivalent.

This gem uses ActiveRecord to store events and reservations

Installation

Add this line to your application's Gemfile:

gem 'reservation'

And then execute:

$ bundle

Or install it yourself as:

$ gem install reservation

Usage

First of all migrate your schema so you have the necessary tables -

rails g reservation:migration

Objects associated with an event are called "subjects"; each event has many subjects, via an association model called Reservation::Reservation. The simplest way to create a bunch of events is to use Event#create_weekly. This will create a set of events, with the given subjects, within the given constraints, repeating weekly.

subjects = [ { "role" => "owner", "subject" => matt, "status" => "confirmed" },
             { "role" => "helpr", "subject" => bill, "status" => "tentative" },
             { "role" => "place", "subject" => here, "status" => "tentative" }
           ]

patterns = [ { "day" => "wed", "start" => "0930", "finish" => "1030"},
             { "day" => "wed", "start" => "18",   "finish" => "20"  },
             { "day" => "tue", "start" => "7",    "finish" => "830" } ]

Reservation::Event.create_weekly "the_title", "2013-09-03", "2013-10-13", subjects, pattern

A 'pattern' may contain an 'nth_of_month' key, in which case the gem will generate events only on days which are the given nth day of the month (for example, "2nd wednesday of each month", "last saturday of the month").

You can use Reservation::Event#build_weekly instead in order to instantiate the object graph without persisting it.

History

v0.0.5 Add "nth day of month" feature

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

license

MIT License

About

basic reservations using active_record

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages