https://github.com/radkomih/attempt
Retry library with configurable waiting strategy.
https://github.com/radkomih/attempt
retries retry retry-library retry-strategies retrying
Last synced: 3 days ago
JSON representation
Retry library with configurable waiting strategy.
- Host: GitHub
- URL: https://github.com/radkomih/attempt
- Owner: radkomih
- License: mit
- Created: 2020-10-18T17:14:37.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2020-10-18T19:03:39.000Z (almost 5 years ago)
- Last Synced: 2025-07-15T07:33:34.775Z (3 months ago)
- Topics: retries, retry, retry-library, retry-strategies, retrying
- Language: Ruby
- Homepage: https://github.com/radkomih/attempt
- Size: 4.88 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Attempt
Retry library with configurable waiting strategy.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'attempt'
```
And then execute:
$ bundle install
Or install it yourself as:
$ gem install attempt
## Usage
```ruby
Attempt.new.execute do
raise StandardError.new('Wooops!!!')
end
Attempt.new(tries: 2).execute do
raise StandardError.new('Wooops!!!')
end
Attempt.new(exceptions: [StandardError]).execute do
raise StandardError.new('Wooops!!!')
end
# constant|incremental|random|exponential
Attempt.new(wait_strategy: :constant).execute do
raise StandardError.new('Wooops!!!')
end
callback = Proc.new { |e, context_message| puts "#{e.message} #{context_message}" }
Attempt.new(failure_callback: callback).execute(context: 'syncing resources') do
raise StandardError.new('Wooops!!!')
end
```
## Development
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` 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](https://rubygems.org).
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/radkomih/attempt.