Class: Origen::SubBlocks::Placeholder

Inherits:
Object
  • Object
show all
Defined in:
lib/origen/sub_blocks.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(owner, name, attributes) ⇒ Placeholder

Returns a new instance of Placeholder.



472
473
474
475
476
 
# File 'lib/origen/sub_blocks.rb', line 472

def initialize(owner, name, attributes)
  @owner = owner
  @name = name
  @attributes = attributes
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method, *args, &block) ⇒ Object 



502
503
504
 
# File 'lib/origen/sub_blocks.rb', line 502

def method_missing(method, *args, &block)
  materialize.send(method, *args, &block)
end

Instance Attribute Details

#attributes ⇒ Object (readonly)

Returns the value of attribute attributes.



470
471
472
 
# File 'lib/origen/sub_blocks.rb', line 470

def attributes
  @attributes
end

#name ⇒ Object (readonly)

Returns the value of attribute name.



470
471
472
 
# File 'lib/origen/sub_blocks.rb', line 470

def name
  @name
end

#owner ⇒ Object (readonly)

Returns the value of attribute owner.



470
471
472
 
# File 'lib/origen/sub_blocks.rb', line 470

def owner
  @owner
end

Instance Method Details

#==(obj) ⇒ Object Also known as: equal? 



525
526
527
528
529
530
531
 
# File 'lib/origen/sub_blocks.rb', line 525

def ==(obj)
  if obj.is_a?(Placeholder)
    materialize == obj.materialize
  else
    materialize == obj
  end
end

#add_attributes(attrs) ⇒ Object 



478
479
480
 
# File 'lib/origen/sub_blocks.rb', line 478

def add_attributes(attrs)
  @attributes = @attributes.merge(attrs)
end

#class ⇒ Object

Make this appear like a sub-block to any application code



483
484
485
 
# File 'lib/origen/sub_blocks.rb', line 483

def class
  klass
end

#clone ⇒ Object 



538
539
540
 
# File 'lib/origen/sub_blocks.rb', line 538

def clone
  materialize.clone
end

#dup ⇒ Object 



542
543
544
 
# File 'lib/origen/sub_blocks.rb', line 542

def dup
  materialize.dup
end

#freeze ⇒ Object 



534
535
536
 
# File 'lib/origen/sub_blocks.rb', line 534

def freeze
  materialize.freeze
end

#inspect ⇒ Object

Make it look like a sub-block in the console to avoid confusion



498
499
500
 
# File 'lib/origen/sub_blocks.rb', line 498

def inspect
  "<SubBlock: #{name}>"
end

#is_a?(klass) ⇒ Boolean

Make this appear like a sub-block to any application code

Returns:

  • (Boolean) 


488
489
490
491
492
493
494
495
 
# File 'lib/origen/sub_blocks.rb', line 488

def is_a?(klass)
  # Because sub_blocks are stored in a hash.with_indifferent_access, the value is tested
  # against being a Hash or Array when it is added to the hash. This prevents the class being
  # looking up and loaded by the autoload system straight away, especially if the sub-block
  # has been specified to lazy load
  return false if klass == Hash || klass == Array
  klass == self.klass || klass == Placeholder
end

#klass ⇒ Object 



550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
 
# File 'lib/origen/sub_blocks.rb', line 550

def klass
  @klass ||= begin
    class_name = attributes.delete(:class_name)
    tmp_class = nil
    if class_name
      begin
        tmp_class = "::#{owner.namespace}::#{class_name}"
        klass = eval(tmp_class)
      rescue NameError => e
        raise if e.message !~ /^uninitialized constant (.*)$/ || tmp_class !~ /#{Regexp.last_match(1)}/
        begin
          tmp_class = "::#{class_name}"
          klass = eval(tmp_class)
        rescue NameError => e
          raise if e.message !~ /^uninitialized constant (.*)$/ || tmp_class !~ /#{Regexp.last_match(1)}/
          begin
            tmp_class = "#{owner.class}::#{class_name}"
            klass = eval(tmp_class)
          rescue NameError => e
            raise if e.message !~ /^uninitialized constant (.*)$/ || tmp_class !~ /#{Regexp.last_match(1)}/
            puts "Could not find class: #{class_name}"
            raise 'Unknown sub block class!'
          end
        end
      end
    else
      klass = Origen::SubBlock
    end
    unless klass.respond_to?(:includes_origen_model)
      puts 'Any class which is to be instantiated as a sub_block must include Origen::Model,'
      puts "add this to #{klass}:"
      puts ''
      puts '  include Origen::Model'
      puts ''
      fail 'Sub block does not include Origen::Model!'
    end
    klass
  end
end

#materialize ⇒ Object 



510
511
512
513
514
515
516
517
518
519
520
521
522
523
 
# File 'lib/origen/sub_blocks.rb', line 510

def materialize
  block = nil
  file = attributes.delete(:file)
  load_block = attributes.delete(:load_block)
  dir = attributes.delete(:dir) || owner.send(:export_dir)
  block = owner.send(:instantiate_sub_block, name, klass, attributes)
  if file
    require File.join(dir, file)
    block.extend owner.send(:export_module_names_from_path, file).join('::').constantize
  end
  block.load_block(load_block) if load_block
  block.owner = owner
  block
end

#respond_to?(method, include_private = false) ⇒ Boolean

Returns:

  • (Boolean) 


506
507
508
 
# File 'lib/origen/sub_blocks.rb', line 506

def respond_to?(method, include_private = false)
  materialize.respond_to?(method, include_private)
end

#to_json(*args) ⇒ Object 



546
547
548
 
# File 'lib/origen/sub_blocks.rb', line 546

def to_json(*args)
  materialize.to_json(*args)
end