YoClient
is a Ruby client of Yo.
Requirements
- Ruby 1.9+ (Tested on Ruby 1.9.3, 2.0.0, 2.1.2)
- Yo API Account
Installation
Add this line to your application's Gemfile:
gem 'yo_client'
And then execute:
$ bundle install
Usage
client = YoClient::Client.new(API_TOKEN)
# Yo all subscribers
client.yoall
# Yo all subscribers with a link (added from v0.1.0)
client.yoall(link: 'http://youcune.com/')
# Yo the specific user
# Note that USERNAME will be upcased before sending to API
client.yo(USERNAME)
# Yo the specific user with a link (added from v0.1.0)
client.yo(USERNAME, link: 'http://youcune.com/')
# Count Total Subscribers
client.subscribers_count # -> 5
Error Handling
-
YoClient::ConnectionError
is risen if the connection has failed. -
YoClient::ClientError
is risen if the connection has succeeded but API returned error.
At the date of 13th July, even if API results in failure, it sometimes behaves as if it succeed. In this case, YoClient cannot tell succeeded or not.
Yo the developer
Yo YOUCUNE, the developer of YoClient, if you ...
- like YoClient
- dislike YoClient
- have any ideas about YoClient
Thanks.
Contributing
- Fork it ( https://github.com/youcune/yo_client/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request