tweets 0.0.1 → 0.0.2

data/README.rdoc

@@ -0,0 +1,34 @@
+= Tweets
+
+Tweets provides lists of twitter updates based on the supplied string.
+
+  Build: http://github.com/james-turner/tweets
+  Gem: https://rubygems.org/gems/tweets
+  Wiki: http://github.com/james-turner/tweets/wiki
+
+== Installation
+
+The latest release is available on rubygems.
+ gem install tweets
+
+== Require
+
+To use tweets:
+ require 'tweets'
+
+== Usage
+
+The tweets method is available on all strings
+and will return you an array of the latest twitter
+status updates
+
+It couldn't be simpler
+ "justin bieber".tweets
+ =>
+ ["justin bieber is the best",
+  "i love justin bieber",
+  "wow, love the latest justin bieber track"
+ ]
+
+= COPYRIGHT
+Copyright 2011 J. Turner <copyright@phpninjas.co.uk>.

data/lib/tweets.rb

@@ -1,5 +1,50 @@
-require 'tweets/extensions'
-require 'tweets/string'
+require 'open-uri'
+require 'json'
 
+module Tweets
+  module Extensions
+    module String
 
+      # Retrieve the latest tweets defined by the string version of yourself.
+      #
+      # Example:
+      #  >> "justin bieber".tweets
+      #  => ["the bieb is amazing!", "moar beeb plox", ...]
+      #
+      #  >> "@user".tweets
+      #  => ["@user you are amazing", ...]
+      #
+      #  >> "#tag"
+      #  => ["#tag is the most cool twitter tag evah ya!", ...]
+      #
+      #
+      # The string can contain the syntax that is allowed in
+      # any of the twitter search
+      # @see https://dev.twitter.com/docs/using-search
+      #
+      # Arguments:
+      #   language: (String)
+      def tweets
+        search = URI.escape(self.to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))
 
+        begin
+          json = JSON.parse open("http://search.twitter.com/search.json?q=#{search}").read.to_s
+          json["results"].map { |result| result["text"] } unless json.has_key? "error" || []
+        rescue SocketError
+          # no socket connection.
+          raise SocketError, "Could not connect to the twitter search api. Check your internet connection."
+        rescue JSON::ParserError
+          # not json?
+          raise JSON::ParserError, "The response received from twitter was not JSON. Check your internet connection."
+        end
+      end
+    end
+  end
+end
+
+# In you go!
+#
+# Includes the tweets string extension
+# inside the String ruby class via mixin
+#
+String.send :include, Tweets::Extensions::String

data/lib/tweets/version.rb

@@ -0,0 +1,13 @@
+module Tweets
+  module Version
+    MAJOR = 0
+    MINOR = 0
+    PATCH = 2
+    BUILD = ""
+    STRING = [MAJOR, MINOR, PATCH, BUILD].select{|version| version.to_s.length > 0}.join('.')
+  end
+
+  def self.version
+    return Version::STRING
+  end
+end

data/spec/tweets_spec.rb

@@ -0,0 +1,20 @@
+$:.unshift "#{File.dirname(__FILE__)}/../lib"
+require 'tweets'
+require 'tweets/version'
+require 'rspec'
+
+describe "tweets" do
+
+  it "should give me a list" do
+
+    "justin bieber".tweets.should be_a_kind_of Array
+
+  end
+
+  it "version should be in a major.minor.patch.build format" do
+
+    Tweets.version.should match /(\d\.){,3}(\w)/
+
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tweets
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,20 +9,19 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-10-11 00:00:00.000000000Z
+date: 2011-10-13 00:00:00.000000000Z
 dependencies: []
 description: Tweet finder for strings
-email: james.turner.phpninja@gmail.com
+email: 
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- README.rdoc
+- lib/tweets/version.rb
 - lib/tweets.rb
 - spec/tweets_spec.rb
-- lib/tweets/extensions.rb
-- lib/tweets/string.rb
-homepage: ''
+- README.rdoc
+homepage: http://github.com/james-turner/tweets
 licenses: []
 post_install_message: 
 rdoc_options: []
@@ -33,7 +32,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.9.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:

data/lib/tweets/extensions.rb

@@ -1,21 +0,0 @@
-require 'open-uri'
-require 'json'
-
-module Tweets
-  module Extensions
-    module String
-
-      # tweets => []
-      #
-      #
-      def tweets
-        tweets = []
-        search = URI.escape(self.to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))
-        json = JSON.parse open("http://search.twitter.com/search.json?q=#{search}").read.to_s
-
-        tweets = json["results"].map { |result| result["text"] } unless json.has_key? "error"
-        tweets
-      end
-    end
-  end
-end

data/lib/tweets/string.rb

@@ -1,9 +0,0 @@
-# tweets => ["one","two","three",...]
-#
-#
-#     Includes the tweets string extension
-#     inside the String ruby class via mixin
-#
-class String
-  include Tweets::Extensions::String
-end