web-ex-events 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6313292bccf157b4ad36a2cbf03c81641e4bd024
+  data.tar.gz: 256e43c16759d10915bf1b80bf89ab29cb2404b8
+SHA512:
+  metadata.gz: d39ebb09c79cb01a8f18a02efcfe5645c67c7fce0ecaf3e549fa858fb078c4228407f010d5b4d4c482ab37a4cd3316414c6d3beff31d518bb9a1c8b182f0f408
+  data.tar.gz: 17931565713e2273947abc0298abbe5e123eb83ec66afc78ba0ccf5e5e8f7774b1384cf3f9414a2e01251257b3f1b6d945fdb5a44509bfc58e4b64d9d3d336e5

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in web-ex-events.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Pete Nicholls
+
+MIT License
+
+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/README.md

@@ -0,0 +1,56 @@
+# WebEx::Events
+
+A library to read WebEx events through the WebEx API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'web-ex-events'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install web-ex-events
+
+## Usage
+
+```ruby
+require 'web_ex/events'
+
+# Set WebEx site name
+ENV['WEB_EX_SITE_NAME'] = "…"
+
+# Web Ex Site and Partner ID (available through WebEx support request)
+ENV['WEB_EX_SITE_ID'] = "…"
+ENV['WEB_EX_PARTNER_ID'] = "…"
+
+# Your WebEx credentials
+ENV['WEB_EX_USERNAME'] = "…"
+ENV['WEB_EX_PASSWORD'] = "…"
+
+next_30_days = 30 * 24 * 60 * 60
+events = WebEx::Events::Event.fetch(next_30_days)
+
+# Print event details
+events.each do |event|
+  puts event.name
+  puts event.start_date
+  puts "#{event.duration} mins"
+  puts event.description
+end
+
+# Print all events as JSON
+puts events.to_json
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/web_ex/events.rb

@@ -0,0 +1,10 @@
+require 'nokogiri'
+require 'httparty'
+require 'tzinfo'
+
+require "web_ex/events/version"
+require "web_ex/events/configuration"
+require "web_ex/events/event"
+require "web_ex/events/event_list"
+require "web_ex/events/event_summary_request"
+require "web_ex/events/time_with_zone"

data/lib/web_ex/events/configuration.rb

@@ -0,0 +1,15 @@
+module WebEx
+  module Events
+    class Configuration
+    
+      %w( site_name site_id username password partner_id ).each do |name|
+        define_singleton_method(name) { ENV["WEBEX_#{name.upcase}"] }
+      end
+    
+      def self.xml_service_url
+        "https://#{site_name}.webex.com/WBXService/XMLService"
+      end
+    
+    end
+  end
+end

data/lib/web_ex/events/event.rb

@@ -0,0 +1,43 @@
+module WebEx
+  module Events
+    class Event
+      attr_accessor :name, :start_date, :end_date, :key, :description, :duration
+    
+      def initialize(attributes = {})
+        attributes.each do |k, v|
+          send("#{k}=", v)
+        end
+      end
+    
+      def to_json(*args)
+        JSON.dump(
+          name: name,
+          start_date: start_date,
+          end_date: end_date,
+          key: key,
+          description: description,
+          duration: duration
+        )
+      end
+    
+      def self.from_xml(xml)
+        node = Nokogiri::XML(xml)
+        element = node.xpath('event')
+      
+        self.new(
+          name: element.xpath('sessionName').text,
+          start_date: TimeWithZone.new(element.xpath('startDate').text, element.xpath('timeZoneID').text).to_datetime,
+          end_date: TimeWithZone.new(element.xpath('endDate').text, element.xpath('timeZoneID').text).to_datetime,
+          key: element.xpath('sessionKey').text,
+          description: element.xpath('description').text,
+          duration: element.xpath('duration').text.to_i
+        )
+      end
+    
+      def self.fetch(time_frame)
+        request = EventSummaryRequest.new(start_date: Time.now, end_date: Time.now + time_frame)
+        request.find_events!
+      end
+    end
+  end
+end

data/lib/web_ex/events/event_list.rb

@@ -0,0 +1,31 @@
+module WebEx
+  module Events
+    class EventList
+      include Enumerable
+    
+      def initialize(*events)
+        @events = events.flatten
+      end
+    
+      def length
+        @events.length
+      end
+    
+      def each(&block)
+        @events.each(&block)
+      end
+    
+      def last
+        @events.last
+      end
+    
+      def empty?
+        @events.empty?
+      end
+    
+      def to_json
+        JSON.dump(@events)
+      end
+    end
+  end
+end

data/lib/web_ex/events/event_summary_request.rb

@@ -0,0 +1,75 @@
+module WebEx
+  module Events
+    class EventSummaryRequest
+      WEBEX_EMPTY_RESULTS_EXCEPTION_ID = "000015"
+    
+      attr_accessor :start_date, :end_date
+    
+      def initialize(options = {})
+        @start_date, @end_date = options[:start_date], options[:end_date]
+      end
+    
+      def find_events!
+        events = xml_response.xpath('//event').map do |node|
+          Event.from_xml(node.to_xml)
+        end
+      
+        EventList.new(events)
+      end
+    
+      def payload
+        <<-XML
+          <?xml version="1.0" encoding="UTF-8"?>
+          <message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+            <header>
+              <securityContext>
+                <webExID>#{Configuration.username}</webExID>
+                <password>#{Configuration.password}</password>
+                <siteID>#{Configuration.site_id}</siteID>
+                <partnerID>#{Configuration.partner_id}</partnerID>
+              </securityContext>
+            </header>
+            <body>
+              <bodyContent xsi:type="java:com.webex.service.binding.event.LstsummaryEvent">
+                <listControl>
+                  <startFrom/>
+                </listControl>
+                <order>
+                  <orderBy>STARTTIME</orderBy>
+                </order>
+                <dateScope>
+                  <startDateStart>#{formatted_date start_date}</startDateStart>
+                  <endDateEnd>#{formatted_date end_date}</endDateEnd>
+                  <timeZoneID>#{TimeWithZone::UTC_ZONE_ID}</timeZoneID>
+                </dateScope>
+              </bodyContent>
+            </body>
+          </message>
+        XML
+      end
+    
+      private
+    
+      def response
+        @response ||= HTTParty.post(Configuration.xml_service_url, body: payload)
+      end
+    
+      def xml_response
+        @xml_response ||= begin
+          xml = Nokogiri::XML(response.body)
+          webex_exception = xml.at_xpath('//serv:exceptionID')
+              
+          if webex_exception && webex_exception.content != WEBEX_EMPTY_RESULTS_EXCEPTION_ID
+            raise "WebEx Error: #{xml.at_xpath('//serv:reason').content}" 
+          end
+        
+          xml.remove_namespaces!
+        end
+      end
+    
+      def formatted_date(date)
+        date.utc.strftime('%m/%d/%Y %H:%M:%S') if date
+      end
+    end
+  end
+end

data/lib/web_ex/events/time_with_zone.rb

@@ -0,0 +1,83 @@
+module WebEx
+  module Events
+    class TimeWithZone
+      UTC_ZONE_ID = 21
+    
+      TIME_ZONE_MAPPINGS = {
+         0 => "Pacific/Niue",
+         1 => "Pacific/Apia",
+         2 => "Pacific/Honolulu",
+         3 => "America/Juneau ",
+         4 => "America/Los_Angeles",
+         5 => "America/Phoenixr",
+         6 => "America/Denver",
+         7 => "America/Chicago",
+         8 => "America/Tegucigalpa",
+         9 => "America/Regina",
+        10 => "America/Bogota",
+        11 => "America/New_York",
+        12 => "America/Indiana/Indianapolis",
+        13 => "America/Halifax",
+        14 => "America/Caracas",
+        15 => "America/St_Johns",
+        16 => "America/Sao_Paulo",
+        17 => "America/Argentina/Buenos_Aires",
+        18 => "Atlantic/South_Georgia",
+        19 => "Atlantic/Azores",
+        20 => "Africa/Casablanca",
+        21 => "Europe/London",
+        22 => "Europe/Amsterdam",
+        23 => "Europe/Paris",
+        24 => "Europe/Paris",
+        25 => "Europe/Berlin",
+        26 => "Europe/Athens",
+        27 => "Europe/Athens",
+        28 => "Africa/Cairo",
+        29 => "Africa/Johannesburg",
+        30 => "Europe/Helsinki",
+        31 => "Asia/Amman",
+        32 => "Asia/Baghdad",
+        33 => "Europe/Moscow",
+        34 => "Africa/Nairobi",
+        35 => "Asia/Tehran",
+        36 => "Asia/Muscat",
+        37 => "Asia/Baku",
+        38 => "Asia/Kabul",
+        39 => "Asia/Yekaterinburg",
+        40 => "Asia/Karachi",
+        41 => "Asia/Kolkata",
+        42 => "Asia/Colombo",
+        43 => "Asia/Almaty",
+        44 => "Asia/Bangkok",
+        45 => "Asia/Shanghai",
+        46 => "Australia/Perth",
+        47 => "Asia/Singapore",
+        48 => "Asia/Taipei",
+        49 => "Asia/Tokyo",
+        50 => "Asia/Seoul",
+        51 => "Asia/Yakutsk",
+        52 => "Australia/Adelaide",
+        53 => "Australia/Darwin",
+        54 => "Australia/Brisbane",
+        55 => "Australia/Sydney",
+        56 => "Pacific/Guam",
+        57 => "Australia/Hobart",
+        58 => "Asia/Vladivostok",
+        59 => "Asia/Magadan",
+        60 => "Pacific/Auckland",
+        61 => "Pacific/Fiji"
+      }
+    
+      def initialize(date_string, timezone_id)
+        @date_string = date_string
+        @timezone_id = timezone_id.to_i
+      end
+    
+      def to_datetime
+        month, day, year, hour, minute, second = @date_string.split(/[\/ :]/).map(&:to_i)
+        time_zone = TZInfo::Timezone.get(TIME_ZONE_MAPPINGS[@timezone_id])
+        time_zone.local_to_utc DateTime.new(year, month, day, hour, minute, second)
+      end
+    end
+  end
+end

data/lib/web_ex/events/version.rb

@@ -0,0 +1,5 @@
+module WebEx
+  module Events
+    VERSION = "1.0.1"
+  end
+end

data/spec/fixtures/responses/webex_events.xml

@@ -0,0 +1,200 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
+ <serv:header>
+  <serv:response>
+   <serv:result>SUCCESS</serv:result>
+   <serv:gsbStatus>PRIMARY</serv:gsbStatus>
+  </serv:response>
+ </serv:header>
+ <serv:body>
+  <serv:bodyContent xsi:type="event:lstsummaryEventResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+   <event:matchingRecords>
+    <serv:total>13</serv:total>
+    <serv:returned>13</serv:returned>
+    <serv:startFrom>1</serv:startFrom>
+   </event:matchingRecords>
+   <event:event>
+    <event:sessionKey>337167902</event:sessionKey>
+    <event:sessionName>Baking Basics</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/01/2013 05:00:00</event:startDate>
+    <event:endDate>05/01/2013 06:30:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>90</event:duration>
+    <event:description>Learn the intricacies of Japanese baking in this 90 minute webinar.</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists></event:panelists>
+    <event:listStatus>UNLISTED</event:listStatus>
+   </event:event>
+   <event:event>
+    <event:sessionKey>241299796</event:sessionKey>
+    <event:sessionName>Advanced Baking</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/01/2013 08:00:00</event:startDate>
+    <event:endDate>05/01/2013 09:00:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>60</event:duration>
+    <event:description>Learn the intricacies of Japanese baking in this 90 minute webinar.</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists>Satoshi Nakamoto</event:panelists>
+    <event:listStatus>UNLISTED</event:listStatus>
+   </event:event>
+   <event:event>
+    <event:sessionKey>741475588</event:sessionKey>
+    <event:sessionName>Baking Basics</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/01/2013 11:00:00</event:startDate>
+    <event:endDate>05/01/2013 12:30:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>90</event:duration>
+    <event:description>Learn the intricacies of Japanese baking in this 90 minute webinar.</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists></event:panelists>
+    <event:listStatus>UNLISTED</event:listStatus>
+   </event:event>
+   <event:event>
+    <event:sessionKey>785125343</event:sessionKey>
+    <event:sessionName>Baking Basics</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/01/2013 13:00:00</event:startDate>
+    <event:endDate>05/01/2013 14:30:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>90</event:duration>
+    <event:description>Learn the intricacies of Japanese baking in this 90 minute webinar.</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists></event:panelists>
+    <event:listStatus>UNLISTED</event:listStatus>
+   </event:event>
+   <event:event>
+    <event:sessionKey>516377344</event:sessionKey>
+    <event:sessionName>Baking Basics</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/02/2013 05:00:00</event:startDate>
+    <event:endDate>05/02/2013 06:30:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>90</event:duration>
+    <event:description>Learn the intricacies of Japanese baking in this 90 minute webinar.</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists></event:panelists>
+    <event:listStatus>UNLISTED</event:listStatus>
+   </event:event>
+   <event:event>
+    <event:sessionKey>675735386</event:sessionKey>
+    <event:sessionName>Advanced Baking</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/02/2013 08:00:00</event:startDate>
+    <event:endDate>05/02/2013 09:00:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>60</event:duration>
+    <event:description>Learn the intricacies of Japanese baking in this 90 minute webinar.</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists>Satoshi Nakamoto</event:panelists>
+    <event:listStatus>UNLISTED</event:listStatus>
+   </event:event>
+   <event:event>
+    <event:sessionKey>448544768</event:sessionKey>
+    <event:sessionName>Baking Basics</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/02/2013 11:00:00</event:startDate>
+    <event:endDate>05/02/2013 12:30:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>90</event:duration>
+    <event:description>Learn the intricacies of Japanese baking in this 90 minute webinar.</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists></event:panelists>
+    <event:listStatus>UNLISTED</event:listStatus>
+   </event:event>
+   <event:event>
+    <event:sessionKey>548465686</event:sessionKey>
+    <event:sessionName>Baking Basics</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/02/2013 13:00:00</event:startDate>
+    <event:endDate>05/02/2013 14:30:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>90</event:duration>
+    <event:description>Learn the intricacies of Japanese baking in this 90 minute webinar.</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists></event:panelists>
+    <event:listStatus>UNLISTED</event:listStatus>
+   </event:event>
+   <event:event>
+    <event:sessionKey>265268976</event:sessionKey>
+    <event:sessionName>Advanced Baking</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/03/2013 08:00:00</event:startDate>
+    <event:endDate>05/03/2013 09:00:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>60</event:duration>
+    <event:description>Learn the intricacies of Japanese baking in this 90 minute webinar.</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists>Satoshi Nakamoto</event:panelists>
+    <event:listStatus>UNLISTED</event:listStatus>
+   </event:event>
+   <event:event>
+    <event:sessionKey>223574221</event:sessionKey>
+    <event:sessionName>Baking Basics</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/07/2013 05:00:00</event:startDate>
+    <event:endDate>05/07/2013 06:30:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>90</event:duration>
+    <event:description>Learn the intricacies of Japanese baking in this 90 minute webinar.</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists></event:panelists>
+    <event:listStatus>UNLISTED</event:listStatus>
+   </event:event>
+   <event:event>
+    <event:sessionKey>495477388</event:sessionKey>
+    <event:sessionName>Advanced Baking</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/07/2013 11:00:00</event:startDate>
+    <event:endDate>05/07/2013 12:00:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>60</event:duration>
+    <event:description>Learn advanced Japanese baking techniques in this hour-long webinar.</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists></event:panelists>
+    <event:listStatus>PUBLIC</event:listStatus>
+   </event:event>
+   <event:event>
+    <event:sessionKey>252653476</event:sessionKey>
+    <event:sessionName>Baking Basics</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/07/2013 11:00:00</event:startDate>
+    <event:endDate>05/07/2013 12:30:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>90</event:duration>
+    <event:description>Learn the intricacies of Japanese baking in this 90 minute webinar.</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists></event:panelists>
+    <event:listStatus>UNLISTED</event:listStatus>
+   </event:event>
+   <event:event>
+    <event:sessionKey>356727241</event:sessionKey>
+    <event:sessionName>Baking Finale</event:sessionName>
+    <event:sessionType>220</event:sessionType>
+    <event:hostWebExID>bakery</event:hostWebExID>
+    <event:startDate>05/07/2013 13:00:00</event:startDate>
+    <event:endDate>05/07/2013 14:30:00</event:endDate>
+    <event:timeZoneID>4</event:timeZoneID>
+    <event:duration>90</event:duration>
+    <event:description>A 90 minute wrap-up event!</event:description>
+    <event:status>NOT_INPROGRESS</event:status>
+    <event:panelists></event:panelists>
+    <event:listStatus>UNLISTED</event:listStatus>
+   </event:event>
+  </serv:bodyContent>
+ </serv:body>
+</serv:message>

data/spec/fixtures/responses/webex_events_auth_error.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
+ <serv:header>
+  <serv:response>
+   <serv:result>FAILURE</serv:result>
+   <serv:reason>Corresponding User not found</serv:reason>
+   <serv:gsbStatus>PRIMARY</serv:gsbStatus>
+   <serv:exceptionID>030001</serv:exceptionID>
+  </serv:response>
+ </serv:header>
+ <serv:body>
+  <serv:bodyContent/>
+ </serv:body>
+</serv:message>

data/spec/fixtures/responses/webex_events_no_results.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
+ <serv:header>
+  <serv:response>
+   <serv:result>FAILURE</serv:result>
+   <serv:reason>Sorry, no record found</serv:reason>
+   <serv:gsbStatus>PRIMARY</serv:gsbStatus>
+   <serv:exceptionID>000015</serv:exceptionID>
+  </serv:response>
+ </serv:header>
+ <serv:body>
+  <serv:bodyContent/>
+ </serv:body>
+</serv:message>

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require 'bundler/setup'
+require 'web_ex/events'
+require 'json'
+require 'timecop'
+
+include WebEx::Events

data/spec/web_ex/events/configuration_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe Configuration do
+  context "with all environment variables present" do
+    before :each do
+      ENV.stub(:[]).with("WEBEX_SITE_NAME").and_return("bakeryevents")
+      ENV.stub(:[]).with("WEBEX_USERNAME").and_return("bakery")
+      ENV.stub(:[]).with("WEBEX_PASSWORD").and_return("secret")
+      ENV.stub(:[]).with("WEBEX_SITE_ID").and_return("358562")
+      ENV.stub(:[]).with("WEBEX_PARTNER_ID").and_return("123ab")
+    end
+  
+    it { Configuration.site_name.should == "bakeryevents" }
+    it { Configuration.username.should == "bakery" }
+    it { Configuration.password.should == "secret" }
+    it { Configuration.site_id.should == "358562" }
+    it { Configuration.partner_id.should == "123ab" }
+    it { Configuration.xml_service_url.should == "https://bakeryevents.webex.com/WBXService/XMLService" }
+  end
+end

data/spec/web_ex/events/event_list_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+describe EventList do
+  let(:event_a) { stub }
+  let(:event_b) { stub }
+  let(:event_c) { stub }
+  
+  describe "#each" do
+    let(:event_list) { EventList.new(event_a, event_b, event_c) }
+    
+    it "iterates over each event" do
+      captured_events = []
+      event_list.each { |event| captured_events << event }
+      captured_events.should == [event_a, event_b, event_c]
+    end
+  end
+  
+  describe "#to_json" do
+    let(:event_list) { EventList.new(event_a, event_b) }
+    
+    before :each do
+      event_a.stub(to_json: '{ "event": "a" }')
+      event_b.stub(to_json: '{ "event": "b" }')
+    end
+    
+    it "returns a JSON representation of all events" do
+      JSON.parse(event_list.to_json).should == [{ 'event' => 'a' }, { 'event' => 'b' }]
+    end
+  end
+  
+  describe "#length" do
+    it "returns the number of events" do
+      EventList.new(event_a, event_b).length.should == 2
+      EventList.new(event_a, event_b, event_c).length.should == 3
+    end
+  end
+  
+  context "with three events" do
+    let(:event_list) { EventList.new(event_a, event_b, event_c) }
+    
+    describe "#first and #last" do
+      it { event_list.first.should == event_a }
+      it { event_list.last.should == event_c }
+    end
+  end
+  
+  context "with no events" do
+    subject {  EventList.new }
+    it { should be_empty }
+  end
+  
+  context "with at least one event" do
+    subject { EventList.new(event_a) }
+    it { should_not be_empty }
+  end
+  
+end

data/spec/web_ex/events/event_spec.rb

@@ -0,0 +1,114 @@
+require "spec_helper"
+
+describe Event do
+  let(:valid_attributes) {
+    {
+      name: "Cupcake Giveaway",
+      start_date: DateTime.now,
+      end_date: DateTime.now + 3600,
+      key: "12345",
+      description: "Free cupcakes!",
+      duration: 60
+    }
+  }
+  
+  let(:event) { Event.new(valid_attributes) }
+  
+  it "can has accessors for valid attributes" do
+    valid_attributes.each do |name, value|
+      event.send(name).should == value
+    end
+  end
+  
+  describe "#to_json" do
+    let(:json) { JSON.parse(event.to_json) }
+    
+    it "contains all the valid attributes" do
+      json["name"].should == "Cupcake Giveaway"
+      json["start_date"].inspect.should == JSON.dump(DateTime.now)
+      json["end_date"].inspect.should == JSON.dump(DateTime.now + 3600)
+      json["key"].should == "12345"
+      json["duration"].should == 60
+      json["description"].should == "Free cupcakes!"
+    end
+  end
+  
+  describe ".from_xml" do
+    let(:xml) {
+      <<-XML
+        <event>
+          <sessionKey>662050914</sessionKey>
+          <sessionName>NE Utilities - Transition Webinar Navtrak to Fleet</sessionName>
+          <sessionType>220</sessionType>
+          <hostWebExID>bakery</hostWebExID>
+          <startDate>04/30/2013 05:00:00</startDate>
+          <endDate>04/30/2013 06:30:00</endDate>
+          <timeZoneID>4</timeZoneID>
+          <duration>90</duration>
+          <description>During this webinar you will be trained on the bakery Fleet application.</description>
+          <status>NOT_INPROGRESS</status>
+          <panelists></panelists>
+          <listStatus>UNLISTED</listStatus>
+        </event>
+      XML
+    }
+    
+    let(:parsed_event) { Event.from_xml(xml) }
+    
+    it "can parse an event" do
+      parsed_event.name.should == "NE Utilities - Transition Webinar Navtrak to Fleet"
+      parsed_event.key.should == "662050914"
+      parsed_event.duration.should == 90
+      parsed_event.description.should == "During this webinar you will be trained on the bakery Fleet application."
+    end
+    
+    context "with a timezone not in daylight savings" do
+      let(:xml) {
+        <<-XML
+          <event>
+            <startDate>02/15/2013 05:00:00</startDate>
+            <endDate>02/15/2013 06:30:00</endDate>
+            <timeZoneID>4</timeZoneID>
+          </event>
+        XML
+      }
+      
+      it "parses the date correctly" do
+        parsed_event.start_date.should == DateTime.new(2013, 2, 15, 5, 0, 0, "-08:00")
+        parsed_event.end_date.should == DateTime.new(2013, 2, 15, 6, 30, 0, "-08:00")
+      end
+    end
+    
+    context "with a timezone inside daylight savings" do
+      let(:xml) {
+        <<-XML
+          <event>
+            <startDate>04/30/2013 05:00:00</startDate>
+            <endDate>04/30/2013 06:30:00</endDate>
+            <timeZoneID>4</timeZoneID>
+          </event>
+        XML
+      }
+      
+      it "corrects for daylight savings" do
+        parsed_event.start_date.should == DateTime.new(2013, 4, 30, 5, 0, 0, "-07:00")
+        parsed_event.end_date.should == DateTime.new(2013, 4, 30, 6, 30, 0, "-07:00")
+      end
+    end
+  end
+  
+  describe ".fetch" do
+    it "creates a new event summary request using the time frame" do
+      Timecop.freeze do
+        request = stub(find_events!: "events")
+        ten_days = 10 * 24 * 60 * 60
+
+        EventSummaryRequest.should_receive(:new)
+                                  .with(start_date: Time.now, end_date: Time.now + ten_days)
+                                  .and_return(request)
+        
+        Event.fetch(ten_days).should == "events"
+      end
+    end
+  end
+end

data/spec/web_ex/events/event_summary_request_spec.rb

@@ -0,0 +1,137 @@
+require 'spec_helper'
+require 'fakeweb'
+
+describe EventSummaryRequest do
+  def fixture_path(name)
+    File.expand_path("../../../fixtures/#{name}", __FILE__)
+  end
+  
+  context "with a start date of a day ago and end date in a weeks' time" do
+    let(:one_second) { 1 }
+    let(:one_day_ago) { Time.now - (24 * 60 * 60) }
+    let(:seven_days_from_now) { Time.now + (7 * 24 * 60 * 60) }
+
+    let(:req) { EventSummaryRequest.new(start_date: one_day_ago, end_date: seven_days_from_now) }
+  
+    describe "#start_date" do
+      subject { req.start_date }
+      it { should be_within(one_second).of(one_day_ago) }
+    end
+  
+    describe "#end_date" do
+      subject { req.end_date }
+      it { should be_within(one_second).of(seven_days_from_now) }
+    end
+  end
+  
+  describe "#payload" do
+    let(:req)  { EventSummaryRequest.new }
+    let(:xml) { Nokogiri::XML(req.payload) }
+        
+    describe "<?xml ?> processing instruction" do
+      subject { xml.at_xpath('/processing-instruction("xml")').content }
+      it { should include("UTF-8") }  
+    end
+    
+    describe "namespaces" do
+      let(:namespaces) { xml.collect_namespaces }
+      it { namespaces.should have_key('xmlns:xsi') }
+    end
+    
+    describe "security context" do    
+      before :each do
+        Configuration.stub(
+          site_name: "wafflehut",
+          site_id: "12345",
+          username: "bobwaffles",
+          password: "maplesyrup",
+          partner_id: "p4rtn3r"
+        )
+      end
+    
+      let(:security_context) { xml.at_xpath('/message/header/securityContext') }
+      it { security_context.at_xpath('./webExID').content.should == "bobwaffles" }
+      it { security_context.at_xpath('./password').content.should == "maplesyrup" }
+      it { security_context.at_xpath('./siteID').content.should == "12345" }
+      it { security_context.at_xpath('./partnerID').content.should == "p4rtn3r" }
+    end
+    
+    describe "body content" do
+      let(:body_content) { xml.at_xpath('/message/body/bodyContent') }
+      it { body_content['xsi:type'].should include('LstsummaryEvent') }
+      it { body_content.at_xpath('./listControl/startFrom').should_not be_nil }
+      it { body_content.at_xpath('./order').should_not be_nil }
+      it { body_content.at_xpath('./dateScope').should_not be_nil }
+    end
+    
+    context "with start and end dates in a time zone" do
+      before :each do
+        midday_pancake_tuesday = Time.new(2014, 3, 4, 12, 0, 0, "+02:00")
+        three_thirty_pm_pancake_tuesday = Time.new(2014, 3, 4, 15, 30, 0, "+02:00")
+        req.stub(start_date: midday_pancake_tuesday, end_date: three_thirty_pm_pancake_tuesday)
+      end
+      
+      describe "date scope" do
+        let(:date_scope) { xml.at_xpath('/message/body/bodyContent/dateScope') }
+        
+        it "formats dates appropriately and in UTC time" do
+          date_scope.at_xpath('./startDateStart').content.should == "03/04/2014 10:00:00"
+          date_scope.at_xpath('./endDateEnd').content.should == "03/04/2014 13:30:00"
+        end
+        
+        it "uses the UTC time zone ID" do
+          date_scope.at_xpath('./timeZoneID').content.should == "21"
+        end
+      end
+    end
+  end
+  
+  describe "#find_events!" do
+    let(:req) { EventSummaryRequest.new }
+      
+    before :each do
+      Configuration.stub(xml_service_url: "https://webex-api.example.com/service")
+      FakeWeb.register_uri(:post, "https://webex-api.example.com/service", body: response_body)
+      req.stub(payload: "XML")
+    end
+      
+    context "when the server responds with events" do
+      let(:response_body) { fixture_path("responses/webex_events.xml") }
+      
+      it "creates a new event using from each event node" do
+        Event.should_receive(:from_xml).exactly(13).times
+        req.find_events!
+      end
+      
+      it "returns the events in an event list" do
+        events = req.find_events!
+        events.should be_a(EventList)
+        events.length.should == 13
+        events.first.name.should == "Baking Basics"
+        events.last.name.should == "Baking Finale"
+      end
+    end
+    
+    context "when the server responds without events" do
+      let(:response_body) { fixture_path("responses/webex_events_no_results.xml") }
+      
+      it "returns an empty list" do
+        events = req.find_events!
+        events.should be_a(EventList)
+        events.should be_empty        
+      end
+    end
+    
+    context "when the server responds with an authentication error" do
+      let(:response_body) { fixture_path("responses/webex_events_auth_error.xml") }
+      
+      it "raises an error with the server's reason for the error" do
+        -> {
+          req.find_events!
+        }.should raise_error { |error|
+          error.message.should include('Corresponding User not found')
+        }
+      end
+    end
+  end
+end

data/web-ex-events.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'web_ex/events/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "web-ex-events"
+  spec.version       = WebEx::Events::VERSION
+  spec.authors       = ["Pete Nicholls"]
+  spec.email         = ["pete@metanation.com"]
+  spec.description   = "Allows fetching and parsing WebEx events through the WebEx API. Events can be queried and converted into JSON."
+  spec.summary       = "A library to read WebEx events through the WebEx API."
+  spec.homepage      = "https://github.com/Aupajo/web-ex-events"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  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_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "timecop"
+  spec.add_development_dependency "fakeweb"
+  
+  spec.add_dependency "tzinfo"
+  spec.add_dependency "httparty"
+  spec.add_dependency "nokogiri"
+end

metadata

@@ -0,0 +1,186 @@
+--- !ruby/object:Gem::Specification
+name: web-ex-events
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- Pete Nicholls
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tzinfo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Allows fetching and parsing WebEx events through the WebEx API. Events
+  can be queried and converted into JSON.
+email:
+- pete@metanation.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/web_ex/events.rb
+- lib/web_ex/events/configuration.rb
+- lib/web_ex/events/event.rb
+- lib/web_ex/events/event_list.rb
+- lib/web_ex/events/event_summary_request.rb
+- lib/web_ex/events/time_with_zone.rb
+- lib/web_ex/events/version.rb
+- spec/fixtures/responses/webex_events.xml
+- spec/fixtures/responses/webex_events_auth_error.xml
+- spec/fixtures/responses/webex_events_no_results.xml
+- spec/spec_helper.rb
+- spec/web_ex/events/configuration_spec.rb
+- spec/web_ex/events/event_list_spec.rb
+- spec/web_ex/events/event_spec.rb
+- spec/web_ex/events/event_summary_request_spec.rb
+- web-ex-events.gemspec
+homepage: https://github.com/Aupajo/web-ex-events
+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.0.3
+signing_key: 
+specification_version: 4
+summary: A library to read WebEx events through the WebEx API.
+test_files:
+- spec/fixtures/responses/webex_events.xml
+- spec/fixtures/responses/webex_events_auth_error.xml
+- spec/fixtures/responses/webex_events_no_results.xml
+- spec/spec_helper.rb
+- spec/web_ex/events/configuration_spec.rb
+- spec/web_ex/events/event_list_spec.rb
+- spec/web_ex/events/event_spec.rb
+- spec/web_ex/events/event_summary_request_spec.rb