vpim 0.695 → 13.11.11

data/lib/vpim/icalendar.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -30,15 +31,18 @@ module Vpim
   #
   # The iCalendar format is specified by a series of IETF documents:
   #
-  # - link:rfc2445.txt: Internet Calendaring and Scheduling Core Object Specification
-  # - link:rfc2446.txt: iCalendar Transport-Independent Interoperability Protocol
-  #   (iTIP) Scheduling Events, BusyTime, To-dos and Journal Entries
-  # - link:rfc2447.txt: iCalendar Message-Based Interoperability Protocol
+  # - RFC2445[http://www.ietf.org/rfc/rfc2445.txt]: Internet Calendaring and
+  #   Scheduling Core Object Specification
+  # - RFC2446[http://www.ietf.org/rfc/rfc2446.txt]: iCalendar
+  #   Transport-Independent Interoperability Protocol (iTIP) Scheduling Events,
+  #   BusyTime, To-dos and Journal Entries
+  # - RFC2447[http://www.ietf.org/rfc/rfc2447.txt]: iCalendar Message-Based
+  #   Interoperability Protocol
   #
   # = 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
+  # (RFC 2445) is based on vCalendar, but is not very compatible.  While
   # much appears to be similar, the recurrence rule syntax is completely
   # different.
   #

data/lib/vpim/maker/vcard.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 

data/lib/vpim/property/base.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 

data/lib/vpim/property/common.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 

data/lib/vpim/property/location.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -29,9 +30,18 @@ module Vpim
           end
           prop
         end
+      end
+    end
 
+    # add a location property to (v)events. This is specified in the RFC 2445
+    module Set
+      module Location
+        def location(value)
+          set_text 'LOCATION', value
+        end
       end
     end
+
   end
 end
 

data/lib/vpim/property/priority.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -23,7 +24,7 @@ module Vpim
         #   comparison operators?
         def priority
           p = @properties.detect { |f| f.name? 'PRIORITY' }
-          
+
           if !p
             p = 0
           else

data/lib/vpim/property/recurrence.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 

data/lib/vpim/property/resources.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -20,5 +21,3 @@ module Vpim
     end
   end
 end
-
-

data/lib/vpim/repo.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -188,7 +189,7 @@ module Vpim
                  uri
                else
                  begin
-                   URI.parse(uri)
+                   URI.parse(uri.sub(/^webcal:/, "http:"))
                  rescue URI::InvalidURIError => e
                    raise ArgumentError, "Invalid URI for #{uri.inspect} - #{e.to_s}"
                  end

data/lib/vpim/rfc2425.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -21,13 +22,13 @@ module Vpim
 
     # <"> <Any character except CTLs, DQUOTE> <">
     QSTR    = '"([^"]*)"'
-     
+
     # *<Any character except CTLs, DQUOTE, ";", ":", ",">
     PTEXT   = '([^";:,]+)'
-      
+
     # param-value = ptext / quoted-string
     PVALUE  = "(?:#{QSTR}|#{PTEXT})"
-    
+
     # param = name "=" param-value *("," param-value)
     # Note: v2.1 allows a type or encoding param-value to appear without the type=
     # or the encoding=. This is hideous, but we try and support it, if there
@@ -76,29 +77,36 @@ module Vpim
   # This also supports the (invalid) encoding convention of allowing empty
   # lines to be inserted for readability - it does this by dropping zero-length
   # lines.
-  def Vpim.unfold(card) #:nodoc:
-      unfolded = []
-
-      card.each do |line|
-        line.chomp!
-        # If it's a continuation line, add it to the last.
-        # If it's an empty line, drop it from the input.
-        if( line =~ /^[ \t]/ )
-          unfolded[-1] << line[1, line.size-1]
-        elsif( line =~ /^$/ )
-        else
-          unfolded << line
-        end
+  #
+  # Also supports an the QUOTED-PRINTABLE soft line-break as described here:
+  # http://en.wikipedia.org/wiki/Quoted-printable
+  #
+  def Vpim.unfold(card) # :nodoc:
+    unfolded = []
+    # Ruby 1.9's String can no longer be iterated with #each, so the following
+    # code, which used to work with String, or Array, or File, or anything else
+    # which produced lines when iterated, now just works with String. Sucky.
+    card.each_line do |line|
+      line.chomp!
+      # If it's a continuation line, add it to the last.
+      # If it's an empty line, drop it from the input.
+      if( line =~ /^[ \t]/ )
+        unfolded[-1] << line[1, line.size-1]
+      elsif (unfolded.last && unfolded.last =~ /;ENCODING=QUOTED-PRINTABLE:.*?=$/)
+        unfolded.last << line
+      elsif( line =~ /^$/ )
+      else
+        unfolded << line
       end
-
-      unfolded
+    end
+    unfolded
   end
 
   # Convert a +sep+-seperated list of values into an array of values.
   def Vpim.decode_list(value, sep = ',') # :nodoc:
     list = []
-    
-    value.each(sep) do |item|
+
+    value.each_line(sep) do |item|
       item.chomp!(sep)
       list << yield(item)
     end
@@ -245,14 +253,14 @@ module Vpim
     # FIXME - I think this should trim leading and trailing space
     v.gsub(/\\(.)/) do
       case $1
-      when 'n', 'N' 
+      when 'n', 'N'
         "\n"
       else
         $1
       end
     end
   end
-  
+
   def Vpim.encode_text(v) #:nodoc:
     v.to_str.gsub(/([\\,;\n])/) { $1 == "\n" ? "\\n" : "\\"+$1 }
   end
@@ -286,7 +294,7 @@ module Vpim
     when %r{\A#{Bnf::SAFECHAR}*\z}
       value
     else
-      raise Vpim::Unencodable, "paramtext #{value.inspect}"
+      raise Vpim::Unencodeable, "paramtext #{value.inspect}"
     end
   end
 
@@ -297,7 +305,7 @@ module Vpim
     when %r{\A#{Bnf::QSAFECHAR}*\z}
       '"' + value + '"'
     else
-      raise Vpim::Unencodable, "param-value #{value.inspect}"
+      raise Vpim::Unencodeable, "param-value #{value.inspect}"
     end
   end
 

data/lib/vpim/rrule.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -65,20 +66,20 @@ module Vpim
 
        # Freq is mandatory, but must occur only once.
        @freq = nil
-   
+
        # Both Until and Count must not occur, neither is OK.
        @until = nil
        @count = nil
-   
+
        # Interval is optional, but defaults to 1.
        @interval = 1
 
        # WKST defines what day a week begins on, the default is monday.
        @wkst = 'MO'
-   
+
        # Recurrence can modified by these.
        @by = {}
-  
+
        if @rrule
          @rrule.scan(/([^;=]+)=([^;=]+)/) do |key,value|
            key.upcase!
@@ -256,10 +257,10 @@ module Vpim
         end
 
         # TODO - BYHOUR, BYMINUTE, BYSECOND
-        
-        hour   = [@dtstart.hour]   if !hour 
-        min    = [@dtstart.min]    if !min  
-        sec    = [@dtstart.sec]    if !sec 
+
+        hour   = [@dtstart.hour]   if !hour
+        min    = [@dtstart.min]    if !min
+        sec    = [@dtstart.sec]    if !sec
 
   #      debug days
 

data/lib/vpim/time.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 

data/lib/vpim/vcard.rb

@@ -1,3 +1,4 @@
+# -*- encoding : binary -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -17,8 +18,8 @@ module Vpim
   # A vCard, a specialization of a directory info object.
   #
   # The vCard format is specified by:
-  # - RFC2426: vCard MIME Directory Profile (vCard 3.0)
-  # - RFC2425: A MIME Content-Type for Directory Information
+  # - RFC2426[http://www.ietf.org/rfc/rfc2426.txt]: vCard MIME Directory Profile (vCard 3.0)
+  # - RFC2425[http://www.ietf.org/rfc/rfc2425.txt]: A MIME Content-Type for Directory Information
   #
   # This implements vCard 3.0, but it is also capable of working with vCard 2.1
   # if used with care.
@@ -26,7 +27,7 @@ module Vpim
   # All line values can be accessed with Vcard#value, Vcard#values, or even by
   # iterating through Vcard#lines. Line types that don't have specific support
   # and non-standard line types ("X-MY-SPECIAL", for example) will be returned
-  # as a String, with any base64 or quoted-printable encoding removed. 
+  # as a String, with any base64 or quoted-printable encoding removed.
   #
   # Specific support exists to return more useful values for the standard vCard
   # types, where appropriate.
@@ -41,13 +42,10 @@ module Vpim
   # lines, and both the singular and plural forms will eventually be
   # implemented.
   #
-  # If there is sufficient demand, specific support for vCard 2.1 could be
-  # implemented.
-  #
   # For more information see:
-  # - link:rfc2426.txt: vCard MIME Directory Profile (vCard 3.0)
-  # - link:rfc2425.txt: A MIME Content-Type for Directory Information
-  # - http://www.imc.org/pdi/pdiproddev.html: vCard 2.1 Specifications
+  # - RFC2426[http://www.ietf.org/rfc/rfc2426.txt]: vCard MIME Directory Profile (vCard 3.0)
+  # - RFC2425[http://www.ietf.org/rfc/rfc2425.txt]: A MIME Content-Type for Directory Information
+  # - vCard2.1[http://www.imc.org/pdi/pdiproddev.html]: vCard 2.1 Specifications
   #
   # vCards are usually transmitted in files with <code>.vcf</code>
   # extensions.
@@ -275,7 +273,7 @@ module Vpim
     end
 
     # Represents the value of a TEL field.
-    # 
+    #
     # The value is supposed to be a "X.500 Telephone Number" according to RFC
     # 2426, but that standard is not freely available. Otherwise, anything that
     # looks like a phone number should be OK.
@@ -672,6 +670,8 @@ module Vpim
         raise ArgumentError, "Vcard.decode cannot be called with a #{card.type}"
       end
 
+      string.force_encoding "BINARY"
+
       case string
         when /^\xEF\xBB\xBF/
           string = string.sub("\xEF\xBB\xBF", '')
@@ -689,6 +689,8 @@ module Vpim
           string = string.unpack('v*').pack('U*')
       end
 
+      string.force_encoding "utf-8"
+
       entities = Vpim.expand(Vpim.decode(string))
 
       # Since all vCards must have a begin/end, the top-level should consist
@@ -1384,7 +1386,7 @@ module Vpim
       # Copy the fields from +card+ into self using #add_field. If a block is
       # provided, each Field from +card+ is yielded. The block should return a
       # Field to add, or nil.  The Field doesn't have to be the one yielded,
-      # allowing the field to be copied and modified (see Field#copy) before adding, or 
+      # allowing the field to be copied and modified (see Field#copy) before adding, or
       # not added at all if the block yields nil.
       #
       # The vCard fields BEGIN and END aren't copied, and VERSION, N, and FN are copied

data/lib/vpim/version.rb

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

data/lib/vpim/vevent.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -103,7 +104,7 @@ module Vpim
 
           # put invitee in as field[1]
           fields << invitee.encode('ATTENDEE') if i == 1
-          
+
           fields << f unless f.name? 'ATTENDEE'
         end
 
@@ -135,6 +136,7 @@ module Vpim
       class Maker
         include Vpim::Icalendar::Set::Util #:nodoc:
         include Vpim::Icalendar::Set::Common
+        include Vpim::Icalendar::Set::Location
 
         # The event that changes are being made to.
         attr_reader :event

data/lib/vpim/view.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -10,7 +11,7 @@ require "enumerator"
 
 module Vpim
   module View
-    
+
     SECSPERDAY = 24 * 60 * 60
 
     # View only events occuring in the next week.
@@ -50,7 +51,7 @@ module Vpim
           end
 __
 =begin
-        block = lambda do |dountil| 
+        block = lambda do |dountil|
             unless block_given?
               return Enumerable::Enumerator.new(self, :occurrences, dountil)
             end

data/lib/vpim/vjournal.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 

data/lib/vpim/vpim.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 
@@ -21,7 +22,7 @@ module Vpim
   # If its unsupported, its likely because I didn't anticipate it being useful
   # to support this, and it likely it could be supported on request.
   class UnsupportedError < StandardError; end
-  
+
   # Exception used to indicate that encoding failed, probably because the
   # object would not result in validly encoded data. The message should
   # describe what is unsupported.

data/lib/vpim/vtodo.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 =begin
   Copyright (C) 2008 Sam Roberts
 

data/samples/agent.ru

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# Run as "rackup agent.ru", default rackup arguments follow:
+#\ -p 4567
+
+require "vpim/agent/ics"
+
+use Rack::Reloader, 0
+
+run Vpim::Agent::Ics
+

data/test/test_all.rb

@@ -1,3 +1,4 @@
+# -*- encoding : utf-8 -*-
 #!/usr/bin/env ruby
 
 require 'pp'
@@ -5,6 +6,7 @@ require 'pp'
 $-w = true
 
 $:.unshift File.dirname(__FILE__) + "/../lib"
+$:.unshift File.dirname(__FILE__) + "/.."
 
 
 #pp [__LINE__, $:, $"]