class NSIVideoConvert::Client
Public Class Methods
Pre-configure the NSIVideoConvert
module with default params for the NSIVideoConvert::Client
@yield a Configuration
object (see {NSIVideoConvert::Client::Configuration})
@example
NSIVideoConvert::Client.configure do user "why" password "chunky" host "localhost" port "8888" end
# File lib/nsivideoconvert/client.rb, line 125 def self.configure(&block) Configuration.instance_eval(&block) end
Initialize a client to a VideoConvert node
@param [Hash] options used to connect to the VideoConvert node @options options [String] host to connect @options options [String] port to connect @options options [String] user to authenticatie with @options options [String] password to the refered user
@return [Client] the object itself @example
videoconvert = NSIVideoConvert::Client.new host: 'localhost', port: '8886', user: 'test', password: 'test'
@note if you had used the ‘configure’ method, you can use it without parameters
and those you provided before will be used (see Client#configure)
# File lib/nsivideoconvert/client.rb, line 23 def initialize(params = {}) params = Configuration.settings.merge(params) @user = params[:user] @password = params[:password] @host = params[:host] @port = params[:port] end
Public Instance Methods
Send a video be converted by a nsi.videoconvert node
@param [Hash] options used to send a video to be converted @option options [String] file the base64 encoded file to be converted @option options [String] sam_uid the UID of a video at SAM @option options [String] filename the filename of the video @note the filename is very importante, the videoconvert node will use the proper coding/encoding option for the video type @option options [String] video_link link to the video that’ll be converted @note if provided both video_link and file options, file will be ignored and the client will download the video instead @option options [String] callback a callback url to the file convertion @option options [String] verb the callback request verb, when not provided, nsi.videoconvert defaults to POST
@example A simple convertion
require 'base64' video = Base64.encode64(File.new('video.ogv', 'r').read) response = nsivideoconvert.convert(:file => video, :filename => 'video.ogv') nsivideoconvert.done(response["video_key"]) nsivideoconvert.grains_keys_for(response["video_key"])
@example Converting from a SAM uid
video = Base64.encode64(File.new('video.ogv', 'r').read) response = sam.store({:doc => doc}) video_key = response["key"] response = nsivideoconvert.convert(:sam_uid => video_key, :filename => 'video.ogv') nsivideoconvert.done(response["video_key"]) nsivideoconvert.grains_keys_for(response["video_key"])
@example Downloading and converting from web
response = nsivideoconvert.convert(:video_link => 'http://google.com/video.ogv') nsivideoconvert.done(response["video_key"]) nsivideoconvert.grains_keys_for(response["video_key"])
@example Sending a callback url
video = Base64.encode64(File.new('video.ogv', 'r').read) nsivideoconvert.convert(:file => video, :filename => 'video.ogv', :callback => 'http://google.com') nsivideoconvert.convert(:video_link => 'http://google.com/video.ogv', :callback => 'http://google.com')
@example Using a custom verb to the callback
video = Base64.encode64(File.new('video.ogv', 'r').read) nsivideoconvert.convert(:file => video, :filename => 'video.ogv', :callback => 'http://google.com', :verb => "PUT") nsivideoconvert.convert(:video_link => 'http://google.com/video.ogv', :callback => 'http://google.com', :verb => "PUT")
@return [Hash] response
* "video_key" [String] the key to access the converted video in the sam node it was stored
@raise NSIVideoConvert::Errors::Client::MissingParametersError
when an invalid or incomplete set of parameters is provided @raise NSIVideoConvert::Errors::Client::SAMConnectionError
when cannot connect to the SAM node @raise NSIVideoConvert::Errors::Client::AuthenticationError
when invalids user and/or password are provided @raise NSIVideoConvert::Errors::Client::KeyNotFoundError
when an invalid sam_uid is provided
# File lib/nsivideoconvert/client.rb, line 77 def convert(options = {}) @request_data = Hash.new if options[:video_link] insert_download_data options elsif options[:sam_uid] && options[:filename] file_data = {:sam_uid => options[:sam_uid], :filename => options[:filename]} @request_data.merge! file_data elsif options[:file] && options[:filename] file_data = {:video => options[:file], :filename => options[:filename]} @request_data.merge! file_data else raise NSIVideoConvert::Errors::Client::MissingParametersError end insert_callback_data options request = prepare_request :POST, @request_data.to_json execute_request(request) end
Verify if a video is already converted
@param [String] key of the desired video @return [Hash] response
* "done" [String] true if the video was already granualted, otherwise, false
@example
nsivideoconvert.done("some key")
@raise NSIVideoConvert::Errors::Client::SAMConnectionError
when cannot connect to the SAM node @raise NSIVideoConvert::Errors::Client::AuthenticationError
when invalids user and/or password are provided @raise NSIVideoConvert::Errors::Client::KeyNotFoundError
when an invalid key is provided
# File lib/nsivideoconvert/client.rb, line 109 def done(key) request = prepare_request :GET, {:key => key}.to_json execute_request(request) end
Private Instance Methods
# File lib/nsivideoconvert/client.rb, line 149 def execute_request(request) begin response = Net::HTTP.start @host, @port do |http| http.request(request) end rescue Errno::ECONNREFUSED => e raise NSIVideoConvert::Errors::Client::ConnectionRefusedError else raise NSIVideoConvert::Errors::Client::KeyNotFoundError if response.code == "404" raise NSIVideoConvert::Errors::Client::MalformedRequestError if response.code == "400" raise NSIVideoConvert::Errors::Client::AuthenticationError if response.code == "401" raise NSIVideoConvert::Errors::Client::QueueServiceConnectionError if response.code == "503" if response.code == "500" and response.body.include?("SAM") raise NSIVideoConvert::Errors::Client::SAMConnectionError end JSON.parse(response.body) end end
# File lib/nsivideoconvert/client.rb, line 136 def insert_callback_data(options) @request_data[:callback] = options[:callback] unless options[:callback].nil? @request_data[:verb] = options[:verb] unless options[:verb].nil? end
# File lib/nsivideoconvert/client.rb, line 131 def insert_download_data(options) download_data = {video_link: options[:video_link]} @request_data.merge! download_data end
# File lib/nsivideoconvert/client.rb, line 141 def prepare_request(verb, body) verb = verb.to_s.capitalize! request = Net::HTTP.const_get("#{verb}").new '/' request.body = body request.basic_auth @user, @password request end