百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
C

classy_enum

> 编程语言
开源

一个基于类的枚举 gem 适用于 Rails

273 stars0 点赞2 次浏览
访问官网GitHub

工具介绍

一个基于类的枚举 gem 适用于 Rails

ClassyEnum

ClassyEnum is a Ruby on Rails gem that adds class-based enumerator functionality to Active Record attributes.

This README is also available in a user-friendly DocumentUp format.

Rails & Ruby Versions Supported

Rails: 3.2.x - 4.2.x

Ruby: 1.9.3, 2.0.0, 2.1.x, 2.2.x, and 2.3.x

Installation

The gem is hosted at rubygems.org

Despite RailsGuides claiming that all directories under app will be autoloaded, I've had reports of this not being the case with newer versions of Ruby and Rails.

You may need to add the enums path to config/application.rb:

ruby
# Make sure classy_enum enums get loaded
config.autoload_paths += %W(#{config.root}/app/enums)

Upgrading?

See the wiki for notes about upgrading from previous versions.

Getting Started & Example Usage

The most common use for ClassyEnum is to replace database lookup tables where the content and behavior is mostly static and has multiple "types". Please see the Wiki for a short discussion on use cases comparing ClassyEnum to other gems.

In this example, I have an Active Record model called Alarm with an attribute called priority. Priority is stored as a string (VARCHAR) type in the database and is converted to an enum value when requested.

1. Generate the Enum

The fastest way to get up and running with ClassyEnum is to use the built-in Rails generator like so:

rails generate classy_enum Priority low medium high

NOTE: You may destroy/revoke an enum by using the rails destroy command:

rails destroy classy_enum Priority

A new enum template file will be created at app/enums/priority.rb that will look like:

ruby
class Priority  Priority::Medium
@alarm.priority.medium? # => true
@alarm.priority.high? # => false
@alarm.priority.to_s # => 'medium'

# Should this alarm send an email?
@alarm.send_email? # => false
@alarm.priority = :high
@alarm.send_email? # => true

The enum field works like any other model attribute. It can be mass-assigned using #update_attributes.

What if your enum class name is not the same as your model's attribute name?

Just provide an optional class_name argument to declare the enum's class name. In this case, the model's attribute is called alarm_priority.

ruby
class Alarm  Priority::Medium

Internationalization

ClassyEnum provides built-in support for translations using Ruby's I18n library. The translated values are provided via a #text method on each enum object. Translations are automatically applied when a key is found at locale.classy_enum.enum_parent_class.enum_value, or a default value is used that is equivalent to #to_s.titleize.

Given the following file config/locales/es.yml

yaml
es:
  classy_enum:
    priority:
      low: 'Bajo'
      medium: 'Medio'
      high: 'Alto'

You can now do the following:

ruby
@alarm.priority = :low
@alarm.priority.text # => 'Low'

I18n.locale = :es

@alarm.priority.text # => 'Bajo'

Using Enum as a Collection

ClassyEnum::Base extends the Enumerable module which provides several traversal and searching methods. This can be useful for situations where you are working with the collection, as opposed to the attributes on an Active Record object.

…

Default Enum Value

As with any Active Record attribute, default values can be specified in the database table and will propagate to new instances. However, there may be times when you can't or don't want to set the default value in the database. For these occasions, a default value can be specified like so:

ruby
class Alarm  Priority::Medium

You may also use a Proc object to set the default value. The enum class is yielded to the block and can be used to determine the default at runtime.

ruby
class Alarm (enum){ enum.max }
end

Alarm.new.priority # => Priority::High

Back Reference to Owning Object

In some cases you may want an enum class to reference the owning object (an instance of the Active Record model). Think of it as a belongs_to relationship, where the enum belongs to the model.

By default, the back reference can be called using #owner. If you want to refer to the owner by a different name, you must explicitly declare the owner name in the classy_enum parent class using the .owner class method.

Example using the default #owner method:

ruby
class Priority  true
@alarm.enabled = false
@alarm.send_email? # => false

Model Validation

An Active Record validator validates_inclusion_of :field, in: ENUM is automatically added to your model when you use classy_enum_attr.

If your enum only has members low, medium, and high, then the following validation behavior would be expected:

ruby
@alarm = Alarm.new(priority: :really_high)
@alarm.valid? # => false
@alarm.priority = :high
@alarm.valid? # => true

To allow nil or blank values, you can pass in :allow_nil and :allow_blank as options to classy_enum_attr:

ruby
class Alarm  true

Active Record Querying

Classy Enum classes are plain Ruby objects, and Active Record does not know how to typecast them to strings when querying. Therefore you must explicitly convert the object to a string or symbol for the query to be valid.

Classy Enum versions before 4.0.0 supported querying directly with the enum objects. Suppport for this was removed in 4.0.0 because it depended on ARel internals, and maintaining backwards compatibility with older version of Rails was not possible.

Any of these are valid:

ruby
Alarm.where(priority: 'high')

Alarm.where(priority: Priority[:high].to_s)

Alarm.where(priority: Priority::High.new.to_s)

Note If you get an error like Cannot visit , it means that ActiveRecord - or more accurately ARel - has received the Classy Enum class or instance directly, rather than a string representing corresponding to the database value. To resolve this issue, you need to convert the object to a string.

Form Usage

ClassyEnum includes a select_options helper method to generate an array of enum options that can be used by Rails' form builders such as SimpleForm and Formtastic.

erb
# SimpleForm

  
  

Testing Enums

ClassyEnums can be tested by creating new instances of the ClassyEnum and testing expectations. For example:

ruby
class TestPriorityHigh < Minitest::Test
  def setup
    @priority_high_enum = Priority::High.new
  end

  def test_send_email_enabled
    assert @priority_high_enum.send_email?
  end
end

If the ClassyEnum method implementations rely upon the owner, the ClassyEnum#build method can be used with the owner option. For example:

ruby
class TestPriorityHigh < Minitest::Test
  def setup
    @alarm = Alarm.create
    @priority_high_enum = Priority::High.build(:high, owner: @alarm)
  end

  def test_send_email_enabled
    assert_equal @priority_high_enum.owner, @alarm
  end
end

Copyright

Copyright (c) 2010-2016 Peter Brown. See LICENSE for details.

Issues· 1 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Ruby

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言