File Source for tangra_module

<?php
// $Id$
/**
* Contains class Tangra_Module_Release
*
* @package tangra_lib
* @subpackage modules_manager
*/
/**
*
*/
require_once(TANGRA_MAIN_DIR.'nls/date.inc.php');
/**
* Tangra module release
*
* @package tangra_lib
* @subpackage modules_manager
*/
class Tangra_Module_Release extends Tangra_Class {
/**
* ID
*
* @var integer
* @internal
*/
private $id;
/**
* Module ID
*
* @var integer
* @internal
*/
private $module;
/**
* Release version
*
* @var string
* @internal
*/
private $version;
/**
* Description
*
* @var string
* @internal
*/
private $description;
/**
* Maintainer's email
*
* @var string
* @internal
*/
private $maintainer;
/**
* URL of module info page
*
* @var string
* @internal
*/
private $url;
/**
* Minimal requirement for tangra_lib version
*
* @var string
* @internal
*/
private $requires_tangra_lib_version = '2.0.0alpha1';
/**
* Minimal requirement for PHP version
*
* @var string
* @internal
*/
private $requires_php_version = '5.1.0';
/**
* Is release online?
*
* @var booelan
* @internal
*/
private $online = false;
/**
* Datetime of release
*
* @var string
* @internal
*/
private $release_date = '0000-00-00';
/**
* Change notes
*
* @var string
* @internal
*/
private $changes;
/**
* Sets ID
*
* @param integer $id
*/
public function set_id($id) {
tangra_if_not_int_throw_e($id);
$this->id = $id;
}
/**
* Gets ID
*
* @return integer
*/
public function get_id() {
return $this->id;
}
/**
* Sets module ID
*
* @param integer $module
*/
public function set_module($module) {
tangra_if_not_int_throw_e($module);
$this->module = $module;
}
/**
* Gets module ID
*
* @return integer
*/
public function get_module() {
return $this->module;
}
/**
* Sets release version
*
* @param string $version
*/
public function set_version($version) {
if (ereg("^([0-9]{1,2}\.[0-9]{1,2}\.[0-9]{1,2})([A-Za-z]{1,5}[0-9]{0,2})?$", trim($version))) {
$this->version = $version;
} else {
throw new Tangra_Exception("Invalid version literal: $version. Must conform: ^([0-9]{1,2}\.[0-9]{1,2}\.[0-9]{1,2})([A-Za-z]{1,5}[0-9]{0,2})?$");
}
}
/**
* Gets version
*
* @return string
*/
public function get_version() {
return $this->version;
}
/**
* Sets description
*
* @param string $description
*/
public function set_description($description) {
$this->description = $description;
}
/**
* Gets description
*
* @return string
*/
public function get_description() {
return $this->description;
}
/**
* Sets maintainer's email
*
* @param string $maintainer
*/
public function set_maintainer($maintainer) {
//TODO check if maintainer field comforms RFC822, i.e. name <email address>
$this->maintainer = $maintainer;
}
/**
* Gets maintainer's email
*
* @return string
*/
public function get_maintainer() {
return $this->maintainer;
}
/**
* Sets URL for info page
*
* @param string $url
*/
public function set_url($url) {
$this->url = $url;
}
/**
* Gets URL for info page
*
* @return unknown
*/
public function get_url() {
return $this->url;
}
/**
* Sets required minimal version of tangra_lib
*
* @param string $requires_tangra_lib_version
*/
public function set_requires_tangra_lib_version($requires_tangra_lib_version) {
if (ereg("^([0-9]{1,2}\.[0-9]{1,2}\.[0-9]{1,2})([A-Za-z]{1,5}[0-9]{0,2})?$", trim($requires_tangra_lib_version))) {
$this->requires_tangra_lib_version = $requires_tangra_lib_version;
} else {
throw new Tangra_Exception("Invalid requires_tangra_lib_version literal: $requires_tangra_lib_version. Must conform: ^([0-9]{1,2}\.[0-9]{1,2}\.[0-9]{1,2})([A-Za-z]{1,5}[0-9]{0,2})?$");
}
}
/**
* Gets required minimal version of tangra_lib
*
* @return string
*/
public function get_requires_tangra_lib_version() {
return $this->requires_tangra_lib_version;
}
/**
* Sets required minimal version of PHP
*
* @param string $requires_php_version
*/
public function set_requires_php_version($requires_php_version) {
if (ereg("^([0-9]{1,2}\.[0-9]{1,2}\.[0-9]{1,2})([A-Za-z]{1,5}[0-9]{0,2})?$", trim($requires_php_version))) {
$this->requires_php_version = $requires_php_version;
} else {
throw new Tangra_Exception("Invalid requires_php_version literal: $requires_php_version. Must conform: ^([0-9]{1,2}\.[0-9]{1,2}\.[0-9]{1,2})([A-Za-z]{1,5}[0-9]{0,2})?$");
}
}
/**
* Gets required minimal version of PHP
*
* @return string
*/
public function get_requires_php_version() {
return $this->requires_php_version;
}
/**
* Sets is online? flag
*
* @param booleand $online
*/
public function set_online($online) {
$this->online = $online ? true : false;
}
/**
* Gets is online? flag
*
* @return boolean
*/
public function get_online() {
return $this->online;
}
/**
* Sets release date
*
* @param string $release_date Date of the release
*/
public function set_release_date($release_date) {
if ($release_date != '0000-00-00') {
if (is_valid_date($release_date)) {
$this->release_date = $release_date;
} else {
throw new Tangra_Exception('Invalid release date.');
}
} else {
$this->release_date = $release_date;
}
}
/**
* Gets release date
*
* @return string
*/
public function get_release_date() {
return $this->release_date;
}
/**
* Sets change notes
*
* @param string $changes
*/
public function set_changes($changes) {
$this->changes = $changes;
}
/**
* Gets change notes
*
* @return string
*/
public function get_changes() {
return $this->changes;
}
}

Source for file tangra_module_release.class.php