ruby-slideshare 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a2374eeca9167e6c1e12d398211f5438bd01c021
+  data.tar.gz: abc1ea2abd83f92b209d171de9e2ddc20295eec0
+SHA512:
+  metadata.gz: 43983c420ddb40f3d2c5e74b0b5ced5e22acbbf24e960c9cad7774d443d0408038618ee37f217df3ea8833ba8e4677e24fa102b8e3c9f1d223d3b1fa24f27ced
+  data.tar.gz: bd1d5f4e9ec1446a16dec7f595764d8c90c06e2009d7e2f7a6c25fa1aa0a68664bc517e85256012c2eb8e2e715474afef232bf0c1e5aeb87dea85f25f55f1846

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in slideshare.gemspec
+gemspec

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/Readme.markdown

@@ -0,0 +1,28 @@
+# Super Mega Slideshare
+
+A ruby wrapper for Slideshare.
+
+## Example
+
+    require 'rubygems'
+    require 'slideshare'
+    Slideshare.configure do |config|
+    	config.api_key = "XYZ123"
+    	config.api_secret = "123XYZ"
+    end
+
+    begin
+    	Slideshare.get_slideshow(:slideshow_url => "http://www.slideshare.net/lolcats/lolcatz-2-minute-break-1", :detailed => 1)
+    rescue Slideshare::SlideshareError => e
+    	puts e
+    end
+
+    begin
+    	Slideshare.get_slideshows_by_tag(:tag => "lolcats")
+    rescue Slideshare::SlideshareError => e
+    	puts e
+    end
+
+## Contributors
+
+Written by Edd Parris for NixonMcInnes, large parts copied with great thanks from the Twitter gem (https://github.com/jnunemaker/twitter)

data/lib/faraday/multipart.rb

@@ -0,0 +1,30 @@
+require 'faraday'
+
+# @private
+module Faraday
+  # @private
+  class Request::Multipart < Faraday::Middleware
+    def call(env)
+      if env[:body].is_a?(Hash)
+        env[:body].each do |key, value|
+          if value.is_a?(File)
+            env[:body][key] = Faraday::UploadIO.new(value, mime_type(value), value.path)
+          end
+        end
+      end
+
+      @app.call(env)
+    end
+
+    private
+
+    def mime_type(file)
+      case file.path
+        when /\.jpe?g/i then 'image/jpeg'
+        when /\.gif$/i then 'image/gif'
+        when /\.png$/i then 'image/png'
+        else 'application/octet-stream'
+      end
+    end
+  end
+end

data/lib/faraday/parse_slideshare_xml.rb

@@ -0,0 +1,54 @@
+require 'faraday'
+require 'nokogiri'
+
+# @private
+module Faraday
+  # @private
+  class Response::ParseSlideshareXml < Response::Middleware
+    begin
+      require 'multi_xml'
+    rescue LoadError, NameError => error
+      self.load_error = error
+    end
+    
+    def self.register_on_complete(env)
+      # parse and raise either proper error or just return the response
+      env[:response].on_complete do |response|
+        response[:body] = begin
+          error_id = nil
+          doc = Nokogiri::XML(response[:body])
+          doc.search('Message').each do |node|
+            raise Slideshare::SlideshareError, error_message(response, node['ID'].to_s + " " + node.text)
+          end
+          ::MultiXml.parse(response[:body])
+        end
+      end
+    end
+
+    def initialize(app)
+      super
+      @parser = nil
+    end
+
+    private
+
+    def self.error_message(response, message)
+      "#{response[:method].to_s.upcase} #{response[:url].to_s}: #{response[:status]} #{message}"
+    end
+
+    def self.error_body(body)
+      if body.nil?
+        nil
+      elsif body['error']
+        ": #{body['error']}"
+      elsif body['errors']
+        first = body['errors'].to_a.first
+        if first.kind_of? Hash
+          ": #{first['message'].chomp}"
+        else
+          ": #{first.chomp}"
+        end
+      end
+    end
+  end
+end

data/lib/faraday/raise_http_4xx.rb

@@ -0,0 +1,52 @@
+require 'faraday'
+
+# @private
+module Faraday
+  # @private
+  class Response::RaiseHttp4xx < Response::Middleware
+    def self.register_on_complete(env)
+      env[:response].on_complete do |response|
+        case response[:status].to_i
+        when 400
+          raise Slideshare::BadRequest, error_message(response)
+        when 401
+          raise Slideshare::Unauthorized, error_message(response)
+        when 403
+          raise Slideshare::Forbidden, error_message(response)
+        when 404
+          raise Slideshare::NotFound, error_message(response)
+        when 406
+          raise Slideshare::NotAcceptable, error_message(response)
+        when 420
+          raise Slideshare::EnhanceYourCalm.new error_message(response), response[:response_headers]
+        end
+      end
+    end
+
+    def initialize(app)
+      super
+      @parser = nil
+    end
+
+    private
+
+    def self.error_message(response)
+      "#{response[:method].to_s.upcase} #{response[:url].to_s}: #{response[:status]}#{error_body(response[:body])}"
+    end
+
+    def self.error_body(body)
+      if body.nil?
+        nil
+      elsif body['error']
+        ": #{body['error']}"
+      elsif body['errors']
+        first = body['errors'].to_a.first
+        if first.kind_of? Hash
+          ": #{first['message'].chomp}"
+        else
+          ": #{first.chomp}"
+        end
+      end
+    end
+  end
+end

data/lib/faraday/raise_http_5xx.rb

@@ -0,0 +1,31 @@
+require 'faraday'
+
+# @private
+module Faraday
+  # @private
+  class Response::RaiseHttp5xx < Response::Middleware
+    def self.register_on_complete(env)
+      env[:response].on_complete do |response|
+        case response[:status].to_i
+        when 500
+          raise Slideshare::InternalServerError, error_message(response, "Something is technically wrong.")
+        when 502
+          raise Slideshare::BadGateway, error_message(response, "Slideshare is down or being upgraded.")
+        when 503
+          raise Slideshare::ServiceUnavailable, error_message(response, "(__-){ Slideshare is over capacity.")
+        end
+      end
+    end
+
+    def initialize(app)
+      super
+      @parser = nil
+    end
+
+    private
+
+    def self.error_message(response, body=nil)
+      "#{response[:method].to_s.upcase} #{response[:url].to_s}: #{[response[:status].to_s + ':', body].compact.join(' ')} Check http://status.twitter.com/ for updates on the status of the Twitter service."
+    end
+  end
+end

data/lib/slideshare.rb

@@ -0,0 +1,30 @@
+require 'slideshare/error'
+require 'slideshare/configuration'
+require 'slideshare/client'
+require 'slideshare/api'
+
+
+module Slideshare
+  extend Configuration
+  
+  # Alias for Slideshare::Client.new
+  #
+  # @return [Slideshare::Client]
+  def self.client(options={})
+    Slideshare::Client.new(options)
+  end
+
+  # Delegate to Slideshare::Client
+  def self.method_missing(method, *args, &block)
+    return super unless client.respond_to?(method)
+    client.send(method, *args, &block)
+  end
+
+  # Delegate to Slideshare::Client
+  def self.respond_to?(method)
+    return client.respond_to?(method) || super
+  end
+  
+end
+
+

data/lib/slideshare/api.rb

@@ -0,0 +1,256 @@
+module Slideshare
+  module Api
+    
+    
+    # Authorization: Optional
+    # URL: http://www.slideshare.net/api/2/get_slideshow
+    # Required parameters:
+    # * slideshow_id: ID of the slideshow to be fetched.
+    # * slideshow_url: URL of the slideshow to be fetched. This is required if slideshow_id is not set. If both are set, slideshow_id takes precedence.
+    # Optional parameters
+    # * username: Username of the requesting user
+    # * password: Password of the requesting user
+    # * exclude_tags: Exclude tags from the detailed information. 1 to exclude.
+    # * detailed: Whether or not to include optional information. 1 to include, 0 (default) for basic information.
+    def get_slideshow(options={})
+      response = get("get_slideshow/", options)
+    end
+    
+    
+    # Authorization: None
+    # URL: http://www.slideshare.net/api/2/get_slideshows_by_tag
+    # Required parameters:
+    # * tag: Tag name
+    # Optional: parameters
+    # * limit: Specify number of items to return
+    # * offset: Specify offset
+    # * detailed: Whether or not to include optional information. 1 to include, 0 (default) for basic information.
+    def get_slideshows_by_tag(options={})
+      response = get("get_slideshows_by_tag/", options)
+    end
+    
+    # Authorization: None
+    # URL http://www.slideshare.net/api/2/get_slideshows_by_group
+    # Required parameters
+    # * group_name: Group name (as returned in QueryName element in get_user_groups method)
+    # Optional parameters
+    # * limit: Specify number of items to return
+    # * offset: Specify offset
+    # * detailed: Whether or not to include optional information. 1 to include, 0 (default) for basic information.
+    def get_slideshows_by_group(options={})
+      response = get("get_slideshows_by_group/", options)
+    end
+    
+    # Authorization: None
+    # URL: http://www.slideshare.net/api/2/get_slideshows_by_user
+    # Required parameters:
+    # * username_for username of owner of slideshows
+    # Optional parameters:
+    # * username username of the requesting user
+    # * password password of the requesting user
+    # * limit specify number of items to return
+    # * offset specify offset
+    # * detailed Whether or not to include optional information. 1 to include, 0 (default) for basic information.
+    # * get_unconverted Whether or not to include unconverted slideshows. 1 to include them, 0 (default) otherwise.
+    def get_slideshows_by_user(options={})
+      response = get("get_slideshows_by_user/", options)
+    end
+    
+    # Authorization: None
+    # URL: http://www.slideshare.net/api/2/search_slideshows
+    # Required parameters:
+    # * q: the query string
+    # Optional parameters:
+    # * page: The page number of the results (works in conjunction with items_per_page), default is 1
+    # * items_per_page: Number of results to return per page, default is 12
+    # * lang: Language of slideshows (default is English, 'en') ('**':All,'es':Spanish,'pt':Portuguese,'fr':French,'it':Italian,'nl':Dutch, 'de':German,'zh':Chinese,'ja':Japanese,'ko':Korean,'ro':Romanian, '!!':Other)
+    # * sort: Sort order (default is 'relevance') ('mostviewed','mostdownloaded','latest')
+    # * upload_date: The time period you want to restrict your search to. 'week' would restrict to the last week. (default is 'any') ('week', 'month', 'year')
+    # * what: What type of search. If not set, text search is used. 'tag' is the other option.
+    # * download: Slideshows that are available to download; Set to '0' to do this, otherwise default is all slideshows.
+    # * fileformat: File format to search for. Default is "all". ('pdf':PDF,'ppt':PowerPoint,'odp':Open Office,'pps':PowerPoint Slideshow,'pot':PowerPoint template)
+    # * file_type: File type to search for. Default is "all". ('presentations', 'documents', 'webinars','videos')
+    # * cc: Set to '1' to retrieve results under the Creative Commons license. Default is '0'
+    # * cc_adapt: Set to '1' for results under Creative Commons that allow adaption, modification. Default is '0'
+    # * cc_commercial: Set to '1' to retrieve results with the commercial Creative Commons license. Default is '0'
+    # * detailed: Whether or not to include optional information. 1 to include, 0 (default) for basic information.
+    def search_slideshows(options={})
+      response = get("search_slideshows/", options)
+    end
+    
+    # Authorization: Optional
+    # URL: http://www.slideshare.net/api/2/get_user_groups
+    # Required parameters:
+    # * username_for: Username of user whose groups are being requested
+    # Optional parameters:
+    # * username: Username of the requesting user
+    # * password: Password of the requesting user
+    def get_user_groups(options={})
+      response = get("get_user_groups/", options)
+    end
+    
+    # Authorization: Optional
+    # URL: http://www.slideshare.net/api/2/get_user_contacts
+    # Required parameters:
+    # * username_for: username of user whose Contacts are being requested
+    # Optional parameters:
+    # * limit: Specify number of items to return
+    # * offset: Specify offset
+    def get_user_contacts(options={})
+      response = get("get_user_contacts/", options)
+    end
+    
+    # Authorization: Required
+    # URL: http://www.slideshare.net/api/2/get_user_tags
+    # Required parameters:
+    # username: Username of the requesting user
+    # password: Password of the requesting user
+    def get_user_tags(options={})
+      response = get("get_user_tags/", options)
+    end
+    
+    # Authorization: Required
+    # URL: http://www.slideshare.net/api/2/edit_slideshow
+    # Required parameters:
+    # * username: Username of the requesting user
+    # * password: Password of the requesting user
+    # * slideshow_id: Slideshow ID
+    # Optional parameters:
+    # * slideshow_title: Text
+    # * slideshow_description: Text
+    # * slideshow_tags: Text
+    # * make_slideshow_private: Should be Y if you want to make the slideshow private. If this is not set, following tags will not be considered
+    # * generate_secret_url: Generate a secret URL for the slideshow. Requires make_slideshow_private to be Y
+    # * allow_embeds: Sets if other websites should be allowed to embed the slideshow. Requires make_slideshow_private to be Y
+    # * share_with_contacts: Sets if your contacts on SlideShare can view the slideshow. Requires make_slideshow_private to be Y
+    def edit_slideshow(options={})
+      response = get("edit_slideshow/", options)
+    end
+    
+    # Authorization: Required
+    # URL: http://www.slideshare.net/api/2/delete_slideshow
+    # Required parameters:
+    # * username: username of the requesting user
+    # * password: password of the requesting user
+    # * slideshow_id: slideshow ID
+    def delete_slideshow(options={})
+      response = get("delete_slideshow/", options)
+    end
+    
+    # Not quite working yet, need to figure out best way to handle uploads.
+    # Get versions with upload_url set should work ok though
+    # Authorization: Required
+    # URL: http://www.slideshare.net/api/2/upload_slideshow
+    # Required parameters:
+    # * username: Username of the requesting user
+    # * password: Password of the requesting user
+    # * slideshow_title: Slideshow's title
+    # * slideshow_srcfile: Slideshow file (requires HTTP POST)
+    # -OR-
+    # * upload_url: string containing an url pointing to the power point file: ex: http://domain.tld/directory/my_power_point.ppt
+    #   The following urls are also acceptable
+    #     http://www.domain.tld/directory/file.ppt
+    #     http://www.domain.tld/directory/file.cgi?filename=file.ppt
+    # 
+    #   Note, that this will not accept entries that cannot be identified by their extension. If you sent
+    #   http://www.domain.tld/directory/file.cgi?id=2342
+    #   We will not be able to identify the type of the file!
+    # Optional parameters
+    # * slideshow_description: description
+    # * slideshow_tags: tags should be comma separated
+    # * make_src_public: Y if you want users to be able to download the ppt file, N otherwise. Default is Y
+    # Privacy settings (optional):
+    # * make_slideshow_private: Should be Y if you want to make the slideshow private. If this is not set, following tags will not be considered
+    # * generate_secret_url: Generate a secret URL for the slideshow. Requires make_slideshow_private to be Y
+    # * allow_embeds: Sets if other websites should be allowed to embed the slideshow. Requires make_slideshow_private to be Y
+    # * share_with_contacts: Sets if your contacts on SlideShare can view the slideshow. Requires make_slideshow_private to be Y
+    # 
+    # The document will upload into the account of the user specified by (username / password). The user associated with the API key need not be the
+    # same as the user into who's account the slideshow gets uploaded. So, for example, a bulk uploader would include the api_key (and hash) associated
+    # with the API account, and the username and password associated with the account being uploaded to.
+    def upload_slideshow(options={})
+      response = get("upload_slideshow/", options)
+    end
+    
+    # Authorization: Required
+    # URL: http://www.slideshare.net/api/2/add_favorite
+    # Required parameters:
+    # * username: Username of the requesting user
+    # * password: Password of the requesting user
+    # * slideshow_id: the slideshow to be favorited
+    def add_favorite(options={})
+      response = get("add_favorite/", options)
+    end
+    
+    # Authorization: Required
+    # URL: http://www.slideshare.net/api/2/check_favorite
+    # Required parameters:
+    # * username: username of the requesting user
+    # * password: password of the requesting user
+    # * slideshow_id: Slideshow which would be favorited
+    def check_favorite(options={})
+      response = get("check_favorite/", options)
+    end
+    
+    # Authorization: Mandatory
+    # URL: http://www.slideshare.net/api/2/get_user_campaigns
+    # Required parameters:
+    # * username: username of the requesting user
+    # * password: password of the requesting user
+    def get_user_campaigns(options={})
+      response = get("get_user_campaigns/", options)
+    end
+    
+    # Authorization: Mandatory
+    # URL: http://www.slideshare.net/api/2/get_user_leads
+    # Required parameters:
+    # * username: username of the requesting user
+    # * password: password of the requesting user
+    # Optional parameters
+    # * begin: only get leads collected after this UTC date: YYYYMMDDHHMM
+    # * end: only get leads collected before this UTC date: YYYYMMDDHHMM
+    # Note: January 18th, 2010.
+    # We have changed the field to ,
+    # For ruby/C people this is: strftime("%Y%m%d%H%M")
+    # We realize that we asking for input dates in UTC, but give out information in MNT
+    # time is funny, but we will fix this in the next revision
+    def get_user_leads(options={})
+      response = get("get_user_leads/", options)
+    end
+    
+    # Authorization: Mandatory
+    # URL: http://www.slideshare.net/api/2/get_user_campaign_leads
+    # Required parameters:
+    # * username: username of the requesting user
+    # * password: password of the requesting user
+    # * campaign_id: campaign_id to select the leads from
+    # Optional parameters:
+    # * begin: only get leads collected after this UTC date: YYYYMMDDHHMM
+    # * end: only get leads collected before this UTC date: YYYYMMDDHHMM
+    # Note: January 18th, 2010.
+    # We have changed the field to ,
+    # For ruby/C people this is: strftime("%Y%m%d%H%M")
+    # We realize that we asking for input dates in UTC, but give out information in MNT
+    # time is funny, but we will fix this in the next revision.
+    def get_user_campaign_leads(options={})
+      response = get("get_user_campaign_leads/", options)
+    end
+    
+    def get_slideshow(options={})
+      response = get("get_slideshow/", options)
+    end
+    
+    def get_slideshow(options={})
+      response = get("get_slideshow/", options)
+    end
+    
+    def get_slideshow(options={})
+      response = get("get_slideshow/", options)
+    end
+    
+    def get_slideshow(options={})
+      response = get("get_slideshow/", options)
+    end
+    
+  end
+end

data/lib/slideshare/authentication.rb

@@ -0,0 +1,27 @@
+require 'digest/sha1'
+
+module Slideshare
+  # @private
+  module Authentication
+    private
+
+    # Authentication hash
+    #
+    # @return [Hash]
+    def authentication
+      timestamp = Time.now.to_i.to_s
+      {
+        :api_key => api_key,
+        :ts => timestamp,
+        :hash => Digest::SHA1.hexdigest(api_secret + timestamp)
+      }
+    end
+
+    # Check whether user is authenticated
+    #
+    # @return [Boolean]
+    def authenticated?
+      authentication.values.all?
+    end
+  end
+end

data/lib/slideshare/client.rb

@@ -0,0 +1,26 @@
+require 'slideshare/connection'
+require 'slideshare/request'
+require 'slideshare/api'
+require 'slideshare/authentication'
+
+module Slideshare
+  class Client
+    attr_accessor *Configuration::VALID_OPTIONS_KEYS
+
+    # Creates a new API
+    def initialize(options={})
+      options = Slideshare.options.merge(options)
+      Configuration::VALID_OPTIONS_KEYS.each do |key|
+        send("#{key}=", options[key])
+      end
+    end
+
+    include Connection
+    include Request
+    include Authentication
+    include Api
+    
+    
+    
+  end
+end

data/lib/slideshare/configuration.rb

@@ -0,0 +1,60 @@
+require 'faraday'
+require 'slideshare/version'
+
+module Slideshare
+  module Configuration
+    VALID_OPTIONS_KEYS = [
+      :adapter,
+      :version,
+      :api_key,
+      :api_secret,
+      :api_endpoint,
+      :http_endpoint,
+      :https_endpoint,
+      :format,
+      :user_agent
+    ].freeze
+    
+    VALID_FROMATS = [:xml].freeze
+    
+    DEFAULT_ADAPTER = Faraday.default_adapter
+    DEFAULT_VERSION = "2".freeze
+    DEFAULT_API_KEY = nil
+    DEFAULT_API_SECRET = nil
+    DEFAULT_API_ENDPOINT = "https://www.slideshare.net/api/2/".freeze
+    DEFAULT_FORMAT = :xml
+    DEFAULT_USER_AGENT = "Slideshare Rub Gem #{Slideshare::VERSION}".freeze
+    
+    
+    # @private
+    attr_accessor *VALID_OPTIONS_KEYS
+
+    # When this module is extended, set all configuration options to their default values
+    def self.extended(base)
+      base.reset
+    end
+
+    # Convenience method to allow configuration options to be set in a block
+    def configure
+      yield self
+    end
+    
+    # Create a hash of options and their values
+    def options
+      Hash[VALID_OPTIONS_KEYS.map {|key| [key, send(key)] }]
+    end
+    
+    # Reset all configuration options to defaults
+    def reset
+      self.adapter        = DEFAULT_ADAPTER
+      self.version        = DEFAULT_VERSION
+      self.api_key        = DEFAULT_API_KEY
+      self.api_secret     = DEFAULT_API_SECRET
+      self.api_endpoint   = DEFAULT_API_ENDPOINT
+      self.format         = DEFAULT_FORMAT
+      self.user_agent     = DEFAULT_USER_AGENT
+      self
+    end
+    
+  end
+end

data/lib/slideshare/connection.rb

@@ -0,0 +1,37 @@
+require 'faraday_middleware'
+require 'faraday/multipart'
+require 'faraday/raise_http_4xx'
+require 'faraday/raise_http_5xx'
+require 'faraday/parse_slideshare_xml'
+
+module Slideshare
+  # @private
+  module Connection
+    private
+    
+    def connection(raw=false)
+      
+      options = {
+        :headers => {'Accept' => "application/#{format}", 'User-Agent' => user_agent},
+        :ssl => {:verify => false},
+        :url => api_endpoint,
+      }
+
+      Faraday::Connection.new(options) do |connection|
+        connection.use Faraday::Request::Multipart #, authentication
+        #connection.use Faraday::Request::OAuth, authentication if authenticated?
+        connection.adapter(adapter)
+        connection.use Faraday::Response::RaiseHttp5xx
+        unless raw
+          case format.to_s.downcase
+          when 'json' then connection.use Faraday::Response::ParseJson # one can hope
+          when 'xml' then connection.use Faraday::Response::ParseSlideshareXml
+          end
+        end
+        connection.use Faraday::Response::RaiseHttp4xx
+        connection.use Faraday::Response::Mashify unless raw
+      end
+    end
+    
+  end
+end

data/lib/slideshare/error.rb

@@ -0,0 +1,31 @@
+module Slideshare
+  # Custom error class for rescuing from all SlideShare errors
+  class Error < StandardError; end
+
+  # Raised when SlideShare returns the HTTP status code 400
+  class BadRequest < Error; end
+
+  # Raised when SlideShare returns the HTTP status code 401
+  class Unauthorized < Error; end
+
+  # Raised when SlideShare returns the HTTP status code 403
+  class Forbidden < Error; end
+
+  # Raised when SlideShare returns the HTTP status code 404
+  class NotFound < Error; end
+
+  # Raised when SlideShare returns the HTTP status code 406
+  class NotAcceptable < Error; end
+
+  # Raised when SlideShare returns the HTTP status code 500
+  class InternalServerError < Error; end
+
+  # Raised when SlideShare returns the HTTP status code 502
+  class BadGateway < Error; end
+
+  # Raised when SlideShare returns the HTTP status code 503
+  class ServiceUnavailable < Error; end
+  
+  # Raised when SlideShare returns any other error from its API
+  class SlideshareError < Error; end
+end

data/lib/slideshare/request.rb

@@ -0,0 +1,45 @@
+module Slideshare
+  # Defines HTTP request methods
+  module Request
+    # Perform an HTTP GET request
+    def get(path, options={}, raw=false)
+      request(:get, path, options, raw)
+    end
+
+    # Perform an HTTP POST request
+    def post(path, options={}, raw=false)
+      request(:post, path, options, raw)
+    end
+
+    # Perform an HTTP PUT request
+    def put(path, options={}, raw=false)
+      request(:put, path, options, raw)
+    end
+
+    # Perform an HTTP DELETE request
+    def delete(path, options={}, raw=false)
+      request(:delete, path, options, raw)
+    end
+
+    private
+
+    # Perform an HTTP request
+    def request(method, path, options, raw=false)
+      options.merge!(authentication)
+      response = connection(raw).send(method) do |request|
+        case method
+        when :get, :delete
+          request.url(path, options)
+        when :post, :put
+          request.path = path
+          request.body = options unless options.empty?
+        end
+      end
+      raw ? response : response.body
+    end
+
+    def formatted_path(path)
+      [path, format].compact.join('.')
+    end
+  end
+end

data/lib/slideshare/version.rb

@@ -0,0 +1,4 @@
+module Slideshare
+  # The version of the gem
+  VERSION = '0.1.2' #.freeze unless defined?(::Slideshare::VERSION)
+end

data/slideshare.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "slideshare/version"
+#require File.expand_path('../lib/slideshare/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "ruby-slideshare"
+  s.version     = Slideshare::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Edd Parris"]
+  s.email       = ["eddy@nixonmcinnes.co.uk"]
+  s.homepage    = ""
+  s.summary     = %q{Wrapper for the Slideshare API}
+  s.description = %q{Wrapper for the Slideshare API}
+
+  s.rubyforge_project = s.name
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.post_install_message = "
+  ****************************************************************
+  Thank you for installing #{s.name}!
+  ****************************************************************
+  "
+  s.add_runtime_dependency('hashie', '~> 1.0.0')
+  s.add_runtime_dependency('faraday', '~> 0.5.4')
+  s.add_runtime_dependency('faraday_middleware', '~> 0.3.2')
+  s.add_runtime_dependency('nokogiri', '~> 1.4.4')
+  s.add_runtime_dependency('multi_xml', '~> 0.2')
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification
+name: ruby-slideshare
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- Edd Parris
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.4
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.2
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.4
+- !ruby/object:Gem::Dependency
+  name: multi_xml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: Wrapper for the Slideshare API
+email:
+- eddy@nixonmcinnes.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Rakefile
+- Readme.markdown
+- lib/faraday/multipart.rb
+- lib/faraday/parse_slideshare_xml.rb
+- lib/faraday/raise_http_4xx.rb
+- lib/faraday/raise_http_5xx.rb
+- lib/slideshare.rb
+- lib/slideshare/api.rb
+- lib/slideshare/authentication.rb
+- lib/slideshare/client.rb
+- lib/slideshare/configuration.rb
+- lib/slideshare/connection.rb
+- lib/slideshare/error.rb
+- lib/slideshare/request.rb
+- lib/slideshare/version.rb
+- slideshare.gemspec
+homepage: ''
+licenses: []
+metadata: {}
+post_install_message: "\n  ****************************************************************\n
+  \ Thank you for installing ruby-slideshare!\n  ****************************************************************\n
+  \ "
+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: ruby-slideshare
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Wrapper for the Slideshare API
+test_files: []