rev-api 2.2.0 → 2.4.0

data/README.md

@@ -1,132 +1,131 @@
-[![Gem Version](https://badge.fury.io/rb/rev-api.png)](http://badge.fury.io/rb/rev-api)
-[![Build Status](https://secure.travis-ci.org/revdotcom/rev-ruby-sdk.png?branch=master)](https://secure.travis-ci.org/revdotcom/rev-ruby-sdk)
-[![Dependency Status](https://gemnasium.com/revdotcom/rev-ruby-sdk.png?travis)](https://gemnasium.com/revdotcom/rev-ruby-sdk)
-[![Code Climate](https://codeclimate.com/github/revdotcom/rev-ruby-sdk.png)](https://codeclimate.com/github/revdotcom/rev-ruby-sdk)
-[![Coverage Status](https://coveralls.io/repos/revdotcom/rev-ruby-sdk/badge.png)](https://coveralls.io/r/revdotcom/rev-ruby-sdk)
-
-[Reference](https://www.rev.com/api/docs) | [RDocs](http://rubydoc.info/github/revdotcom/rev-ruby-sdk/master/frames)
-
-rev-ruby-sdk
-------------
-
-### Background
-
-Rev.com provides transcription and translation services powered by humans. The Rev.com API allows you to tap these services
-with no manual steps. It's a RESTful API, documented at <https://www.rev.com/api/docs>.
-
-The Ruby SDK for the Rev API provides a convenient Ruby wrapper for the Rev.com API. All operations of the API, as described
-at <https://www.rev.com/api/operations>, are supported.
-
-### Install
-
-```shell
-gem install rev-api
-```
-
-or put it into your Gemfile.
-
-When you need it:
-
-```ruby
-require 'rev-api'
-```
-
-### Authentication
-
-If you are building a new API client, you must first obtain a client API key, which you can do at <https://www.rev.com/api>.
-
-All operations in the API are performed on behalf of a Rev customer, identified by their user API key. The client key / user
-key pair is used to authenticate each API operation. Once you have the two keys, you can create a new Rev.com API client:
-
-
-```ruby
-require 'rev-api'
-
-rev_client = Rev.new('your_client_key', 'your_user_key')
-```
-
-You can read more about authentication in the Rev.com API at <https://www.rev.com/api/security>
-
-### Sandbox
-
-All operations can be executed against either the production or the sandbox environment. The sandbox environment allows you
-to test your API client without actually paying for orders and having them worked on.
-
-By default, the Rev.com API client executes against the production environment. To go against the sandbox instead,
-initialize the client this way:
-
-```ruby
-require 'rev-api'
-
-rev_client = Rev.new('your_client_key', 'your_user_key', Rev::Api::SANDBOX_HOST)
-```
-
-### Usage
-
-The snippets below assume you've initialized `rev_client`:
-
-```ruby
-rev_client = Rev.new('your_client_key', 'your_user_key')
-```
-
-#### Listing orders
-
-```ruby
-orders_page = rev_client.get_orders_page(1); # get a single page of orders
-all_orders = rev_client.get_all_orders; # get first page of orders history
-orders_by_client_ref = rev_client.get_orders_by_client_ref('some_ref'); # get orders with reference id of 'some_ref'
-```
-
-#### Get a single order by order number
-
-```ruby
-some_order = rev_client.get_order('TCxxxxxxxx')
-puts "Original comment: #{some_order.comments.first.text}"
-```
-
-#### Cancel an order given an order number
-
-```ruby
-rev_client.cancel_order('TCxxxxxxxx')
-```
-
-#### Print out the text of all transcripts in an order
-
-```ruby
-order = rev_client.get_order('TCxxxxxxx')
-
-order.transcripts.each do |t|
-	puts rev_client.get_attachment_content_as_string t.id
-	puts
-end
-```
-
-Refer to `cli.rb` in the `examples` directory for a full example illustrating placing orders, handling error responses, etc.
-
-### Documentation
-
-[YARD documentation](http://rubydoc.info/github/revdotcom/rev-ruby-sdk/master/frames) can be generated locally by running `rake yard` command, and will be placed in the `doc` directory.
-
-You can find API documentation at <https://www.rev.com/api/docs>.
-
-### Support
-
-If you have any questions or suggestions for improvement, email us directly at api[at]rev[dot]com.
-
-### Compatibility
-
-- MRI 2.0.0
-
-### Tests
-
-Minitest suite might be run using `rake test` command.
-Current stack:
-
-- minitest
-- webmock
-- vcr
-- turn
-
-### Dependencies
-
-- httparty
+[![Gem Version](https://badge.fury.io/rb/rev-api.png)](http://badge.fury.io/rb/rev-api)
+[![Build Status](https://secure.travis-ci.org/revdotcom/rev-ruby-sdk.png?branch=master)](https://secure.travis-ci.org/revdotcom/rev-ruby-sdk)
+[![Dependency Status](https://gemnasium.com/revdotcom/rev-ruby-sdk.png?travis)](https://gemnasium.com/revdotcom/rev-ruby-sdk)
+[![Code Climate](https://codeclimate.com/github/revdotcom/rev-ruby-sdk.png)](https://codeclimate.com/github/revdotcom/rev-ruby-sdk)
+
+[Reference](https://www.rev.com/api/docs) | [RDocs](http://rubydoc.info/github/revdotcom/rev-ruby-sdk/master/frames)
+
+rev-ruby-sdk
+------------
+
+### Background
+
+Rev.com provides transcription, caption and translation services powered by humans. The Rev.com API allows you to tap transcription
+and caption services with no manual steps. It's a RESTful API, documented at <https://www.rev.com/api/docs>.
+
+The Ruby SDK for the Rev API provides a convenient Ruby wrapper for the Rev.com API. All operations of the API, as described
+at <https://www.rev.com/api/operations>, are supported.
+
+### Install
+
+```shell
+gem install rev-api
+```
+
+or put it into your Gemfile.
+
+When you need it:
+
+```ruby
+require 'rev-api'
+```
+
+### Authentication
+
+If you are building a new API client, you must first obtain a client API key, which you can do at <https://www.rev.com/api>.
+
+All operations in the API are performed on behalf of a Rev customer, identified by their user API key. The client key / user
+key pair is used to authenticate each API operation. Once you have the two keys, you can create a new Rev.com API client:
+
+
+```ruby
+require 'rev-api'
+
+rev_client = Rev.new('your_client_key', 'your_user_key')
+```
+
+You can read more about authentication in the Rev.com API at <https://www.rev.com/api/security>
+
+### Sandbox
+
+All operations can be executed against either the production or the sandbox environment. The sandbox environment allows you
+to test your API client without actually paying for orders and having them worked on.
+
+By default, the Rev.com API client executes against the production environment. To go against the sandbox instead,
+initialize the client this way:
+
+```ruby
+require 'rev-api'
+
+rev_client = Rev.new('your_client_key', 'your_user_key', Rev::Api::SANDBOX_HOST)
+```
+
+### Usage
+
+The snippets below assume you've initialized `rev_client`:
+
+```ruby
+rev_client = Rev.new('your_client_key', 'your_user_key')
+```
+
+#### Listing orders
+
+```ruby
+orders_page = rev_client.get_orders_page(1) # get a single page of orders
+all_orders = rev_client.get_all_orders # get first page of orders history
+orders_by_client_ref = rev_client.get_orders_by_client_ref('some_ref') # get orders with reference id of 'some_ref'
+```
+
+#### Get a single order by order number
+
+```ruby
+some_order = rev_client.get_order('TCxxxxxxxx')
+puts "Original comment: #{some_order.comments.first.text}"
+```
+
+#### Cancel an order given an order number
+
+```ruby
+rev_client.cancel_order('TCxxxxxxxx')
+```
+
+#### Print out the text of all transcripts in an order
+
+```ruby
+order = rev_client.get_order('TCxxxxxxx')
+
+order.transcripts.each do |t|
+	puts rev_client.get_attachment_content_as_string t.id
+	puts
+end
+```
+
+Refer to `cli.rb` in the `examples` directory for a full example illustrating placing orders, handling error responses, etc.
+
+### Documentation
+
+[YARD documentation](http://rubydoc.info/github/revdotcom/rev-ruby-sdk/master/frames) can be generated locally by running `rake yard` command, and will be placed in the `doc` directory.
+
+You can find API documentation at <https://www.rev.com/api/docs>.
+
+### Support
+
+If you have any questions or suggestions for improvement, email us directly at api[at]rev[dot]com.
+
+### Compatibility
+
+- MRI 2.0.0
+
+### Tests
+
+Minitest suite might be run using `rake test` command.
+Current stack:
+
+- minitest
+- webmock
+- vcr
+- turn
+
+### Dependencies
+
+- httparty

data/Rakefile

@@ -1,14 +1,14 @@
-require 'rake/testtask'
-require 'yard'
-require 'rubygems/tasks'
-
-Rake::TestTask.new do |t|
-  t.test_files = FileList['spec/lib/rev/**/*_spec.rb']
-  t.verbose = true
-end
-
-YARD::Rake::YardocTask.new 
-
-Gem::Tasks.new
-
+require 'rake/testtask'
+require 'yard'
+require 'rubygems/tasks'
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['spec/lib/rev/**/*_spec.rb']
+  t.verbose = true
+end
+
+YARD::Rake::YardocTask.new 
+
+Gem::Tasks.new
+
 task :default => :test

data/examples/cli.rb

@@ -1,270 +1,270 @@
-require 'rev-api'
-require 'optparse'
-require 'pp'
-
-# An example app using the official Ruby SDK for the Rev.com API
-#   This ruby script sets up a basic command line interface (CLI)
-#   that prompts a user to authenticate on the web, then
-#   allows them to type commands to manipulate their orders.
-#
-# To start, run:
-# ruby examples/cli.rb --sandbox --client-key your_client_key --user-key your_user_key
-
-class RevCLI
-  COMMANDS = %w{help get get_by_client_ref list transcripts captions dl_transcripts dl_captions dl_sources place_tc place_cp cancel}
-
-  def initialize
-    options = { :environment => Rev::Api::PRODUCTION_HOST, :verbatim => false, :timestamps => false }
-    optparse = OptionParser.new do |opts|
-      opts.banner = "Usage: cli.rb [options]. You will be prompted for command then."
-
-      opts.on("--client-key CLIENT-KEY", "Use CLIENT-KEY as the API Client Key for Authorization") do |client_key|
-        options[:client_key] = client_key
-      end
-
-      opts.on("--user-key USER-KEY", "Use USER-KEY as the API User Key for Authorization") do |user_key|
-        options[:user_key] = user_key
-      end
-
-      opts.on("--sandbox", "Execute against the Sandbox environment rather than production") do
-        options[:environment] = Rev::Api::SANDBOX_HOST
-      end
-
-      opts.on("--[no-]verbatim", "Request verbatim transcription") do |v|
-        options[:verbatim] = v
-      end
-
-      opts.on("--[no-]timestamps", "Request timestamps transcription") do |t|
-        options[:timestamps] = t
-      end
-    end
-    optparse.parse!
-
-    raise OptionParser::MissingArgument, "--client-key" if options[:client_key].nil?
-    raise OptionParser::MissingArgument, "--user-key" if options[:user_key].nil?
-
-    @rev_client = Rev.new(options[:client_key], options[:user_key], options[:environment])
-  end
-
-  def command_loop
-    puts "Enter a command or 'help' or 'exit'"
-    command_line = ''
-
-    while command_line.strip != 'exit'
-      begin
-        execute_command(command_line)
-      rescue RuntimeError => e
-        puts "Command Line Error! #{e.class}: #{e}"
-        puts e.backtrace
-      end
-      print '> '
-      command_line = gets.strip
-    end
-
-    puts 'Goodbye!'
-    exit(0)
-  end
-
-  def execute_command(cmd_line)
-    command = cmd_line.split
-    method = command.first
-    if COMMANDS.include? method
-      begin
-        send(method.to_sym, command[1..-1])
-      rescue Rev::BadRequestError => e
-        puts "Server returned error with code #{e.code}, message #{e.message}"
-      rescue Rev::ApiError => e
-        puts "Server returned error with message #{e.message}"
-      end
-    elsif command.first && !command.first.strip.empty?
-      puts 'Invalid command. Type \'help\' to see commands.'
-    end
-  end
-
-  def get(args)
-    order_num = args[0]
-    order = @rev_client.get_order order_num
-    pp order
-  end
-
-  def list(args)
-    orders = @rev_client.get_all_orders
-    orders.each { |o| puts("#{o.order_number}") }
-
-    puts 'There are no orders placed so far.' if orders.empty?
-  end
-
-  def get_by_client_ref(args)
-    # client ref can contain spaces, so we have to join client ref from pieces
-    if (args.last == '0' || args.last.to_i > 0)
-      client_ref = args[0..-2].join(' ')
-    else
-      client_ref = args.join(' ')
-    end
-
-    client_ref = client_ref.gsub('\'', '').gsub('"', '')
-    page = args.last.nil? ? 0: args.last.to_i
-
-    orders_first_page = @rev_client.get_orders_by_client_ref(client_ref, page)
-    puts "Found #{orders_first_page.total_count} order(s), showing page #{page}. Pass page number as second argument"
-    orders_first_page.orders.each { |o| puts ("#{o.client_ref}: #{o.order_number}") }
-
-    puts "There are no orders associated with the given client reference: #{client_ref}" if orders_first_page.orders.empty?
-  end
-
-  def transcripts(args)
-    begin
-      order_num = args[0]
-      order = @rev_client.get_order order_num
-
-      if order.transcripts.empty?
-        puts "There are no transcripts for order #{order_num}"
-        return
-      end
-
-      order.transcripts.each do |t|
-        puts "Contents of #{t.name}"
-        puts "-----------------------------------"
-        puts @rev_client.get_attachment_content_as_string t.id
-        puts
-      end
-    rescue Rev::BadRequestError => e
-      puts "Displaying transcripts failed with error code #{e.code}, message #{e.message}"
-    end
-  end
-
-  def captions(args)
-    begin
-      order_num = args[0]
-      order = @rev_client.get_order order_num
-
-      if order.captions.empty?
-        puts "There are no captions for order #{order_num}"
-        return
-      end
-
-      order.captions.each do |t|
-        puts "Contents of #{t.name}"
-        puts "-----------------------------------"
-        puts @rev_client.get_attachment_content(t.id).body
-        puts
-      end
-    rescue Rev::BadRequestError => e
-      puts "Displaying captions failed with error code #{e.code}, message #{e.message}"
-    end
-  end
-
-  def dl_transcripts(args)
-    begin
-      order_num = args[0]
-      order = @rev_client.get_order order_num
-
-      if order.transcripts.empty?
-        puts "There are no transcripts for order #{order_num}"
-        return
-      end
-
-      filenames = order.transcripts.map { |t| t.name}.join(',')
-      puts "Downloading files: #{filenames}"
-      order.transcripts.each do |t|
-        @rev_client.save_attachment_content t.id, t.name
-      end
-    rescue Rev::BadRequestError => e
-      puts "Downloading transcripts failed with error code #{e.code}, message #{e.message}"
-    end
-  end
-
-  def dl_captions(args)
-    begin
-      order_num = args[0]
-      order = @rev_client.get_order order_num
-
-      if order.captions.empty?
-        puts "There are no captions for order #{order_num}"
-        return
-      end
-
-      filenames = order.captions.map { |t| t.name}.join(',')
-      puts "Downloading files: #{filenames}"
-      order.captions.each do |t|
-        @rev_client.save_attachment_content t.id, t.name
-      end
-    rescue Rev::BadRequestError => e
-      puts "Downloading captions failed with error code #{e.code}, message #{e.message}"
-    end
-  end
-
-  def dl_sources(args)
-    begin
-      order_num = args[0]
-      order = @rev_client.get_order order_num
-
-      if order.sources.empty?
-        puts "There are no source files for order #{order_num}"
-        return
-      end
-
-      filenames = order.sources.map { |t| t.name }.join(',')
-      puts "Downloading files: #{filenames}"
-      order.sources.each do |t|
-        @rev_client.save_attachment_content t.id, t.name
-      end
-    rescue Rev::BadRequestError => e
-      puts "Downloading sources failed with error code #{e.code}, message #{e.message}"
-    end
-  end
-
-  def cancel(args)
-    begin
-      order_num = args[0]
-      @rev_client.cancel_order order_num
-      puts "Order #{order_num} cancelled"
-    rescue Rev::BadRequestError => e
-      puts "Cancelling order failed with error code #{e.code}, message #{e.message}"
-    end
-  end
-
-  def place_tc(args)
-    input_urls = upload(args, 'audio/mpeg')
-    inputs = input_urls.map { |url| Rev::Input.new(:uri => url, :audio_length_seconds => 180) }
-    tc_options = Rev::TranscriptionOptions.new(inputs)
-    place_helper(inputs, { :transcription_options => tc_options })
-  end
-
-  def place_cp(args)
-    input_urls = upload(args, 'video/mpeg')
-    inputs = input_urls.map { |url| Rev::Input.new(:uri => url, :video_length_seconds => 180) }
-    cp_options = Rev::CaptionOptions.new(inputs, {:output_file_formats => [Rev::CaptionOptions::OUTPUT_FILE_FORMATS[:scc]] })
-    place_helper(inputs, { :caption_options => cp_options })
-  end
-
-  def help(*args)
-    puts "commands are: #{COMMANDS.join(' ')} exit"
-  end
-
-  private
-
-  def upload(args, type)
-    input_urls = args.map do |f|
-      puts "Uploading #{f}"
-      @rev_client.upload_input(f, type)
-    end
-    input_urls
-  end
-
-  def place_helper(inputs, options)
-    options = options.merge({ :client_ref => 'XB432423', :comment => 'Please work quickly' })
-    request = Rev::OrderRequest.new(options)
-
-    begin
-      new_order = @rev_client.submit_order(request)
-      puts "New order: #{new_order}"
-    rescue Rev::BadRequestError => e
-      puts "Order placement failed with error code #{e.code}, message #{e.message}"
-    end
-  end
-
-end
-
-cli = RevCLI.new
-cli.command_loop
+require 'rev-api'
+require 'optparse'
+require 'pp'
+
+# An example app using the official Ruby SDK for the Rev.com API
+#   This ruby script sets up a basic command line interface (CLI)
+#   that prompts a user to authenticate on the web, then
+#   allows them to type commands to manipulate their orders.
+#
+# To start, run:
+# ruby examples/cli.rb --sandbox --client-key your_client_key --user-key your_user_key
+
+class RevCLI
+  COMMANDS = %w{help get get_by_client_ref list transcripts captions dl_transcripts dl_captions dl_sources place_tc place_cp cancel}
+
+  def initialize
+    options = { :environment => Rev::Api::PRODUCTION_HOST, :verbatim => false, :timestamps => false }
+    optparse = OptionParser.new do |opts|
+      opts.banner = "Usage: cli.rb [options]. You will be prompted for command then."
+
+      opts.on("--client-key CLIENT-KEY", "Use CLIENT-KEY as the API Client Key for Authorization") do |client_key|
+        options[:client_key] = client_key
+      end
+
+      opts.on("--user-key USER-KEY", "Use USER-KEY as the API User Key for Authorization") do |user_key|
+        options[:user_key] = user_key
+      end
+
+      opts.on("--sandbox", "Execute against the Sandbox environment rather than production") do
+        options[:environment] = Rev::Api::SANDBOX_HOST
+      end
+
+      opts.on("--[no-]verbatim", "Request verbatim transcription") do |v|
+        options[:verbatim] = v
+      end
+
+      opts.on("--[no-]timestamps", "Request timestamps transcription") do |t|
+        options[:timestamps] = t
+      end
+    end
+    optparse.parse!
+
+    raise OptionParser::MissingArgument, "--client-key" if options[:client_key].nil?
+    raise OptionParser::MissingArgument, "--user-key" if options[:user_key].nil?
+
+    @rev_client = Rev.new(options[:client_key], options[:user_key], options[:environment])
+  end
+
+  def command_loop
+    puts "Enter a command or 'help' or 'exit'"
+    command_line = ''
+
+    while command_line.strip != 'exit'
+      begin
+        execute_command(command_line)
+      rescue RuntimeError => e
+        puts "Command Line Error! #{e.class}: #{e}"
+        puts e.backtrace
+      end
+      print '> '
+      command_line = gets.strip
+    end
+
+    puts 'Goodbye!'
+    exit(0)
+  end
+
+  def execute_command(cmd_line)
+    command = cmd_line.split
+    method = command.first
+    if COMMANDS.include? method
+      begin
+        send(method.to_sym, command[1..-1])
+      rescue Rev::BadRequestError => e
+        puts "Server returned error with code #{e.code}, message #{e.message}"
+      rescue Rev::ApiError => e
+        puts "Server returned error with message #{e.message}"
+      end
+    elsif command.first && !command.first.strip.empty?
+      puts 'Invalid command. Type \'help\' to see commands.'
+    end
+  end
+
+  def get(args)
+    order_num = args[0]
+    order = @rev_client.get_order order_num
+    pp order
+  end
+
+  def list(args)
+    orders = @rev_client.get_all_orders
+    orders.each { |o| puts("#{o.order_number}") }
+
+    puts 'There are no orders placed so far.' if orders.empty?
+  end
+
+  def get_by_client_ref(args)
+    # client ref can contain spaces, so we have to join client ref from pieces
+    if (args.last == '0' || args.last.to_i > 0)
+      client_ref = args[0..-2].join(' ')
+    else
+      client_ref = args.join(' ')
+    end
+
+    client_ref = client_ref.gsub('\'', '').gsub('"', '')
+    page = args.last.nil? ? 0: args.last.to_i
+
+    orders_first_page = @rev_client.get_orders_by_client_ref(client_ref, page)
+    puts "Found #{orders_first_page.total_count} order(s), showing page #{page}. Pass page number as second argument"
+    orders_first_page.orders.each { |o| puts ("#{o.client_ref}: #{o.order_number}") }
+
+    puts "There are no orders associated with the given client reference: #{client_ref}" if orders_first_page.orders.empty?
+  end
+
+  def transcripts(args)
+    begin
+      order_num = args[0]
+      order = @rev_client.get_order order_num
+
+      if order.transcripts.empty?
+        puts "There are no transcripts for order #{order_num}"
+        return
+      end
+
+      order.transcripts.each do |t|
+        puts "Contents of #{t.name}"
+        puts "-----------------------------------"
+        puts @rev_client.get_attachment_content_as_string t.id
+        puts
+      end
+    rescue Rev::BadRequestError => e
+      puts "Displaying transcripts failed with error code #{e.code}, message #{e.message}"
+    end
+  end
+
+  def captions(args)
+    begin
+      order_num = args[0]
+      order = @rev_client.get_order order_num
+
+      if order.captions.empty?
+        puts "There are no captions for order #{order_num}"
+        return
+      end
+
+      order.captions.each do |t|
+        puts "Contents of #{t.name}"
+        puts "-----------------------------------"
+        puts @rev_client.get_attachment_content(t.id).body
+        puts
+      end
+    rescue Rev::BadRequestError => e
+      puts "Displaying captions failed with error code #{e.code}, message #{e.message}"
+    end
+  end
+
+  def dl_transcripts(args)
+    begin
+      order_num = args[0]
+      order = @rev_client.get_order order_num
+
+      if order.transcripts.empty?
+        puts "There are no transcripts for order #{order_num}"
+        return
+      end
+
+      filenames = order.transcripts.map { |t| t.name}.join(',')
+      puts "Downloading files: #{filenames}"
+      order.transcripts.each do |t|
+        @rev_client.save_attachment_content t.id, t.name
+      end
+    rescue Rev::BadRequestError => e
+      puts "Downloading transcripts failed with error code #{e.code}, message #{e.message}"
+    end
+  end
+
+  def dl_captions(args)
+    begin
+      order_num = args[0]
+      order = @rev_client.get_order order_num
+
+      if order.captions.empty?
+        puts "There are no captions for order #{order_num}"
+        return
+      end
+
+      filenames = order.captions.map { |t| t.name}.join(',')
+      puts "Downloading files: #{filenames}"
+      order.captions.each do |t|
+        @rev_client.save_attachment_content t.id, t.name
+      end
+    rescue Rev::BadRequestError => e
+      puts "Downloading captions failed with error code #{e.code}, message #{e.message}"
+    end
+  end
+
+  def dl_sources(args)
+    begin
+      order_num = args[0]
+      order = @rev_client.get_order order_num
+
+      if order.sources.empty?
+        puts "There are no source files for order #{order_num}"
+        return
+      end
+
+      filenames = order.sources.map { |t| t.name }.join(',')
+      puts "Downloading files: #{filenames}"
+      order.sources.each do |t|
+        @rev_client.save_attachment_content t.id, t.name
+      end
+    rescue Rev::BadRequestError => e
+      puts "Downloading sources failed with error code #{e.code}, message #{e.message}"
+    end
+  end
+
+  def cancel(args)
+    begin
+      order_num = args[0]
+      @rev_client.cancel_order order_num
+      puts "Order #{order_num} cancelled"
+    rescue Rev::BadRequestError => e
+      puts "Cancelling order failed with error code #{e.code}, message #{e.message}"
+    end
+  end
+
+  def place_tc(args)
+    input_urls = upload(args, 'audio/mpeg')
+    inputs = input_urls.map { |url| Rev::Input.new(:uri => url, :audio_length_seconds => 180) }
+    tc_options = Rev::TranscriptionOptions.new(inputs)
+    place_helper(inputs, { :transcription_options => tc_options })
+  end
+
+  def place_cp(args)
+    input_urls = upload(args, 'video/mpeg')
+    inputs = input_urls.map { |url| Rev::Input.new(:uri => url, :video_length_seconds => 180) }
+    cp_options = Rev::CaptionOptions.new(inputs, {:output_file_formats => [Rev::CaptionOptions::OUTPUT_FILE_FORMATS[:scc]] })
+    place_helper(inputs, { :caption_options => cp_options })
+  end
+
+  def help(*args)
+    puts "commands are: #{COMMANDS.join(' ')} exit"
+  end
+
+  private
+
+  def upload(args, type)
+    input_urls = args.map do |f|
+      puts "Uploading #{f}"
+      @rev_client.upload_input(f, type)
+    end
+    input_urls
+  end
+
+  def place_helper(inputs, options)
+    options = options.merge({ :client_ref => 'XB432423' })
+    request = Rev::OrderRequest.new(options)
+
+    begin
+      new_order = @rev_client.submit_order(request)
+      puts "New order: #{new_order}"
+    rescue Rev::BadRequestError => e
+      puts "Order placement failed with error code #{e.code}, message #{e.message}"
+    end
+  end
+
+end
+
+cli = RevCLI.new
+cli.command_loop