ice_cube 0.3.1

== About ice_cube
ice_cube is a time recurrence library for Ruby. The API is modeled
after iCalendar repeating events, making it very easy to describe
complex rules and conjunctions in pure Ruby. ice_cube's power lies in
its ability to specify multiple rules - and easily query and expand
them. Most importantly, ice_cube is fast, extremely expressive, and
removes ugly complex date logic from your application.

== Example
Rule.yearly.day(:friday).day_of_month(13).month_of_year(:october)

== Get ice_cube
website: http://seejohnrun.github.com/ice_cube/
github: http://github.com/seejohnrun/ice_cube

gem install ice_cube

Thanks,
John Crepezzi
<john@crepezzi.com>

Hi John.
I like this library, it was just what I wanted.
I am a newbie, i did not understand how to put dynamically the numbers
of the days in the method IceCube::Rule.weekly

i have try this under Ruby on Rails:

Sorry for the delay in response, for some reason I never got a
notification..
Glad you like IceCube so far!

First, the indexes in your code below should be 0-6, not 1-7 (where 0
is sunday)

Also, you're missing your add_recurrence_rule call -- should be:
schedule.add_recurrence_rule IceCube::Rule.weekly.day(*all_days)

This is a great gem, and probably the best starting point I could have
hoped for in order to meet my project's requirements - thanks a
million for putting it together!

I'm dealing with recurring events which can be both stuff like normal
business hours (mon-fri 10-18 & sat 12-18) or more obscure ones
(second sunday of every month 12-19). I've set up a simple model and
associated form which generates rules for the starting times, and it
all works very nicely indeed (I render the schedule to YAML before
storing in DB). But then *doh* it hits me: there is no way to specify
an end time other than the time when the recurring series as a whole
should end. How do I go about giving each recurring event a time
span?

Many thanks,

mikrogroove

Mikro,

Thanks, I'm glad you like it :slight_smile:

Individual rules can take an end date as follows:
rule = IceCube::Rule.weekly.until(Time.local(2010, 10, 6))

Just a note: Until times are inclusive.

Hope this helps!
Thanks,
John Crepezzi <john.crepezzi@gmail.com>

Hi John,

Many thanks for your quick reply! I knew about the .until() option,
but it's not quite what I was after though. From the readme:
"Individual rules may optionally specify an until date, which is a
date that that individual rule is no longer effective". I need the
rule to remain effective for the next occurrence of the event. Think
of it this way: what if I have a weekly meeting every Monday between
9.30am and 10.30am and I do .occurs_at?(Time.now) on a Monday @ 10am?
What I'm after is a way to specify the duration of each occurrence,
but perhaps I'm better off storing this separately? But then how to
deal with a schedule with multiple rules (where each rule might have a
different duration)?

Cheers,

mikrogroove

Yep, since ice_cube is made for occurrences and not durations - you'd
have to store these separately. I'm working with a branch now that
will support end_times for rules, so you could call occurring_at?
(Time.now) on a rule and see if it occurs anywhere in the duration.

I'll have this ready in the next few days
Thanks,
John C

That is awesome news John, I am sure this will become a hugely popular
gem - it's almost a complete calendaring system in a box! I wish my
skills were up to a level where I could offer to help, but I fear I'd
just mess things up for you :s Please know that your efforts are
greatly appreciated!

mikrogroove

@John: Just wanted to check if there's any progress on the end_times
support?

Many thanks,

mikrogroove

@mikrogroove

I need a few days to finish up the testing, and then I'll have this
out for you.
Thanks for your patience!

Also, check out the addition of :duration in the README, if you
haven't already. May help you get started

Thanks,
John Crepezzi

I'm just having a look at this, as I've another need for
recurrence-tracking. Previously I've used RiCal, but liked the look of
IceCube as a little more lightweight.
But I'm getting lots of error in my console with Dates being compared
to Times, or missing "utc_offset" method.... have I missed something
in the requirements for Ruby or Rails for this gem?

I'm on Ruby 1.8.7 and Rails 2.3.2 (for this project).

Can you give some more details?
ice_cube's times are expressed as Time(s) in Ruby.

Maybe just some sample code?

@mikrogroove

ice_cube v0.4 just came out with end time support and a few bug fixes.
I'm adding details for adding end_time to a schedule now

Thanks,
John C