= sublab calendar stuff

Code and tools related to working with the sublab calendar. Currently
'working' means reading it.

== Getting started

You'll need ruby and ruby bundler (http://bundler.io).

  # install dependencies
  bundle install

  # start a REPL
  pry -Ilib -r sublab_calendar

  cal = SublabCalendar::Calendar.load

  cal.events            # all events
  cal.future_events     # future events
  cal.past_events       # past events

  # get all events & occurrences this month

  list = cal.everything_this_month
  # => SublabCalendar::EventList

  puts list.to_json
  # => 
  #  {"summary":"lounge","start":"2014-09-11 19:00:00 UTC","end":"2014-09-11 21:00:00 UTC"}
  #  {"summary":"lounge","start":"2014-09-25 19:00:00 UTC","end":"2014-09-25 21:00:00 UTC"}
  #  {"summary":"September Event","start":"2014-09-26 18:00:00 +0200","end":"2014-09-26 21:00:00 +0200"}


== Vagrant

There is a Vagrant (vagrantup.com) VM defined for playing around with a
radicale CalDAV server. 

  # start the VM
  vagrant up

  # stop the VM
  vagrant halt

  # help!
  vagrant -h
  vagrant <command> -h

The VM being imported and provisioned on first run, this may take a
little while depending on your Internet connection.

The radicale server will be available on your host machine on http://localhost:5232.

See http://radicale.org/ for more docs.

Note: this is a debian wheezy (7.4), which ships an old version of
radicale. Upgrading to a more current version may be necessary for
proper client and feature support.