Rails 6 delete_by, destroy_by ActiveRecord::Relation

As described by DHH in the issue, Rails has find_or_create_by, find_by and similar methods to create and find the records matching the specified conditions. Rails was missing similar feature for deleting/destroying the record(s).

Before Rails 6, deleting/destroying the record(s) which are matching the given condition was done as shown below.

# Example to destroy all authors matching the given condition

Author.find_by(email: "[email protected]").destroy
Author.where(email: "[email protected]", rating: 4).destroy_all

# Example to delete all authors matching the given condition

Author.find_by(email: "[email protected]").delete
Author.where(email: "[email protected]", rating: 4).delete_all

The above examples were missing the symmetry like find_or_create_by and find_by methods.

In Rails 6, the new delete_by and destroy_by methods have been added as ActiveRecord::Relation methods. ActiveRecord::Relation#delete_by is short-hand for relation.where(conditions).delete_all. Similarly, ActiveRecord::Relation#destroy_by is short-hand for relation.where(conditions).destroy_all.

Here is how it can be used.

# Example to destroy all authors matching the given condition using destroy_by

Author.destroy_by(email: "[email protected]")
Author.destroy_by(email: "[email protected]", rating: 4)

# Example to destroy all authors matching the given condition using delete_by

Author.delete_by(email: "[email protected]")
Author.delete_by(email: "[email protected]", rating: 4)

Check out the pull request for more details on this.