RubyGems - sprout - Versions diffs - 1.1.15.pre → 1.1.16.pre - Mend

sprout 1.1.15.pre → 1.1.16.pre

Potentially problematic release.

This version of sprout might be problematic. Click here for more details.

Files changed (101) hide show

data/VERSION +1 -1
data/lib/sprout/executable/base.rb +7 -7
metadata +101 -252
data/Gemfile.lock +0 -50
data/doc/Dir.html +0 -288
data/doc/Rake/Task.html +0 -184
data/doc/Sprout.html +0 -740
data/doc/Sprout/ArchiveUnpacker.html +0 -1246
data/doc/Sprout/CommandLine.html +0 -520
data/doc/Sprout/Concern.html +0 -351
data/doc/Sprout/Errors.html +0 -101
data/doc/Sprout/Errors/ArchiveUnpackerError.html +0 -125
data/doc/Sprout/Errors/DestinationExistsError.html +0 -133
data/doc/Sprout/Errors/DuplicateMemberError.html +0 -132
data/doc/Sprout/Errors/ExecutableError.html +0 -125
data/doc/Sprout/Errors/ExecutableRegistrationError.html +0 -132
data/doc/Sprout/Errors/ExecutionError.html +0 -121
data/doc/Sprout/Errors/GeneratorError.html +0 -125
data/doc/Sprout/Errors/InvalidArgumentError.html +0 -132
data/doc/Sprout/Errors/LoadError.html +0 -121
data/doc/Sprout/Errors/MissingArgumentError.html +0 -132
data/doc/Sprout/Errors/MissingExecutableError.html +0 -132
data/doc/Sprout/Errors/MissingGeneratorError.html +0 -132
data/doc/Sprout/Errors/MissingTemplateError.html +0 -132
data/doc/Sprout/Errors/ProcessRunnerError.html +0 -121
data/doc/Sprout/Errors/RemoteFileLoaderError.html +0 -110
data/doc/Sprout/Errors/SproutError.html +0 -114
data/doc/Sprout/Errors/UnknownArchiveType.html +0 -122
data/doc/Sprout/Errors/UsageError.html +0 -121
data/doc/Sprout/Errors/ValidationError.html +0 -121
data/doc/Sprout/Errors/VersionRequirementNotMetError.html +0 -121
data/doc/Sprout/Executable.html +0 -169
data/doc/Sprout/Executable/Base.html +0 -2813
data/doc/Sprout/Executable/Boolean.html +0 -534
data/doc/Sprout/Executable/CollectionParam.html +0 -483
data/doc/Sprout/Executable/FileParam.html +0 -484
data/doc/Sprout/Executable/Files.html +0 -292
data/doc/Sprout/Executable/Number.html +0 -141
data/doc/Sprout/Executable/Param.html +0 -2874
data/doc/Sprout/Executable/ParameterFactory.html +0 -232
data/doc/Sprout/Executable/Path.html +0 -223
data/doc/Sprout/Executable/Paths.html +0 -253
data/doc/Sprout/Executable/Session.html +0 -1513
data/doc/Sprout/Executable/StringParam.html +0 -213
data/doc/Sprout/Executable/Strings.html +0 -167
data/doc/Sprout/Executable/Url.html +0 -160
data/doc/Sprout/Executable/Urls.html +0 -170
data/doc/Sprout/FileTarget.html +0 -1109
data/doc/Sprout/Generator.html +0 -750
data/doc/Sprout/Generator/Base.html +0 -1902
data/doc/Sprout/Generator/Command.html +0 -690
data/doc/Sprout/Generator/DirectoryManifest.html +0 -476
data/doc/Sprout/Generator/FileManifest.html +0 -643
data/doc/Sprout/Generator/Manifest.html +0 -377
data/doc/Sprout/Generator/TemplateManifest.html +0 -194
data/doc/Sprout/GeneratorGenerator.html +0 -1115
data/doc/Sprout/Library.html +0 -1146
data/doc/Sprout/LibraryGenerator.html +0 -331
data/doc/Sprout/OutputBuffer.html +0 -445
data/doc/Sprout/Platform.html +0 -714
data/doc/Sprout/ProcessRunner.html +0 -1707
data/doc/Sprout/ProgressBar.html +0 -366
data/doc/Sprout/ProgressBarImpl.html +0 -2109
data/doc/Sprout/ProgressBarManager.html +0 -424
data/doc/Sprout/ProgressBarOutputStream.html +0 -406
data/doc/Sprout/RDocParser.html +0 -211
data/doc/Sprout/RemoteFileLoader.html +0 -172
data/doc/Sprout/RemoteFileTarget.html +0 -679
data/doc/Sprout/ReversedProgressBar.html +0 -184
data/doc/Sprout/RubyFeature.html +0 -155
data/doc/Sprout/RubyFeature/ClassMethods.html +0 -1065
data/doc/Sprout/RubyGenerator.html +0 -786
data/doc/Sprout/Specification.html +0 -767
data/doc/Sprout/System.html +0 -191
data/doc/Sprout/System/BaseSystem.html +0 -1660
data/doc/Sprout/System/JavaSystem.html +0 -122
data/doc/Sprout/System/OSXSystem.html +0 -335
data/doc/Sprout/System/ThreadMock.html +0 -183
data/doc/Sprout/System/UnixSystem.html +0 -584
data/doc/Sprout/System/VistaSystem.html +0 -251
data/doc/Sprout/System/WinNixSystem.html +0 -325
data/doc/Sprout/System/WinSystem.html +0 -571
data/doc/Sprout/TestHelper.html +0 -2165
data/doc/Sprout/ToolGenerator.html +0 -953
data/doc/Sprout/VERSION.html +0 -118
data/doc/String.html +0 -290
data/doc/_index.html +0 -820
data/doc/class_list.html +0 -36
data/doc/css/common.css +0 -1
data/doc/css/full_list.css +0 -53
data/doc/css/style.css +0 -310
data/doc/file.README.html +0 -96
data/doc/file_list.html +0 -41
data/doc/frames.html +0 -13
data/doc/index.html +0 -96
data/doc/js/app.js +0 -202
data/doc/js/full_list.js +0 -149
data/doc/js/jquery.js +0 -154
data/doc/method_list.html +0 -3603
data/doc/top-level-namespace.html +0 -192
data/test/fixtures/library/archive/Archive.swc +0 -0

@@ -1,191 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-  <head>
-    <meta name="Content-Type" content="text/html; charset=utf-8" />
-<title>Module: Sprout::System</title>
-<link rel="stylesheet" href="../css/style.css" type="text/css" media="screen" charset="utf-8" />
-<link rel="stylesheet" href="../css/common.css" type="text/css" media="screen" charset="utf-8" />
-<script type="text/javascript" charset="utf-8">
-  relpath = '..';
-  if (relpath != '') relpath += '/';
-</script>
-<script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
-<script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
-  </head>
-  <body>
-    <script type="text/javascript" charset="utf-8">
-      if (window.top.frames.main) document.body.className = 'frames';
-    </script>
-    <div id="header">
-      <div id="menu">
-    <a href="../_index.html">Index (S)</a> &raquo;
-    <span class='title'><span class='object_link'><a href="../Sprout.html" title="Sprout (module)">Sprout</a></span></span>
-     &raquo;
-    <span class="title">System</span>
-  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
-</div>
-      <div id="search">
-  <a id="class_list_link" href="#">Class List</a>
-  <a id="method_list_link" href="#">Method List</a>
-  <a id ="file_list_link" href="#">File List</a>
-</div>
-      <div class="clear"></div>
-    </div>
-    <iframe id="search_frame"></iframe>
-    <div id="content"><h1>Module: Sprout::System
-</h1>
-<dl class="box">
-    <dt class="r1 last">Defined in:</dt>
-    <dd class="r1 last">lib/sprout/system.rb<span class="defines">,<br />
-  lib/sprout/system/win_system.rb,<br /> lib/sprout/system/osx_system.rb,<br /> lib/sprout/system/unix_system.rb,<br /> lib/sprout/system/base_system.rb,<br /> lib/sprout/system/java_system.rb,<br /> lib/sprout/system/vista_system.rb,<br /> lib/sprout/system/win_nix_system.rb</span>
-</dd>
-</dl>
-<div class="clear"></div>
-<h2>Defined Under Namespace</h2>
-<p class="children">
-      <strong class="classes">Classes:</strong> <span class='object_link'><a href="System/BaseSystem.html" title="Sprout::System::BaseSystem (class)">BaseSystem</a></span>, <span class='object_link'><a href="System/JavaSystem.html" title="Sprout::System::JavaSystem (class)">JavaSystem</a></span>, <span class='object_link'><a href="System/OSXSystem.html" title="Sprout::System::OSXSystem (class)">OSXSystem</a></span>, <span class='object_link'><a href="System/ThreadMock.html" title="Sprout::System::ThreadMock (class)">ThreadMock</a></span>, <span class='object_link'><a href="System/UnixSystem.html" title="Sprout::System::UnixSystem (class)">UnixSystem</a></span>, <span class='object_link'><a href="System/VistaSystem.html" title="Sprout::System::VistaSystem (class)">VistaSystem</a></span>, <span class='object_link'><a href="System/WinNixSystem.html" title="Sprout::System::WinNixSystem (class)">WinNixSystem</a></span>, <span class='object_link'><a href="System/WinSystem.html" title="Sprout::System::WinSystem (class)">WinSystem</a></span>
-</p>
-    <h2>
-      Class Method Summary
-      <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
-    </h2>
-    <ul class="summary">
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#create-class_method" title="create (class method)">+ (Object) <strong>create</strong> </a>
-  </span>
-    <span class="summary_desc"><div class='inline'>
-<p>This is the factory that one should generally be used to create new,
-concrete System objects.</p>
-</div></span>
-</li>
-    </ul>
-  <div id="class_method_details" class="method_details_list">
-    <h2>Class Method Details</h2>
-      <div class="method_details first">
-  <p class="signature first" id="create-class_method">
-    + (<tt>Object</tt>) <strong>create</strong>
-</p><div class="docstring">
-  <div class="discussion">
-<p>This is the factory that one should generally be used to create new,
-concrete System objects.</p>
-<p>A typical example follows:</p>
-<pre class="code"><span class='id system'>system</span> <span class='op'>=</span> <span class='const'>System</span><span class='period'>.</span><span class='id create'>create</span>
-<span class='const'>Dir</span><span class='period'>.</span><span class='id chdir'>chdir</span> <span class='id system'>system</span><span class='period'>.</span><span class='id home'>home</span>
-<span class='id system'>system</span><span class='period'>.</span><span class='id execute'>execute</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>pwd</span><span class='tstring_end'>&quot;</span></span> <span class='comment'># /home/yourusername</span></pre>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-23
-24
-25
-26
-27
-28
-29
-30
-31</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system.rb', line 23</span>
-<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id create'>create</span>
-  <span class='id p'>p</span> <span class='op'>=</span> <span class='const'>Sprout</span><span class='op'>::</span><span class='const'>Platform</span><span class='period'>.</span><span class='id new'>new</span>
-  <span class='kw'>return</span> <span class='const'>VistaSystem</span><span class='period'>.</span><span class='id new'>new</span>  <span class='kw'>if</span> <span class='id p'>p</span><span class='period'>.</span><span class='id vista?'>vista?</span>
-  <span class='kw'>return</span> <span class='const'>WinNixSystem</span><span class='period'>.</span><span class='id new'>new</span> <span class='kw'>if</span> <span class='id p'>p</span><span class='period'>.</span><span class='id windows_nix?'>windows_nix?</span>
-  <span class='kw'>return</span> <span class='const'>WinSystem</span><span class='period'>.</span><span class='id new'>new</span>    <span class='kw'>if</span> <span class='id p'>p</span><span class='period'>.</span><span class='id windows?'>windows?</span>
-  <span class='kw'>return</span> <span class='const'>JavaSystem</span><span class='period'>.</span><span class='id new'>new</span>   <span class='kw'>if</span> <span class='id p'>p</span><span class='period'>.</span><span class='id java?'>java?</span>
-  <span class='kw'>return</span> <span class='const'>OSXSystem</span><span class='period'>.</span><span class='id new'>new</span>    <span class='kw'>if</span> <span class='id p'>p</span><span class='period'>.</span><span class='id mac?'>mac?</span>
-  <span class='kw'>return</span> <span class='const'>UnixSystem</span><span class='period'>.</span><span class='id new'>new</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-  </div>
-</div>
-    <div id="footer">
-  Generated on Fri Apr 29 18:33:05 2011 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.6.3 (ruby-1.9.2).
-</div>
-  </body>
-</html>

data/doc/Sprout/System/BaseSystem.html DELETED

@@ -1,1660 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-  <head>
-    <meta name="Content-Type" content="text/html; charset=utf-8" />
-<title>Class: Sprout::System::BaseSystem</title>
-<link rel="stylesheet" href="../../css/style.css" type="text/css" media="screen" charset="utf-8" />
-<link rel="stylesheet" href="../../css/common.css" type="text/css" media="screen" charset="utf-8" />
-<script type="text/javascript" charset="utf-8">
-  relpath = '../..';
-  if (relpath != '') relpath += '/';
-</script>
-<script type="text/javascript" charset="utf-8" src="../../js/jquery.js"></script>
-<script type="text/javascript" charset="utf-8" src="../../js/app.js"></script>
-  </head>
-  <body>
-    <script type="text/javascript" charset="utf-8">
-      if (window.top.frames.main) document.body.className = 'frames';
-    </script>
-    <div id="header">
-      <div id="menu">
-    <a href="../../_index.html">Index (B)</a> &raquo;
-    <span class='title'><span class='object_link'><a href="../../Sprout.html" title="Sprout (module)">Sprout</a></span></span> &raquo; <span class='title'><span class='object_link'><a href="../System.html" title="Sprout::System (module)">System</a></span></span>
-     &raquo;
-    <span class="title">BaseSystem</span>
-  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
-</div>
-      <div id="search">
-  <a id="class_list_link" href="#">Class List</a>
-  <a id="method_list_link" href="#">Method List</a>
-  <a id ="file_list_link" href="#">File List</a>
-</div>
-      <div class="clear"></div>
-    </div>
-    <iframe id="search_frame"></iframe>
-    <div id="content"><h1>Class: Sprout::System::BaseSystem
-</h1>
-<dl class="box">
-    <dt class="r1">Inherits:</dt>
-    <dd class="r1">
-      <span class="inheritName">Object</span>
-        <ul class="fullTree">
-          <li>Object</li>
-            <li class="next">Sprout::System::BaseSystem</li>
-        </ul>
-        <a href="#" class="inheritanceTree">show all</a>
-      </dd>
-    <dt class="r2 last">Defined in:</dt>
-    <dd class="r2 last">lib/sprout/system/base_system.rb</dd>
-</dl>
-<div class="clear"></div>
-<h2>Overview</h2><div class="docstring">
-  <div class="discussion">
-<p>The abstract base class for all supported system/platform types. In
-general, users are created by calling the <tt>create</tt> factory method on
-the <tt>System</tt> module.</p>
-<pre class="code"><span class='const'>System</span><span class='period'>.</span><span class='id create'>create</span></pre>
-<p>Assuming you call the create method, you should wind up with a concrete
-system that matches your system, and these concrete users will generally be
-derived from this base class.</p>
-  </div>
-</div>
-<div class="tags">
-</div><div id="subclasses">
-  <h2>Direct Known Subclasses</h2>
-  <p class="children"><span class='object_link'><a href="JavaSystem.html" title="Sprout::System::JavaSystem (class)">JavaSystem</a></span>, <span class='object_link'><a href="UnixSystem.html" title="Sprout::System::UnixSystem (class)">UnixSystem</a></span>, <span class='object_link'><a href="WinSystem.html" title="Sprout::System::WinSystem (class)">WinSystem</a></span></p>
-</div>
-    <h2>
-      Instance Method Summary
-      <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
-    </h2>
-    <ul class="summary">
-        <li class="protected ">
-  <span class="summary_signature">
-      <a href="#alt_separator%3F-instance_method" title="#alt_separator? (instance method)">- (Boolean) <strong>alt_separator?</strong> </a>
-  </span>
-  <span class="note title protected">protected</span>
-    <span class="summary_desc"><div class='inline'></div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#application_home-instance_method" title="#application_home (instance method)">- (Object) <strong>application_home</strong>(name) </a>
-  </span>
-    <span class="summary_desc"><div class='inline'>
-<p>Different operating systems will store Application data different default
-locations.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#can_execute%3F-instance_method" title="#can_execute? (instance method)">- (Boolean) <strong>can_execute?</strong>(platform) </a>
-  </span>
-    <span class="summary_desc"><div class='inline'></div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#clean_path-instance_method" title="#clean_path (instance method)">- (Object) <strong>clean_path</strong>(path) </a>
-  </span>
-    <span class="summary_desc"><div class='inline'>
-<p>Clean the provided <tt>path</tt> String for the current operating system.</p>
-</div></span>
-</li>
-        <li class="protected ">
-  <span class="summary_signature">
-      <a href="#env_home-instance_method" title="#env_home (instance method)">- (Object) <strong>env_home</strong> </a>
-  </span>
-  <span class="note title protected">protected</span>
-    <span class="summary_desc"><div class='inline'></div></span>
-</li>
-        <li class="protected ">
-  <span class="summary_signature">
-      <a href="#env_homedrive-instance_method" title="#env_homedrive (instance method)">- (Object) <strong>env_homedrive</strong> </a>
-  </span>
-  <span class="note title protected">protected</span>
-    <span class="summary_desc"><div class='inline'></div></span>
-</li>
-        <li class="protected ">
-  <span class="summary_signature">
-      <a href="#env_homedrive_and_homepath-instance_method" title="#env_homedrive_and_homepath (instance method)">- (Object) <strong>env_homedrive_and_homepath</strong> </a>
-  </span>
-  <span class="note title protected">protected</span>
-    <span class="summary_desc"><div class='inline'></div></span>
-</li>
-        <li class="protected ">
-  <span class="summary_signature">
-      <a href="#env_homepath-instance_method" title="#env_homepath (instance method)">- (Object) <strong>env_homepath</strong> </a>
-  </span>
-  <span class="note title protected">protected</span>
-    <span class="summary_desc"><div class='inline'></div></span>
-</li>
-        <li class="protected ">
-  <span class="summary_signature">
-      <a href="#env_userprofile-instance_method" title="#env_userprofile (instance method)">- (Object) <strong>env_userprofile</strong> </a>
-  </span>
-  <span class="note title protected">protected</span>
-    <span class="summary_desc"><div class='inline'></div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#execute-instance_method" title="#execute (instance method)">- (Object) <strong>execute</strong>(tool, options = '') </a>
-  </span>
-    <span class="summary_desc"><div class='inline'>
-<p>Creates a new process, executes the command and returns whatever the
-process wrote to stdout, or stderr.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#execute_silent-instance_method" title="#execute_silent (instance method)">- (Object) <strong>execute_silent</strong>(tool, options = '') </a>
-  </span>
-    <span class="summary_desc"><div class='inline'>
-<p>Creates and returns the process without attempting to read or write to the
-stream.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#execute_thread-instance_method" title="#execute_thread (instance method)">- (Sprout::ProcessRunner) <strong>execute_thread</strong>(tool, options = '', prompt = nil) {|String| ... }</a>
-  </span>
-    <span class="summary_desc"><div class='inline'>
-<p>Execute a new process in a separate thread and yield whatever output is
-written to its stderr and stdout.</p>
-</div></span>
-</li>
-        <li class="protected ">
-  <span class="summary_signature">
-      <a href="#find_home-instance_method" title="#find_home (instance method)">- (Object) <strong>find_home</strong> </a>
-  </span>
-  <span class="note title protected">protected</span>
-    <span class="summary_desc"><div class='inline'></div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#format_application_name-instance_method" title="#format_application_name (instance method)">- (Object) <strong>format_application_name</strong>(name) </a>
-  </span>
-    <span class="summary_desc"><div class='inline'>
-<p>Template method that should be overridden by subclasses.</p>
-</div></span>
-</li>
-        <li class="protected ">
-  <span class="summary_signature">
-      <a href="#get_and_execute_process_runner-instance_method" title="#get_and_execute_process_runner (instance method)">- (Object) <strong>get_and_execute_process_runner</strong>(tool, options = nil) </a>
-  </span>
-  <span class="note title protected">protected</span>
-    <span class="summary_desc"><div class='inline'>
-<p>Get a process runner and execute the provided <tt>executable</tt>, with the
-provided <tt>options</tt>.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#get_process_runner-instance_method" title="#get_process_runner (instance method)">- (Object) <strong>get_process_runner</strong> </a>
-  </span>
-    <span class="summary_desc"><div class='inline'>
-<p>Instantiate and return a new Sprout::ProcessRunner so that we can execute
-it.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#home-instance_method" title="#home (instance method)">- (Object) <strong>home</strong> </a>
-  </span>
-    <span class="summary_desc"><div class='inline'>
-<p>Get the home path for a system on a particular operating system.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#home%3D-instance_method" title="#home= (instance method)">- (Object) <strong>home=</strong>(home) </a>
-  </span>
-    <span class="summary_desc"><div class='inline'>
-<p>Set the home path for a system on a particular operating system.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#library-instance_method" title="#library (instance method)">- (Object) <strong>library</strong> </a>
-  </span>
-    <span class="summary_desc"><div class='inline'>
-<p>Some operating systems (like OS X and Windows) have a  specific location
-where applications are expected to store files for a particular system.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#read_from-instance_method" title="#read_from (instance method)">- (Object) <strong>read_from</strong>(pipe, prompt, &amp;block) </a>
-  </span>
-    <span class="summary_desc"><div class='inline'></div></span>
-</li>
-        <li class="protected ">
-  <span class="summary_signature">
-      <a href="#tilde_home-instance_method" title="#tilde_home (instance method)">- (Object) <strong>tilde_home</strong> </a>
-  </span>
-  <span class="note title protected">protected</span>
-    <span class="summary_desc"><div class='inline'></div></span>
-</li>
-        <li class="protected ">
-  <span class="summary_signature">
-      <a href="#worst_case_home-instance_method" title="#worst_case_home (instance method)">- (Object) <strong>worst_case_home</strong> </a>
-  </span>
-  <span class="note title protected">protected</span>
-    <span class="summary_desc"><div class='inline'></div></span>
-</li>
-    </ul>
-  <div id="instance_method_details" class="method_details_list">
-    <h2>Instance Method Details</h2>
-      <div class="method_details first">
-  <p class="signature first" id="alt_separator?-instance_method">
-    - (<tt>Boolean</tt>) <strong>alt_separator?</strong>  <span class="extras">(protected)</span>
-</p><div class="docstring">
-  <div class="discussion">
-  </div>
-</div>
-<div class="tags">
-  <h3>Returns:</h3>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-223
-224
-225</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 223</span>
-<span class='kw'>def</span> <span class='id alt_separator?'>alt_separator?</span>
-  <span class='const'>File</span><span class='op'>::</span><span class='const'>ALT_SEPARATOR</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="application_home-instance_method">
-    - (<tt>Object</tt>) <strong>application_home</strong>(name)
-</p><div class="docstring">
-  <div class="discussion">
-<p>Different operating systems will store Application data different default
-locations.</p>
-<p>Subclasses will generally override this method and  return the appropriate
-location for their operating system.</p>
-<p><tt>name</tt> String value of the Application name for which we'd like to
-store data.</p>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-183
-184
-185</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 183</span>
-<span class='kw'>def</span> <span class='id application_home'>application_home</span><span class='lparen'>(</span><span class='id name'>name</span><span class='rparen'>)</span>
-  <span class='kw'>return</span> <span class='const'>File</span><span class='period'>.</span><span class='id join'>join</span><span class='lparen'>(</span><span class='id library'>library</span><span class='comma'>,</span> <span class='id format_application_name'>format_application_name</span><span class='lparen'>(</span><span class='id name'>name</span><span class='period'>.</span><span class='id to_s'>to_s</span><span class='rparen'>)</span><span class='rparen'>)</span><span class='semicolon'>;</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="can_execute?-instance_method">
-    - (<tt>Boolean</tt>) <strong>can_execute?</strong>(platform)
-</p><div class="docstring">
-  <div class="discussion">
-  </div>
-</div>
-<div class="tags">
-  <h3>Returns:</h3>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-60
-61
-62</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 60</span>
-<span class='kw'>def</span> <span class='id can_execute?'>can_execute?</span> <span class='id platform'>platform</span>
-  <span class='id platform'>platform</span> <span class='op'>==</span> <span class='symbol'>:universal</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="clean_path-instance_method">
-    - (<tt>Object</tt>) <strong>clean_path</strong>(path)
-</p><div class="docstring">
-  <div class="discussion">
-<p>Clean the provided <tt>path</tt> String for the current operating system.</p>
-<p>Each operating system behaves differently when we attempt to execute a file
-with spaces in the <tt>path</tt> to the file.</p>
-<p>Subclasses will generally override this method and clean the path
-appropriately for their operating  system.</p>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-170
-171</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 170</span>
-<span class='kw'>def</span> <span class='id clean_path'>clean_path</span><span class='lparen'>(</span><span class='id path'>path</span><span class='rparen'>)</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="env_home-instance_method">
-    - (<tt>Object</tt>) <strong>env_home</strong>  <span class="extras">(protected)</span>
-</p><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-215
-216
-217</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 215</span>
-<span class='kw'>def</span> <span class='id env_home'>env_home</span>
-  <span class='const'>ENV</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>HOME</span><span class='tstring_end'>'</span></span><span class='rbracket'>]</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="env_homedrive-instance_method">
-    - (<tt>Object</tt>) <strong>env_homedrive</strong>  <span class="extras">(protected)</span>
-</p><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-197
-198
-199</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 197</span>
-<span class='kw'>def</span> <span class='id env_homedrive'>env_homedrive</span>
-  <span class='const'>ENV</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>HOMEDRIVE</span><span class='tstring_end'>'</span></span><span class='rbracket'>]</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="env_homedrive_and_homepath-instance_method">
-    - (<tt>Object</tt>) <strong>env_homedrive_and_homepath</strong>  <span class="extras">(protected)</span>
-</p><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-205
-206
-207
-208
-209</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 205</span>
-<span class='kw'>def</span> <span class='id env_homedrive_and_homepath'>env_homedrive_and_homepath</span>
-  <span class='id drive'>drive</span> <span class='op'>=</span> <span class='id env_homedrive'>env_homedrive</span>
-  <span class='id path'>path</span> <span class='op'>=</span> <span class='id env_homepath'>env_homepath</span>
-  <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id drive'>drive</span><span class='rbrace'>}</span><span class='tstring_content'>:</span><span class='embexpr_beg'>#{</span><span class='id path'>path</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id drive'>drive</span> <span class='op'>&amp;&amp;</span> <span class='id path'>path</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="env_homepath-instance_method">
-    - (<tt>Object</tt>) <strong>env_homepath</strong>  <span class="extras">(protected)</span>
-</p><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-201
-202
-203</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 201</span>
-<span class='kw'>def</span> <span class='id env_homepath'>env_homepath</span>
-  <span class='const'>ENV</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>HOMEPATH</span><span class='tstring_end'>'</span></span><span class='rbracket'>]</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="env_userprofile-instance_method">
-    - (<tt>Object</tt>) <strong>env_userprofile</strong>  <span class="extras">(protected)</span>
-</p><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-211
-212
-213</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 211</span>
-<span class='kw'>def</span> <span class='id env_userprofile'>env_userprofile</span>
-  <span class='const'>ENV</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>USERPROFILE</span><span class='tstring_end'>'</span></span><span class='rbracket'>]</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="execute-instance_method">
-    - (<tt>Object</tt>) <strong>execute</strong>(tool, options = '')
-</p><div class="docstring">
-  <div class="discussion">
-<p>Creates a new process, executes the command and returns whatever the
-process wrote to stdout, or stderr.</p>
-<p>Raises a <tt>Sprout::Errors::ExecutionError</tt> if the process writes to stderr</p>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-70
-71
-72
-73
-74
-75
-76
-77
-78
-79
-80
-81
-82
-83
-84
-85</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 70</span>
-<span class='kw'>def</span> <span class='id execute'>execute</span><span class='lparen'>(</span><span class='id tool'>tool</span><span class='comma'>,</span> <span class='id options'>options</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>
-  <span class='const'>Sprout</span><span class='period'>.</span><span class='id stdout'>stdout</span><span class='period'>.</span><span class='id puts'>puts</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id tool'>tool</span><span class='rbrace'>}</span><span class='tstring_content'> </span><span class='embexpr_beg'>#{</span><span class='id options'>options</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
-  <span class='id runner'>runner</span> <span class='op'>=</span> <span class='id get_and_execute_process_runner'>get_and_execute_process_runner</span><span class='lparen'>(</span><span class='id tool'>tool</span><span class='comma'>,</span> <span class='id options'>options</span><span class='rparen'>)</span>
-  <span class='id error'>error</span>  <span class='op'>=</span> <span class='id runner'>runner</span><span class='period'>.</span><span class='id read_err'>read_err</span>
-  <span class='id result'>result</span> <span class='op'>=</span> <span class='id runner'>runner</span><span class='period'>.</span><span class='id read'>read</span>
-  <span class='kw'>if</span><span class='lparen'>(</span><span class='id result'>result</span><span class='period'>.</span><span class='id size'>size</span> <span class='op'>&gt;</span> <span class='int'>0</span><span class='rparen'>)</span>
-    <span class='const'>Sprout</span><span class='period'>.</span><span class='id stdout'>stdout</span><span class='period'>.</span><span class='id puts'>puts</span> <span class='id result'>result</span>
-  <span class='kw'>end</span>
-  <span class='kw'>if</span><span class='lparen'>(</span><span class='id error'>error</span><span class='period'>.</span><span class='id size'>size</span> <span class='op'>&gt;</span> <span class='int'>0</span><span class='rparen'>)</span>
-    <span class='id raise'>raise</span> <span class='const'>Sprout</span><span class='op'>::</span><span class='const'>Errors</span><span class='op'>::</span><span class='const'>ExecutionError</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>[ERROR] </span><span class='embexpr_beg'>#{</span><span class='id error'>error</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
-  <span class='kw'>end</span>
-  <span class='id result'>result</span> <span class='op'>||</span> <span class='id error'>error</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="execute_silent-instance_method">
-    - (<tt>Object</tt>) <strong>execute_silent</strong>(tool, options = '')
-</p><div class="docstring">
-  <div class="discussion">
-<p>Creates and returns the process without attempting to read or write to the
-stream. This is useful for interacting with long-lived CLI processes like
-FCSH or FDB.</p>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-93
-94
-95</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 93</span>
-<span class='kw'>def</span> <span class='id execute_silent'>execute_silent</span><span class='lparen'>(</span><span class='id tool'>tool</span><span class='comma'>,</span> <span class='id options'>options</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>
-  <span class='id get_and_execute_process_runner'>get_and_execute_process_runner</span><span class='lparen'>(</span><span class='id tool'>tool</span><span class='comma'>,</span> <span class='id options'>options</span><span class='rparen'>)</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="execute_thread-instance_method">
-    - (<tt><span class='object_link'><a href="../ProcessRunner.html" title="Sprout::ProcessRunner (class)">Sprout::ProcessRunner</a></span></tt>) <strong>execute_thread</strong>(tool, options = '', prompt = nil) {|String| ... }
-</p><div class="docstring">
-  <div class="discussion">
-<p>Execute a new process in a separate thread and yield whatever output is
-written to its stderr and stdout.</p>
-  </div>
-</div>
-<div class="tags">
-  <h3>Parameters:</h3>
-<ul class="param">
-    <li>
-        <span class='type'>(<tt>File</tt>)</span>
-        <span class='name'>tool</span>
-        &mdash;
-        <div class='inline'>
-<p>Path to the executable.</p>
-</div>
-    </li>
-    <li>
-        <span class='type'>(<tt><span class='object_link'><a href="../../String.html" title="String (class)">String</a></span></tt>)</span>
-        <span class='name'>options</span>
-        <em class="default">(defaults to: <tt>''</tt>)</em>
-        &mdash;
-        <div class='inline'>
-<p>The command line options that the executable accepts.</p>
-</div>
-    </li>
-    <li>
-        <span class='type'>(<tt>Regex</tt>)</span>
-        <span class='name'>prompt</span>
-        <em class="default">(defaults to: <tt>nil</tt>)</em>
-        &mdash;
-        <div class='inline'>
-<p>The prompt that will trigger the listener block to be called.</p>
-</div>
-    </li>
-</ul>
-<h3>Yields:</h3>
-<ul class="yield">
-    <li>
-        <span class='type'>(<tt><span class='object_link'><a href="../../String.html" title="String (class)">String</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'>
-<p>Message that was received from the process, called when #prompt is
-encountered.</p>
-</div>
-    </li>
-</ul>
-<h3>Returns:</h3>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt><span class='object_link'><a href="../ProcessRunner.html" title="Sprout::ProcessRunner (class)">Sprout::ProcessRunner</a></span></tt>)</span>
-    </li>
-</ul>
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-107
-108
-109
-110
-111
-112
-113
-114
-115
-116
-117
-118
-119
-120
-121
-122
-123
-124
-125
-126
-127
-128
-129</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 107</span>
-<span class='kw'>def</span> <span class='id execute_thread'>execute_thread</span> <span class='id tool'>tool</span><span class='comma'>,</span> <span class='id options'>options</span><span class='op'>=</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='id prompt'>prompt</span><span class='op'>=</span><span class='kw'>nil</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id block'>block</span>
-  <span class='id t'>t</span> <span class='op'>=</span> <span class='const'>Thread</span><span class='period'>.</span><span class='id new'>new</span> <span class='kw'>do</span>
-    <span class='const'>Thread</span><span class='period'>.</span><span class='id current'>current</span><span class='period'>.</span><span class='id abort_on_exception'>abort_on_exception</span> <span class='op'>=</span> <span class='kw'>true</span>
-    <span class='id runner'>runner</span> <span class='op'>=</span> <span class='id execute_silent'>execute_silent</span><span class='lparen'>(</span><span class='id tool'>tool</span><span class='comma'>,</span> <span class='id options'>options</span><span class='rparen'>)</span>
-    <span class='const'>Thread</span><span class='period'>.</span><span class='id current'>current</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>runner</span><span class='tstring_end'>'</span></span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id runner'>runner</span>
-    <span class='id out'>out</span> <span class='op'>=</span> <span class='id read_from'>read_from</span> <span class='id runner'>runner</span><span class='period'>.</span><span class='id r'>r</span><span class='comma'>,</span> <span class='id prompt'>prompt</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id block'>block</span>
-    <span class='id err'>err</span> <span class='op'>=</span> <span class='id read_from'>read_from</span> <span class='id runner'>runner</span><span class='period'>.</span><span class='id e'>e</span><span class='comma'>,</span> <span class='id prompt'>prompt</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id block'>block</span>
-    <span class='id out'>out</span><span class='period'>.</span><span class='id join'>join</span> <span class='op'>&amp;&amp;</span> <span class='id err'>err</span><span class='period'>.</span><span class='id kill'>kill</span>
-  <span class='kw'>end</span>
-  <span class='comment'># Wait for the runner to be created
-</span>  <span class='comment'># before returning a nil reference
-</span>  <span class='comment'># that never gets populated...
-</span>  <span class='kw'>while</span> <span class='id t'>t</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>runner</span><span class='tstring_end'>'</span></span><span class='rbracket'>]</span><span class='period'>.</span><span class='id nil?'>nil?</span> <span class='kw'>do</span>
-    <span class='id sleep'>sleep</span><span class='lparen'>(</span><span class='float'>0.1</span><span class='rparen'>)</span>
-  <span class='kw'>end</span>
-  <span class='kw'>if</span> <span class='op'>!</span><span class='id t'>t</span><span class='period'>.</span><span class='id alive?'>alive?</span>
-    <span class='id raise'>raise</span> <span class='const'>Sprout</span><span class='op'>::</span><span class='const'>Errors</span><span class='op'>::</span><span class='const'>UsageError</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='id t'>t</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>runner</span><span class='tstring_end'>'</span></span><span class='rbracket'>]</span><span class='period'>.</span><span class='id read_err'>read_err</span><span class='rparen'>)</span>
-  <span class='kw'>end</span>
-  <span class='id t'>t</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="find_home-instance_method">
-    - (<tt>Object</tt>) <strong>find_home</strong>  <span class="extras">(protected)</span>
-</p><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-232
-233
-234
-235
-236
-237
-238
-239
-240
-241
-242
-243</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 232</span>
-<span class='kw'>def</span> <span class='id find_home'>find_home</span>
-  <span class='lbracket'>[</span><span class='symbol'>:env_userprofile</span><span class='comma'>,</span> <span class='symbol'>:env_home</span><span class='comma'>,</span> <span class='symbol'>:env_homedrive_and_homepath</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id key'>key</span><span class='op'>|</span>
-    <span class='id value'>value</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id send'>send</span><span class='lparen'>(</span><span class='id key'>key</span><span class='rparen'>)</span>
-    <span class='kw'>return</span> <span class='id value'>value</span> <span class='kw'>unless</span> <span class='id value'>value</span><span class='period'>.</span><span class='id nil?'>nil?</span>
-  <span class='kw'>end</span>
-  <span class='kw'>begin</span>
-    <span class='kw'>return</span> <span class='id tilde_home'>tilde_home</span>
-  <span class='kw'>rescue</span> <span class='const'>StandardError</span>
-    <span class='id worst_case_home'>worst_case_home</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="format_application_name-instance_method">
-    - (<tt>Object</tt>) <strong>format_application_name</strong>(name)
-</p><div class="docstring">
-  <div class="discussion">
-<p>Template method that should be overridden by subclasses.</p>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-191
-192
-193</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 191</span>
-<span class='kw'>def</span> <span class='id format_application_name'>format_application_name</span><span class='lparen'>(</span><span class='id name'>name</span><span class='rparen'>)</span>
-  <span class='id name'>name</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="get_and_execute_process_runner-instance_method">
-    - (<tt>Object</tt>) <strong>get_and_execute_process_runner</strong>(tool, options = nil)  <span class="extras">(protected)</span>
-</p><div class="docstring">
-  <div class="discussion">
-<p>Get a process runner and execute the provided <tt>executable</tt>, with the
-provided <tt>options</tt>.</p>
-<p><tt>executable</tt> String path to the external executable file.</p>
-<p><tt>options</tt> String commandline options to send to the
-<tt>executable</tt>.</p>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-255
-256
-257
-258
-259</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 255</span>
-<span class='kw'>def</span> <span class='id get_and_execute_process_runner'>get_and_execute_process_runner</span> <span class='id tool'>tool</span><span class='comma'>,</span> <span class='id options'>options</span><span class='op'>=</span><span class='kw'>nil</span>
-  <span class='id runner'>runner</span> <span class='op'>=</span> <span class='id get_process_runner'>get_process_runner</span>
-  <span class='id runner'>runner</span><span class='period'>.</span><span class='id execute_open4'>execute_open4</span> <span class='id clean_path'>clean_path</span><span class='lparen'>(</span><span class='id tool'>tool</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id options'>options</span>
-  <span class='id runner'>runner</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="get_process_runner-instance_method">
-    - (<tt>Object</tt>) <strong>get_process_runner</strong>
-</p><div class="docstring">
-  <div class="discussion">
-<p>Instantiate and return a new Sprout::ProcessRunner so that we can execute
-it.</p>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-56
-57
-58</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 56</span>
-<span class='kw'>def</span> <span class='id get_process_runner'>get_process_runner</span>
-  <span class='const'>Sprout</span><span class='op'>::</span><span class='const'>ProcessRunner</span><span class='period'>.</span><span class='id new'>new</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="home-instance_method">
-    - (<tt>Object</tt>) <strong>home</strong>
-</p><div class="docstring">
-  <div class="discussion">
-<p>Get the home path for a system on a particular operating system.</p>
-<p>This path will be different, depending on which system owns the curren
-process, and which operating system they are on.</p>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-22
-23
-24</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 22</span>
-<span class='kw'>def</span> <span class='id home'>home</span>
-  <span class='ivar'>@home</span> <span class='op'>||=</span> <span class='id find_home'>find_home</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="home=-instance_method">
-    - (<tt>Object</tt>) <strong>home=</strong>(home)
-</p><div class="docstring">
-  <div class="discussion">
-<p>Set the home path for a system on a particular operating system.</p>
-<p>If you request the home path before setting it, we will attempt to
-determine the home path of the current system for the current operating
-system.</p>
-<p>This is just a simple way to override the default behavior.</p>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-35
-36
-37</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 35</span>
-<span class='kw'>def</span> <span class='id home='>home=</span><span class='lparen'>(</span><span class='id home'>home</span><span class='rparen'>)</span>
-  <span class='ivar'>@home</span> <span class='op'>=</span> <span class='id home'>home</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="library-instance_method">
-    - (<tt>Object</tt>) <strong>library</strong>
-</p><div class="docstring">
-  <div class="discussion">
-<p>Some operating systems (like OS X and Windows) have a  specific location
-where applications are expected to store files for a particular system.
-This location is generally a subdirectory of <tt>home</tt>.</p>
-<p>The value of this location will usually be overridden in concrete System
-classes.</p>
-  </div>
-</div>
-<div class="tags">
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-48
-49
-50</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 48</span>
-<span class='kw'>def</span> <span class='id library'>library</span>
-  <span class='kw'>return</span> <span class='id home'>home</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="read_from-instance_method">
-    - (<tt>Object</tt>) <strong>read_from</strong>(pipe, prompt, &amp;block)
-</p><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-131
-132
-133
-134
-135
-136
-137
-138
-139
-140
-141
-142
-143
-144
-145
-146
-147
-148
-149
-150
-151
-152
-153
-154
-155
-156</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 131</span>
-<span class='kw'>def</span> <span class='id read_from'>read_from</span> <span class='id pipe'>pipe</span><span class='comma'>,</span> <span class='id prompt'>prompt</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id block'>block</span>
-  <span class='const'>Thread</span><span class='period'>.</span><span class='id new'>new</span> <span class='kw'>do</span>
-    <span class='const'>Thread</span><span class='period'>.</span><span class='id current'>current</span><span class='period'>.</span><span class='id abort_on_exception'>abort_on_exception</span> <span class='op'>=</span> <span class='kw'>true</span>
-    <span class='id lines'>lines</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_end'>'</span></span>
-    <span class='id line'>line</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_end'>'</span></span>
-    <span class='id pipe'>pipe</span><span class='period'>.</span><span class='id sync'>sync</span> <span class='op'>=</span> <span class='kw'>true</span>
-    <span class='id pipe'>pipe</span><span class='period'>.</span><span class='id each_char'>each_char</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id char'>char</span><span class='op'>|</span>
-      <span class='kw'>break</span> <span class='kw'>if</span> <span class='id pipe'>pipe</span><span class='period'>.</span><span class='id closed?'>closed?</span>
-      <span class='id line'>line</span> <span class='op'>&lt;&lt;</span> <span class='id char'>char</span>
-      <span class='kw'>if</span> <span class='id line'>line</span><span class='period'>.</span><span class='id match'>match</span> <span class='id prompt'>prompt</span>
-        <span class='kw'>yield</span> <span class='id line'>line</span> <span class='kw'>if</span> <span class='id block_given?'>block_given?</span>
-        <span class='id lines'>lines</span> <span class='op'>&lt;&lt;</span> <span class='id line'>line</span>
-        <span class='id lines'>lines</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_end'>'</span></span>
-        <span class='id line'>line</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_end'>'</span></span>
-        <span class='kw'>next</span>
-      <span class='kw'>end</span>
-      <span class='kw'>if</span> <span class='id char'>char</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span>
-        <span class='id lines'>lines</span> <span class='op'>&lt;&lt;</span> <span class='id line'>line</span>
-        <span class='kw'>yield</span> <span class='id line'>line</span> <span class='kw'>if</span> <span class='id block_given?'>block_given?</span>
-        <span class='id line'>line</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_end'>'</span></span>
-      <span class='kw'>end</span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="tilde_home-instance_method">
-    - (<tt>Object</tt>) <strong>tilde_home</strong>  <span class="extras">(protected)</span>
-</p><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-219
-220
-221</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 219</span>
-<span class='kw'>def</span> <span class='id tilde_home'>tilde_home</span>
-  <span class='const'>File</span><span class='period'>.</span><span class='id expand_path'>expand_path</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>~</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-      <div class="method_details ">
-  <p class="signature " id="worst_case_home-instance_method">
-    - (<tt>Object</tt>) <strong>worst_case_home</strong>  <span class="extras">(protected)</span>
-</p><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-227
-228
-229
-230</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/sprout/system/base_system.rb', line 227</span>
-<span class='kw'>def</span> <span class='id worst_case_home'>worst_case_home</span>
-  <span class='kw'>return</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>C:\\</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id alt_separator?'>alt_separator?</span>
-  <span class='kw'>return</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/</span><span class='tstring_end'>&quot;</span></span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-  </div>
-</div>
-    <div id="footer">
-  Generated on Fri Apr 29 18:33:08 2011 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.6.3 (ruby-1.9.2).
-</div>
-  </body>
-</html>