icalendar 1.4.1 → 1.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bac1e484f0c1f2c316989f0fb092e799cdcbc768
-  data.tar.gz: 43df9e195316a6fa72ea53ef22b615c62dccf807
+  metadata.gz: 037c1a6dc0343e14f0ee3ab43f078385795d9b1c
+  data.tar.gz: e14616a6a69ca12590b9634100708b3f3b7276c6
 SHA512:
-  metadata.gz: 8f3facfc15d82ac4d1364d82fd8f9dbca4d6101e725a93acd182a86a35571ec8180dd3fcf85b92fdce31b79a1cb7e7ef68aa07eca27bfc5bb81bcfb41b16bcc5
-  data.tar.gz: b9732aa49cfe06380fc0a401499bca6334c3dafdaad1a640f50d7e7d97d32be9f8651904064653436f892293896e0b5280651a77d48523e81e2b2eb926f809d2
+  metadata.gz: fcd6f74754bd83938a343d5f5b5fe9c3e70d22fc135f83960c5a615226c7d9418a0e972d2fa0daee663f60e40a21bf88f85e5327a3c7fff06defcfb08699d128
+  data.tar.gz: 9e400bf9c4c693f97e98759d020a3616d754fb7630ee75ddbb9cc8a824d9951c349157fd91e5911048691992171f0ff8d4df079fd81e9a408b50613982aecb66

data/.gitignore

@@ -0,0 +1,5 @@
+.rvmrc
+.ruby-version
+.ruby-gemset
+Gemfile.lock
+pkg/

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/History.txt

@@ -1,3 +1,7 @@
+=== 1.4.2 2013-09-11
+ * Double Quote parameter values that contain forbidden characters
+ * Update Component#respond_to? to match Ruby 2.0 - Keith Marcum
+
 === 1.4.1 2013-06-25
  * Don't escape semicolon in GEO property - temirov
  * Allow access to various parts of RRule class

data/README.md

@@ -0,0 +1,268 @@
+iCalendar -- Internet calendaring, Ruby style
+===
+
+<http://github.com/icalendar/icalendar>
+
+DESCRIPTION
+---
+
+iCalendar is a Ruby library for dealing with iCalendar files in the 
+iCalendar format defined by RFC-2445:
+
+The use of calendaring and scheduling has grown considerably in the
+last decade. Enterprise and inter-enterprise business has become
+dependent on rapid scheduling of events and actions using this
+information technology. However, the longer term growth of calendaring
+and scheduling, is currently limited by the lack of Internet standards
+for the message content types that are central to these knowledgeware
+applications. This memo is intended to progress the level of
+interoperability possible between dissimilar calendaring and
+scheduling applications. This memo defines a MIME content type for
+exchanging electronic calendaring and scheduling information. The
+Internet Calendaring and Scheduling Core Object Specification, or
+iCalendar, allows for the capture and exchange of information normally
+stored within a calendaring and scheduling application; such as a
+Personal Information Manager (PIM) or a Group Scheduling product. 
+
+The iCalendar format is suitable as an exchange format between
+applications or systems. The format is defined in terms of a MIME
+content type. This will enable the object to be exchanged using
+several transports, including but not limited to SMTP, HTTP, a file
+system, desktop interactive protocols such as the use of a memory-
+based clipboard or drag/drop interactions, point-to-point asynchronous
+communication, wired-network transport, or some form of unwired
+transport such as infrared might also be used.
+
+
+EXAMPLES
+---
+
+### Probably want to start with this ###
+
+    require 'icalendar'
+    require 'date'
+
+    include Icalendar # You should do this in your class to limit namespace overlap
+
+### Creating calendars and events ###
+
+    # Create a calendar with an event (standard method)
+    cal = Calendar.new
+    cal.event do
+      dtstart       Date.new(2005, 04, 29)
+      dtend         Date.new(2005, 04, 28)
+      summary     "Meeting with the man."
+      description "Have a long lunch meeting and decide nothing..."
+      klass       "PRIVATE"
+    end
+
+    cal.publish
+
+#### Or you can make events like this ####
+
+    event = Event.new
+    event.start = DateTime.civil(2006, 6, 23, 8, 30)
+    event.summary = "A great event!"
+    cal.add_event(event)
+
+    event2 = cal.event  # This automatically adds the event to the calendar
+    event2.start = DateTime.civil(2006, 6, 24, 8, 30)
+    event2.summary = "Another great event!"
+
+#### Now with support for property parameters ####
+
+    params = {"ALTREP" =>['"http://my.language.net"'], "LANGUAGE" => ["SPANISH"]}
+
+    cal.event do
+      dtstart Date.new(2005, 04, 29)
+      dtend   Date.new(2005, 04, 28)
+      summary "This is a summary with params.", params
+    end
+
+#### We can output the calendar as a string ####
+
+    cal_string = cal.to_ical
+    puts cal_string
+
+ALARMS
+---
+
+### Within an event ###
+
+    cal.event.do
+      # ...other event properties
+      alarm do
+        action        "EMAIL"
+        description   "This is an event reminder" # email body (required)
+        summary       "Alarm notification"        # email subject (required)
+        attendees     %w(mailto:me@my-domain.com mailto:me-too@my-domain.com) # one or more email recipients (required)
+        add_attendee  "mailto:me-three@my-domain.com"
+        remove_attendee "mailto:me@my-domain.com"
+        trigger       "-PT15M" # 15 minutes before
+        add_attach    "ftp://host.com/novo-procs/felizano.exe", {"FMTTYPE" => "application/binary"} # email attachments (optional)
+      end
+
+      alarm do
+        action        "DISPLAY" # This line isn't necessary, it's the default
+        summary       "Alarm notification"
+        trigger       "-P1DT0H0M0S" # 1 day before
+      end
+
+      alarm do
+        action        "AUDIO"
+        trigger       "-PT15M"
+        add_attach    "Basso", {"VALUE" => ["URI"]}  # only one attach allowed (optional)
+      end
+    end
+
+#### Output ####
+
+    # BEGIN:VALARM
+    # ACTION:EMAIL
+    # ATTACH;FMTTYPE=application/binary:ftp://host.com/novo-procs/felizano.exe
+    # TRIGGER:-PT15M
+    # SUMMARY:Alarm notification
+    # DESCRIPTION:This is an event reminder
+    # ATTENDEE:mailto:me-too@my-domain.com
+    # ATTENDEE:mailto:me-three@my-domain.com
+    # END:VALARM
+    #
+    # BEGIN:VALARM
+    # ACTION:DISPLAY
+    # TRIGGER:-P1DT0H0M0S
+    # SUMMARY:Alarm notification
+    # END:VALARM
+    #
+    # BEGIN:VALARM
+    # ACTION:AUDIO
+    # ATTACH;VALUE=URI:Basso
+    # TRIGGER:-PT15M
+    # END:VALARM
+
+TIMEZONES
+---
+
+    cal = Calendar.new
+    cal.timezone do
+      timezone_id             "America/Chicago"
+
+      daylight do
+        timezone_offset_from  "-0600"
+        timezone_offset_to    "-0500"
+        timezone_name         "CDT"
+        dtstart               "19700308TO20000"
+        add_recurrence_rule   "FREQ=YEARLY;BYMONTH=3;BYDAY=2SU"
+      end
+
+      standard do
+        timezone_offset_from  "-0500"
+        timezone_offset_to    "-0600"
+        timezone_name         "CST"
+        dtstart               "19701101T020000"
+        add_recurrence_rule   "YEARLY;BYMONTH=11;BYDAY=1SU"
+      end
+    end
+
+#### Output ####
+
+    # BEGIN:VTIMEZONE
+    # TZID:America/Chicago
+    # BEGIN:DAYLIGHT
+    # TZOFFSETFROM:-0600
+    # TZOFFSETTO:-0500
+    # TZNAME:CDT
+    # DTSTART:19700308T020000
+    # RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=2SU
+    # END:DAYLIGHT
+    # BEGIN:STANDARD
+    # TZOFFSETFROM:-0500
+    # TZOFFSETTO:-0600
+    # TZNAME:CST
+    # DTSTART:19701101T020000
+    # RRULE:FREQ=YEARLY;BYMONTH=11;BYDAY=1SU
+    # END:STANDARD
+    # END:VTIMEZONE
+
+Unicode
+---
+
+Add `$KCODE = 'u'` to make icalender work correctly with Utf8 texts
+
+Parsing iCalendars
+---
+
+    # Open a file or pass a string to the parser
+    cal_file = File.open("single_event.ics")
+
+    # Parser returns an array of calendars because a single file
+    # can have multiple calendars.
+    cals = Icalendar.parse(cal_file)
+    cal = cals.first
+    
+    # Now you can access the cal object in just the same way I created it
+    event = cal.events.first
+
+    puts "start date-time: #{event.dtstart}"
+    puts "start date-time timezone: #{event.dtstart.icalendar_tzid}" if event.dtstart.is_a?(DateTime)
+    puts "summary: #{event.summary}"
+
+    # Some calendars contain non-standard parameters (e.g. Apple iCloud
+    # calendars). You can pass in a `strict` value when creating a new parser.
+    unstrict_parser = Icalendar::Parser.new(cal_file, false)
+    cal = unstrict_parser.parse()
+
+Finders
+---
+
+Often times in web apps and other interactive applications you'll need to
+lookup items in a calendar to make changes or get details.  Now you can find
+everything by the unique id automatically associated with all components.
+
+    cal = Calendar.new
+    10.times { cal.event } # Create 10 events with only default data.
+    some_event = cal.events[5] # Grab it from the array of events
+
+    # Use the uid as the key in your app
+    key = some_event.uid
+
+    # so later you can find it.
+    same_event = cal.find_event(key)
+
+Examples
+---
+
+Check the unit tests for examples of most things you'll want to do, but please
+send me example code or let me know what's missing.
+
+Download
+---
+
+The latest release version of this library can be found at
+
+* <http://rubygems.org/gems/icalendar>
+
+Installation
+---
+
+It's all about rubygems:
+
+    $ gem install icalendar
+
+Testing
+---
+
+To run the tests:
+
+    $ bundle install
+    $ rake test
+
+License
+---
+
+This library is released under the same license as Ruby itself.
+
+Support & Contributions
+---
+
+Please submit pull requests from a rebased topic branch and
+include tests for all bugs and features.

data/Rakefile

@@ -1,20 +1,10 @@
-require 'hoe'
-require 'fileutils'
-require './lib/icalendar'
+require 'bundler'
+Bundler::GemHelper.install_tasks
 
-Hoe.plugin :newgem
-Hoe.plugin :website
-Hoe.plugins.delete :gemcutter
-Hoe.plugin :rubyforge
-
-# Generate all the Rake tasks
-# Run 'rake -T' to see list of generated tasks (from gem root directory)
-$hoe = Hoe.spec 'icalendar' do
-  developer 'Ryan Ahearn', 'ryan.c.ahearn@gmail.com'
-  self.extra_rdoc_files += %w[COPYING GPL]
+require 'rake/testtask'
+Rake::TestTask.new do |t|
+  t.pattern = 'test/**/test*.rb'
+  t.verbose = true
 end
 
-if ENV['UNDER_HUDSON']
-  require 'ci/reporter/rake/test_unit'
-  task :test => ["ci:setup:testunit"]
-end
+task default: [:test, :build]

data/icalendar.gemspec

@@ -3,19 +3,27 @@ require 'icalendar/base'
 
 Gem::Specification.new do |s|
   s.authors = ['Ryan Ahearn']
+  s.email   = ['ryan.c.ahearn@gmail.com']
 
   s.name = "icalendar"
   s.version = Icalendar::VERSION
 
-  s.homepage = "http://icalendar.rubyforge.org/"
+  s.homepage = "https://github.com/icalendar/icalendar"
   s.platform = Gem::Platform::RUBY
   s.summary = "A ruby implementation of the iCalendar specification (RFC-2445)."
-  s.description = "Implements the iCalendar specification (RFC-2445) in Ruby.  This allows for the generation and parsing of .ics files, which are used by a variety of calendaring applications."
+  s.description = <<-EOD
+    Implements the iCalendar specification (RFC-2445) in Ruby.  This allows
+    for the generation and parsing of .ics files, which are used by a
+    variety of calendaring applications.
+  EOD
 
-  s.add_development_dependency 'hoe', '~> 3.5'
-  s.add_development_dependency 'newgem', '~> 1.5'
-  s.add_development_dependency 'rubyforge', '~> 2.0'
-  s.add_development_dependency 'rdoc', '~> 4.0'
+  s.files = `git ls-files`.split "\n"
+  s.test_files = `git ls-files -- {test,spec,features}/*`.split "\n"
+  s.executables = `git ls-files -- bin/*`.split("\n").map { |f| File.basename f }
+  s.require_paths = ['lib']
+
+  s.add_development_dependency 'rake', '~> 10.0'
+  s.add_development_dependency 'bundler', '~> 1.3'
   s.add_development_dependency 'tzinfo', '~> 0.3'
 end
 

data/lib/icalendar/base.rb

@@ -11,7 +11,7 @@ require 'logger'
 
 module Icalendar #:nodoc:
 
-  VERSION = '1.4.1'
+  VERSION = '1.4.2'
 
   # A simple error class to differentiate iCalendar library exceptions
   # from ruby language exceptions or others.

data/lib/icalendar/component.rb

@@ -180,13 +180,13 @@ module Icalendar
         # Possible parameter values
         unless val.empty?
           s << "="
-          sep = "" # First entry comes after = sign, but then we need commas
-          val.each do |pval|
+          s << val.map do |pval|
             if pval.respond_to? :to_ical
-              s << sep << pval.to_ical
-              sep = ","
+              param = pval.to_ical
+              param = %|"#{param}"| unless param =~ %r{\A#{Parser::QSTR}\z|\A#{Parser::PTEXT}\z}
+              param
             end
-          end
+          end.compact.join(',')
         end
       end
       s
@@ -429,9 +429,9 @@ module Icalendar
 
     public
 
-    def respond_to?(method_name)
+    def respond_to?(method_name, include_all=false)
       if method_name.to_s.downcase =~ /x_.*/
-       true
+        true
       else
         super
       end

data/test/fixtures/nonstandard.ics

@@ -0,0 +1,24 @@
+BEGIN:VCALENDAR
+VERSION:2.0
+PRODID:bsprodidfortestabc123
+BEGIN:VEVENT
+UID:bsuidfortestabc123
+ORGANIZER:mailto:joebob@random.net
+ATTACH:http://bush.sucks.org/impeach/him.rhtml
+ATTACH:http://corporations-dominate.existence.net/why.rhtml
+SUMMARY:This is a really long summary
+  to test the method of unfolding lines\,
+  so I'm just going to ma
+ ke it
+  a whol
+ e
+  bunch of lines.
+CLASS:PRIVATE
+PRIORITY:2
+CUSTOMFIELD:Not properly noted as custom with X- prefix.
+GEO:37.386013;-122.0829322
+DTSTART;TZID=US-Mountain:20050120T170000
+DTEND:20050120T184500
+DTSTAMP:20050118T211523Z
+END:VEVENT
+END:VCALENDAR

data/test/test_parameter.rb

@@ -38,6 +38,23 @@ class TestParameter < Test::Unit::TestCase
     end
   end
 
+  def test_unquoted_property_parameters
+    params = {'ALTREP' => ['"http://my.language.net"'],
+              'LANGUAGE' => ['SPANISH:CATILLAN']}
+    expected_params = {'ALTREP' => ['"http://my.language.net"'],
+                       'LANGUAGE' => ['"SPANISH:CATILLAN"']}
+    @event.summary('This is a test summary.', params)
+
+    assert_equal params, @event.summary.ical_params
+
+    @cal.add_event @event
+    cal_str = @cal.to_ical
+
+    cals = Icalendar::Parser.new(cal_str).parse
+    event = cals.first.events.first
+    assert_equal expected_params, event.summary.ical_params
+  end
+
   def test_nonstandard_property_parameters
     params = {'CUSTOM' => ['yours']}
     @event.priority(2, params)

metadata

@@ -1,110 +1,74 @@
 --- !ruby/object:Gem::Specification
 name: icalendar
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 1.4.2
 platform: ruby
 authors:
 - Ryan Ahearn
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-26 00:00:00.000000000 Z
+date: 2013-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rubyforge
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: 2.0.4
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: 2.0.4
-- !ruby/object:Gem::Dependency
-  name: rdoc
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '10.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '10.0'
 - !ruby/object:Gem::Dependency
-  name: newgem
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 1.5.3
+        version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 1.5.3
+        version: '1.3'
 - !ruby/object:Gem::Dependency
-  name: hoe
+  name: tzinfo
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '3.6'
+        version: '0.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '3.6'
-description: "This is a Ruby library for dealing with iCalendar files.  Rather than\nexplaining
-  myself, here is the introduction from RFC-2445, which\ndefines the format:\n\nThe
-  use of calendaring and scheduling has grown considerably in the\nlast decade. Enterprise
-  and inter-enterprise business has become\ndependent on rapid scheduling of events
-  and actions using this\ninformation technology. However, the longer term growth
-  of calendaring\nand scheduling, is currently limited by the lack of Internet standards\nfor
-  the message content types that are central to these knowledgeware\napplications.
-  This memo is intended to progress the level of\ninteroperability possible between
-  dissimilar calendaring and\nscheduling applications. This memo defines a MIME content
-  type for\nexchanging electronic calendaring and scheduling information. The\nInternet
-  Calendaring and Scheduling Core Object Specification, or\niCalendar, allows for
-  the capture and exchange of information normally\nstored within a calendaring and
-  scheduling application; such as a\nPersonal Information Manager (PIM) or a Group
-  Scheduling product. \n\nThe iCalendar format is suitable as an exchange format between\napplications
-  or systems. The format is defined in terms of a MIME\ncontent type. This will enable
-  the object to be exchanged using\nseveral transports, including but not limited
-  to SMTP, HTTP, a file\nsystem, desktop interactive protocols such as the use of
-  a memory-\nbased clipboard or drag/drop interactions, point-to-point asynchronous\ncommunication,
-  wired-network transport, or some form of unwired\ntransport such as infrared might
-  also be used."
+        version: '0.3'
+description: |2
+      Implements the iCalendar specification (RFC-2445) in Ruby.  This allows
+      for the generation and parsing of .ics files, which are used by a
+      variety of calendaring applications.
 email:
 - ryan.c.ahearn@gmail.com
 executables: []
 extensions: []
-extra_rdoc_files:
-- History.txt
-- Manifest.txt
-- README.rdoc
-- website/index.txt
-- COPYING
-- GPL
+extra_rdoc_files: []
 files:
+- .gitignore
 - COPYING
 - GPL
+- Gemfile
 - History.txt
-- Manifest.txt
-- README.rdoc
+- README.md
 - Rakefile
-- config/website.yml
 - examples/create_cal.rb
 - examples/parse_cal.rb
 - examples/single_event.ics
@@ -128,16 +92,14 @@ files:
 - lib/icalendar/tzinfo.rb
 - lib/meta.rb
 - script/console
-- script/destroy
-- script/generate
 - script/recur1.ics
 - script/tryit.rb
-- script/txt2html
 - test/component/test_event.rb
 - test/component/test_timezone.rb
 - test/component/test_todo.rb
 - test/fixtures/folding.ics
 - test/fixtures/life.ics
+- test/fixtures/nonstandard.ics
 - test/fixtures/simplecal.ics
 - test/fixtures/single_event.ics
 - test/interactive.rb
@@ -148,20 +110,17 @@ files:
 - test/test_helper.rb
 - test/test_parameter.rb
 - test/test_parser.rb
+- test/test_tzinfo.rb
 - website/index.html
 - website/index.txt
 - website/javascripts/rounded_corners_lite.inc.js
 - website/stylesheets/screen.css
 - website/template.html.erb
-- test/test_tzinfo.rb
-- .gemtest
-homepage: http://github.com/icalendar/icalendar
+homepage: https://github.com/icalendar/icalendar
 licenses: []
 metadata: {}
 post_install_message: 
-rdoc_options:
-- --main
-- README.rdoc
+rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -175,15 +134,22 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: icalendar
+rubyforge_project: 
 rubygems_version: 2.0.3
 signing_key: 
 specification_version: 4
-summary: This is a Ruby library for dealing with iCalendar files
+summary: A ruby implementation of the iCalendar specification (RFC-2445).
 test_files:
 - test/component/test_event.rb
 - test/component/test_timezone.rb
 - test/component/test_todo.rb
+- test/fixtures/folding.ics
+- test/fixtures/life.ics
+- test/fixtures/nonstandard.ics
+- test/fixtures/simplecal.ics
+- test/fixtures/single_event.ics
+- test/interactive.rb
+- test/read_write.rb
 - test/test_calendar.rb
 - test/test_component.rb
 - test/test_conversions.rb

data/Manifest.txt

@@ -1,55 +0,0 @@
-COPYING
-GPL
-History.txt
-Manifest.txt
-README.rdoc
-Rakefile
-config/website.yml
-examples/create_cal.rb
-examples/parse_cal.rb
-examples/single_event.ics
-icalendar.gemspec
-lib/hash_attrs.rb
-lib/icalendar.rb
-lib/icalendar/base.rb
-lib/icalendar/calendar.rb
-lib/icalendar/component.rb
-lib/icalendar/component/alarm.rb
-lib/icalendar/component/event.rb
-lib/icalendar/component/freebusy.rb
-lib/icalendar/component/journal.rb
-lib/icalendar/component/timezone.rb
-lib/icalendar/component/todo.rb
-lib/icalendar/conversions.rb
-lib/icalendar/helpers.rb
-lib/icalendar/parameter.rb
-lib/icalendar/parser.rb
-lib/icalendar/rrule.rb
-lib/icalendar/tzinfo.rb
-lib/meta.rb
-script/console
-script/destroy
-script/generate
-script/recur1.ics
-script/tryit.rb
-script/txt2html
-test/component/test_event.rb
-test/component/test_timezone.rb
-test/component/test_todo.rb
-test/fixtures/folding.ics
-test/fixtures/life.ics
-test/fixtures/simplecal.ics
-test/fixtures/single_event.ics
-test/interactive.rb
-test/read_write.rb
-test/test_calendar.rb
-test/test_component.rb
-test/test_conversions.rb
-test/test_helper.rb
-test/test_parameter.rb
-test/test_parser.rb
-website/index.html
-website/index.txt
-website/javascripts/rounded_corners_lite.inc.js
-website/stylesheets/screen.css
-website/template.html.erb

data/README.rdoc

@@ -1,286 +0,0 @@
-= iCalendar -- Internet calendaring, Ruby style
-
-* http://github.com/icalendar/icalendar
-
-== DESCRIPTION
-
-This is a Ruby library for dealing with iCalendar files.  Rather than
-explaining myself, here is the introduction from RFC-2445, which
-defines the format:
-
-The use of calendaring and scheduling has grown considerably in the
-last decade. Enterprise and inter-enterprise business has become
-dependent on rapid scheduling of events and actions using this
-information technology. However, the longer term growth of calendaring
-and scheduling, is currently limited by the lack of Internet standards
-for the message content types that are central to these knowledgeware
-applications. This memo is intended to progress the level of
-interoperability possible between dissimilar calendaring and
-scheduling applications. This memo defines a MIME content type for
-exchanging electronic calendaring and scheduling information. The
-Internet Calendaring and Scheduling Core Object Specification, or
-iCalendar, allows for the capture and exchange of information normally
-stored within a calendaring and scheduling application; such as a
-Personal Information Manager (PIM) or a Group Scheduling product. 
-
-The iCalendar format is suitable as an exchange format between
-applications or systems. The format is defined in terms of a MIME
-content type. This will enable the object to be exchanged using
-several transports, including but not limited to SMTP, HTTP, a file
-system, desktop interactive protocols such as the use of a memory-
-based clipboard or drag/drop interactions, point-to-point asynchronous
-communication, wired-network transport, or some form of unwired
-transport such as infrared might also be used.
-
-
-== EXAMPLES
-
-=== Probably want to start with this
-
-  require 'rubygems' # Unless you install from the tarball or zip.
-  require 'icalendar'
-  require 'date'
-
-  include Icalendar # Probably do this in your class to limit namespace overlap
-
-=== Creating calendars and events is easy.
-
-  # Create a calendar with an event (standard method)
-  cal = Calendar.new
-  cal.event do
-    dtstart       Date.new(2005, 04, 29)
-    dtend         Date.new(2005, 04, 28)
-    summary     "Meeting with the man."
-    description "Have a long lunch meeting and decide nothing..."
-    klass       "PRIVATE"
-  end
-
-  cal.publish
-
-=== Or you can make events like this
-  event = Event.new
-  event.start = DateTime.civil(2006, 6, 23, 8, 30)
-  event.summary = "A great event!"
-  cal.add_event(event)
-
-  event2 = cal.event  # This automatically adds the event to the calendar
-  event2.start = DateTime.civil(2006, 6, 24, 8, 30)
-  event2.summary = "Another great event!"
-
-  # Now with support for property parameters
-  params = {"ALTREP" =>['"http://my.language.net"'], "LANGUAGE" => ["SPANISH"]}
-
-  cal.event do
-    dtstart Date.new(2005, 04, 29)
-    dtend   Date.new(2005, 04, 28)
-    summary "This is a summary with params.", params
-  end
-
-  # We can output the calendar as a string to write to a file,
-  # network port, database etc.
-  cal_string = cal.to_ical
-  puts cal_string
-
-== ALARMS
-
-=== Within an event, you can create e-mail notification alarms like this...
-
-  cal.event.do
-    # ...other event properties
-    alarm do
-      action        "EMAIL"
-      description   "This is an event reminder" # email body (required)
-      summary       "Alarm notification"        # email subject (required)
-      attendees     %w(mailto:me@my-domain.com mailto:me-too@my-domain.com) # one or more email recipients (required)
-      add_attendee  "mailto:me-three@my-domain.com"
-      remove_attendee "mailto:me@my-domain.com"
-      trigger       "-PT15M" # 15 minutes before
-      add_attach    "ftp://host.com/novo-procs/felizano.exe", {"FMTTYPE" => "application/binary"} # email attachments (optional)
-    end
-
-    alarm do
-      action        "DISPLAY" # This line isn't necessary, it's the default
-      summary       "Alarm notification"
-      trigger       "-P1DT0H0M0S" # 1 day before
-    end
-
-    alarm do
-      action        "AUDIO"
-      trigger       "-PT15M"
-      add_attach    "Basso", {"VALUE" => ["URI"]}  # only one attach allowed (optional)
-    end
-  end
-
-  # Output
-
-  # BEGIN:VALARM
-  # ACTION:EMAIL
-  # ATTACH;FMTTYPE=application/binary:ftp://host.com/novo-procs/felizano.exe
-  # TRIGGER:-PT15M
-  # SUMMARY:Alarm notification
-  # DESCRIPTION:This is an event reminder
-  # ATTENDEE:mailto:me-too@my-domain.com
-  # ATTENDEE:mailto:me-three@my-domain.com
-  # END:VALARM
-  #
-  # BEGIN:VALARM
-  # ACTION:DISPLAY
-  # TRIGGER:-P1DT0H0M0S
-  # SUMMARY:Alarm notification
-  # END:VALARM
-  #
-  # BEGIN:VALARM
-  # ACTION:AUDIO
-  # ATTACH;VALUE=URI:Basso
-  # TRIGGER:-PT15M
-  # END:VALARM
-
-== Timezones
-
-  # Create a timezone definition (previous convention)
-  cal = Calendar.new
-  timezone = Icalendar::Timezone.new
-  daylight = Icalendar::Daylight.new
-  standard = Icalendar::Standard.new
-
-  timezone.timezone_id =            "America/Chicago"
-
-  daylight.timezone_offset_from =   "-0600"
-  daylight.timezone_offset_to =     "-0500"
-  daylight.timezone_name =          "CDT"
-  daylight.dtstart =                "19700308TO20000"
-  daylight.recurrence_rules =       ["FREQ=YEARLY;BYMONTH=3;BYDAY=2SU"]
-
-  standard.timezone_offset_from =   "-0500"
-  standard.timezone_offset_to =     "-0600"
-  standard.timezone_name =          "CST"
-  standard.dtstart =                "19701101T020000"
-  standard.recurrence_rules =       ["YEARLY;BYMONTH=11;BYDAY=1SU"]
-
-  timezone.add(daylight)
-  timezone.add(standard)
-  cal.add(timezone)
-
-  # Now, you can make timezones like this
-  cal = Calendar.new
-  cal.timezone do
-    timezone_id             "America/Chicago"
-
-    daylight do
-      timezone_offset_from  "-0600"
-      timezone_offset_to    "-0500"
-      timezone_name         "CDT"
-      dtstart               "19700308TO20000"
-      add_recurrence_rule   "FREQ=YEARLY;BYMONTH=3;BYDAY=2SU"
-    end
-
-    standard do
-      timezone_offset_from  "-0500"
-      timezone_offset_to    "-0600"
-      timezone_name         "CST"
-      dtstart               "19701101T020000"
-      add_recurrence_rule   "YEARLY;BYMONTH=11;BYDAY=1SU"
-    end
-  end
-
-  # Both conventions output
-
-  # BEGIN:VTIMEZONE
-  # TZID:America/Chicago
-  # BEGIN:DAYLIGHT
-  # TZOFFSETFROM:-0600
-  # TZOFFSETTO:-0500
-  # TZNAME:CDT
-  # DTSTART:19700308T020000
-  # RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=2SU
-  # END:DAYLIGHT
-  # BEGIN:STANDARD
-  # TZOFFSETFROM:-0500
-  # TZOFFSETTO:-0600
-  # TZNAME:CST
-  # DTSTART:19701101T020000
-  # RRULE:FREQ=YEARLY;BYMONTH=11;BYDAY=1SU
-  # END:STANDARD
-  # END:VTIMEZONE
-
-== Unicode
-Add `$KCODE = 'u'` to make icalender work correctly with Utf8 texts
-
-== Parsing iCalendars:
-
-  # Open a file or pass a string to the parser
-  cal_file = File.open("single_event.ics")
-
-  # Parser returns an array of calendars because a single file
-  # can have multiple calendars.
-  cals = Icalendar.parse(cal_file)
-  cal = cals.first
-  
-  # Now you can access the cal object in just the same way I created it
-  event = cal.events.first
-
-  puts "start date-time: " + event.dtstart
-  puts "summary: " + event.summary
-
-  # Some calendars contain non-standard parameters (e.g. Apple iCloud
-  # calendars). You can pass in a `strict` value when creating a new parser.
-  unstrict_parser = Icalendar::Parser.new(cal_file, false)
-  cal = unstrict_parser.parse()
-
-== Finders:
-
-Often times in web apps and other interactive applications you'll need to
-lookup items in a calendar to make changes or get details.  Now you can find
-everything by the unique id automatically associated with all components.
-
-  cal = Calendar.new
-  10.times { cal.event } # Create 10 events with only default data.
-  some_event = cal.events[5] # Grab it from the array of events
-
-  # Use the uid as the key in your app
-  key = some_event.uid
-
-  # so later you can find it.
-  same_event = cal.find_event(key)
-
-== Examples:
-
-Check the unit tests for examples of most things you'll want to do, but please
-send me example code or let me know what's missing.
-
-== Download
-
-The latest release version of this library can be found at
-
-* http://rubyforge.org/projects/icalendar/
-
-Documentation can be found at
-
-* http://icalendar.rubyforge.org/
-
-== Installation
-
-It's all about rubygems:
-
-$ sudo gem install icalendar
-
-== Testing
-
-The gem `hoe` is required as well:
-
-  gem install hoe
-
-To run the tests:
-
-  rake test
-
-== License
-
-This library is released under the same license as Ruby itself.
-
-== Support & Contributions
-
-The iCalendar library homepage is http://icalendar.rubyforge.org/
-
-There is an icalendar-devel@rubyforge.org mailing list that can be
-used for asking questions, making comments or submitting patches.

data/config/website.yml

@@ -1,2 +0,0 @@
-host: rcahearn@rubyforge.org
-remote_dir: /var/www/gforge-projects/icalendar

data/script/destroy

@@ -1,14 +0,0 @@
-#!/usr/bin/env ruby
-APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
-
-begin
-  require 'rubigen'
-rescue LoadError
-  require 'rubygems'
-  require 'rubigen'
-end
-require 'rubigen/scripts/destroy'
-
-ARGV.shift if ['--help', '-h'].include?(ARGV[0])
-RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
-RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -1,14 +0,0 @@
-#!/usr/bin/env ruby
-APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
-
-begin
-  require 'rubigen'
-rescue LoadError
-  require 'rubygems'
-  require 'rubigen'
-end
-require 'rubigen/scripts/generate'
-
-ARGV.shift if ['--help', '-h'].include?(ARGV[0])
-RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
-RubiGen::Scripts::Generate.new.run(ARGV)

data/script/txt2html

@@ -1,71 +0,0 @@
-#!/usr/bin/env ruby
-
-load File.dirname(__FILE__) + "/../Rakefile"
-require 'rubyforge'
-require 'redcloth'
-require 'syntax/convertors/html'
-require 'erb'
-
-download = "http://rubyforge.org/projects/#{$hoe.rubyforge_name}"
-version  = $hoe.version
-
-def rubyforge_project_id
-  RubyForge.new.configure.autoconfig["group_ids"][$hoe.rubyforge_name]
-end
-
-class Fixnum
-  def ordinal
-    # teens
-    return 'th' if (10..19).include?(self % 100)
-    # others
-    case self % 10
-    when 1 then return 'st'
-    when 2 then return 'nd'
-    when 3 then return 'rd'
-    else    return 'th'
-    end
-  end
-end
-
-class Time
-  def pretty
-    return "#{mday}#{mday.ordinal} #{strftime('%B')} #{year}"
-  end
-end
-
-def convert_syntax(syntax, source)
-  return Syntax::Convertors::HTML.for_syntax(syntax).convert(source).gsub(%r!^<pre>|</pre>$!,'')
-end
-
-if ARGV.length >= 1
-  src, template = ARGV
-  template ||= File.join(File.dirname(__FILE__), '/../website/template.html.erb')
-else
-  puts("Usage: #{File.split($0).last} source.txt [template.html.erb] > output.html")
-  exit!
-end
-
-template = ERB.new(File.open(template).read)
-
-title = nil
-body = nil
-File.open(src) do |fsrc|
-  title_text = fsrc.readline
-  body_text_template = fsrc.read
-  body_text = ERB.new(body_text_template).result(binding)
-  syntax_items = []
-  body_text.gsub!(%r!<(pre|code)[^>]*?syntax=['"]([^'"]+)[^>]*>(.*?)</\1>!m){
-    ident = syntax_items.length
-    element, syntax, source = $1, $2, $3
-    syntax_items << "<#{element} class='syntax'>#{convert_syntax(syntax, source)}</#{element}>"
-    "syntax-temp-#{ident}"
-  }
-  title = RedCloth.new(title_text).to_html.gsub(%r!<.*?>!,'').strip
-  body = RedCloth.new(body_text).to_html
-  body.gsub!(%r!(?:<pre><code>)?syntax-temp-(\d+)(?:</code></pre>)?!){ syntax_items[$1.to_i] }
-end
-stat = File.stat(src)
-created = stat.ctime
-modified = stat.mtime
-
-$stdout << template.result(binding)