Enumerize - 简化枚举类型处理的 Ruby 库

Enumerize - 简化枚举类型处理的 Ruby 库

是一个用于 Ruby on Rails 和 Active Record 的开源库，它提供了简单、易于使用的枚举类型处理功能。如果您需要在模型中定义一组可选值或状态，那么 Enumerize 就是一个理想的选择。

功能特性

• 支持通过字符串或符号来指定枚举值。
• 可以在数据库中存储枚举值，并支持搜索和排序。
• 提供了一系列辅助方法，方便在视图层进行渲染。
• 兼容 ActiveRecord, ROM, Mongoid ORM 框架。
• 支持多语言本地化。

使用场景

Enumerize 在很多情况下都非常实用：

• 定义角色或权限（如 User 模型中的 role 属性）。
• 管理订单状态（如 Order 模型中的 status 属性）。
• 处理性别、颜色等枚举类型的属性。

快速上手

要开始使用 Enumerize，首先在 Gemfile 中添加如下依赖项：

gem 'enumerize'

接着运行 bundle 安装 gem：

$ bundle install

现在可以在模型中定义枚举类型了：

class User < ApplicationRecord
  enumerize :role, in: { admin: 1, member: 2 }, predicates: true
end

这将为 User 模型添加一个新的 role 属性，可以选择 admin 或 member 值。还可以在视图模板中利用以下辅助方法：

<% if current_user.admin? %>
  <!-- 显示管理员专享区域 -->
<% end %>

<%= form_with(model: @user) do |f| %>
  <%= f.select :role, User.roles.keys.map(&:to_s).collect { |r| [User.human_attribute_name("role.#{r}"), r] } %>
<% end %>

进阶使用

除了基本的用法，Enumerize 还提供了许多高级功能。例如，您可以使用模块化的方式来组织枚举：

module Profile
  extend Enumerize

  enumerize :gender, in: [:male, :female]
end

class User < ApplicationRecord
  include Profile
end

此外，您还可以让枚举值对应于数据库表中的不同列：

class Product < ApplicationRecord
  enumerize :color, in: [:red, :green, :blue], values_in_database: true
end

这将在 products 表中创建一个名为 color_id 的字段，用于存储枚举值对应的 ID。

社区与支持

由于 Enumerize 已经被广泛应用多年，因此您可以在 Stack Overflow 或官方 GitHub 仓库的 Issues 部分找到大量解决方案和讨论。

总之，如果你想简化枚举类型处理并在 Ruby on Rails 中获得更好的开发体验，请尝试一下 Enumerize！愿它成为您的下一个必备工具！