tilia-vobject 4.0.0.pre.alpha2

data/lib/tilia/v_object/time_zone_data/windows_zones.rb

@@ -0,0 +1,121 @@
+module Tilia
+  module VObject
+    module TimeZoneData
+      # Automatically generated timezone file
+      #
+      # Last update: 2015-07-27T16:56:36-04:00
+      # Source: http://unicode.org/repos/cldr/trunk/common/supplemental/windowsZones.xml
+      module WindowsZones
+        def self.list
+          {
+            'AUS Central Standard Time'       => 'Australia/Darwin',
+            'AUS Eastern Standard Time'       => 'Australia/Sydney',
+            'Afghanistan Standard Time'       => 'Asia/Kabul',
+            'Alaskan Standard Time'           => 'America/Anchorage',
+            'Arab Standard Time'              => 'Asia/Riyadh',
+            'Arabian Standard Time'           => 'Asia/Dubai',
+            'Arabic Standard Time'            => 'Asia/Baghdad',
+            'Argentina Standard Time'         => 'America/Buenos_Aires',
+            'Atlantic Standard Time'          => 'America/Halifax',
+            'Azerbaijan Standard Time'        => 'Asia/Baku',
+            'Azores Standard Time'            => 'Atlantic/Azores',
+            'Bahia Standard Time'             => 'America/Bahia',
+            'Bangladesh Standard Time'        => 'Asia/Dhaka',
+            'Belarus Standard Time'           => 'Europe/Minsk',
+            'Canada Central Standard Time'    => 'America/Regina',
+            'Cape Verde Standard Time'        => 'Atlantic/Cape_Verde',
+            'Caucasus Standard Time'          => 'Asia/Yerevan',
+            'Cen. Australia Standard Time'    => 'Australia/Adelaide',
+            'Central America Standard Time'   => 'America/Guatemala',
+            'Central Asia Standard Time'      => 'Asia/Almaty',
+            'Central Brazilian Standard Time' => 'America/Cuiaba',
+            'Central Europe Standard Time'    => 'Europe/Budapest',
+            'Central European Standard Time'  => 'Europe/Warsaw',
+            'Central Pacific Standard Time'   => 'Pacific/Guadalcanal',
+            'Central Standard Time'           => 'America/Chicago',
+            'Central Standard Time (Mexico)'  => 'America/Mexico_City',
+            'China Standard Time'             => 'Asia/Shanghai',
+            'Dateline Standard Time'          => 'Etc/GMT+12',
+            'E. Africa Standard Time'         => 'Africa/Nairobi',
+            'E. Australia Standard Time'      => 'Australia/Brisbane',
+            'E. South America Standard Time'  => 'America/Sao_Paulo',
+            'Eastern Standard Time'           => 'America/New_York',
+            'Eastern Standard Time (Mexico)'  => 'America/Cancun',
+            'Egypt Standard Time'             => 'Africa/Cairo',
+            'Ekaterinburg Standard Time'      => 'Asia/Yekaterinburg',
+            'FLE Standard Time'               => 'Europe/Kiev',
+            'Fiji Standard Time'              => 'Pacific/Fiji',
+            'GMT Standard Time'               => 'Europe/London',
+            'GTB Standard Time'               => 'Europe/Bucharest',
+            'Georgian Standard Time'          => 'Asia/Tbilisi',
+            'Greenland Standard Time'         => 'America/Godthab',
+            'Greenwich Standard Time'         => 'Atlantic/Reykjavik',
+            'Hawaiian Standard Time'          => 'Pacific/Honolulu',
+            'India Standard Time'             => 'Asia/Calcutta',
+            'Iran Standard Time'              => 'Asia/Tehran',
+            'Israel Standard Time'            => 'Asia/Jerusalem',
+            'Jordan Standard Time'            => 'Asia/Amman',
+            'Kaliningrad Standard Time'       => 'Europe/Kaliningrad',
+            'Korea Standard Time'             => 'Asia/Seoul',
+            'Libya Standard Time'             => 'Africa/Tripoli',
+            'Line Islands Standard Time'      => 'Pacific/Kiritimati',
+            'Magadan Standard Time'           => 'Asia/Magadan',
+            'Mauritius Standard Time'         => 'Indian/Mauritius',
+            'Middle East Standard Time'       => 'Asia/Beirut',
+            'Montevideo Standard Time'        => 'America/Montevideo',
+            'Morocco Standard Time'           => 'Africa/Casablanca',
+            'Mountain Standard Time'          => 'America/Denver',
+            'Mountain Standard Time (Mexico)' => 'America/Chihuahua',
+            'Myanmar Standard Time'           => 'Asia/Rangoon',
+            'N. Central Asia Standard Time'   => 'Asia/Novosibirsk',
+            'Namibia Standard Time'           => 'Africa/Windhoek',
+            'Nepal Standard Time'             => 'Asia/Katmandu',
+            'New Zealand Standard Time'       => 'Pacific/Auckland',
+            'Newfoundland Standard Time'      => 'America/St_Johns',
+            'North Asia East Standard Time'   => 'Asia/Irkutsk',
+            'North Asia Standard Time'        => 'Asia/Krasnoyarsk',
+            'Pacific SA Standard Time'        => 'America/Santiago',
+            'Pacific Standard Time'           => 'America/Los_Angeles',
+            'Pacific Standard Time (Mexico)'  => 'America/Santa_Isabel',
+            'Pakistan Standard Time'          => 'Asia/Karachi',
+            'Paraguay Standard Time'          => 'America/Asuncion',
+            'Romance Standard Time'           => 'Europe/Paris',
+            'Russia Time Zone 10'             => 'Asia/Srednekolymsk',
+            'Russia Time Zone 11'             => 'Asia/Kamchatka',
+            'Russia Time Zone 3'              => 'Europe/Samara',
+            'Russian Standard Time'           => 'Europe/Moscow',
+            'SA Eastern Standard Time'        => 'America/Cayenne',
+            'SA Pacific Standard Time'        => 'America/Bogota',
+            'SA Western Standard Time'        => 'America/La_Paz',
+            'SE Asia Standard Time'           => 'Asia/Bangkok',
+            'Samoa Standard Time'             => 'Pacific/Apia',
+            'Singapore Standard Time'         => 'Asia/Singapore',
+            'South Africa Standard Time'      => 'Africa/Johannesburg',
+            'Sri Lanka Standard Time'         => 'Asia/Colombo',
+            'Syria Standard Time'             => 'Asia/Damascus',
+            'Taipei Standard Time'            => 'Asia/Taipei',
+            'Tasmania Standard Time'          => 'Australia/Hobart',
+            'Tokyo Standard Time'             => 'Asia/Tokyo',
+            'Tonga Standard Time'             => 'Pacific/Tongatapu',
+            'Turkey Standard Time'            => 'Europe/Istanbul',
+            'US Eastern Standard Time'        => 'America/Indianapolis',
+            'US Mountain Standard Time'       => 'America/Phoenix',
+            'UTC'                             => 'Etc/GMT',
+            'UTC+12'                          => 'Etc/GMT-12',
+            'UTC-02'                          => 'Etc/GMT+2',
+            'UTC-11'                          => 'Etc/GMT+11',
+            'Ulaanbaatar Standard Time'       => 'Asia/Ulaanbaatar',
+            'Venezuela Standard Time'         => 'America/Caracas',
+            'Vladivostok Standard Time'       => 'Asia/Vladivostok',
+            'W. Australia Standard Time'      => 'Australia/Perth',
+            'W. Central Africa Standard Time' => 'Africa/Lagos',
+            'W. Europe Standard Time'         => 'Europe/Berlin',
+            'West Asia Standard Time'         => 'Asia/Tashkent',
+            'West Pacific Standard Time'      => 'Pacific/Port_Moresby',
+            'Yakutsk Standard Time'           => 'Asia/Yakutsk'
+          }
+        end
+      end
+    end
+  end
+end

data/lib/tilia/v_object/time_zone_data.rb

@@ -0,0 +1,10 @@
+module Tilia
+  module VObject
+    module TimeZoneData
+      require 'tilia/v_object/time_zone_data/exchange_zones'
+      require 'tilia/v_object/time_zone_data/lotus_zones'
+      require 'tilia/v_object/time_zone_data/php_zones'
+      require 'tilia/v_object/time_zone_data/windows_zones'
+    end
+  end
+end

data/lib/tilia/v_object/time_zone_util.rb

@@ -0,0 +1,213 @@
+module Tilia
+  module VObject
+    # Time zone name translation.
+    #
+    # This file translates well-known time zone names into "Olson database" time zone names.
+    class TimeZoneUtil
+      @map = nil
+
+      # List of microsoft exchange timezone ids.
+      #
+      # Source: http://msdn.microsoft.com/en-us/library/aa563018(loband).aspx
+      @microsoft_exchange_map = {
+        0  => 'UTC',
+        31 => 'Africa/Casablanca',
+
+        # Insanely, id #2 is used for both Europe/Lisbon, and Europe/Sarajevo.
+        # I'm not even kidding.. We handle this special case in the
+        # getTimeZone method.
+        2  => 'Europe/Lisbon',
+        1  => 'Europe/London',
+        4  => 'Europe/Berlin',
+        6  => 'Europe/Prague',
+        3  => 'Europe/Paris',
+        69 => 'Africa/Luanda', # This was a best guess
+        7  => 'Europe/Athens',
+        5  => 'Europe/Bucharest',
+        49 => 'Africa/Cairo',
+        50 => 'Africa/Harare',
+        59 => 'Europe/Helsinki',
+        27 => 'Asia/Jerusalem',
+        26 => 'Asia/Baghdad',
+        74 => 'Asia/Kuwait',
+        51 => 'Europe/Moscow',
+        56 => 'Africa/Nairobi',
+        25 => 'Asia/Tehran',
+        24 => 'Asia/Muscat', # Best guess
+        54 => 'Asia/Baku',
+        48 => 'Asia/Kabul',
+        58 => 'Asia/Yekaterinburg',
+        47 => 'Asia/Karachi',
+        23 => 'Asia/Calcutta',
+        62 => 'Asia/Kathmandu',
+        46 => 'Asia/Almaty',
+        71 => 'Asia/Dhaka',
+        66 => 'Asia/Colombo',
+        61 => 'Asia/Rangoon',
+        22 => 'Asia/Bangkok',
+        64 => 'Asia/Krasnoyarsk',
+        45 => 'Asia/Shanghai',
+        63 => 'Asia/Irkutsk',
+        21 => 'Asia/Singapore',
+        73 => 'Australia/Perth',
+        75 => 'Asia/Taipei',
+        20 => 'Asia/Tokyo',
+        72 => 'Asia/Seoul',
+        70 => 'Asia/Yakutsk',
+        19 => 'Australia/Adelaide',
+        44 => 'Australia/Darwin',
+        18 => 'Australia/Brisbane',
+        76 => 'Australia/Sydney',
+        43 => 'Pacific/Guam',
+        42 => 'Australia/Hobart',
+        68 => 'Asia/Vladivostok',
+        41 => 'Asia/Magadan',
+        17 => 'Pacific/Auckland',
+        40 => 'Pacific/Fiji',
+        67 => 'Pacific/Tongatapu',
+        29 => 'Atlantic/Azores',
+        53 => 'Atlantic/Cape_Verde',
+        30 => 'America/Noronha',
+        8  => 'America/Sao_Paulo', # Best guess
+        32 => 'America/Argentina/Buenos_Aires',
+        60 => 'America/Godthab',
+        28 => 'America/St_Johns',
+        9  => 'America/Halifax',
+        33 => 'America/Caracas',
+        65 => 'America/Santiago',
+        35 => 'America/Bogota',
+        10 => 'America/New_York',
+        34 => 'America/Indiana/Indianapolis',
+        55 => 'America/Guatemala',
+        11 => 'America/Chicago',
+        37 => 'America/Mexico_City',
+        36 => 'America/Edmonton',
+        38 => 'America/Phoenix',
+        12 => 'America/Denver', # Best guess
+        13 => 'America/Los_Angeles', # Best guess
+        14 => 'America/Anchorage',
+        15 => 'Pacific/Honolulu',
+        16 => 'Pacific/Midway',
+        39 => 'Pacific/Kwajalein'
+      }
+
+      # This method will try to find out the correct timezone for an iCalendar
+      # date-time value.
+      #
+      # You must pass the contents of the TZID parameter, as well as the full
+      # calendar.
+      #
+      # If the lookup fails, this method will return the default PHP timezone
+      # (as configured using date_default_timezone_set, or the date.timezone ini
+      # setting).
+      #
+      # Alternatively, if fail_if_uncertain is set to true, it will throw an
+      # exception if we cannot accurately determine the timezone.
+      #
+      # @param string tzid
+      # @param Sabre\VObject\Component vcalendar
+      #
+      # @return DateTimeZone
+      def self.time_zone(tzid, vcalendar = nil, fail_if_uncertain = false)
+        # First we will just see if the tzid is a support timezone identifier.
+        #
+        # The only exception is if the timezone starts with (. This is to
+        # handle cases where certain microsoft products generate timezone
+        # identifiers that for instance look like:
+        #
+        # (GMT+01.00) Sarajevo/Warsaw/Zagreb
+        #
+        # Since PHP 5.5.10, the first bit will be used as the timezone and
+        # this method will return just GMT+01:00. This is wrong, because it
+        # doesn't take DST into account.
+
+        unless tzid[0] == '('
+
+          # PHP has a bug that logs PHP warnings even it shouldn't:
+          # https://bugs.php.net/bug.php?id=67881
+          #
+          # That's why we're checking if we'll be able to successfull instantiate
+          # \Date_time_zone before doing so. Otherwise we could simply instantiate
+          # and catch the exception.
+          return ActiveSupport::TimeZone.new(tzid) if ActiveSupport::TimeZone.new(tzid)
+        end
+
+        load_tz_maps
+
+        # Next, we check if the tzid is somewhere in our tzid map.
+
+        return ActiveSupport::TimeZone.new(@map[tzid]) if @map.key?(tzid)
+
+        # Maybe the author was hyper-lazy and just included an offset. We
+        # support it, but we aren't happy about it.
+        matches = /^GMT(\+|-)([0-9]{4})$/.match(tzid)
+        if matches
+
+          # Note that the path in the source will never be taken from PHP 5.5.10
+          # onwards. PHP 5.5.10 supports the "GMT+0100" style of format, so it
+          # already gets returned early in this function. Once we drop support
+          # for versions under PHP 5.5.10, this bit can be taken out of the
+          # source.
+          # @codeCoverageIgnoreStart
+          return ActiveSupport::TimeZone.new("Etc/GMT#{matches[1]}#{matches[2][0..1].gsub(/^0+/, '')}")
+          # @codeCoverageIgnoreEnd
+        end
+
+        if vcalendar
+          # If that didn't work, we will scan VTIMEZONE objects
+          vcalendar.select('VTIMEZONE').each do |vtimezone|
+            next unless vtimezone['TZID'].to_s == tzid
+            if vtimezone.key?('X-LIC-LOCATION')
+              lic = vtimezone['X-LIC-LOCATION'].to_s
+
+              # Libical generators may specify strings like
+              # "SystemV/EST5EDT". For those we must remove the
+              # SystemV part.
+              lic = lic[8..-1] if lic[0...8] == 'SystemV/'
+
+              return time_zone(lic, nil, fail_if_uncertain)
+            end
+
+            # Microsoft may add a magic number, which we also have an
+            # answer for.
+            next unless vtimezone.key?('X-MICROSOFT-CDO-TZID')
+            cdo_id = vtimezone['X-MICROSOFT-CDO-TZID'].value.to_i
+
+            # 2 can mean both Europe/Lisbon and Europe/Sarajevo.
+            if cdo_id == 2 && vtimezone['TZID'].to_s.index('Sarajevo')
+              return ActiveSupport::TimeZone.new('Europe/Sarajevo')
+            end
+
+            if @microsoft_exchange_map.key?(cdo_id)
+              return ActiveSupport::TimeZone.new(@microsoft_exchange_map[cdo_id])
+            end
+          end
+        end
+
+        if fail_if_uncertain
+          fail ArgumentError, "We were unable to determine the correct PHP timezone for tzid: #{tzid}"
+        end
+
+        # If we got all the way here, we default to UTC.
+        Time.zone
+      end
+
+      # This method will load in all the tz mapping information, if it's not yet
+      # done.
+      def self.load_tz_maps
+        return @map if @map
+
+        @map = TimeZoneData::PhpZones.list
+        @map.merge! TimeZoneData::ExchangeZones.list
+        @map.merge! TimeZoneData::LotusZones.list
+        @map.merge! TimeZoneData::WindowsZones.list
+        @map
+      end
+
+      class << self
+        attr_accessor :map
+        attr_accessor :microsoft_exchange_map
+      end
+    end
+  end
+end

data/lib/tilia/v_object/uuid_util.rb

@@ -0,0 +1,51 @@
+module Tilia
+  module VObject
+    # UUID Utility.
+    #
+    # This class has static methods to generate and validate UUID's.
+    # UUIDs are used a decent amount within various *DAV standards, so it made
+    # sense to include it.
+    class UuidUtil
+      # Returns a pseudo-random v4 UUID.
+      #
+      # This function is based on a comment by Andrew Moore on php.net
+      #
+      # @see http://www.php.net/manual/en/function.uniqid.php#94959
+      #
+      # @return string
+      def self.uuid
+        format(
+          '%04x%04x-%04x-%04x-%04x-%04x%04x%04x',
+          # 32 bits for "time_low"
+          rand(0..0xffff),
+          rand(0..0xffff),
+
+          # 16 bits for "time_mid"
+          rand(0..0xffff),
+
+          # 16 bits for "time_hi_and_version",
+          # four most significant bits holds version number 4
+          rand(0..0x0fff) | 0x4000,
+
+          # 16 bits, 8 bits for "clk_seq_hi_res",
+          # 8 bits for "clk_seq_low",
+          # two most significant bits holds zero and one for variant DCE1.1
+          rand(0..0x3fff) | 0x8000,
+
+          # 48 bits for "node"
+          rand(0..0xffff),
+          rand(0..0xffff),
+          rand(0..0xffff)
+        )
+      end
+
+      # Checks if a string is a valid UUID.
+      #
+      # @param string $uuid
+      # @return bool
+      def self.validate_uuid(uuid)
+        uuid =~ /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i
+      end
+    end
+  end
+end