module Sequel::Plugins::Subclasses

  1. lib/sequel/plugins/subclasses.rb

The subclasses plugin keeps track of all subclasses of the current model class. Direct subclasses are available via the subclasses method, and all descendent classes are available via the descendants method:

c = Class.new(Sequel::Model)
c.plugin :subclasses
sc1 = Class.new(c)
sc2 = Class.new(c)
ssc1 = Class.new(sc1)
c.subclasses    # [sc1, sc2]
sc1.subclasses  # [ssc1]
sc2.subclasses  # []
ssc1.subclasses # []
c.descendants   # [sc1, ssc1, sc2]

You can also finalize the associations and then freeze the classes in all descendent classes. Doing so is a recommended practice after all models have been defined in production and testing, and this makes it easier than keeping track of the classes to finalize and freeze manually:

c.freeze_descendants

You can provide a block when loading the plugin, and it will be called with each subclass created:

a = []
Sequel::Model.plugin(:subclasses){|sc| a << sc}
class A < Sequel::Model; end
class B < Sequel::Model; end
a # => [A, B]

Methods

Public Class

  1. apply

Public Class methods

apply(model, &block)

Initialize the subclasses instance variable for the model.

[show source]
   # File lib/sequel/plugins/subclasses.rb
42 def self.apply(model, &block)
43   # :nocov:
44   model.instance_variable_set(:@subclasses, [])  if NEED_SUBCLASSES
45   # :nocov:
46   model.instance_variable_set(:@on_subclass, block)
47 end