module ActiveRecord::Scoping::Named::ClassMethods

# File activerecord/lib/active_record/scoping/named.rb, line 22
def all(all_queries: nil)
  scope = current_scope

  if scope
    if self == scope.model
      scope.clone
    else
      relation.merge!(scope)
    end
  else
    default_scoped(all_queries: all_queries)
  end
end

Возвращает объект области видимости ActiveRecord::Relation.

posts = Post.all
posts.size # Fires "select count(*) from  posts" and returns the count
posts.each {|p| puts p.name } # Fires "select * from posts" and loads post objects

fruits = Fruit.all
fruits = fruits.where(color: 'red') if options[:red_only]
fruits = fruits.limit(10) if limited?

Вы можете определить область видимости, применяемую ко всем методам поиска, с помощью default_scope.

# File activerecord/lib/active_record/scoping/named.rb, line 45
def default_scoped(scope = relation, all_queries: nil)
  build_default_scope(scope, all_queries: all_queries) || scope
end

Возвращает область видимости модели с областями видимости по умолчанию.

# File activerecord/lib/active_record/scoping/named.rb, line 154
def scope(name, body, &block)
  unless body.respond_to?(:call)
    raise ArgumentError, "The scope body needs to be callable."
  end

  if dangerous_class_method?(name)
    raise ArgumentError, "You tried to define a scope named \"#{name}\" " \
      "on the model \"#{self.name}\", but Active Record already defined " \
      "a class method with the same name."
  end

  if method_defined_within?(name, Relation)
    raise ArgumentError, "You tried to define a scope named \"#{name}\" " \
      "on the model \"#{self.name}\", but ActiveRecord::Relation already defined " \
      "an instance method with the same name."
  end

  extension = Module.new(&block) if block

  if body.respond_to?(:to_proc)
    singleton_class.define_method(name) do |*args|
      scope = all._exec_scope(*args, &body)
      scope = scope.extending(extension) if extension
      scope
    end
  else
    singleton_class.define_method(name) do |*args|
      scope = body.call(*args) || all
      scope = scope.extending(extension) if extension
      scope
    end
  end
  singleton_class.send(:ruby2_keywords, name)

  generate_relation_method(name)
end

Добавляет метод класса для получения объектов и выполнения запросов к ним. Этот метод должен возвращать объект ActiveRecord::Relation, который можно комбинировать с другими областями видимости. Если он возвращает nil или false, вместо этого возвращается область видимости all.

Область видимости представляет собой сужение запроса к базе данных, например where(color: :red).select('shirts.*').includes(:washing_instructions).

class Shirt < ActiveRecord::Base
  scope :red, -> { where(color: 'red') }
  scope :dry_clean_only, -> { joins(:washing_instructions).where('washing_instructions.dry_clean_only = ?', true) }
end

Приведённые выше вызовы scope определяют методы класса Shirt.red и Shirt.dry_clean_only. Shirt.red фактически представляет запрос Shirt.where(color: 'red').

Обратите внимание, что это всего лишь «синтаксический сахар» для определения настоящего метода класса:

class Shirt < ActiveRecord::Base
  def self.red
    where(color: 'red')
  end
end

Однако, в отличие от Shirt.find(...), объект, возвращаемый Shirt.red, — это не Array, а ActiveRecord::Relation, который можно комбинировать с другими областями видимости; он напоминает объект ассоциации, создаваемый объявлением has_many. Например, можно вызвать Shirt.red.first, Shirt.red.count, Shirt.red.where(size: 'small'). Кроме того, как и объекты ассоциаций, именованные области видимости ведут себя как Array, реализуя Enumerable; Shirt.red.each(&block), Shirt.red.first и Shirt.red.inject(memo, &block) ведут себя так, будто Shirt.red действительно был массивом.

Эти именованные области видимости можно комбинировать. Например, Shirt.red.dry_clean_only вернёт все рубашки, которые одновременно красные и подлежат только химчистке. Вложенные поиски и вычисления также работают с такими комбинациями: Shirt.red.dry_clean_only.count возвращает количество предметов одежды, соответствующих этим критериям. Аналогично работает Shirt.red.dry_clean_only.average(:thread_count).

Все области видимости доступны как методы класса у потомка ActiveRecord::Base, в котором они были определены. Они также доступны для ассоциаций has_many. Если

class Person < ActiveRecord::Base
  has_many :shirts
end

то elton.shirts.red.dry_clean_only вернёт все красные рубашки Элтона, подлежащие только химчистке.

Для именованных областей видимости также можно задавать расширения, как и для объявлений has_many:

class Shirt < ActiveRecord::Base
  scope :red, -> { where(color: 'red') } do
    def dom_id
      'red_shirts'
    end
  end
end

Области видимости также можно использовать при создании или построении записи.

class Article < ActiveRecord::Base
  scope :published, -> { where(published: true) }
end

Article.published.new.published    # => true
Article.published.create.published # => true

Методы класса вашей модели автоматически доступны в областях видимости. Предположим, что задана следующая конфигурация:

class Article < ActiveRecord::Base
  scope :published, -> { where(published: true) }
  scope :featured, -> { where(featured: true) }

  def self.latest_article
    order('published_at desc').first
  end

  def self.titles
    pluck(:title)
  end
end

Тогда эти методы можно вызывать так:

Article.published.featured.latest_article
Article.featured.titles