Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yasaichi/everett
:eyes: Substitute for Active Record Observer on Rails 5
https://github.com/yasaichi/everett
observer rails
Last synced: about 1 month ago
JSON representation
:eyes: Substitute for Active Record Observer on Rails 5
- Host: GitHub
- URL: https://github.com/yasaichi/everett
- Owner: yasaichi
- License: mit
- Created: 2016-12-10T12:03:50.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T20:22:48.000Z (about 1 year ago)
- Last Synced: 2024-11-24T09:42:20.538Z (about 1 month ago)
- Topics: observer, rails
- Language: Ruby
- Homepage:
- Size: 65.4 KB
- Stars: 22
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: MIT-LICENSE
Awesome Lists containing this project
README
# Everett
[](http://badge.fury.io/rb/everett)
[](https://travis-ci.org/yasaichi/everett)
[](https://codeclimate.com/github/yasaichi/everett)
[](https://codeclimate.com/github/yasaichi/everett/coverage)
Everett is a substitute for Active Record Observer on Rails 5.
## Installation
Put this in your Gemfile:
```ruby
gem 'everett'
```
Run the installation generator with:
```sh
$ rails g everett:install
```
They will install the initializer into `config/initializers/everett.rb`.
## Usage
### Overview
Observers allow you to implement trigger-like behavior outside the original classes.
You can put them anywhere, for example `app/models/contact_observer.rb`:
```ruby
class ContactObserver < Everett::Observer
def after_create(contact)
Rails.logger.info('New contact has been added!')
end
def after_destroy(contact)
Rails.logger.info("Contact with an id of #{contact.id} has been destroyed!")
end
end
```
This observer prints a log message when specific callbacks are triggered.
Just like Active Record Observer, the convention is to name observers after the class they observe.
If you need to change this, or want to use one observer for several classes, use `observe`:
```ruby
class NotificationsObserver < Everett::Observer
observe :comment, :like
def after_create(record)
# notifiy users of new comment or like
end
end
```
Note that you must register observers first to activate them.
This can be done by adding the following line into `config/initializers/everett.rb`:
```ruby
config.observers = :contact_observer, :notifications_observer
```
### after\_{create,update,destroy}\_commit
Since `after_create_commit`, `after_update_commit` and `after_destroy_commit` were introduced in Rails 5,
you can also use them in observers:
```ruby
class CommentObserver < Everett::Observer
def after_create_commit(comment)
CommentMailer.notification(comment).deliver_now
end
end
```
This observer sends an email after a record has been created.
## Migration from rails-observers
Since Everett is highly compatible with Active Record Observer,
you can easily migrate from [rails-observers](https://github.com/rails/rails-observers).
All you need to do is as follows:
### 1. Replace ActiveRecord::Observer with Everett::Observer
```diff
-class ContactObserver < ActiveRecord::Observer
+class ContactObserver < Everett::Observer
```
### 2. Register observers in config/initializers/everett.rb
```diff
# config/application.rb
-config.active_record.observers = :contact_observer, :notifications_observer
# config/initializers/everett.rb
+Everett.configure do |config|
+ config.observers = :contact_observer, :notifications_observer
+end
```
### 3. Check the test suite passes
If you find any bugs, please document them on [the issues page](https://github.com/yasaichi/everett/issues).
## Contributing
You should follow the steps below.
1. [Fork the repository](https://help.github.com/articles/fork-a-repo/)
2. Create a feature branch: `git checkout -b add-new-feature`
3. Commit your changes: `git commit -am 'Add new feature'`
4. Push the branch: `git push origin add-new-feature`
5. [Send us a pull request](https://help.github.com/articles/about-pull-requests/)
## License
The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).