twiddla 0.1.0

data/README.md

@@ -0,0 +1,47 @@
+Twiddla
+## Installation
+
+http://rubygems.org/gems/twiddla
+
+    gem install twiddla
+
+## Usage
+
+Set up API key
+
+    require 'twiddla'
+    Twiddla.auth!('username', 'password') # set your own API key here
+
+Create user
+
+    options = {
+      newusername: 'john_doe',
+      newpassword: 'password',
+      displayname: 'John Doe'
+    }
+    user_name = Twiddla::API.create_user(options)
+
+Create meeting
+
+    options = { meetingtitle: 'Title', meetingpassword: 'password' }
+    session_id = Twiddla::API.create_meeting(options)
+
+Embeddable meeting url
+
+    meeting_url = Twiddla::API.meeting_url(session_id)
+
+List active meetings
+
+    meetings = Twiddla::API.active_meetings
+
+List snapshots
+
+    snapshots = Twiddla::API.snapshots
+
+Delete meeting
+
+    Twiddla::API.delete(session_id)
+
+## Twiddla API References
+
+http://www.twiddla.com/API/Reference.aspx

data/lib/twiddla.rb

@@ -0,0 +1 @@
+require 'twiddla/base'

data/lib/twiddla/api.rb

@@ -0,0 +1,61 @@
+module Twiddla
+  class API
+    class << self
+      attr_accessor :username, :password
+
+      def create_user(options)
+        api_call('CreateUser', options)
+      end
+
+      def create_meeting(options={})
+        call('new', options)
+      end
+
+      def meeting_url(session_id, options = {})
+        params = { sessionid: session_id }.merge(options)
+        "#{twiddla_url('api/Start')}?#{URI.encode_www_form(params)}"
+      end
+
+      def active_meetings
+        api_call('ListActive').split(',')
+      end
+
+      def snapshots(session_id = nil)
+        params = session_id ? { sessionid: session_id } : {}
+        api_call('ListSnapshots', params)
+      end
+
+      def delete_meeting(session_id)
+        api_call('DeleteSession', { sessionid: session_id })
+      end
+
+      private
+
+      def api_call(path, params = {})
+        call("api/#{path}", params)
+      end
+
+      def call(path, params = {})
+        uri = URI.parse(twiddla_url(path))
+        response = Net::HTTP.post_form(uri, auth_params.merge(params))
+        check_for_errors_and_return response.body.to_s
+      end
+
+      def twiddla_url(path)
+        "http://www.twiddla.com/#{path}.aspx"
+      end
+
+      def auth_params
+        { username: username, password: password }
+      end
+
+      LEADING_NEGATIVE_INTEGER = /-\d/
+      def check_for_errors_and_return(response_body)
+        raise APIError.new(response_body) if response_body.match(LEADING_NEGATIVE_INTEGER)
+        response_body
+      end
+    end
+  end
+
+  class Twiddla::APIError < Exception; end
+end

data/lib/twiddla/base.rb

@@ -0,0 +1,9 @@
+require 'net/http'
+require 'twiddla/api'
+
+module Twiddla
+  def self.auth!(username, password)
+    API.password = password
+    API.username = username
+  end
+end

data/lib/twiddla/version.rb

@@ -0,0 +1,3 @@
+module Twiddla
+  VERSION = "0.1.0"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+require 'Twiddla'
+include Twiddla

data/spec/twiddla_spec.rb

@@ -0,0 +1,60 @@
+require 'spec_helper'
+
+describe Twiddla::API do
+  before :each do
+    Twiddla.auth!('username', 'password')
+    @response = mock()
+    @response.stub(:body).and_return('')
+    Net::HTTP.stub(:post_form).and_return(@response)
+    @session_id = rand(1000)
+  end
+
+  describe '.create_user' do
+    it 'calls "CreateUser"' do
+      options = {
+        newusername: 'foo',
+        newpassword: 'bar',
+        displayname: 'foo bar',
+        email:       'foo@example.com',
+      }
+      Twiddla::API.should_receive(:api_call).with('CreateUser', options).and_return(options[:displayname])
+      Twiddla::API.create_user(options)
+    end
+  end
+
+  describe '.create_meeting' do
+    it 'calls "new"' do
+      Twiddla::API.should_receive(:call).with('new', {}).and_return(@session_id)
+      Twiddla::API.create_meeting
+    end
+  end
+
+  describe '.meeting_url' do
+    it 'creates embeddable url' do
+      regex = /api\/Start\.aspx\?sessionid=#{@session_id}$/
+      Twiddla::API.meeting_url(@session_id).should match(regex)
+    end
+  end
+
+  describe '.active_meetings' do
+    it 'calls "ListActive"' do
+      session_ids = [@session_id, @session_id + 1].map(&:to_s)
+      Twiddla::API.should_receive(:api_call).with('ListActive').and_return(session_ids.join(','))
+      Twiddla::API.active_meetings.should == session_ids
+    end
+  end
+
+  describe '.snapshots' do
+    it 'calls "ListSnapshots"' do
+      Twiddla::API.should_receive(:call).with('api/ListSnapshots', { sessionid: @session_id })
+      Twiddla::API.snapshots(@session_id)
+    end
+  end
+
+  describe '.delete_meeting' do
+    it 'calls "DeleteSession"' do
+      Twiddla::API.should_receive(:call).with('api/DeleteSession', { sessionid: @session_id }).and_return('1')
+      Twiddla::API.delete_meeting(@session_id)
+    end
+  end
+end

data/twiddla.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "twiddla/version"
+
+Gem::Specification.new do |s|
+  s.name          = "twiddla"
+  s.version       = Twiddla::VERSION
+  s.date          = "2013-02-17"
+  s.authors       = ["Hwan-Joon Choi"]
+  s.email         = ["hc5duke@gmail.com"]
+  s.homepage      = "https://github.com/hc5duke/twiddla"
+
+  s.summary       = "Twiddla API ruby wrapper."
+  s.description   = "Twiddla API in ruby."
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec", "~>2.5"
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification
+name: twiddla
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Hwan-Joon Choi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.5'
+description: Twiddla API in ruby.
+email:
+- hc5duke@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/twiddla.rb
+- lib/twiddla/api.rb
+- lib/twiddla/base.rb
+- lib/twiddla/version.rb
+- spec/spec_helper.rb
+- spec/twiddla_spec.rb
+- twiddla.gemspec
+homepage: https://github.com/hc5duke/twiddla
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Twiddla API ruby wrapper.
+test_files:
+- spec/spec_helper.rb
+- spec/twiddla_spec.rb