twilio_recordings 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f6bf1eede329168be4c864532cf2f29a5927de84
+  data.tar.gz: 1c139b37e95d497dabb063ec24dd16f5f9e9706a
+SHA512:
+  metadata.gz: 8e83d87cb5a2d120793e707d319f92b1f574ec5f65e8ee6442611bcbedfbbe1c24e7ef52b98bf474eb79e82ed983d85852cc44c759a31c6d5b6874921a1b4174
+  data.tar.gz: 090620f1f336e0de14094c7a0d026ae52b2ddd17a6df998e2e0c3d98f31c01a127e6e5424d95ffad3d4f0af568977b9fc27e8ff106d649b20da73e2a94dbe018

data/lib/twilio_recordings.rb

@@ -0,0 +1,102 @@
+require 'faraday'
+require 'typhoeus/adapters/faraday'
+
+class TwilioRecordings
+  attr_writer :connection
+
+  ##
+  # Instantiate a new TwilioRecordings object.
+  # 
+  # Example:
+  #   >> t = TwilioRecordings.new(account_sid, recording_sids, tmp_dir: './my_tmp_dir')
+  #   => #<TwilioRecordings:0x00... > 
+  #
+  # Arguments:
+  #   account_sid: The Twilio account SID, e.g. "AC12345678901234567890123456789012"
+  #   recording_sids: An array of recording SIDs, e.g. ["RE12345678901234567890123456789012"]
+  #   tmp_dir: The directory that the recordings will be temporarily downloaded to. (optional, default is '/tmp')
+  def initialize(account_sid, recording_sids, tmp_dir: File.join('','tmp'))
+    @account_sid = account_sid
+    @recording_sids = recording_sids
+    @tmp_dir = tmp_dir
+    @recording_downloads = {}
+  end
+
+  ##
+  # Return a list of URL strings based on the account SID and recording SIDs.
+  #
+  # Example:
+  #   >> t.twilio_urls
+  #   => ["https://api.twilio.com/2010-04-01/Accounts/AC12345678901234567890123456789012/Recordings/RE12345678901234567890123456789012.mp3"]
+  def twilio_urls
+    @recording_sids.map { |r| "https://api.twilio.com/2010-04-01/Accounts/#{@account_sid}/Recordings/#{r}.mp3" }
+  end
+
+  ##
+  # Return a list of URL strings based on the account SID and recording SIDs.
+  #
+  # Example:
+  #   >> t.twilio_urls
+  #   => ["./my_tmp_dir/RE12345678901234567890123456789012.mp3"]
+  def filenames
+    @recording_sids.map { |r| File.join(@tmp_dir, "#{r}.mp3") }
+  end
+
+  ##
+  # Return the Faraday connection used to download the recordings.
+  # 
+  # Will create a new connection if one has not already been set with connection=.
+  #
+  # Example:
+  #   >> t.connection
+  #   => #<Faraday::Connection:0x00... >
+  def connection
+    @connection ||= Faraday.new do |faraday|
+      faraday.adapter :typhoeus
+    end
+  end
+
+  def download_and_join
+    download
+    join
+  end
+
+  ##
+  # Download the recordings to @tmp_dir
+  #
+  # Returns self
+  #
+  # Example:
+  #   >> t.download
+  #   => #<TwilioRecordings:0x00... >
+  def download
+    # download the recordings
+    connection.in_parallel do
+      twilio_urls.zip(filenames).each do |url, filename|
+        @recording_downloads[filename] = connection.get(url)
+      end
+    end
+
+    # write the recordings to file
+    @recording_downloads.each do |filename, response|
+      File.open(filename, 'wb') { |f| f.write(response.body) }
+    end
+
+    self
+  end
+
+  ##
+  # Join the recordings together into a single file. Returns the output filename.
+  #
+  # Example: 
+  #   >> t.join('~/my_file.mp3')
+  #   => "~/my_file.mp3"
+  #
+  # Arguments:
+  #   output: A string to the filename that the output should be written to. (optional, default is '/tmp/joined_{recording_ids}')
+  def join(output=nil)
+    output ||= File.join(@tmp_dir, "joined_#{@recording_sids.join('_')}.mp3")
+    `cat #{filenames.join(" ")} > #{output}`
+    output
+  end
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: twilio_recordings
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+platform: ruby
+authors:
+- Paul Boxley
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-11-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Utility for downloading and joining recordings from Twilio.
+email: paul@paulboxley.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/twilio_recordings.rb
+homepage: 
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.2
+signing_key: 
+specification_version: 4
+summary: TwilioRecordings
+test_files: []