groupwise 0.0.1

data/contrib/novell/readme.txt

@@ -0,0 +1,40 @@
+GroupWise Schemas
+
+
+The GroupWise WSDL and schemas are written using industry standards from W3c.  You can find the link to the XML schemas definitions at:  http://www.w3.org/XML/Schema.  From the point of GroupWise, we provide developers schemas and WSDL files.  Developers decide the specific development framework they want to use to build GroupWise applications.  Each development framework compiles its own library with the GroupWise schemas and WSDL.  Different frameworks have different levels of support for Web Services.  This means that each generated library could have a different set of bugs.
+
+In GroupWise development, we have tested with Sun's Java libraries and Microsoft .Net.  Sun's Java libraries support our schemas without any modifications.  However, we have found some issues with Microsoft's implementation of the GroupWise schemas.  For Microsoft .Net 2003 and 2005, we provide a set of schemas that will work. 
+
+
+GroupWise 2012
+
+We have included the GroupWise 2012 schemas. You will find the shipping schemas for GroupWise 2012 and 2012 SP1.
+
+
+GroupWise 8
+
+In GroupWise 8, we have consolidated the schemas down to one set for all frameworks.  In GroupWise 7, we had a general set of schemas for all frameworks except .Net.  We had a separate set of schemas for .Net.
+
+In the GW8 directory, you will find the WSDL and schema files.  Below this is a directory called "Differences - GW703 and GW8".  This directory contains the differences between the GroupWise 7.03 and GroupWise 8 WSDL and schemas in HTML format.  This may prove useful in understanding the changes.
+
+
+GroupWise 7 Only
+
+We have included the GroupWise 7 schemas for convenience.  You will find the shipping schemas for GroupWise 7 SP1, SP2 and SP3.
+
+
+
+Using the Right Schema in GroupWise 7
+
+With each iteration of GroupWise, GroupWise schemas and WSDL will change.  Our intention is to make sure that we are backward compatible with older versions of the schema.  However, we can't predict how each development framework will react to schema changes.  We don't have the time or the resources to verify that all developement frameworks are backward compatible with our schema changes.
+
+In the GroupWise Web Services download, you will find the "WSDL and schema" directory.  In that directory, you will find the GW7SP1 and GW7SP2 directory.  It has the GroupWise 7 SP1 and SP2 WSDL and schemas.  We recommend using the SP2 schemas.  Libraries build using the SP2 schemas should work with GroupWise 7 SP1 POAs.  
+
+If you are using Microsoft .Net 2003 or 2005.  See below for more information.
+
+
+Microsoft .Net 2003 and 2005
+
+We have found that Microsoft .Net 2003 and 2005 do not support some W3C schema elements.  We have modified the schemas to address the issues.  You can find the .Net schemas in the MS.Net directory below the WSDL and schemas directory.  We can't say for certain that we have identified all .Net schema issues.  Despite the schema changes, we believe that GroupWise Web Services and .Net should work together.
+
+The following list is not comprehensive.  Diff the schemas in the "WSDL and schemas" and the MS.Net directory for a complete list.

data/groupwise.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'groupwise/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "groupwise"
+  spec.version       = Groupwise::VERSION
+  spec.authors       = ["Curtis Schiewek"]
+  spec.email         = ["curtis.schiewek@gmail.com"]
+  spec.summary       = %q{Wrapper for Groupwise SOAP web services.}
+  spec.description   = spec.summary
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "savon", "~> 2.6.0", ">= 2.6.0"
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", "~> 10.3.2", ">= 10.3.2"
+  spec.add_development_dependency "rspec", "~> 3.0.0", ">= 3.0.0"
+  spec.add_development_dependency "debugger", "~> 1.6.8", ">= 1.6.8"
+end

data/lib/groupwise.rb

@@ -0,0 +1,16 @@
+require 'savon'
+require 'groupwise/version'
+
+module Groupwise
+  require 'groupwise/free_busy_session_message'
+  require 'groupwise/post_office_agent'
+
+  def self.wsdl_version(version)
+    version = version.tr('.','').to_i
+    dir = File.expand_path('../../contrib/novell/GW*', __FILE__)
+    versions = Dir[dir].map do |dir|    
+      dir.match(/(?<=GW)([^\n\r]*)/).captures.first.to_i
+    end
+    versions.min{|a,b|  (version-a).abs <=> (version-b).abs }.to_s
+  end
+end

data/lib/groupwise/free_busy_session_message.rb

@@ -0,0 +1,22 @@
+module Groupwise
+  class FreeBusySessionMessage
+    def initialize(email_addresses, start_time = nil, end_time = nil)
+      @email_addresses = email_addresses.is_a?(Array) ? email_addresses : [email_addresses]
+      @start_time, @end_time = start_time, end_time
+    end
+
+    def to_s
+      builder = Builder::XmlMarkup.new
+
+      builder.users { |b|
+        @email_addresses.each do |email|
+          b.user { |u| u.email(email) }
+        end
+      }
+      builder.startDate(@start_time.utc.iso8601) if @start_time
+      builder.endDate(@end_time.utc.iso8601) if @end_time
+
+      builder
+    end
+  end
+end

data/lib/groupwise/post_office_agent.rb

@@ -0,0 +1,68 @@
+module Groupwise
+  class PostOfficeAgent
+    attr_reader :endpoint, :client
+
+    def initialize(endpoint, username, app_name, app_key)
+      @endpoint, @username, @app_name, @app_key = endpoint, username, app_name, app_key
+      @client = Savon.client(wsdl: wsdl, endpoint: endpoint)
+      login
+    end
+
+    def version
+      @version ||= begin
+        body = HTTPI.get(HTTPI::Request.new(endpoint)).body
+        version = body.match(/(?<=POA )([^\n\r]*)/).captures.first
+      end
+    end
+
+    def wsdl
+      @wsdl ||= begin
+        wsdl_version = Groupwise.wsdl_version(version)
+        File.expand_path("../../../contrib/novell/GW#{wsdl_version}/groupwise.wsdl", __FILE__)
+      end
+    end
+
+    def logout
+      response = authenticated_request(:logout)
+      @session = nil if response[:status][:code] == '0'
+      return response
+    end
+
+    def free_busy(email_addresses, wait_time = 0, start_time = nil, end_time = nil)
+      message = { free_busy_session_id: free_busy_session(email_addresses, start_time, end_time) }
+      sleep wait_time
+      response = authenticated_request(:get_free_busy, message)[:free_busy_info]
+    end
+
+    private 
+
+    def login
+      message = {
+        auth: { username: @username, name: @app_name, key: @app_key }, 
+        version: '1.05', language: 'en',
+        attributes!: { auth: { 'xsi:type' => 'q1:TrustedApplication' } }
+      }
+      response = @client.call(:login_request, message: message)
+      @session = response.body[:login_response][:session]
+      response.body[:login_response]
+    end
+
+    def authenticated_request(method, message = nil)
+      response = @client.call(
+        "#{method}_request".to_sym, 
+        message: message, 
+        soap_header: { session: @session }
+      )
+      response.body["#{method}_response".to_sym]
+    end
+
+    def free_busy_session(email_addresses, start_time = nil, end_time = nil)
+      @free_busy_session ||= begin
+        message = FreeBusySessionMessage.new(email_addresses, start_time, end_time)
+        response = authenticated_request(:start_free_busy_session, message)
+        response[:free_busy_session_id]
+      end 
+    end
+
+  end
+end

data/lib/groupwise/version.rb

@@ -0,0 +1,3 @@
+module Groupwise
+  VERSION = "0.0.1"
+end

data/spec/groupwise/post_office_agent_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+require 'groupwise'
+include Groupwise
+
+describe PostOfficeAgent do
+  before do
+    @config = RSpec.configuration.groupwise_config['post_office_agent']
+    @poa = PostOfficeAgent.new(
+      @config['endpoint'], @config['username'], @config['app_name'], @config['app_key']
+    )
+  end
+
+  it 'should have an endpoint' do
+    expect(@poa.endpoint).to eq(@config['endpoint'])
+  end
+
+  it 'should detect the version' do
+    expect(@poa.version).to eq(@config['version'])
+  end
+
+  it 'should set the wsdl' do
+    expect(@poa.wsdl.split('/').last).to eq('groupwise.wsdl')
+  end
+
+  it 'should have a Savon client' do
+    expect(@poa.client).to be_a(Savon::Client)
+  end
+
+  it 'should set the session' do
+    expect(@poa.instance_variable_get('@session')).to_not be_nil
+  end
+
+  it 'should allow you to logout' do
+    expect(@poa.logout[:status][:code]).to eq('0')
+  end
+
+  it 'should be return free busy information' do
+    email_addresses = @config['users']
+    expect(@poa.free_busy(email_addresses)).to_not be_nil
+  end
+end

data/spec/groupwise/version_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe 'Version' do
+  it 'should exist' do
+    expect(Groupwise::VERSION).to_not be_nil
+  end
+end

data/spec/groupwise_config.yml.sample

@@ -0,0 +1,9 @@
+post_office_agent:
+  endpoint: 'http://127.0.0.1:7191/soap'
+  username: 'user'
+  app_name: 'TrustedApplication'
+  app_key:  'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA'
+  version:  '12.0.2'
+  users: 
+    - 'john.doe@domain.com'
+    - 'jane.doe@domain.com'

data/spec/groupwise_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe Groupwise do 
+  it 'should be defined' do
+    expect(defined?(Groupwise)).to eq('constant')
+  end
+
+  describe '.wsdl_version' do
+    it 'should return the closest matching version' do
+      expect(Groupwise.wsdl_version('12.0.2')).to eq('1201')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require 'yaml'
+
+RSpec.configure do |config|
+   config.add_setting :groupwise_config, 
+                      default: YAML.load(File.read('./spec/groupwise_config.yml'))
+end

metadata

@@ -0,0 +1,173 @@
+--- !ruby/object:Gem::Specification
+name: groupwise
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Curtis Schiewek
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: savon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.3.2
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 10.3.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.3.2
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 10.3.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: debugger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.8
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.6.8
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.8
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.6.8
+description: Wrapper for Groupwise SOAP web services.
+email:
+- curtis.schiewek@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- contrib/novell/GW1200/archive.wsdl
+- contrib/novell/GW1200/archive.xsd
+- contrib/novell/GW1200/events.xsd
+- contrib/novell/GW1200/groupwise.wsdl
+- contrib/novell/GW1200/methods.xsd
+- contrib/novell/GW1200/types.xsd
+- contrib/novell/GW1201/archive.wsdl
+- contrib/novell/GW1201/archive.xsd
+- contrib/novell/GW1201/events.xsd
+- contrib/novell/GW1201/groupwise.wsdl
+- contrib/novell/GW1201/methods.xsd
+- contrib/novell/GW1201/types.xsd
+- contrib/novell/readme.txt
+- groupwise.gemspec
+- lib/groupwise.rb
+- lib/groupwise/free_busy_session_message.rb
+- lib/groupwise/post_office_agent.rb
+- lib/groupwise/version.rb
+- spec/groupwise/post_office_agent_spec.rb
+- spec/groupwise/version_spec.rb
+- spec/groupwise_config.yml.sample
+- spec/groupwise_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.3.0
+signing_key: 
+specification_version: 4
+summary: Wrapper for Groupwise SOAP web services.
+test_files:
+- spec/groupwise/post_office_agent_spec.rb
+- spec/groupwise/version_spec.rb
+- spec/groupwise_config.yml.sample
+- spec/groupwise_spec.rb
+- spec/spec_helper.rb
+has_rdoc: