openvidu-ruby-client 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6816d2ce00a5d853de33612fca8b893d9d4f76d2
-  data.tar.gz: 417436d1f059a6688a7ee77355c8c73b89156e57
+  metadata.gz: 5f5a0eb2dc94b5816ee311555d3739ba1fc64a9a
+  data.tar.gz: 7071c1d9e02b6f3ac9d80d12376fd628d9c8e6fc
 SHA512:
-  metadata.gz: b51fcf9e220816e1ee32a7b0fce6147f0c96a9ab5286a9560f5b05c68ef0144c472900696d278efb27b8134f3af01f7df3543cb8446c2b3831fd23233e47eb49
-  data.tar.gz: c41aa3bcc46633072358561daf62080a1794f833aa5ed6409a04446b29a5d542848bc8a0d7e03af4ba88a54d65f3e4a2bd986dda1b1a5a62bba7101976e06414
+  metadata.gz: a226c1b45b92dbd419e771f108a02b802af82500453b6bcaf7e84d21b013f1a9a960824a7b4251331d9bf857105e14753082ba690a596490808bfe8d8c0f48e3
+  data.tar.gz: 02ca643fad82e6b2c809fe2122dd708273e13813f548144d4426bf2a0acf26b3b1b9db709d0590d656d0f45188d1b7c315b2b7888f2730b4b4f34ed64517b894

data/.env.sample

@@ -0,0 +1,4 @@
+OPENVIDU_URL=https://localhost:4443
+OPENVIDU_USERNAME=openviduapp
+OPENVIDU_PASSWORD=MY_SECRET
+OPENVIDU_VERIFY_PEER=false

data/.gitignore

@@ -9,3 +9,7 @@
 /spec/reports/
 /tmp/
 /vendor/
+.DS_Store
+\.idea
+\.rakeTasks
+Gemfile.lock

data/.travis.yml

@@ -3,11 +3,16 @@ sudo: false
 language: ruby
 cache: bundler
 rvm: 2.4.5
+dist: bionic
 
 services:
   - docker
 
+env:
+  OPENVIDU_VERIFY_PEER: false
+
 before_install:
   - gem install bundler -v 1.17.3
   - docker pull openvidu/openvidu-server-kms
-  - docker run -p 4443:4443 -d --rm -e openvidu.secret=MY_SECRET openvidu/openvidu-server-kms
+  - docker run -p 4443:4443 -d --rm -e openvidu.secret=MY_SECRET -e openvidu.recording.path=/recordings -e openvidu.recording=true -v /var/run/docker.sock:/var/run/docker.sock openvidu/openvidu-server-kms
+  - while [[ "$(curl -k -uOPENVIDUAPP:MY_SECRET -s -o /dev/null -w ''%{http_code}'' https://localhost:4443)" != "200" ]]; do echo "Waiting for Openvidu..."; sleep 5; done

data/README.md

@@ -1,8 +1,6 @@
 # OpenVidu Ruby Client
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/open_vidu`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
+![Build Status](https://travis-ci.org/BryanSaxon/openvidu-ruby-client.svg?branch=master)
 
 ## Installation
 
@@ -22,12 +20,33 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+To get started locally, first pull the OpenVidu Docker image and start a container:
 
 ```bash
-OPENVIDU_URL = 'https://localhost:4443'
-OPENVIDU_USERNAME = 'OPENVIDUAPP'
-OPENVIDU_PASSWORD = 'MY_SECRET'
+docker pull openvidu/openvidu-server-kms
+docker run -p 4443:4443 -d --rm -e openvidu.secret=MY_SECRET -e openvidu.recording.path=/recordings -e openvidu.recording=true -v /var/run/docker.sock:/var/run/docker.sock openvidu/openvidu-server-kms
+```
+
+Set the following environment variables in your Ruby application:
+
+To start a OpenVidu session:
+
+```ruby
+server = 'https://127.0.0.1:4443?token=MY_SECRET&timeout=5'
+
+OpenVidu::Session.new(server,
+  customSessionId: 'your-custom-session-id',
+  defaultOutputMode: 'INDIVIDUAL',
+  recordingMode: 'ALWAYS').create
+
+# Create a token to publish video
+token = OpenVidu::Token.new(server, session: 'your-custom-session-id,
+  role: "PUBLISHER",
+  data: {
+    "full_name": "John Smith"  # Custom data can be supplied here
+  }
+)
+
 ```
 
 ## Development

data/lib/open_vidu.rb

@@ -1,6 +1,7 @@
 require "open_vidu/version"
+require "open_vidu/base"
 
 module OpenVidu
   class Error < StandardError; end
-  # Your code goes here...
+
 end

data/lib/open_vidu/base.rb

@@ -1,4 +1,5 @@
 require 'open_vidu/command'
+require 'open_vidu/server'
 
 module OpenVidu
   # Base
@@ -7,7 +8,14 @@ module OpenVidu
     GENERATED_PARAMS = %w[].freeze
     ALL_PARAMS = (ASSIGNABLE_PARAMS + GENERATED_PARAMS).freeze
 
-    def initialize(params = {})
+    attr_reader :server
+
+    def self.content_key
+      'content'
+    end
+
+    def initialize(uri, params = {})
+      @server = Server.new(uri).freeze
       self.class::ALL_PARAMS.each do |param|
         instance_variable_set("@#{param}", params[param.to_sym])
         self.class.send(:attr_accessor, param.to_sym)

data/lib/open_vidu/command.rb

@@ -1,28 +1,33 @@
 require 'open_vidu/requestor'
 require 'open_vidu/responder'
+require 'open_vidu/exceptions'
 
 module OpenVidu
   # Command
   class Command
-    attr_reader :object, :method, :endpoint, :params
+    attr_reader :object, :method, :endpoint, :params, :requestor, :responder, :server
 
-    def initialize(object, method, endpoint, params = {})
+    def initialize(object, method, endpoint, params = {}, options: {})
       @object = object
       @method = method
       @endpoint = endpoint
       @params = params
+
+      @server = options.fetch(:server)
+      @requestor = options[:requestor] || OpenVidu::Requestor.new(server, method, endpoint, params)
+      @responder = options[:responder] || OpenVidu::Responder.new
     end
 
     def execute
-      response = OpenVidu::Requestor.new(method, endpoint, params).execute
-      OpenVidu::Responder.new(object, response).execute if valid?(response)
+      response = requestor.execute
+      raise OpenVidu::ResponseError.new(response) unless valid?(response)
+      responder.execute(server, object, response.parsed_response)
     end
 
     private
 
-    # TODO: Implement.
     def valid?(response)
-      true
+      response.success?
     end
   end
 end

data/lib/open_vidu/config.rb

@@ -12,8 +12,8 @@ module OpenVidu
     ].freeze
     ALL_PARAMS = (ASSIGNABLE_PARAMS + GENERATED_PARAMS).freeze
 
-    def self.config
-      OpenVidu::Command.new(:config, :get, 'config').execute
+    def config
+      OpenVidu::Command.new(:config, :get, 'config', { options: {server: server } }).execute
     end
   end
 end

data/lib/open_vidu/exceptions.rb

@@ -0,0 +1,9 @@
+module OpenVidu
+  class ResponseError < StandardError
+    attr_reader :response
+    def initialize(response)
+      @response = response
+      super("OpenVidu Response error code: #{response.code}")
+    end
+  end
+end

data/lib/open_vidu/recording.rb

@@ -10,19 +10,32 @@ module OpenVidu
     ].freeze
     ALL_PARAMS = (ASSIGNABLE_PARAMS + GENERATED_PARAMS).freeze
 
-    def self.all
+    def self.content_key
+      'items'
+    end
+
+    def all
       OpenVidu::Command.new(
-        :recording, :get, 'api/recordings'
+        :recording,
+        :get,
+        'api/recordings',
+        { options: { server: server } }
       ).execute
     end
 
-    def self.create(params)
-      new(params).create
+    def find(id)
+      OpenVidu::Command.new(
+        :recording, :get, "api/recordings/#{id}",
+        { options: { server: server } }
+      ).execute
     end
 
-    def self.find(id)
+    def stop
       OpenVidu::Command.new(
-        :recording, :get, "api/recordings/#{id}"
+        :recording,
+        :post,
+        "api/recordings/stop/#{id}",
+        { options: { server: server } }
       ).execute
     end
 
@@ -30,15 +43,18 @@ module OpenVidu
       OpenVidu::Command.new(
         :recording,
         :delete,
-        "api/recordings/stop/#{id}"
+        "api/recordings/#{id}",
+        { options: { server: server } }
       ).execute
     end
 
-    alias_method :stop, :delete
-
     def create
       OpenVidu::Command.new(
-        :recording, :post, 'api/recordings/start', create_params
+        :recording,
+        :post,
+        'api/recordings/start',
+        create_params,
+        { options: { server: server } }
       ).execute
     end
 

data/lib/open_vidu/requestor.rb

@@ -1,39 +1,36 @@
-require 'dotenv/load'
 require 'httparty'
 require 'json'
 
 module OpenVidu
   # Requestor
   class Requestor
-    attr_reader :method, :endpoint, :params
+    attr_reader :server, :method, :endpoint, :params
 
-    BASE_URL = ENV['OPENVIDU_URL']
-    TOKEN = "#{ENV['OPENVIDU_USERNAME']}:#{ENV['OPENVIDU_PASSWORD']}".freeze
-    MODE = ENV['MODE']
-
-    def initialize(method, endpoint, params = {})
+    def initialize(server, method, endpoint, params = {})
+      @server = server
       @method = method
       @endpoint = endpoint
       @params = params
     end
 
     def execute
-      HTTParty.send(method, url, options)&.parsed_response
+      HTTParty.send(method, url, options)
     end
 
     private
 
     def url
-      "#{BASE_URL}/#{endpoint}"
+      "#{server.scheme}://#{server.host}:#{server.port || 4443}/#{endpoint}"
     end
 
     def options
       {
         headers: {
-          'Authorization' => "Basic #{Base64.strict_encode64(TOKEN)}",
+          'Authorization' => "Basic #{Base64.strict_encode64(server.token)}",
           'Content-Type' => 'application/json'
         },
-        verify: MODE != 'DEV',
+        verify: server.verify_peer?,
+        timeout: server.timeout,
         body: params.to_json
       }
     end

data/lib/open_vidu/responder.rb

@@ -1,27 +1,30 @@
-require 'byebug'
-
 module OpenVidu
   # Responder
   class Responder
     attr_reader :object, :response
 
-    def initialize(object, response)
+    def execute(server, object, response)
       @object = object
       @response = response
-    end
-
-    def execute
       klass = Object.const_get(klass_name)
 
       return true if record_destroyed?
-      return klass.new(mapped_params(response)) if complete_record?
-      return klass.find(response['id']) if record_lookup?
+      return klass.new(server, mapped_params(response)) if complete_record?
+      return klass.new(server).find(response['id']) if record_lookup?
 
-      response['content'].map { |hash| klass.new(mapped_params(hash)) }
+      response[content_key].map { |hash| klass.new(server, mapped_params(hash)) }
     end
 
     private
 
+    def klass
+      Object.const_get(klass_name)
+    end
+
+    def content_key
+      klass.content_key
+    end
+
     def klass_name
       "OpenVidu::#{object.to_s.split('_').map(&:capitalize).join('')}"
     end

data/lib/open_vidu/server.rb

@@ -0,0 +1,49 @@
+require 'addressable'
+require 'forwardable'
+
+module OpenVidu
+  # Endpoint configuration
+  class Server
+    extend Forwardable
+
+    InvalidURI = Class.new(StandardError)
+
+    DEFAULT_TIMEOUT = 10 # seconds
+
+    def_delegators :@uri, :host, :port, :scheme, :query_values, :to_s
+
+    # `uri` should take the form of scheme://some-openvidu-host-or-ip:port?token=<your-secret-here>
+    # e.g. https://1.2.3.4?token=abcdefghijklmnop
+    def initialize(uri)
+      @uri = Addressable::URI.parse(uri.to_s)
+      raise InvalidURI if @uri.empty?
+    end
+
+    def token
+      "OPENVIDUAPP:#{query_values.fetch('token')}"
+    end
+
+    def host_and_port
+      "#{host}:#{port}"
+    end
+
+    def verify_peer?
+      return false if query_values['verify_peer'].to_s.downcase == 'false'
+
+      true
+    end
+
+    def timeout
+      if query_values['timeout'].to_i > 0
+        query_values['timeout'].to_i
+      else
+        DEFAULT_TIMEOUT
+      end
+    end
+
+    def ==(other)
+      other.to_s == self.to_s
+    end
+  end
+end
+

data/lib/open_vidu/session.rb

@@ -8,31 +8,39 @@ module OpenVidu
     GENERATED_PARAMS = %w[sessionId createdAt connections recording].freeze
     ALL_PARAMS = (ASSIGNABLE_PARAMS + GENERATED_PARAMS).freeze
 
-    def self.all
+    def all
       OpenVidu::Command.new(
-        :session, :get, 'api/sessions'
+        :session, :get, 'api/sessions', { options: { server: server } }
       ).execute
     end
 
-    def self.create(params)
-      new(params).create
-    end
-
-    def self.find(id)
+    def find(id)
       OpenVidu::Command.new(
-        :session, :get, "api/sessions/#{id}"
+        :session, :get, "api/sessions/#{id}", { options: { server: server } }
       ).execute
     end
 
+    def exists?(id)
+      begin
+        OpenVidu::Command.new(
+          :session, :get, "api/sessions/#{id}", { options: { server: server } }
+        ).execute
+        true
+      rescue OpenVidu::ResponseError => e
+        raise e unless e.response.code == 404
+        false
+      end
+    end
+
     def create
       OpenVidu::Command.new(
-        :session, :post, 'api/sessions', create_params
+        :session, :post, 'api/sessions', create_params, { options: { server: server } }
       ).execute
     end
 
     def delete
       OpenVidu::Command.new(
-        :session, :delete, "api/sessions/#{sessionId}"
+        :session, :delete, "api/sessions/#{customSessionId}", { options: { server: server } }
       ).execute
     end
   end

data/lib/open_vidu/token.rb

@@ -5,13 +5,9 @@ module OpenVidu
     GENERATED_PARAMS = %w[id token].freeze
     ALL_PARAMS = (ASSIGNABLE_PARAMS + GENERATED_PARAMS).freeze
 
-    def self.create(params)
-      new(params).create
-    end
-
     def create
       OpenVidu::Command.new(
-        :token, :post, 'api/tokens', create_params
+        :token, :post, 'api/tokens', create_params, options: { server: server }
       ).execute
     end
   end

data/lib/open_vidu/version.rb

@@ -1,3 +1,3 @@
 module OpenVidu
-  VERSION = "0.2.0"
+  VERSION = "0.4.0"
 end

data/openvidu-ruby-client.gemspec

@@ -32,12 +32,14 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler', '~> 1.16'
   spec.add_development_dependency 'byebug', '~> 9.0', '>= 9.0.6'
   spec.add_development_dependency 'minitest', '~> 5.0'
   spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'test-unit', '~> 3.3', '>= 3.3.4'
+  spec.add_development_dependency 'openssl', '>= 2.1.2' # Fix for Travis CI
+  spec.add_development_dependency 'webmock', '~> 3.7'
+  spec.add_development_dependency 'simplecov', '~> 0.17'
 
-  spec.add_runtime_dependency 'dotenv', '~> 2.7', '>= 2.7.5'
-  spec.add_runtime_dependency 'httparty', '~> 0.13.7'
+  spec.add_runtime_dependency 'addressable', '>= 2.5.0'
+  spec.add_runtime_dependency 'httparty', '>= 0.13'
 end

metadata

@@ -1,29 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: openvidu-ruby-client
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Bryan Saxon
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-10-09 00:00:00.000000000 Z
+date: 2020-08-13 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.16'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.16'
 - !ruby/object:Gem::Dependency
   name: byebug
   requirement: !ruby/object:Gem::Requirement
@@ -93,39 +79,75 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 3.3.4
 - !ruby/object:Gem::Dependency
-  name: dotenv
+  name: openssl
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: 2.1.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.7.5
-  type: :runtime
+        version: 2.1.2
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.17'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.7.5
+        version: 2.5.0
 - !ruby/object:Gem::Dependency
   name: httparty
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.13.7
+        version: '0.13'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.13.7
+        version: '0.13'
 description: Ruby client built around OpenVidu's REST API.
 email:
 - emailBryanSaxon@gmail.com
@@ -133,7 +155,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".DS_Store"
+- ".env.sample"
 - ".gitignore"
 - ".travis.yml"
 - CODE_OF_CONDUCT.md
@@ -143,15 +165,15 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
-- lib/.DS_Store
 - lib/open_vidu.rb
-- lib/open_vidu/.DS_Store
 - lib/open_vidu/base.rb
 - lib/open_vidu/command.rb
 - lib/open_vidu/config.rb
+- lib/open_vidu/exceptions.rb
 - lib/open_vidu/recording.rb
 - lib/open_vidu/requestor.rb
 - lib/open_vidu/responder.rb
+- lib/open_vidu/server.rb
 - lib/open_vidu/session.rb
 - lib/open_vidu/token.rb
 - lib/open_vidu/version.rb
@@ -179,7 +201,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.14.3
+rubygems_version: 2.5.2.2
 signing_key: 
 specification_version: 4
 summary: OpenVidu Ruby client.