vpim 0.357 → 0.360

data/lib/vpim/address.rb

@@ -47,77 +47,31 @@ module Vpim
     # a field.
     #
     # Example:
+    #
     #   ORGANIZER;CN="A. Person":mailto:a_person@example.com
+    #
     #   ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=NEEDS-ACTION
     #    ;CN="Sam Roberts";RSVP=TRUE:mailto:SRoberts@example.com
     #
     class Address
 
-      # Create an Address from a DirectoryInfo::Field, +field+.
-      #
-      # TODO - make private, and split into the encode/decode/create trinity.
-      def initialize(field)
-        unless field.value
-          raise ArgumentError
-        end
-
-        @field = field
-      end
-
-      # Return a representation of this Address as a DirectoryInfo::Field.
-      def field
-        @field.copy
-      end
-
       # Create a copy of Address. If the original Address was frozen, this one
       # won't be.
       def copy
-        Marshal.load(Marshal.dump(self))
+        #Marshal.load(Marshal.dump(self))
+        self.dup.dirty
       end
 
-      # Addresses in a CAL-ADDRESS are represented as a URI, usually a mailto URI.
-      def uri
-        @field.value
-      end
-
-      # Return true if the +uri+ is == to this address' URI. The comparison
-      # is case-insensitive.
-      #
-      # FIXME - why case insensitive? Email addresses. Should use a URI library
-      # if I can find one and it knows how to do URI comparisons.
-      def ==(uri)
-        Vpim::Methods.casecmp?(self.uri.to_str, uri.to_str)
-      end
-
-      # The common or displayable name associated with the calendar address,
-      # or nil if there is none.
-      def cn
-        return nil unless n = @field.param('CN')
-
-        # FIXME = the CN param may have no value, which is an error, but don't try
-        # to decode it, return either nil, or InvalidEncoding
-        Vpim.decode_text(n.first)
-      end
-
-      # A string representation of an address, using the common name, and the
-      # URI. The URI protocol is stripped if it's "mailto:".
-      # 
-      # TODO - this needs to properly escape the cn string!
-      def to_s
-        u = uri
-        u.gsub!(/^mailto: */i, '')
-
-        if cn
-          "\"#{cn}\" <#{uri}>"
-        else
-          uri
-        end
-      end
-
-      def inspect
-        "#<Vpim::Icalendar::Address:cn=#{cn.inspect} status=#{partstat} rsvp?=#{rsvp} #{uri.inspect}>"
+      def dirty #:nodoc:
+        @field = nil
+        self
       end
 
+      # Addresses in a CAL-ADDRESS are represented as a URI, usually a mailto URI.
+      attr_accessor :uri
+      # The common or displayable name associated with the calendar address, or
+      # nil if there is none.
+      attr_accessor :cn
       # The participation role for the calendar user specified by the address.
       #
       # The standard roles are:
@@ -128,11 +82,7 @@ module Vpim
       #
       # The default role is REQ-PARTICIPANT, returned if no ROLE parameter was
       # specified.
-      def role
-        return 'REQ-PARTICIPANT' unless r = @field.param('ROLE')
-        r.first.upcase
-      end
-
+      attr_accessor :role
       # The participation status for the calendar user specified by the
       # property PARTSTAT, a String.
       #
@@ -145,36 +95,124 @@ module Vpim
       #
       # Default is NEEDS-ACTION.
       #
-      # TODO - make the default depend on the component type.
-      def partstat
-        return 'NEEDS-ACTION' unless r = @field.param('PARTSTAT')
-        r.first.upcase
+      # FIXME - make the default depend on the component type.
+      attr_accessor :partstat
+      # The value of the RSVP field, either +true+ or +false+. It is used to
+      # specify whether there is an expectation of a reply from the calendar
+      # user specified by the property value.
+      attr_accessor :rsvp
+
+      def initialize(field=nil) #:nodoc:
+        @field = field
+        @uri = ''
+        @cn = ''
+        @role = "REQ-PARTICIPANT"
+        @partstat = "NEEDS-ACTION"
+        @rsvp = false
       end
 
-      # Set or change the participation status of the address, the PARTSTAT,
-      # to +status+.
-      #
-      # See #partstat.
-      def partstat=(status)
-        @field['PARTSTAT'] = status.to_str
-        status
+      # Create a new Address. It will encode as a +name+ property.
+      def self.create(uri='')
+        adr = new
+        adr.uri = uri.to_str
+        adr
       end
 
-      # The value of the RSVP field, either +true+ or +false+. It is used to
-      # specify whether there is an expectation of a favor of a reply from the
-      # calendar user specified by the property value.
-      #
-      # TODO - should be #rsvp?
-      def rsvp
-        return false unless r = @field.param('RSVP')
-        r = r.first
-        return false unless r
-        case r
-          when /TRUE/i then true
-          when /FALSE/i then false
-          else raise InvalidEncodingError, "RSVP param value not TRUE/FALSE: #{r}"
+      def self.decode(field)
+        adr = new(field)
+        adr.uri = field.value
+
+        cn = field.param('CN')
+
+        if cn
+          adr.cn = cn.first
+        end
+
+        role = field.param('ROLE')
+
+        if role
+          adr.role = role.first.strip.upcase
+        end
+
+        partstat = field.param('PARTSTAT')
+
+        if partstat
+          adr.partstat = partstat.first.strip.upcase
+        end
+        
+        rsvp = field.param('RSVP')
+
+        if rsvp
+          adr.rsvp = case rsvp.first
+                     when /TRUE/i then true
+                     when /FALSE/i then false
+                     else raise InvalidEncodingError, "RSVP param value not TRUE/FALSE: #{rsvp}"
+                     end
+        end
+
+        adr.freeze
+      end
+
+      # Return a representation of this Address as a DirectoryInfo::Field.
+      def encode(name) #:nodoc:
+        if @field
+          # FIXME - set the field name, it could be different from cached
+          return @field
+        end
+
+        value = uri.to_str.strip
+
+        if value.empty?
+          raise Uencodeable, "Address#uri is zero-length"
+        end
+
+        params = {}
+
+        if cn.length > 0
+          params['CN'] = Vpim::encode_paramvalue(cn)
+        end
+
+        # FIXME - default value is different for non-vEvent
+        if role.length > 0 && role != 'REQ-PARTICIPANT'
+          params['ROLE'] = Vpim::encode_paramtext(role)
+        end
+
+        # FIXME - default value is different for non-vEvent
+        if partstat.length > 0 && partstat != 'NEEDS-ACTION'
+          params['PARTSTAT'] = Vpim::encode_paramtext(partstat)
+        end
+
+        if rsvp
+          params['RSVP'] = 'true'
+        end
+
+        Vpim::DirectoryInfo::Field.create(name, value, params)
+      end
+
+      # Return true if the +uri+ is == to this address' URI. The comparison
+      # is case-insensitive (because email addresses and domain names are).
+      def ==(uri)
+        # TODO - could I use a URI library?
+        Vpim::Methods.casecmp?(self.uri.to_str, uri.to_str)
+      end
+
+      # A string representation of an address, using the common name, and the
+      # URI. The URI protocol is stripped if it's "mailto:".
+      def to_s
+        u = uri
+        u = u.gsub(/^mailto: */i, '')
+
+        if cn.length > 0
+          "#{cn.inspect} <#{uri}>"
+        else
+          uri
         end
       end
+
+      def inspect #:nodoc:
+        "#<Vpim::Icalendar::Address:cn=#{cn.inspect} status=#{partstat} rsvp=#{rsvp} #{uri.inspect}>"
+      end
+
     end
   end
 end

data/lib/vpim/icalendar.rb

@@ -33,10 +33,12 @@ module Vpim
   #   (iTIP) Scheduling Events, BusyTime, To-dos and Journal Entries
   # - link:rfc2447.txt: iCalendar Message-Based Interoperability Protocol
   #
-  # iCalendar (RFC 2445) is based on vCalendar, but does not appear to be
-  # altogether compatible. iCalendar files have VERSION:2.0 and vCalendar have
-  # VERSION:1.0.  While much appears to be similar, the recurrence rule syntax,
-  # at least, is completely different.
+  # = iCalendar and vCalendar
+  #
+  # iCalendar files have VERSION:2.0 and vCalendar have VERSION:1.0.  iCalendar
+  # (RFC 2445) is based on vCalendar, but but is not very compatible.  While
+  # much appears to be similar, the recurrence rule syntax is completely
+  # different.
   #
   # iCalendars are usually transmitted in files with <code>.ics</code>
   # extensions.
@@ -88,18 +90,37 @@ module Vpim
       end
     end
 
+    # Add and event to this calendar.
+    #
+    # Yields an event maker, Icalendar::Vevent::Maker.
+    def add_event(&block) #:yield:event
+      push Vevent::Maker.make( &block )
+    end
+
+    # FIXME - could take mandatory fields as an arguments
+    # FIXME - args: support PRODID
+    # FIXME - yield an Icalendar::Maker if block provided
+    # FIXME - maker#prodid=
+    def Icalendar.create2(args = nil)
+      # FIXME - make the primary API
+      di = DirectoryInfo.create( [ DirectoryInfo::Field.create('VERSION', '2.0') ], 'VCALENDAR' )
+
+      di.push_unique DirectoryInfo::Field.create('PRODID',   Vpim::PRODID)
+      di.push_unique DirectoryInfo::Field.create('CALSCALE', "Gregorian")
+
+      new(di.to_a)
+    end
+
     # Create a new Icalendar object with the minimal set of fields for a valid
     # Calendar. If specified, +fields+ must be an array of
     # DirectoryInfo::Field objects to add. They can override the the default
     # Calendar fields, so, for example, this can be used to set a custom PRODID field.
-    #
-    # TODO - allow hash args like Vevent.create
     def Icalendar.create(fields=[])
       di = DirectoryInfo.create( [ DirectoryInfo::Field.create('VERSION', '2.0') ], 'VCALENDAR' )
 
       DirectoryInfo::Field.create_array(fields).each { |f| di.push_unique f }
 
-      di.push_unique DirectoryInfo::Field.create('PRODID',   "-//Ensemble Independant//vPim #{Vpim.version}//EN")
+      di.push_unique DirectoryInfo::Field.create('PRODID',   Vpim::PRODID)
       di.push_unique DirectoryInfo::Field.create('CALSCALE', "Gregorian")
 
       new(di.to_a)
@@ -124,10 +145,16 @@ module Vpim
       Icalendar.create(fields)
     end
 
+    # Used during encoding.
+    def fields # :nodoc:
+      f = @properties.to_a
+      last = f.pop
+      @components.each { |c| f << c.fields }
+      f.push last
+    end
+
     # Encode the Calendar as a string. The width is the maximum width of the
     # encoded lines, it can be specified, but is better left to the default.
-    #
-    # TODO - only does top-level now, needs to add the events/todos/etc.
     def encode(width=nil)
       # We concatenate the fields of all objects, create a DirInfo, then
       # encode it.
@@ -135,17 +162,6 @@ module Vpim
       di.encode(width)
     end
 
-    # Used during encoding.
-    def fields # :nodoc:
-      fields = @properties.to_a
-
-      last = fields.pop
-
-      @components.each { |c| fields << c.fields }
-
-      fields << last
-    end
-
     alias to_s encode
 
     # Push a calendar component onto the calendar.
@@ -156,6 +172,7 @@ module Vpim
         else
           raise ArgumentError, "can't add a #{component.type} to a calendar"
       end
+      self
     end
 
     # Check if the protocol method is +method+

data/lib/vpim/property/base.rb

@@ -8,10 +8,88 @@
 
 module Vpim
   class Icalendar
+    module Set #:nodoc:
+      module Util #:nodoc:
+
+        def rm_all(name)
+          rm = @comp.properties.select { |f| f.name? name }
+          rm.each { |f| @comp.properties.delete(f) }
+        end
+
+        def set_token(name, allowed, default, value) #:nodoc:
+          value = value.to_str
+          unless allowed.include?(value)
+            raise Vpim::Unencodeable, "Invalid #{name} value '#{value}'"
+          end
+          rm_all(name)
+          unless value == default
+            @comp.properties.push Vpim::DirectoryInfo::Field.create(name, value)
+          end
+        end
+
+        def field_create(name, value, default_value_type = nil, value_type = nil, params = {})
+          if value_type && value_type != default_value_type
+            params['VALUE'] = value_type
+          end
+          Vpim::DirectoryInfo::Field.create(name, value, params)
+        end
+
+        def set_date_or_datetime(name, default, value)
+          f = nil
+          case value
+          when Date
+            f = field_create(name, Vpim.encode_date(value), default, 'DATE')
+          when Time
+            f = field_create(name, Vpim.encode_date_time(value), default, 'DATE-TIME')
+          else
+            raise Vpim::Unencodeable, "Invalid #{name} value #{value.inspect}"
+          end
+          rm_all(name)
+          @comp.properties.push(f)
+        end
+
+        def set_datetime(name, value)
+          f = field_create(name, Vpim.encode_date_time(value))
+          rm_all(name)
+          @comp.properties.push(f)
+        end
+
+        def set_text(name, value)
+          f = field_create(name, Vpim.encode_text(value))
+          rm_all(name)
+          @comp.properties.push(f)
+        end
+
+        def set_text_list(name, value)
+          f = field_create(name, Vpim.encode_text_list(value))
+          rm_all(name)
+          @comp.properties.push(f)
+        end
+
+        def set_integer(name, value)
+          value = value.to_int.to_s
+          f = field_create(name, value)
+          rm_all(name)
+          @comp.properties.push(f)
+        end
+
+        def add_address(name, value)
+          f = value.encode(name)
+          @comp.properties.push(f)
+        end
+
+        def set_address(name, value)
+          rm_all(name)
+          add_address(name, value)
+        end
+
+      end
+    end
+
     module Property #:nodoc:
 
-      # FIXME - these should be part of Dirinfo
-      module Base
+      # FIXME - rename Base to Util
+      module Base #:nodoc:
         # Value of first property with name +name+
         def propvalue(name) #:nodoc:
           prop = @properties.detect { |f| f.name? name }

data/lib/vpim/property/common.rb

@@ -78,7 +78,7 @@ module Vpim
           organizer = @properties.field('ORGANIZER')
 
           if organizer
-            organizer = Icalendar::Address.new(organizer)
+            organizer = Icalendar::Address.decode(organizer)
           end
 
           organizer.freeze
@@ -128,7 +128,7 @@ seq
         # attendees are objects of Icalendar::Address. If +uri+ is specified
         # only the return the attendees with this +uri+.
         def attendees(uri = nil)
-          attendees = @properties.enum_by_name('ATTENDEE').map { |a| Icalendar::Address.new(a).freeze }
+          attendees = @properties.enum_by_name('ATTENDEE').map { |a| Icalendar::Address.decode(a) }
           attendees.freeze
           if uri
             attendees.select { |a| a == uri }
@@ -174,6 +174,141 @@ seq
       end
 
     end
+
+    module Set
+
+      # Properties common to Vevent, Vtodo, and Vjournal.
+      module Common
+
+        # Set the access class of the component, see Icalendar::Get::Common#access_class.
+        def access_class(token)
+          set_token 'CLASS', ["PUBLIC", "PRIVATE", "CONFIDENTIAL"], "PUBLIC", token
+        end
+
+        # Set the creation time, see Icalendar::Get::Common#created
+        def created(time)
+          set_datetime 'CREATED', time
+        end
+
+        # Set the description, see Icalendar::Get::Common#description.
+        def description(text)
+          set_text 'DESCRIPTION', text
+        end
+
+        # Set the sequence number, see Icalendar::Get::Common#sequence.
+        # is no SEQUENCE; property.
+        def sequence(int)
+          set_integer 'SEQUENCE', int
+        end
+
+        # Set the timestamp, see Icalendar::Get::Common#timestamp.
+        def dtstamp(time)
+          set_datetime 'DTSTAMP', time
+          self
+        end
+
+        # The start time or date, see Icalendar::Get::Common#dtstart.
+        def dtstart(start)
+          set_date_or_datetime 'DTSTART', 'DATE-TIME', start
+          self
+        end
+
+        # Set the last modification time, see Icalendar::Get::Common#lastmod.
+        def lastmod(time)
+          set_datetime 'LAST-MODIFIED', time
+          self
+        end
+
+        # Set the event organizer, an Icalendar::Address, see Icalendar::Get::Common#organizer.
+        #
+        # Without an +adr+ it yields an Icalendar::Address that is a copy of
+        # the current organizer (if any), allowing it to be modified.
+        def organizer(adr=nil) #:yield: organizer
+          unless adr
+            adr = @comp.organizer
+            if adr
+              adr = adr.copy
+            else
+              adr = Icalendar::Address.create
+            end
+            yield adr
+          end
+          set_address('ORGANIZER', adr)
+          self
+        end
+
+=begin
+        # Status values are not rejected during decoding. However, if the
+        # status is requested, and it's value is not one of the defined
+        # allowable values, an exception is raised.
+        def status
+          case self
+          when Vpim::Icalendar::Vevent
+            proptoken 'STATUS', ['TENTATIVE', 'CONFIRMED', 'CANCELLED']
+
+          when Vpim::Icalendar::Vtodo
+            proptoken 'STATUS', ['NEEDS-ACTION', 'COMPLETED', 'IN-PROCESS', 'CANCELLED']
+
+          when Vpim::Icalendar::Vevent
+            proptoken 'STATUS', ['DRAFT', 'FINAL', 'CANCELLED']
+          end
+        end
+=end
+
+        # Set summary description of component, see Icalendar::Get::Common#summary.
+        def summary(text)
+          set_text 'SUMMARY', text
+        end
+
+        # Set the unique identifier of this calendar component, see Icalendar::Get::Common#uid.
+        def uid(uid)
+          set_text 'UID', uid
+        end
+
+        def url(url)
+          set_text 'URL', url
+        end
+
+        # Add an attendee Address, see Icalendar::Get::Common#attendees.
+        def add_attendee(adr)
+          add_address('ATTENDEE', adr)
+        end
+
+        # Set the categories, see Icalendar::Get::Common#attendees.
+        #
+        # If +cats+ is provided, the categories are set to cats, either a
+        # String or an Array of String. Otherwise, and array of the existing
+        # category strings is yielded, and it can be modified.
+        def categories(cats = nil) #:yield: categories
+          unless cats
+            cats = @comp.categories
+            yield cats
+          end
+          # TODO - strip the strings
+          set_text_list('CATEGORIES', cats)
+        end
+
+        # Set the comment, see Icalendar::Get::Common#comment.
+        def comment(value)
+          set_text 'COMMENT', value
+        end
+
+=begin
+        def contacts
+          proptextarray 'CONTACT'
+        end
+
+        # An Array of attachments, see Attachment for more information.
+        def attachments
+          @properties.enum_by_name('ATTACH').map do |f|
+            attachment = Attachment.decode(f, 'uri', 'FMTTYPE')
+          end
+        end
+=end
+
+      end
+
+    end
   end
 end
 

data/lib/vpim/rfc2425.rb

@@ -56,6 +56,14 @@ module Vpim
 
     # integer = (["+"] / "-") 1*DIGIT
     INTEGER = '[-+]?\d+'
+
+    # QSAFE-CHAR = WSP / %x21 / %x23-7E / NON-US-ASCII
+    #  ; Any character except CTLs and DQUOTE
+    QSAFECHAR = '[ \t\x21\x23-\x7e\x80-\xff]'
+
+    # SAFE-CHAR  = WSP / %x21 / %x23-2B / %x2D-39 / %x3C-7E / NON-US-ASCII
+    #   ; Any character except CTLs, DQUOTE, ";", ":", ","
+    SAFECHAR = '[ \t\x21\x23-\x2b\x2d-\x39\x3c-\x7e\x80-\xff]'
   end
 end
 
@@ -232,8 +240,13 @@ module Vpim
     end
   end
 
+  # v is an Array of String, or just a single String
   def Vpim.encode_text_list(v, sep = ",") #:nodoc:
-    v.to_ary.map{ |t| Vpim.encode_text(t) }.join(sep)
+    begin
+      v.to_ary.map{ |t| Vpim.encode_text(t) }.join(sep)
+    rescue
+      Vpim.encode_text(v)
+    end
   end
 
   # Convert a +sep+-seperated list of TEXT values into an array of values.
@@ -248,6 +261,29 @@ module Vpim
     list
   end
 
+  # param-value = paramtext / quoted-string
+  # paramtext  = *SAFE-CHAR
+  # quoted-string      = DQUOTE *QSAFE-CHAR DQUOTE
+  def Vpim.encode_paramtext(value)
+    case value
+    when %r{\A#{Bnf::SAFECHAR}*\z}
+      value
+    else
+      raise Vpim::Unencodable, "paramtext #{value.inspect}"
+    end
+  end
+
+  def Vpim.encode_paramvalue(value)
+    case value
+    when %r{\A#{Bnf::SAFECHAR}*\z}
+      value
+    when %r{\A#{Bnf::QSAFECHAR}*\z}
+      '"' + value + '"'
+    else
+      raise Vpim::Unencodable, "param-value #{value.inspect}"
+    end
+  end
+
 
   # Unfold the lines in +card+, then return an array of one Field object per
   # line.

data/lib/vpim/vcard.rb

@@ -1078,19 +1078,12 @@ module Vpim
 
       public
 
-      #     def add_name # :yield: n
-      #       # FIXME: Each attribute can currently only have a single String value.
-      #       # FIXME: Need to escape specials in the String.
-      #       x = Struct.new(:family, :given, :additional, :prefix, :suffix).new
-      #       yield x
-      #       @card << Vpim::DirectoryInfo::Field.create(
-      #         'N',
-      #         x.map { |s| s ? s.to_str : '' }
-      #         )
-      #       self
-      #     end
-      # Set with #name now.
-      # Use m.name do |n| n.fullname = foo end
+      # Deprecated, see #name.
+      #
+      # Use
+      #   maker.name do |n| n.fullname = "foo" end
+      # to set just fullname, or set the other fields to set fullname and the
+      # name.
       def fullname=(fullname) #:nodoc: bacwards compat
         if @card.field('FN')
           raise Vpim::InvalidEncodingError, "Not allowed to add more than one FN field to a vCard."

data/lib/vpim/version.rb

@@ -7,9 +7,9 @@
 =end
 
 module Vpim
-  PRODID = '-//Ensemble Independent//vPim 0.357//EN'
+  PRODID = '-//Ensemble Independent//vPim 0.360//EN'
 
-  VERSION = '0.357'
+  VERSION = '0.360'
 
   # Return the API version as a string.
   def Vpim.version

data/lib/vpim/vevent.rb

@@ -20,6 +20,7 @@ require 'vpim/property/recurrence'
 module Vpim
   class Icalendar
     class Vevent
+
       include Vpim::Icalendar::Property::Base
       include Vpim::Icalendar::Property::Common
       include Vpim::Icalendar::Property::Priority
@@ -37,6 +38,19 @@ module Vpim
         # See "TODO - fields" in dirinfo.rb
       end
 
+      # TODO - derive everything from Icalendar::Component to get this kind of stuff?
+      def fields #:nodoc:
+        f = @properties.to_a
+        last = f.pop
+        f.push @elements
+        f.push last
+      end
+
+      def properties #:nodoc:
+        @properties
+      end
+
+
       # Create a new Vevent object. All events must have a DTSTART field,
       # specify it as either a Time or a Date in +start+, it defaults to "now"
       # (is this useful?).
@@ -71,10 +85,12 @@ module Vpim
 
       # Accept an event invitation. The +invitee+ is the Address that wishes
       # to accept the event invitation as confirmed.
+      #
+      # The event created is identical to this one, but
+      # - without the attendees
+      # - with the invitee added with a PARTSTAT of ACCEPTED
       def accept(invitee)
-        # The event created is identical to this one, but
-        # - without the attendees
-        # - with the invitee added with a PARTSTAT of ACCEPTED
+        # FIXME - move to Vpim::Itip.
         invitee = invitee.copy
         invitee.partstat = 'ACCEPTED'
 
@@ -84,7 +100,7 @@ module Vpim
           |f,i|
 
           # put invitee in as field[1]
-          fields << invitee.field if i == 1
+          fields << invitee.encode('ATTENDEE') if i == 1
           
           fields << f unless f.name? 'ATTENDEE'
         end
@@ -92,11 +108,8 @@ module Vpim
         Vevent.new(fields)
       end
 
-=begin
-      # Set the start time for the event to +start+, a Time object.
-      # TODO - def dtstart=(start) ... start should be allowed to be Time/Date/DateTime
-=end
-
+      # In iTIP, whether this event is OPAQUE or TRANSPARENT to scheduling. If
+      # transparency is not explicitly set, it defaults to OPAQUE.
       def transparency
         proptoken 'TRANSP', ["OPAQUE", "TRANSPARENT"], "OPAQUE"
       end
@@ -135,6 +148,57 @@ module Vpim
         end
       end
 
+      # Make a new Vevent, or make changes to an existing Vevent.
+      class Maker
+        # TODO - should I automatically set
+        #   #created
+        #   #dtstamp
+        #   #sequence
+        #   ...?
+        #
+        # Many have pretty specific meanings in iTIP, perhaps I should leave
+        # them alone.
+        include Vpim::Icalendar::Set::Util #:nodoc:
+        include Vpim::Icalendar::Set::Common
+
+        # The event that changes are being made to.
+        attr_reader :event
+
+        def initialize(event) #:nodoc:
+          @event = event
+          @comp = event
+        end
+
+        # Make changes to +event+. If +event+ is not specified, creates a new
+        # event. Yields a Vevent::Maker, and returns +event+.
+        def self.make(event = Vpim::Icalendar::Vevent.create) #:yield:maker
+          m = self.new(event)
+          yield m
+          m.event
+        end
+
+        # Set transparency to "OPAQUE" or "TRANSPARENT", see Vpim::Vevent#transparency.
+        def transparency(token)
+          set_token 'TRANSP', ["OPAQUE", "TRANSPARENT"], "OPAQUE", token
+        end
+
+        # Set end for events with fixed durations. +end+ can be a Date or Time
+        def dtend(dtend)
+          set_date_or_datetime 'DTEND', 'DATE-TIME', dtend
+        end
+
+        # Yields a selector that allows the duration to be set.
+        #
+        # TODO - syntax is:
+        #   dur-value =  (["+"] / "-") "P" (dur-date / dur-time / dur-week)
+        #   dur-date  = dur-day [ "T" (dur-hour / dur-minute / dur-second) ]
+        #   dur-time  = "T" (dur-hour / dur-minute / dur-second)
+        #   dur-week  = 1*DIGIT "W"
+        def duration(dur) #:yield:selector
+          raise Vpim::Unsupported
+        end
+      end
+
     end
   end
 end

metadata

@@ -3,15 +3,15 @@ rubygems_version: 0.8.11
 specification_version: 1
 name: vpim
 version: !ruby/object:Gem::Version 
-  version: "0.357"
-date: 2006-03-31 00:00:00 -08:00
-summary: a library to manipulate vCards and iCalendars
+  version: "0.360"
+date: 2006-04-02 00:00:00 -08:00
+summary: iCalendar and vCard support for ruby
 require_paths: 
 - lib
 email: sroberts@uniserve.com
 homepage: http://vpim.rubyforge.org
-rubyforge_project: 
-description: 
+rubyforge_project: vpim
+description: This is a pure-ruby library for decoding and encoding vCard and iCalendar data ("personal information") called vPim.
 autorequire: vpim
 default_executable: 
 bindir: bin