tilia-vobject 4.0.0.pre.alpha2

data/CONTRIBUTING.md

@@ -0,0 +1,25 @@
+# Contributing
+
+This project adheres to the [Open Code of Conduct][code-of-conduct]. By participating, you are expected to honor this code.
+[code-of-conduct]: http://todogroup.org/opencodeofconduct/#tilia-vobject/tilia@jakobsack.de
+
+This library is a port of [sabre/vobject](http://github.com/fruux/sabre-vobject). The ruby code should match the php code as good as possible. For more information refer to the [coding guidelines](https://tilia.github.io/coding_guidelines).
+
+If you are having an issue [search the open issues](https://github.com/tilia/tilia-vobject/issues) or create an issue and we'll help point you in the right direction.
+
+## Submitting a Pull Request
+
+* Fork the project on Github
+* Install development dependencies (`bundle install`)
+* Create a topic branch for your changes
+* Ensure that you provide *documentation* and *test coverage* for your changes (patches won't be accepted without)
+* Ensure that all tests pass (`bundle exec rake`)
+* Create a [pull request](https://github.com/tilia/tilia-vobject/pulls) on Github (these are also a great place to start a conversation around a patch as early as possible)
+
+## Testing
+
+To run the tests:
+
+    $ rake
+
+If nothing complains, congratulations!

data/Gemfile

@@ -0,0 +1,17 @@
+source 'https://rubygems.org'
+
+# Internal dependencies
+gem 'tilia-xml', '~> 1.1'
+
+# External dependencies
+gem 'activesupport', '~> 4.2'
+gem 'mail', '~> 2.6'
+gem 'tzinfo', '~> 1.2'
+gem 'rchardet', '~>1.6'
+
+# Testing
+gem 'rake'
+gem 'minitest', '~> 5.8'
+gem 'simplecov', '~> 0.10'
+gem 'rubocop', '~> 0.34'
+gem 'yard', '~> 0.8'

data/Gemfile.lock

@@ -0,0 +1,68 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (4.2.5)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    ast (2.1.0)
+    astrolabe (1.3.1)
+      parser (~> 2.2)
+    docile (1.1.5)
+    i18n (0.7.0)
+    json (1.8.3)
+    libxml-ruby (2.8.0)
+    mail (2.6.3)
+      mime-types (>= 1.16, < 3)
+    mime-types (2.99)
+    minitest (5.8.3)
+    parser (2.2.3.0)
+      ast (>= 1.1, < 3.0)
+    powerpack (0.1.1)
+    rainbow (2.0.0)
+    rake (10.4.2)
+    rchardet (1.6.1)
+    rubocop (0.35.1)
+      astrolabe (~> 1.3)
+      parser (>= 2.2.3.0, < 3.0)
+      powerpack (~> 0.1)
+      rainbow (>= 1.99.1, < 3.0)
+      ruby-progressbar (~> 1.7)
+      tins (<= 1.6.0)
+    ruby-progressbar (1.7.5)
+    simplecov (0.10.0)
+      docile (~> 1.1.0)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    thread_safe (0.3.5)
+    tilia-uri (1.0.1)
+      activesupport (~> 4.2)
+    tilia-xml (1.2.0)
+      activesupport (~> 4.2)
+      libxml-ruby (~> 2.8)
+      tilia-uri (~> 1.0)
+    tins (1.6.0)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    yard (0.8.7.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (~> 4.2)
+  mail (~> 2.6)
+  minitest (~> 5.8)
+  rake
+  rchardet (~> 1.6)
+  rubocop (~> 0.34)
+  simplecov (~> 0.10)
+  tilia-xml (~> 1.1)
+  tzinfo (~> 1.2)
+  yard (~> 0.8)
+
+BUNDLED WITH
+   1.10.6

data/LICENSE

@@ -0,0 +1,27 @@
+Copyright (C) 2015 Jakob Sack (tilia@jakobsack.de)
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * 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.
+    * Neither the name Tilia nor the names of its contributors
+      may be used to endorse or promote products derived from this software
+      without specific prior written permission.
+
+    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 OWNER 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/LICENSE.sabre

@@ -0,0 +1,27 @@
+Copyright (C) 2011-2015 fruux GmbH (https://fruux.com/)
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * 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.
+    * Neither the name Sabre nor the names of its contributors
+      may be used to endorse or promote products derived from this software
+      without specific prior written permission.
+
+    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 OWNER 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.md

@@ -0,0 +1,63 @@
+tilia/vobject
+=============
+
+[![Build Status](https://travis-ci.org/tilia/tilia-vobject.svg?branch=master)](https://travis-ci.org/tilia/tilia-vobject)
+
+**tilia/vobject is a port of [sabre/vobject](https://github.com/fruux/sabre-vobject)**
+
+The sabre/vobject library allows you to easily parse and manipulate [iCalendar](https://tools.ietf.org/html/rfc5545)
+and [vCard](https://tools.ietf.org/html/rfc6350) objects using PHP.
+
+The goal of the VObject library is to create a very complete library, with an easy to use API.
+
+
+Installation
+------------
+
+Simply add tilia-vobject to your Gemfile and bundle it up:
+
+```ruby
+  gem 'tilia-vobject', '~> 4.0.0'
+```
+
+Changes to sabre/vobject
+------------------------
+
+```php
+  Sabre\VObject\FreeBusyGenerator#setTimeRange(DateTimeInterface $start = null, DateTimeInterface $end = null)
+```
+
+is replaced by
+
+```ruby
+  Tilia::VObject::FreeBusyGenerator#time_range=(Range<Time>)
+```
+
+Unknown beginnings and ends can be replaced by `Tilia::VObject::Settings.min_date`
+and `.max_date`.
+
+
+```php
+  Sabre\VObject\Property\ICalendar\DateTime#setDateTime(DateTimeInterface $dt, $isFloating = false)
+  Sabre\VObject\Property\ICalendar\DateTime#setDateTimes(array $dt, $isFloating = false)
+```
+
+are replaced by
+
+```ruby
+  Tilia::VObject::Property::ICalendar#date_time=(Time)
+  Tilia::VObject::Property::ICalendar#date_times=(Array<Time>)
+  Tilia::VObject::Property::ICalendar#floating=(Boolean)
+```
+
+
+Contributing
+------------
+
+See [Contributing](CONTRIBUTING.md)
+
+
+License
+-------
+
+tilia-vobject is licensed under the terms of the [three-clause BSD-license](LICENSE).

data/Rakefile

@@ -0,0 +1,17 @@
+require 'rake'
+require 'rake/testtask'
+require 'rubocop/rake_task'
+require 'yard'
+
+Rake::TestTask.new do |t|
+  t.test_files = Dir.glob('test/**/*_test.rb')
+  t.libs << 'test'
+end
+RuboCop::RakeTask.new do |t|
+  t.options = ['--format', 'html', '--out', 'coverage/rubocop.html']
+end
+YARD::Rake::YardocTask.new do |t|
+  t.files = ['lib/**/*.rb', '-', 'README.md']
+end
+
+task(default: :test)

data/bin/vobject

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+# Expected to be called "bundle exec bin/vobject"
+require './lib/tilia_vobject'
+
+cli = Tilia::VObject::Cli.new
+exit(cli.main(ARGV))

data/lib/tilia/v_object/birthday_calendar_generator.rb

@@ -0,0 +1,142 @@
+module Tilia
+  module VObject
+    # This class generates birthday calendars.
+    class BirthdayCalendarGenerator
+      # Input objects.
+      #
+      # @var array
+      # RUBY: attr_accessor :objects
+
+      # Default year.
+      # Used for dates without a year.
+      DEFAULT_YEAR = 2000
+
+      # Output format for the SUMMARY.
+      #
+      # @var string
+      # RUBY: attr_accessor :format
+
+      # Creates the generator.
+      #
+      # Check the setTimeRange and setObjects methods for details about the
+      # arguments.
+      #
+      # @param mixed objects
+      def initialize(objects = nil)
+        @objects = []
+        @format = '%1s\'s Birthday'
+
+        self.objects = objects if objects
+      end
+
+      # Sets the input objects.
+      #
+      # You must either supply a vCard as a string or as a Component/VCard object.
+      # It's also possible to supply an array of strings or objects.
+      #
+      # @param mixed objects
+      #
+      # @return void
+      def objects=(objects)
+        objects = [objects] unless objects.is_a?(Array)
+
+        @objects = []
+        objects.each do |object|
+          if object.is_a?(String)
+            v_obj = Reader.read(object)
+            unless v_obj.is_a?(Component::VCard)
+              fail ArgumentError, 'String could not be parsed as Component::VCard by setObjects'
+            end
+
+            @objects << v_obj
+          elsif object.is_a?(Component::VCard)
+            @objects << object
+          else
+            fail ArgumentError, 'You can only pass strings or Component::VCard arguments to setObjects'
+          end
+        end
+      end
+
+      # Sets the output format for the SUMMARY
+      #
+      # @param string format
+      #
+      # @return void
+      attr_writer :format
+
+      # Parses the input data and returns a VCALENDAR.
+      #
+      # @return Component/VCalendar
+      def result
+        calendar = Component::VCalendar.new
+
+        @objects.each do |object|
+          # Skip if there is no BDAY property.
+          next if object.select('BDAY').empty?
+
+          # We've seen clients (ez-vcard) putting "BDAY:" properties
+          # without a value into vCards. If we come across those, we'll
+          # skip them.
+          next if object['BDAY'].value.blank?
+
+          # We're always converting to vCard 4.0 so we can rely on the
+          # VCardConverter handling the X-APPLE-OMIT-YEAR property for us.
+          object = object.convert(Document::VCARD40)
+
+          # Skip if the card has no FN property.
+          next unless object.key?('FN')
+
+          # Skip if the BDAY property is not of the right type.
+          next unless object['BDAY'].is_a?(Property::VCard::DateAndOrTime)
+
+          # Skip if we can't parse the BDAY value.
+          begin
+            date_parts = DateTimeParser.parse_v_card_date_time(object['BDAY'].value)
+          rescue ArgumentError
+            next
+          end
+
+          # Set a year if it's not set.
+          unknown_year = false
+
+          unless date_parts['year']
+            object['BDAY'] = "#{self.class::DEFAULT_YEAR}-#{date_parts['month']}-#{date_parts['date']}"
+            unknown_year = true
+          end
+
+          # Create event.
+          event = calendar.add(
+            'VEVENT',
+            'SUMMARY'      => format(@format, object['FN'].value),
+            'DTSTART'      => Time.zone.parse(object['BDAY'].value),
+            'RRULE'        => 'FREQ=YEARLY',
+            'TRANSP'       => 'TRANSPARENT'
+          )
+
+          # add VALUE=date
+          event['DTSTART']['VALUE'] = 'DATE'
+
+          # Add X-SABRE-BDAY property.
+          if unknown_year
+            event.add(
+              'X-SABRE-BDAY',
+              'BDAY',
+              'X-SABRE-VCARD-UID' => object['UID'].value,
+              'X-SABRE-VCARD-FN'  => object['FN'].value,
+              'X-SABRE-OMIT-YEAR' => self.class::DEFAULT_YEAR
+            )
+          else
+            event.add(
+              'X-SABRE-BDAY',
+              'BDAY',
+              'X-SABRE-VCARD-UID' => object['UID'].value,
+              'X-SABRE-VCARD-FN'  => object['FN'].value
+            )
+          end
+        end
+
+        calendar
+      end
+    end
+  end
+end