viewpoint 0.1.27 → 1.0.0.beta.1

data/lib/model/meeting_request.rb

@@ -1,39 +0,0 @@
-=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
-  module EWS
-    class MeetingRequest < Item
-
-
-      private
-
-      def init_methods
-        super()
-        define_str_var :conversation_index, :conversation_topic, :internet_message_id, :references
-        define_mbox_users :to_recipients, :cc_recipients, :bcc_recipients, :reply_to, :required_attendees, :optional_attendees
-        define_mbox_user :from, :sender, :received_by, :received_representing, :organizer
-        define_bool_var :is_read, :is_read_receipt_requested, :is_response_requested, :is_delivery_receipt_requested, :is_draft, :is_from_me
-        define_bool_var :is_all_day_event, :is_cancelled, :is_delegated, :is_meeting, :is_out_of_date, :is_recurring, :is_resend
-        define_bool_var :is_submitted, :is_unmodified, :allow_new_time_proposal
-        define_int_var :adjacent_meeting_count, :appointment_sequence_number, :appointment_state, :conflicting_meeting_count
-        define_datetime_var :start, :end
-      end
-    end # MeetingRequest
-  end # EWS
-end # Viewpoint

data/lib/model/message.rb

@@ -1,142 +0,0 @@
-=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
-  module EWS
-    class Message < Item
-
-      # Send an E-mail message
-      #
-      # @param [String] subject The message subject
-      # @param [String] body The message body
-      # @param [Array] to_recipients An array of e-mail addresses to send to
-      # @param [Array] cc_recipients An array of e-mail addresses to send to
-      # @param [Array] bcc_recipients An array of e-mail addresses to send to
-      # @param [Array<File>] file_attachments An array of File objects to read data from that
-      #   will attach to this message.
-      # @return [Message,true] Returns true if the message is sent, if draft is true it will return the Message object
-      #   or it raises an error with a message stating why the e-mail could not be sent.
-      def self.send(subject, body, to_recipients, cc_recipients=[], bcc_recipients=[], file_attachments=nil, draft=false)
-        item = {}
-        item[:subject] = {:text => subject}
-        item[:body] = {:text => body, :body_type => 'Text'} unless body.nil?
-        to_recipients.each do |a|
-          item[:to_recipients] = [] unless item[:to_recipients].is_a?(Array)
-          item[:to_recipients] << {:mailbox => {:email_address => {:text => a}}}
-        end
-        cc_recipients.each do |a|
-          item[:cc_recipients] = [] unless item[:cc_recipients].is_a?(Array)
-          item[:cc_recipients] << {:mailbox => {:email_address => {:text => a}}}
-        end unless cc_recipients.nil?
-        bcc_recipients.each do |a|
-          item[:bcc_recipients] = [] unless item[:bcc_recipients].is_a?(Array)
-          item[:bcc_recipients] << {:mailbox => {:email_address => {:text => a}}}
-        end unless bcc_recipients.nil?
-        
-        conn = Viewpoint::EWS::EWS.instance
-        resp = conn.ews.create_message_item(:drafts, item, 'SaveOnly')
-        (resp.status == 'Success') || (raise EwsError, "Could not send message. #{resp.code}: #{resp.message}")
-        msg_key = resp.items.first.keys.first
-        msg_id = resp.items.first[msg_key][:item_id]
-        msg_id = add_attachments(msg_id, file_attachments) unless (file_attachments.nil? || file_attachments.empty?)
-        if !draft
-          resp = conn.ews.send_item([msg_id])
-          (resp.status == 'Success') || (raise EwsError, "Could not send message. #{resp.code}: #{resp.message}")
-        else
-          self.new({:item_id => msg_id})
-        end
-      end
-
-      # Initialize an Exchange Web Services item of type Message
-      def initialize(ews_item, opts={})
-        super(ews_item, opts)
-      end
-
-      def headers
-        deepen! if @shallow
-        return @headers if defined?(@headers) && !@headers.empty?
-        return nil unless @ews_item.has_key?(:internet_message_headers)
-        @headers = {}
-        # @todo When ruby 1.9 becomes more pervasive the Enumerator#each_with_object
-        #@headers ||= @ews_item[:internet_message_headers][:internet_message_header].each_with_object({}) do |h,obj|
-        @ews_item[:internet_message_headers][:internet_message_header].each do |h|
-          @headers[h[:header_name]] = h[:text]
-        end
-        @headers
-      end
-
-
-      # This creates an object of type Mail (mail gem) and allows us to
-      # manipulate and output Message Items in standards compliant ways.
-      # @see http://www.ietf.org/rfc/rfc2822.txt
-      def to_mail
-        mail = Mail.new
-        unless(headers.nil?)
-          mail.received  headers['Received']
-          mail.content_type headers['Content-Type']
-          mail.content_transfer_encoding headers['Content-Transfer-Encoding']
-        end
-        mail.date date_time_sent unless date_time_sent.nil?
-        mail.message_id internet_message_id unless internet_message_id.nil?
-        mail.in_reply_to in_reply_to unless in_reply_to.nil?
-        mail.references references unless references.nil?
-        mail.subject subject unless subject.nil?
-        mail.return_path = sender.email_address unless(sender.nil? || ! sender.respond_to?(:email_address))
-        mail.to to_recipients.map {|r| r.email_address if r.respond_to?(:email_address) } unless to_recipients.nil?
-        mail.cc cc_recipients.map {|r| r.email_address if r.respond_to?(:email_address) } unless cc_recipients.nil?
-        mail.from from.email_address unless(from.nil? || ! from.respond_to?(:email_address))
-        # Because the mail gem does not pass an object to the block there are some issues with using self
-        msg = self
-        if(body_type == "HTML")
-          mail.html_part do
-            body msg.body
-          end
-          mail.text_part do
-            body Nokogiri::HTML(msg.body).content
-          end
-        else
-          mail.text_part do
-            body msg.body
-          end
-        end
-
-        # add attachments
-        if(self.has_attachments?)
-          self.attachments.each do |att|
-            if(att.is_a?(FileAttachment))
-              mail.attachments[att.file_name] = Base64.decode64(att.content)
-            end
-          end
-        end
-        mail
-      end
-
-
-      private
-
-      def init_methods
-        super()
-        define_str_var :conversation_index, :conversation_topic, :internet_message_id, :references
-        define_mbox_users :to_recipients, :cc_recipients, :bcc_recipients, :reply_to
-        define_mbox_user :from, :sender, :received_by, :received_representing
-        define_bool_var :is_read, :is_read_receipt_requested, :is_response_requested, :is_delivery_receipt_requested
-      end
-
-    end # Message
-  end # EWS
-end # Viewpoint

data/lib/model/model.rb

@@ -1,269 +0,0 @@
-=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
-
-# This class is inherited by all Item subtypes such as Message, Event,
-# and Task.  It will serve as the brain for all of the methods that
-# each of these Item types have in common.
-module Viewpoint
-  module EWS
-    # This is the base model Module for shared code among all Model classes.
-    # @attr_reader [Array] :ews_methods The EWS methods created for this Model.
-    module Model
-
-      # These are convenience methods to quickly create instance methods for
-      # the various Model types when passed a Hash from the SOAP parser.
-      # These functions depend on each model type saving the passed Hash
-      # in an instance variable called @ews_item.
-
-      attr_reader :ews_methods, :ews_methods_undef
-
-      def initialize
-        # Defined EWS methods
-        @ews_methods = []
-        # Undefined EWS methods
-        @ews_methods_undef = []
-      end
-
-      protected
-
-      # Define a method that returns a string.  The vars are the keys in the 
-      # hash that contain a :text key.  In the original SOAP packet this would
-      # look something like this:
-      # @param [Array<Symbol,Hash>] *vars the symbols to map to methods.  If the
-      #   last item is a hash it will be used to map methods names.  For instance
-      #   UID comes through like this :u_i_d so we can map it like so {:u_i_d => :uid}
-      # @example
-      #   <method_name>
-      #      This is the text
-      #   </method_name>
-      def define_str_var(*vars)
-        map = ( vars.last.is_a?(Hash) ? vars.pop : {})
-        vars.each do |var|
-          mname = ( map.has_key?(var) ? map[var] : var )
-          if(@ews_item[var])
-            @ews_methods << mname
-            self.instance_eval <<-EOF
-            def #{mname}
-              @ews_item[:#{var}][:text]
-            end
-            EOF
-          else
-            @ews_methods_undef << var
-          end
-          if(Item::FIELD_URIS.has_key?(var.to_sym) && Item::FIELD_URIS[var.to_sym][:writable])
-            self.instance_eval <<-EOF
-            def #{mname}=(newtext)
-              @ews_item[:#{var}] = {} unless @ews_item[:#{var}]
-              @ews_item[:#{var}][:text] = newtext
-              @updates[:#{var}] = @ews_item[:#{var}]
-            end
-            EOF
-          end
-        end
-      end
-
-      # This is similar to the #define_str_var method except of the text value
-      # is from an XML attribute in the original SOAP so the text won't be pointed
-      # to by :text.  In the orignal SOAP it may have looked like this:
-      # @example
-      #   <node my_method='this is the text'/>
-      #   so you would specify this...
-      #   define_attr_str_var :node, :my_method
-      def define_attr_str_var(parent, *vars)
-        return unless @ews_item[parent]
-        vars.each do |var|
-          @ews_methods << var
-          if(@ews_item[parent][var].is_a?(Hash) && @ews_item[parent][var].has_key?(:text))
-            self.instance_eval <<-EOF
-            def #{var}
-              @ews_item[:#{parent}][:#{var}][:text]
-            end
-            EOF
-          elsif(@ews_item[parent][var])
-            self.instance_eval <<-EOF
-            def #{var}
-              @ews_item[:#{parent}][:#{var}]
-            end
-            EOF
-          else
-            @ews_methods_undef << var
-          end
-        end
-      end
-
-
-      def define_int_var(*vars)
-        vars.each do |var|
-          if(@ews_item[var])
-            @ews_methods << var
-            self.instance_eval <<-EOF
-            def #{var}
-              @ews_item[:#{var}][:text].to_i
-            end
-            EOF
-          else
-            @ews_methods_undef << var
-          end
-          if(Item::FIELD_URIS.has_key?(var.to_sym) && Item::FIELD_URIS[var.to_sym][:writable])
-            self.instance_eval <<-EOF
-            def #{var}=(newint)
-              @ews_item[:#{var}] = {} unless @ews_item[:#{var}]
-              @ews_item[:#{var}][:text] = newint.to_s
-              @updates[:#{var}] = @ews_item[:#{var}]
-            end
-            EOF
-          end
-        end
-      end
-
-      def define_bool_var(*vars)
-        vars.each do |var|
-          if(@ews_item[var])
-            @ews_methods << "#{var}?".to_sym
-            self.instance_eval <<-EOF
-            def #{var}?
-              (@ews_item[:#{var}][:text] == 'true') ? true : false
-            end
-            EOF
-          else
-            @ews_methods_undef << "#{var}?".to_sym
-          end
-          if(Item::FIELD_URIS.has_key?(var.to_sym) && Item::FIELD_URIS[var.to_sym][:writable])
-            self.instance_eval <<-EOF
-            def #{var}=(newbool)
-              raise EwsError, "Value not boolean for method #{var}=" unless(newbool.is_a?(TrueClass) || newbool.is_a?(FalseClass))
-              @ews_item[:#{var}] = {} unless @ews_item[:#{var}]
-              @ews_item[:#{var}][:text] = newbool.to_s
-              @updates[:#{var}] = @ews_item[:#{var}]
-            end
-          EOF
-          end
-        end
-      end
-
-      def define_datetime_var(*vars)
-        vars.each do |var|
-          if(@ews_item[var])
-            @ews_methods << var
-            self.instance_eval <<-EOF
-            def #{var}
-              DateTime.parse(@ews_item[:#{var}][:text])
-            end
-            EOF
-          else
-            @ews_methods_undef << var
-          end
-          if(Item::FIELD_URIS.has_key?(var.to_sym) && Item::FIELD_URIS[var.to_sym][:writable])
-            self.instance_eval <<-EOF
-            def #{var}=(newdate)
-              @ews_item[:#{var}] = {} unless @ews_item[:#{var}]
-              @ews_item[:#{var}][:text] = newdate.to_s
-              @updates[:#{var}] = @ews_item[:#{var}]
-            end
-            EOF
-          end
-        end
-      end
-
-      def define_mbox_users(*vars)
-        vars.each do |var|
-          if(@ews_item[var])
-            @ews_methods << var
-            self.instance_eval <<-EOF
-            def #{var}
-              return @#{var} if defined?(@#{var})
-              deepen! if !@ews_item[:#{var}]
-              if( (@ews_item[:#{var}][:mailbox]).is_a?(Hash) )
-                @#{var} = [MailboxUser.new(@ews_item[:#{var}][:mailbox])]
-              elsif( (@ews_item[:#{var}][:mailbox]).is_a?(Array) )
-                @#{var} = []
-                @ews_item[:#{var}][:mailbox].each do |i|
-                  @#{var} << MailboxUser.new(i)
-                end
-              else
-                raise EwsError, "Bad value for mailbox: " + @ews_item[:#{var}][:mailbox]
-              end
-              @#{var}
-            end
-            EOF
-          else
-            @ews_methods_undef << var
-          end
-        end
-      end
-
-
-      def define_mbox_user(*vars)
-        vars.each do |var|
-          if(@ews_item[var])
-            @ews_methods << var
-            self.instance_eval <<-EOF
-            def #{var}
-              deepen! if !@ews_item[:#{var}]
-              @#{var} ||= MailboxUser.new(@ews_item[:#{var}][:mailbox])
-            end
-            EOF
-          else
-            @ews_methods_undef << var
-          end
-        end
-      end
-      
-
-      # Define meeting attendees
-      # @param [String] *attendee_types the type of attendee we are defining :required_attendees, :optional_attendees
-      def define_attendees(*attendee_types)
-        attendee_types.each do |attendee_type|
-          if(@ews_item.has_key?(attendee_type))
-            @ews_methods << attendee_type
-            self.instance_eval <<-EOF
-            def #{attendee_type}
-              return @#{attendee_type} if(defined?(@#{attendee_type}) && !@#{attendee_type}.nil?)
-              if( (@ews_item[:#{attendee_type}][:attendee]).is_a?(Hash) )
-                @#{attendee_type} = [Attendee.new(@ews_item[:#{attendee_type}][:attendee])]
-              elsif( (@ews_item[:#{attendee_type}][:attendee]).is_a?(Array) )
-                @#{attendee_type} = []
-                @ews_item[:#{attendee_type}][:attendee].each do |i|
-                  @#{attendee_type} << Attendee.new(i)
-                end
-              else
-                raise EwsError, "Bad value for mailbox: " + @ews_item[:#{attendee_type}][:attendee]
-              end
-              @#{attendee_type}
-            end
-            EOF
-          else
-            @ews_methods_undef << attendee_type
-          end
-        end
-      end
-
-      # After a delete is called on an object this method will clear
-      # out all of the defined EWS methods so they can't be called on the
-      # instantiated object.
-      def clear_object!
-        @ews_methods.each do |m|
-          self.instance_variables.each do |iv|
-            self.instance_variable_set("#{iv}",nil)
-          end
-        end
-      end
-
-    end # Model
-  end # EWS
-end # Viewpoint