zoomus 0.0.5

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,8 @@
+source :rubygems
+
+gem 'httparty'
+gem 'json'
+group :test do
+  gem 'rspec'
+  gem 'webmock'
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Maxim Colls
+
+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/Makefile

@@ -0,0 +1,5 @@
+help:
+	@echo "make console"
+
+console:
+	irb -rubygems -I lib -r zoomus.rb

data/README.md

@@ -0,0 +1,35 @@
+# Zoomus Gem
+
+Ruby wrapper gem for zoom.us API v1.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'zoomus'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install zoomus
+
+## Usage
+
+    require 'zoomus'
+    zoomus_client = Zoomus.new(:api_key => "xxx", :api_secret => "xxx")
+    user_list = zoomus_client.user_list
+    user_list["users"].each do |user|
+      user_id = u["id"]
+      puts zoomus_client.meeting_list(:host_id => user_id)
+    end
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/lib/zoomus.rb

@@ -0,0 +1,12 @@
+require 'zoomus/utils'
+require 'zoomus/actions/user'
+require 'zoomus/actions/meeting'
+require 'zoomus/client'
+
+module Zoomus
+  class << self
+    def new(*arg)
+      Zoomus::Client.new(*arg)
+    end
+  end
+end

data/lib/zoomus/actions/meeting.rb

@@ -0,0 +1,19 @@
+module Zoomus
+  module Actions
+    module Meeting
+
+      def meeting_list(*args)
+        options = args.extract_options!
+        require_params(:host_id, options)
+        parse_response self.class.post("/meeting/list", :query => options)
+      end
+
+      def meeting_create(*args)
+        options = args.extract_options!
+        require_params([:host_id, :topic, :type], options)
+        parse_response self.class.post("/meeting/create", :query => options)
+      end
+
+    end
+  end
+end

data/lib/zoomus/actions/user.rb

@@ -0,0 +1,17 @@
+module Zoomus
+  module Actions
+    module User
+
+      def user_list
+        parse_response self.class.post("/user/list")
+      end
+
+      def user_create(*args)
+        options = args.extract_options!
+        require_params([:type, :email], options)
+        parse_response self.class.post("/user/create", :query => options)
+      end
+
+    end
+  end
+end

data/lib/zoomus/client.rb

@@ -0,0 +1,27 @@
+require 'httparty'
+require 'json'
+
+module Zoomus
+  class Client
+    
+    include HTTParty
+    
+    include Utils
+    include Actions::User
+    include Actions::Meeting
+
+    base_uri 'https://api.zoom.us/v1'
+
+    def initialize(*args)
+
+      options = args.extract_options!
+
+      raise argument_error("api_key and api_secret") unless options[:api_key] and options[:api_secret]
+
+      self.class.default_params :api_key => options[:api_key], 
+                                :api_secret => options[:api_secret]
+    end
+
+  end
+end
+

data/lib/zoomus/utils.rb

@@ -0,0 +1,28 @@
+module Zoomus
+  module Utils
+    private
+      def argument_error(name)
+        name ? ArgumentError.new("You must provide #{name}") : ArgumentError
+      end
+
+      def parse_response(http_response)
+        JSON.parse(http_response.parsed_response)
+      end
+
+      def require_params(params, options)
+        params = [params] unless params.is_a? Array
+        params.each do |param|
+          unless options[param]
+            raise argument_error(param.to_s)
+            break
+          end
+        end
+      end
+  end
+end
+
+class Array
+  def extract_options!
+    last.is_a?(::Hash) ? pop : {}
+  end
+end

data/spec/fixtures/meeting_create.json

@@ -0,0 +1,15 @@
+{
+  "uuid": "F48qM18iRqSQunRLbKBpmQ==",
+  "id": 494333439,
+  "host_id": "ufR93M2pRyy8ePFN92dttq",
+  "topic": "Foo",
+  "password": "",
+  "type": 1,
+  "option_jbh": true,
+  "start_time": "",
+  "duration": 0,
+  "timezone": "",
+  "start_url": "https://zoom.us/s/494333439?zpk=ZhyyOBOEVXlCSy9BX8KH5viEMwat3OfU9biKujAxrTk.BwUAAAE8qkJADwAAHCAkODRhOTQzMzctOTIwNS00YzI1LTkxNjMtYzJhZDIwZDM4OGI4FnVmUjkzTTJwUnl5OGVQRk45MmR0dFEWdWZSOTNNMnBSeXk4ZVBGTjkyZHR0UQtNYXhpbSBDb2xsc2QAsjRlMDZwQ2pjNmRMYVB5RG9OeGZ2X0VtcXJxajJjRXBlOWF2UFI2VEhiREkuQmdFZ2NFOUhVVXRVTW1KdVZVdFdRMVJTU25kcFp6VjRPVUozUmtwU0wycE9TelpBTlRVeVpUTTRPR013WlRNeU1EazJZMlF4Tmpaa01HSXlZV0ZqTkRBMk5UUXpOMlE1TVdZek1HSm1abVEyTW1aa016WXhZV1U1Wm1FMk5ETm1OR0V5TmcAABZkUGJUUWoxelJuLVJ5R2ZCeW11QndBAAE",
+  "join_url": "https://zoom.us/j/494333439",
+  "created_at": "2013-02-05T12:08:54Z"
+}

data/spec/fixtures/meeting_list.json

@@ -0,0 +1,20 @@
+{
+  "page_count": 1,
+  "page_number": 1,
+  "page_size": 30,
+  "total_records": 1,
+  "meetings": [{
+    "topic": "My Meeting",
+    "id": 521910404,
+    "start_url": "https://zoom.us/s/521910404?zpk=LRTNfaKqk15rJHbOQ5uCo92GP_iNykiboh9q5jqkoXU.BwUAAAE8qaCS4wAAHCAkYTEwNTc5ZDAtZTliNi00NGJjLTliZWQtMzVjMTQ4MDE2NWRkFnVmUjkzTTJwUnl5OGVQRk45MmR0dFEWdWZSOTNNMnBSeXk4ZVBGTjkyZHR0UQtNYXhpbSBDb2xsc2QAsjRlMDZwQ2pjNmRMYVB5RG9OeGZ2X0VtcXJxajJjRXBlOWF2UFI2VEhiREkuQmdFZ2NFOUhVVXRVTW1KdVZVdFdRMVJTU25kcFp6VjRPVUozUmtwU0wycE9TelpBTlRVeVpUTTRPR013WlRNeU1EazJZMlF4Tmpaa01HSXlZV0ZqTkRBMk5UUXpOMlE1TVdZek1HSm1abVEyTW1aa016WXhZV1U1Wm1FMk5ETm1OR0V5TmcAABZkUGJUUWoxelJuLVJ5R2ZCeW11QndBAAE",
+    "timezone": "Europe/Brussels",
+    "duration": 60,
+    "option_jbh": true,
+    "host_id": "ufR9342pRyf8ePFN92dttQ",
+    "join_url": "https://zoom.us/j/521910404",
+    "created_at": "2013-02-05T09:11:48Z",
+    "start_time": "2013-02-05T10:00:00Z",
+    "uuid": "g0OFRGGARfaTlDxbGjcVKQ==",
+    "type": 2
+  }]
+}

data/spec/fixtures/user_create.json

@@ -0,0 +1,9 @@
+{
+  "id": "eIimBAXqSrWOcB_EOIXTog",
+  "email": "foo@bar.com",
+  "first_name": "Foo",
+  "last_name": "Bar",
+  "type": 1,
+  "created_at": "2013-02-05T11:23:58Z",
+  "token": null
+}

data/spec/fixtures/user_list.json

@@ -0,0 +1,14 @@
+{
+  "page_count": 1,
+  "page_number": 1,
+  "page_size": 30,
+  "total_records": 1,
+  "users": [{
+    "id": "ufR9342pRyf8ePFN92dttQ",
+    "first_name": "Bar",
+    "email": "foo@bar.com",
+    "last_name": "Foo",
+    "created_at": "2013-01-30T12:19:17Z",
+    "type": 1
+  }]
+}

data/spec/lib/zoomus/actions/meeting_spec.rb

@@ -0,0 +1,75 @@
+require 'spec_helper'
+
+describe Zoomus::Actions::Meeting do
+
+  before :all do
+    @zc = zoomus_client
+    @host_id = "ufR93M2pRyy8ePFN92dttq"
+  end
+
+  describe "#meeting_list action" do
+    before :each do
+      stub_request(:post, zoomus_url("/meeting/list")).to_return(:body => json_response("meeting_list"))
+    end
+
+    it "requires a 'host_id' argument" do
+      expect{@zc.meeting_list()}.to raise_error(ArgumentError)
+    end
+
+    it "returns a hash" do
+      expect(@zc.meeting_list(:host_id => @host_id)).to be_kind_of(Hash)
+    end
+
+    it "returns 'total_records'" do
+      expect(@zc.meeting_list(:host_id => @host_id)["total_records"]).to eq(1)
+    end
+
+    it "returns 'meetings' Array" do
+      expect(@zc.meeting_list(:host_id => @host_id)["meetings"]).to be_kind_of(Array)
+    end
+  end
+
+  describe "#meeting_list action" do
+    before :each do
+      stub_request(:post, zoomus_url("/meeting/create")).to_return(:body => json_response("meeting_create"))
+    end
+
+    it "requires a 'host_id' argument" do
+      expect{@zc.meeting_create(:type => 1, :topic => "Foo")}.to raise_error(ArgumentError)
+    end
+
+    it "requires a 'topic' argument" do
+      expect{@zc.meeting_create(:host_id => 1, :type => "Foo")}.to raise_error(ArgumentError)
+    end
+
+    it "requires a 'type' argument" do
+      expect{@zc.meeting_create(:host_id => 1, :topic => "Foo")}.to raise_error(ArgumentError)
+    end
+
+    it "returns a hash" do
+      expect(@zc.meeting_create(:host_id => @host_id,
+                                :type => 1,
+                                :topic => "Foo")).to be_kind_of(Hash)
+    end
+
+    it "returns the setted params" do
+      res = @zc.meeting_create(:host_id => @host_id,
+                               :type => 1,
+                               :topic => "Foo")
+
+      expect(res["host_id"]).to eq(@host_id)
+      expect(res["type"]).to eq(1)
+      expect(res["topic"]).to eq("Foo")
+    end
+
+    it "returns 'start_url' and 'join_url'" do
+      res = @zc.meeting_create(:host_id => @host_id,
+                               :type => 1,
+                               :topic => "Foo")
+
+      expect(res["start_url"]).to_not be_nil
+      expect(res["join_url"]).to_not be_nil
+    end
+  end
+end
+

data/spec/lib/zoomus/actions/user_spec.rb

@@ -0,0 +1,59 @@
+require 'spec_helper'
+
+describe Zoomus::Actions::User do
+
+  before :all do
+    @zc = zoomus_client
+  end
+
+  describe "#user_list action" do
+    before :each do
+      stub_request(:post, zoomus_url("/user/list")).to_return(:body => json_response("user_list"))
+    end
+
+    it "returns a hash" do
+      expect(@zc.user_list).to be_kind_of(Hash)
+    end
+
+    it "returns 'total_records" do
+      expect(@zc.user_list["total_records"]).to eq(1)
+    end
+
+    it "returns 'users' Array" do
+      expect(@zc.user_list["users"]).to be_kind_of(Array)
+    end
+  end
+
+  describe "#user_create action" do
+    before :each do
+      stub_request(:post, zoomus_url("/user/create")).to_return(:body => json_response("user_create"))
+    end
+
+    it "requires email param" do
+      expect{@zc.user_create(:type => "foo@bar.com")}.to raise_error(ArgumentError)
+    end
+
+    it "requires type param" do
+      expect{@zc.user_create(:email => "foo@bar.com")}.to raise_error(ArgumentError)
+    end
+
+    it "returns a hash" do
+      expect(@zc.user_create(:email => "foo@bar.com", 
+                             :first_name => "Foo", 
+                             :last_name => "Bar", 
+                             :type => 1)).to be_kind_of(Hash)
+    end
+
+    it "returns same params" do
+      res = @zc.user_create(:email => "foo@bar.com", 
+                            :first_name => "Foo", 
+                            :last_name => "Bar", 
+                            :type => 1)
+
+      expect(res["email"]).to eq("foo@bar.com")
+      expect(res["first_name"]).to eq("Foo")
+      expect(res["last_name"]).to eq("Bar")
+      expect(res["type"]).to eq(1)
+    end
+  end
+end

data/spec/lib/zoomus/client_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe Zoomus::Client do
+
+  describe "default attributes" do
+    it "must include httparty methods" do
+      expect(Zoomus::Client).to include(HTTParty)
+    end
+
+    it "must have the base url set to Zoomus API endpoint" do
+      expect(Zoomus::Client.base_uri).to eq('https://api.zoom.us/v1')
+    end
+  end
+
+  describe "constructor" do
+    it "requires api_key and api_secret for a new instance" do
+      expect{Zoomus::Client.new(:api_key => "xxx")}.to raise_error(ArgumentError)
+    end
+
+    it "creates instance of Zoomus::Client if api_key and api_secret is provided" do
+      expect(Zoomus::Client.new(:api_key => "xxx", :api_secret => "xxx")).to be_an_instance_of(Zoomus::Client)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,24 @@
+require 'rubygems'
+require 'bundler/setup'
+require "zoomus"
+require 'webmock/rspec'
+
+RSpec.configure do |config|
+  # some (optional) config here
+end
+
+def fixture(filename)
+  File.dirname(__FILE__) + '/fixtures/' + filename
+end
+
+def json_response(key)
+  open(fixture(key + '.json')).read
+end
+
+def zoomus_url(url)
+  /https:\/\/api.zoom.us\/v1#{url}.*/
+end
+
+def zoomus_client
+  Zoomus.new(:api_key => "xxx", :api_secret => "xxx")
+end

data/zoomus.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |gem|
+
+  gem.add_dependency 'httparty'
+  gem.add_dependency 'json'
+
+  gem.authors       = ['Maxim Colls']
+  gem.email         = ['collsmaxim@gmail.com']
+  gem.description   = %q{A Ruby wrapper for zoom.us API v1}
+  gem.summary       = %q{zoom.us API wrapper}
+  gem.homepage      = 'https://github.com/mllocs/zoomus'
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = 'zoomus'
+  gem.require_paths = ['lib']
+  gem.version       = '0.0.5'
+end

metadata

@@ -0,0 +1,94 @@
+--- !ruby/object:Gem::Specification
+name: zoomus
+version: !ruby/object:Gem::Version
+  version: 0.0.5
+  prerelease: 
+platform: ruby
+authors:
+- Maxim Colls
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: &76078940 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *76078940
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &76076930 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *76076930
+description: A Ruby wrapper for zoom.us API v1
+email:
+- collsmaxim@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- Makefile
+- README.md
+- lib/zoomus.rb
+- lib/zoomus/actions/meeting.rb
+- lib/zoomus/actions/user.rb
+- lib/zoomus/client.rb
+- lib/zoomus/utils.rb
+- spec/fixtures/meeting_create.json
+- spec/fixtures/meeting_list.json
+- spec/fixtures/user_create.json
+- spec/fixtures/user_list.json
+- spec/lib/zoomus/actions/meeting_spec.rb
+- spec/lib/zoomus/actions/user_spec.rb
+- spec/lib/zoomus/client_spec.rb
+- spec/spec_helper.rb
+- zoomus.gemspec
+homepage: https://github.com/mllocs/zoomus
+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.10
+signing_key: 
+specification_version: 3
+summary: zoom.us API wrapper
+test_files:
+- spec/fixtures/meeting_create.json
+- spec/fixtures/meeting_list.json
+- spec/fixtures/user_create.json
+- spec/fixtures/user_list.json
+- spec/lib/zoomus/actions/meeting_spec.rb
+- spec/lib/zoomus/actions/user_spec.rb
+- spec/lib/zoomus/client_spec.rb
+- spec/spec_helper.rb