Enummer #

Enummer is a lightweight answer for adding enums with multiple values to Rails, with a similar syntax to Rails' built-in enum.

Enummer officially supports Ruby versions 2.7, 3.0 and 3.1 with SQLite, PostgreSQL, and MariaDB.

Installation #

Add gem "enummer" to your Gemfile and bundle.

Usage #

Setup #

Create a migration for an integer that looks something like this:

class CreateUsers < ActiveRecord::Migration[7.0]
  def change
    create_table :users do |t|
      t.integer :permissions, default: 0, null: false
    end
  end
end

Now set up enummer with the available values in your model:

enummer permissions: %i[read write execute]

Scopes #

Scopes will now be provided for <option> and not_<option>.

User.read
User.not_read
User.write
User.not_write
User.execute
User.not_execute

Getter methods #

Simply calling the instance method for the column will return an array of options. Question mark methods are also provided.

user = User.last

user.permissions # => [:read, :write]

user.read? # => true
user.write? # => true
user.execute? # => false

Setter methods #

Options can be set with an array of symbols or via bang methods. Bang methods will additionally persist the changes.

user.update(permissions: %i[read write])
user.write!

FAQ #

Which data type should I use? #

That depends on how many options you expect to store. In PostgreSQL you should be able to store bytes * 8 - 1 of your data type:

Type	Bytes	Values
smallint	2	15
integer	4	31
bigint	8	65
numeric	???	all of them

How can I use it outside of Rails? #

lol stop

Contributing #

Make an issue / PR and we'll see.

Alternatives #

• flag_shih_tzu
• Lots of booleans
• DB Arrays

License #

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