RailsStuff — набор для разработки на рельсах

• ResourcesController — облегчённая и современная версия InheritedResources;
• Трекер типов;
• Генератор уникальных случайных значений;
• Хэлперы переводов и основных ссылок.

Установка

# Не использовать автоматическую загрузку:
RailsStuff.load_modules = []

# Загрузить только определенные модули:
RailsStuff.load_modules = %i(sort_scope statusable)

ResourcesController

• Доступ к ресурсам в разных контроллерах по одному имени. Хорошо, когда у тебя переменная @user, но уже хуже, если @payment_transaction. Ещё хуже, если @recurring_payment_transaction. Кто-то в таком случае начинает сокращать имена, но от этого обычно становится ещё хуже.
• Отсутствие повторяющихся before_action :set_user / before_action :find_manager. С длинными списками only или except, которые нужно не забывать поддерживать в актуальном состоянии.
• И, конечно, меньше дублирования кода экшенов и файндеров. Да, рельсы генерируют его за вас, но он всё равно остаётся кодом в вашем репозитории, и он повторяется. При редактировании приходится читать весь код: сразу сложно сказать, что перед тобой — оригинальный код из генератора, или он уже был редактирован.

• Одинаковые названия переменных для всех контроллеров: @_resource и @_collection. Нет необходимости в громоздких конструкциях из set_collection_ivar и get_resource_ivar.
• Отсутствуют belongs_to и цепочки отношений. Но есть resource_helper и быстрый способ установить source_relation:
  
  

  resources_controller source_relation: -> { manager.projects }
  # Это добавит метод #manager, который находит менеджера по params[:manager_id]:
  resource_helper :manager
  

  
  
• Улучшенная интеграция со StrongParameters (хэлпер вместо странного def permited_params):
  
  

  permit_attrs :name, project_attributes: [:id, :_destroy, :name]
  

  
  
• respond_with используется только в create, update, destroy. В целом, это не должно быть проблемой: переопределение .to_json — не очень хорошая идея для форматирования ответов для API Но если это действительно необходимо, то можно допатчить модуль и добавить нужные экшены.
• Хэлперы для STI-моделей: белый список типов, доступных для создания, автоматическое определение класса по названию из параметров и отдельные разрешенные параметры для каждого типа.

module Site
  class UsersController < SiteController
    resources_controller
    permit_attrs :name, :email
  end

  class ProjectsController < SiteController
    resources_controller sti: true
    resource_helper :user
    permit_attrs :name
    permit_attrs_for Project::External, :company
    permit_attrs_for Project::Internal, :department

    def create
      super(action: :index)
    end

    protected

    def after_save_url
      url_for action: :index, user_id: resource.user_id
    end

    def source_relation
      params.key?(:user_id) ? user.projects : self.class.resource_class
    end
  end
end

Трекер типов

class Project
  extend RailsStuff::TypesTracker

  # ...

  eager_load_types! # загрузит все .rb в app/models/project
  # или указать директорию явно:
  eager_load_types! 'lib/path/to/projects'
end

class Project::Big < Project
  unregister_type # Убираем этот класс из списка
end

class Project::Internal < Project::Big; end
class Project::External < Project::Big; end
class Project::Small < Project; end

Project.types_list # [Internal, External, Small]

class Project
  extend RailsStuff::TypesTracker
  # MyTaggedArray должен предоставлять #add(klass, *args).
  # В примере *args - фактически *tags.
  self.types_list_class = MyTaggedArray
end

class Project::Internal < Project::Big
  # Вызывает types_list.add Project::Internal, :tag_1
  register_type :tag_1
end

class Project::External < Project::Big
  register_type :tag_2
end

Project.types_list.with(:tag_1)

Генератор случайных уникальных значений

1. Запись сохраняется как обычно.
2. Если поле уже имеет значение, то ничего не происходит.
3. Генерирует значение и пробует сохранить запись.
4. Если произошла ошибка RecordNotUnique, повторяет предыдущий шаг.

# По-умолчанию используется SecureRandom.hex(32)
random_uniq_attr :token

# С кастомным генератором:
random_uniq_attr(:code) { |instance| my_random(instance) }

Хэлперы

ru:
  helpers:
    actions:
      edit: Редактировать
      delete: Удалить
    confirm: Точно?
    confirmations:
      delete: Не пожалеете?

# в хэлпер добавить модуль:
# include RailsStuff::Helpers::Translation

= translate_action(:edit) or translate_action(:delete)

- collection.each do |resource|
  tr
    td= resource.name
    td= link_to 'x', url_for(resource),
      method: :delete, data: {confirm:  translate_confirmation(:delete)}

= translate_confirmation(:purge_all) # Фолбэк: 'Точно?'

# Настройки в хэлпере.
# Подробности можно посмотреть в модуле rails_stuff/helpers/links
include RailsStuff::Helpers::Links

ICONS = {
  destroy:  '<span class="glyphicon glyphicon-trash"></span>'.html_safe,
  edit:     'Редактировать',
  new:      -> { translate_action(:new) },
}

def basic_link_icons
  ICONS
end

# Использование:
link_to_edit([:edit, :scope, resource]) or link_to_edit(edit_path)
link_to_edit('url', class: 'text-info')

# Если url не указан, используется url_for(action: edit).
# Так на странице /users/1
link_to_edit # будет вести на '/users/1/edit'

# По такому же принципу работают:
link_to_destroy or link_to_new

Что ещё можно найти?

• «nullify blanks»;
• модуль для работы со статусами/перечислениями (как AR::Enum, только лучше);
• обработку параметров для сортировки;
• хэлпер response.json_body для тестирования API;
• даже хэлпер для дебага Net::HTTP;
• и другое.