root/release

#!/usr/bin/env php
<?php
/**
 * 
 * Solar release script.
 * 
 * Automates the release process, all but for the package upload and
 * website update.
 * 
 * @author Clay Loveless
 * 
 * @author Paul M. Jones
 * 
 * @license http://opensource.org/licenses/bsd-license.php BSD
 * 
 */

/**
 * 
 * Prints, then executes a shell command with passthru().
 * 
 * @param string $cmd The shell command to execute.
 * 
 * @return void
 * 
 */
function solar_passthru($cmd)
{
    echo "\$ $cmd\n";
    passthru($cmd, $status);
    return $status;
}

/**
 * 
 * Prints, then executes a shell command with exec().
 * 
 * @param string $cmd The shell command to execute.
 * 
 * @param array &$output This array is cleared and then filled with
 * output lines.
 * 
 * @return string The last line of the output.
 * 
 */
function solar_exec($cmd, &$output)
{
    $output = null;
    echo "\$ $cmd\n";
    return exec($cmd, $output);
}

// remove previous release files, if any
solar_passthru("rm trunk/*.xml");
solar_passthru("rm trunk/*.tgz");

// clean dotfiles
solar_passthru('php clean.php');

// update keywords
solar_passthru('php keywords.php');

// make sure relevant files are up-to-date
$result = solar_exec('svn status info/ trunk/', $output);
if (trim($result) != '') {
    echo implode("\n", $output) . "\n";
    echo "Info and/or trunk not up-to-date. Please handle outstanding issues.\n";
    exit(1);
}

// // make sure all tests pass
// $result = solar_exec('cd trunk/tests/; ./phpunit AllTests.php', $output);
// if (in_array("FAILURES!", $output)) {
//     echo implode("\n", $output) . "\n";
//     echo "\nAt least one test failed.  Please run tests manually and resolve.\n";
//     exit(1);
// }

// // generate docs
// solar_passthru('/Users/pmjones/Sites/dev/solarweb/make-docs.sh');

// whether or not we're doing a full commit
$commit = isset($argv[1]) && $argv[1] == 'commit';

// ---------------------------------------------------------------------
// 
// RELEASE INFORMATION
// 

// get all files in the info directory, reverse-sorted
$dir = dirname(__FILE__) . '/info';
$list = scandir($dir, 1);

// grab number for most-recent version and set directory
$version = '0.0.0';
foreach ($list as $val) {
    if (version_compare($val, $version, ">")) {
        $version = $val;
    }
}
$dir .= "/$version";

// get release-specific info
$stability = file_get_contents("$dir/stability");
$summary   = file_get_contents("$dir/summary");
$descr     = file_get_contents("$dir/description");
$notes     = file_get_contents("$dir/notes");

// get maintainers
$list = file("$dir/maintainers");
$maintainers = array();
foreach ($list as $data) {
    
    // ignore blank lines
    if (trim($data) == '') {
        continue;
    }
    
    $person = explode(',', trim($data));
    array_walk($person, 'trim');
    $maintainers[] = $person;
}


// ---------------------------------------------------------------------
// 
// BUILD THE PACKAGE
// 

require_once 'PEAR/PackageFileManager2.php';
PEAR::setErrorHandling(PEAR_ERROR_PRINT);
$pkg = new PEAR_PackageFileManager2;

$opts = array(
    'baseinstalldir'    => '/',
    'packagefile'       => 'package2.xml',
    'packagedirectory'  => dirname(__FILE__) . '/trunk/',
    'filelistgenerator' => 'file',
    'roles'             => array(
        '*' => 'php',
    ),
    'exceptions'        => array(
        'tests/*' => 'test',
        'docs/*'  => 'doc',
    ),
);

$e = $pkg->setOptions($opts);

$pkg->setPackage('Solar');
$pkg->setSummary($summary);
$pkg->setDescription($descr);

foreach ($maintainers as $person) {
    $result = call_user_func_array(
        array($pkg, 'addMaintainer'),
        $person
    );
}

$pkg->setChannel('solarphp.com');
$pkg->setAPIVersion($version);
$pkg->setReleaseVersion($version);
$pkg->setReleaseStability($stability);
$pkg->setAPIStability($stability);
$pkg->setPackageType('php');
$pkg->addRelease();
$pkg->setNotes($notes);
$pkg->setPhpDep('5.2.0');
$pkg->setPearinstallerDep('1.4.6');
$pkg->setLicense('BSD', 'http://www.opensource.org/licenses/bsd-license.php');

$pkg->addGlobalReplacement('package-info', '@package_version@', 'version');
$pkg->addGlobalReplacement('package-info', '@package_date@', 'date');

// 0 => 'name',
// 1 => 'summary',
// 2 => 'channel',
// 3 => 'notes',
// 4 => 'extends',
// 5 => 'description',
// 6 => 'release_notes',
// 7 => 'license',
// 8 => 'release-license',
// 9 => 'license-uri',
// 10 => 'version',
// 11 => 'api-version',
// 12 => 'state',
// 13 => 'api-state',
// 14 => 'release_date',
// 15 => 'date',
// 16 => 'time',

$pkg->generateContents();


// write the package file
echo "\nWrite package file...\n";
$compat =& $pkg->exportCompatiblePackageFile1();
$compat->writePackageFile();
$pkg->writePackageFile();

// create the package.
// creates package.xml, package2.xml, and the .tgz file
solar_passthru('cd trunk; pear package');


// ---------------------------------------------------------------------
// 
// COMMIT THE RELEASE
// 

if (! $commit) {
    // not committing the release, so we're done
    echo "Flag for 'commit' not specified; release process complete.\n";
    exit(0);
}

// copy trunk to tags/release-x.y.z
// and commit with release message
solar_passthru("svn copy trunk tags/release-$version");
solar_passthru("svn add tags/release-$version/*");
solar_passthru("svn commit -m \"tagged release $version\" tags/release-$version");

echo "Done.\n";
exit(0);