/**
  * 
  * Model-specific setup.
  * 
  * @return void
  * 
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_belongsTo('node');
 }

 /**
  * 
  * Write out a series of dirs and symlinks for a new Vendor source.
  * 
  * @param string $vendor The Vendor name.
  * 
  * @return void
  * 
  */
 protected function _exec($vendor = null)
 {
     // we need a vendor name, at least
     if (!$vendor) {
         throw $this->_exception('ERR_NO_VENDOR_NAME');
     }
     $this->_outln("Removing links for vendor '{$vendor}' ...");
     // build "foo-bar" and "FooBar" versions of the vendor name.
     $this->_inflect = Solar_Registry::get('inflect');
     $this->_dashes = $this->_inflect->camelToDashes($vendor);
     $this->_studly = $this->_inflect->dashesToStudly($this->_dashes);
     // the base system dir
     $system = Solar::$system;
     // the links to remove (reverse order from make-vendor)
     $links = array("script/{$this->_dashes}", "include/Mock/{$this->_studly}", "include/Test/{$this->_studly}", "include/{$this->_studly}");
     // remove the links
     foreach ($links as $link) {
         $this->_out("    Removing '{$link}' ... ");
         $path = "{$system}/{$link}";
         if (Solar_File::exists($path)) {
             unlink($path);
             $this->_outln("done.");
         } else {
             $this->_outln("missing.");
         }
     }
     // done!
     $this->_outln("... done.");
     // reminders
     $this->_outln("Remember to remove '{$this->_studly}_App' from the " . "['Solar_Controller_Front']['classes'] element " . "in your config file.");
     $this->_outln("Remember to remove '{$this->_studly}_Model' from the " . "['Solar_Sql_Model_Catalog']['classes'] element " . "in your config file.");
     // need to write a recursive-remove method for Solar_Dir that will
     // delete only the symlinked files (not the real files)
     $this->_outln("You will need to remove the " . "'docroot/public/{$this->_studly}' directory yourself, as it " . "may contain copies of public assets (not links).");
 }

 /**
  *
  * Model-specific setup.
  *
  * @return void
  *
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = $this->_config['prefix'] . Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_hasMany('moduleinfo', array('foreign_class' => 'Foresmo_Model_ModuleInfo', 'foreign_key' => 'module_id'));
 }

 /**
  *
  * Model-specific setup.
  *
  * @return void
  *
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = $this->_config['prefix'] . Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_belongsTo('comments', array('foreign_class' => 'Foresmo_Model_Comments'));
 }

 /**
  * 
  * Fetches the roles for a username.
  * 
  * @param string $handle User handle to get roles for.
  * 
  * @return array An array of discovered roles.
  * 
  */
 public function fetch($handle)
 {
     // force the full, real path to the file
     $file = realpath($this->_config['file']);
     // does the file exist?
     if (!Solar_File::exists($file)) {
         throw $this->_exception('ERR_FILE_NOT_READABLE', array('file' => $file));
     }
     // load the file as an array of lines
     $lines = file($file);
     // the discovered roles
     $roles = array();
     // loop through each line, find the group, then see if the user
     // is on the line anywhere
     foreach ($lines as $line) {
         // eliminate all spaces, which cause mismatches when we get to
         // in_array() later
         $line = preg_replace("/\\s/", '', $line);
         // break apart at first ':'
         $pos = strpos($line, ':');
         // the group name is the part before the ':'
         $group = substr($line, 0, $pos);
         // the list of user handles comes after
         $tmp = substr($line, $pos + 1);
         $list = explode(',', $tmp);
         // is the user part of the group?
         if (in_array($handle, $list)) {
             $roles[] = $group;
         }
     }
     // done!
     return $roles;
 }

 /**
  * 
  * Loads a class or interface file from the include_path.
  * 
  * Thanks to Robert Gonzalez  for the report leading to this method.
  * 
  * @param string $name A Solar (or other) class or interface name.
  * 
  * @return void
  * 
  * @todo Add localization for errors
  * 
  */
 public static function autoload($name)
 {
     // did we ask for a non-blank name?
     if (trim($name) == '') {
         throw Solar::exception('Solar_Class', 'ERR_AUTOLOAD_EMPTY', 'No class or interface named for loading.', array('name' => $name));
     }
     // pre-empt further searching for the named class or interface.
     // do not use autoload, because this method is registered with
     // spl_autoload already.
     $exists = class_exists($name, false) || interface_exists($name, false);
     if ($exists) {
         return;
     }
     // convert the class name to a file path.
     $file = str_replace('_', DIRECTORY_SEPARATOR, $name) . '.php';
     // include the file and check for failure. we use Solar_File::load()
     // instead of require() so we can see the exception backtrace.
     Solar_File::load($file);
     // if the class or interface was not in the file, we have a problem.
     // do not use autoload, because this method is registered with
     // spl_autoload already.
     $exists = class_exists($name, false) || interface_exists($name, false);
     if (!$exists) {
         throw Solar::exception('Solar_Class', 'ERR_AUTOLOAD_FAILED', 'Class or interface does not exist in loaded file', array('name' => $name, 'file' => $file));
     }
 }

 /**
  * 
  * Model-specific setup.
  * 
  * @return void
  * 
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_index = Solar_File::load($dir . 'index_info.php');
     /**
      * Special columns
      */
     $this->_serialize_cols[] = 'prefs';
     $this->_calculate_cols[] = 'tags_as_string';
     /**
      * Filters
      */
     // make sure the name is unique for its area and model
     $where = array('inherit = :inherit', 'area_id = :area_id');
     $this->_addFilter('name', 'validateUnique', $where);
     // other filters
     $this->_addFilter('email', 'validateEmail');
     $this->_addFilter('uri', 'validateUri');
     $this->_addFilter('editor_ipaddr', 'validateIpv4');
     $this->_addFilter('locale', 'validateLocaleCode');
     $this->_addFilter('mime', 'validateMimeType');
     $this->_addFilter('tags_as_string', 'validateSepWords');
     /**
      * Relationships.
      */
     $this->_belongsTo('area');
     $this->_hasMany('taggings');
     $this->_hasMany('tags', array('through' => 'taggings'));
 }

 /**
  *
  * Model-specific setup.
  *
  * @return void
  *
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = $this->_config['prefix'] . Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_hasMany('userinfo', array('foreign_class' => 'Foresmo_Model_UserInfo', 'foreign_key' => 'user_id'));
     $this->_hasOne('groups', array('foreign_class' => 'Foresmo_Model_Groups', 'native_col' => 'group_id', 'foreign_col' => 'id'));
 }

 /**
  *
  * Model-specific setup.
  *
  * @return void
  *
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = $this->_config['prefix'] . Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_hasMany('posts_tags', array('foreign_class' => 'Foresmo_Model_PostsTags', 'foreign_key' => 'tag_id'));
     $this->_hasMany('posts', array('foreign_class' => 'Foresmo_Model_Posts', 'through' => 'posts_tags', 'through_key' => 'post_id', 'through_native_col' => 'tag_id', 'through_foreign_col' => 'post_id', 'conditions' => array('status = ?' => array(1))));
 }

 public function setup()
 {
     // easier to do this here than as a property, since we use functions.
     $this->_config = array('adapters' => array(array('adapter' => 'Solar_Log_Adapter_File', 'events' => 'debug', 'file' => Solar_File::tmp('test_solar_log_adapter_multi.debug.log'), 'format' => '%e %m'), array('adapter' => 'Solar_Log_Adapter_File', 'events' => 'info, notice', 'file' => Solar_File::tmp('test_solar_log_adapter_multi.other.log'), 'format' => '%e %m')));
     parent::setup();
     @unlink($this->_config['adapters'][0]['file']);
     @unlink($this->_config['adapters'][1]['file']);
 }

 /**
  * 
  * Model setup.
  * 
  * @return void
  * 
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_model_name = 'users';
     $this->_index = array('created', 'updated', 'handle' => 'unique');
 }

 /**
  *
  * Model-specific setup.
  *
  * @return void
  *
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = $this->_config['prefix'] . Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_belongsTo('tags', array('foreign_key' => 'id'));
     $this->_belongsTo('posts', array('foreign_key' => 'id'));
 }

 /**
  *
  * Model-specific setup.
  *
  * @return void
  *
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = $this->_config['prefix'] . Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_hasMany('comments');
     $this->_hasMany('permissions', array('through' => 'groupspermissions'));
 }

 public function testCallbacks_instanceMethod()
 {
     $file = Solar_Class::dir('Mock_Solar') . 'callbacks-instance-method.php';
     Solar_File::load($file);
     $instance = Solar::factory('Solar_Callbacks_Instance_Method');
     Solar::callbacks(array(array($instance, 'callback')));
     $this->assertTrue($GLOBALS['SOLAR_CALLBACKS_INSTANCE_METHOD']);
 }

 /**
  * 
  * Model setup.
  * 
  * @return void
  * 
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_addFilter('email', 'validateEmail');
     $this->_addFilter('uri', 'validateUri');
     $this->_index_info = array('created', 'updated', 'email' => 'unique', 'uri');
 }

 /**
  * 
  * Model setup.
  * 
  * @return void
  * 
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_model_name = 'tags';
     $this->_hasMany('taggings');
     $this->_hasMany('nodes', array('through' => 'taggings'));
     $this->_index = array('name' => 'unique');
 }

 /**
  * 
  * Model setup.
  * 
  * @return void
  * 
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_model_name = 'areas';
     $this->_hasMany('nodes');
     $this->_belongsTo('user');
     $this->_index = array('created', 'updated', 'user_id');
 }

 /**
  * 
  * Model setup.
  * 
  * @return void
  * 
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_model_name = 'taggings';
     $this->_belongsTo('node');
     $this->_belongsTo('tag');
     $this->_index = array('node_id', 'tag_id');
 }

 /**
  * 
  * Model setup.
  * 
  * @return void
  * 
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     // recognize sequence columns
     $this->_sequence_cols = array('seq_foo' => 'test_solar_foo', 'seq_bar' => 'test_solar_bar');
     // recognize serialize columns
     $this->_serialize_cols = 'serialize';
 }

 /**
  *
  * Model-specific setup.
  *
  * @return void
  *
  */
 protected function _setup()
 {
     $dir = str_replace('_', DIRECTORY_SEPARATOR, __CLASS__) . DIRECTORY_SEPARATOR . 'Setup' . DIRECTORY_SEPARATOR;
     $this->_table_name = $this->_config['prefix'] . Solar_File::load($dir . 'table_name.php');
     $this->_table_cols = Solar_File::load($dir . 'table_cols.php');
     $this->_hasMany('postinfo', array('foreign_class' => 'Foresmo_Model_PostInfo', 'foreign_key' => 'post_id'));
     $this->_hasMany('comments', array('foreign_class' => 'Foresmo_Model_Comments', 'foreign_key' => 'post_id'));
     $this->_hasMany('posts_tags', array('foreign_class' => 'Foresmo_Model_PostsTags', 'foreign_key' => 'post_id'));
     $this->_hasMany('tags', array('foreign_class' => 'Foresmo_Model_Tags', 'through' => 'posts_tags', 'through_key' => 'tag_id'));
     $this->_hasOne('users', array('foreign_class' => 'Foresmo_Model_Users', 'cols' => array('id', 'username', 'email'), 'native_col' => 'user_id', 'foreign_col' => 'id'));
 }