Project

douban

0.01
Repository is archived
No commit activity in last 3 years
No release in over 3 years
A Ruby wrapper of Douban(豆瓣) API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 0
 Project Readme
Douban
======

A Ruby wrapper for Douban(豆瓣) API, Rails 3 support only.

Install
=======

$ gem install douban

Usage
=======

1. Add below lines to your Gemfile:

gem 'douban', :require => 'oauth'
require 'douban'

2. Run generator

$ script/rails generate douban

3. Set you api key and secret in config/douban.yml, and include 
DoubanHelper in your ApplicationController:

class ApplicationController
  include DoubanHelper
end

4. Then you can insert below lines into your application layout

<% if douban_authorized? %>
  <%= link_to 'Logout From Douban', douban_logout_path %>
<% else %>
  <%= link_to "Login with douban", douban_login_path %>
<% end %>

Other available helpers:

* douban_auth_or_login_required, it's useful if you use RESTFUL_AUTH.
* douban_auth_required, you can add it to before_filter.

5. To access douban resources, you can simple call:

douban.get('/people/ahbei')
douban.post('/reviews', review)

6. To determine if your have authorized by user, simple call:

douban.authorized?
=> true  # if your access token is valid.

Feedback are always welcome, Yuanyi Zhang(zhangyuanyi#gmail.com)