sonar_rexchange 0.3.7

data/.gitignore

@@ -0,0 +1,22 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+sonar_rexchange.gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Trampoline Systems Ltd
+
+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:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+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.

data/RAKEFILE

@@ -0,0 +1,50 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "sonar_rexchange"
+    gem.summary = %Q{Modified rexchange gem}
+    gem.description = %Q{The sonar_rexchange gem imports and fixes bugs in the rexchange gem.}
+    gem.email = "hello@empire42.com"
+    gem.homepage = "http://github.com/trampoline/sonar-rexchange"
+    gem.authors = ["Peter MacRobert", "Daniel Kwiecinski", "Craig McMillan"]
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "sonar_rexchange #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/README

@@ -0,0 +1,89 @@
+= RExchange
+
+== Please note 
+sonar-rexchange is a modified version of the rexchange gem.
+
+RExchange is a pure ruby wrapper for the Microsoft Exchange Server WebDAV API
+
+== Things you should know
+
+* Requires Ruby 1.8.4 (or later, for the extended WebDAV support in the net/http library)
+* RExchange is cross-platform compatible, being written in pure Ruby
+* Kiwi fruits are packed with vitamins
+
+== Why should you use RExchange
+
+* It makes interacting with Exchange simple
+* It was written for a real application, and does real work reliably day in and day out
+
+== Example
+
+	# We pass our uri (pointing directly to a mailbox), a username, and a password to RExchange::open
+	# to create a RExchange::Session. Notice that we escape the "\" in our username.
+	RExchange::open('https://example.com/exchange/admin/', 'mydomain\\admin', 'secret') do |mailbox|
+  
+		# The block parameter ("mailbox" in this case) is actually the Session itself.
+		# You can refer to folders by chaining them as method calls. "inbox" in this case
+		# isn't a defined method for Session, but part of the DSL to refer to folder names.
+		# Each folder name returns a RExchange::Folder. The folder is Enumerable, allowing
+		# iteration over the items in the folder, depending on the DAV:content-class of
+		# the folder.
+		mailbox.inbox.each do |message|
+    
+			# The "message" block parameter is a RExchange::Message object. You have access to
+			# several attributes of the message, including: href, from, to, message_id, date,
+			# importance, has_attachment? and body.
+			p message.subject
+    
+			# The RExchange::Message#move_to method moves the message to another folder, in this
+			# case, an "archive" folder off of the inbox.
+			message.move_to mailbox.inbox.archive
+		end
+  
+		# Folder names are "normalized", replacing dashes and spaces with underscores,
+		# squeezing out multiple underscores in a row, and downcasing the whole thing.
+		# So a folder name such as "My Very-long Folder Name" would look like:
+		mailbox.my_very_long_folder_name
+  
+		# The Enumerable mixin gives us an Folder#entries method in case we just want to
+		# return an array.
+		messages = mailbox.inbox.entries
+	
+		# Other methods, like Enumerable#map and Enumerable#sort_by let us manipulate
+		# the Folder in fun ways:
+		puts mailbox.contacts.sort_by { |contact| contact.first_name }.map do |contact|
+			<<-CONTACT
+				Name:    #{contact.first_name} #{contact.last_name}
+				Email:   #{contact.email}
+				Phone:   #{contact.phone}
+			CONTACT
+		end
+	
+	end
+
+	# We can access the Global Address Book by accessing the "/public" folder:
+	RExchange::open('https://example.com/public', 'mydomain\\somebody', 'secret') do |mailbox|
+
+		puts mailbox.company_contacts.each do |contact|
+			<<-CONTACT
+				Company: #{contact.company}
+				Name:    #{contact.first_name} #{contact.last_name}
+				Email:   #{contact.email}
+				Phone:   #{contact.phone}
+			CONTACT
+	 end
+
+	end
+	
+== Caveats
+
+There are several features missing (simply because we didn't need them yet). Among them:
+
+* The ability to delete messages or folders
+* The ability to create folders
+* There's no mechanism for sending new messages, or replying or forwarding existing ones
+* There are a lot more message attributes we're not retrieving since they weren't useful to us, but they might be to you
+* Exporting an email or entire folder tree to offline storage
+* And much much more!
+
+If you'd like to see any of these features, or have some ideas of your own you'd like to see implemented don't hesitate to let us know, and if it strikes our fancy maybe you'll get some free programming!

data/REXCHANGE-CHANGELOG

@@ -0,0 +1,52 @@
+-- 0.3.4:
+* Updated the README so it jives with the current version
+* Removed Folder::join since it's only used by Folder#to_s, and just used a simpler
+	solution in Folder#to_s instead
+
+-- 0.3.3:
+* Folder objects now default to using the Message class for enumeration 
+  if no class is associated with the content_type of the Folder.
+  
+-- 0.3.2:
+* Quick hack to make Message#move_to work
+
+-- 0.3.1:
+* Disabled a warning about overwriting GenericItem::CONTENT_CLASS
+* Added a "rescue" for Time::parse failures that reverts to the original element text
+
+-- 0.3.0:
+* Added support for Appointments
+* Options hash for Session creation is gone. The new form is: "RExchange::Session.new(url, username, password)"
+* Removed GenericItem#[], GenericItem#method_missing (attributes are explicit now)
+* Removed Folder#get_messages, #get_contacts and #messages_in. Folders are now Enumerables using Enumerable#entries, #each, etc
+  to retrieve entries according to the folder's content-class. So a 'mailfolder' will retrieve Message instances,
+  a 'calendarfolder' will retrieve Appointment instances, and so on.
+
+-- 0.2.0:
+* Fixed a bug in Message#move_to when passing folders
+* Added support for Contact browsing
+* Added GenericItem to abstract Contacts and Messages
+* Renamed Folder#messages to Folder#get_messages to avoid naming collisions
+* Modified attributes in GenericItem that end with "date" to be Time::parse'd
+* Added "r_exchange.rb" for Rails auto-require compatibility
+* Now calling String#normalize on attribute names instead of just String#tr('-', '_')
+
+-- 0.1.4:
+* Moved Folder::normalize_folder_name to String#normalize, and added support for MixedCase sources.
+* Fixed a bug where the normalized folder name was being used for the Folder#to_s result.
+* Moved the meat of Folder#messages to Message::find
+* Added Message#to_s
+* Modified Folder#get_folders to return a hash instead of an array, providing both the original, and normalized names.
+
+-- 0.1.3: Bugfixes
+* Fixed several nasty bugs.
+
+-- 0.1.2: Minor documentation/cleanup
+* Removed a double-dash in the README that was apparently causing some viewing errors
+* Changed Session initialize to a ternary condition
+* Added RExchange::Message#has_attachments?
+* Added documentation for most methods in RExchange::Message and RExchange::Folder
+
+-- 0.1.1
+* Fleshed out the README
+* Copied the RAKEFILE from the Rools project

data/REXCHANGE-MIT-LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2006 Samuel Smoot
+
+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:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+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.

data/VERSION

@@ -0,0 +1 @@
+0.3.7

data/lib/r_exchange.rb

@@ -0,0 +1,2 @@
+# Provided for compatibility with RubyOnRails auto-require functionality.
+require 'rexchange'

data/lib/rexchange.rb

@@ -0,0 +1,33 @@
+require 'rexchange/session'
+require 'rexchange/r_exception'
+
+class String
+  def ends_with?(partial)
+    self[self.size - partial.size..self.size] == partial
+  end
+
+  def ensure_ends_with(partial)
+    self.ends_with?(partial) ? self : self + partial
+  end
+
+  def normalize
+    self.split(/(?=[A-Z][a-z]*)/).join('_').tr('- ', '_').squeeze('_').downcase
+  end
+end
+
+module RExchange
+  # Use STDOUT or another stream if you'd like to capture the HTTP debug output
+  DEBUG_STREAM = $log
+
+  PR_HTTPMAIL_READ = 'read'
+  NS_HTTPMAIL = 'urn:schemas:httpmail'
+
+  # A shortcut to RExchange::Session#new
+  def self.open(dav_uri, owa_uri, username = nil, password = nil)
+    session = RExchange::Session.new(dav_uri, owa_uri, username, password)
+
+    yield session if block_given?
+    return session
+  end
+
+end

data/lib/rexchange/appointment.rb

@@ -0,0 +1,38 @@
+require 'rexchange/generic_item'
+
+module RExchange
+  class Appointment < GenericItem
+    
+    set_folder_type 'calendar'
+    
+    attribute_mappings :all_day_event => 'urn:schemas:calendar:alldayevent',
+      :busy_status => 'urn:schemas:calendar:busystatus',
+      :contact => 'urn:schemas:calendar:contact',
+      :contact_url => 'urn:schemas:calendar:contacturl',
+      :created_on => 'urn:schemas:calendar:created',
+      :description_url => 'urn:schemas:calendar:descriptionurl',
+      :end_at => 'urn:schemas:calendar:dtend',
+      :created_at => 'urn:schemas:calendar:dtstamp',
+      :start_at => 'urn:schemas:calendar:dtstart',
+      :duration => 'urn:schemas:calendar:duration',
+      :expires_on => 'urn:schemas:calendar:exdate',
+      :expiry_rule => 'urn:schemas:calendar:exrule',          
+      :has_attachment? => 'urn:schemas:httpmail:hasattachment', 
+      :html => 'urn:schemas:httpmail:htmldescription',
+      :modified_on => 'urn:schemas:calendar:lastmodified', 
+      :location => 'urn:schemas:calendar:location', 
+      :location_url => 'urn:schemas:calendar:locationurl', 
+      :meeting_status => 'urn:schemas:calendar:meetingstatus', 
+      :normalized_subject => 'urn:schemas:httpmail:normalizedsubject', 
+      :priority => 'urn:schemas:httpmail:priority', 
+      :recurres_on => 'urn:schemas:calendar:rdate', 
+      :reminder_offset => 'urn:schemas:calendar:reminderoffset', 
+      :reply_time => 'urn:schemas:calendar:replytime', 
+      :sequence => 'urn:schemas:calendar:sequence', 
+      :subject => 'urn:schemas:httpmail:subject', 
+      :body => 'urn:schemas:httpmail:textdescription',
+      :timezone => 'urn:schemas:calendar:timezone', 
+      :uid => 'urn:schemas:calendar:uid'
+
+  end
+end  

data/lib/rexchange/contact.rb

@@ -0,0 +1,29 @@
+require 'rexchange/generic_item'
+
+module RExchange
+  class Contact < GenericItem
+    
+    set_folder_type 'contact'
+    set_content_class 'person'
+
+    attribute_mappings :first_name => 'urn:schemas:contacts:givenName',
+      :middle_name => 'urn:schemas:contacts:middlename',
+      :last_name => 'urn:schemas:contacts:sn',
+      :title => 'urn:schemas:contacts:title',
+      :created_at => 'DAV:creationdate',
+      :address => 'urn:schemas:contacts:mailingstreet',
+      :city => 'urn:schemas:contacts:mailingcity',
+      :state => 'urn:schemas:contacts:st',
+      :zip_code => 'urn:schemas:contacts:mailingpostalcode',
+      :country => 'urn:schemas:contacts:co',
+      :phone => 'urn:schemas:contacts:homePhone',
+      :business_phone => 'urn:schemas:contacts:telephoneNumber',
+      :fax => 'urn:schemas:contacts:facsimiletelephonenumber',
+      :mobile => 'urn:schemas:contacts:mobile',    
+      :email => 'urn:schemas:contacts:email1',
+      :website => 'urn:schemas:contacts:businesshomepage',
+      :company => 'urn:schemas:contacts:o',
+      :notes => 'urn:schemas:httpmail:textdescription'
+
+  end  
+end

data/lib/rexchange/credentials.rb

@@ -0,0 +1,38 @@
+require 'uri'
+
+module RExchange
+
+  # Credentials are passed around between Folders to emulate a stateful
+  # connection with the RExchange::Session
+  class Credentials
+    attr_reader :user, :password, :dav_uri, :owa_uri
+    attr_accessor :auth_cookie
+
+    # You must pass a dav_uri, owa_uri, a username and a password
+    def initialize(dav_uri = nil, owa_uri = nil, username = nil, password = nil)
+      owa_uri = nil if owa_uri && owa_uri.blank?
+      @dav_uri = URI.parse(dav_uri) if dav_uri
+      @owa_uri = URI.parse(owa_uri) if owa_uri
+      @dav_use_ssl = @dav_uri.scheme ? (@dav_uri.scheme.downcase == 'https') : false
+      @user = username || (@dav_uri && @dav_uri.userinfo ? @dav_uri.userinfo.split(':')[0] : nil) || (@owa_uri && @owa_uri.userinfo ? @owa_uri.userinfo.split(':')[0] : nil)
+      @password = password || (@dav_uri && @dav_uri.userinfo ? @dav_uri.userinfo.split(':')[1] : nil) || (@owa_uri && @owa_uri.userinfo ? @owa_uri.userinfo.split(':')[1] : nil)
+      @dav_port = (@dav_uri.port || @dav_uri.default_port) if @dav_uri
+      @owa_port = (@owa_uri.port || @owa_uri.default_port) if @owa_uri
+      if block_given?
+        yield self
+      else
+        return self
+      end
+    end
+    
+    def dav_use_ssl?
+      @dav_use_ssl
+    end
+
+    def is_owa?
+      @owa_uri && @owa_uri.scheme && @owa_uri.host
+    end
+    
+  end
+  
+end

data/lib/rexchange/dav_delete_request.rb

@@ -0,0 +1,30 @@
+require 'rexchange/exchange_request'
+
+module RExchange
+  # Used to move entities to different locations in the accessable mailbox.
+  class DavDeleteRequest < ExchangeRequest
+    METHOD = 'DELETE'
+    REQUEST_HAS_BODY = false
+    RESPONSE_HAS_BODY = false
+
+    def self.execute(credentials, source, &b)
+      begin
+        options = {
+                :path => source
+        }
+
+        response = super credentials, options
+        yield response if b                
+        response
+      rescue RException => e
+        raise e  
+      rescue Exception => e
+        raise RException.new(options[:request], response, e)
+      end
+    end
+
+
+
+  end
+
+end