xing-vpim 0.658.1

data/COPYING

@@ -0,0 +1,58 @@
+vPim is copyrighted free software by Sam Roberts <sroberts@uniserve.com>.
+
+You can redistribute it and/or modify it under either the terms of the GPL (see
+the file GPL), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise make them
+       Freely Available, such as by posting said modifications to Usenet or an
+       equivalent medium, or by allowing the author to include your
+       modifications in the software.
+
+       b) use the modified software only within your corporation or
+       organization.
+
+       c) give non-standard binaries non-standard names, with instructions on
+       where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or binary form,
+     provided that you do at least ONE of the following:
+
+       a) distribute the binaries and library files of the software, together
+       with instructions (in the manual page or equivalent) on where to get the
+       original distribution.
+
+       b) accompany the distribution with the machine-readable source of the
+       software.
+
+       c) give non-standard binaries non-standard names, with instructions on
+       where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under these terms.
+
+     For the list of those files and their copying conditions, see the
+     file LEGAL.
+
+  5. The scripts and library files supplied as input to or produced as 
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them, 
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.
+

data/README

@@ -0,0 +1,182 @@
+Author::     Sam Roberts <vieuxtech@gmail.com>
+Copyright::  Copyright (C) 2008 Sam Roberts
+License::    May be distributed under the same terms as Ruby
+Homepage::   http://vpim.rubyforge.org
+Download::   http://rubyforge.org/projects/vpim
+Install::    sudo gem install vpim
+
+vPim provides calendaring, scheduling, and contact support for Ruby through the
+standard iCalendar and vCard data formats for "personal information" exchange.
+
+= Thanks
+
+- http://ZipDX.com: for sponsoring development of FREQ=weekly and BYSETPOS in
+  recurrence rules.
+- http://RubyForge.org: for their generous hosting of this project.
+
+= Installation
+
+There is a vPim package installable using ruby-gems:
+
+  # sudo gem install vpim (may require root privilege)
+
+It is also installable in the standard way. Untar the package, and do:
+
+  $ ruby setup.rb --help
+
+or do:
+
+  $ ruby setup.rb config
+  $ ruby setup.rb setup
+  # ruby setup.rb install (may require root privilege)
+
+= Overview
+
+vCard (RFC 2426) is a format for personal information, see Vpim::Vcard and
+Vpim::Maker::Vcard.
+
+iCalendar (RFC 2445) is a format for calendar related information, see
+Vpim::Icalendar.
+
+vCard and iCalendar support is built on top of an implementation of the MIME
+Content-Type for Directory Information (RFC 2425). The basic RFC 2425 format is
+implemented by  Vpim::DirectoryInfo and Vpim::DirectoryInfo::Field.
+
+The libary is quite useful, but improvements are ongoing.  If you find
+something missing or have suggestions, please contact me. I can't promise
+instantaneous turnaround, but I might be able to suggest another approach, and
+features requested by users of vPim go to the top of the todo list. If you need
+a feature for a commercial project, consider sponsoring development.
+
+= Examples
+
+Here's an example to give a sense for how iCalendars are encoded and decoded:
+
+  require 'vpim/icalendar'
+
+  cal = Vpim::Icalendar.create2
+
+  cal.add_event do |e|
+    e.dtstart       Date.new(2005, 04, 28)
+    e.dtend         Date.new(2005, 04, 29)
+    e.summary       "Monthly meet-the-CEO day"
+    e.description <<'---'
+  Unlike last one, this meeting will change your life because
+  we are going to discuss your likely demotion if your work isn't
+  done soon.
+  ---
+    e.categories    [ 'APPOINTMENT' ]
+    e.categories do |c| c.push 'EDUCATION' end
+    e.url           'http://www.example.com'
+    e.sequence      0
+    e.access_class  "PRIVATE"
+    e.transparency  'OPAQUE'
+
+    now = Time.now
+    e.created       now
+    e.lastmod       now
+
+
+    e.organizer do |o|
+      o.cn = "Example Organizer, Mr."
+      o.uri = "mailto:organizer@example.com"
+    end
+
+    attendee = Vpim::Icalendar::Address.create("mailto:attendee@example.com")
+    attendee.rsvp = true
+    e.add_attendee attendee
+  end
+
+  icsfile = cal.encode
+
+  puts '--- Encode:'
+
+  puts icsfile
+
+  puts '--- Decode:'
+
+  cal = Vpim::Icalendar.decode(icsfile).first
+
+  cal.components do |e|
+    puts e.summary
+    puts e.description
+    puts e.dtstart.to_s
+    puts e.dtend.to_s
+  end
+
+This produces:
+
+  --- Encode:
+  BEGIN:VCALENDAR
+  VERSION:2.0
+  PRODID:-//Ensemble Independent//vPim 0.357//EN
+  CALSCALE:Gregorian
+  BEGIN:VEVENT
+  DTSTART;VALUE=DATE:20050428
+  DTEND;VALUE=DATE:20050429
+  SUMMARY:Monthly meet-the-CEO day
+  DESCRIPTION:Unlike last one, this meeting will change your life because\nwe
+    are going to discuss your likely demotion if your work isn't\ndone soon.\n
+  CATEGORIES:APPOINTMENT,EDUCATION
+  URL:http://www.example.com
+  SEQUENCE:0
+  CLASS:PRIVATE
+  CREATED:20060402T231755
+  LAST-MODIFIED:20060402T231755
+  ORGANIZER;CN="Example Organizer, Mr.":mailto:organizer@example.com
+  ATTENDEE;RSVP=true:mailto:attendee@example.com
+  END:VEVENT
+  END:VCALENDAR
+  --- Decode:
+  Monthly meet-the-CEO day
+  Unlike last one, this meeting will change your life because
+  we are going to discuss your likely demotion if your work isn't
+  done soon.
+  Thu Apr 28 00:00:00 UTC 2005
+  Fri Apr 29 00:00:00 UTC 2005
+
+
+More examples of using vPim are provided in samples/.
+
+vCard examples are:
+- link:ex_mkvcard.txt: example of creating a vCard
+- link:ex_cpvcard.txt: example of copying and them modifying a vCard
+- link:ex_mkv21vcard.txt: example of creating version 2.1 vCard
+- link:mutt-aliases-to-vcf.txt: convert a mutt aliases file to vCards
+- link:ex_get_vcard_photo.txt: pull photo data from a vCard
+- link:ab-query.txt: query the OS X Address Book to find vCards
+- link:vcf-to-mutt.txt: query vCards for matches, output in formats useful
+  with Mutt (see link:README.mutt for details)
+- link:tabbed-file-to-vcf.txt: convert a tab-delimited file to vCards, a
+  (small but) complete application contributed by Dane G. Avilla, thanks!
+- link:vcf-to-ics.txt: example of how to create calendars of birthdays from vCards
+- link:vcf-dump.txt: utility for dumping contents of .vcf files
+
+iCalendar examples are:
+- link:ics-to-rss.txt: prints todos as RSS, or starts a WEBrick servlet
+  that publishes todos as a RSS feed. Thanks to Dave Thomas for this idea,
+  from http://pragprog.com/pragdave/Tech/Blog/ToDos.rdoc.
+- link:cmd-itip.txt: prints emailed iCalendar invitations in human-readable
+  form, and see link:README.mutt for instruction on mutt integration. I get
+  a lot of meeting invitations from Lotus Notes/Domino users at work, and
+  this is pretty useful in figuring out where and when I am supposed to be.
+- link:reminder.txt: prints upcoming events and todos, by default from
+  Apple's iCal calendars
+- link:rrule.txt: utility for printing recurrence rules
+- link:ics-dump.txt: utility for dumping contents of .ics files
+
+= Project Information
+
+vPim can be downloaded from the Ruby Forge project page:
+
+- http://rubyforge.org/projects/vpim
+
+or installed as a gem:
+
+- sudo gem install vpim
+
+For notifications about new releases, or to ask questions about vPim, please
+subscribe to "vpim-talk":
+
+- http://rubyforge.org/mailman/listinfo/vpim-talk
+

data/bin/reminder

@@ -0,0 +1,203 @@
+#!/usr/bin/env ruby
+
+$-w = true
+
+require 'ubygems' rescue "ignored"
+
+require 'getoptlong'
+require 'pp'
+require 'plist'
+
+require 'vpim/repo'
+
+$stdout.sync = true
+$stderr.sync = true
+
+HELP =<<EOF
+Usage: #{$0} [where]
+
+Shows events and todos occuring soon.
+
+By default, the Apple iCal v3 calendars are used, but if a location where
+.ics files is specified, any calendars found there will be used.
+
+Options
+  -h,--help        Print this helpful message.
+  -n,--days   N    How many of the next days are considered to be "soon", default
+                     is seven.
+  -v,--verbose     Print more information about upcoming events.
+EOF
+
+opt_debug = nil
+opt_verbose = nil
+opt_days  = 7
+
+opts = GetoptLong.new(
+  [ "--help",    "-h",   GetoptLong::NO_ARGUMENT ],
+  [ "--days",    "-n",   GetoptLong::REQUIRED_ARGUMENT ],
+  [ "--verbose", "-v",   GetoptLong::NO_ARGUMENT ],
+  [ "--debug",   "-d",   GetoptLong::NO_ARGUMENT ]
+)
+
+opts.each do |opt, arg|
+  case opt
+    when "--help" then
+      puts HELP
+      exit 0
+
+    when "--days" then
+      opt_days = arg.to_i
+
+    when "--verbose" then
+      opt_verbose = true
+
+    when "--debug" then
+      opt_verbose = true
+      opt_debug = true
+  end
+end
+
+calendars = []
+
+if ARGV.length > 0
+  Vpim::Repo::Directory.each(ARGV.first) do |cal|
+    calendars << cal
+  end
+else
+  Vpim::Repo::Ical3.each() do |cal|
+    calendars << cal
+  end
+end
+
+if opt_debug
+  pp ARGV
+  pp calendars
+end
+
+SECSPERDAY = (24 * 60 * 60)
+
+t0 = Time.new.to_a
+t0[0] = t0[1] = t0[2] = 0 # sec,min,hour = 0
+t0 = Time.local(*t0)
+t1 = t0 + opt_days * SECSPERDAY
+
+if opt_debug
+  puts "to: #{t0}"
+  puts "t1: #{t1}"
+end
+
+if opt_verbose
+  puts "Events in the next #{opt_days} days:"
+end
+
+# Collect all events, then all todos.
+all_events = []
+all_todos  = []
+
+calendars.each do |cal|
+  if opt_debug; puts cal.name; end
+
+  begin
+    cal.events.each do |e|
+      begin
+        if opt_debug; pp e; end
+        if e.occurs_in?(t0, t1)
+          if e.summary
+            all_events.push(e)
+          end
+        end
+      rescue
+        $stderr.puts "error in #{cal.name} (\"#{e.summary}\"): #{$!.to_s}"
+      end
+    end
+
+    all_todos.concat(cal.todos)
+  end
+end
+
+puts
+
+def start_of_first_occurrence(t0, t1, e)
+  e.occurrences(t1) do |t|
+    # An event might start before t0, but end after it..., in which case
+    # we are still interested.
+    if (t + (e.duration || 0)) >= t0
+      return t
+    end
+  end
+  nil
+end
+
+all_events.sort! do |lhs, rhs|
+  start_of_first_occurrence(t0, t1, lhs) <=> start_of_first_occurrence(t0, t1, rhs)
+end
+
+all_events.each do |e|
+  puts "#{e.summary}:"
+
+  if opt_verbose
+    if e.description;   puts "  description=#{e.description}"; end
+    if e.comments;      puts "  comment=#{e.comments.first}"; end
+    if e.location;      puts "  location=#{e.location}"; end
+    if e.status;        puts "  status=#{e.status}"; end
+    if e.dtstart;       puts "  dtstart=#{e.dtstart}"; end
+    if e.duration;      puts "  duration=#{Vpim::Duration.new(e.duration).to_s}"; end
+  end
+
+  i = 1
+  e.occurrences.each_until(t1).each do |t|
+    # An event might start before t0, but end after it..., in which case
+    # we are still interested.
+    dstr = ''
+    if e.duration
+      d = e.duration
+      dstr = " for #{Vpim::Duration.new(e.duration).to_s}"
+    end
+
+    if (t + (e.duration || 0)) >= t0
+      puts "  ##{i} on #{t}#{dstr}"
+      i += 1
+    end
+  end
+end
+
+=begin
+def fix_priority(vtodo)
+  p = vtodo.priority
+  if !p
+    p = 10
+
+end
+=end
+
+all_todos.sort! do |x,y|
+  x = x.priority
+  y = y.priority
+
+  # 0 means no priority, put these last, not first
+  x = 10 if x == 0
+  y = 10 if y == 0
+
+  x <=> y
+end
+
+priorities = [
+  'no importance',
+  'very important',
+  'very important',
+  'very important',
+  'important',
+  'important',
+  'important',
+  'not important',
+  'not important',
+  'not important'
+]
+
+all_todos.each do |e|
+  status = e.status || 'Todo'
+  if status != 'COMPLETED'
+    puts "#{status.capitalize}: #{e.summary}" #  (#{priorities[e.priority]})"
+  end
+end
+

data/bin/rrule

@@ -0,0 +1,71 @@
+#!/usr/bin/env ruby
+
+$-w = true
+$:.unshift File.dirname($0) + "/../lib"
+
+require 'vpim/rrule'
+require 'getoptlong'
+require 'parsedate'
+
+HELP =<<EOF
+Usage: #{$0} [options] rrule
+
+Options
+  -h,--help      Print this helpful message.
+  -t,--start     Start time for recurrence rule, defaults to current time.
+
+Examples:
+
+FREQ=DAILY;COUNT=10
+FREQ=DAILY;UNTIL=19971224T000000Z
+FREQ=DAILY;INTERVAL=2
+FREQ=DAILY;INTERVAL=10;COUNT=5
+
+Demonstrate DST time change:
+
+#{$0}  --start '2004-04-03 02:00' 'FREQ=daily;count=3'
+#{$0}  --start '2004-10-30 02:00' 'FREQ=daily;count=3'
+
+Note: In the US DST starts at 2AM, on the first Sunday of April, and reverts
+at 2AM on the last Sunday of October.
+
+EOF
+
+dtstart = Time.new
+
+opts = GetoptLong.new(
+  [ "--help",    "-h",   GetoptLong::NO_ARGUMENT ],
+  [ "--start",   "-t",   GetoptLong::REQUIRED_ARGUMENT]
+)
+
+opts.each do |opt, arg|
+  case opt
+    when "--help" then
+      puts HELP
+      exit 0
+
+    when "--start" then
+      date = ParseDate.parsedate(arg)
+      date.pop
+      date.pop
+      dtstart = Time.local(*date)
+  end
+end
+
+if ARGV.length < 1
+  puts "no rrule specified, try -h!\n"
+  exit 1
+end
+
+puts "Start: #{Vpim.encode_date_time(dtstart)}"
+
+ARGV.each do |rule|
+  rrule = Vpim::Rrule.new(dtstart, rule)
+
+  puts "Rule: #{rule}"
+
+  rrule.each_with_index do |t, count|
+    puts format("count=%3d %s", count, t.to_s)
+  end
+end
+