vobject 0.1.0 → 1.0.2

data/Gemfile

@@ -1,4 +1,4 @@
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 # Specify your gem's dependencies in ruby-vobject.gemspec
 gemspec

data/LICENSE.txt

@@ -1,21 +1,25 @@
-The MIT License (MIT)
+BSD 2-Clause License
 
-Copyright (c) 2017 Peter Tam
+Copyright (c) 2018, Ribose
+All rights reserved.
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
 
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.adoc

@@ -0,0 +1,151 @@
+== Ruby vObject parser
+
+image:https://img.shields.io/gem/v/ruby-vobject.svg["Gem Version", link="https://rubygems.org/gems/vobject"]
+image:https://github.com/riboseinc/ruby-vobject/workflows/macos/badge.svg["Build Status (macOS)", link="https://github.com/riboseinc/ruby-vobject/actions?workflow=macos"]
+image:https://github.com/riboseinc/ruby-vobject/workflows/ubuntu/badge.svg["Build Status (ubuntu)", link="https://github.com/riboseinc/ruby-vobject/actions?workflow=ubuntu"]
+image:https://github.com/riboseinc/ruby-vobject/workflows/windows/badge.svg["Build Status (Windows)", link="https://github.com/riboseinc/ruby-vobject/actions?workflow=windows"]
+image:https://codeclimate.com/github/riboseinc/ruby-vobject/badges/gpa.svg["Code Climate", link="https://codeclimate.com/github/riboseinc/ruby-vobject"]
+image:https://img.shields.io/github/issues-pr-raw/riboseinc/ruby-vobject.svg["Pull Requests", link="https://github.com/riboseinc/ruby-vobject/pulls"]
+image:https://img.shields.io/github/commits-since/riboseinc/ruby-vobject/latest.svg["Commits since latest",link="https://github.com/riboseinc/ruby-vobject/releases"]
+
+
+The main purpose of the gem is to parse vobject formatted text into a ruby
+hash format. Currently there are two possiblities of vobjects, namely
+iCalendar (https://tools.ietf.org/html/rfc5545) and vCard
+(https://tools.ietf.org/html/rfc6350). This gem parses iCalendar objects
+and vCard objects in versions 3.0 and 4.0, together with any subsequent
+additions to those specifications in other RFCs (see below).
+
+A secondary purpose is to create a normalised form of Vobjects (iCalendars
+and vCards version 4.0), which can be used to compare two Vobjects with minor
+formatting differences
+
+NOTE: This gem used to be named `ruby-vobject` (from versions 0.1.0 to 1.0.1),
+but for clarity purposes it is now simply called `vobject` (from version 1.0.2
+onwards).
+
+== Installation
+
+Add this line to your application's Gemfile:
+
+[source,ruby]
+----
+gem 'vobject'
+----
+
+And then execute:
+
+[source,console]
+----
+$ bundle
+----
+
+Or install it yourself as:
+
+[source,console]
+----
+$ gem install vobject
+----
+
+== Usage
+
+[source,ruby]
+----
+require 'vcalendar'
+require 'JSON'
+require 'pp'
+
+ics = File.read "spec/examples/vcalendar/timezones/America/Denver.ics"
+# parse VCalendar into native object structure, with strict validation 
+# (raises exception on any deviation from the spec)
+pp Vcalendar.parse(ics, true)
+# parse VCalendar into native object structure, without strict validation 
+# (errors other than syntax errors are logged, but object still parses)
+pp Vcalendar.parse(ics, false)
+# list any errors
+pp Vcalendar.parse(ics, false).get_errors
+# convert VCalendar into Ruby hash
+pp Vcalendar.parse(ics).to_hash
+# convert VCalendar into JSON
+pp JSON.parse(Vcalendar.parse(ics).to_json)
+# convert VCalendar into VCalendar text
+print Vcalendar.parse(ics).to_s
+# convert VCalendar into normalised VCalendar text
+print Vcalendar.parse(ics).to_norm
+----
+
+[source,ruby]
+----
+require 'vcard'
+require 'JSON'
+require 'pp'
+
+vcf = File.read "spec/examples/vcard/vcard3.vcf"
+# parse Vcard into native object structure (version 3), strict validation
+pp Vcard.parse(vcf, '3.0', true)
+# parse Vcard into Ruby hash
+pp Vcard.parse(vcf, '3.0', true).to_hash
+# parse Vcard into JSON
+pp JSON.parse(Vcard.parse(vcf, '3.0', true).to_json)
+# parse Vcard into VCard text
+print Vcard.parse(vcf, '3.0', true).to_s
+vcf = File.read "spec/examples/vcard/example61.vcf"
+# parse Vcard into native object structure (version 4), lax validation
+pp Vcard.parse(vcf, '4.0', false)
+# list any errors
+pp Vcard.parse(vcf, '4.0', false).get_errors
+----
+
+* Recognises all of VCard v3.0, Vcard v4.0, and Vcalendar v2.0
+* Components, properties, and parameters are all objects.
+** Each type of component is a distinct object.
+* The parameters of a property are represented as an array of parameter objects.
+* If a property has multiple values, given on separate lines, they are represented
+as an array of value properties. Each value hash may have its own parameters.
+* The values of properties are also typed objects.
+* Objects can be parsed from text files.
+* Objects can be populated from hashes of property value objects.
+* Objects can be converted to Ruby hashes with native property value types (`.to_hash`), JSON objects with the same value types (`.to_json`), and round-tripped back to ICAL/VCARD string representations (`.to_s`). 
+* The normalised form of Vobjects (`.to_norm`) applies normalising conventions to the string representation; most notably presenting elements of a vCard in sorted order.
+** Normalisation follows the draft RFC `draft-calconnect-vobject-and-normalization`.
+* Validation can be strict or lax. 
+** If strict, an exception is raised on any syntax error, type mismatch, or other mismatch to the specification, such as mandatory elements.
+** If lax, an exception is still raised on syntax errors, but other issues are listed in an error field of the resulting object.
+* Normalisation follows the draft RFC `draft-calconnect-vobject-and-normalization`.
+
+Running spec:
+
+[source,console]
+----
+bundle exec rspec
+----
+
+== Implementation
+
+This gem is implemented using ttps://github.com/luikore/rsec[Rsec], a very fast PEG grammar based on StringScanner.
+
+== Coverage
+
+This tool is intended as a reference implementation, and it is very strict in its conformance: it requires all rules for parameter coocurrence, 
+property typing, parameter typing, permitted properties within components, etc to be met by objects. 
+
+The tool only parses one object at a time, and does not parse Vobject streams.
+
+This tool supports v2.0 iCal as specified in RFC 5545, and as updated in RFC 5546 (registry for values of METHOD and REQUEST-STATUS),
+RFC 6868 (caret escapes for parameter values), RFC 7529 (non-Gregorian Calendars), RFC 7953 (VAVAILABILITY component), and
+RFC 7986 (new properties).
+
+This tool supports v3.0 vCard as specified in RFC 2425 and RFC 2426, and as updated in RFC 2739 (calendar attributes) and RFC 4770 (extensions for Instant Messaging). It allows for the VCARD 2.1 style specification of PREF parameters in RFC 2739.
+
+This tool supports v4.0 vCard as specified in RFC 6350, and as updated in RFC 6868 (parameter encoding), RFC 6474 (place of birth, place and date of death), RFC 6715 (OMA CAB extensions), and RF 6473 (KIND:application).
+
+
+== Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/riboseinc/vobject. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the http://contributor-covenant.org[Contributor Covenant] code of conduct.
+
+
+== License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -3,4 +3,4 @@ require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
+task default: :spec

data/lib/c.rb

@@ -0,0 +1,173 @@
+require "rsec"
+require "set"
+require "uri"
+require_relative "vobject/vcalendar/propertyvalue"
+
+module C
+  # definitions common to classes
+  SIGN = /[+-]/i.r
+  BOOLEAN = /TRUE/i.r.map { true } | /FALSE/i.r.map { false }
+  IANATOKEN = /[a-zA-Z\d\-]+/.r
+  vendorid_vcal = /[a-zA-Z0-9][a-zA-Z0-9][a-zA-Z0-9]/.r
+  XNAME_VCAL = seq(/[xX]-/, vendorid_vcal, "-", IANATOKEN).map(&:join)
+  vendorid_vcard = /[a-zA-Z0-9]+/.r # different from iCal
+  XNAME_VCARD = seq(/[xX]-/, vendorid_vcard, "-", IANATOKEN).map(&:join)
+  TEXT = /([ \t\u0021\u0023-\u002b\u002d-\u0039\u003c-\u005b\u005d-\u007e\u0080-\u3ffff:"]|\\[nN;,\\])*/.r
+  TEXT3 = /([ \t\u0021\u0023-\u002b\u002d-\u0039\u003c-\u005b\u005d-\u007e\u0080-\u3ffff:"]|\\[nN;,\\]?)*/.r
+  TEXT4 = /([ \t\u0021\u0023-\u002b\u002d-\u005b\u005d-\u007e\u0080-\u3ffff:"]|\\[nN,\\])*/.r
+  COMPONENT4 = /([ \t\u0021\u0023-\u002b\u002d-\u003a\u003c-\u005b\u005d-\u007e\u0080-\u3ffff:"]|\\[nN,;\\])*/.r
+  DATE = seq(/[0-9]{4}/.r, /[0-9]{2}/.r, /[0-9]{2}/.r) do |yy, mm, dd|
+    Vobject::Vcalendar::PropertyValue::Date.new Time.utc(yy, mm, dd)
+  end
+  DATE_TIME = seq(/[0-9]{4}/.r, /[0-9]{2}/.r, /[0-9]{2}/.r << "T".r,
+                  /[0-9]{2}/.r, /[0-9]{2}/.r, /[0-9]{2}/.r, /Z/i.r._?) do |yy, mm, dd, h, m, s, z|
+    if z.empty?
+      #Vobject::Vcalendar::PropertyValue::DateTimeLocal.new(time: Time.local(yy, mm, dd, h, m, s), zone: "")
+      Vobject::Vcalendar::PropertyValue::DateTimeLocal.new(year: yy, month: mm, day: dd, hour: h, min: m, sec: s, zone: "")
+    else
+      #Vobject::Vcalendar::PropertyValue::DateTimeUTC.new(time: Time.utc(yy, mm, dd, h, m, s), zone: "Z")
+      Vobject::Vcalendar::PropertyValue::DateTimeUTC.new(year: yy, month: mm, day: dd, hour: h, min: m, sec: s, zone: "Z")
+    end
+  end
+  DATE_TIME_UTC = seq(/[0-9]{4}/.r, /[0-9]{2}/.r, /[0-9]{2}/.r << "T".r,
+                      /[0-9]{2}/.r, /[0-9]{2}/.r, /[0-9]{2}/.r, /Z/i.r._?) do |yy, mm, dd, h, m, s, _z|
+    #Vobject::Vcalendar::PropertyValue::DateTimeUTC.new(time: Time.utc(yy, mm, dd, h, m, s), zone: "Z")
+      Vobject::Vcalendar::PropertyValue::DateTimeUTC.new(year: yy, month: mm, day: dd, hour: h, min: m, sec: s, zone: "Z")
+  end
+  TIME	= seq(/[0-9]{2}/.r, /[0-9]{2}/.r, /[0-9]{2}/.r, /Z/i.r._?) do |h, m, s, z|
+    hash = { hour: h, min: m, sec: s }
+    hash[:utc] = not(z.empty?)
+    hash
+  end
+  ICALPROPNAMES	= /BEGIN/i.r | /END/i.r | /CALSCALE/i.r | /METHOD/i.r | /VERSION/i.r |
+    /ATTACH/i.r | /IMAGE/i.r | /CATEGORIES/i.r | /RESOURCERS/i.r | /CLASS/i.r |
+    /COMMENT/i.r | /DESCRIPTION/i.r | /LOCATION/i.r | /SUMMARY/i.r | /TZID/i.r |
+    /TZNAME/i.r | /CONTACT/i.r | /RELATED-TO/i.r | /UID/i.r | /PRODID/i.r | /NAME/i.r |
+    /GEO/i.r | /PERCENT-COMPLETE/i.r | /PRIORITY/i.r | /STATUS/i.r | /COMPLETED/i.r |
+    /CREATEED/i.r | /DTSTAMP/i.r | /LAST-MODIFIED/i.r | /DTEND/i.r | /DTSTART/i.r |
+    /DUE/i.r | /RECURRENCE-ID/i.r | /EXDATE/i.r | /RDATE/i.r | /TRIGGER/i.r |
+    /FREEBUSY/i.r | /TRANSP/i.r | /TZOFFSETFROM/i.r | /TZOFFSETTO/i.r |
+    /TZURI/i.r | /URL/i.r | /SOURCE/i.r | /CONFERENCE/i.r | /ATTENDEE/i.r |
+    /ORGANIZER/i.r | /RRULE/i.r | /ACTION/i.r | /REPEAT/i.r | /SEQUENCE/i.r |
+    /REQUEST-STATUS/i.r | /BUSYTYPE/i.r | /REFRESH-INTERVAL/i.r | /COLOR/i.r
+  VCARD3PROPNAMES	= /BEGIN/i.r | /END/i.r | /SOURCE/i.r | /NAME/i.r | /PROFILE/i.r |
+    /VERSION/i.r | /URL/i.r | /FN/i.r | /NICKNAME/i.r | /LABEL/i.r | /EMAIL/i.r |
+    /MAILER/i.r | /TITLE/i.r | /ROLE/i.r | /NOTE/i.r | /PRODID/.r | /SORT-STRING/i.r |
+    /UID/i.r | /CLASS/i.r | /ORG/i.r | /CATEGORIES/i.r | /N/i.r | /PHOTO/i.r |
+    /LOGO/i.r | /SOUND/i.r | /KEY/i.r | /BDAY/i.r | /REV/i.r | /ADR/i.r |
+    /TEL/i.r | /TZ/i.r | /GEO/i.r | /AGENT/i.r | /IMPP/i.r |
+    /FBURL/i.r | /CALADRURI/i.r | /CALURI/i.r | /CAPURI/i.r
+  VCARD4PROPNAMES	= /SOURCE/i.r | /KIND/i.r | /FN/i.r | /NICKNAME/i.r | /NOTE/i.r | /N/i.r |
+    /PHOTO/i.r | /BDAY/i.r | /ANNIVERSARY/i.r | /GENDER/i.r | /ADR/i.r |
+    /TEL/i.r | /EMAIL/i.r | /IMPP/i.r | /LANG/i.r | /TZ/i.r |
+    /GEO/i.r | /TITLE/i.r | /ROLE/i.r | /LOGO/i.r | /ORG/i.r |
+    /MEMBER/i.r | /RELATED/i.r | /CATEGORIES/i.r | /PRODID/i.r |
+    /REV/i.r | /SOUND/i.r | /UID/i.r | /CLIENTPIDMAP/i.r | /URL/i.r |
+    /KEY/i.r | /FBURL/i.r | /CALADRURI/i.r | /CALURI/i.r | /XML/i.r |
+    /BIRTHPLACE/i.r | /DEATHPLACE/i.r | /DEATHDATE/i.r | /EXPERTISE/i.r |
+    /HOBBY/i.r | /INTEREST/i.r | /ORG-DIRECTORY/i.r |
+    beginend	= /BEGIN/i.r | /END/i.r
+  NAME_VCAL = C::XNAME_VCAL | seq("".r ^ beginend, C::IANATOKEN)[1]
+  NAME_VCARD = C::XNAME_VCARD | seq("".r ^ beginend, C::IANATOKEN)[1]
+  durday = seq(/[0-9]+/.r, "D") { |d, _| { days: d.to_i } }
+  dursecond = seq(/[0-9]+/.r, "S") { |d, _| { seconds: d.to_i } }
+  durminute = seq(/[0-9]+/.r, "M", dursecond._?) do |d, _, s|
+    hash =	{ minutes: d.to_i }
+    hash = hash.merge s[0] unless s.empty?
+    hash
+  end
+  durhour = seq(/[0-9]+/.r, "H", durminute._?) do |d, _, m|
+    hash =	{ hours: d.to_i }
+    hash = hash.merge m[0] unless m.empty?
+    hash
+  end
+  durweek = seq(/[0-9]+/.r, "W") { |d, _| { weeks: d.to_i } }
+  durtime1 = durhour | durminute | dursecond
+  durtime = seq("T", durtime1) { |_, d| d }
+  durdate = seq(durday, durtime._?) do |d, t|
+    d = d.merge t[0] unless t.empty?
+    d
+  end
+  duration1 = durdate | durtime | durweek
+  DURATION = seq(SIGN._?, "P", duration1) do |s, _, d|
+    d[:sign] = s[0] unless s.empty?
+    d
+  end
+
+  non_ascii = /[\u0080-\u3ffff]/
+  wsp = /[ \t]/.r
+  q_safe_char_vcal = wsp | /[\u0021\u0023-\u007e]/ | non_ascii
+  safe_char_vcal = wsp | /[\u0021\u0023-\u0039\u003c-\u007e]/ | non_ascii
+  q_safe_char_vcard = wsp | /[!\u0023-\u007e]/ | non_ascii
+  safe_char_vcard = wsp | /[!\u0023-\u0039\u003c-\u007e]/ | non_ascii
+  v_char = /[\u0021-\u007e]/.r
+  value_char = wsp | v_char | non_ascii
+
+  QUOTEDSTRING_VCAL = seq(/"/.r >> q_safe_char_vcal.star <<
+                          /"/.r) { |q| q.join("") }
+  PTEXT_VCAL = safe_char_vcal.star.map(&:join)
+  QUOTEDSTRING_VCARD = seq(/"/.r >> q_safe_char_vcard.star <<
+                           /"/.r) { |q| q.join("") }
+  PTEXT_VCARD = safe_char_vcard.star.map(&:join)
+  VALUE = value_char.star.map(&:join)
+
+  rfc5646irregular = /en-GB-oed/i.r | /i-ami/i.r | /i-bnn/i.r | /i-default/i.r | /i-enochian/i.r |
+    /i-hak/i.r | /i-klingon/i.r | /i-lux/i.r | /i-mingo/i.r |
+    /i-navajo/i.r | /i-pwn/i.r | /i-tao/i.r | /i-tay/i.r |
+    /i-tsu/i.r | /sgn-BE-FR/i.r | /sgn-BE-NL/i.r | /sgn-CH-DE/i.r
+  rfc5646regular = /art-lojban/i.r | /cel-gaulish/i.r | /no-bok/i.r | /no-nyn/i.r |
+    /zh-guoyu/i.r | /zh-hakka/i.r | /zh-min/i.r | /zh-min-nan/i.r |
+    /zh-xiang/i.r
+  rfc5646grandfathered = rfc5646irregular | rfc5646regular
+  rfc5646privateuse1 = seq("-", /[0-9A-Za-z]{1,8}/.r)
+  rfc5646privateuse = seq("x", rfc5646privateuse1 * (1..-1))
+  rfc5646extension1 = seq("-", /[0-9A-Za-z]{2,8}/.r)
+  rfc5646extension = seq("-", /[0-9][A-WY-Za-wy-z]/.r, rfc5646extension1 * (1..-1))
+  rfc5646variant = seq("-", /[A-Za-z]{5,8}/.r) | seq("-", /[0-9][A-Za-z0-9]{3}/)
+  rfc5646region = seq("-", /[A-Za-z]{2}/.r) | seq("-", /[0-9]{3}/)
+  rfc5646script = seq("-", /[A-Za-z]{4}/.r)
+  rfc5646extlang = seq(/[A-Za-z]{3}/.r, /[A-Za-z]{3}/.r._?, /[A-Za-z]{3}/.r._?)
+  rfc5646language = seq(/[A-Za-z]{2,3}/.r, rfc5646extlang._?) | /[A-Za-z]{4}/.r | /[A-Za-z]{5,8}/.r
+  rfc5646langtag = seq(rfc5646language, rfc5646script._?, rfc5646region._?,
+                       rfc5646variant.star, rfc5646extension.star, rfc5646privateuse._?) do |a, b, c, d, e, f|
+    [a, b, c, d, e, f].flatten.join("")
+  end
+  RFC5646LANGVALUE = rfc5646langtag | rfc5646privateuse | rfc5646grandfathered
+
+  # https://www.w3.org/TR/2011/REC-css3-color-20110607/#svg-color
+  COLOR = /AliceBlue/i.r | /AntiqueWhite/i.r | /Aqua/i.r | /Aquamarine/i.r | /Azure/i.r | /Beige/i.r |
+    /Bisque/i.r | /Black/i.r | /BlanchedAlmond/i.r | /Blue/i.r | /BlueViolet/i.r | /Brown/i.r |
+    /BurlyWood/i.r | /CadetBlue/i.r | /Chartreuse/i.r | /Chocolate/i.r | /Coral/i.r |
+    /CornflowerBlue/i.r | /Cornsilk/i.r | /Crimson/i.r | /Cyan/i.r | /DarkBlue/i.r |
+    /DarkCyan/i.r | /DarkGoldenRod/i.r | /DarkGray/i.r | /DarkGrey/i.r | /DarkGreen/i.r |
+    /DarkKhaki/i.r | /DarkMagenta/i.r | /DarkOliveGreen/i.r | /DarkOrange/i.r | /DarkOrchid/i.r |
+    /DarkRed/i.r | /DarkSalmon/i.r | /DarkSeaGreen/i.r | /DarkSlateBlue/i.r | /DarkSlateGray/i.r |
+    /DarkSlateGrey/i.r | /DarkTurquoise/i.r | /DarkViolet/i.r | /DeepPink/i.r | /DeepSkyBlue/i.r |
+    /DimGray/i.r | /DimGrey/i.r | /DodgerBlue/i.r | /FireBrick/i.r | /FloralWhite/i.r | /ForestGreen/i.r |
+    /Fuchsia/i.r | /Gainsboro/i.r | /GhostWhite/i.r | /Gold/i.r | /GoldenRod/i.r | /Gray/i.r | /Grey/i.r |
+    /Green/i.r | /GreenYellow/i.r | /HoneyDew/i.r | /HotPink/i.r | /IndianRed/i.r | /Indigo/i.r |
+    /Ivory/i.r | /Khaki/i.r | /Lavender/i.r | /LavenderBlush/i.r | /LawnGreen/i.r | /LemonChiffon/i.r |
+    /LightBlue/i.r | /LightCoral/i.r | /LightCyan/i.r | /LightGoldenRodYellow/i.r | /LightGray/i.r |
+    /LightGrey/i.r | /LightGreen/i.r | /LightPink/i.r | /LightSalmon/i.r | /LightSeaGreen/i.r |
+    /LightSkyBlue/i.r | /LightSlateGray/i.r | /LightSlateGrey/i.r | /LightSteelBlue/i.r |
+    /LightYellow/i.r | /Lime/i.r | /LimeGreen/i.r | /Linen/i.r | /Magenta/i.r | /Maroon/i.r |
+    /MediumAquaMarine/i.r | /MediumBlue/i.r | /MediumOrchid/i.r | /MediumPurple/i.r |
+    /MediumSeaGreen/i.r | /MediumSlateBlue/i.r | /MediumSpringGreen/i.r | /MediumTurquoise/i.r |
+    /MediumVioletRed/i.r | /MidnightBlue/i.r | /MintCream/i.r | /MistyRose/i.r | /Moccasin/i.r |
+    /NavajoWhite/i.r | /Navy/i.r | /OldLace/i.r | /Olive/i.r | /OliveDrab/i.r | /Orange/i.r |
+    /OrangeRed/i.r | /Orchid/i.r | /PaleGoldenRod/i.r | /PaleGreen/i.r | /PaleTurquoise/i.r |
+    /PaleVioletRed/i.r | /PapayaWhip/i.r | /PeachPuff/i.r | /Peru/i.r | /Pink/i.r | /Plum/i.r |
+    /PowderBlue/i.r | /Purple/i.r | /RebeccaPurple/i.r | /Red/i.r | /RosyBrown/i.r | /RoyalBlue/i.r |
+    /SaddleBrown/i.r | /Salmon/i.r | /SandyBrown/i.r | /SeaGreen/i.r | /SeaShell/i.r | /Sienna/i.r |
+    /Silver/i.r | /SkyBlue/i.r | /SlateBlue/i.r | /SlateGray/i.r | /SlateGrey/i.r | /Snow/i.r |
+    /SpringGreen/i.r | /SteelBlue/i.r | /Tan/i.r | /Teal/i.r | /Thistle/i.r | /Tomato/i.r |
+    /Turquoise/i.r | /Violet/i.r | /Wheat/i.r | /White/i.r | /WhiteSmoke/i.r | /Yellow/i.r | /YellowGreen/i.r
+
+  UTC_OFFSET = seq(C::SIGN, /[0-9]{2}/.r, /[0-9]{2}/.r, /[0-9]{2}/.r._?) do |s, h, m, z|
+    h = { sign: s, hour: h, min: m }
+    h[:sec] = z[0] unless z.empty?
+    h
+  end
+  ZONE	= UTC_OFFSET.map { |u| u } |
+    /Z/i.r.map { "Z" }
+end

data/lib/error.rb

@@ -0,0 +1,19 @@
+# expand error reporting of Rsec
+class Rsec::ParseContext
+  def report_error(msg, source)
+    if pos <= @last_fail_pos
+      line = line @last_fail_pos
+      col = col @last_fail_pos
+      line_text = line_text @last_fail_pos
+      expect_tokens = Rsec::Fail.get_tokens @last_fail_mask
+      expects = ", expect token [ #{expect_tokens.join ' | '} ]"
+    else
+      line = line pos
+      col = col pos
+      line_text = line_text pos
+      expects = nil
+    end
+    msg = "#{msg}\nin #{source}:#{line} at #{col}#{expects}"
+    Rsec::SyntaxError.new msg, line_text, line, col
+  end
+end

data/lib/vcalendar.rb

@@ -0,0 +1,77 @@
+require "vobject"
+require "vobject/component"
+require "vobject/vcalendar/component"
+require "vobject/vcalendar/grammar"
+require "json"
+
+class Vcalendar < Vobject::Component
+  attr_accessor :comp_name, :children, :version
+
+  class << self
+    def parse(vcf, strict)
+      Vobject::Component::Vcalendar.parse(vcf, strict)
+    end
+  end
+
+  def initialize(key, cs, err)
+    super key, cs, err
+  end
+
+  def child_class(key, val)
+    base_class = if key == :VTODO
+                   Vobject::Component::Vcalendar::ToDo
+                 elsif key == :VFREEBUSY
+                   Vobject::Component::Vcalendar::FreeBusy
+                 elsif key == :JOURNAL
+                   Vobject::Component::Vcalendar::Journal
+                 elsif key == :STANDARD
+                   Vobject::Component::Vcalendar::Timezone::Standard
+                 elsif key == :DAYLIGHT
+                   Vobject::Component::Vcalendar::Timezone::Daylight
+                 elsif key == :VTIMEZONE
+                   Vobject::Component::Vcalendar::Timezone
+                 elsif key == :VEVENT
+                   Vobject::Component::Vcalendar::Event
+                 elsif key == :VALARM
+                   Vobject::Component::Vcalendar::Alarm
+                 elsif key == :VAVAILABILITY
+                   Vobject::Component::Vcalendar::Vavailability
+                 elsif key == :AVAILABLE
+                   Vobject::Component::Vcalendar::Vavailability::Available
+                 elsif !(val.is_a?(Hash) && !val.has_key?(:value))
+                   property_base_class
+                 else
+                   Vobject::Component::Vcalendar
+                 end
+    return base_class if [:CLASS, :OBJECT, :METHOD].include?
+    camelized_key = key.to_s.downcase.split("_").map(&:capitalize).join("")
+    base_class.const_get(camelized_key) rescue base_class
+  end
+
+  private
+
+  def raise_invalid_parsing
+    raise "Vobject component parse failed"
+  end
+end
+
+class Vobject::Component::Vcalendar::ToDo < Vobject::Component::Vcalendar
+end
+class Vobject::Component::Vcalendar::Freebusy < Vobject::Component::Vcalendar
+end
+class Vobject::Component::Vcalendar::Journal < Vobject::Component::Vcalendar
+end
+class Vobject::Component::Vcalendar::Timezone < Vobject::Component::Vcalendar
+end
+class Vobject::Component::Vcalendar::Timezone::Standard < Vobject::Component::Vcalendar::Timezone
+end
+class Vobject::Component::Vcalendar::Timezone::Daylight < Vobject::Component::Vcalendar::Timezone
+end
+class Vobject::Component::Vcalendar::Event < Vobject::Component::Vcalendar
+end
+class Vobject::Component::Vcalendar::Alarm < Vobject::Component::Vcalendar
+end
+class Vobject::Component::Vcalendar::Vavailability < Vobject::Component::Vcalendar
+end
+# class Vobject::Component::Vcalendar::Vavailability::Available < Vobject::Component::Vcalendar::Vavailability
+# end