convore 0.0.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in convore.gemspec
+gemspec

data/README.md

@@ -0,0 +1,42 @@
+Convore API
+===========
+
+Quick implementation of the Convore.com API in ruby.
+
+Usage
+-----
+
+	require 'convore'
+
+	@client = Convore::Client.new
+	@client.username = 'user'
+	@client.password = 'pass'
+
+	# listen will fork a thread that listens to the long polling /api/live.json
+	# the poll function will check if the thread exited (i.e. a response was received)
+	# process the response and relaunch the thread
+
+	@client.listen
+
+	while true do
+		@client.poll # optionally takes a float for how long to wait for the poll thread to exit, defaults to 0.05
+
+		while m = @client.stream.pop do
+			case m
+			when Convore::Topic then
+				puts "#{m.group.name}: Topic '#{m.name}' created by #{m.user.username}"
+			when Convore::Message then
+				puts "#{m.group.name}: [##{m.topic.name}] <#{m.user.username}> #{m.text}"
+			when Convore::Star then
+				puts "* #{m.user.username} has #{m.star? ? 'stared' : 'unstared'} '#{m.message.text}' by #{m.message.user.username}"
+			else
+				puts "UNKNOWN MESSAGE: #{m.inspect}"
+			end
+		end
+
+		sleep(1)
+	end
+
+All models are quick hacks - Group and Topic have #find, which fetches a given ID via the Rest API.
+
+I wrote this to implement it in an rbot plugin ..watch out for that, coming soon (or maybe not)

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/convore.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "convore/version"
+
+Gem::Specification.new do |s|
+  s.name        = "convore"
+  s.version     = Convore::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Marian Rudzynski"]
+  s.email       = ["mr@impaled.org"]
+  s.homepage    = ""
+  s.summary     = %q{A hasty convore.com API implementation in ruby}
+  s.description = %q{}
+
+  # s.rubyforge_project = "convore"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/convore.rb

@@ -0,0 +1,17 @@
+require 'net/http'
+require 'json'
+
+module Convore
+end
+
+require 'convore/version'
+
+require 'convore/api'
+require 'convore/base'
+require 'convore/user'
+require 'convore/group'
+require 'convore/topic'
+require 'convore/message'
+require 'convore/star'
+require 'convore/client'
+

data/lib/convore/api.rb

@@ -0,0 +1,22 @@
+# TODO: Establish link to client connect, to use their username/password?
+
+module Convore
+	class API
+		class << self
+			def cache
+				@@cache ||= {}
+			end
+
+			def get(api_uri, username=nil, password=nil)
+				response = cache[api_uri] ? cache[api_uri] : 
+				Net::HTTP.start('convore.com', 443, nil, nil, nil, nil, {:use_ssl => true}) {|http|
+					req = Net::HTTP::Get.new(api_uri)
+					req.basic_auth(username, password) if username && password
+					req.set_content_type('application/json')
+					http.request(req)
+				}
+				cache[api_uri] = response
+			end
+		end
+	end
+end

data/lib/convore/base.rb

@@ -0,0 +1,66 @@
+module Convore
+	class Base
+		attr_accessor :attributes
+
+		def initialize
+			@attributes ||= {}
+		end
+
+		def method_missing(method, *args)
+			if method.match(/\=/)
+				@attributes[method.to_s.gsub(/\=$/, '').to_sym] = args.first
+				return true
+			else
+				return @attributes[method] if @attributes[method]
+			end
+			raise NoMethodError.new("no such method: #{method}")
+		end
+
+		class << self
+
+			def get_class(key)
+				case key
+				when 'message' then	Message
+				when 'user', 'creator', 'mentioned_user' then User
+				when 'group' then Group
+				when 'topic' then Topic
+				end
+			end
+
+			def from_json(json)
+				return nil if !json
+
+				object = new
+				json.each {|key, val|
+					key_class = get_class(key)
+
+					value = if val.is_a?(Hash) && key_class
+						key_class.from_json(json[key])
+					elsif val.is_a?(Numeric) && key_class && key_class.api
+						key_class.find(val)
+					else
+						val
+					end
+
+					object.send("#{key}=", value)
+				}
+				object
+			end
+			
+			def api
+				nil
+			end
+			
+			def find(rid)
+				return false if !api || !rid.is_a?(Numeric)
+
+				api_uri = "/api/#{api[-1] == 's' ? api : "#{api}s"}/#{rid}.json"
+
+				response = Convore::API.get(api_uri)
+				
+				json = JSON.parse(response.body)
+				from_json(json[api])
+			end
+		end
+	end
+end

data/lib/convore/client.rb

@@ -0,0 +1,54 @@
+require 'yaml'
+module Convore
+	class Client
+		attr_accessor :thread, :stream, :cursor, :username, :password
+
+		def initialize
+			@stream ||= []
+			@ts ||= Time.now.to_f
+		end
+		
+		def listen
+			raise Exception.new("username and password need to be set to listen to /live") if !username || !password
+
+			@thread = Thread.fork {
+				Net::HTTP.start('convore.com', 443, nil, nil, nil, nil, {:use_ssl => true}) {|http|
+					req = Net::HTTP::Get.new("/api/live.json?cursor=#{@cursor if @cursor}")
+					req.basic_auth(username, password)
+					req.set_content_type('application/json')
+					response = http.request(req)
+					
+					Thread.current[:response] = response.body
+				}
+			}
+		end
+
+		def process_response(response)
+			json = JSON.parse(response)
+
+			if json['messages']
+				json['messages'].each {|msg|
+					if msg['_ts'] && @ts < msg['_ts']
+						case msg['kind']
+						when 'message' then
+							stream.unshift(Message.from_json(msg))
+						when 'topic' then
+							stream.unshift(Topic.from_json(msg))
+						when 'star', 'unstar' then
+							stream.unshift(Star.from_json(msg))
+						end
+						@ts = msg['_ts'] if msg['_ts']
+						@cursor = msg['_id'] if msg['_id']
+					end
+				}
+			end
+		end
+		
+		def poll(wait = 0.05)
+			if t = @thread.join(wait)
+				listen unless @thread.alive?
+				process_response(t[:response])
+			end				
+		end
+	end
+end

data/lib/convore/group.rb

@@ -0,0 +1,7 @@
+module Convore
+	class Group < Base
+		def self.api
+			'group'
+		end
+	end
+end

data/lib/convore/mention.rb

@@ -0,0 +1,4 @@
+module Convore
+	class Mention < Base
+	end
+end

data/lib/convore/message.rb

@@ -0,0 +1,7 @@
+module Convore
+	class Message < Base
+		def text
+			message
+		end
+	end
+end

data/lib/convore/star.rb

@@ -0,0 +1,17 @@
+module Convore
+	class Star < Base
+		class << self
+			def from_json(json)
+				object = new
+				object.user = User.from_json(json['user'])
+				object.message = Message.from_json(json['star']['message'])
+				object.star = json['kind'] == 'star' ? true : false
+				object
+			end
+		end
+		
+		def star?
+			star
+		end
+	end
+end

data/lib/convore/topic.rb

@@ -0,0 +1,7 @@
+module Convore
+	class Topic < Base
+		def self.api
+			'topic'
+		end
+	end
+end

data/lib/convore/user.rb

@@ -0,0 +1,4 @@
+module Convore
+	class User < Base
+	end
+end

data/lib/convore/version.rb

@@ -0,0 +1,3 @@
+module Convore
+	VERSION = "0.0.0"
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification 
+name: convore
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 0
+  version: 0.0.0
+platform: ruby
+authors: 
+- Marian Rudzynski
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-15 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: ""
+email: 
+- mr@impaled.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- convore.gemspec
+- lib/convore.rb
+- lib/convore/api.rb
+- lib/convore/base.rb
+- lib/convore/client.rb
+- lib/convore/group.rb
+- lib/convore/mention.rb
+- lib/convore/message.rb
+- lib/convore/star.rb
+- lib/convore/topic.rb
+- lib/convore/user.rb
+- lib/convore/version.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A hasty convore.com API implementation in ruby
+test_files: []
+