RubyGems - sprout - Versions diffs - 1.0.35.pre → 1.1.2.pre - Mend

sprout 1.0.35.pre → 1.1.2.pre

Potentially problematic release.

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

Files changed (234) hide show

data/Gemfile +1 -1
data/Gemfile.lock +0 -2
data/README.textile +1 -1
data/VERSION +1 -1
data/lib/sprout/concern.rb +5 -7
data/lib/sprout/daemon.rb +183 -143
data/lib/sprout/executable/base.rb +564 -0
data/lib/sprout/executable.rb +1 -550
data/lib/sprout/generator/base.rb +2 -3
data/lib/sprout/generator.rb +2 -1
data/lib/sprout/generators/ruby/templates/ruby_base.rb +1 -2
data/lib/sprout/library.rb +3 -3
data/lib/sprout/output_buffer.rb +35 -0
data/lib/sprout/process_runner.rb +68 -17
data/lib/sprout/progress_bar.rb +5 -5
data/lib/sprout/remote_file_target.rb +1 -1
data/lib/sprout/system/base_system.rb +3 -3
data/lib/sprout/system/unix_system.rb +1 -1
data/lib/sprout/{test/sprout_test_case.rb → test_helper.rb} +214 -14
data/lib/sprout/version.rb +1 -1
data/lib/sprout.rb +133 -2
data/rakefile.rb +2 -0
data/test/fixtures/examples/echo_inputs.rb +1 -2
data/test/fixtures/executable/fdb.rb +7 -9
data/test/fixtures/executable/flex3sdk_gem/fdb +49 -18
data/test/fixtures/executable/mxmlc.rb +1 -2
data/test/fixtures/executable/subclass/executable_subclass.rb +0 -1
data/test/fixtures/executable/subclass/executable_superclass.rb +1 -2
data/test/fixtures/specification/flex4sdk.rb +35 -24
data/test/unit/archive_unpacker_test.rb +1 -1
data/test/unit/boolean_param_test.rb +1 -1
data/test/unit/daemon_test.rb +35 -3
data/test/unit/executable_option_parser_test.rb +2 -3
data/test/unit/executable_param_test.rb +1 -1
data/test/unit/executable_test.rb +8 -15
data/test/unit/fake_other_executable.rb +1 -2
data/test/unit/file_param_test.rb +1 -1
data/test/unit/file_target_test.rb +1 -1
data/test/unit/files_param_test.rb +1 -1
data/test/unit/generator_generator_test.rb +1 -1
data/test/unit/generator_test.rb +1 -1
data/test/unit/library_generator_test.rb +1 -1
data/test/unit/library_test.rb +1 -1
data/test/unit/osx_system_test.rb +1 -1
data/test/unit/path_param_test.rb +1 -1
data/test/unit/paths_param_test.rb +1 -1
data/test/unit/platform_test.rb +1 -1
data/test/unit/process_runner_test.rb +1 -1
data/test/unit/rdoc_parser_test.rb +1 -1
data/test/unit/remote_file_loader_test.rb +1 -1
data/test/unit/remote_file_target_test.rb +1 -1
data/test/unit/ruby_feature_test.rb +1 -1
data/test/unit/ruby_generator_test.rb +1 -1
data/test/unit/specification_test.rb +8 -1
data/test/unit/sprout_test.rb +2 -2
data/test/unit/string_param_test.rb +1 -1
data/test/unit/string_test.rb +1 -1
data/test/unit/strings_param_test.rb +1 -1
data/test/unit/test_helper.rb +33 -1
data/test/unit/tool_generator_test.rb +1 -1
data/test/unit/unix_system_test.rb +1 -1
data/test/unit/user_test.rb +1 -1
data/test/unit/vista_system_test.rb +1 -1
data/test/unit/win_nix_system_test.rb +1 -1
data/test/unit/win_system_test.rb +1 -1
data/test-stderr.log +1 -0
data/test-stdout.log +237 -0
metadata +15 -190
data/doc/Dir.html +0 -288
data/doc/Rake/Task.html +0 -184
data/doc/Sprout/ArchiveUnpacker.html +0 -1246
data/doc/Sprout/Base/ClassMethods.html +0 -434
data/doc/Sprout/Base.html +0 -126
data/doc/Sprout/Concern.html +0 -353
data/doc/Sprout/Daemon/ClassMethods.html +0 -244
data/doc/Sprout/Daemon/InstanceMethods.html +0 -601
data/doc/Sprout/Daemon.html +0 -166
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/Errors.html +0 -101
data/doc/Sprout/Executable/Boolean.html +0 -483
data/doc/Sprout/Executable/ClassMethods.html +0 -417
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/InstanceMethods.html +0 -2006
data/doc/Sprout/Executable/Number.html +0 -141
data/doc/Sprout/Executable/Param.html +0 -2818
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/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/Executable.html +0 -173
data/doc/Sprout/FileTarget.html +0 -1109
data/doc/Sprout/Generator/Base.html +0 -1626
data/doc/Sprout/Generator/Command.html +0 -690
data/doc/Sprout/Generator/DirectoryManifest.html +0 -476
data/doc/Sprout/Generator/FileManifest.html +0 -572
data/doc/Sprout/Generator/Manifest.html +0 -377
data/doc/Sprout/Generator/TemplateManifest.html +0 -196
data/doc/Sprout/Generator.html +0 -689
data/doc/Sprout/GeneratorGenerator.html +0 -1018
data/doc/Sprout/Library.html +0 -1141
data/doc/Sprout/LibraryGenerator.html +0 -309
data/doc/Sprout/Log.html +0 -496
data/doc/Sprout/MXMLC.html +0 -6373
data/doc/Sprout/Platform.html +0 -714
data/doc/Sprout/ProcessRunner.html +0 -1352
data/doc/Sprout/ProgressBar.html +0 -376
data/doc/Sprout/ProgressBarImpl.html +0 -2119
data/doc/Sprout/ProgressBarManager.html +0 -434
data/doc/Sprout/ProgressBarOutputStream.html +0 -416
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 -194
data/doc/Sprout/RubyFeature/ClassMethods.html +0 -1065
data/doc/Sprout/RubyFeature.html +0 -155
data/doc/Sprout/RubyGenerator.html +0 -764
data/doc/Sprout/Specification.html +0 -767
data/doc/Sprout/System/BaseSystem.html +0 -1455
data/doc/Sprout/System/JavaSystem.html +0 -122
data/doc/Sprout/System/OSXSystem.html +0 -335
data/doc/Sprout/System/ThreadMock.html +0 -193
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/System.html +0 -191
data/doc/Sprout/ToolGenerator.html +0 -931
data/doc/Sprout/VERSION.html +0 -128
data/doc/Sprout.html +0 -144
data/doc/SproutTestCase.html +0 -1412
data/doc/String.html +0 -286
data/doc/_index.html +0 -1035
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.archive_unpacker.html +0 -288
data/doc/file.base.html +0 -208
data/doc/file.base_system.html +0 -278
data/doc/file.boolean.html +0 -135
data/doc/file.collection_param.html +0 -139
data/doc/file.command.html +0 -126
data/doc/file.concern.html +0 -136
data/doc/file.daemon.html +0 -309
data/doc/file.dir.html +0 -76
data/doc/file.directory_manifest.html +0 -122
data/doc/file.errors.html +0 -147
data/doc/file.executable.html +0 -638
data/doc/file.file_manifest.html +0 -109
data/doc/file.file_param.html +0 -120
data/doc/file.file_target.html +0 -140
data/doc/file.files.html +0 -85
data/doc/file.generator.html +0 -296
data/doc/file.generator_class.html +0 -72
data/doc/file.generator_generator.html +0 -137
data/doc/file.generator_test.html +0 -92
data/doc/file.generator_test_helper.html +0 -67
data/doc/file.java_system.html +0 -62
data/doc/file.library.html +0 -291
data/doc/file.library_generator.html +0 -74
data/doc/file.log.html +0 -100
data/doc/file.manifest.html +0 -67
data/doc/file.mxmlc.html +0 -740
data/doc/file.number.html +0 -67
data/doc/file.osx_system.html +0 -79
data/doc/file.param.html +0 -491
data/doc/file.parameter_factory.html +0 -119
data/doc/file.path.html +0 -81
data/doc/file.paths.html +0 -80
data/doc/file.platform.html +0 -124
data/doc/file.process_runner.html +0 -224
data/doc/file.progress_bar.html +0 -390
data/doc/file.rdoc_parser.html +0 -145
data/doc/file.remote_file_loader.html +0 -117
data/doc/file.remote_file_target.html +0 -176
data/doc/file.ruby_base.html +0 -64
data/doc/file.ruby_feature.html +0 -244
data/doc/file.ruby_generator.html +0 -118
data/doc/file.ruby_input.html +0 -62
data/doc/file.ruby_test_case.html +0 -78
data/doc/file.ruby_test_helper.html +0 -61
data/doc/file.specification.html +0 -248
data/doc/file.sprout.html +0 -64
data/doc/file.sprout_test_case.html +0 -280
data/doc/file.string.html +0 -72
data/doc/file.string_param.html +0 -76
data/doc/file.strings.html +0 -71
data/doc/file.system.html +0 -86
data/doc/file.template_manifest.html +0 -67
data/doc/file.tool.html +0 -92
data/doc/file.tool_generator.html +0 -90
data/doc/file.unix_system.html +0 -128
data/doc/file.url.html +0 -71
data/doc/file.urls.html +0 -70
data/doc/file.version.html +0 -71
data/doc/file.vista_system.html +0 -69
data/doc/file.win_nix_system.html +0 -88
data/doc/file.win_system.html +0 -129
data/doc/file_list.html +0 -230
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 -3355
data/doc/top-level-namespace.html +0 -192
data/lib/sprout/base.rb +0 -121
data/lib/sprout/log.rb +0 -46
data/test/unit/sprout_test_helper.rb +0 -33

data/doc/file.archive_unpacker.html DELETED Viewed

@@ -1,288 +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>File: archive_unpacker</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" title="Index">Index</a> &raquo;
-    <span class="title">File: archive_unpacker</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"><div id='filecontents'>
-<p>require ‘zip/zip’ require ‘sprout/version’ require ‘archive/tar/minitar’</p>
-<p>## # Given a source, destination and archive type (or ability to infer it),
-# unpack the provided archive. # #   unpacker = Sprout::ArchiveUnpacker.new
-#   unpacker.unpack “Foo.zip”, “unpacked/” # class Sprout::ArchiveUnpacker</p>
-<pre class="code"><span class='comment'>##
-</span><span class='comment'># Unpack the provided +archive+ into the provided +destination+.
-</span><span class='comment'>#
-</span><span class='comment'># If a +type+ is not provided, a type will be inferred from the file name suffix.
-</span><span class='comment'>#
-</span><span class='comment'># @param archive [File] Path to the archive that will be unpacked (or copied)
-</span><span class='comment'># @param destination [Path] Path to the folder where unpacked files should be placed (or copied).
-</span><span class='comment'># @param type [Symbol] The type of the archive in cases where it can't be inferred
-</span><span class='comment'>#     from the name. Acceptable values are: :zip, :tgz, :swc, :exe or :rb
-</span><span class='comment'># @param clobber [Boolean] If the destination already contains the expected file(s),
-</span><span class='comment'>#     the unpacker will not run unless +clobber+ is true.
-</span><span class='comment'># @return [String] path to the unpacked files (usually same as destination).
-</span><span class='comment'># @raise Sprout::Errors::UnknownArchiveType If the archive type cannot be inferred and a valid type is not provided.
-</span><span class='kw'>def</span> <span class='id unpack'>unpack</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='comma'>,</span> <span class='id type'>type</span><span class='op'>=</span><span class='kw'>nil</span><span class='comma'>,</span> <span class='id clobber'>clobber</span><span class='op'>=</span><span class='kw'>nil</span>
-  <span class='kw'>return</span> <span class='id unpack_zip'>unpack_zip</span><span class='lparen'>(</span><span class='id archive'>archive</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='comma'>,</span> <span class='id clobber'>clobber</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id is_zip?'>is_zip?</span><span class='lparen'>(</span><span class='id archive'>archive</span><span class='comma'>,</span> <span class='id type'>type</span><span class='rparen'>)</span>
-  <span class='kw'>return</span> <span class='id unpack_tgz'>unpack_tgz</span><span class='lparen'>(</span><span class='id archive'>archive</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='comma'>,</span> <span class='id clobber'>clobber</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id is_tgz?'>is_tgz?</span><span class='lparen'>(</span><span class='id archive'>archive</span><span class='comma'>,</span> <span class='id type'>type</span><span class='rparen'>)</span>
-  <span class='comment'># This is definitely debatable, should we copy the file even if it's
-</span>  <span class='comment'># not an archive that we're about to unpack?
-</span>  <span class='comment'># If so, why would we only do this with some subset of file types?
-</span>  <span class='comment'># Opinions welcome here...
-</span>  <span class='kw'>return</span> <span class='id copy_file'>copy_file</span><span class='lparen'>(</span><span class='id archive'>archive</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='comma'>,</span> <span class='id clobber'>clobber</span><span class='rparen'>)</span>  <span class='kw'>if</span> <span class='id is_copyable?'>is_copyable?</span><span class='lparen'>(</span><span class='id archive'>archive</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'>UnknownArchiveType</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'>Unsupported or unknown archive type encountered with: </span><span class='embexpr_beg'>#{</span><span class='id archive'>archive</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Unpack zip archives on any platform using whatever strategy is most
-</span><span class='comment'># efficient and reliable.
-</span><span class='comment'>#
-</span><span class='comment'># @param archive [File] Path to the archive that will be unpacked.
-</span><span class='comment'># @param destination [Path] Path to the folder where unpacked files should be placed.
-</span><span class='comment'># @param clobber [Boolean] If the destination already contains the expected file(s),
-</span><span class='comment'>#     the unpacker will not run unless +clobber+ is true.
-</span><span class='comment'># @return [File] the file or directory that was created.
-</span><span class='kw'>def</span> <span class='id unpack_zip'>unpack_zip</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='comma'>,</span> <span class='id clobber'>clobber</span><span class='op'>=</span><span class='kw'>nil</span>
-  <span class='id validate'>validate</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id destination'>destination</span>
-  <span class='comment'>##
-</span>  <span class='comment'># As it turns out, the Rubyzip library corrupts
-</span>  <span class='comment'># binary files (like the Flash Player) on OSX and is also
-</span>  <span class='comment'># horribly slow for large archives (like the ~120MB Flex SDK)
-</span>  <span class='comment'># on all platforms.
-</span>  <span class='kw'>if</span> <span class='id is_darwin?'>is_darwin?</span>
-    <span class='id unpack_zip_on_darwin'>unpack_zip_on_darwin</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='comma'>,</span> <span class='id clobber'>clobber</span>
-  <span class='kw'>else</span>
-    <span class='const'>Zip</span><span class='op'>::</span><span class='const'>ZipFile</span><span class='period'>.</span><span class='id open'>open</span> <span class='id archive'>archive</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id zipfile'>zipfile</span><span class='op'>|</span>
-      <span class='id zipfile'>zipfile</span><span class='period'>.</span><span class='id each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id entry'>entry</span><span class='op'>|</span>
-        <span class='kw'>next</span> <span class='kw'>if</span> <span class='id entry'>entry</span><span class='period'>.</span><span class='id name'>name</span> <span class='op'>=~</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>__MACOSX</span><span class='regexp_end'>/</span></span> <span class='kw'>or</span> <span class='id entry'>entry</span><span class='period'>.</span><span class='id name'>name</span> <span class='op'>=~</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>\.DS_Store</span><span class='regexp_end'>/</span></span>
-          <span class='id unpack_zip_entry'>unpack_zip_entry</span> <span class='id entry'>entry</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='comma'>,</span> <span class='id clobber'>clobber</span>
-      <span class='kw'>end</span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Return true if we're on a Darwin native system (OSX).
-</span><span class='comment'># @return [Boolean]
-</span><span class='kw'>def</span> <span class='id is_darwin?'>is_darwin?</span>
-  <span class='const'>Sprout</span><span class='period'>.</span><span class='id current_system'>current_system</span><span class='period'>.</span><span class='id is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Sprout</span><span class='op'>::</span><span class='const'>System</span><span class='op'>::</span><span class='const'>OSXSystem</span><span class='rparen'>)</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Optimization for zip files on OSX. Uses the native
-</span><span class='comment'># 'unzip' utility which is much faster (and more reliable)
-</span><span class='comment'># than Ruby for large archives (like the Flex SDK) and
-</span><span class='comment'># binaries that Ruby corrupts (like the Flash Player).
-</span><span class='comment'>#
-</span><span class='comment'># @return [File] the file or directory that was created.
-</span><span class='kw'>def</span> <span class='id unpack_zip_on_darwin'>unpack_zip_on_darwin</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='comma'>,</span> <span class='id clobber'>clobber</span>
-  <span class='comment'># Unzipping on OS X
-</span>  <span class='const'>FileUtils</span><span class='period'>.</span><span class='id makedirs'>makedirs</span> <span class='id destination'>destination</span>
-  <span class='id zip_dir'>zip_dir</span>  <span class='op'>=</span> <span class='const'>File</span><span class='period'>.</span><span class='id expand_path'>expand_path</span> <span class='const'>File</span><span class='period'>.</span><span class='id dirname'>dirname</span><span class='lparen'>(</span><span class='id archive'>archive</span><span class='rparen'>)</span>
-  <span class='id zip_name'>zip_name</span> <span class='op'>=</span> <span class='const'>File</span><span class='period'>.</span><span class='id basename'>basename</span> <span class='id archive'>archive</span>
-  <span class='id output'>output</span>   <span class='op'>=</span> <span class='const'>File</span><span class='period'>.</span><span class='id expand_path'>expand_path</span> <span class='id destination'>destination</span>
-  <span class='comment'># puts &quot;&gt;&gt; zip_dir: #{zip_dir} zip_name: #{zip_name} output: #{output}&quot;
-</span>  <span class='backtick'>%x(</span><span class='tstring_content'>cd </span><span class='embexpr_beg'>#{</span><span class='id zip_dir'>zip_dir</span><span class='rbrace'>}</span><span class='tstring_content'>;unzip </span><span class='embexpr_beg'>#{</span><span class='id zip_name'>zip_name</span><span class='rbrace'>}</span><span class='tstring_content'> -d </span><span class='embexpr_beg'>#{</span><span class='id output'>output</span><span class='rbrace'>}</span><span class='tstring_end'>)</span></span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Unpack tar.gz or .tgz files on any platform.
-</span><span class='comment'>#
-</span><span class='comment'># @return [File] the file or directory that was created.
-</span><span class='kw'>def</span> <span class='id unpack_tgz'>unpack_tgz</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='comma'>,</span> <span class='id clobber'>clobber</span><span class='op'>=</span><span class='kw'>nil</span>
-  <span class='id validate'>validate</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id destination'>destination</span>
-  <span class='id tar'>tar</span> <span class='op'>=</span> <span class='const'>Zlib</span><span class='op'>::</span><span class='const'>GzipReader</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='const'>File</span><span class='period'>.</span><span class='id open'>open</span><span class='lparen'>(</span><span class='id archive'>archive</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>rb</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span><span class='rparen'>)</span>
-  <span class='kw'>if</span><span class='lparen'>(</span><span class='op'>!</span><span class='id should_unpack_tgz?'>should_unpack_tgz?</span><span class='lparen'>(</span><span class='id destination'>destination</span><span class='comma'>,</span> <span class='id clobber'>clobber</span><span class='rparen'>)</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'>DestinationExistsError</span><span class='period'>.</span><span class='id new'>new</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Unable to unpack </span><span class='embexpr_beg'>#{</span><span class='id archive'>archive</span><span class='rbrace'>}</span><span class='tstring_content'> into </span><span class='embexpr_beg'>#{</span><span class='id destination'>destination</span><span class='rbrace'>}</span><span class='tstring_content'> without explicit :clobber argument</span><span class='tstring_end'>&quot;</span></span>
-  <span class='kw'>end</span>
-  <span class='const'>Archive</span><span class='op'>::</span><span class='const'>Tar</span><span class='op'>::</span><span class='const'>Minitar</span><span class='period'>.</span><span class='id unpack'>unpack</span><span class='lparen'>(</span><span class='id tar'>tar</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='rparen'>)</span>
-  <span class='comment'># Recurse and unpack gzipped children (Adobe did this double
-</span>  <span class='comment'># gzip with the Linux FlashPlayer for some weird reason)
-</span>  <span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id destination'>destination</span><span class='rbrace'>}</span><span class='tstring_content'>/**/*.tgz</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id destination'>destination</span><span class='rbrace'>}</span><span class='tstring_content'>/**/*.tar.gz</span><span class='tstring_end'>&quot;</span></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 pattern'>pattern</span><span class='op'>|</span>
-    <span class='const'>Dir</span><span class='period'>.</span><span class='id glob'>glob</span><span class='lparen'>(</span><span class='id pattern'>pattern</span><span class='rparen'>)</span><span class='period'>.</span><span class='id each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id child'>child</span><span class='op'>|</span>
-      <span class='kw'>if</span><span class='lparen'>(</span><span class='id child'>child</span> <span class='op'>!=</span> <span class='id archive'>archive</span> <span class='op'>&amp;&amp;</span> <span class='id dir'>dir</span> <span class='op'>!=</span> <span class='const'>File</span><span class='period'>.</span><span class='id dirname'>dirname</span><span class='lparen'>(</span><span class='id child'>child</span><span class='rparen'>)</span><span class='rparen'>)</span>
-        <span class='id unpack_tgz'>unpack_tgz</span><span class='lparen'>(</span><span class='id child'>child</span><span class='comma'>,</span> <span class='const'>File</span><span class='period'>.</span><span class='id dirname'>dirname</span><span class='lparen'>(</span><span class='id child'>child</span><span class='rparen'>)</span><span class='rparen'>)</span>
-      <span class='kw'>end</span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Rather than unpacking, safely copy the file from one location
-</span><span class='comment'># to another.
-</span><span class='comment'># This method is generally used when .exe files are downloaded
-</span><span class='comment'># directly.
-</span><span class='comment'>#
-</span><span class='comment'># @return [File] the file or directory that was created.
-</span><span class='kw'>def</span> <span class='id copy_file'>copy_file</span> <span class='id file'>file</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='comma'>,</span> <span class='id clobber'>clobber</span><span class='op'>=</span><span class='kw'>nil</span>
-  <span class='id validate'>validate</span> <span class='id file'>file</span><span class='comma'>,</span> <span class='id destination'>destination</span>
-  <span class='id target'>target</span> <span class='op'>=</span> <span class='const'>File</span><span class='period'>.</span><span class='id expand_path'>expand_path</span><span class='lparen'>(</span> <span class='const'>File</span><span class='period'>.</span><span class='id join'>join</span><span class='lparen'>(</span><span class='id destination'>destination</span><span class='comma'>,</span> <span class='const'>File</span><span class='period'>.</span><span class='id basename'>basename</span><span class='lparen'>(</span><span class='id file'>file</span><span class='rparen'>)</span><span class='rparen'>)</span> <span class='rparen'>)</span>
-  <span class='kw'>if</span><span class='lparen'>(</span><span class='const'>File</span><span class='period'>.</span><span class='id exists?'>exists?</span><span class='lparen'>(</span><span class='id target'>target</span><span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='id clobber'>clobber</span> <span class='op'>!=</span> <span class='symbol'>:clobber</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'>DestinationExistsError</span><span class='period'>.</span><span class='id new'>new</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Unable to copy </span><span class='embexpr_beg'>#{</span><span class='id file'>file</span><span class='rbrace'>}</span><span class='tstring_content'> to </span><span class='embexpr_beg'>#{</span><span class='id target'>target</span><span class='rbrace'>}</span><span class='tstring_content'> because target already exists and we were not asked to :clobber it</span><span class='tstring_end'>&quot;</span></span>
-  <span class='kw'>end</span>
-  <span class='const'>FileUtils</span><span class='period'>.</span><span class='id mkdir_p'>mkdir_p</span> <span class='id destination'>destination</span>
-  <span class='const'>FileUtils</span><span class='period'>.</span><span class='id cp_r'>cp_r</span> <span class='id file'>file</span><span class='comma'>,</span> <span class='id destination'>destination</span>
-  <span class='id destination'>destination</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Returns true if the provided file name looks like a zip file or the +type+ argument is +:zip+.
-</span><span class='comment'># @return [Boolean]
-</span><span class='kw'>def</span> <span class='id is_zip?'>is_zip?</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id type'>type</span><span class='op'>=</span><span class='kw'>nil</span>
-  <span class='id type'>type</span> <span class='op'>==</span> <span class='symbol'>:zip</span> <span class='op'>||</span> <span class='op'>!</span><span class='id archive'>archive</span><span class='period'>.</span><span class='id match'>match</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>\.zip$</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id nil?'>nil?</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Return true if the provided file name looks like a tar.gz file or the +type+ argument is +:tgz+.
-</span><span class='comment'># @return [Boolean]
-</span><span class='kw'>def</span> <span class='id is_tgz?'>is_tgz?</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id type'>type</span><span class='op'>=</span><span class='kw'>nil</span>
-  <span class='id type'>type</span> <span class='op'>==</span> <span class='symbol'>:tgz</span> <span class='op'>||</span> <span class='op'>!</span><span class='id archive'>archive</span><span class='period'>.</span><span class='id match'>match</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>\.tgz$</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id nil?'>nil?</span> <span class='op'>||</span> <span class='op'>!</span><span class='id archive'>archive</span><span class='period'>.</span><span class='id match'>match</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>\.tar.gz$</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id nil?'>nil?</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Return true if the downloaded archive is a .exe file or the +type+ argument is +:exe+.
-</span><span class='comment'># @return [Boolean]
-</span><span class='kw'>def</span> <span class='id is_exe?'>is_exe?</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id type'>type</span><span class='op'>=</span><span class='kw'>nil</span>
-  <span class='id type'>type</span> <span class='op'>==</span> <span class='symbol'>:exe</span> <span class='op'>||</span> <span class='op'>!</span><span class='id archive'>archive</span><span class='period'>.</span><span class='id match'>match</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>\.exe$</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id nil?'>nil?</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Return true if the downloaded archive is a .swc file or the +type+ argument is +:swc+.
-</span><span class='comment'># @return [Boolean]
-</span><span class='kw'>def</span> <span class='id is_swc?'>is_swc?</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id type'>type</span><span class='op'>=</span><span class='kw'>nil</span>
-  <span class='id type'>type</span> <span class='op'>==</span> <span class='symbol'>:swc</span> <span class='op'>||</span> <span class='op'>!</span><span class='id archive'>archive</span><span class='period'>.</span><span class='id match'>match</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>\.swc$</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id nil?'>nil?</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Return true if the downloaded archive is a .rb file or the +type+ argument is +:rb+.
-</span><span class='comment'># @return [Boolean]
-</span><span class='kw'>def</span> <span class='id is_rb?'>is_rb?</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id type'>type</span><span class='op'>=</span><span class='kw'>nil</span>
-  <span class='id type'>type</span> <span class='op'>==</span> <span class='symbol'>:rb</span> <span class='op'>||</span> <span class='op'>!</span><span class='id archive'>archive</span><span class='period'>.</span><span class='id match'>match</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>\.rb$</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id nil?'>nil?</span>
-<span class='kw'>end</span>
-<span class='id private'>private</span>
-<span class='comment'>##
-</span><span class='comment'># Return true if the provided archive should be copied as-is, rather
-</span><span class='comment'># than being unpacked first.
-</span><span class='comment'># @return [Boolean]
-</span><span class='kw'>def</span> <span class='id is_copyable?'>is_copyable?</span> <span class='id archive'>archive</span>
-  <span class='lparen'>(</span><span class='id is_exe?'>is_exe?</span><span class='lparen'>(</span><span class='id archive'>archive</span><span class='rparen'>)</span> <span class='op'>||</span> <span class='id is_swc?'>is_swc?</span><span class='lparen'>(</span><span class='id archive'>archive</span><span class='rparen'>)</span> <span class='op'>||</span> <span class='id is_rb?'>is_rb?</span><span class='lparen'>(</span><span class='id archive'>archive</span><span class='rparen'>)</span><span class='rparen'>)</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Return true if the tgz should be unpacked.
-</span><span class='comment'># @return [Boolean]
-</span><span class='kw'>def</span> <span class='id should_unpack_tgz?'>should_unpack_tgz?</span> <span class='id dir'>dir</span><span class='comma'>,</span> <span class='id clobber'>clobber</span><span class='op'>=</span><span class='kw'>nil</span>
-  <span class='kw'>return</span> <span class='op'>!</span><span class='id directory_has_children?'>directory_has_children?</span><span class='lparen'>(</span><span class='id dir'>dir</span><span class='rparen'>)</span> <span class='op'>||</span> <span class='id clobber'>clobber</span> <span class='op'>==</span> <span class='symbol'>:clobber</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Return true if the provided directory has one or more chidren.
-</span><span class='comment'># @return [Boolean]
-</span><span class='kw'>def</span> <span class='id directory_has_children?'>directory_has_children?</span> <span class='id dir'>dir</span>
-  <span class='lparen'>(</span><span class='const'>Dir</span><span class='period'>.</span><span class='id entries'>entries</span><span class='lparen'>(</span><span class='id dir'>dir</span><span class='rparen'>)</span> <span class='op'>-</span> <span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>.</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>..</span><span class='tstring_end'>'</span></span><span class='rbracket'>]</span><span class='rparen'>)</span><span class='period'>.</span><span class='id size'>size</span> <span class='op'>&gt;</span> <span class='int'>0</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># @return [Boolean] true if the +archive+ and +destination+ exist.
-</span><span class='comment'># @raise Sprout::Errors::ArchiveUnpackerError if the +archive+ or +destination+ don't exist.
-</span><span class='kw'>def</span> <span class='id validate'>validate</span> <span class='id archive'>archive</span><span class='comma'>,</span> <span class='id destination'>destination</span>
-  <span class='id archive_message'>archive_message</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Archive could not be found at: </span><span class='embexpr_beg'>#{</span><span class='id archive'>archive</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></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'>ArchiveUnpackerError</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='id archive_message'>archive_message</span><span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id valid_path?'>valid_path?</span><span class='lparen'>(</span><span class='id archive'>archive</span><span class='rparen'>)</span>
-  <span class='id destination_message'>destination_message</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Destination could not be found at: </span><span class='embexpr_beg'>#{</span><span class='id destination'>destination</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></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'>ArchiveUnpackerError</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='id destination_message'>destination_message</span><span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id valid_path?'>valid_path?</span><span class='lparen'>(</span><span class='id destination'>destination</span><span class='rparen'>)</span>
-  <span class='kw'>true</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># @return [Boolean] true if the provided +path+ is not nil and exists on disk.
-</span><span class='kw'>def</span> <span class='id valid_path?'>valid_path?</span> <span class='id path'>path</span>
-  <span class='op'>!</span><span class='id path'>path</span><span class='period'>.</span><span class='id nil?'>nil?</span> <span class='op'>&amp;&amp;</span> <span class='const'>File</span><span class='period'>.</span><span class='id exists?'>exists?</span><span class='lparen'>(</span><span class='id path'>path</span><span class='rparen'>)</span>
-<span class='kw'>end</span>
-<span class='comment'>##
-</span><span class='comment'># Unpack an entry from a zip archive. This is an _inconvenience_ method
-</span><span class='comment'># thanks to the way Ruby zip handles zip archives.
-</span><span class='kw'>def</span> <span class='id unpack_zip_entry'>unpack_zip_entry</span> <span class='id entry'>entry</span><span class='comma'>,</span> <span class='id destination'>destination</span><span class='comma'>,</span> <span class='id clobber'>clobber</span>
-  <span class='comment'># Ensure hidden mac files don't get written to disk:
-</span>  <span class='id path'>path</span> <span class='op'>=</span> <span class='const'>File</span><span class='period'>.</span><span class='id join'>join</span> <span class='id destination'>destination</span><span class='comma'>,</span> <span class='id entry'>entry</span><span class='period'>.</span><span class='id name'>name</span>
-  <span class='kw'>if</span> <span class='id entry'>entry</span><span class='period'>.</span><span class='id directory?'>directory?</span>
-    <span class='comment'># If an archive has empty directories:
-</span>    <span class='const'>FileUtils</span><span class='period'>.</span><span class='id mkdir_p'>mkdir_p</span> <span class='id path'>path</span>
-  <span class='kw'>elsif</span> <span class='id entry'>entry</span><span class='period'>.</span><span class='id file?'>file?</span>
-    <span class='comment'># On Windows, we don't get the entry for
-</span>    <span class='comment'># each parent directory:
-</span>    <span class='const'>FileUtils</span><span class='period'>.</span><span class='id mkdir_p'>mkdir_p</span> <span class='const'>File</span><span class='period'>.</span><span class='id dirname'>dirname</span><span class='lparen'>(</span><span class='id path'>path</span><span class='rparen'>)</span>
-    <span class='kw'>begin</span>
-      <span class='id entry'>entry</span><span class='period'>.</span><span class='id extract'>extract</span> <span class='id path'>path</span>
-    <span class='kw'>rescue</span> <span class='const'>Zip</span><span class='op'>::</span><span class='const'>ZipDestinationFileExistsError</span> <span class='op'>=&gt;</span> <span class='id zip_dest_error'>zip_dest_error</span>
-      <span class='kw'>if</span><span class='lparen'>(</span><span class='id clobber'>clobber</span> <span class='op'>==</span> <span class='symbol'>:clobber</span><span class='rparen'>)</span>
-        <span class='const'>FileUtils</span><span class='period'>.</span><span class='id rm_rf'>rm_rf</span> <span class='id path'>path</span>
-        <span class='id entry'>entry</span><span class='period'>.</span><span class='id extract'>extract</span> <span class='id path'>path</span>
-      <span class='kw'>else</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'>DestinationExistsError</span><span class='period'>.</span><span class='id new'>new</span> <span class='id zip_dest_error'>zip_dest_error</span><span class='period'>.</span><span class='id message'>message</span>
-      <span class='kw'>end</span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span></pre>
-<p>end</p>
-</div></div>
-    <div id="footer">
-  Generated on Wed Dec 22 11:58:31 2010 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/file.base.html DELETED Viewed

@@ -1,208 +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>File: base</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" title="Index">Index</a> &raquo;
-    <span class="title">File: base</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"><div id='filecontents'>
-<p>module Sprout</p>
-<pre class="code"><span class='kw'>module</span> <span class='const'>Generator</span>
-  <span class='kw'>class</span> <span class='const'>Base</span>
-    <span class='id include'>include</span> <span class='const'>Sprout</span><span class='op'>::</span><span class='const'>Executable</span>
-    <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id inherited'>inherited</span> <span class='id base'>base</span>
-      <span class='comment'># NOTE: We can NOT instantiate the class here,
-</span>      <span class='comment'># because only it's first line has been interpreted, if we
-</span>      <span class='comment'># instantiate here, none of the code declared in the class body will
-</span>      <span class='comment'># be associated with this instance.
-</span>      <span class='comment'>#
-</span>      <span class='comment'># Go ahead and register the class and update instances afterwards.
-</span>      <span class='const'>Sprout</span><span class='op'>::</span><span class='const'>Generator</span><span class='period'>.</span><span class='id register'>register</span> <span class='id base'>base</span><span class='comma'>,</span> <span class='id template_from_caller'>template_from_caller</span><span class='lparen'>(</span><span class='id caller'>caller</span><span class='period'>.</span><span class='id first'>first</span><span class='rparen'>)</span>
-    <span class='kw'>end</span>
-    <span class='comment'>##
-</span>    <span class='comment'># The directory where files will be created.
-</span>    <span class='id add_param'>add_param</span> <span class='symbol'>:path</span><span class='comma'>,</span> <span class='const'>Path</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:default</span> <span class='op'>=&gt;</span> <span class='const'>Dir</span><span class='period'>.</span><span class='id pwd'>pwd</span> <span class='rbrace'>}</span>
-    <span class='comment'>##
-</span>    <span class='comment'># Insteast of creating, destroy the files.
-</span>    <span class='id add_param'>add_param</span> <span class='symbol'>:destroy</span><span class='comma'>,</span> <span class='const'>Boolean</span>
-    <span class='comment'>##
-</span>    <span class='comment'># Force the creation of files without prompting.
-</span>    <span class='id add_param'>add_param</span> <span class='symbol'>:force</span><span class='comma'>,</span> <span class='const'>Boolean</span>
-    <span class='comment'>##
-</span>    <span class='comment'># Run the generator in Quiet mode - do not write
-</span>    <span class='comment'># status to standard output.
-</span>    <span class='id add_param'>add_param</span> <span class='symbol'>:quiet</span><span class='comma'>,</span> <span class='const'>Boolean</span>
-    <span class='comment'>##
-</span>    <span class='comment'># A collection of paths to look in for named templates.
-</span>    <span class='id add_param'>add_param</span> <span class='symbol'>:templates</span><span class='comma'>,</span> <span class='const'>Paths</span>
-    <span class='comment'>##
-</span>    <span class='comment'># The primary input for the application or component.
-</span>    <span class='id add_param'>add_param</span> <span class='symbol'>:input</span><span class='comma'>,</span> <span class='const'>String</span><span class='comma'>,</span> <span class='lbrace'>{</span> <span class='symbol'>:hidden_name</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='symbol'>:required</span> <span class='op'>=&gt;</span> <span class='kw'>true</span> <span class='rbrace'>}</span>
-    <span class='comment'>##
-</span>    <span class='comment'># Set the default name for generators.
-</span>    <span class='id set'>set</span> <span class='symbol'>:name</span><span class='comma'>,</span> <span class='symbol'>:application</span>
-    <span class='comment'>##
-</span>    <span class='comment'># The symbol name for which this generator is most
-</span>    <span class='comment'># appropriate.
-</span>    <span class='comment'>#
-</span>    <span class='comment'># This value defaults to :application so, if you're working on an
-</span>    <span class='comment'># application generator, you can leave it as the default.
-</span>    <span class='comment'>#
-</span>    <span class='comment'># For all other generator types, you'll want to select the most
-</span>    <span class='comment'># general project type that this generator may be useful in.
-</span>    <span class='comment'>#
-</span>    <span class='comment'># Following are some example values:
-</span>    <span class='comment'>#
-</span>    <span class='comment'>#     :as3, :flex3, :flex4, :air2
-</span>    <span class='comment'>#
-</span>    <span class='comment'># or core libraries:
-</span>    <span class='comment'>#
-</span>    <span class='comment'>#     :asunit4, :flexunit4
-</span>    <span class='comment'>#
-</span>    <span class='comment'># or even other libraries:
-</span>    <span class='comment'>#
-</span>    <span class='comment'>#     :puremvc, :robotlegs, :swizz
-</span>    <span class='comment'>#
-</span>    <span class='id attr_accessor'>attr_accessor</span> <span class='symbol'>:name</span>
-    <span class='id attr_accessor'>attr_accessor</span> <span class='symbol'>:logger</span>
-    <span class='id attr_accessor'>attr_accessor</span> <span class='symbol'>:pkg_name</span>
-    <span class='id attr_accessor'>attr_accessor</span> <span class='symbol'>:pkg_version</span>
-    <span class='comment'>##
-</span>    <span class='comment'># Record the actions and trigger them
-</span>    <span class='kw'>def</span> <span class='id execute'>execute</span>
-      <span class='kw'>return</span> <span class='id prepare_command'>prepare_command</span><span class='period'>.</span><span class='id unexecute'>unexecute</span> <span class='kw'>if</span> <span class='id destroy'>destroy</span>
-      <span class='id prepare_command'>prepare_command</span><span class='period'>.</span><span class='id execute'>execute</span>
-    <span class='kw'>end</span>
-    <span class='comment'>##
-</span>    <span class='comment'># Rollback the generator
-</span>    <span class='kw'>def</span> <span class='id unexecute'>unexecute</span>
-      <span class='id prepare_command'>prepare_command</span><span class='period'>.</span><span class='id unexecute'>unexecute</span>
-    <span class='kw'>end</span>
-    <span class='kw'>def</span> <span class='id say'>say</span> <span class='id message'>message</span>
-      <span class='id logger'>logger</span><span class='period'>.</span><span class='id puts'>puts</span> <span class='id message'>message</span><span class='period'>.</span><span class='id gsub'>gsub</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</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='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>.</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id quiet'>quiet</span>
-    <span class='kw'>end</span>
-    <span class='comment'>##
-</span>    <span class='comment'># TODO: Add support for arbitrary templating languages.
-</span>    <span class='comment'># For now, just support ERB...
-</span>    <span class='comment'>#
-</span>    <span class='comment'># TODO: This is also a possible spot where those of you that don't want
-</span>    <span class='comment'># to snuggle might put pretty-print code or some such
-</span>    <span class='comment'># modifiers...
-</span>    <span class='kw'>def</span> <span class='id resolve_template'>resolve_template</span> <span class='id content'>content</span>
-      <span class='id require'>require</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>erb</span><span class='tstring_end'>'</span></span>
-      <span class='const'>ERB</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='id content'>content</span><span class='comma'>,</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>&gt;</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id result'>result</span><span class='lparen'>(</span><span class='id binding'>binding</span><span class='rparen'>)</span>
-    <span class='kw'>end</span>
-    <span class='comment'>##
-</span>    <span class='comment'># Returns a collection of templates that were provided on the
-</span>    <span class='comment'># command line, followed by templates that are created by a
-</span>    <span class='comment'># concrete generator, followed by the
-</span>    <span class='comment'># Sprout::Generator.search_paths + 'templates' folders.
-</span>    <span class='comment'>#
-</span>    <span class='kw'>def</span> <span class='id template_paths'>template_paths</span>
-      <span class='id templates'>templates</span> <span class='op'>&lt;&lt;</span> <span class='const'>Sprout</span><span class='op'>::</span><span class='const'>Generator</span><span class='op'>::</span><span class='id template_folder_for'>template_folder_for</span><span class='lparen'>(</span><span class='kw'>self</span><span class='rparen'>)</span>
-      <span class='id templates'>templates</span><span class='period'>.</span><span class='id concat'>concat</span> <span class='id default_search_paths'>default_search_paths</span>
-    <span class='kw'>end</span>
-    <span class='id protected'>protected</span>
-    <span class='kw'>def</span> <span class='id default_search_paths'>default_search_paths</span>
-      <span class='const'>Sprout</span><span class='op'>::</span><span class='const'>Generator</span><span class='period'>.</span><span class='id search_paths'>search_paths</span><span class='period'>.</span><span class='id collect'>collect</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id path'>path</span><span class='op'>|</span> <span class='const'>File</span><span class='period'>.</span><span class='id join'>join</span><span class='lparen'>(</span><span class='id path'>path</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>templates</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span> <span class='rbrace'>}</span>
-    <span class='kw'>end</span>
-    <span class='kw'>def</span> <span class='id prepare_command'>prepare_command</span>
-      <span class='ivar'>@logger</span> <span class='op'>||=</span> <span class='gvar'>$stdout</span>
-      <span class='ivar'>@command</span> <span class='op'>=</span> <span class='const'>Command</span><span class='period'>.</span><span class='id new'>new</span> <span class='kw'>self</span>
-      <span class='ivar'>@command</span><span class='period'>.</span><span class='id logger'>logger</span> <span class='op'>=</span> <span class='id logger'>logger</span>
-      <span class='id manifest'>manifest</span>
-      <span class='ivar'>@command</span>
-    <span class='kw'>end</span>
-    <span class='kw'>def</span> <span class='id directory'>directory</span> <span class='id name'>name</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id block'>block</span>
-      <span class='ivar'>@command</span><span class='period'>.</span><span class='id directory'>directory</span> <span class='id name'>name</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id block'>block</span>
-    <span class='kw'>end</span>
-    <span class='kw'>def</span> <span class='id file'>file</span> <span class='id name'>name</span><span class='comma'>,</span> <span class='id template'>template</span><span class='op'>=</span><span class='kw'>nil</span>
-      <span class='ivar'>@command</span><span class='period'>.</span><span class='id file'>file</span> <span class='id name'>name</span><span class='comma'>,</span> <span class='id template'>template</span>
-    <span class='kw'>end</span>
-    <span class='kw'>def</span> <span class='id template'>template</span> <span class='id name'>name</span><span class='comma'>,</span> <span class='id template'>template</span><span class='op'>=</span><span class='kw'>nil</span>
-      <span class='ivar'>@command</span><span class='period'>.</span><span class='id template'>template</span> <span class='id name'>name</span><span class='comma'>,</span> <span class='id template'>template</span>
-    <span class='kw'>end</span>
-    <span class='kw'>def</span> <span class='id generator'>generator</span> <span class='id name'>name</span><span class='comma'>,</span> <span class='id options'>options</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span>
-      <span class='ivar'>@command</span><span class='period'>.</span><span class='id generator'>generator</span> <span class='id name'>name</span><span class='comma'>,</span> <span class='id to_hash'>to_hash</span><span class='period'>.</span><span class='id merge'>merge</span><span class='lparen'>(</span><span class='id options'>options</span><span class='rparen'>)</span>
-    <span class='kw'>end</span>
-    <span class='id private'>private</span>
-    <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id template_from_caller'>template_from_caller</span> <span class='id caller_string'>caller_string</span>
-      <span class='id file'>file</span> <span class='op'>=</span> <span class='const'>Sprout</span><span class='period'>.</span><span class='id file_from_caller'>file_from_caller</span> <span class='id caller_string'>caller_string</span>
-      <span class='const'>File</span><span class='period'>.</span><span class='id join'>join</span><span class='lparen'>(</span><span class='const'>File</span><span class='period'>.</span><span class='id dirname'>dirname</span><span class='lparen'>(</span><span class='id file'>file</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>templates</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
-<span class='kw'>end</span></pre>
-<p>end</p>
-</div></div>
-    <div id="footer">
-  Generated on Wed Dec 22 11:58:32 2010 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>