meme 0.1.2 → 0.2.0

data/README.rdoc

@@ -24,6 +24,24 @@ Meme uses {YQL}[http://developer.yahoo.com/yql/] to get API of {Yahoo! Meme}[htt
   user.avatar_url
   => "http://d.yimg.com/gg/jtadeulopes/avatars/44251e70378d4d225f8cda09a6c3aec87301833a.jpeg"
 
+=== Followers and Following
+
+  followers = user.followers
+  followers.count
+  => 10
+  
+  follower = followers.first
+
+  follower.name
+  => "zigotto"
+
+  follower.url
+  => "http://meme.yahoo.com/zigotto/"
+
+  following = user.following
+  following.count
+  => 10
+
 === Find posts
 
   posts = Meme::Post.find('brhackday')
@@ -31,8 +49,8 @@ Meme uses {YQL}[http://developer.yahoo.com/yql/] to get API of {Yahoo! Meme}[htt
   posts.first.category
   => "text"
 
-  post.first.content
-  => "RT @codepo8: And I am off - plane leaves BR for London. Thanks to everybody I met at #brhackday. I have not a single bad memory to speak of."
+  posts.first.content
+  => "RT @codepo8: And I am off - plane leaves BR for London. Thanks to everybody I met at #brhackday...
 
 Find by type:
 
@@ -43,6 +61,10 @@ Find by type:
 
 For more information, please refer the {project wiki}[http://wiki.github.com/jtadeulopes/meme/]
 
+== Installation
+
+  sudo gem install meme
+
 == TODO
 
 Much remains to be done! Please refer the {project wiki}[http://wiki.github.com/jtadeulopes/meme/]

data/VERSION

@@ -1 +1 @@
-0.1.2
+0.2.0

data/lib/meme.rb

@@ -1,63 +1,6 @@
 require 'open-uri'
 require 'json'
 
-class Meme
-
-  class Info
-
-    VARS = ["avatar_url", "name", "title", "guid", "followers", "language", "url", "description"]
-
-    attr_accessor *VARS
-
-    def initialize(data)
-      unless data.nil?
-        VARS.each do |var|
-          self.instance_variable_set("@#{var}", data[var])
-        end
-      end
-    end
-
-    def self.find(name)
-      url    = URI.escape("https://query.yahooapis.com/v1/public/yql?q=SELECT * FROM meme.info WHERE name='#{name}'&format=json")
-      buffer = open(url).read
-      parse  = JSON.parse(buffer)
-      if parse
-        results = parse['query']['results']
-        results.nil? ? nil : Info.new(results['meme'])
-      else
-        parse.error!
-      end
-    end
-
-  end
-
-  class Post
-
-    VARS = ["category", "timestamp", "guid", "pubid", "url", "repost_count", "caption", "type", "content"]
-
-    attr_accessor *VARS
-
-    def initialize(data)
-      unless data.nil?
-        VARS.each do |var|
-          self.instance_variable_set("@#{var}", data[var])
-        end
-      end      
-    end
-
-    def self.find(query, options = {})
-      type = " and type='#{options.delete(:type).to_s}'" if options.has_key?(:type)
-      url = URI.escape("https://query.yahooapis.com/v1/public/yql?q=SELECT * FROM meme.search WHERE query='#{query}'#{type}&format=json")
-      buffer = open(url).read
-      parse = JSON.parse(buffer)
-      if parse
-        results = parse['query']['results']
-        results.nil? ? nil : results['post'].map {|m| Post.new(m)}
-      else
-        parse.error!
-      end
-    end
-
-  end
-
-end
+require 'meme/info'
+require 'meme/search'
+require 'meme/request'

data/lib/meme/info.rb

@@ -0,0 +1,111 @@
+module Meme
+
+  class Info
+
+    VARS = ["avatar_url", "name", "title", "guid", "language", "url", "description"] #:nodoc:
+
+    attr_accessor *VARS
+
+    def initialize(data) #:nodoc:
+      unless data.nil?
+        VARS.each do |var|
+          self.instance_variable_set("@#{var}", data[var])
+        end
+      end
+    end
+
+    # Find user
+    #
+    #   Example:
+    #
+    #   # by name
+    #   user = Meme::Info.find('jtadeulopes')
+    #   user.name
+    #   => "jtadeulopes"
+    #
+    def self.find(name)
+      query = "SELECT * FROM meme.info WHERE name='#{name}'"
+      parse = Request.parse(query)
+      if parse
+        results = parse['query']['results']
+        results.nil? ? nil : Info.new(results['meme'])
+      else
+        parse.error!
+      end
+    end
+
+    # Return user followers
+    #
+    #   Example:
+    #
+    #   # Search user
+    #   user = Meme::Info.find('jtadeulopes')
+    #
+    #   # Default
+    #   followers = user.followers
+    #   followers.count
+    #   => 10
+    #
+    #   # Specify a count
+    #   followers = user.followers(100)
+    #   followers.count
+    #   => 100
+    #
+    #   # All followers
+    #   followers = user.followers(:all)
+    #   followers.count
+    #
+    #   follower = followers.first
+    #   follower.name
+    #   => "zigotto"
+    #   follower.url
+    #   => "http://meme.yahoo.com/zigotto/"
+    #
+    def followers(count=10)
+      count = 0 if count.is_a?(Symbol) && count == :all
+      query = "SELECT * FROM meme.followers(#{count}) WHERE owner_guid='#{self.guid}'"
+      parse = Request.parse(query)
+      if parse
+        results = parse['query']['results']
+        results.nil? ? nil : results['meme'].map {|m| Info.new(m)}
+      else
+        parse.error!
+      end
+    end
+
+    # Return user following
+    #
+    #   Example:
+    #
+    #   # Search user
+    #   user = Meme::Info.find('jtadeulopes')
+    #
+    #   # Default
+    #   following = user.following
+    #   following.count
+    #   => 10
+    #
+    #   # Specify a count
+    #   following = user.following(100)
+    #   following.count
+    #   => 100
+    #
+    #   # All following
+    #   following = user.following(:all)
+    #   following.count
+    #
+    def following(count=10)
+      count = 0 if count.is_a?(Symbol) && count == :all
+      query = "SELECT * FROM meme.following(#{count}) WHERE owner_guid='#{self.guid}'"
+      parse = Request.parse(query)
+      if parse
+        results = parse['query']['results']
+        results.nil? ? nil : results['meme'].map {|m| Info.new(m)}
+      else
+        parse.error!
+      end
+    end
+
+  end
+
+end

data/lib/meme/request.rb

@@ -0,0 +1,13 @@
+module Meme
+
+  class Request #:nodoc:
+
+    def self.parse(query)
+      url    = URI.escape("https://query.yahooapis.com/v1/public/yql?q=#{query}&format=json")
+      buffer = open(url).read
+      JSON.parse(buffer)
+    end
+
+  end
+
+end

data/lib/meme/search.rb

@@ -0,0 +1,47 @@
+module Meme
+
+  class Post
+
+    VARS = ["category", "timestamp", "guid", "pubid", "url", "repost_count", "caption", "type", "content"] #:nodoc:
+
+    attr_accessor *VARS
+
+    def initialize(data) #:nodoc:
+      unless data.nil?
+        VARS.each do |var|
+          self.instance_variable_set("@#{var}", data[var])
+        end
+      end      
+    end
+
+    # Find posts
+    #
+    #   Example:
+    #
+    #   # type text
+    #   posts = Meme::Post.find('brhackday')
+    #
+    #   # type photo
+    #   posts = Meme::Post.find('brhackday', :type => :photo)
+    #
+    #   # type video
+    #   posts = Meme::Post.find('brhackday', :type => :video)
+    #
+    #   posts.first.content
+    #   => "RT @codepo8: And I am off - plane leaves BR for London. Thanks to everybody...
+    #
+    def self.find(query, options = {})
+      type  = " and type='#{options.delete(:type).to_s}'" if options.has_key?(:type)
+      query = "SELECT * FROM meme.search WHERE query='#{query}'#{type}"
+      parse = Request.parse(query)
+      if parse
+        results = parse['query']['results']
+        results.nil? ? nil : results['post'].map {|m| Post.new(m)}
+      else
+        parse.error!
+      end
+    end
+
+  end
+
+end

data/meme.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{meme}
-  s.version = "0.1.2"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["J\303\251sus Lopes"]
-  s.date = %q{2010-03-23}
+  s.date = %q{2010-04-01}
   s.description = %q{Yahoo! Meme API wrapper library in Ruby}
   s.email = %q{jlopes@zigotto.com.br}
   s.extra_rdoc_files = [
@@ -24,14 +24,25 @@ Gem::Specification.new do |s|
      "Rakefile",
      "VERSION",
      "lib/meme.rb",
+     "lib/meme/info.rb",
+     "lib/meme/request.rb",
+     "lib/meme/search.rb",
      "meme.gemspec",
+     "spec/fixtures/meme_followers.json",
+     "spec/fixtures/meme_followers_all.json",
+     "spec/fixtures/meme_followers_count.json",
+     "spec/fixtures/meme_following.json",
+     "spec/fixtures/meme_following_all.json",
+     "spec/fixtures/meme_following_count.json",
      "spec/fixtures/meme_info.json",
      "spec/fixtures/meme_info_not_found.json",
      "spec/fixtures/meme_search.json",
      "spec/fixtures/meme_search_type_audio.json",
      "spec/fixtures/meme_search_type_photo.json",
      "spec/fixtures/meme_search_type_video.json",
+     "spec/info_spec.rb",
      "spec/meme_spec.rb",
+     "spec/search_spec.rb",
      "spec/spec.opts",
      "spec/spec_helper.rb"
   ]
@@ -42,7 +53,9 @@ Gem::Specification.new do |s|
   s.summary = %q{Ruby Yahoo! Meme API}
   s.test_files = [
     "spec/meme_spec.rb",
-     "spec/spec_helper.rb"
+     "spec/search_spec.rb",
+     "spec/spec_helper.rb",
+     "spec/info_spec.rb"
   ]
 
   if s.respond_to? :specification_version then

data/spec/fixtures/meme_followers.json

@@ -0,0 +1,112 @@
+{
+  "query":{
+    "count":"10",
+      "created":"2010-04-01T10:31:02Z",
+      "lang":"en-US",
+      "updated":"2010-04-01T10:31:02Z",
+      "uri":"https://query.yahooapis.com/v1/yql?q=SELECT+*+FROM+meme.followers+WHERE+owner_guid%3D%27EMREXCV4R5OTM3CZW3HBD5QAGY%27",
+      "results":{
+        "meme":[{
+          "guid":"J7B4OWIQWFXHJDYZWAARA2RYZE",
+          "name":"zigotto",
+          "title":"Zigotto",
+          "description":"Criação e Desenvolvimento para todo Vale do Paraíba e Brasil",
+          "url":"http://meme.yahoo.com/zigotto/",
+          "avatar_url":"http://d.yimg.com/gg/zigotto/avatars/c0fbd3fe6c109cebaf0c0c871e45e338b7c04ed8.png",
+          "language":"pt",
+          "followers":"1"
+        },
+        {
+          "guid":"2FPYHHRLJK5XMBSSXNL5NQGGB4",
+          "name":"fabilouco8000",
+          "title":"Fabilouco8000",
+          "description":"Diversão é comigo mesmo!",
+          "url":"http://meme.yahoo.com/fabilouco8000/",
+          "avatar_url":"http://d.yimg.com/gg/fabilouco8000/avatars/73d91d124dbf68ad706798de4ed0a3f4661446f3.jpeg",
+          "language":"pt",
+          "followers":"510"
+        },
+        {
+          "guid":"6M46NNM2LO5YQ7XNYCU5MVITKE",
+          "name":"acsouza09",
+          "title":"acsouza09",
+          "description":"Sou uma pessoa feliz, extremamente vaidoosa!",
+          "url":"http://meme.yahoo.com/acsouza09/",
+          "avatar_url":"http://d.yimg.com/gg/acsouza09/avatars/013fb916b1362f68acbbea5ec643012380d942e6.jpeg",
+          "language":"pt",
+          "followers":"3"
+        },
+        {
+          "guid":"CETYPLO3WBYWGEBEUXMC2FO4EU",
+          "name":"marcetolosa",
+          "title":"Marcetolosa",
+          "description":"BA - Yahoo!",
+          "url":"http://meme.yahoo.com/marcetolosa/",
+          "avatar_url":"http://d.yimg.com/gg/marcetolosa/avatars/59a1e60f21b9c5d478ec1816dd827bdde64b8f52.jpeg",
+          "language":"es",
+          "followers":"1183"
+        },
+        {
+          "guid":"NEUNUDTFXKL4Q3IQK2JEH4NMDI",
+          "name":"edercosta",
+          "title":"edercosta",
+          "description":"desenvolvedor web, só!",
+          "url":"http://meme.yahoo.com/edercosta/",
+          "avatar_url":"http://d.yimg.com/gg/edercosta/avatars/7e7b464e2af1e413ca421101d57b3c5684325076.jpeg",
+          "language":"pt",
+          "followers":"6"
+        },
+        {
+          "guid":"GNQZXVPVCUUVFODPRUGPYSK5LA",
+          "name":"marcelofraga",
+          "title":"Marcelo Fraga",
+          "description":"Web Developer",
+          "url":"http://meme.yahoo.com/marcelofraga/",
+          "avatar_url":"http://d.yimg.com/gg/marcelofraga/avatars/8dc4fde72c2f718386a44f52c5384ed83f7eea67.jpeg",
+          "language":"pt",
+          "followers":"5"
+        },
+        {
+          "guid":"SNTS64IYOYICF2TMB2QN2EGG2Y",
+          "name":"berg_te_amo",
+          "title":"°•๋ °Loறa°•๋ °",
+          "description":"°•๋ °navegando no றar dos றeus sonhos°•๋ °",
+          "url":"http://meme.yahoo.com/berg_te_amo/",
+          "avatar_url":"http://d.yimg.com/gg/berg_te_amo/avatars/24872b74162ea7ca3a0db798e25dccd7250aac33.jpeg",
+          "language":"pt",
+          "followers":"403"
+        },
+        {
+          "guid":"M7OYDALP7ODIEAH6W2ZUQTVIB4",
+          "name":"matiaz",
+          "title":"Matiaz",
+          "description":"Yahoo! Argentina",
+          "url":"http://meme.yahoo.com/matiaz/",
+          "avatar_url":"http://d.yimg.com/gg/matiaz/avatars/711923e770e1c66f86e8ceb2743dd09e0d6a35cf.jpeg",
+          "language":"en",
+          "followers":"1492"
+        },
+        {
+          "guid":"QLET3EJ5XXYIVAHBOQVSPZB6BM",
+          "name":"mariano",
+          "title":"mariano",
+          "description":"Coisas engraçadas e informática!! O.o",
+          "url":"http://meme.yahoo.com/mariano/",
+          "avatar_url":"http://d.yimg.com/gg/mariano/avatars/13311faeddf76382df7806b8ad188e8b455cd2ca.jpeg",
+          "language":"pt",
+          "followers":"287"
+        },
+        {
+          "guid":"LKMTQUYO4NA3HWE2MHPCC2UVOU",
+          "name":"willweb",
+          "title":"willweb",
+          "description":"Imerso no mundo digital, para descobrir intenções e realidades físicas!",
+          "url":"http://meme.yahoo.com/willweb/",
+          "avatar_url":"http://d.yimg.com/gg/willweb/avatars/480c433a64d2b433e618cd6acb7436dafffe5299.jpeg",
+          "language":"pt",
+          "followers":"12283"
+        }
+        ]
+      }
+  }
+}