viewpoint 0.1.27 → 1.0.0.beta.1

data/lib/{model/attachment.rb → ews/soap/responses/subscribe_response_message.rb}

@@ -16,16 +16,20 @@
   limitations under the License.
 =end
 
-module Viewpoint
-  module EWS
-    # A generic Attachment.  This class should not be instantiated directly.  You
-    # should use one of the subclasses like FileAttachment or ItemAttachment.
-    class Attachment
-      include Model
-
-      # All Attachment types will have an id.
-      attr_reader :id
-
-    end # Attachment
-  end # EWS
-end # Viewpoint
+module Viewpoint::EWS::SOAP
+  class SubscribeResponseMessage < ResponseMessage
+
+    def subscription
+      safe_hash_access message, [:elems]
+    end
+
+    def subscription_id
+      safe_hash_access subscription, [:subscription_id, :text]
+    end
+
+    def watermark
+      safe_hash_access subscription, [:watermark, :text]
+    end
+
+  end # SubscribeResponseMessage
+end # Viewpoint::EWS::SOAP

data/lib/ews/templates/forward_item.rb

@@ -0,0 +1,24 @@
+module Viewpoint::EWS
+  module Template
+    class ForwardItem < Message
+
+      # Format this object for EWS backend consumption.
+      def to_ews
+        ews_opts, msg = to_ews_basic
+        msg[:reference_item_id] = reference_item_id
+        msg[:new_body_content]  = {text: new_body_content, body_type: new_body_type}
+        ews_opts.merge({items: [{forward_item: msg}]})
+      end
+
+      private
+
+
+      def init_defaults!
+        super
+        self.new_body_content ||= ''
+        self.new_body_type ||= 'Text'
+      end
+
+    end
+  end
+end

data/lib/ews/templates/message.rb

@@ -0,0 +1,66 @@
+module Viewpoint::EWS
+  module Template
+    class Message < OpenStruct
+
+      def initialize(opts = {})
+        super opts.clone
+        init_defaults!
+      end
+
+      # Format this object for EWS backend consumption.
+      def to_ews
+        ews_opts, msg = to_ews_basic
+        ews_opts.merge({items: [{message: msg}]})
+      end
+
+      def has_attachments?
+        !(file_attachments.empty? && item_attachments.empty?)
+      end
+
+
+      private
+
+
+      def init_defaults!
+        self.subject ||= nil
+        self.body ||= nil
+        self.body_type ||= 'Text'
+        self.draft ||= false
+        self.to_recipients ||= []
+        self.cc_recipients ||= []
+        self.bcc_recipients ||= []
+        self.file_attachments ||= []
+        self.item_attachments ||= []
+      end
+
+      def to_ews_basic
+        ews_opts = {}
+        ews_opts[:message_disposition] = (draft ? 'SaveOnly' : 'SendAndSaveCopy')
+
+        if saved_item_folder_id
+          if saved_item_folder_id.kind_of?(Hash)
+            ews_opts[:saved_item_folder_id] = saved_item_folder_id
+          else
+            ews_opts[:saved_item_folder_id] = {id: saved_item_folder_id}
+          end
+        end
+
+        msg = {}
+        msg[:subject] = subject if subject
+        msg[:body] = {text: body, body_type: body_type} if body
+
+        to_r = to_recipients.collect{|r| {mailbox: {email_address: r}}}
+        msg[:to_recipients] = to_r unless to_r.empty?
+
+        cc_r = cc_recipients.collect{|r| {mailbox: {email_address: r}}}
+        msg[:cc_recipients] = cc_r unless cc_r.empty?
+
+        bcc_r = bcc_recipients.collect{|r| {mailbox: {email_address: r}}}
+        msg[:bcc_recipients] = bcc_r unless bcc_r.empty?
+
+        [ews_opts, msg]
+      end
+
+    end
+  end
+end

data/lib/ews/templates/reply_to_item.rb

@@ -0,0 +1,25 @@
+module Viewpoint::EWS
+  module Template
+    class ReplyToItem < Message
+
+      # Format this object for EWS backend consumption.
+      def to_ews
+        ews_opts, msg = to_ews_basic
+        msg[:reference_item_id] = reference_item_id
+        msg[:new_body_content]  = {text: new_body_content, body_type: new_body_type}
+        ews_opts.merge({items: [{ews_type => msg}]})
+      end
+
+      private
+
+
+      def init_defaults!
+        super
+        self.new_body_content ||= ''
+        self.new_body_type ||= 'Text'
+        self.ews_type = :reply_to_item
+      end
+
+    end
+  end
+end

data/lib/ews/types.rb

@@ -0,0 +1,146 @@
+module Viewpoint::EWS
+  module Types
+
+    KEY_PATHS = {
+      extended_properties: [:extended_property],
+    }
+    KEY_TYPES = {
+      extended_properties: :build_extended_properties,
+    }
+    KEY_ALIAS = {}
+
+    attr_reader :ews_item
+
+    # @param [SOAP::ExchangeWebService] ews the EWS reference
+    # @param [Hash] ews_item the EWS parsed response document
+    def initialize(ews, ews_item)
+      @ews      = ews
+      @ews_item = ews_item
+      @shallow      = true
+    end
+
+    def method_missing(method_sym, *arguments, &block)
+      if method_keys.include?(method_sym)
+        type_convert( method_sym, resolve_method(method_sym) )
+      else
+        super
+      end
+    end
+
+    def to_s
+      "#{self.class.name}: EWS METHODS: #{self.ews_methods.sort.join(', ')}"
+    end
+
+    def shallow?
+      @shallow
+    end
+
+    def mark_deep!
+      @shallow = false
+    end
+
+    def auto_deepen?
+      ews.auto_deepen
+    end
+
+    def deepen!
+      if shallow?
+        self.get_all_properties!
+        @shallow = false
+        true
+      end
+    end
+    alias_method :enlighten!, :deepen!
+
+    # @see http://www.ruby-doc.org/core/classes/Object.html#M000333
+    def respond_to?(method_sym, include_private = false)
+      if method_keys.include?(method_sym)
+        true
+      else
+        super
+      end
+    end
+
+    def methods(include_super = true)
+      super + ews_methods
+    end
+
+    def ews_methods
+      key_paths.keys + key_alias.keys
+    end
+
+    protected # things like OutOfOffice need protected level access
+
+    def ews
+      @ews
+    end
+
+    private
+
+    def key_paths
+      KEY_PATHS
+    end
+
+    def key_types
+      KEY_TYPES
+    end
+
+    def key_alias
+      KEY_ALIAS
+    end
+
+    def class_by_name(cname)
+      if(cname.instance_of? Symbol)
+        cname = cname.to_s.camel_case
+      end
+      Viewpoint::EWS::Types.const_get(cname)
+    end
+
+    def type_convert(key,str)
+      return nil if str.nil?
+      key = key_alias[key] || key
+      if key_types[key]
+        key_types[key].is_a?(Symbol) ? method(key_types[key]).call(str) : key_types[key].call(str)
+      else
+        str
+      end
+    end
+
+    def resolve_method(method_sym)
+      begin
+        resolve_key_path(@ews_item, method_path(method_sym))
+      rescue
+        if shallow?
+          if auto_deepen?
+            enlighten!
+            retry
+          else
+            raise EwsMinimalObjectError, "Could not resolve :#{method_sym}. #auto_deepen set to false"
+          end
+        else
+          nil
+        end
+      end
+    end
+
+    def resolve_key_path(hsh, path)
+      k = path.first
+      return hsh[k] if path.length == 1
+      resolve_key_path(hsh[k],path[1..-1])
+    end
+
+    def method_keys
+      key_paths.keys + key_alias.keys
+    end
+
+    # Resolve the method path with or without an alias
+    def method_path(sym)
+      key_paths[key_alias[sym] || sym]
+    end
+
+    def build_extended_properties(eprops)
+      eprops.collect.collect {|e| e[:elems]}
+    end
+
+  end
+end

data/lib/ews/types/attachment.rb

@@ -0,0 +1,77 @@
+=begin
+  This file is part of Viewpoint; the Ruby library for Microsoft Exchange Web Services.
+
+  Copyright © 2011 Dan Wanek <dan.wanek@gmail.com>
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+=end
+
+module Viewpoint::EWS::Types
+  # A generic Attachment.  This class should not be instantiated directly.  You
+  # should use one of the subclasses like FileAttachment or ItemAttachment.
+  class Attachment
+    include Viewpoint::EWS
+    include Viewpoint::EWS::Types
+    include Viewpoint::EWS::Types::Item
+
+    ATTACH_KEY_PATHS = {
+      :id   => [:attachment_id, :attribs, :id],
+      :parent_item_id  => [:attachment_id, :attribs, :root_item_id],
+      :parent_change_key  => [:attachment_id, :attribs, :root_item_change_key],
+      :name => [:name, :text],
+      :content_type => [:content_type, :text],
+      :content_id => [:content_id],
+      :size => [:size, :text],
+      :last_modified_time => [:last_modified_time, :text],
+      :is_inline? => [:is_inline, :text],
+    }
+
+    ATTACH_KEY_TYPES = {
+      is_inline?:   ->(str){str.downcase == 'true'},
+      last_modified_type: ->(str){DateTime.parse(str)},
+      size: ->(str){str.to_i},
+      content_id: :fix_content_id,
+    }
+
+    ATTACH_KEY_ALIAS = { }
+
+    # @param [Hash] attachment The attachment ews_item
+    def initialize(item, attachment)
+      @item = item
+      super(item.ews, attachment)
+    end
+
+
+    private
+
+
+    def key_paths
+      @key_paths ||= ATTACH_KEY_PATHS
+    end
+
+    def key_types
+      @key_types ||= ATTACH_KEY_TYPES
+    end
+
+    def key_alias
+      @key_alias ||= ATTACH_KEY_ALIAS
+    end
+
+    # Sometimes the SOAP response comes back with two identical content_ids.
+    # This method fishes them out no matter which way them come.
+    def fix_content_id(content_id)
+      content_id.is_a?(Array) ? content_id.last[:text] : content_id[:text]
+    end
+
+  end
+end

data/lib/{model/meeting_cancellation.rb → ews/types/attendee.rb}

@@ -16,11 +16,12 @@
   limitations under the License.
 =end
 
-module Viewpoint
-  module EWS
-    # Meeting cancellations have the exact same elements as a Meeting Message
-    # so MeetingCancellation is just a subclass of that.
-    class MeetingCancellation < MeetingMessage
-    end # MeetingCancellation
-  end # EWS
-end # Viewpoint
+module Viewpoint::EWS::Types
+
+  # This represents a Mailbox object in the Exchange data store
+  # @see http://msdn.microsoft.com/en-us/library/aa565036.aspx MSDN docs
+  # @todo Design a Class method that resolves to an Array of MailboxUsers
+  class Attendee < MailboxUser
+  end # Attendee
+
+end # Viewpoint::EWS::Types

data/lib/ews/types/calendar_folder.rb

@@ -0,0 +1,8 @@
+module Viewpoint::EWS::Types
+  class CalendarFolder
+    include Viewpoint::EWS
+    include Viewpoint::EWS::Types
+    include Viewpoint::EWS::Types::GenericFolder
+
+  end
+end

data/lib/ews/types/calendar_item.rb

@@ -0,0 +1,37 @@
+module Viewpoint::EWS::Types
+  class CalendarItem
+    include Viewpoint::EWS
+    include Viewpoint::EWS::Types
+    include Viewpoint::EWS::Types::Item
+
+    CALENDAR_ITEM_KEY_PATHS = {
+      recurring?:   [:is_recurring, :text],
+      meeting?:     [:is_meeting, :text],
+      cancelled?:   [:is_cancelled, :text],
+    }
+
+    CALENDAR_ITEM_KEY_TYPES = {
+      recurring?:   ->(str){str.downcase == 'true'},
+      meeting?:     ->(str){str.downcase == 'true'},
+      cancelled?:   ->(str){str.downcase == 'true'},
+    }
+    CALENDAR_ITEM_KEY_ALIAS = {}
+
+
+    private
+
+    def key_paths
+      super.merge(CALENDAR_ITEM_KEY_PATHS)
+    end
+
+    def key_types
+      super.merge(CALENDAR_ITEM_KEY_TYPES)
+    end
+
+    def key_alias
+      super.merge(CALENDAR_ITEM_KEY_ALIAS)
+    end
+
+
+  end
+end