How to install Enumerize in a Rails 7 app?

Add gem 'enumerize' to your Gemfile and run bundle install. Ensure you're using Ruby 3.1+ and Rails 7.0+, as specified in the Supported Versions section.

Enumerize vs ActiveRecord::Enum: which is better for Rails?

Enumerize offers more features like I18n support, multiple ORM compatibility, and form integration, but if you only need basic enums within ActiveRecord and want fewer dependencies, Rails' built-in enum might be sufficient. Enumerize is ideal for projects requiring internationalization or cross-ORM consistency.

How to skip validations in Enumerize?

Pass skip_validations: true or a lambda in the enumerize method, as shown in the ActiveRecord section. This is necessary to avoid default inclusion validations that might interfere with custom logic.

Can Enumerize handle multi-word enum values?

Yes, but you should use the I18n feature for human-readable text. Define keys in localization files, as noted in the Usage section, since enumerized values are identifiers and not directly multi-word strings.

How to use Enumerize with Mongoid?

Extend your Mongoid document class with Enumerize and define the field, as demonstrated in the Mongoid section. It supports default values and other options without requiring ActiveRecord.

How to create radio buttons with Enumerize and SimpleForm?

In your SimpleForm, use f.input :status, as: :radio_buttons; Enumerize automatically provides the collection based on the enumerated attribute, eliminating the need for manual array setup.

Does Enumerize work with RSpec for testing?

Yes, it includes built-in RSpec matchers with qualifiers for options like in, with_default, and with_scope, making it easy to test enumerated attributes, as detailed in the Testing section.

Open-Awesome

Enumerize

MITRubyv2.5.0

A Ruby gem for adding enumerated attributes with I18n support and ORM integrations like ActiveRecord and Mongoid.

GitHub

1.8k stars200 forks0 contributors

What is Enumerize?

Enumerize is a Ruby gem that adds enumerated attribute support to Ruby classes, particularly in Rails applications. It allows developers to define attributes with a fixed set of values (like roles or statuses), providing I18n translations, validations, and helper methods. It solves the problem of managing predefined options in models without cluttering code with constants or manual validation logic.

Target Audience

Ruby on Rails developers and Rubyists using ORMs like ActiveRecord or Mongoid who need to handle enumerated fields (e.g., user roles, order statuses) with clean code and internationalization support.

Value Proposition

Developers choose Enumerize for its seamless integration with popular ORMs, built-in I18n support, and rich feature set like scopes, predicate methods, and form helpers—all while keeping model definitions simple and maintainable.

Overview

Enumerated attributes with I18n and ActiveRecord/Mongoid support

Use Cases

Best For

Adding role-based access control (e.g., admin/user roles) in Rails models
Managing status fields (e.g., draft/published/archived) with I18n translations
Creating dropdown or radio button inputs in forms using SimpleForm or Formtastic
Implementing scoped queries for enumerated attributes in ActiveRecord
Storing multiple selection values (e.g., user interests) as an array
Testing enumerated attributes with built-in RSpec matchers

Not Ideal For

Projects using PostgreSQL native enum types who prioritize database-level constraints over application logic
Applications requiring enumerations to be dynamically modifiable at runtime without code changes or migrations
Teams that prefer Rails' built-in ActiveRecord::Enum for simplicity and minimal gem dependencies

Pros & Cons

Pros

Extensive I18n Integration

Supports localization files for human-readable values with flexible scoping, including defaults and custom i18n_scope options, as shown in the I18n Support section.

Broad ORM Compatibility

Works seamlessly with ActiveRecord, Mongoid, MongoMapper, and Sequel, including database migrations and scopes, reducing boilerplate code across different Ruby ORMs.

Rich Helper Methods

Generates predicate methods (e.g., user.admin?) and provides ActiveRecord scopes for easy querying, enhancing developer productivity in model interactions.

Form Builder Synergy

Automatically integrates with SimpleForm and Formtastic to generate dropdowns or radio buttons, simplifying form creation without manual collection setup.

Cons

Mandatory Validation Overhead

Adds inclusion validation by default, which can conflict with custom validations; disabling it requires explicit skip_validations options, adding complexity.

Static Enumeration Design

Values are defined statically at the class level and cannot be easily modified at runtime, limiting flexibility for applications with evolving data sets.

Scope Restriction with Multi-Select

Cannot define scopes when using the :multiple option for array-like attributes, hindering query optimization for fields that hold multiple values.

Frequently Asked Questions

Related Projects

PaperTrail

Track changes to your rails models

Stars7,021

Forks910

Last commit1 month ago

FriendlyId

FriendlyId is the “Swiss Army bulldozer” of slugging and permalink plugins for ActiveRecord. It allows you to create pretty URL’s and work with human-friendly strings as if they were numeric ids for ActiveRecord models.

Stars6,225

Forks589

Last commit1 month ago

AASM

AASM - State machines for Ruby classes (plain Ruby, ActiveRecord, Mongoid, NoBrainer, Dynamoid)

Stars5,216

Forks648

Last commit23 days ago

ActsAsTaggableOn

A tagging plugin for Rails applications that allows for custom tagging along dynamic contexts.

Stars4,996

Forks1,193

Last commit3 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub