tweets 0.0.1.pre2

data/README.rdoc

@@ -0,0 +1,36 @@
+=begin
+= 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>.
+=end

data/lib/tweets/version.rb

@@ -0,0 +1,13 @@
+module Tweets
+  module Version
+    MAJOR = 0
+    MINOR = 0
+    PATCH = 1
+    BUILD = "pre2"
+    STRING = [MAJOR, MINOR, PATCH, BUILD].join('.')
+  end
+
+  def self.version
+    return Version::STRING
+  end
+end

data/lib/tweets.rb

@@ -0,0 +1,50 @@
+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/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

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: tweets
+version: !ruby/object:Gem::Version
+  version: 0.0.1.pre2
+  prerelease: 6
+platform: ruby
+authors:
+- James Turner
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-10-13 00:00:00.000000000Z
+dependencies: []
+description: Tweet finder for strings
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/tweets/version.rb
+- lib/tweets.rb
+- spec/tweets_spec.rb
+- README.rdoc
+homepage: http://github.com/james-turner/tweets
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>'
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: tweets
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Tweet finder for strings
+test_files: []