ActsAsBoolean

Treat time-y attributes like boolean attributes.

Why

Ruby is expressive. Expressive is sexy. ActiveRecord time-y objects are time-y objects. Time-y objects are a nightmare, and therefore, not sexy.

We like sexy.

How

class Post < ApplicationRecord
  acts_as_boolean :published_at 
end 

class PostsController < ApplicationController
  def index
    @posts = Post.published 
  end

  def show
    @post = Post.find(params[:id])
    unless @post.published?
      raise ActiveRecord::RecordNotFound
    end
  end 
end  

What

Given Post#published_at:

Method	Description
Post#published	true if Post#published_at is greater than or equal to Time.current; otherwise false
Post#published?	Sexy alias of Post#published
Post#published=	Sets the value of published_at to Time.current if the value passed is truth-y per ActiveModel::Type::Boolean; otherwise sets published_at to nil
Post.published	Creates a scope of Post.where('published_at <= ?', Time.current).where.not(published_at: nil)

Installation

Add this line to your application's Gemfile:

gem 'acts_as_boolean'

And then execute:

$ bundle

The great migration — you probably want an index here because we create a scope to the column:

rails g migration AddPublishedAtToPosts published_at:datetime:index

rake db:migrate

Then drop it in:

class Post < ApplicationRecord
  acts_as_boolean :published_at 
end

Advanced configuration

Default time-y thing

By default, ActsAsBoolean uses Time.current. Want to use DateTime.now? Great, just send in a proc.

In config/initializers/acts_as_boolean.rb:

ActsAsBoolean.timeish = -> { DateTime.now }

Want more control? Pass it in.

class Post < ApplicationRecord
  acts_as_boolean :published_at, time: -> { DateTime.now }
end 

New method name

By default, ActsAsBoolean assumes you want column_name.to_s.delete_suffix("_at"). Given you have published_pie as your column name (which, of course, you do, because you love pie)...

class Post < ApplicationRecord
  acts_as_boolean :published_pie, as: :published
end 

Want to control this globally?

In config/initializers/acts_as_boolean.rb:

ActsAsBoolean.normalize_column = -> (str) { str.gsub("_at", "") }

Contributing

Yes.

License

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