claire_client 0.0.2

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Matheus E. Muller
+
+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/README.rdoc

@@ -0,0 +1,17 @@
+= claire.client
+
+Description goes here.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Matheus E. Muller. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,47 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "claire_client"
+    gem.summary = "A ruby client for St. Claire."
+    gem.description = "This gem is a Ruby client for the St. Claire Media Server, which power power Canção Nova's reach of video and streamming web services."
+    gem.email = "hello@memuller.com"
+    gem.homepage = "http://github.com/memuller/claire.client"
+    gem.authors = ["Matheus E. Muller"]
+		gem.add_dependency "activesupport", ">= 2.3.5"
+		gem.add_dependency "hashie", ">= 0.2.0"
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "claire.client #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.2

data/claire_client.gemspec

@@ -0,0 +1,77 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{claire_client}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Matheus E. Muller"]
+  s.date = %q{2010-04-28}
+  s.description = %q{This gem is a Ruby client for the St. Claire Media Server, which power power Canção Nova's reach of video and streamming web services.}
+  s.email = %q{hello@memuller.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "claire_client.gemspec",
+     "lib/claire_client.rb",
+     "lib/claire_client/category.rb",
+     "lib/claire_client/item.rb",
+     "lib/claire_client/list.rb",
+     "lib/claire_client/listable.rb",
+     "lib/claire_client/stream.rb",
+     "lib/claire_client/video.rb",
+     "spec/claire_client/item_spec.rb",
+     "spec/claire_client/list_spec.rb",
+     "spec/claire_client/listable_spec.rb",
+     "spec/claire_client_spec.rb",
+     "spec/fixtures/item.xml",
+     "spec/fixtures/item_direct.xml",
+     "spec/fixtures/item_with_channel.xml",
+     "spec/fixtures/list.xml",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/memuller/claire.client}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{A ruby client for St. Claire.}
+  s.test_files = [
+    "spec/claire_client/item_spec.rb",
+     "spec/claire_client/list_spec.rb",
+     "spec/claire_client/listable_spec.rb",
+     "spec/claire_client_spec.rb",
+     "spec/spec_helper.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
+      s.add_runtime_dependency(%q<activesupport>, [">= 2.3.5"])
+      s.add_runtime_dependency(%q<hashie>, [">= 0.2.0"])
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 2.3.5"])
+      s.add_dependency(%q<hashie>, [">= 0.2.0"])
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 2.3.5"])
+    s.add_dependency(%q<hashie>, [">= 0.2.0"])
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+  end
+end
+

data/lib/claire_client/category.rb

@@ -0,0 +1,10 @@
+module Claire
+	module Client
+		class Category
+			include Claire::Client::Item
+			include Claire::Client::Listable
+	 
+	 	end
+		
+	end
+end

data/lib/claire_client/item.rb

@@ -0,0 +1,92 @@
+module Claire
+  module Client
+    module Item						
+			
+			attr_writer :partial
+			
+    	def initialize arg
+    		if arg.is_a? String
+    			file = Claire::Client.get("#{self.class.base_url}/#{arg}")
+					if Claire::Client.format == 'xml'
+						hash = Hashie::Mash.new(Hashie::Mash.from_xml(file))
+					else
+						hash = Hashie::Mash.new(JSON.parse(file))
+					end
+					@partial = false
+			 	else 
+					hash = Hashie::Mash.new(arg) and @partial = true
+				end
+				
+				# fetches items from rss, channel, or directly?
+				if hash.rss
+					hash = hash.rss
+					hash = 	if hash.channel
+										then	hash.channel
+										else  hash.item
+									end
+				end
+										
+				hash.each do |k,v|
+					
+					# skips paging and sub-items.
+					next if %w(item next previous).include? k
+					
+					# sets an element's label										         										
+					v = v.label if v.respond_to?('merge') and not v.label.nil?
+					
+					# properly fetches the items's link, in case there are more than one link
+					v = v.first if k == 'link' and v.respond_to? 'push'
+					
+					class_eval "def #{k}; @#{k}; end" 
+					instance_variable_set "@#{k}", v
+				end
+				
+				# a link is always required. 
+				raise Claire::Error, "a link is always required" if @link.nil? or @link.empty?
+								
+    	end
+      
+			# comparison operator. Sorts by title.
+			def <=> arg
+				criteria = :title 
+				return 1 if self.send(criteria) > arg.send(criteria)
+				return 0 if self.send(criteria) == arg.send(criteria)
+				return -1 if self.send(criteria) < arg.send(criteria) 				
+			end
+			
+			# checks an item's partial status
+      def partial?
+      	@partial
+      end
+
+			module ClassMethods
+				
+				# Returns this class base URI on the server,
+				# or guesses it from this class name.
+				def base_url
+					if defined? @@base_url
+						return @@base_url unless @@base_url.nil?
+					end															
+					self.to_s.downcase.pluralize.split('::').last					
+				end
+			  
+				# Manually set this class base URI on the server. 
+				def base_url= arg
+					@@base_url = arg
+				end
+			end			
+			
+			# Extends the class methods above.
+			def Item.included base
+				base.extend ClassMethods
+				(@@children ||= []) << base
+			end
+			
+			# Lists all avaliable Claire::Items			
+			def self.children
+				@@children ||= []
+			end
+						
+    end
+  end
+end

data/lib/claire_client/list.rb

@@ -0,0 +1,53 @@
+module Claire
+  module Client
+    class List
+			include Enumerable
+			
+			attr_reader :body, :document
+						
+			# gets, parses, and builds objects.
+			def initialize(arg)
+				#puts Claire::Client.respond_to? :get				
+				@body = Claire::Client.get(arg)
+				@document = Hashie::Mash.new(Hashie::Mash.from_xml(@body))
+				@document = @document.rss if @document.rss
+				@document = @document.channel if @document.channel				
+				if @document.item.nil?
+					@items = []
+				else
+					@items = @document.item
+				end
+				build_items											
+			end						
+			
+			# Implements an iterator that either
+			# - returns an Array of items if no block is given
+			# - yields the given block once for each item
+			def each &block
+				return @objects unless block
+				@objects.each do |obj|
+					yield(obj)
+				end
+			end
+			
+			private
+			
+			# Builds an array of Claire media objects.
+			# guesses their classes based on their restfull URI.		
+			def build_items
+				@items.each do |item| 					
+					link = if item.link.is_a? String
+						then item.link
+						else item.link.first
+					end
+					klass = ("Claire::Client::" + link.split('/')[-2].classify).constantize
+					obj = klass.new(item)
+					(@objects||=[]) << obj 																		
+					
+				end				
+				
+			end
+
+    end
+  end
+end

data/lib/claire_client/listable.rb

@@ -0,0 +1,37 @@
+module Claire
+	module Client
+		module Listable
+					 						
+			module ClassMethods
+				
+				# Returns a Claire::List on its base_url.
+				# if passed a block, gets the list, them applies a local 
+				# filter to the received items, returning an Array.				
+				def all &block					
+					list = List.new(self.base_url)
+					return list unless block
+					items = []					
+					list.each do |item|
+						items << item if yield(item)						
+					end
+					items		
+										
+				end
+				
+			end
+			
+			# Extends the class methods above.
+			def Listable.included base
+				raise Error, "only Claire::Client::Item s can be Listable" unless Item.children.include? base
+				base.extend ClassMethods
+				(@@children ||= []) << base
+			end
+			
+			# Lists all avaliable Claire::Items			
+			def self.children
+				@@children ||= []
+			end
+			
+		end
+	end
+end

data/lib/claire_client/stream.rb

@@ -0,0 +1,10 @@
+module Claire
+	module Client
+		class Stream
+			include Claire::Client::Item
+			include Claire::Client::Listable
+	 
+	 	end
+		
+	end
+end

data/lib/claire_client/video.rb

@@ -0,0 +1,10 @@
+module Claire
+	module Client
+		class Video
+			include Claire::Client::Item
+			include Claire::Client::Listable
+	 
+	 	end
+		
+	end
+end

data/lib/claire_client.rb

@@ -0,0 +1,85 @@
+#loads global dependencies
+#%w(rubygems mongo mongo_mapper memcache yaml activesupport json).each{|lib| require lib}
+
+#loads every ruby file inside those folders
+full_dir = File.expand_path(File.join(File.dirname(__FILE__), 'claire_client'))
+%w(item list listable category video stream).each do |lib|
+	load "#{full_dir}/#{lib}.rb"
+end
+
+	# 
+	#   Dir.new(full_dir).entries.each do |file|
+	#       load [full_dir, file]*'/' if file.include? '.rb'
+	#   end
+
+#main module here.
+module Claire
+	module Client
+		%w(rubygems open-uri active_support hashie).each { |lib| require lib }
+		@@hostname = "localhost:3000"
+		@@api_key = "33c80d2e38e6b1753982500721f76eccaee0d111"
+		@@format = 'xml'
+		
+		%w(api_key hostname format).each do |var|
+			class_eval <<-METHOD
+				def self.#{var}
+					@@#{var}
+				end
+				
+				def self.#{var}= arg
+					@@#{var} = arg
+				end
+			METHOD
+		end
+		
+		# receives all parameters necessary for request-making.
+		def self.config args={}
+			args.each do |k,v|
+				class_variable_set "@@#{k}", v
+			end			
+		end
+		
+		# assembles an URL from an string of params.
+		def self.assemble_url url="", params={}
+			url = "http://#{@@hostname}/#{url}"			
+			url += ".#{@@format.downcase}" if @@format			
+			uri = URI.parse url			
+			(uri.query ||= "") << "api_key=#{@@api_key}"
+			params.each do |k,v|
+				uri.query << "&#{k}=#{v}"
+			end
+			uri
+			
+		end
+		
+		# gets an URL. Assembles it first.
+		def self.get url=''
+			url = assemble_url(url)
+			request = open(url)
+			return request.read if request.status.first.to_i == 200
+			nil
+		rescue Exception => e
+			
+			
+			raise 		
+		end
+		
+		
+	end
+	
+	
+	#here goes the errors.
+	class Error < StandardError; end
+	class ClientError < Error; end
+	class AuthError < Error; end
+	class NotFound < Error; end
+	class TimeoutError < Error; end
+
+	module Client
+		class Video
+  		include Claire::Client::Item
+		end
+	end
+	
+end
+

data/spec/claire_client/item_spec.rb

@@ -0,0 +1,128 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+class Video
+	include Claire::Client::Item
+end
+
+describe Claire::Client::Item do
+	#@session.should_receive(:post).with("url", "data", "headers")
+	#@session = mock("session")
+	before do 
+		Claire::Client.stub(:get).with('videos/id').and_return xml :item
+		@video = Video.new(hash_from_xml(:item))
+	end
+	
+	describe "its initializer" do
+		
+		describe "its base_url class attribute" do
+			it "should default to the class name, pluralized" do
+				Video.base_url.should == "videos"			
+			end
+			
+			it "should accept manual overwrite on the class" do
+				Video.base_url = "lists"
+				Video.base_url.should == "lists"
+				Video.base_url = nil
+				Video.base_url.should == "videos"
+			end
+			
+			it "if the class is in a module, it should get the class name only" do
+				eval %(
+					module Testing
+						class Video
+							include Claire::Client::Item
+						end
+					end
+				)
+				Testing::Video.base_url.should == "videos"
+			end
+		end
+		
+		context "upon receiving a Hash" do
+			before :each do				
+				@video = Video.new(hash_from_xml(:item))
+			end
+			
+			it "should set partial do true" do
+				@video.should be_partial
+			end
+			
+			it "should skip the <rss> container if it is present" do
+				@video.title.should be_a_kind_of String
+				@video.should_not respond_to :rss
+			end
+			
+			it "should skip the <channel> container if its present" do
+				video = Video.new(hash_from_xml(:item_with_channel))
+				video.title.should be_a_kind_of String
+				video.should_not respond_to :channel
+			end
+			
+			it "should never set 'items' attributes " do
+				%w(item item_with_channel).each do |type|
+					video = Video.new(hash_from_xml(type))
+					video.should_not respond_to :item
+					video.title.should be_a_kind_of String
+					
+				end
+			end
+			
+			it "should set the link attribute properly (eg ignoring links to other objects/pages)" do
+				video = Video.new hash_from_xml :item_with_channel
+				video.link.should be_a_kind_of String								
+			end											
+				
+			it "should set its key/values as properties of the element" do
+				%w(title link category keywords description).each do |item|
+					@video.send(item).should be_a_kind_of String
+				end
+				%w(thumbnail content).each{ |item|  @video.send(item).should be_a_kind_of Array }
+			end
+			it "should fail if there is not a link attribute" do
+				lambda { Video.new( {:rss => {:item => {:name => 'bla'}}} ) }.should raise_error Claire::Error
+			end
+		end
+		
+		context "upon receiving a String" do
+			before { @video = Video.new 'id' }
+			it "should open the given string" do
+				lambda { Video.new "" }.should raise_error
+				lambda { Video.new "id" }.should_not raise_error
+			end
+			it "should parse the result using the XML parsing rules" do
+				@video.title.should be_a_kind_of String 
+			end
+			it "should set partial to false" do
+				@video.should_not be_partial
+			end
+			
+		end		
+				 								
+	end
+	
+	describe "its comparison (spaceship) operator" do		
+		it "should be defined" do
+			@video.should respond_to '<=>'		   
+		end
+		
+		it "should compare items by title" do
+		  @video2 = @video.clone
+			(@video <=> @video2).should be 0
+		end
+		
+	end
+	
+	context "when an undefined method is called" do
+		it "it should raise error if partial is false"
+		context "if the item is partial" do
+			it "should request the full object from server, and replace itself"
+			it "should return the asked attribute"
+		end
+	end	
+	
+	it "should have a list of its children as the children class attribute" do
+		Claire::Client::Item.children.include?(Video).should be true
+	end
+	
+	
+end

data/spec/claire_client/list_spec.rb

@@ -0,0 +1,61 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+
+describe Claire::Client::List do
+
+	before do
+		Claire::Client.stub(:get).with('categories').and_return(xml(:item_with_channel))		
+	  @list = Claire::Client::List.new('categories')
+	end
+	
+	describe "its initializing methods & states" do
+		it "should require a String" do
+			lambda { Claire::Client::List.new }.should raise_error ArgumentError
+			lambda { Claire::Client::List.new('categories') }.should_not raise_error
+		end
+		
+		it "should make the response accessible thru the body property" do
+			@list.body.should be_a_kind_of String
+		end
+		
+		
+		it "should have a parsed document accessible thru the document property" do
+			@list.document.should respond_to '[]'
+		end
+																
+	end
+	
+	describe "its each method" do
+		
+		it "should return an array" do
+			@list.each.should respond_to :first
+		end
+		
+		it "should accept a block, yielding once for each object" do
+			i = 0 and arr = []
+			@list.each do |item|
+				item.should_not be_nil
+				i += 1
+			end
+			i.should == 2
+			arr.each_slice(2){ |a| a.first.should_not == a.last }
+		end
+		
+		it "should contain a list of Claire::Client:Itens-based objects" do			
+			@list.each do |item|												
+				Claire::Client::Item.children.include?(item.class).should be true				
+			end
+		end
+		
+		it "the returned objects should be set as partial" do
+			@list.each { |item| item.should be_partial } 
+		end									
+	end
+	
+	describe "its size method" do
+		it "should return the nun_items field if its avaliable"
+		it "should count the items if otherwise"
+	end
+	
+		  
+end

data/spec/claire_client/listable_spec.rb

@@ -0,0 +1,49 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+class Video
+	include Claire::Client::Item
+	include Claire::Client::Listable	
+end
+
+describe Claire::Client::Listable do
+  before do
+    Claire::Client.stub(:get).with('videos').and_return xml(:item_with_channel)
+		Claire::Client.stub(:get).with('videos/id').and_return xml(:item)
+  end
+
+	describe "initialization" do
+		it "should work only on Claire::Items" do
+		  lambda { eval("
+				class NotAVideo
+					include Claire::Client::Listable
+				end
+			") }.should raise_error Claire::Error
+			lambda { Video.new('id')}.should_not raise_error
+		end				
+	end
+	
+	describe "its all method" do
+		it "should be defined" do
+			Video.should respond_to :all
+		end
+		
+		it "should return a Claire::List on the item's base URL" do
+		  Video.all.should be_a_kind_of Claire::Client::List
+		end
+	end
+	
+	it "delegate a count property to its all method" # do
+	 # 		Video.count.should == 2
+	 # 	end                                             
+	
+	it "should have a list of its children" do
+	  Claire::Client::Listable.children.include?(Video).should be_true
+	end
+	
+	it "should accept a block filter" do
+		Video.all { |video| video.title }.should_not be_empty
+		Video.all { |video| video.title == ''}.should be_empty
+	end
+	
+
+end

data/spec/claire_client_spec.rb

@@ -0,0 +1,115 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+describe Claire::Client do
+	before { Claire::Client.stub(:get).with('categories').and_return(xml(:list)) }
+	
+	it "should have a hostname property" do
+		%w(hostname hostname=).each{ |method| Claire::Client.should respond_to method }		
+	end
+	it "should have an API key" do
+		%w(api_key api_key=).each{ |method| Claire::Client.should respond_to method }
+	end	
+	it "should have a format property" do
+		%w(format format=).each{ |method| Claire::Client.should respond_to method }
+	end
+	
+	context "its config method" do
+		
+		it "should exist"do
+			Claire::Client.should respond_to "config"
+		end
+		
+		it "should accept an hash of init options" do
+			lambda{ Claire::Client.config :api_key => "abc", :hostname => "localhost:3000"}.should_not raise_error
+		end
+		
+		it "received options must be set" do
+			Claire::Client.config :api_key => "abc", :hostname => "localhost:3000"
+			Claire::Client.api_key.should == "abc"
+			Claire::Client.hostname.should == "localhost:3000"			
+		end
+		
+	end
+	
+	it "standard errors should be defined" do
+		%w(Claire::Error Claire::ClientError Claire::AuthError Claire::NotFound Claire::TimeoutError).each do |err|	
+			lambda{ eval("#{err}") }.should_not raise_error 
+		end
+	end
+	
+	describe "its assemble_url method" do
+		
+		it "should exist" do
+			Claire::Client.should respond_to "assemble_url"
+		end		
+		
+		it "should receive a string" do
+			lambda{ Claire::Client.assemble_url("url") }.should_not raise_error
+		end
+		
+		it "should receive an optional parameter hash" do
+		  lambda{ Claire::Client.assemble_url("url",{:param => 'value'}) }.should_not raise_error
+		end
+		
+		it "should return an URI object" do
+			Claire::Client.assemble_url.should be_a_kind_of URI
+		end
+		
+		context "about the resulting URI" do
+			before do 
+				@response = Claire::Client.assemble_url("categories")
+			end
+			
+			it "should have the given hostname" do
+				lambda { Claire::Client.hostname.include?(@response.host) }.call.should be true				  
+			end
+			
+			it "should use the API key" do
+				@response.query.include?("api_key=#{Claire::Client.api_key}").should be true
+			end
+			
+			it "should have the desired format" do
+				lambda { @response.to_s.include?(".#{Claire::Client.format.downcase}") }.call.should be true
+			end
+			
+			it "should have the desired path" do
+				lambda { @response.path.include? "categories" }.call.should be true
+			end
+			
+			it "should have the given query" do
+				@response = Claire::Client.assemble_url("categories?stuff=true")
+				lambda { @response.query.include?("stuff=true") }.call.should be true				
+			end
+			
+			context "if a param hash was given" do
+			  before :each do
+			  	@response = Claire::Client.assemble_url("categories", :page =>  2, :limit => 10)			
+			  end
+			
+				it "assembles the params in the URI" do
+			    %w(limit=10 page=2).each do |i|
+			    	@response.query.include?(i).should be true
+			    end
+			  end
+			end
+		
+		end 
+		
+	end 
+	                   
+	describe "its get method" do
+		it "should exist" do
+			Claire::Client.should respond_to "get"
+		end
+	  
+		it "should receive a String" do
+			lambda { Claire::Client.get "categories" }.should_not raise_error			
+		end
+		
+		it "should receive aditional params as an hash"		
+		
+		it "should make the request and return an body" do
+			lambda { Claire::Client.get "categories" }.call.should_not be_empty
+		end
+		
+	end
+end

data/spec/fixtures/item.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+
+<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss" xmlns:atom="http://www.w3.org/2005/Atom">
+<item>
+  <title>new title</title>
+  <link>http://localhost:3000/videos/4bbced401637fd736a000004</link>
+  <media:content type="video/flv" url="/videos/4bbced401637fd736a000004/flv-h263.flv" duration=""/>
+  <media:content type="video/flv" url="/videos/4bbced401637fd736a000004/flv-h264.flv" duration=""/>
+  <media:thumbnail width="215" url="/videos/4bbced401637fd736a000004/thumb_thumb_medium.jpg" heigth="120"/>
+  <media:thumbnail width="50" url="/videos/4bbced401637fd736a000004/thumb_thumb_square.jpg" heigth="50"/>
+  <media:thumbnail width="500" url="/videos/4bbced401637fd736a000004/thumb_thumb_large.jpg" heigth="281"/>
+  <media:category label="test"/>
+  <media:keywords>many, keywords, here</media:keywords>
+  <media:description>asa</media:description>
+  <media:community>
+    <media:starRating average="0.0"/>
+    <media:statistics views="0"/>
+  </media:community>
+  <related>
+    <item title="new title" link="http://localhost:3000/videos/4bbced401637fd736a000004" thumbnail="/videos/4bbced401637fd736a000004/thumb_thumb_square.jpg"/>
+  </related>
+</item>
+</rss>

data/spec/fixtures/item_direct.xml

@@ -0,0 +1,19 @@
+<item>
+  <title>new title</title>
+  <link>http://localhost:3000/videos/4bbced401637fd736a000004</link>
+  <media:content type="video/flv" url="/videos/4bbced401637fd736a000004/flv-h263.flv" duration=""/>
+  <media:content type="video/flv" url="/videos/4bbced401637fd736a000004/flv-h264.flv" duration=""/>
+  <media:thumbnail width="215" url="/videos/4bbced401637fd736a000004/thumb_thumb_medium.jpg" heigth="120"/>
+  <media:thumbnail width="50" url="/videos/4bbced401637fd736a000004/thumb_thumb_square.jpg" heigth="50"/>
+  <media:thumbnail width="500" url="/videos/4bbced401637fd736a000004/thumb_thumb_large.jpg" heigth="281"/>
+  <media:category label="test"/>
+  <media:keywords></media:keywords>
+  <media:description>asa</media:description>
+  <media:community>
+    <media:starRating average="0.0"/>
+    <media:statistics views="0"/>
+  </media:community>
+  <related>
+    <item title="new title" link="http://localhost:3000/videos/4bbced401637fd736a000004" thumbnail="/videos/4bbced401637fd736a000004/thumb_thumb_square.jpg"/>
+  </related>
+</item>

data/spec/fixtures/item_with_channel.xml

@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+
+<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss" xmlns:atom="http://www.w3.org/2005/Atom">
+
+<channel>
+  <title>test</title>
+  <description></description>
+  <header>/public/categories/4bb48ef61637fd69c1000005/original.jpg</header>
+  <num_items>1</num_items>
+  <link>http://localhost:3000/categories/4bb48ef61637fd69c1000005</link>
+  <item>
+    <title>new title</title>
+    <link>http://localhost:3000/videos/4bbced401637fd736a000004</link>
+    <media:content type="video/flv" duration="" url="/videos/4bbced401637fd736a000004/flv-h263.flv"/>
+    <media:content type="video/flv" duration="" url="/videos/4bbced401637fd736a000004/flv-h264.flv"/>
+    <media:thumbnail heigth="50" width="50" url="/videos/4bbced401637fd736a000004/thumb_thumb_square.jpg"/>
+    <media:thumbnail heigth="120" width="215" url="/videos/4bbced401637fd736a000004/thumb_thumb_medium.jpg"/>
+    <media:thumbnail heigth="281" width="500" url="/videos/4bbced401637fd736a000004/thumb_thumb_large.jpg"/>
+    <media:category label="testting"/>
+    <media:keywords></media:keywords>
+    <media:description>asa</media:description>
+    <media:community>
+      <media:starRating average="0.0"/>
+      <media:statistics views="0"/>
+    </media:community>
+    <related>
+      <item thumbnail="/videos/4bbced401637fd736a000004/thumb_thumb_square.jpg" title="new title" link="http://localhost:3000/videos/4bbced401637fd736a000004"/>
+    </related>
+  </item>
+  <item>
+    <title>new title 2</title>
+    <link>http://localhost:3000/videos/4bbced401637fd736a000004</link>
+    <media:content type="video/flv" duration="" url="/videos/4bbced401637fd736a000004/flv-h263.flv"/>
+    <media:content type="video/flv" duration="" url="/videos/4bbced401637fd736a000004/flv-h264.flv"/>
+    <media:thumbnail heigth="50" width="50" url="/videos/4bbced401637fd736a000004/thumb_thumb_square.jpg"/>
+    <media:thumbnail heigth="120" width="215" url="/videos/4bbced401637fd736a000004/thumb_thumb_medium.jpg"/>
+    <media:thumbnail heigth="281" width="500" url="/videos/4bbced401637fd736a000004/thumb_thumb_large.jpg"/>
+    <media:category label="testting"/>
+    <media:keywords></media:keywords>
+    <media:description>asa</media:description>
+    <media:community>
+      <media:starRating average="0.0"/>
+      <media:statistics views="0"/>
+    </media:community>
+    <related>
+      <item thumbnail="/videos/4bbced401637fd736a000004/thumb_thumb_square.jpg" title="new title" link="http://localhost:3000/videos/4bbced401637fd736a000004"/>
+    </related>
+  </item>
+  <atom:link rel="next" href="http://localhost:3000/categories/4bb48ef61637fd69c1000005.xml?page=2"/>
+</channel>
+
+
+</rss>

data/spec/fixtures/list.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+
+<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss" xmlns:atom="http://www.w3.org/2005/Atom">
+
+<item>
+  <title>test</title>
+  <link>http://localhost:3000/categories/4bb48ef61637fd69c1000005</link>
+  <num_videos>1</num_videos>
+</item>
+<item>
+  <title>none</title>
+  <link>http://localhost:3000/categories/4bb881681637fd0513000001</link>
+  <description>some</description>
+  <num_videos>0</num_videos>
+</item>
+<item>
+  <title>name</title>
+  <link>http://localhost:3000/categories/4bb882251637fd0513000002</link>
+  <description>namae</description>
+  <num_videos>0</num_videos>
+</item>
+
+
+</rss>

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'claire_client'
+require 'spec'
+require 'spec/autorun'
+
+$root = File.join(File.dirname(__FILE__), '..')
+
+Spec::Runner.configure do |config|
+  
+end
+
+def xml arg
+	 File.open("#{$root}/spec/fixtures/#{arg}.xml", 'r').read
+end
+
+def hash_from_xml arg
+	Hashie::Mash.from_xml(xml(arg))
+end            

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification 
+name: claire_client
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Matheus E. Muller
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-28 00:00:00 -03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 3
+        - 5
+        version: 2.3.5
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: hashie
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 2
+        - 0
+        version: 0.2.0
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id003
+description: "This gem is a Ruby client for the St. Claire Media Server, which power power Can\xC3\xA7\xC3\xA3o Nova's reach of video and streamming web services."
+email: hello@memuller.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- claire_client.gemspec
+- lib/claire_client.rb
+- lib/claire_client/category.rb
+- lib/claire_client/item.rb
+- lib/claire_client/list.rb
+- lib/claire_client/listable.rb
+- lib/claire_client/stream.rb
+- lib/claire_client/video.rb
+- spec/claire_client/item_spec.rb
+- spec/claire_client/list_spec.rb
+- spec/claire_client/listable_spec.rb
+- spec/claire_client_spec.rb
+- spec/fixtures/item.xml
+- spec/fixtures/item_direct.xml
+- spec/fixtures/item_with_channel.xml
+- spec/fixtures/list.xml
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/memuller/claire.client
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: A ruby client for St. Claire.
+test_files: 
+- spec/claire_client/item_spec.rb
+- spec/claire_client/list_spec.rb
+- spec/claire_client/listable_spec.rb
+- spec/claire_client_spec.rb
+- spec/spec_helper.rb