pomade 0.2.1 → 0.2.2

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 1.9.3

data/.yardopts

@@ -0,0 +1,2 @@
+--markup markdown
+lib/**/*.rb

data/Gemfile

@@ -1,4 +1,10 @@
 source 'https://rubygems.org'
 
-# Specify your gem's dependencies in pomade.gemspec
 gemspec
+
+gem 'rake'
+
+group :test do
+  gem 'i18n'
+  gem 'tzinfo'
+end

data/Rakefile

@@ -1 +1,21 @@
-require "bundler/gem_tasks"
+require 'rubygems'
+require 'bundler/gem_tasks'
+
+# ----- Utility Functions -----
+
+def scope(path)
+  File.join(File.dirname(__FILE__), path)
+end
+
+# ----- Default: Testing -----
+
+task :default => :test
+
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  test_files = FileList[scope('test/test_*.rb')]
+  t.test_files = test_files
+  t.verbose = true
+end

data/lib/pomade/exceptions.rb

@@ -2,6 +2,9 @@ module Pomade
   # Errors thrown from Pomegranate
   class ResponseError < StandardError; end
 
+  # Cannot authenticate
+  class AuthenticationError < StandardError; end
+
   # If an asset's keys do not match up
   class InvalidAssetKeys < StandardError; end
 

data/lib/pomade/publisher.rb

@@ -7,88 +7,164 @@ module Pomade
   # Handles all interactions to Pomegranate.
   class Publisher
     ##
-    # Creates a new instance of +Publisher+ that pushes records to Pomegranate.
+    # Creates a new instance of `Publisher` that pushes records to Pomegranate. If you do not set any optional arguments, Pomade will connect to Pomegranate's public sandbox instance.
     # 
-    # == Parameters
+    # ## Parameters
     # 
-    # * *subdomain* _(string)_ - The subdomain for the Pomegranate instance that you'd like to connect to.
-    # * *username* _(string)_ - The username used for connecting to your isntance.
-    # * *password* _(string)_ - The password used for connecting to your isntance.
-    # * *client_id* _(string)_ - Your client ID.
-    # * *opts* _(hash, optional)_ - Additional options. Available options are:
-    #   * *:host* _(string)_ - The host (domain name) that your Pomegranate instance lives on.
-    #   * *:pathname* _(string)_ - The path that is used for interacting with assets.
-    #   * *:time_format* _(strftime)_ - Change the layout of the timestamp that is posted to your instance.
-    #   * *:domain* _(string)_ - NTLM login domain.
+    # * **args** _(hash, optional)_
+    #   * **:subdomain** _(string)_ -- The subdomain for the Pomegranate instance that you'd like to connect to.
+    #   * **:username** _(string)_ -- The username used for connecting to your isntance.
+    #   * **:password** _(string)_ -- The password used for connecting to your isntance.
+    #   * **:client_id** _(string)_ -- Your client ID.
+    #   * **:skip_authentication** _(string)_ -- Skip any authentication tests
+    #   * **:host** _(string)_ -- The host (domain name) that your Pomegranate instance lives on.
+    #   * **:pathname** _(string)_ -- The path that is used for interacting with assets.
+    #   * **:time_format** _(strftime)_ -- Change the layout of the timestamp that is posted to your instance.
+    #   * **:domain** _(string)_ -- NTLM login domain.
     # 
-    # == Returns
-    # An instance of +Pomade::Publisher+
+    # ## Returns
     # 
-    # == Example
+    # An instance of `Pomade::Publisher`
+    # 
+    # ## Example
     #
-    #   @pom = Pomade::Publisher.new('my-subdomain', 'myusername', 'mypassword', 'XX')
-    def initialize(subdomain, username, password, client_id, opts = {})
-      @subdomain = subdomain
-      @username = username
-      @password = password
-      @client_id = client_id
+    #     @pom = Pomade::Publisher.new('my-subdomain', 'myusername', 'mypassword', 'XX')
+    def initialize(args = {})
+      @subdomain = args[:subdomain] || 'pomegranate'
+      @username = args[:username] || nil
+      @password = args[:password] || nil
+      @client_id = args[:client_id] || 'P0'
 
       # Other options
       @options = {}
-      @options[:host] = opts[:host] || 'timessquare2.com'
-      @options[:pathname] = opts[:pathname] || '/p/p.svc/Assets/'
-      @options[:time_format] = opts[:time_format] || "%Y-%m-%dT%H:%M:%SZ"
-      @options[:domain] = opts[:domain] || nil
+      @options[:skip_authentication] = args[:skip_authentication] || false
+      @options[:host] = args[:host] || 'timessquare2.com'
+      @options[:pathname] = args[:pathname] || '/p/p.svc/Assets/'
+      @options[:time_format] = args[:time_format] || "%Y-%m-%dT%H:%M:%SZ"
+      @options[:domain] = args[:domain] || nil
+
+      # Test authentication
+      test_authentication! unless @options[:skip_authentication]
     end
 
     ##
-    # Publishes an array of assets to Pomegranate and returns the results in a +hash+.
+    # Sets authentication credentials
+    #
+    # ## Parameters
     # 
-    # == Parameters
+    # * **credentials** _(hash)_
+    #   * **:subdomain** _(string)_ -- The subdomain for the Pomegranate instance that you'd like to connect to.
+    #   * **:username** _(string)_ -- The username used for connecting to your isntance.
+    #   * **:password** _(string)_ -- The password used for connecting to your isntance.
+    #   * **:client_id** _(string)_ -- Your client ID.
+    #
+    # ## Returns
     # 
-    # * *assets* _(array)_ - A collection of assets. Each item consists of a hash with three keys: +:target+, +:type+ and +:value+. The values for keys +:target+ and +:value+ are both strings while the +:type+ key's value is a symbol. Available values are:
-    #   * +:image+ -- An +IMAGE+ type asset
-    #   * +:video+ -- A +VIDEO+ type asset
-    #   * +:text+ -- A +TEXT+ type asset
+    # A `boolean` depending on whether the authentication passed or failed.
     # 
-    # == Returns
+    # ## Example
     # 
-    # A +hash+ containing two keys: +record_id+ and +assets+.
+    #     credz = {
+    #       username: "myuser",
+    #       password: "mypass",
+    #       subdomain: "mysubdomain",
+    #       client_id: "XX"
+    #     }
+    #     @pom.authenticate(opts)
+    #     # => true
+    def authenticate(credentials)
+      @subdomain = credentials[:subdomain] || @subdomain
+      @username = credentials[:username] || @username
+      @password = credentials[:password] || @password
+      @client_id = credentials[:client_id] || @client_id
+
+      test_authentication unless @options[:skip_authentication]
+    end
+
+    ##
+    # Check if authentication is set
+    def authentication_set?
+      !@username.nil? && !@password.nil?
+    end
+
+    ##
+    # Performs a GET request on the Pomegranate instance's feed to ensure login credentials are correct.
+    def test_authentication
+      status = false
+
+      Net::HTTP.start("#{@subdomain}.#{@options[:host]}", 80) do |http|
+        req = Net::HTTP::Get.new(@options[:pathname])
+
+        if authentication_set?
+          req.ntlm_auth(@username, @options[:domain], @password)
+        end
+
+        response = http.request(req)
+
+        if response.code.to_i.between?(200,399)
+          status = true
+        else
+          status = false
+        end
+      end
+
+      return status
+    end
+
+    ##
+    # Raises AuthenticationError if authentication fails
+    def test_authentication!
+      raise AuthenticationError unless test_authentication
+    end
+
+    ##
+    # Publishes an array of assets to Pomegranate and returns the results in a `hash`.
+    # 
+    # ## Parameters
+    # 
+    # * **assets** _(array)_ -- A collection of assets. Each item consists of a hash with three keys: `:target`, `:type` and `:value`. The values for keys `:target` and `:value` are both strings while the `:type` key's value is a symbol. Available values are:
+    #   * `:image` -- An `IMAGE type asset
+    #   * `:video` -- A `VIDEO` type asset
+    #   * `:text` -- A `TEXT` type asset
     # 
-    # == Example
+    # ## Returns
     # 
-    #   records = [
-    #     { target: "XX~username", type: :text, value: "jakebellacera"},
-    #     { target: "XX~avatar", type: :image, value: "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png"}
-    #   ]
-    #   
-    #   @pom.publish(records)
-    #   # =>
-    #   {
-    #     record_id: "XX-91c8071a-1201-4f99-bc9d-f8d53a947dc1",
-    #     assets: [
-    #       {
-    #         "AssetID" => "9a24c8e2-1066-42fb-be1c-697c5ead476d",
-    #         "AssetData" => "jakebellacera",
-    #         "AssetType" => "TEXT",
-    #         "Target" => "XX~username",
-    #         "Client" => "XX",
-    #         "Status" => "APPROVED",
-    #         "AssetMeta" => "",
-    #         "AssetRecordID" => "XX-91c8071a-1201-4f99-bc9d-f8d53a947dc1"
-    #       },
-    #       {
-    #         "AssetID" => "9a24c8e2-1066-42fb-be1c-697c5ead476d",
-    #         "AssetData" => "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png",
-    #         "AssetType" => "IMAGE",
-    #         "Target" => "XX~avatar",
-    #         "Client" => "XX",
-    #         "Status" => "APPROVED",
-    #         "AssetMeta" => "",
-    #         "AssetRecordID" => "XX-91c8071a-1201-4f99-bc9d-f8d53a947dc1"
-    #       }
+    # A `hash` containing two keys: `record_id` and `assets`.
+    # 
+    # ## Example
+    # 
+    #     assets = [
+    #       { target: "PUB~1text", type: :text, value: "jakebellacera" },
+    #       { target: "PUB~1image", type: :image, value: "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png" }
     #     ]
-    #   }
+    #     
+    #     @pom.publish(records)
+    #     # =>
+    #     {
+    #       record_id: "P0-91c8071a-1201-4f99-bc9d-f8d53a947dc1",
+    #       assets: [
+    #         {
+    #           "AssetID" => "9a24c8e2-1066-42fb-be1c-697c5ead476d",
+    #           "AssetData" => "jakebellacera",
+    #           "AssetType" => "TEXT",
+    #           "Target" => "PUB~1text",
+    #           "Client" => "P0",
+    #           "Status" => "UPLOADED",
+    #           "AssetMeta" => "",
+    #           "AssetRecordID" => "P0-91c8071a-1201-4f99-bc9d-f8d53a947dc1"
+    #         },
+    #         {
+    #           "AssetID" => "9a24c8e2-1066-42fb-be1c-697c5ead476c",
+    #           "AssetData" => "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png",
+    #           "AssetType" => "IMAGE",
+    #           "Target" => "PUB~1image",
+    #           "Client" => "P0",
+    #           "Status" => "UPLOADED",
+    #           "AssetMeta" => "",
+    #           "AssetRecordID" => "P0-91c8071a-1201-4f99-bc9d-f8d53a947dc1"
+    #         }
+    #       ]
+    #     }
     def publish(assets)
       @record_id = generate_record_id
       @time = Time.now.strftime(@options[:time_format])
@@ -108,30 +184,30 @@ module Pomade
     ##
     # Validates an array of assets.
     # 
-    # == Parameters
+    # ## Parameters
     #
-    # * *assets* _(array)_ - A collection of assets. Each item consists of a hash with three keys: +:target+, +:type+ and +:value+. The values for keys +:target+ and +:value+ are both strings while the +:type+ key's value is a symbol. Available values are:
-    #   * +:image+ -- An +IMAGE+ type asset
-    #   * +:video+ -- A +VIDEO+ type asset
-    #   * +:text+ -- A +TEXT+ type asset
+    # * **assets** _(array)_ -- A collection of assets. Each item consists of a hash with three keys: `:target`, `:type` and `:value`. The values for keys `:target` and `:value` are both strings while the `:type` key's value is a symbol. Available values are:
+    #   * `:image` -- An `IMAGE` type asset
+    #   * `:video` -- A `VIDEO` type asset
+    #   * `:text` -- A `TEXT` type asset
     #
-    # == Returns
+    # ## Returns
     # 
-    # The +array+ of assets.
+    # The `array` of assets.
     # 
-    # == Example
+    # ## Example
     # 
-    #   records = [
-    #     { target: "XX~USERNAME", type: :text, value: "jakebellacera"},
-    #     { target: "XX~AVATAR", type: :image, value: "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png"}
-    #   ]
-    #   
-    #   @pom.validate(records)
-    #   # =>
-    #   [
-    #     { target: "XX~USERNAME", type: :text, value: "jakebellacera"},
-    #     { target: "XX~AVATAR", type: :image, value: "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png"}
-    #   ]
+    #     assets = [
+    #       { target: "PUB~1text", type: :text, value: "jakebellacera" },
+    #       { target: "PUB~1image", type: :image, value: "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png" }
+    #     ]
+    #     
+    #     @pom.validate(records)
+    #     # =>
+    #     [
+    #       { target: "PUB~1text", type: :text, value: "jakebellacera" },
+    #       { target: "PUB~1image", type: :image, value: "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png" }
+    #     ]
     def validate(assets)
       available_keys = [:target, :type, :value].sort
 
@@ -142,16 +218,48 @@ module Pomade
       end
     end
 
+    ##
+    # Checks if the assets are valid or not.
+    # 
+    # ## Parameters
+    #
+    # * **assets** _(array)_ -- A collection of assets. Each item consists of a hash with three keys: `:target`, `:type` and `:value`. The values for keys `:target` and `:value` are both strings while the `:type` key's value is a symbol. Available values are:
+    #   * `:image` -- An `IMAGE` type asset
+    #   * `:video` -- A `VIDEO` type asset
+    #   * `:text` -- A `TEXT` type asset
+    #
+    # ## Returns
+    # 
+    # A `boolean` depending on if the assets pass or fail validation.
+    # 
+    # ## Example
+    # 
+    #     assets = [
+    #       { target: "PUB~1text", type: :text, value: "jakebellacera" },
+    #       { target: "PUB~1image", type: :image, value: "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png" }
+    #     ]
+    #     
+    #     @pom.valid?(records)
+    #     # => true
+    def valid?(assets)
+      begin
+        validate(assets)
+        return true
+      rescue
+        return false
+      end
+    end
+
     private
 
     ##
-    # Generates a +SecureRandom.uuid+ (GUID) with the +client_id+ appended to it.
+    # Generates a `SecureRandom.uuid` (GUID) with the `client_id` appended to it.
     def generate_record_id
       @client_id + '-' + SecureRandom.uuid
     end
 
     ##
-    # Tests to see if an asset's +:value+ is correct in correlation to its +:type+.
+    # Tests to see if an asset's `:value` is correct in correlation to its `:type`.
     def test(asset)
       # If the value is a URL...
       if (asset[:type] == :image || asset[:type] == :video) && url?(asset[:value])
@@ -166,15 +274,15 @@ module Pomade
     ##
     # Posts an XML to the Pomegranate instance and handles the response.
     #
-    # *Note:* This method will fail if any requests are rejected.
+    # **Note:** This method will fail if any requests are rejected.
     #
-    # == Parameters
+    # ## Parameters
     # 
-    # * *body* _(string, XML)_ - A Pomegranate XML asset
+    # * **body** _(string, XML)_ -- A Pomegranate XML asset
     #
-    # == Returns
+    # ## Returns
     # 
-    # An +array+ of comiled Pomegranate assets
+    # An `array` of comiled Pomegranate assets
     def post(data)
       response_data = []
       data.each do |xml|
@@ -201,9 +309,9 @@ module Pomade
     ##
     # Sends a request to Pomegranate
     #
-    # == Parameters
+    # ## Parameters
     # 
-    # * *body* _(string, XML)_ - A Pomegranate XML asset
+    # * *body* _(string, XML)_ -- A Pomegranate XML asset
     def send_request(body)
       status = false
       data = false
@@ -215,7 +323,10 @@ module Pomade
         req.content_type = 'application/atom+xml'
         req.content_length = body.size - 20 # Currently a bug with the Pomegranate API I believe
         req.body = body
-        req.ntlm_auth(@username, @options[:domain], @password)
+
+        if authentication_set?
+          req.ntlm_auth(@username, @options[:domain], @password)
+        end
 
         response = http.request(req)
 
@@ -255,7 +366,7 @@ module Pomade
               <d:AssetRecordID>#{@record_id}</d:AssetRecordID>
               <d:Target>#{target}</d:Target>
               <d:Client>#{@client_id}</d:Client>
-              <d:Status>APPROVED</d:Status>
+              <d:Status>#{@client_id == "P0" ? "UPLOADED" : "APPROVED"}</d:Status>
             </m:properties>
           </content>
         </entry>

data/lib/pomade/version.rb

@@ -1,3 +1,3 @@
 module Pomade
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

data/readme.md

@@ -1,12 +1,12 @@
 # Pomade - The ruby Pomegranate API wrapper
 
-Pomade is a gem that acts as an API wrapper used for interfacing with TimesSquare2's [Pomegranate API](http://api.timessquare2.com/pomegranate/).
+Pomade is a ruby library that acts as an API wrapper used for interfacing with TimesSquare2's [Pomegranate API](http://api.timessquare2.com/pomegranate/).
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
-    gem 'pomade'
+    gem 'pomade', '~> 0.2.2'
 
 And then execute:
 
@@ -18,79 +18,124 @@ Or install it yourself as:
 
 ## Publisher
 
-Publisher lets you publish content to the Pomegranate API.
+_View the full documentation [here](http://rdoc.info/github/jakebellacera/pomade/master/Pomade/Publisher)_
+
+Publisher lets you easily publish content to the Pomegranate API. It handles everything from authenticating your requests to building XML files, so all you need to worry about is the content.
 
 ```ruby
-Pomade::Publisher.new(subdomain, username, password, client_id, options)
-```
+@pom = Pomade::Publisher.new
 
-#### Available Options
+assets = [
+  { target: "PUB~1text", type: :text, value: "jakebellacera" },
+  { target: "PUB~1image", type: :image, value: "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png" }
+]
 
-These are the available options and their defaults.
+record = @pom.publish(assets)
 
-```ruby
+puts record
+# =>
 {
-    host:           'timessquare2.com',     # [string] The host (domain name) that Pomegranate lives on.
-    pathname:       '/p/p.svc/Assets/',     # [string] The path that is used for interacting with Pomegranate.
-    time_format:    "%Y-%m-%dT%H:%M:%SZ",   # [string] (strftime) change the layout of the timestamp.
-    login_domain:   nil                     # [string] NTLM login domain.
+  record_id: "P0-91c8071a-1201-4f99-bc9d-f8d53a947dc1",
+  assets: [
+    {
+      "AssetID" => "9a24c8e2-1066-42fb-be1c-697c5ead476d",
+      "AssetData" => "jakebellacera",
+      "AssetType" => "TEXT",
+      "Target" => "PUB~1text",
+      "Client" => "P0",
+      "Status" => "UPLOADED",
+      "AssetMeta" => "",
+      "AssetRecordID" => "P0-91c8071a-1201-4f99-bc9d-f8d53a947dc1"
+    },
+    {
+      "AssetID" => "9a24c8e2-1066-42fb-be1c-697c5ead476d",
+      "AssetData" => "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png",
+      "AssetType" => "IMAGE",
+      "Target" => "PUB~1image",
+      "Client" => "P0",
+      "Status" => "UPLOADED",
+      "AssetMeta" => "",
+      "AssetRecordID" => "P0-91c8071a-1201-4f99-bc9d-f8d53a947dc1"
+    }
+  ]
 }
 ```
 
 ### Usage
 
-To publish assets to Pomegranate, simply create a new `Pomade::Publisher` instance.
+To publish assets to Pomegranate, simply create a new Publisher instance (for available options, [go here](http://rdoc.info/github/jakebellacera/pomade/master/Pomade/Publisher:initialize)).
 
 ```ruby
-@pom = Pomade::Publisher.new('my-subdomain', 'myusername', 'mypassword', 'XX')
+@pom = Pomade::Publisher.new
 ```
 
-Next, you'll want to push your assets to Pomegranate. You can do this by building an array of hashes. Each item in the array represents a single asset and they each have three keys: **:target**, **:type** and **:value**. You'll pass this array into the `publish` method.
+Next, you'll need to publish your assets. An asset is a `hash` that consists of three keys: **:target**, **:type** and **:value**.
 
 ```ruby
 assets = [
-  { target: "XX~username", type: :text, value: "jakebellacera"},
-  { target: "XX~avatar", type: :image, value: "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png"}
+  { target: "PUB~1text", type: :text, value: "jakebellacera" },
+  { target: "PUB~1image", type: :image, value: "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png" }
 ]
 
 record = @pom.publish(assets)
 ```
 
-The `publish` method will return a **record**. A record is a hash with two keys: **:record_id** and **:assets**. The `:record_id` is a randomly generated UUID string with your client_id prepended to it while the `:assets` array is the posted assets.
+Once the publishing is complete, Publisher will return the finalized record data.
 
 ```ruby
 puts record
-#=>
+# =>
 {
-  record_id: "XX-91c8071a-1201-4f99-bc9d-f8d53a947dc1",
+  record_id: "P0-91c8071a-1201-4f99-bc9d-f8d53a947dc1",
   assets: [
     {
       "AssetID" => "9a24c8e2-1066-42fb-be1c-697c5ead476d",
       "AssetData" => "jakebellacera",
       "AssetType" => "TEXT",
-      "Target" => "XX~username",
-      "Client" => "XX",
-      "Status" => "APPROVED",
+      "Target" => "PUB~1text",
+      "Client" => "P0",
+      "Status" => "UPLOADED",
       "AssetMeta" => "",
-      "AssetRecordID" => "XX-91c8071a-1201-4f99-bc9d-f8d53a947dc1"
+      "AssetRecordID" => "P0-91c8071a-1201-4f99-bc9d-f8d53a947dc1"
     },
     {
-      "AssetID" => "9a24c8e2-1066-42fb-be1c-697c5ead476d",
+      "AssetID" => "9a24c8e2-1066-42fb-be1c-697c5ead476c",
       "AssetData" => "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png",
       "AssetType" => "IMAGE",
-      "Target" => "XX~avatar",
-      "Client" => "XX",
-      "Status" => "APPROVED",
+      "Target" => "PUB~1image",
+      "Client" => "P0",
+      "Status" => "UPLOADED",
       "AssetMeta" => "",
-      "AssetRecordID" => "XX-91c8071a-1201-4f99-bc9d-f8d53a947dc1"
+      "AssetRecordID" => "P0-91c8071a-1201-4f99-bc9d-f8d53a947dc1"
     }
   ]
 }
 ```
 
+#### Authentication
+
+If you require authentication, you can authenticate either at initialization or by running the `authenticate` method. Publisher will attempt to authenticate with Pomegranate. Since this is a setter method, you can authenticate as many times as you'd like throughout your application.
+
+```ruby
+credz = {
+  username: "myuser",
+  password: "mypass",
+  subdomain: "mysubdomain",
+  client_id: "XX"
+}
+@pom.authenticate(opts)
+# => true
+```
+
 #### Validation
 
-Once you attempt to publish your assets, `Publisher` will attempt to validate your assets. Most of the time it will work, as Publisher will check your URLS for :image and :video types and ensure that they resolve properly. This validation may not find everything and you'll still get a bad response from Pomegranate, if that's the case, please [file a bug](http://github.com/jakebellacera/pomade/issues) with the steps you took to reproduce the problem.
+Once you attempt to publish your assets, Publisher will attempt to validate your assets. Most of the time it will work, as Publisher will check your URLS if the asset's type is :image and :video and ensure that they resolve properly. This validation may not find everything and you'll still get a bad response from Pomegranate. If that's the case, please [file a bug](http://github.com/jakebellacera/pomade/issues) with the steps you took to reproduce the problem.
+
+You can also run a validation manually by running the `validate(assets)` method where `assets` is your array of assets to check against.
+
+## More Info
+
+Need more info? Check the [docs](http://rdoc.info/github/jakebellacera/pomade/master/frames) or [browse the source](http://github.com/jakebellacera/pomade).
 
 ## Contributing
 

data/test/test_helper.rb

@@ -0,0 +1,11 @@
+require 'rubygems'
+require 'bundler'
+Bundler.setup(:default, :test)
+Bundler.require(:default, :test)
+
+dir = File.dirname(File.expand_path(__FILE__))
+$LOAD_PATH.unshift dir + '/../lib'
+$TESTING = true
+require 'test/unit'
+require 'pomade'
+require 'tzinfo'

data/test/test_publisher.rb

@@ -0,0 +1,22 @@
+require 'test_helper'
+
+# Fixtures
+$valid_assets = [
+  { target: "XX~username", type: :text, value: "jakebellacera"},
+  { target: "XX~avatar", type: :image, value: "http://www.gravatar.com/avatar/98363013aa1237798130bc0fd2c4159d.png"}
+]
+
+class PublisherTest < Test::Unit::TestCase
+  def test_public_authentication
+    pom = Pomade::Publisher.new
+    assert pom.test_authentication
+  end
+
+  def test_asset_validation
+    pom = Pomade::Publisher.new
+
+    assert_nothing_raised do
+      pom.validate($valid_assets)
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pomade
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-27 00:00:00.000000000 Z
+date: 2012-09-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-ntlm
@@ -51,6 +51,8 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .travis.yml
+- .yardopts
 - Gemfile
 - LICENSE.txt
 - Rakefile
@@ -60,6 +62,8 @@ files:
 - lib/pomade/version.rb
 - pomade.gemspec
 - readme.md
+- test/test_helper.rb
+- test/test_publisher.rb
 homepage: http://github.com/jakebellacera/pomade
 licenses: []
 post_install_message: 
@@ -72,17 +76,24 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: 1927956313076339663
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: 1927956313076339663
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Ruby wrapper for TimesSquare2's Pomegranate API
-test_files: []
-has_rdoc: 
+test_files:
+- test/test_helper.rb
+- test/test_publisher.rb