Class: Rubu::Trail

Inherits:
Move
  • Object
show all
Includes:
MoveStyles
Defined in:
lib/rubu.rb

Overview

Trail with name. Trail is a collection of Steps and/or Trails.

Direct Known Subclasses

Fork, Walk

Constant Summary

@@trails =

Trail hash.

{}

Instance Attribute Summary (collapse)

Attributes inherited from Move

#errmsg, #output, #status, #subs

Class Method Summary (collapse)

Instance Method Summary (collapse)

Methods included from MoveStyles

#parallel_run, #serial_run

Methods inherited from Move

#display, #error, #host, #host_in, #host_out, #use

Constructor Details

- (Trail) initialize(name = nil, &blk)

Create Trail object. Named Trails are registered and can be referenced later.



717
718
719
720
721
722
723
724
725
726
 
# File 'lib/rubu.rb', line 717

def initialize( name = nil, &blk )
    super()
    @name = name
    host_in
    instance_eval &blk
    host_out
    if @name
        @@trails[ @name ] = self
    end
end

Instance Attribute Details

- (Object) name (readonly)

Returns the value of attribute name



713
714
715
 
# File 'lib/rubu.rb', line 713

def name
  @name
end

Class Method Details

+ (Object) [](name)

Reference Trail by name.



708
709
710
 
# File 'lib/rubu.rb', line 708

def self.[]( name )
    @@trails[ name ]
end

+ (Object) form(name = nil, &blk)

Replacement (alias) for new method.



702
703
704
 
# File 'lib/rubu.rb', line 702

def self.form( name = nil, &blk )
    self.new( name, &blk )
end

+ (Object) load_setup(setup_file)

Load a setup file.



741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
 
# File 'lib/rubu.rb', line 741

def Trail.load_setup( setup_file )

    if File.exist? setup_file

        conf = YAML.load_file( setup_file )

        conf.each do |k,v|

            scope = nil

            case k
            when :var; scope = Var
            when :order; scope = Order
            when :info; scope = Info
            end

            v.each do |k2,v2|
                scope[ k2 ] = v2
            end
        end
    end
end

+ (Object) run(trails = 'default')

Run selected trail(s).

Parameters:

  • trails (defaults to: 'default') —

    List of Trails to run.



798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
 
# File 'lib/rubu.rb', line 798

def Trail.run( trails = 'default' )

    unless trails.kind_of? Array
        trails = [ trails ]
    end

    trails.each do |name|

        begin

            ret = Trail[ name ].run
            if ret.status == :error
                STDERR.puts "Rubu FAILURE..."
                exit false
            end

        rescue

            STDERR.puts "Broken trail: \"#{name}\"..."
            exit false

        end

    end

    State.save

    exit true
end

+ (Object) setup(spec)

Apply configuration options and command parameters, if any, to Rubu.

Parameters:

  • spec —

    Hash of options for setup.



769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
 
# File 'lib/rubu.rb', line 769

def Trail.setup( spec )

    Trail.load_setup( "#{ENV['HOME']}/.rubu.yml" )
    Trail.load_setup( ENV['RUBU_CONF'] ) if ENV['RUBU_CONF']
    Trail.load_setup( ".rubu.yml" )

    State.load

    # Apply options from Como.
    if spec[ :como ]
        como = spec[ :como ]
        if Opt[ como ].given
            Opt[ como ].value.each do |conf|
                name, value = conf.split( '=' )
                value = case value
                        when 'true'; true
                        when 'false'; false
                        else value
                        end
                Var[ name.to_sym ] = value
            end
        end
    end

end

Instance Method Details

- (Object) pick(trail)

Take trail into use.



730
731
732
 
# File 'lib/rubu.rb', line 730

def pick( trail )
    Trail[ trail ].use
end

- (Object) run

Default run style for Trail.



736
737
738
 
# File 'lib/rubu.rb', line 736

def run
    serial_run
end