kerio-ical 0.0.1

data/History.txt

@@ -0,0 +1,3 @@
+=== 0.0.1 2010-11-08
+
+* Initial release

data/Manifest.txt

@@ -0,0 +1,16 @@
+History.txt
+Manifest.txt
+PostInstall.txt
+README.rdoc
+Rakefile
+config/template_config.yml
+lib/kerio-ical/config.rb
+lib/kerio-ical/date_time.rb
+lib/kerio-ical/get.rb
+lib/kerio-ical/transport.rb
+lib/kerio-ical.rb
+script/console
+script/destroy
+script/generate
+test/test_kerio_ical.rb
+test/test_helper.rb

data/PostInstall.txt

@@ -0,0 +1,3 @@
+Thank you for using kerio-ical.
+
+Make sure you have curl in your path!

data/README.rdoc

@@ -0,0 +1,64 @@
+= kerio-ical
+
+http://github.com/athlite/kerio-ical
+
+== DESCRIPTION
+
+A Ruby interface to Kerio Mail server calendars
+	
+== FEATURES
+
+* List a user calendars.
+
+== SYNOPSIS
+Setup
+
+	KerioIcal::Config.config = {
+		'url' => 'https://mail.example.com/path/to-calendars',
+		'username' =>  'username',
+		'password' => 'password'
+	}
+	
+To get calendars of a specific user
+	
+	calendars = KerioIcal::Get.calendars('username')
+	
+	calendars.each do |cal|
+		cal.events.each do |event|
+			p event
+		end
+	end
+
+== REQUIREMENTS
+
+* icalendar
+* curl must be installed
+
+== INSTALL
+
+* sudo gem install kerio-ical
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2010 Thomas T. Eng
+
+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,25 @@
+require 'rubygems'
+gem 'hoe', '>= 2.1.0'
+require 'hoe'
+require 'fileutils'
+require './lib/kerio-ical'
+
+Hoe.plugin :newgem
+# Hoe.plugin :website
+# Hoe.plugin :cucumberfeatures
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.spec 'kerio-ical' do
+  self.developer 'Thomas Tinnesand Eng', 'thomas.tinnesand.eng@gmail.com'
+  self.post_install_message = 'PostInstall.txt' # TODO remove if post-install message not required
+  self.rubyforge_name       = self.name # TODO this is default value
+	self.extra_deps = [['icalendar', '>= 1.1.5']]
+end
+
+require 'newgem/tasks'
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+# TODO - want other tests/tasks run by default? Add them to the list
+# remove_task :default
+# task :default => [:spec, :features]

data/config/template_config.yml

@@ -0,0 +1,4 @@
+url: 'https://mail.example.com/ical/example.com'
+username: user
+password: pw
+user: 'john.doe'

data/lib/kerio-ical.rb

@@ -0,0 +1,25 @@
+$:.unshift(File.dirname(__FILE__)) unless
+$:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+# *Author*::   Thomas T. Eng  (mailto:thomas.tinnesand.eng@gmail.com)
+# *Copyright*:: Copyright (c) 2010 Thomas T. Eng
+# *License*::   The MIT License
+module KerioIcal
+	
+	# Gem version
+	VERSION = '0.0.1'
+	
+	# Base dir of lib.
+	ROOT_DIR = File.expand_path( File.dirname(__FILE__) )
+	
+	require 'yaml'
+	require 'date'
+	require 'net/http'
+	require 'net/https'
+	require 'rubygems'
+	require 'icalendar'
+	require 'kerio-ical/config'
+	require 'kerio-ical/date_time.rb'
+	require 'kerio-ical/transport'
+	require 'kerio-ical/get'
+end

data/lib/kerio-ical/config.rb

@@ -0,0 +1,25 @@
+module KerioIcal 
+	# Holds config parameters.
+	class Config
+		class << self
+			
+			# set config hash
+			def config=(c)
+				@config = c
+			end
+			
+			# access config params
+			def [](key)
+				@config ||= YAML::load_file( File.join(ROOT_DIR, "..", "config", "config.yml") )
+				@config[key]
+			end
+			
+			# access to config params through class methods
+			# i.e *Config.url*
+			def method_missing(name, *options, &block)
+				self[name.to_s] or super
+			end
+			
+		end
+	end
+end

data/lib/kerio-ical/date_time.rb

@@ -0,0 +1,7 @@
+# Extends DateTime
+class DateTime
+	# converts to Time
+	def to_time
+		Time.mktime(self.year, self.month, self.day, self.hour, self.min, self.sec)
+	end
+end

data/lib/kerio-ical/get.rb

@@ -0,0 +1,17 @@
+module KerioIcal
+	# Gets the calendar objects	
+	class Get
+		class << self		
+			# *user* must be under a directory on mail server.
+			# i.e. _http://mail.example.com/ical/example.com/john.doe_
+			# 
+			# returns an array *Icalendar* objects
+			def calendars(user)
+				Transport::url = Config.url
+				transport = Transport::url.match(/^https:/) ? :net_https : :net_http
+				result = Transport::get(Config.username, Config.password, user, transport)
+				Icalendar.parse(result)
+			end
+		end
+	end
+end

data/lib/kerio-ical/transport.rb

@@ -0,0 +1,55 @@
+module KerioIcal
+	# Methods for accessing curl transport
+	module Transport
+		class << self
+			
+			# sets path to calendar service.
+			def url=(u)
+				@url = u
+			end
+			# gets path to calendar service.
+			def url
+				@url
+			end
+			
+			# _parameters_:
+			# *username*:: an authorized user
+			# *password*:: with password
+			# *user*:: the user we wish to list
+			# *transport*:: \:net_http or \:net_https
+			def get(username, password, user, transport = :net_http)
+				return net_http(username, password, user, false) if transport == :net_http
+				return net_http(username, password, user, true) if transport == :net_https
+				""
+			end
+			
+			# http transport
+			def net_http(username, password, user, ssl = true)
+				uri = URI.parse( inject_username_password("#{@url}/#{user}", username, password) )
+				@http=Net::HTTP.new(uri.host, uri.port)
+				@http.use_ssl= true if ssl
+				resp = ""
+				@http.start do |http|
+					req = Net::HTTP::Get.new(uri.path)
+					req.basic_auth uri.user, uri.password
+					response = http.request(req)
+					raise "not authorized" if response.code == "401"
+					raise "could not find user: '#{user}'" if response.code == "404"
+					raise "something not right [#{response.code}]" unless response.code == "200"
+					resp = response.body
+				end
+				resp
+			end
+			
+			# Prefixes url with username and password.
+			# <p>\http://example.com => \http://user:pass@example.com</p>
+			def inject_username_password(url,username,password)
+				url = url.split("://")
+				url[0] += "://"
+				url.push(url.last)
+				url[1] = "#{username}:#{password}@"
+				url = url.join
+			end
+		end
+	end
+end

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/kerio-ical.rb'}"
+puts "Loading kerio-ical gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/test/test_helper.rb

@@ -0,0 +1,3 @@
+require 'stringio'
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/kerio-ical'

data/test/test_kerio_ical.rb

@@ -0,0 +1,25 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestKerioIcal < Test::Unit::TestCase
+
+	def setup
+		KerioIcal::Config.config = YAML::load_file(File.join(KerioIcal::ROOT_DIR, "..", "config", "test_config.yml"))
+		@user = KerioIcal::Config['user']
+	end
+
+	def test_calendars
+		calendars = KerioIcal::Get.calendars(@user)
+		calendars.each do |cal|
+			assert_equal cal.class, Icalendar::Calendar
+			cal.events.each do |event|
+				assert_equal event.class, Icalendar::Event
+			end
+		end
+	end
+	
+	def test_inject_username_password
+		url = "http://example.com"
+		assert_equal "http://user:pass@example.com", KerioIcal::Transport::inject_username_password(url, "user", "pass")
+	end
+	
+end

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification 
+name: kerio-ical
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Thomas Tinnesand Eng
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-08 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: icalendar
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 25
+        segments: 
+        - 1
+        - 1
+        - 5
+        version: 1.1.5
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rubyforge
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 2
+        - 0
+        - 4
+        version: 2.0.4
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 2
+        - 6
+        - 2
+        version: 2.6.2
+  type: :development
+  version_requirements: *id003
+description: A Ruby interface to Kerio Mail server calendars
+email: 
+- thomas.tinnesand.eng@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+files: 
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+- README.rdoc
+- Rakefile
+- config/template_config.yml
+- lib/kerio-ical/config.rb
+- lib/kerio-ical/date_time.rb
+- lib/kerio-ical/get.rb
+- lib/kerio-ical/transport.rb
+- lib/kerio-ical.rb
+- script/console
+- script/destroy
+- script/generate
+- test/test_kerio_ical.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/athlite/kerio-ical
+licenses: []
+
+post_install_message: PostInstall.txt
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: kerio-ical
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A Ruby interface to Kerio Mail server calendars
+test_files: 
+- test/test_helper.rb
+- test/test_kerio_ical.rb