Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mitukiii/tumblife-for-ruby

A Ruby wrapper for the Tumblr API v2.
https://github.com/mitukiii/tumblife-for-ruby

Last synced: 3 months ago
JSON representation

A Ruby wrapper for the Tumblr API v2.

Awesome Lists containing this project

README

        

# Tumblife

[![Build Status](https://travis-ci.org/mitukiii/tumblife-for-ruby.png?branch=master)][travis]
[![Code Climate](https://codeclimate.com/github/mitukiii/tumblife-for-ruby.png)][codeclimate]
[![Dependency Status](https://gemnasium.com/mitukiii/tumblife-for-ruby.png?travis)][gemnasium]

[travis]: https://travis-ci.org/mitukiii/tumblife-for-ruby
[codeclimate]: https://codeclimate.com/github/mitukiii/tumblife-for-ruby
[gemnasium]: https://gemnasium.com/mitukiii/tumblife-for-ruby

A Ruby wrapper for the Tumblr API v2.

## Installation

Add this line to your application's Gemfile:

gem 'tumblife'

And then execute:

$ bundle

Or install it yourself as:

$ gem install tumblife

## Usage

```ruby
require 'tumblife'

Tumblife.configure do |config|
config.consumer_key = YOUR_CONSUMER_KEY
config.consumer_secret = YOUR_CONSUMER_SECRET
config.oauth_token = YOUR_OAUTH_TOKEN
config.oauth_token_secret = YOUR_OAUTH_TOKEN_SECRET
end

client = Tumblife.client

avatar = client.avatar('mitukiii.tumblr.com')
avatar.avatar_url # => http://24.media.tumblr.com/avatar_87fdfd3ea0e3_64.png

info = client.blog_info('mitukiii.tumblr.com')
info.blog.name # => mitukiii
info.blog.url # => http://mitukiii.tumblr.com/

dashboard = client.dashboard
dashboard.posts.each do |post|
# ... do something
end

client.text('mitukiii.tumblr.com', :body => 'Hello, Tumblr!')
client.photo('mitukiii.tumblr.com', :data => Faraday::UploadIO.new('/path/to/image.png', 'image/png'))
```

## TODO

* better post support

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

## Copyright

Copyright (c) 2012 [Kazuya Takeshima](mailto:[email protected]). See [LICENSE][license] for details.

[license]: LICENSE.md