Module: NameMagic::ClassMethods

Defined in:
lib/y_support/name_magic/class_methods.rb

Instance Method Summary collapse

Instance Method Details

#avid(*args, &block) ⇒ Object

Calls #new in avid mode (name_avid: true); see #new method for avid mode explanation.



64
65
66
67
 
# File 'lib/y_support/name_magic/class_methods.rb', line 64

def avid *args, &block
  oo = args[-1].is_a?( Hash ) ? args.pop : {} # extract options
  new *args, oo.update( name_avid: true ), &block
end

#instance_names(option = false) ⇒ Object

Presents the instance names. Takes one optional argument, same as #instances method. Unnamed instances are completely disregarded.



27
28
29
 
# File 'lib/y_support/name_magic/class_methods.rb', line 27

def instance_names option=false
  instances( option ).names( false )
end

#instances(option = false) ⇒ Object

Presents the instances registered by the namespace. Takes one optional argument. If set to false, the method returns all the instances registered by the namespace. If set to true (default), only returns those instances registered by the namespace, which are of the exact same class as the method’s receiver. Example:

class Animal; include NameMagic end
Cat, Dog = Class.new( Animal ), Class.new( Animal )
Spot = Dog.new
Livia = Cat.new
Animal.instances #=> returns 2 instances
Dog.instances #=> returns 1 instance
Dog.instances( false ) #=> returns 2 instances of the namespace Animal



18
19
20
21
22
 
# File 'lib/y_support/name_magic/class_methods.rb', line 18

def instances option=false
  const_magic
  return __instances__.keys if option
  __instances__.keys.select { |i| i.kind_of? self }
end

#new(*args, &block) ⇒ Object

In addition the ability to name objects upon constant assignment, as common with eg. Class instances, NameMagic redefines class method #new so that it swallows the named argument :name (alias :ɴ), and takes care of naming the instance accordingly. Also, :name_avid named argument mey be supplied, which makes the naming avid (able to overwrite the name already in use by another object) if set to true.



38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
 
# File 'lib/y_support/name_magic/class_methods.rb', line 38

def new *args, &block
  oo = args[-1].is_a?( Hash ) ? args.pop : {} # extract hash
  nm = if oo[:name] then oo.delete :name       # consume :name if supplied
       elsif oo[: