rubu 0.0.6 → 0.0.7

data/doc/index.html

@@ -157,8 +157,8 @@ make the build process convenient.</p>
 <p><strong>Step</strong> is build action that transforms source file(s) to
 target file(s). For example, a C source file compilation is a
 <strong>Step</strong> where one source file is converted to a corresponding
-object file. <strong>Step</strong> is given source <strong>Mark</strong>
-and target <strong>Mark</strong> as arguments. Hence this type of
+object file. <strong>Step</strong> is given <strong>Source-Mark</strong>
+and <strong>Target-Mark</strong> as arguments. Hence this type of
 <strong>Step</strong> a is one-to-one mapping.</p>
 
 <p>Linking multiple objects to an executable is a many-to-one mapping. This is
@@ -205,7 +205,7 @@ example.</p>
 <p>To summarize and highlight the relationships between concepts, see the
 diagram below:</p>
 
-<pre class="code ruby"><code class="ruby">RBP =&gt; Trail+ =&gt; Step+ [s/p] =&gt; Move+ [s/p] =&gt; SourceMark*, TargetMark*
+<pre class="code ruby"><code class="ruby">RBP =&gt; Trail+ =&gt; Step+ [s/p] =&gt; Move+ [s/p] =&gt; Source-Mark*, Target-Mark*
     =&gt; Order+
     =&gt; Var*
     =&gt; Info*
@@ -223,8 +223,8 @@ sequence or in parallel.</p>
 
 <p><strong>Step</strong> includes one or more <strong>Moves</strong>, and they
 can also be sequential or parallel. <strong>Move</strong> has typically at
-least one <strong>SourceMark</strong> and at least one
-<strong>TargetMark</strong>. However, there are exceptions as well.</p>
+least one <strong>Source-Mark</strong> and at least one
+<strong>Target-Mark</strong>. However, there are exceptions as well.</p>
 
 <p>The suggested ordering within <span class='object_link'><a href="Rubu.html" title="Rubu (module)">Rubu</a></span> Build Program is:</p>
 <dl class="rdoc-list label-list"><dt>configuration
@@ -235,7 +235,8 @@ the build process.</p>
 <dd>
 <p>Collect source and target files either using Ruby with glob pattern, direct
 references, or through manifest files. Convert file names to
-<strong>Mark</strong> objects.</p>
+<strong>Mark</strong> objects (<strong>Source-Mark</strong>,
+<strong>Target-Mark</strong>).</p>
 </dd><dt>step definition
 <dd>
 <p>Define <strong>Steps</strong>. Inherit one of the <strong>Step</strong>
@@ -274,7 +275,8 @@ all C source files:</p>
 </code></pre>
 
 <p>This creates a list of <strong>Mark</strong> objects which are source
-files. The corresponding object files can be created with “peer” method:</p>
+files, i.e. <strong>Source-Marks</strong>. The corresponding object
+(target) files can be created with “peer” method:</p>
 
 <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_obj_files'>obj_files</span> <span class='op'>=</span> <span class='id identifier rubyid_cee_files'>cee_files</span><span class='period'>.</span><span class='id identifier rubyid_peer'>peer</span><span class='lparen'>(</span> <span class='const'>Var</span><span class='lbracket'>[</span> <span class='symbol'>:build_dir</span> <span class='rbracket'>]</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>.o</span><span class='tstring_end'>&#39;</span></span> <span class='rparen'>)</span>
 </code></pre>
@@ -303,8 +305,8 @@ additional “setup” method can be defined as well.</p>
 configuration. “step” method is the action for <strong>Step</strong>.
 <span class='object_link'><a href="Rubu.html" title="Rubu (module)">Rubu</a></span> executes it, if necessary. For example, if <strong>Step</strong> is
 a <strong>StepAged</strong> class, then the “step” method is only called if
-the source <strong>Mark</strong> is newer than the target
-<strong>Mark</strong>.</p>
+the <strong>Source-Mark</strong> is newer than the
+<strong>Target-Mark</strong>.</p>
 
 <p>“step” method may include only one command or a set of commands. If one
 command is needed, it can be simply executed:</p>
@@ -395,7 +397,7 @@ refer to the source, i.e. the only existing source, you can use the
 </div></div>
 
       <div id="footer">
-  Generated on Tue Sep 11 08:02:18 2018 by
+  Generated on Sat Sep 29 22:28:26 2018 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.16 (ruby-2.5.1).
 </div>

data/doc/top-level-namespace.html

@@ -102,7 +102,7 @@
 </div>
 
       <div id="footer">
-  Generated on Tue Sep 11 08:02:18 2018 by
+  Generated on Sat Sep 29 22:28:26 2018 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.16 (ruby-2.5.1).
 </div>

data/example/bin/rubu_example

@@ -12,6 +12,7 @@ Spec.command( 'rubu_example', 'Tero Isannainen', '2018',
     [
         [ :opt_multi, 'conf',    '-c', "Configuration option." ],
         [ :switch,    'verbose', '-v', "Verbose." ],
+        [ :switch,    'noop',    '-n', "No operation." ],
         [ :switch,    'serial',  '-s', "Serial execution." ],
         [ :switch,    'list',    '-l', "List defined Trails."],
         [ :default,    nil,       nil, "Trail(s) to execute." ],
@@ -33,14 +34,13 @@ Var[ :exe_name ]   = 'build/hello'
 Var[ :fast ] = false
 
 # Change Rubu to verbose mode.
-if Opt['verbose'].given
-    Order[ :verbose ] = true
-end
+Order[ :verbose ] = Opt['verbose'].given
+
+# No operation mode.
+Order[ :noop ] = Opt['noop'].given
 
 # Force serial execution.
-if Opt[ 'serial' ].given
-    Order[ :serial ] = true
-end
+Order[ :serial ] = Opt[ 'serial' ].given
 
 # Read setup files and apply Como command line arguments to Var space.
 Trail.setup( :como => 'conf' )

data/lib/rubu.rb

@@ -133,20 +133,22 @@ module Rubu
         # Execution content.
         def run
             begin
-                stdout, stderr, status = Open3.capture3( @cmd )
+                stdout, stderr, status = Open3.capture3( @cmd ) unless Order[ :noop ]
 
                 if Order[ :verbose ]
                     STDOUT.puts @cmd
                 end
 
-                if status.exitstatus == 0
-                    if Order[ :sh_warn ] && not( stderr.empty? )
-                        warn( stderr )
+                unless Order[ :noop ]
+                    if status.exitstatus == 0
+                        if Order[ :sh_warn ] && not( stderr.empty? )
+                            warn( stderr )
+                        end
+                        @status = :success
+                    else
+                        @status = :error
+                        error( stderr )
                     end
-                    @status = :success
-                else
-                    @status = :error
-                    error( stderr )
                 end
 
             rescue
@@ -173,7 +175,7 @@ module Rubu
         # Execution content.
         def run
             begin
-                ret = instance_eval( &@cmd )
+                ret = instance_eval( &@cmd ) unless Order[ :noop ]
                 @status = :success
                 if @desc && Order[ :verbose ]
                     STDOUT.puts @desc
@@ -403,6 +405,7 @@ module Rubu
     # * serial   - Force parallel executions to serial (default: parallel).
     # * parmax   - Limit the number of parallel executions (default: 0).
     # * verbose  - Show command executions (default: false).
+    # * noop     - No operation (default: false).
     # * force    - Force Step updates (default: false).
     # * sh_warn  - Show shell warnings (default: true).
     class Order
@@ -431,6 +434,9 @@ module Rubu
         # Verbose execution.
         Order[ :verbose ] = false
 
+        # No operation.
+        Order[ :noop ] = false
+
         # Force Step updates.
         Order[ :force ] = false
 

data/lib/version.rb

@@ -1,5 +1,5 @@
 module Rubu
-    VERSION = "0.0.6"
+    VERSION = "0.0.7"
     def Rubu.version
         Rubu::VERSION
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rubu
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors:
 - Tero Isannainen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-09-11 00:00:00.000000000 Z
+date: 2018-09-29 00:00:00.000000000 Z
 dependencies: []
 description: |-
   Rubu (Re-Usable Build Utility) is a library for building