daum_oauth 0.1.1 → 0.1.2

data/Manifest

@@ -1,4 +1,3 @@
-README
 README.rdoc
 Rakefile
 lib/daum_oauth.rb
@@ -6,5 +5,4 @@ lib/daum_oauth/blog.rb
 lib/daum_oauth/cafe.rb
 lib/daum_oauth/client.rb
 lib/daum_oauth/yozm.rb
-text.rdoc
 Manifest

data/README.rdoc

@@ -1,3 +1,60 @@
 = Daum OAuth
 
-Daum OAuth client API library for ruby.
+== About
+
+This is Daum OAuth client API library for ruby.
+
+Motivated by moomerman's twitter_oauth gem
+(http://github.com/moomerman/twitter_oauth)
+
+OAuth specs: http://oauth.net/core/1.0/
+
+OAuth Introduction @ Daum DNA: http://apis.daum.net/oauth/
+
+== Installing
+
+	sudo gem install daum_oauth
+
+Source code is available at http://github.com/thefron/daum_oauth
+
+== Usage
+
+	client = DaumOAuth::Client.new(
+		:consumer_key => 'YOUR_APP_CONSUMER_KEY',
+		:consumer_secret => 'YOUR_APP_CONSUMER_SECRET'
+	)
+	request_token = client.request_token(:oauth_callback => 'callback_url')
+	#:oauth_callback must be specified
+
+	request_token.authorize_url
+	=>  https://apis.daum.net/oauth/authorize?oauth_token=TOKEN
+
+In your application, make users redirect to the authorize_url(daum). Before redirection, store the request token and secret(usually in the session).Then users will authorize the application and be redirected to callback_url you've specified before.
+
+Then in callback procedure,
+
+	access_token = client.authorize(
+		request_token.token,
+		request_token.secret,
+		:oauth_verifier => params[:oauth_verifier]
+	)
+
+	#For now, there's no method for checking authorization's validity.
+	#At least, you can try this if your application makes use of yozm.
+	client.yozm_authorized?
+	=> true
+
+	client.yozm_add 'message here' # sends a yozm message
+
+Now if you can keep access_token(usually in the database) for this user, you won't need re-authorize them next time. Just initialize a client instance with stored access_token when needed.
+
+	access_token = @user.access_token #assuming @user
+
+	client = DaumOAuth::Client.new(
+		:consumer_key => 'YOUR_APP_CONSUMER_KEY',
+		:consumer_secret => 'YOUR_APP_CONSUMER_SECRET',
+		:token => access_token.token,
+		:secret=> access_token.secret
+	)
+
+You are ready to access protected resource.

data/Rakefile

@@ -2,7 +2,7 @@ require 'rubygems'
 require 'rake'
 require 'echoe'
 
-Echoe.new('daum_oauth', '0.1.1') do |p|
+Echoe.new('daum_oauth', '0.1.2') do |p|
 	p.description = 'Daum OAuth API client library for ruby'
 	p.url = 'http://github.com/thefron/daum_oauth'
 	p.author = 'Hoseong Hwang'

data/daum_oauth.gemspec

@@ -2,17 +2,17 @@
 
 Gem::Specification.new do |s|
   s.name = %q{daum_oauth}
-  s.version = "0.1.1"
+  s.version = "0.1.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["Hoseong Hwang"]
-  s.date = %q{2010-11-02}
+  s.date = %q{2010-11-16}
   s.description = %q{Daum OAuth API client library for ruby}
   s.email = %q{thefron@wafflestudio.com}
-  s.extra_rdoc_files = ["README", "README.rdoc", "lib/daum_oauth.rb", "lib/daum_oauth/blog.rb", "lib/daum_oauth/cafe.rb", "lib/daum_oauth/client.rb", "lib/daum_oauth/yozm.rb"]
-  s.files = ["README", "README.rdoc", "Rakefile", "lib/daum_oauth.rb", "lib/daum_oauth/blog.rb", "lib/daum_oauth/cafe.rb", "lib/daum_oauth/client.rb", "lib/daum_oauth/yozm.rb", "text.rdoc", "Manifest", "daum_oauth.gemspec"]
+  s.extra_rdoc_files = ["README.rdoc", "lib/daum_oauth.rb", "lib/daum_oauth/blog.rb", "lib/daum_oauth/cafe.rb", "lib/daum_oauth/client.rb", "lib/daum_oauth/yozm.rb"]
+  s.files = ["README.rdoc", "Rakefile", "lib/daum_oauth.rb", "lib/daum_oauth/blog.rb", "lib/daum_oauth/cafe.rb", "lib/daum_oauth/client.rb", "lib/daum_oauth/yozm.rb", "Manifest", "daum_oauth.gemspec"]
   s.homepage = %q{http://github.com/thefron/daum_oauth}
-  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Daum_oauth", "--main", "README"]
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Daum_oauth", "--main", "README.rdoc"]
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{daum_oauth}
   s.rubygems_version = %q{1.3.7}

data/lib/daum_oauth/yozm.rb

@@ -17,15 +17,40 @@ module DaumOAuth
 				return get("/yozm/v1_0/user/show.json")
 			elsif options[:url_name]
 				return get("/yozm/v1_0/user/show.json?url_name=#{options[:url_name]}")
-			else options[:nick_name]
+			elsif options[:nick_name]
 				return get("/yozm/v1_0/user/show.json?nick_name=#{options[:nick_name]}")
+			else
+				return get("/yozm/v1_0/user/show.json")
 			end
 		end
 
 		#send a message to yozm 
-		def yozm_add(message, options={})
-			get("/yozm/v1_0/message/add.json?#{options.merge(:message => URI.encode(message)).collect{|k, v| "#{k}=#{v}"}.join('&')}")
-			#post("/yozm/v1_0/message/add.json", {:message => message})
+		def yozm_add(message, options={}) #available options: url_shorten, img_url, parent_msg_id
+			#get("/yozm/v1_0/message/add.json?#{options.merge(:message => URI.encode(message)).collect{|k, v| "#{k}=#{v}"}.join('&')}")
+			post("/yozm/v1_0/message/add.json", options.merge(:message => message))
+		end
+
+		#check if a user joined yozm
+		def yozm_joined?
+			get("/yozm/v1_0/user/joined.json")
+		end
+
+		#join yozm
+		def yozm_join(nickname, options={})	#available options: sex(N/F/M), birthday(1984-11-14), blood_type(N/A/B/AB/O)
+			post("/yozm/v1_0/user/join.json", options.merge(:nickname => nickname))
+		end
+
+		def yozm_search(q, options={}) #available options: type(message - default, tag), page, count
+			get("/yozm/v1_0/timeline/search.json?#{options.merge(:q => q).collect{|k,v| "#{k}=#{v}"}.join('&')}")
+		end
+
+		def yozm_home_timeline(options={}) #available options: max_msg_id, since_msg_id, count
+			get("/yozm/v1_0/timeline/home.json?#{options.collect{|k,v| "#{k}=#{v}"}.join('&')}")
 		end
+
+		def yozm_user_timeline(url_name, options={}) #available options: next(=since_msg_id?, count)
+			get("/yozm/v1_0/timeline/user.json?#{options.merge(:url_name => url_name).collect{|k,v| "#{k}=#{v}"}.join('&')}")
+		end
+
 	end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: daum_oauth
 version: !ruby/object:Gem::Version 
-  hash: 25
+  hash: 31
   prerelease: false
   segments: 
   - 0
   - 1
-  - 1
-  version: 0.1.1
+  - 2
+  version: 0.1.2
 platform: ruby
 authors: 
 - Hoseong Hwang
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-02 00:00:00 +09:00
+date: 2010-11-16 00:00:00 +09:00
 default_executable: 
 dependencies: []
 
@@ -26,7 +26,6 @@ executables: []
 extensions: []
 
 extra_rdoc_files: 
-- README
 - README.rdoc
 - lib/daum_oauth.rb
 - lib/daum_oauth/blog.rb
@@ -34,7 +33,6 @@ extra_rdoc_files:
 - lib/daum_oauth/client.rb
 - lib/daum_oauth/yozm.rb
 files: 
-- README
 - README.rdoc
 - Rakefile
 - lib/daum_oauth.rb
@@ -42,7 +40,6 @@ files:
 - lib/daum_oauth/cafe.rb
 - lib/daum_oauth/client.rb
 - lib/daum_oauth/yozm.rb
-- text.rdoc
 - Manifest
 - daum_oauth.gemspec
 has_rdoc: true
@@ -56,7 +53,7 @@ rdoc_options:
 - --title
 - Daum_oauth
 - --main
-- README
+- README.rdoc
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement