Class: DataMapper::DescendantSet

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
lib/dm-core/support/descendant_set.rb

Instance Method Summary collapse

Constructor Details

#initialize(descendants = []) ⇒ DescendantSet

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Initialize a DescendantSet instance

Parameters:

  • descendants (#to_ary) (defaults to: []) —

    initialize with the descendants



13
14
15
 
# File 'lib/dm-core/support/descendant_set.rb', line 13

def initialize(descendants = [])
  @descendants = SubjectSet.new(descendants)
end

Instance Method Details

#<<(descendant) ⇒ DescendantSet

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Add a descendant

Parameters:

  • descendant (Module)

Returns:



35
36
37
38
 
# File 'lib/dm-core/support/descendant_set.rb', line 35

def <<(descendant)
  @descendants << descendant
  self
end

#clear ⇒ DescendantSet

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Removes all entries and returns self

Returns:



86
87
88
 
# File 'lib/dm-core/support/descendant_set.rb', line 86

def clear
  @descendants.clear
end

#delete(descendant) ⇒ DescendantSet

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Remove a descendant

Also removes from all descendants

Parameters:

  • descendant (Module)

Returns:



50
51
52
53
 
# File 'lib/dm-core/support/descendant_set.rb', line 50

def delete(descendant)
  @descendants.delete(descendant)
  each { |d| d.descendants.delete(descendant) }
end

#each {|descendant| ... } ⇒ DescendantSet

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Iterate over each descendant

Yields:

  • (descendant)

Yield Parameters:

  • descendant (Module)

Returns:



64
65
66
67
68
69
70
 
# File 'lib/dm-core/support/descendant_set.rb', line 64

def each
  @descendants.each do |descendant|
    yield descendant
    descendant.descendants.each { |dd| yield dd }
  end
  self
end

#empty? ⇒ Boolean

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Test if there are any descendants

Returns:

  • (Boolean) 


77
78
79
 
# File 'lib/dm-core/support/descendant_set.rb', line 77

def empty?
  @descendants.empty?
end

#initialize_copy(original) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Copy a DescendantSet instance

Parameters:



23
24
25
 
# File 'lib/dm-core/support/descendant_set.rb', line 23

def initialize_copy(original)
  @descendants = @descendants.dup
end