<?php

namespace Boris;

/**
 * Config handles loading configuration files for boris
 */
class Config
{
    private $_searchPaths;
    private $_cascade = false;
    private $_files = array();
    
    /**
     * Create a new Config instance, optionally with an array
     * of paths to search for configuration files.
     *
     * Additionally, if the second, optional boolean argument is
     * true, all existing configuration files will be loaded, and
     * effectively merged.
     *
     * @param array $searchPaths
     * @param bool  $cascade
     */
    public function __construct($searchPaths = null, $cascade = false)
    {
        if (is_null($searchPaths)) {
            $searchPaths = array();
            
            if ($userHome = getenv('HOME')) {
                $searchPaths[] = "{$userHome}/.borisrc";
            }
            
            $searchPaths[] = getcwd() . '/.borisrc';
        }
        
        $this->_cascade     = $cascade;
        $this->_searchPaths = $searchPaths;
    }
    
    /**
     * Searches for configuration files in the available
     * search paths, and applies them to the provided
     * boris instance.
     *
     * Returns true if any configuration files were found.
     *
     * @param  Boris\Boris $boris
     * @return bool
     */
    public function apply(Boris $boris)
    {
        $applied = false;
        
        foreach ($this->_searchPaths as $path) {
            if (is_readable($path)) {
                $this->_loadInIsolation($path, $boris);
                
                $applied        = true;
                $this->_files[] = $path;
                
                if (!$this->_cascade) {
                    break;
                }
            }
        }
        
        return $applied;
    }
    
    /**
     * Returns an array of files that were loaded
     * for this Config
     *
     * @return array
     */
    public function loadedFiles()
    {
        return $this->_files;
    }
    
    // -- Private Methods
    
    private function _loadInIsolation($path, $boris)
    {
        require $path;
    }
}