bliptv 0.1.1

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Michael Kelly Sutton
+
+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/Manifest

@@ -0,0 +1,16 @@
+lib/bliptv/api_spec.rb
+lib/bliptv/base.rb
+lib/bliptv/multipart_params.rb
+lib/bliptv/request.rb
+lib/bliptv/video.rb
+lib/bliptv.rb
+lib/ext/array.rb
+lib/ext/hash.rb
+lib/ext/open_struct.rb
+License.txt
+Manifest
+Rakefile
+README.rdoc
+test/test_base.rb
+test/test_suite.rb
+test/test_video.rb

data/README.rdoc

@@ -0,0 +1,86 @@
+= Blip.tv Ruby Library
+
+A Ruby gem for accessing the blip.tv API (http://wiki.blip.tv/index.php/REST_Upload_API)
+
+== Install 
+
+  gem sources -a http://gems.github.com
+  sudo gem install kellysutton-bliptv
+  sudo gem install rest-client
+  sudo gem install mime-types
+
+== Usage
+
+While the blip.tv API is extremely simple to use, sometimes it's nice to have a wrapper
+library to make life even easier. The BlipTV Ruby gem is just that.
+
+Let's say you want to upload a video:
+  
+  require 'rubygems'
+  require 'bliptv'
+  
+  client = BlipTV::Base.new
+  
+  options = {
+    :username => "barack_obama",
+    :password => "michellexoxo",
+    :file => File.open('movie.mov'),
+    :title => "Ordering Hamburgers in DC",
+    :description => "I love this one burger joint, but the press keeps following me."
+  }
+  
+  video = client.upload_video(options) #=> BlipTV::Video
+    
+The upload_video method call returns a BlipTV::Video object
+that you can play around with.
+
+Or what if you wanted a list of all videos by a user? Also easy:
+
+  require 'rubygems'
+  require 'bliptv'
+
+  client = BlipTV::Base.new
+  
+  video_list = client.find_all_videos_by_user("barack_obama") 
+  
+find_all_videos_by_user will return a list of BlipTV::Video objects.
+
+More usage coming soon.
+  
+== Authors
+
+Kelly Sutton (http://michaelkellysutton.com)
+
+== Features
+
+Provides an easy way to interact with the blip.tv API in Ruby.
+  
+== Special Thanks
+
+This gem is extensively based on Shane Vitrana's Viddler
+gem as well as the YouTubeG gem. Much of the code was simply
+copied and then tweaked to fit the blip.tv nomenclature
+of certain calls. 
+
+== License 
+
+Copyright (c) 2009 Michael Kelly Sutton
+
+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/Rakefile

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('bliptv', '0.1.1') do |p|
+  p.description               = "A Ruby library from Blip.tv"
+  p.url                       = "http://github.com/kellysutton/bliptv"
+  p.author                    = "Michael Kelly Sutton"
+  p.email                     = "michael.k.sutton@gmail.com"
+  p.ignore_pattern            = ["tmp/*", "script/*"]
+  p.development_dependencies  = []
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }

data/bliptv.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{bliptv}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael Kelly Sutton"]
+  s.date = %q{2009-06-05}
+  s.description = %q{A Ruby library from Blip.tv}
+  s.email = %q{michael.k.sutton@gmail.com}
+  s.extra_rdoc_files = ["lib/bliptv/api_spec.rb", "lib/bliptv/base.rb", "lib/bliptv/multipart_params.rb", "lib/bliptv/request.rb", "lib/bliptv/video.rb", "lib/bliptv.rb", "lib/ext/array.rb", "lib/ext/hash.rb", "lib/ext/open_struct.rb", "README.rdoc"]
+  s.files = ["lib/bliptv/api_spec.rb", "lib/bliptv/base.rb", "lib/bliptv/multipart_params.rb", "lib/bliptv/request.rb", "lib/bliptv/video.rb", "lib/bliptv.rb", "lib/ext/array.rb", "lib/ext/hash.rb", "lib/ext/open_struct.rb", "License.txt", "Manifest", "Rakefile", "README.rdoc", "test/test_base.rb", "test/test_suite.rb", "test/test_video.rb", "bliptv.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/kellysutton/bliptv}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Bliptv", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{bliptv}
+  s.rubygems_version = %q{1.3.2}
+  s.summary = %q{A Ruby library from Blip.tv}
+  s.test_files = ["test/test_base.rb", "test/test_suite.rb", "test/test_video.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/bliptv.rb

@@ -0,0 +1,27 @@
+#
+# This is the main entry point for the library. All files in the project are
+# included here, as well as anything required across the project. 
+#
+
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require 'rubygems'
+require 'active_support'
+require 'ostruct'
+require 'net/http'
+require 'uri'
+
+require 'ext/array'
+require 'ext/hash'
+require 'ext/open_struct'
+
+require 'bliptv/base'
+require 'bliptv/video'
+require 'bliptv/api_spec'
+require 'bliptv/multipart_params'
+require 'bliptv/request'
+
+
+module BlipTV
+end

data/lib/bliptv/api_spec.rb

@@ -0,0 +1,53 @@
+module BlipTV
+  class ApiSpec
+    VIDEOS_UPLOAD_ATTRS = {
+      :required => [
+        :title,
+        :file,
+        :userlogin,
+        :password
+      ],   
+      :optional => [
+        :thumbnail,
+        :nsfw,
+        :description,
+        :keywords,
+        :categories,
+        :license,
+        :interactive_post
+      ]
+    }
+    
+    VIDEOS_DELETE_ATTRS = {
+      :required => [
+        :userlogin,
+        :password
+        ],
+      :optional => [
+        :username # kind of sloppy, because a user is unlikely to specify both a userlogin AND a username
+      ]
+    }
+  
+    def self.check_attributes(bliptv_method, attributes)
+      valid_attributes = bliptv_method_to_const(bliptv_method)
+      required = valid_attributes[:required] || Array.new
+      optional = valid_attributes[:optional] || Array.new
+    
+      # blip calls it a "userlogin" instead of a "username"
+      if attributes[:username] != nil 
+        attributes[:userlogin] = attributes[:username]
+        attributes.delete(:username)
+      end
+    
+      attributes.assert_valid_keys(required + optional)
+      attributes.assert_required_keys(required)
+    end
+  
+    protected
+  
+    def self.bliptv_method_to_const(method)
+      const_name = method.gsub('.', '_').upcase
+      const_get("#{const_name}_ATTRS")
+    end
+  end
+end

data/lib/bliptv/base.rb

@@ -0,0 +1,127 @@
+module BlipTV
+  # Generic BlipTV exception class.
+  class BlipTVError < StandardError #:nodoc:
+  end
+
+  # Raised when username and password has not been set.
+  class AuthenticationRequiredError < BlipTVError #:nodoc:
+    def message
+      "Method that you're trying to execute requires username and password."
+    end
+  end
+
+  # Raised when calling not yet implemented API methods.
+  class NotImplementedError < BlipTVError #:nodoc:
+    def message
+      'This method is not yet implemented.'
+    end
+  end
+  
+  #
+  # This is the class that should be instantiated for basic
+  # communication with the Blip.tv API
+  #
+  class Base
+    
+    # TODO allow user to specify userlogin and password on intialize
+    def initialize
+    end
+    
+    # Implements the Blip.tv REST Upload API
+    #
+    # <tt>new_attributes</tt> hash should contain next required keys:
+    # * <tt>title:</tt> The video title;
+    # * <tt>file:</tt> The video file;
+    #
+    # and optionally:
+    # * <tt>thumbnail:</tt> A thumbnail file;
+    # * <tt>nsfw:</tt> true if explicit, false otherwise. Defaults to false;
+    # * <tt>description:</tt> A description of the video
+    # * <tt>username:</tt> Username
+    # * <tt>password:</tt> Password
+    # * <tt>keywords:</tt> A comma-separated string of keywords # TODO this should be nice and also accept Arrays
+    # * <tt>categories:</tt> A Hash of categories
+    # * <tt>license:</tt> A license for the video
+    # * <tt>interactive_post:</tt> Specify whether or not a post is interactive. More here[http://wiki.blip.tv/index.php/API_2.0:_Post_Interactivity]
+    #
+    # Example:
+    #
+    #  bliptv.upload_video(:title => 'Check out this guy getting kicked in the nuts!', :file => File.open('/movies/nuts.mov'))
+    #
+    # Returns BlipTV::Video instance. 
+    #
+    def upload_video(new_attributes={})
+      BlipTV::ApiSpec.check_attributes('videos.upload', new_attributes)
+      
+      new_attributes = {
+        :post => "1",
+        :item_type => "file",
+        :skin => "xmlhttprequest",
+        :file_role => "Web"
+      }.merge(new_attributes) # blip.tv requires the "post" param to be set to 1
+      
+      request = BlipTV::Request.new(:post, 'videos.upload')
+      request.run do |p|
+        for param, value in new_attributes
+          p.send("#{param}=", value)
+        end
+      end
+
+      BlipTV::Video.new(request.response['post_url'].to_s)
+    end
+    
+    
+    # Looks up all videos on Blip.tv with a given <tt>username</tt>
+    #
+    # Options hash could contain next values:
+    # * <tt>page</tt>: The "page number" of results to retrieve (e.g. 1, 2, 3); if not specified, the default value equals 1.
+    # * <tt>pagelen</tt>: The number of results to retrieve per page (maximum 100). If not specified, the default value equals 20.
+    #
+    # Example:
+    #
+    #  bliptv.find_all_videos_by_user("username")
+    #    or
+    #  bliptv.find_all_videos_by_user("username", {:page => 1, :pagelen => 20})
+    #
+    # Returns array of BlipTV::Video objects.
+    #
+    def find_all_videos_by_user(username, options={})
+      options[:page] ||= 1; options[:pagelen] ||= 20
+      url, path = "#{username}.blip.tv", "/posts/?skin=api&page=#{options[:page]}&pagelen=#{options[:pagelen]}"
+      request = Net::HTTP.get(url, path)
+      hash = Hash.from_xml(request)
+      hash == nil ? [] : parse_videos_list(hash)
+    end
+  
+  
+    # Searches through and returns videos based on the <tt>search_string</tt>.
+    #
+    # This method is a direct call of Blip.tv's search method. You get what you get. No guarantees are made.
+    #
+    # Example:
+    #
+    #   bliptv.search_videos("cool stuff")
+    #
+    # Returns an array of BlipTV::Video objects
+    #
+    def search_videos(search_string)
+      request = Net::HTTP.get(URI.parse("http://www.blip.tv/search/?search=#{search_string}&skin=api"))
+      hash = Hash.from_xml(request)
+      parse_videos_list(hash)
+    end
+    
+    private
+  
+    def parse_videos_list(hash)
+      list = []
+      begin
+        hash["response"]["payload"]["asset"].each do |entry| 
+          list << Video.new(entry)
+        end
+      rescue NoMethodError
+        list = []
+      end
+      list
+    end
+  end
+end

data/lib/bliptv/multipart_params.rb

@@ -0,0 +1,49 @@
+require 'mime/types'
+
+class MultipartParams #:nodoc:
+  attr_accessor :content_type, :body
+  
+  def initialize(param_hash={})
+    @boundary_token = generate_boundary_token    
+    self.content_type = "multipart/form-data; boundary=#{@boundary_token}"        
+    self.body = pack_params(param_hash)    
+  end
+
+  protected
+  
+  def generate_boundary_token
+    [Array.new(8) {rand(256)}].join
+  end
+  
+  def pack_params(hash)
+    marker = "--#{@boundary_token}\r\n"
+    files_params = hash.find_all{|k,v| v.is_a?(File)}.to_h
+    text_params = hash - files_params
+    
+    pack_hash(text_params, marker) + marker + pack_hash(files_params, marker) + "--#{@boundary_token}--\r\n"
+  end
+  
+  def pack_hash(hash, marker)
+    hash.map do |name, value|
+      marker + case value
+      when String
+        text_to_multipart(name, value)
+      when File
+        file_to_multipart(name, value)
+      end
+    end.join('')
+  end
+  
+  def file_to_multipart(key,file)
+    filename = File.basename(file.path)
+    mime_types = MIME::Types.of(filename)
+    mime_type = mime_types.empty? ? "application/octet-stream" : mime_types.first.content_type
+    part = %Q[Content-Disposition: form-data; name="#{key}"; filename="#{filename}"\r\n]
+    part += "Content-Transfer-Encoding: binary\r\n"
+    part += "Content-Type: video/mp4\r\n\r\n#{file.read}\r\n"
+  end
+
+  def text_to_multipart(key,value)
+    "Content-Disposition: form-data; name=\"#{key}\"\r\n\r\n#{value.to_s}\r\n"
+  end
+end

data/lib/bliptv/request.rb

@@ -0,0 +1,135 @@
+require 'rest_client'
+
+module BlipTV
+  
+  # Raised when response from Blip.tv contains absolutely no data
+  class EmptyResponseError < BlipTVError #:nodoc:
+  end
+  
+  # Raised when response from Blip.tv contains an error
+  class ResponseError < BlipTVError #:nodoc:
+    def initialize(message)
+      super message
+    end
+  end
+  
+  # Class used to send requests over http to Viddler API.
+  class Request #:nodoc:
+    
+    API_URL = 'http://uploads.blip.tv/'
+    DEFAULT_HEADERS = {:accept => 'application/xml', :content_type => 'multi-part/form-data'}
+  
+    attr_accessor :url, :http_method, :response, :body
+    attr_reader :headers, :params
+  
+    def initialize(http_method, method) #:nodoc:
+      @http_method = http_method.to_s
+      @url = API_URL
+      self.params = {} #{:method => viddlerize(method)}    
+      self.headers = DEFAULT_HEADERS
+    end
+    
+    # Use this method to setup your request's payload and headers.
+    #
+    # Example:
+    #
+    #   request.set :headers do |h|
+    #     h.content_type = 'application/ufo'
+    #   end
+    #
+    #   request.set :params do |p|
+    #     p.sessionid = '12323'
+    #     p.api_key   = '13123
+    #   end
+    # 
+    def set(container, &declarations)
+      struct = OpenStruct.new
+      declarations.call(struct)
+      send("#{container}=", struct.table)
+    end
+    
+    # Send http request to Viddler API.
+    def run(&block)
+      if block_given?
+        set(:params, &block)
+      end
+
+      if post? and multipart?
+        put_multipart_params_into_body
+      else
+        put_params_into_url
+      end    
+      
+      request = RestClient::Request.execute(
+         :method => http_method, 
+         :url => url, 
+         :headers => headers, 
+         :payload => body
+       )
+       self.response = parse_response(request)
+    end
+  
+    private
+  
+    def parse_response(raw_response)
+      raise EmptyResponseError if raw_response.blank?
+      response_hash = Hash.from_xml(raw_response)
+      begin
+        if response_error = response_hash["otter_responses"]["response"]["error"]
+          raise ResponseError.new(bliptv_error_message(response_error))
+        end
+      rescue # we don't care if it fails, that means it works
+      end
+      response_hash["post_url"] = raw_response.match(/\d{3,12}/)[0] # extracts the post_url, since from_xml isn't grabbing it
+      response_hash
+    end
+  
+    def put_multipart_params_into_body
+      multiparams = MultipartParams.new(params)
+      self.body = multiparams.body
+      self.headers = {:content_type => multiparams.content_type}
+    end
+  
+    def put_params_into_url
+      self.url = API_URL + '?' + params.to_query
+    end
+  
+    def viddlerize(name)
+      if name.include?('viddler.')
+        name
+      else
+        'viddler.' + name
+      end
+    end
+    
+    def params=(hash) #:nodoc:
+      @params ||= Hash.new
+      @params.update(hash)
+    end
+  
+    def headers=(hash) #:nodoc:
+      @headers ||= Hash.new
+      @headers.update(hash)
+    end
+  
+    def multipart? #:nodoc:
+      # TOOD let's be nice and do a File.exists?(v)
+      if params.find{|k,v| v.is_a?(File)} then true else false end
+    end
+  
+    def post? #:nodoc:
+      http_method == 'post'
+    end
+    
+    def bliptv_error_message(response_error)
+      description = response_error['description'] || ''
+      details = response_error['details'] || ''      
+      code = response_error['code'] || ''
+      
+      details = ": #{details};" unless details.empty?
+      code = " [code: #{code}]" unless code.empty?
+      %Q[#{description}#{details}#{code}]
+    end
+  
+  end
+end

data/lib/bliptv/video.rb

@@ -0,0 +1,165 @@
+require 'net/http'
+require 'uri'
+
+module BlipTV
+
+  BLIP_TV_ID_EXPR = /\d{3,12}/
+  
+  # Raised when pinging Blip.tv for video information results in an error
+  class VideoResponseError < BlipTVError #:nodoc:
+    def initialize(message)
+      super message
+    end
+  end
+  
+  class VideoDeleteError < BlipTVError
+    def intialize(message)
+      super message
+    end
+  end
+  
+  # This class wraps Blip.tv's video's information.
+  class Video
+  
+    attr_accessor :id,
+                  :title,
+                  :description,
+                  :guid,
+                  :deleted,
+                  :view_count,
+                  :tags,
+                  :links,
+                  :author,
+                  :update_time,
+                  :explicit,
+                  :notes,
+                  :license,
+                  :embed_url,
+                  :embed_code
+                  
+    def initialize(blip_id) #:nodoc:
+      blip_id = blip_id.to_s if blip_id.class == Fixnum
+      
+      if blip_id.class == String && blip_id.match(BLIP_TV_ID_EXPR)
+        update_attributes_from_id(blip_id)
+      elsif blip_id.class == Hash
+        update_attributes_from_hash(blip_id)
+      end
+    end
+    
+    def update_attributes_from_id(blip_id)
+      @id = blip_id
+      
+      a = get_attributes
+      update_attributes_from_hash(a)
+    end
+    
+    def update_attributes_from_hash(a)
+      
+      @id               = a['item_id'] if @id == nil
+      @title            = a['title']
+      @description      = a['description']
+      @guid             = a['guid']
+      @deleted          = a['deleted']
+      @view_count       = a['views']
+      @tags             = parse_tags a['tags']
+      @links            = a['links']['link']
+      @thumbnail_url    = a['thumbnail_url']
+      @author           = a['created_by']['login'] if a['created_by']
+      @update_time      = a['timestamp'] ? Time.at(a['update_time'].to_i) : nil
+      @explicit         = a['explicit']
+      @license          = a['license']
+      @notes            = a['notes']
+      @embed_url        = a['embed_url']
+      @embed_code       = a['embed_code']
+    end
+    
+    #
+    # fire off a HTTP GET response to Blip.tv
+    #
+    # In the future, this should probably be rolled into the 
+    # BlipTV::Request class, so that all exception raising and 
+    # network communication exists in instances of that class.
+    #
+    def get_attributes                                                         
+      url = URI.parse('http://www.blip.tv/')   
+      res = Net::HTTP.start(url.host, url.port) {|http|      
+       http.get("http://www.blip.tv/file/#{@id.to_s}?skin=api")
+      }                                                                                
+      
+      hash = Hash.from_xml(res.body)
+      
+      if hash["response"]["status"] != "OK"
+        raise VideoResponseError.new(hash["response"]["notice"])
+      end
+      
+      if hash["response"]["payload"]["asset"].is_a?(Array) 
+        return hash["response"]["payload"]["asset"][0] # there may be several assets. In that case, read the first one
+      else
+        return hash["response"]["payload"]["asset"]
+      end
+    end
+    
+    #
+    # Refresh the current video object. Useful to check up on encoding progress,
+    # etc.
+    #
+    def refresh
+      update_attributes_from_id(@id)
+    end
+    
+    #
+    # delete! will delete the file from Blip.tv
+    #
+    def delete!(creds = {}, section = "file", reason = "because")
+      BlipTV::ApiSpec.check_attributes('videos.delete', creds)
+      
+      reason = reason.gsub(" ", "%20") # TODO write a method to handle this and other illegalities of URL
+      
+      if creds[:username] && !creds[:userlogin]
+        creds[:userlogin] = creds[:username]
+      end
+      
+      url, path = "www.blip.tv", "/?userlogin=#{creds[:userlogin]}&password=#{creds[:password]}&cmd=delete&s=file&id=#{@id}&reason=#{reason}&skin=api"
+      request = Net::HTTP.get(url, path)
+      hash = Hash.from_xml(request)
+      make_sure_video_was_deleted(hash)
+    end
+    
+    private
+    
+    #
+    # Makes sense out of Blip.tv's strucutre of the <tt>tag</tt> element
+    #
+    # returns a String
+    #
+    def parse_tags(element)
+      if element.class == Hash && element['string']
+        if element['string'].class == Array
+          return element['string'].join(", ")
+        elsif element['string'].class == String 
+          return element['string']
+        end
+      else
+        return ""
+      end
+    end
+    
+    #
+    # make_sure_video_was_deleted analyzes the response <tt>hash</tt>
+    # to make sure it was a success
+    #
+    # raises a descriptive BlipTV::VideoDeleteError
+    #
+    def make_sure_video_was_deleted(hash)
+      # TODO have a special case for authentication required?
+      if hash["response"]["status"] != "OK"
+        begin
+          raise VideoDeleteError.new("#{hash['response']['error']['code']}: #{hash['response']['error']['message']} ") 
+        rescue NoMethodError # TODO irony!
+          raise VideoDeleteError.new(hash.to_yaml)
+        end
+      end
+    end
+  end
+end

data/lib/ext/array.rb

@@ -0,0 +1,18 @@
+class Array #:nodoc:
+  
+  # Extraceted from Ruby Facets:
+  # Converts a two-element associative array into a hash.
+  def to_h(arrayed=nil)
+    h = {}
+    if arrayed
+      each{ |k,*v| h[k] = v }
+    else
+      ary = []
+      each do |a|
+        Array===a ? ary.concat(a) : ary << a
+      end
+      h = Hash[*ary]
+    end
+    h
+  end
+end

data/lib/ext/hash.rb

@@ -0,0 +1,28 @@
+class Hash #:nodoc:
+  
+  def assert_required_keys(keys)
+    for key in keys
+      raise(ArgumentError, "Missing required key(s): #{key}") unless self.keys.include?(key)
+    end
+    true
+  end
+  
+  # Extracted from Ruby Facets:
+  # Operator for remove hash paris. If another hash is given the pairs are only removed if both key and value are equal. If an array is given then matching keys are removed.
+  def -(other)
+    h = self.dup
+    if other.respond_to?(:to_ary)
+      other.to_ary.each do |k|
+        h.delete(k)
+      end
+    else
+      other.each do |k,v|
+        if h.key?(k)
+          h.delete(k) if v == h[k]
+        end
+      end
+    end
+    h
+  end
+  
+end

data/lib/ext/open_struct.rb

@@ -0,0 +1,7 @@
+class OpenStruct #:nodoc:
+  
+  def table
+    @table
+  end
+  
+end

data/test/test_base.rb

@@ -0,0 +1,58 @@
+require 'lib/bliptv'
+
+class TC_BaseTest < Test::Unit::TestCase
+  def setup
+    @base = BlipTV::Base.new
+  end
+  
+  def teardown
+  end
+  
+  def test_find_all_videos_by_user
+    
+    videos = @base.find_all_videos_by_user("onemonthhere")
+    
+    assert_not_equal nil, videos
+    assert_instance_of Array, videos
+    assert videos.size >= 12 # at the time of the writing of the test
+    
+    videos.each do |video|
+      assert_not_equal "", video.title # all videos must have a title
+      assert_equal "onemonthhere", video.author
+      assert_equal "false", video.explicit # I know for a fact that all videos are not explicit
+    end
+  end
+
+  def test_find_all_videos_by_user_retrieve_100
+    
+    videos = @base.find_all_videos_by_user("verycocinar", {:page => 1, :pagelen => 100})
+    
+    assert_not_equal nil, videos
+    assert_instance_of Array, videos
+    assert videos.size == 100    
+  end
+
+  def test_find_all_videos_by_user_more_than_one_page
+    
+    videos_1 = @base.find_all_videos_by_user("verycocinar", {:page => 2, :pagelen => 30})
+    videos_2 = @base.find_all_videos_by_user("verycocinar", {:page => 3, :pagelen => 30})
+    
+    assert_instance_of Array, videos_1
+    assert_instance_of Array, videos_2
+    assert videos_1.size == 30
+    assert videos_2.size == 30
+    assert_not_equal videos_1, videos_2
+  end
+
+  def test_search_videos
+    videos = @base.search_videos("cool")
+    
+    assert_not_equal nil, videos # unless Blip.tv is having a bad day :(
+    assert_instance_of Array, videos
+    assert videos.size > 10 # assumption
+    
+    videos.each do |video|
+      assert_not_equal "", video.title # all videos must have a title
+    end
+  end
+end

data/test/test_suite.rb

@@ -0,0 +1,16 @@
+require 'test/unit'
+require 'test/unit/testsuite'
+require 'test/unit/ui/console/testrunner'
+
+require 'test/test_video'
+require 'test/test_base'
+
+class TS_BlipTVTests
+  def self.suite
+    suite = Test::Unit::TestSuite.new "Blip.tv gem tests"
+    suite << TC_VideoTest.suite
+    suite << TC_BaseTest.suite
+    return suite
+  end
+end
+Test::Unit::UI::Console::TestRunner.run(TS_BlipTVTests)

data/test/test_video.rb

@@ -0,0 +1,133 @@
+require 'lib/bliptv'
+
+NO_TAGS = "\n\t\t\n\t"
+
+class TC_VideoTest < Test::Unit::TestCase
+  def setup
+  end
+  
+  def teardown
+  end
+  
+  def test_video_initialize_with_int_and_string
+    video1 = BlipTV::Video.new(2193230)
+    video2 = BlipTV::Video.new("2193230")
+    
+    a = [video1, video2]
+    
+    a.each do |video|
+      assert_not_equal    nil, video
+      assert_instance_of  BlipTV::Video, video
+  
+      
+      assert_equal "Super Mario Galaxy 2", video.title
+      
+      h = { "mode" => "escaped", "type" => "text/html" }
+      assert_equal h, video.description
+      
+      assert_equal "D2215402-5017-11DE-9B2F-C1BCBB520399", video.guid           
+      assert_equal "false", video.deleted        
+      assert_equal nil, video.view_count # because we don't have the user login info
+      assert_equal "", video.tags
+      
+      links = [{"href"=>"http://blip.tv/file/2193230",
+        "rel"=>"alternate",
+        "type"=>"text/html"},
+       {"href"=>"http://blip.tv/file/2193230/?skin=api",
+        "rel"=>"alternate",
+        "type"=>"text/xml"},
+       {"href"=>"http://blip.tv/file/post/2193230/",
+        "rel"=>"service.edit",
+        "type"=>"text/html"},
+       {"href"=>"http://blip.tv/rss/2204077",
+        "rel"=>"alternate",
+        "type"=>"application/rss+xml"},
+       {"href"=>"http://blip.tv/file/2193230/?skin=atom",
+        "rel"=>"alternate",
+        "type"=>"application/atom+xml"},
+       {"href"=>"http://blip.tv/file/post/2193230/?skin=api",
+        "rel"=>"service.edit",
+        "type"=>"text/xml"}]
+      
+      assert_equal links, video.links          
+      assert_equal "kotaku", video.author         
+      assert_equal "Thu Jan 01 01:00:00 +0100 1970", video.update_time.to_s # not sure why this is the epoch
+      assert_equal "false", video.explicit       
+      
+      license = {"name"=>"No license (All rights reserved)"}
+      assert_equal license, video.license
+      
+      notes = {"mode"=>"escaped", "type"=>"text/html"}
+      assert_equal notes, video.notes          
+      
+      assert_equal "http://blip.tv/play/g4Q9gYbEEY35ZA", video.embed_url
+      assert_equal "<embed src=\"http://blip.tv/play/g4Q9gYbEEY35ZA\" type=\"application/x-shockwave-flash\" width=\"854\" height=\"510\" allowscriptaccess=\"always\" allowfullscreen=\"true\"></embed>", video.embed_code
+    end
+  end
+  
+  def test_video_with_more_data
+    video = BlipTV::Video.new(2141730)
+    
+    assert_match /\d{3,12}/, video.id
+    assert_equal "Field Recon - One Month Here - Episode 9", video.title         
+    assert_equal "I spend most of today out in the field, scoping out challenge locations. Berghain looks eerie and deserted. It's likely the exact opposite at night. I need some swimming trunks...<br /><br /> Tweets read today from @<a href=\"http://twitter.com/iMuesli\">iMuesli</a> , @<a href=\"http://twitter.com/andrewseely\">andrewseely</a> , @<a href=\"http://twitter.com/JDFirst\">JDFirst</a> , @<a href=\"http://twitter.com/grasp183\">grasp183</a> and @<a href=\"http://twitter.com/mxchickmagnet86\">mxchickmagnet86</a><br /><br /> Thanks for watching!", video.description   
+    assert_equal "DB14423E-460F-11DE-B85A-FF0EAE6B9387", video.guid          
+    assert_equal "false", video.deleted       
+    assert_equal nil, video.view_count    
+    assert_equal "bergain, badeschiff, kelly sutton, berlin, germany, kreuzberg", video.tags          
+    
+    links = [{"href"=>"http://blip.tv/file/2141730",
+      "rel"=>"alternate",
+      "type"=>"text/html"},
+     {"href"=>"http://blip.tv/file/2141730/?skin=api",
+      "rel"=>"alternate",
+      "type"=>"text/xml"},
+     {"href"=>"http://blip.tv/file/post/2141730/",
+      "rel"=>"service.edit",
+      "type"=>"text/html"},
+     {"href"=>"http://blip.tv/rss/2152384",
+      "rel"=>"alternate",
+      "type"=>"application/rss+xml"},
+     {"href"=>"http://blip.tv/file/2141730/?skin=atom",
+      "rel"=>"alternate",
+      "type"=>"application/atom+xml"},
+     {"href"=>"http://blip.tv/file/post/2141730/?skin=api",
+      "rel"=>"service.edit",
+      "type"=>"text/xml"}]
+    assert_equal links, video.links         
+    assert_equal "onemonthhere", video.author        
+    assert_equal 0, video.update_time.to_i
+    assert_equal "false", video.explicit
+    
+    licensce = {"name"=>"Creative Commons Attribution 3.0",
+     "link"=>
+      {"href"=>"http://creativecommons.org/licenses/by/3.0/", "type"=>"text/html"}}
+    assert_equal licensce, video.license  
+    
+    notes = {"mode"=>"escaped", "type"=>"text/html"}     
+    assert_equal notes, video.notes         
+    assert_equal "http://blip.tv/play/AYGDsCSV5jE", video.embed_url     
+    assert_equal "<embed src=\"http://blip.tv/play/AYGDsCSV5jE\" type=\"application/x-shockwave-flash\" width=\"640\" height=\"510\" allowscriptaccess=\"always\" allowfullscreen=\"true\"></embed>", video.embed_code
+  end
+  
+  def test_video_delete
+    base = BlipTV::Base.new
+    
+    options = {
+      :userlogin => "bliptv_ruby_gem",
+      :password => "thisissosecret",
+      :file => File.open('/Users/msutton/Desktop/output.mp4'), # change this to a file of your own
+      :title => "test title",
+      :description => "test description"
+    }
+
+    video = base.upload_video(options) #=> BlipTV::Video
+    
+    options = {
+      :userlogin => "bliptv_ruby_gem",
+      :password => "thisissosecret"
+    }
+    
+    video.delete!(options)
+  end
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification 
+name: bliptv
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- Michael Kelly Sutton
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-06-05 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: A Ruby library from Blip.tv
+email: michael.k.sutton@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- lib/bliptv/api_spec.rb
+- lib/bliptv/base.rb
+- lib/bliptv/multipart_params.rb
+- lib/bliptv/request.rb
+- lib/bliptv/video.rb
+- lib/bliptv.rb
+- lib/ext/array.rb
+- lib/ext/hash.rb
+- lib/ext/open_struct.rb
+- README.rdoc
+files: 
+- lib/bliptv/api_spec.rb
+- lib/bliptv/base.rb
+- lib/bliptv/multipart_params.rb
+- lib/bliptv/request.rb
+- lib/bliptv/video.rb
+- lib/bliptv.rb
+- lib/ext/array.rb
+- lib/ext/hash.rb
+- lib/ext/open_struct.rb
+- License.txt
+- Manifest
+- Rakefile
+- README.rdoc
+- test/test_base.rb
+- test/test_suite.rb
+- test/test_video.rb
+- bliptv.gemspec
+has_rdoc: true
+homepage: http://github.com/kellysutton/bliptv
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Bliptv
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: bliptv
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A Ruby library from Blip.tv
+test_files: 
+- test/test_base.rb
+- test/test_suite.rb
+- test/test_video.rb