<?php
/*=====================================================================*\
|| ###################################################################
|| # ViewSVN [#]version[#]
|| # Copyright ©2002-[#]year[#] Blue Static
|| #
|| # This program is free software; you can redistribute it and/or modify
|| # it under the terms of the GNU General Public License as published by
|| # the Free Software Foundation; version [#]gpl[#] of the License.
|| #
|| # This program is distributed in the hope that it will be useful, but
|| # WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|| # or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|| # more details.
|| #
|| # You should have received a copy of the GNU General Public License along
|| # with this program; if not, write to the Free Software Foundation, Inc.,
|| # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
|| ###################################################################
\*=====================================================================*/

/**
* Revision
*
* This class represents one revision in a given repository
*
* @author		Blue Static
* @copyright	Copyright (c)2002 - [#]year[#], Blue Static
* @version		$Revision$
* @package		ViewSVN
*
*/
class Revision
{
	/**
	* Repository path
	* @var string
	*/
	private $path;
	
	/**
	* Repository name
	* @var string
	*/
	private $repos;
	
	/**
	* The subpath inside the repository we're getting info for
	* @var string
	*/
	private $subpath;
	
	/**
	* The revision number
	* @var integer
	*/
	public $revision;
	
	/**
	* The commmit message for this revision
	* @var string
	*/
	public $message;
	
	/**
	* The unparsed/unformatted log message
	* @var string
	*/
	public $messageClean;
	
	/**
	* Author who committed the revision
	* @var string
	*/
	public $author;
	
	/**
	* The date and time this revision was made
	* @var string
	*/
	public $datetime;
	
	/**
	* Files changed by the revision
	* @var array
	*/
	public $files = array();
	
	// ###################################################################
	/**
	* Creates a new revision for a given repository and revision
	*
	* @param	string	Repository
	* @param	integer	Revision to get; to get HEAD, specify 0
	* @param	string	Path inside the repository to get info for
	*/
	public function __construct($repos, $rev = 0, $subpath = null)
	{
		$this->path = BSRegister::Get('repos')->fetchPath($repos);
		$this->repos = $repos;
		$this->subpath = $subpath;
		
		$this->_fetchRevision($rev);
	}
	
	// ###################################################################
	/**
	* Returns an array of properties for this revision at a certain path
	*
	* @param	string	Path
	*
	* @return	array	Array of properties
	*/
	public function getPropsForPath($path)
	{
		$output = BSRegister::Get('lib')->run('proplist -v -r' . $this->revision . ' ' . BSRegister::Get('lib')->arg($this->path . $path) . '@' . $this->revision);
		unset($output[0]);
		
		$proplist = array();
		foreach ($output AS $line)
		{
			if (preg_match('#^\s+(.*)\s:(\s(.*))?#', $line, $matches))
			{
				$curprop = $matches[1];
				$proplist["$curprop"] = $matches[2] . "\n";
			}
			else
			{
				$proplist["$curprop"] .= $line . "\n";
			}
		}
		
		return $proplist;
	}
	
	// ###################################################################
	/**
	* Gets the revision information (commit message, author, date) for the
	* revision
	*/
	public function getRevisionInfo()
	{
		$xml = BSXml::Parse(BSRegister::Get('lib')->run('log --xml -v -r' . $this->revision . ' ' . BSRegister::Get('lib')->arg($this->path) . '@' . $this->revision, true));
		$this->message = FormatLogMessage($xml['log']['logentry']['msg']['value']);
		$this->messasgeClean = $xml['log']['logentry']['msg']['value'];
		$this->datetime = FormatSvnDate($xml['log']['logentry']['date']['value']);
		$this->author = $xml['log']['logentry']['author']['value'];
		$this->files = $xml['log']['logentry']['paths']['path'];
		BSXml::UnifyNode($this->files);
	}
	
	// ###################################################################
	/**
	* Gets the desired XML revision information from the repository
	*
	* @param	integer	Desired revision
	*/
	private function _fetchRevision($desired)
	{
		$xml = BSXml::Parse(BSRegister::Get('lib')->run('log --limit 1 --xml ' . ($desired > 0 ? '-r' . intval($desired) . ' ' : '') . BSRegister::Get('lib')->arg($this->path . $this->subpath) . ($desired > 0 ? '@' . intval($desired) : ''), true));
		$this->revision = intval($xml['log']['logentry']['revision']);
	}
}

/*=====================================================================*\
|| ###################################################################
|| # $HeadURL$
|| # $Id$
|| ###################################################################
\*=====================================================================*/
?>