jonathannelson-massauth 0.0.0

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) 2009 Jonathan Nelson
+
+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,37 @@
+= MassAuth
+
+MassAuth is a Twitter OAuth client library
+
+Requirements: 
+OAuth Gem - http://github.com/pelle/oauth/tree/master
+Twitter Gem - http://github.com/jnunemaker/twitter/tree/master
+
+MassAuth is a library to communicate with Twitter with the help of OAuth. There are both public and private request types. For public, you need just to create MASSAUTH::Base instance:
+
+tconnection = MASSAUTH::Base.new
+tconnection.user_info('username')
+tconnection.search('keyword',page, per_page)
+tconnection.public_timeline
+
+To act on behalf of twitter user, you need consumer key and consumer secret: 
+
+tconnection = MASSAUTH::Base.new(:consumer_key => KEY, :consumer_secret => SECRET)
+
+Then, you need to get request token:
+
+request_token = tconnection.request_token
+
+and redirect user to request_token.authorize_url
+
+After that, get access token
+
+session[:access_token] = tconnection.authorize(session[:request_token],session[:request_token_secret])
+
+If you don't want to reauthenticate user every time he logs in, you can just store his access_token.token and access_token.secret somewhere.
+
+NB: All methods raise MASSAUTH::TwitterOAuthError
+
+
+== Copyright
+
+Copyright (c) 2009 Jonathan Nelson. See LICENSE for details.

data/lib/massauth.rb

@@ -0,0 +1,10 @@
+require 'oauth'
+require 'json'
+require 'open-uri'
+
+require "massauth/exceptions"
+require "massauth/account_helpers"
+require "massauth/message_helpers"
+require "massauth/status_helpers"
+require "massauth/search_helpers"
+require "massauth/authorization"

data/lib/massauth/account_helpers.rb

@@ -0,0 +1,29 @@
+module MASSAUTH
+  class Base
+    
+    def authorized?
+      response = access_token.get('/account/verify_credentials.json')
+      return response.class == Net::HTTPOK
+    end
+
+    def verify_credentials
+      response = access_token.get('/account/verify_credentials.json')
+      return_validated(response.body)
+    end
+
+    def rate_limit_status
+      response = access_token.get('/account/rate_limit_status.json')
+      return_validated(response.body)
+    end
+
+    def user_info(username)
+      response = access_token.get("/users/show/#{username}.json")
+      return_validated(response.body)
+    end
+    
+    def create_friendship_and_follow(username)
+      response = access_token.post('/friendships/create/#{username}.json',"follow=true")
+      return_validated(response.body)
+    end
+  end
+end

data/lib/massauth/authorization.rb

@@ -0,0 +1,33 @@
+module MASSAUTH
+  class Base
+
+    def initialize(options = {})
+      @consumer_key = options[:consumer_key]
+      @consumer_secret = options[:consumer_secret]
+      @token = options[:token]
+      @secret = options[:secret]
+    end
+
+    def authorize(token, secret)
+      request_token = OAuth::RequestToken.new(consumer, token, secret)
+      @access_token = request_token.get_access_token
+      @token = @access_token.token
+      @secret = @access_token.secret
+      @access_token
+    end
+
+    def request_token
+      consumer.get_request_token
+    end
+
+    private
+      def consumer
+        @consumer ||= OAuth::Consumer.new(@consumer_key, @consumer_secret, :site =>"http://twitter.com" )
+      end
+
+      def access_token
+        @access_token ||= OAuth::AccessToken.new(consumer, @token, @secret)
+      end
+  end
+end
+

data/lib/massauth/exceptions.rb

@@ -0,0 +1,14 @@
+module MASSAUTH
+  class TwitterOAuthError < StandardError; end
+
+  class Base
+    def return_validated(response)
+      result = JSON.parse(response)
+      if result.is_a? Hash and result['error']
+        raise TwitterOAuthError, result['error']
+      else
+        result
+      end
+    end
+  end
+end

data/lib/massauth/message_helpers.rb

@@ -0,0 +1,23 @@
+module TwitterOAuth
+  class Base
+
+    # Returns a list of the 20 most recent direct messages sent to the authenticating user.
+    def messages
+      response = access_token.get('/direct_messages.json')
+      return_validated(response.body)
+    end
+
+    # Returns a list of the 20 most recent direct messages sent by the authenticating user.
+    def sent_messages
+      response = access_token.get('/direct_messages/sent.json')
+      return_validated(response.body)
+    end
+
+    # Sends a new direct message to the specified user from the authenticating user.
+    def message(user, text)
+      response = access_token.post('/direct_messages/new.json', :user => user, :text => text)
+      return_validated(response.body)
+    end
+
+  end
+end

data/lib/massauth/search_helpers.rb

@@ -0,0 +1,11 @@
+
+module MASSAUTH
+  class Base
+
+    def search(q, page = 1, per_page = 20)
+      response = open("http://search.twitter.com/search.json?q=#{URI.escape(q)}&page=#{page}&rpp=#{per_page}")
+      search_result = JSON.parse(response.read)['results']
+    end
+
+  end
+end

data/lib/massauth/status_helpers.rb

@@ -0,0 +1,36 @@
+
+module MASSAUTH
+  class Base
+
+    def status_by_id(id)
+      response = access_token.get("/statuses/show/#{id}.json")
+      return_validated(response.body)
+    end
+
+    def public_timeline
+      response = access_token.get('/statuses/public_timeline.json')
+      return_validated(response.body)
+    end
+
+    def friends_timeline
+      response = access_token.get('/statuses/friends_timeline.json')
+      return_validated(response.body)
+    end
+
+    def user_timeline
+      response = access_token.get('/statuses/user_timeline.json')
+      return_validated(response.body)
+    end
+
+    def update(message)
+      response = access_token.post('/statuses/update.json', :status => message)
+      return_validated(response.body)
+    end
+
+    def replies
+      response = access_token.get('/statuses/replies.json')
+      return_validated(response.body)
+    end
+
+  end
+end

data/test/massauth_test.rb

@@ -0,0 +1,7 @@
+require 'test_helper'
+
+class MassauthTest < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'massauth'
+
+class Test::Unit::TestCase
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: jonathannelson-massauth
+version: !ruby/object:Gem::Version 
+  version: 0.0.0
+platform: ruby
+authors: 
+- Jonathan Nelson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-03-29 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: 
+email: |
+  jonathannelson@me.com
+
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- LICENSE
+files: 
+- README.rdoc
+- lib/massauth
+- lib/massauth/account_helpers.rb
+- lib/massauth/authorization.rb
+- lib/massauth/exceptions.rb
+- lib/massauth/message_helpers.rb
+- lib/massauth/search_helpers.rb
+- lib/massauth/status_helpers.rb
+- lib/massauth.rb
+- test/massauth_test.rb
+- test/test_helper.rb
+- LICENSE
+has_rdoc: true
+homepage: http://github.com/jonathannelson/massauth
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: TODO
+test_files: []
+