Utils
Las utils son helpers que nos permiten agrupar métodos relacionados. Tienen las siguientes particularidades:
- No tienen lógica del dominio de la aplicación donde se usan.
- Suelen ser clases estáticas.
- Su uso normalmente se repite por toda la aplicación.
Usamos utils porque Rails no define un lugar específico para este tipo de helpers.
En Rails todo lo que no es del dominio de una app se coloca dentro de
/lib. En platanus reservamos este directorio para toda aquella lógica que sea candidata a convertirse en una gema y no para simples helpers.Vienen con la gema power-types que normalmente viene instalada en nuestro proyectos generados con potassium.
Luego de instalada la gema, se corre el generador:
bin/rails generate util util_name method_1 method_2 method_nPor ejemplo si queremos crear una clase util para simplificar el uso de enums podemos hacer:
bin/rails generate util Enums translate_enum_attr translate_aasm_attr enum_options_for_selectEsto generará el helper en:
app/utils/enums_utils.rbclass EnumsUtils < PowerTypes::BaseUtil
def self.translate_enum_attr(class_name, enum, key)
I18n.t(
"activerecord.attributes.#{class_name.model_name.i18n_key}.#{enum.to_s.pluralize}.#{key}"
)
end
def self.enum_options_for_select(class_name, enum)
class_name.send(enum.to_s.pluralize).map do |key, value|
[translate_enum_attr(class_name, enum, key), value]
end
end
end
Luego se usaría así:
supply_purchase.supply_type = :fertilizer
EnumUtils.translate_enum_attr(Supply, :supply_type, supply_purchase.supply_type) #=> "Fertilizante"
EnumUtils.enum_options_for_select(Supply, :supply_type) #=> [["Fertilizante", :fertilizer], ["Agroquímicos", :agrochemical]]
Repasemos las particularidades de las utils contra el ejemplo:
- “No tienen lógica del dominio de la aplicación donde se usan.” → En este caso se cumple ya que
EnumsUtilspodría moverse a otra aplicación y seguiría funcionando. No hay lógica específica del proyecto. - “Suelen ser clases estáticas.” → Como se puede ver
translate_enum_attryenum_options_for_selectson métodos de clase. No crea una instancia deEnumUtilsen ningún momento. - “Su uso normalmente se repite por toda la aplicación” → Sirve para el modelo
Supplyque usamos en el ejemplo pero también podría servir para cualquier otro modelo de la aplicación.
Última actualización 3mo ago