vpim 0.16 → 0.17

data/lib/vpim/vpim.rb

@@ -1,7 +1,5 @@
 =begin
-  $Id: vpim.rb,v 1.20 2005/02/04 21:31:12 sam Exp $
-
-  Copyright (C) 2005 Sam Roberts
+  Copyright (C) 2006 Sam Roberts
 
   This library is free software; you can redistribute it and/or modify it
   under the same terms as the ruby language itself, see the file COPYING for
@@ -14,31 +12,28 @@
 # Author::     Sam Roberts <sroberts@uniserve.com>
 # Copyright::  Copyright (C) 2006 Sam Roberts
 # License::    May be distributed under the same terms as Ruby
-# Version::    0.16
+# Version::    0.17
 # Homepage::   http://vpim.rubyforge.org
 #
-# An implementation of the MIME Content-Type for Directory Information (RFC
-# 2425), and profiles of this format. The basic RFC 2425 format is implemented
-# by the DirectoryInfo class.
-#
-# Currently the only IETF-defined profile is vCard (RFC 2426), implemented by
-# the Vcard class.
-#
-# iCalendar (RFC 2445) was not specified as a profile of RFC 2425, could have
-# been, and is implemented by the Icalendar class.
+# vCard (RFC 2426) is a format for personal information, see Vpim::Vcard and
+# Vpim::Maker::Vcard.
 #
-# Both of these "v-formats" are for personal information management, thus the
-# name "vPim".
+# iCalendar (RFC 2445) is a format for calendar related information, see
+# Vpim::Icalendar.
 #
-# This is my first Ruby library, and I would love to have feedback on
-# useability. In particular, if anybody using this library could send me
-# any code showing how they call vPim, that would be very useful to me. It
-# doesn't have to be complete, I would just like to see how the APIs are
-# being called, to give me ideas for how to improve them.
+# iCalendar was called vCalendar pre-IETF standaradization, and since both of
+# these "v-formats" are commonly used personal information management, the
+# library is called "vpim".
 #
-# Particularly, I'm interested in examples of encoding.
+# 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.
 #
-# Sam Roberts <sroberts@uniserve.com>
+# The libary is mature to the point of useability, but there is always more
+# that could be done. I have a very long todo list, so if you think something
+# is missing, or have API 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 are high priority for me.
 #
 # = Project Information
 #
@@ -46,8 +41,8 @@
 #
 # - http://rubyforge.org/projects/vpim
 #
-# If you are interested in notifications about new releases, or
-# asking questions about vPim, please subscribe to "vpim-talk":
+# For notifications about new releases, or asking questions about vPim, please
+# subscribe to "vpim-talk":
 #
 # - http://rubyforge.org/mailman/listinfo/vpim-talk
 #
@@ -56,16 +51,18 @@
 # Sample utilities are provided as examples of using vPim in samples/.
 # 
 # vCard examples are:
-# - link:ex_mkvcard.txt: an example of making a vCard
+# - 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:vcard-dump.txt: dump all the fields in a vCard
 # - 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-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
@@ -78,9 +75,9 @@
 # - link:reminder.txt: prints upcoming events and todos, by default from
 #   Apple's iCal calendars
 # - link:rrule.txt: utility for printing recurrence rules
-# - link:ical-dump.txt: utility for dumping contents of .ics files
+# - link:ics-dump.txt: utility for dumping contents of .ics files
 module Vpim
-  VERSION = "0.16"
+  VERSION = "0.17"
 
   # Return the API version as a string.
   def Vpim.version
@@ -94,3 +91,38 @@ module Vpim
   class InvalidEncodingError < StandardError; end
 end
 
+module Vpim::Methods
+  module_function
+
+  # Case-insensitive comparison of +str0+ to +str1+, returns true or false.
+  # Either argument can be nil, where nil compares not equal to anything other
+  # than nil.
+  #
+  # This is available both as a module function:
+  #   Vpim::Methods.casecmp?("yes", "YES")
+  # and an instance method:
+  #   include Vpim::Methods
+  #   casecmp?("yes", "YES")
+  #
+  # Will work with ruby1.6 and ruby 1.8.
+  #
+  # TODO - could make this be more efficient, but I'm supporting 1.6, not
+  # optimizing for it.
+  def casecmp?(str0, str1)
+    if str0 == nil
+      if str1 == nil
+      return true
+      else
+        return fasle
+      end
+    end
+
+    begin
+      str0.casecmp(str1) == 0
+    rescue NoMethodError
+      str0.downcase == str1.downcase
+    end
+  end
+
+end
+

data/lib/vpim/vpim.rb~

@@ -1,7 +1,5 @@
 =begin
-  $Id: vpim.rb,v 1.20 2005/02/04 21:31:12 sam Exp $
-
-  Copyright (C) 2005 Sam Roberts
+  Copyright (C) 2006 Sam Roberts
 
   This library is free software; you can redistribute it and/or modify it
   under the same terms as the ruby language itself, see the file COPYING for
@@ -14,31 +12,28 @@
 # Author::     Sam Roberts <sroberts@uniserve.com>
 # Copyright::  Copyright (C) 2006 Sam Roberts
 # License::    May be distributed under the same terms as Ruby
-# Version::    0.16
+# Version::    0.17
 # Homepage::   http://vpim.rubyforge.org
 #
-# An implementation of the MIME Content-Type for Directory Information (RFC
-# 2425), and profiles of this format. The basic RFC 2425 format is implemented
-# by the DirectoryInfo class.
-#
-# Currently the only IETF-defined profile is vCard (RFC 2426), implemented by
-# the Vcard class.
-#
-# iCalendar (RFC 2445) was not specified as a profile of RFC 2425, could have
-# been, and is implemented by the Icalendar class.
+# vCard (RFC 2426) is a format for personal information, see Vpim::Vcard and
+# Vpim::Maker::Vcard.
 #
-# Both of these "v-formats" are for personal information management, thus the
-# name "vPim".
+# iCalendar (RFC 2445) is a format for calendar related information, see
+# Vpim::Icalendar.
 #
-# This is my first Ruby library, and I would love to have feedback on
-# useability. In particular, if anybody using this library could send me
-# any code showing how they call vPim, that would be very useful to me. It
-# doesn't have to be complete, I would just like to see how the APIs are
-# being called, to give me ideas for how to improve them.
+# iCalendar was called vCalendar pre-IETF standaradization, and since both of
+# these "v-formats" are commonly used personal information management, the
+# library is called "vpim".
 #
-# Particularly, I'm interested in examples of encoding.
+# 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.
 #
-# Sam Roberts <sroberts@uniserve.com>
+# The libary is mature to the point of useability, but there is always more
+# that could be done. I have a very long todo list, so if you think something
+# is missing, or have API 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 are high priority for me.
 #
 # = Project Information
 #
@@ -46,8 +41,8 @@
 #
 # - http://rubyforge.org/projects/vpim
 #
-# If you are interested in notifications about new releases, or
-# asking questions about vPim, please subscribe to "vpim-talk":
+# For notifications about new releases, or asking questions about vPim, please
+# subscribe to "vpim-talk":
 #
 # - http://rubyforge.org/mailman/listinfo/vpim-talk
 #
@@ -56,16 +51,18 @@
 # Sample utilities are provided as examples of using vPim in samples/.
 # 
 # vCard examples are:
-# - link:ex_mkvcard.txt: an example of making a vCard
+# - 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:vcard-dump.txt: dump all the fields in a vCard
 # - 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-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
@@ -78,9 +75,9 @@
 # - link:reminder.txt: prints upcoming events and todos, by default from
 #   Apple's iCal calendars
 # - link:rrule.txt: utility for printing recurrence rules
-# - link:ical-dump.txt: utility for dumping contents of .ics files
+# - link:ics-dump.txt: utility for dumping contents of .ics files
 module Vpim
-  VERSION = "0.16"
+  VERSION = "0.17"
 
   # Return the API version as a string.
   def Vpim.version
@@ -94,3 +91,38 @@ module Vpim
   class InvalidEncodingError < StandardError; end
 end
 
+module Vpim::Methods
+  module_function
+
+  # Case-insensitive comparison of +str0+ to +str1+, returns true or false.
+  # Either argument can be nil, where nil compares not equal to anything other
+  # than nil.
+  #
+  # This is available both as a module function:
+  #   Vpim::Methods.casecmp?("yes", "YES")
+  # and an instance method:
+  #   include Vpim::Methods
+  #   casecmp?("yes", "YES")
+  #
+  # Will work with ruby1.6 and ruby 1.8.
+  #
+  # TODO - could make this be more efficient, but I'm supporting 1.6, not
+  # optimizing for it.
+  def casecmp?(str0, str1)
+    if str0 == nil
+      if str1 == nil
+      return true
+      else
+        return fasle
+      end
+    end
+
+    begin
+      str0.casecmp(str1) == 0
+    rescue NoMethodError
+      str0.downcase == str1.downcase
+    end
+  end
+
+end
+

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.8.11
 specification_version: 1
 name: vpim
 version: !ruby/object:Gem::Version 
-  version: "0.16"
-date: 2006-02-19 00:00:00 -08:00
+  version: "0.17"
+date: 2006-03-08 00:00:00 -08:00
 summary: a library to manipulate vCards and iCalendars
 require_paths: 
 - lib
@@ -29,21 +29,35 @@ authors:
 - Sam Roberts
 files: 
 - lib/vpim
+- lib/vpim/agent
 - lib/vpim/date.rb
+- lib/vpim/date.rb~
 - lib/vpim/dirinfo.rb
+- lib/vpim/dirinfo.rb~
 - lib/vpim/duration.rb
+- lib/vpim/duration.rb~
 - lib/vpim/enumerator.rb
+- lib/vpim/enumerator.rb~
 - lib/vpim/field.rb
+- lib/vpim/field.rb~
 - lib/vpim/icalendar.rb
+- lib/vpim/icalendar.rb~
 - lib/vpim/maker
 - lib/vpim/rfc2425.rb
+- lib/vpim/rfc2425.rb~
 - lib/vpim/rrule.rb
+- lib/vpim/rrule.rb~
 - lib/vpim/time.rb
+- lib/vpim/time.rb~
 - lib/vpim/vcard.rb
+- lib/vpim/vcard.rb~
 - lib/vpim/vevent.rb
+- lib/vpim/vevent.rb~
 - lib/vpim/vpim.rb
 - lib/vpim/vpim.rb~
+- lib/vpim/agent/plist.rb
 - lib/vpim/maker/vcard.rb
+- lib/vpim/maker/vcard.rb~
 test_files: []
 
 rdoc_options: []