RubyGems - autobuild - Versions diffs - 0.5.1 → 0.6 - Mend

autobuild 0.5.1 → 0.6

Files changed (345) hide show

data/doc/classes/TC_TarImporter.src/M000015.html ADDED Viewed

@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>test_tar_remote (TC_TarImporter)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File test/test_import_tar.rb, line 61</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">test_tar_remote</span>
+        <span class="ruby-identifier">web_server</span> <span class="ruby-keyword kw">do</span>
+            <span class="ruby-comment cmt"># Try to get the file through the http server</span>
+            <span class="ruby-identifier">pkg</span> = <span class="ruby-constant">Package</span>.<span class="ruby-identifier">new</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-constant">TestTools</span>.<span class="ruby-identifier">tempdir</span>, <span class="ruby-value str">'tarimport'</span>), <span class="ruby-value str">'tarimport'</span>
+            <span class="ruby-identifier">importer</span> = <span class="ruby-constant">TarImporter</span>.<span class="ruby-identifier">new</span> <span class="ruby-value str">'http://localhost:2000/files/data/tarimport.tar.gz'</span>, <span class="ruby-identifier">:cachedir</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-ivar">@cachedir</span>
+            <span class="ruby-identifier">importer</span>.<span class="ruby-identifier">checkout</span>(<span class="ruby-identifier">pkg</span>)
+            <span class="ruby-identifier">assert</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">pkg</span>.<span class="ruby-identifier">srcdir</span>))
+            <span class="ruby-identifier">assert</span>(<span class="ruby-operator">!</span><span class="ruby-identifier">importer</span>.<span class="ruby-identifier">update_cache</span>)
+            <span class="ruby-identifier">sleep</span> <span class="ruby-value">2</span> <span class="ruby-comment cmt"># The Time class have a 1-second resolution</span>
+            <span class="ruby-constant">FileUtils</span>.<span class="ruby-identifier">touch</span> <span class="ruby-ivar">@tarfile</span>
+            <span class="ruby-identifier">assert</span>(<span class="ruby-identifier">importer</span>.<span class="ruby-identifier">update_cache</span>)
+            <span class="ruby-identifier">assert</span>(<span class="ruby-operator">!</span><span class="ruby-identifier">importer</span>.<span class="ruby-identifier">update_cache</span>)
+        <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/TC_TarImporter.src/M000016.html ADDED Viewed

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+  <title>test_tar_remote_notfound (TC_TarImporter)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File test/test_import_tar.rb, line 78</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">test_tar_remote_notfound</span>
+        <span class="ruby-identifier">web_server</span> <span class="ruby-keyword kw">do</span>
+            <span class="ruby-comment cmt"># Try to get the file through the http server</span>
+            <span class="ruby-identifier">pkg</span> = <span class="ruby-constant">Package</span>.<span class="ruby-identifier">new</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-constant">TestTools</span>.<span class="ruby-identifier">tempdir</span>, <span class="ruby-value str">'tarimport'</span>), <span class="ruby-value str">'tarimport'</span>
+            <span class="ruby-identifier">importer</span> = <span class="ruby-constant">TarImporter</span>.<span class="ruby-identifier">new</span> <span class="ruby-value str">'http://localhost:2000/files/data/tarimport-nofile.tar.gz'</span>, <span class="ruby-identifier">:cachedir</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-ivar">@cachedir</span>
+            <span class="ruby-identifier">assert_raise</span>(<span class="ruby-constant">Autobuild</span><span class="ruby-operator">::</span><span class="ruby-constant">Exception</span>) { <span class="ruby-identifier">importer</span>.<span class="ruby-identifier">checkout</span>(<span class="ruby-identifier">pkg</span>) }
+        <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/created.rid CHANGED Viewed

	@@ -1 +1 @@
1	- ~~Wed~~ ~~Jan~~ 25 21:51:38 ~~CET~~ 2006
1	+ Fri Aug 18 14:42:30 CEST 2006

data/doc/files/README.html ADDED Viewed

@@ -0,0 +1,378 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!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>
+  <title>File: README</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+    elemStyle = elem.style;
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+    return true;
+  }
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  // ]]>
+  </script>
+</head>
+<body>
+  <div id="fileHeader">
+    <h1>README</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>README
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Fri Aug 18 14:42:05 CEST 2006</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <h1>Introduction</h1>
+<h2>WARNING for 0.5 users</h2>
+<p>
+Old configuration files used with autobuild 0.5 aren&#8217;t accepted by
+Autobuild 0.6. Since 0.6, Autobuild uses Ruby for configuration (just like
+rake does)
+</p>
+<h2>What&#8217;s autobuild ?</h2>
+<p>
+Autobuild is a builder for a set of software packages. It takes as input a
+yaml config file as input and
+</p>
+<ul>
+<li>imports the package from a SCM or (optionnaly) updates it
+</li>
+<li>configures it. This phase can handle code generation, configuration (for
+instance for autotools-based
+</li>
+</ul>
+<p>
+packages), &#8230;
+</p>
+<ul>
+<li>build
+</li>
+<li>install
+</li>
+</ul>
+<p>
+It takes the dependencies between packages into account in its build
+process.
+</p>
+<h2>Available packages</h2>
+<h3>Common usage</h3>
+<p>
+All package objects define the following attributes
+</p>
+<table>
+<tr><td valign="top"><b>srcdir</b>:</td><td>where the package sources are located
+</td></tr>
+<tr><td valign="top"><b>importer</b>:</td><td>the importer object (see &quot;Available importers&quot; below)
+</td></tr>
+<tr><td valign="top"><b>prefix</b>:</td><td>the directory where the package should be installed. If it is a relative
+path, it is relative to the value of Autobuild.prefix. The default is to
+use the package name.
+</td></tr>
+</table>
+<p>
+All package methods (Autobuild.import, Autobuild.autotools) has either a
+package name for first argument, or a name =&gt; [dependencies] hash, and
+take a block which can be used to configure the package. For instance
+</p>
+<pre>
+    Autobuild.import :my_package do |pkg|
+    end
+    Autobuild.import :my_package =&gt; [:depends, :depends_also] do |pkg|
+    end
+</pre>
+<h3>Source only</h3>
+<pre>
+    package = Autobuild.import(dependencies) do |pkg|
+        &lt;package configuration&gt;
+    end
+</pre>
+<p>
+Use <tt>import</tt> if you need the package sources but don&#8217;t need to
+build it. You just need to set up the importer and <tt>srcdir</tt>.
+<tt>prefix</tt> is ignored.
+</p>
+<h3>Autotools</h3>
+<pre>
+    package = Autobuild.autotools(name, dependencies) do |pkg|
+        &lt;package configuration&gt;
+    end
+</pre>
+<p>
+Use this to build GNU autotools-based packages. This handles autoconf-only
+packages as well as those using automake
+</p>
+<p>
+Options to give the <tt>configure</tt> script are given in the
+<tt>configureflags</tt> array
+</p>
+<pre>
+    pkg.configureflags = ['--with-blah', 'FOO=bar' ]
+</pre>
+<p>
+If you want the files produced during the build to be separated from the
+source files, set the <tt>builddir</tt> attribute. For now, it has to be a
+relative path, relative to the source directory.
+</p>
+<pre>
+    pkg.builddir = 'build'
+</pre>
+<p>
+The generation of the configure script uses four programs:
+<tt>autoheader</tt>, <tt>autoconf</tt>, <tt>aclocal</tt>,
+<tt>automake</tt>. The default program path can be overriden in the
+Autotools.programs hash. For instance, to be sure that
+<tt>automake-1.9</tt> is used &lt;bb&gt;for all packages&lt;/bb&gt;, you
+set
+</p>
+<pre>
+    Autotools.programs['automake'] = 'automake-1.9'
+</pre>
+<p>
+Autobuild tries to detect what tools it should run, but you can override.
+Autodetection works as follows:
+</p>
+<ul>
+<li>if a script named <tt>autogen</tt> or +autogen.sh+ exists in the package
+source directory, it is run and the other tools are not. The name of this
+kind of script can be set by calling Autotools#use
+<pre>
+  pkg.use :autogen =&gt; 'my_autogen_script'
+</pre>
+</li>
+<li><tt>autoheader</tt> is never used by default
+</li>
+<li><tt>autoconf</tt> is used if there is <tt>configure.ac</tt> or
+<tt>configure.in</tt> in the source dir
+</li>
+<li><tt>aclocal</tt> is used if <tt>autoconf</tt> is enabled (either
+explicitely or by autodetection)
+</li>
+<li><tt>automake</tt> is used if there is a <tt>Makefile.am</tt> file in the
+source dir
+</li>
+<li>you can force to enable or disable any of these steps by calling
+Autotools#use. Set it to <tt>true</tt> to force its usage, <tt>false</tt>
+to disable it or to a string to force the usage of a particular program
+<pre>
+  pkg.use :autogen =&gt; false
+  pkg.use :automake =&gt; false
+  pkg.use :autoheader =&gt; true
+  pkg.use :autoconf =&gt; 'my_autoconf_program'
+</pre>
+<p>
+The &#8216;autogen&#8217; option cannot be set to <tt>true</tt>.
+</p>
+</li>
+</ul>
+<p>
+The only program used during the build and install phases is <tt>make</tt>.
+Its path can be overriden in the Autobuild.programs hash
+</p>
+<pre>
+    Autobuild.programs['make'] = 'gnumake'
+</pre>
+<h2>Available importers</h2>
+<p>
+You must set an importer object for each package. The package importer is
+the <tt>importer</tt> attribute and is set via <tt>package.importer =
+my_importer</tt>. An importer <tt>foo</tt> is defined by the class
+Autobuild::FooImporter and defines a Autobuild.foo method which creates a
+new importer object. Importer classes files are in
+<tt>lib/autobuild/import/</tt>
+</p>
+<h3>CVS</h3>
+<pre>
+    package.importer = cvs(cvsroot, module[, options])
+</pre>
+<p>
+Where <tt>options</tt> is an option hash. See also Autobuild::CVSImporter
+and Autobuild.cvs
+</p>
+<ul>
+<li>the default CVS command is <tt>cvs</tt>. It can be changed by
+<pre>
+  Autobuild.programs['cvs'] = 'my_cvs_command'
+</pre>
+</li>
+<li>the default checkout option is <tt>-P</tt>. You can change that by giving a
+<tt>cvsco</tt> option
+<pre>
+  cvs cvsroot, module, :cvsco =&gt; ['--my', '--cvs', '--options']
+</pre>
+</li>
+<li>the default update option is <tt>-dP</tt>. You can change that by giving a
+<tt>cvsup</tt> option
+<pre>
+  cvs cvsroot, module, :cvsup =&gt; ['--my', '--cvs', '--options']
+</pre>
+</li>
+</ul>
+<h3>Subversion</h3>
+<pre>
+    package.importer = svn(url[, options])
+</pre>
+<p>
+Where <tt>options</tt> is an option hash. See also Autobuild::SVNImporter
+and Autobuild.svn
+</p>
+<ul>
+<li>the default Subversion command is <tt>svn</tt>. It can be changed by
+<pre>
+  Autobuild.programs['svn'] = 'my_svn_command'
+</pre>
+</li>
+<li>by default, no options are given to checkout. You add some by giving a
+<tt>svnco</tt> option
+<pre>
+  svn url, :svnco =&gt; ['--my', '--svn', '--options']
+</pre>
+</li>
+<li>by default, no options are given to update. You can add some by giving a
+<tt>svnup</tt> option
+<pre>
+  svn url, :svnup =&gt; ['--my', '--svn', '--options']
+</pre>
+</li>
+</ul>
+<h3><b>Darcs</b></h3>
+<pre>
+    package.importer = darcs(url[, options])
+</pre>
+<p>
+Where <tt>options</tt> is a hash. See also Autobuild::DarcsImporter and
+Autobuild.darcs
+</p>
+<ul>
+<li>the default Darcs command is <tt>darcs</tt>. It can be changed by
+<pre>
+  Autobuild.programs['darcs'] = 'my_svn_command'
+</pre>
+</li>
+<li>by default, no options are given to get. You add some by giving a
+<tt>get</tt> option
+<pre>
+  darcs url, :get =&gt; ['--my', '--darcs', '--options']
+</pre>
+</li>
+<li>by default, no options are given to pull. You can add some by giving a
+<tt>pull</tt> option
+<pre>
+  darcs url, :pull =&gt; ['--my', '--darcs', '--options']
+</pre>
+</li>
+</ul>
+<h1>Copyright and license</h1>
+<table>
+<tr><td valign="top">Author:</td><td>Sylvain Joyeux &lt;sylvain.joyeux@m4x.org&gt;
+</td></tr>
+<tr><td valign="top">Copyright:</td><td>Copyright &#169; 2005-2006 Sylvain Joyeux
+</td></tr>
+<tr><td valign="top">License:</td><td>GPL
+</td></tr>
+</table>
+    </div>
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <!-- if method_list -->
+  </div>
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+</body>
+</html>

data/doc/files/{lib/autobuild/options_rb.html → demo_rb.html} RENAMED Viewed

@@ -5,10 +5,10 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
-  <title>File: options.rb</title>
+  <title>File: demo.rb</title>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
   <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
   <script type="text/javascript">
   // <![CDATA[
@@ -47,16 +47,16 @@
   <div id="fileHeader">
-    <h1>options.rb</h1>
+    <h1>demo.rb</h1>
     <table class="header-table">
     <tr class="top-aligned-row">
       <td><strong>Path:</strong></td>
-      <td>lib/autobuild/options.rb
+      <td>demo.rb
       </td>
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Wed Jan 25 21:45:14 CET 2006</td>
+      <td>Wed Feb 08 14:39:06 CET 2006</td>
     </tr>
     </table>
   </div>
@@ -69,6 +69,13 @@
   <div id="contextContent">
+    <div id="requires-list">
+      <h3 class="section-bar">Required files</h3>
+      <div class="name-list">
+      autobuild&nbsp;&nbsp;
+      </div>
+    </div>
    </div>
@@ -77,6 +84,13 @@
     <!-- if includes -->
+    <div id="includes">
+      <h3 class="section-bar">Included Modules</h3>
+      <div id="includes-list">
+        <span class="include-name"><a href="../classes/Autobuild.html">Autobuild</a></span>
+      </div>
+    </div>
     <div id="section">