<?php
/*
 *  $Id: ChmodTask.php 4046 2005-04-22 13:41:56Z chregu $
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * This software consists of voluntary contributions made by many individuals
 * and is licensed under the LGPL. For more information please see
 * <http://phing.info>.
 */

require_once 'phing/Task.php';
include_once 'phing/types/FileSet.php';

/**
 * Task that changes the permissions on a file/directory.
 *
 * @author    Manuel Holtgrewe <grin@gmx.net>
 * @author    Hans Lellelid <hans@xmpl.org>
 * @version   $Revision: 1.10 $
 * @package   phing.tasks.system
 */
class ChmodTask extends Task {

    private $file;

    private $mode;

    private $filesets = array();

    private $filesystem;
	
	private $quiet = false;	
	private $failonerror = true;
	
	/**
	 * This flag means 'note errors to the output, but keep going'
	 * @see setQuiet()
	 */
    function setFailonerror($bool) {
        $this->failonerror = $bool;
    }	

    /**
     * Set quiet mode, which suppresses warnings if chmod() fails.
	 * @see setFailonerror()
     */
    function setQuiet($bool) {
        $this->quiet = $bool;
        if ($this->quiet) {
            $this->failonerror = false;
        }
    }
	
    /**
     * Sets a single source file to touch.  If the file does not exist
     * an empty file will be created.
     */
    function setFile(File $file) {        
        $this->file = $file;
    } 

    function setMode($str) {
        $this->mode = $str;
    }

    /**
     * Nested creator, adds a set of files (nested fileset attribute).
     */
    function createFileSet() {
        $num = array_push($this->filesets, new FileSet());
        return $this->filesets[$num-1];
    }

    /**
     * Execute the touch operation.
     * @return void
     */
    function main() {
        // Check Parameters
        $this->checkParams();       
        $this->chmod();
    }
    
    /**
     * Ensure that correct parameters were passed in.
     * @return void
     */
    private function checkParams() {
    
        if ($this->file === null && empty($this->filesets)) {
            throw new BuildException("Specify at least one source - a file or a fileset.");
        }

        if ($this->mode === null) {
            throw new BuildException("You have to specify an octal mode for chmod.");
        }

        // check for mode to be in the correct format
        if (!preg_match('/^([0-7]){3}$/', $this->mode)) {
            throw new BuildException("You have specified an invalid mode.");
        }
     
    }

    /**
     * Does the actual work.
     * @return void
     */
    private function chmod() {
    
        $mode = octdec("0". $this->mode);

        // one file
        if ($this->file !== null) {
            $this->chmodFile($this->file, $mode);
        }

        // filesets
        foreach($this->filesets as $fs) {
                    
            $ds = $fs->getDirectoryScanner($this->project);
            $fromDir = $fs->getDir($this->project);

            $srcFiles = $ds->getIncludedFiles();
            $srcDirs = $ds->getIncludedDirectories();

            for ($j = 0, $filecount = count($srcFiles); $j < $filecount; $j++) {
                $this->chmodFile(new File($fromDir, $srcFiles[$j]), $mode);
            }

            for ($j = 0, $dircount = count($srcDirs); $j <  $dircount; $j++) {
                $this->chmodFile(new File($fromDir, $srcDirs[$j]), $mode);
            }
        }

    }

	/**
	 * Actually change the mode for the file.
	 * @param File $file
	 * @param int $mode
	 */
    private function chmodFile(File $file, $mode) {
        if ( !$file->exists() ) {
            throw new BuildException("The file " . $file->__toString() . " does not exist");
        }   
		     
		try {
			$file->setMode($mode);
			$this->log("Changed file mode on '" . $file->__toString() ."' to " . vsprintf("%o", $mode));
		} catch (Exception $e) {
			if($this->failonerror) {
				throw $e;
			} else {
				$this->log($e->getMessage(), $this->quiet ? PROJECT_MSG_VERBOSE : PROJECT_MSG_WARN);
			}
		}
    }
	
}

