TwitterRetry

Twitter api awesome handling with retry

Gem Version Build Status Code Climate Coverage Status

Requirements

  • Ruby 2.1+

Installation

Add this line to your application's Gemfile:

gem 'twitter_retry'

And then execute:

$ bundle

Or install it yourself as:

$ gem install twitter_retry

Usage

TwitterRetry.with_handing do
  # some twitter API code
  twitter.update("some tweet")
end
  • When twitter.update not raise error
    • return true
  • When twitter.update raise Twitter::Error::Forbidden (Your account is suspended and is not permitted to access this feature.)
    • raise TwitterRetry::SuspendedError
  • When twitter.update raise ignorable error (ex. Twitter::Error::Forbidden(User is over daily status update limit.))
    • error is squashed
    • return false
  • When twitter.update raise retryable error (ex. Twitter::Error::ServiceUnavailable(Over capacity))
    • retry 3 times with sleep 1 second
    • When successful in retry, return true
    • When all failure, raise TwitterRetry::RetryOverError

The algorithm is actually more concise in code: See TwitterRetry::Retryable

Configuration

TwitterRetry.configure do |config|
  config.sleep_second     = 1
  config.max_retry_count  = 3
  config.retryable_errors << [Twitter::Error, "some error message"]
  config.ignorable_errors << [Twitter::Error, "some error message"]

  # Check whether error message matched with regexp
  config.retryable_errors << [Twitter::Error::ServiceUnavailable, /something/]

  # Check whether only error class matches (error message can be anything)
  config.ignorable_errors << [Twitter::Error::ServiceUnavailable]
end

See TwitterRetry::Config

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake rspec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/sue445/twitter_retry.

License

The gem is available as open source under the terms of the MIT License.