<?php
/**
 * Aco Shell.
 * 
 * Automates the creation of ACO nodes for CakePHP applications.
 *
 * Copyright 2008, Mark Story.
 * 823 millwood rd. 
 * toronto, ontario M4G 1W3
 *
 * Licensed under The MIT License
 * Redistributions of files must retain the above copyright notice.
 *
 * @copyright Copyright 2008, Mark Story.
 * @link http://mark-story.com
 * @version 0.5
 * @author Mark Story <mark@mark-story.com>
 * @license http://www.opensource.org/licenses/mit-license.php The MIT License
 */
App::import('Component', 'Acl');
App::import('Model', 'DbAcl');
/**
 * Shell for ACO sync
 *
 * @package		cake
 * @subpackage	cake.cake.console.libs
 */
class AcoSyncShell extends Shell {
/**
 * Contains instance of AclComponent
 *
 * @var object
 * @access public
 */
	var $Acl;
/**
 * Contains arguments parsed from the command line.
 *
 * @var array
 * @access public
 */
	var $args;
/**
 * Contains database source to use
 *
 * @var string
 * @access public
 */
	var $dataSource = 'default';
 
/**
 * Root node name.
 *
 * @var string
 **/
	var $rootNode = 'controllers';
 
/**
 * Internal Clean Actions switch
 *
 * @var boolean
 **/
	var $_clean = false;
 
/**
 * Start up And load Acl Component / Aco model
 *
 * @return void
 **/	
	function startup() {
		$this->Acl =& new AclComponent();
		$controller = null;
		$this->Acl->startup($controller);
		$this->Aco =& $this->Acl->Aco;
	}
 
/**
 * Override main() for help message hook
 *
 * @access public
 */
	function main() {
		$out  = __("Available ACO sync commands:", true) . "\n";
		$out .= "\t - update\n";
		$out .= "\t - sync\n";
		$out .= "\t - help\n\n";
		$out .= __("For help, run the 'help' command.  For help on a specific command, run 'help <command>'", true);
		$this->out($out);
	}
 
/**
 * undocumented function
 *
 * @return void
 **/
	function update() {
		$root = $this->_checkNode($this->rootNode, $this->rootNode, null);
		App::import('Core', array('Controller'));
 
		$Controllers = Configure::listObjects('controller');
		$appIndex = array_search('App', $Controllers);
		if ($appIndex !== false	) {
			unset($Controllers[$appIndex]);
		}
		// look at each controller in app/controllers
		foreach ($Controllers as $ctrlName) {
			App::import('Controller', $ctrlName);
			// find / make controller node
			$controllerNode = $this->_checkNode($this->rootNode .'/'.$ctrlName, $ctrlName, $root['Aco']['id']);
			$this->_checkMethods($ctrlName, $controllerNode, $this->_clean);
		}
		if ($this->_clean) {
			$this->Aco->id = $root['Aco']['id'];
			$controllerNodes = $this->Aco->children(null, true);
			$ctrlFlip = array_flip($Controllers);
			foreach ($controllerNodes as $ctrlNode) {
				if (!isset($ctrlFlip[$ctrlNode['Aco']['alias']])) {
					$this->Aco->id = $ctrlNode['Aco']['id'];
					if ($this->Aco->delete()) {
						$this->out(sprintf(__('Deleted %s and all children', true), $this->rootNode . '/' . $ctrlNode['Aco']['alias']));
					}
				}
			}
		}
		$this->out(__('Aco Update Complete', true));
		return true;
	}
 
/**
 * Sync the ACO table
 *
 * @return void
 **/
	function sync() {
		$this->_clean = true;
		$this->update();
	}
 
/**
 * Check a node for existance, create it if it doesn't exist.
 *
 * @param string $path 
 * @param string $alias 
 * @param int $parentId 
 * @return array Aco Node array
 */
	function _checkNode($path, $alias, $parentId = null) {
		$node = $this->Aco->node($path);
		if (!$node) {
			$this->Aco->create(array('parent_id' => $parentId, 'model' => null, 'alias' => $alias));
			$node = $this->Aco->save();
			$node['Aco']['id'] = $this->Aco->id; 
			$this->out(sprintf(__('Created Aco node: %s', true), $path));
		} else {
			$node = $node[0];
		}
		return $node;
	}
 
/**
 * Check and Add/delete controller Methods
 *
 * @param string $controller 
 * @param array $node 
 * @param bool $cleanup 
 * @return void
 */
	function _checkMethods($controller, $node, $cleanup = false) {
		$className = $controller . 'Controller';
		$baseMethods = get_class_methods('Controller');
		$actions = get_class_methods($className);
		$methods = array_diff($actions, $baseMethods);
		foreach ($methods as $action) {
			if (strpos($action, '_', 0) === 0) {
				continue;
			}
			$this->_checkNode($this->rootNode . '/' . $controller . '/' . $action, $action, $node['Aco']['id']);
		}
		if ($cleanup) {
			$actionNodes = $this->Aco->children($node['Aco']['id']);
			$methodFlip = array_flip($methods);
			foreach ($actionNodes as $action) {
				if (!isset($methodFlip[$action['Aco']['alias']])) {
					$this->Aco->id = $action['Aco']['id'];
					if ($this->Aco->delete()) {
						$path = $this->rootNode . '/' . $controller . '/' . $action['Aco']['alias'];
						$this->out(sprintf(__('Deleted Aco node %s', true), $path));
					}
				}
			}
		}
		return true;
	}
 
 
/**
 * Show help screen.
 *
 * @access public
 */
	function help() {
		$head  = __("Usage: cake aco_sync <command>", true) . "\n";
		$head .= "-----------------------------------------------\n";
		$head .= __("Commands:", true) . "\n\n";
 
		$commands = array(
			'update' => "\tcake aco_sync update\n" .
						"\t\t" . __("Add new ACOs for new controllers and actions", true) . "\n" . 
						"\t\t" . __("Create new ACO's for controllers and their actions. Does not remove any nodes from ACO table", true), 
 
			'sync' =>	"\tcake aco_sync sync\n" . 
						"\t\tPerform a full sync on the ACO table.\n" .
						"\t\t" . __("Creates new ACO's for missing controllers and actions. Removes orphaned entries in the ACO table.", true) . "\n",
 
			'help' => 	"\thelp [<command>]\n" .
						"\t\t" . __("Displays this help message, or a message on a specific command.", true) . "\n"
		);
 
		$this->out($head);
		if (!isset($this->args[0])) {
			foreach ($commands as $cmd) {
				$this->out("{$cmd}\n\n");
			}
		} elseif (isset($commands[low($this->args[0])])) {
			$this->out($commands[low($this->args[0])] . "\n");
		} else {
			$this->out(sprintf(__("Command '%s' not found", true), $this->args[0]));
		}
	}
}
?>