<?php

require_once 'api/v3/utils.php';

/**
 *  returns the list of all the entities that you can manipulate via the api. The entity of this API call is the entity, that isn't a real civicrm entity as in something stored in the DB, but an abstract meta object. My head is going to explode. In a meta way.
 */
function civicrm_api3_entity_get($params) {

  civicrm_api3_verify_mandatory($params);
  $entities = array();
  $include_dirs = array_unique(explode(PATH_SEPARATOR, get_include_path()));
  #$include_dirs = array(dirname(__FILE__). '/../../');
  foreach ($include_dirs as $include_dir) {
    $api_dir = implode(DIRECTORY_SEPARATOR, array($include_dir, 'api', 'v3'));
    if (! is_dir($api_dir)) {
      continue;
    }
    $iterator = new DirectoryIterator($api_dir);
  foreach ($iterator as $fileinfo) {
    $file = $fileinfo->getFilename();

      // Check for entities with a master file ("api/v3/MyEntity.php")
    $parts = explode(".", $file);
      if (end($parts) == "php" && $file != "utils.php" && !preg_match('/Tests?.php$/', $file) ) {
      // without the ".php"
      $entities[] = substr($file, 0, -4);
    }

      // Check for entities with standalone action files ("api/v3/MyEntity/MyAction.php")
      $action_dir = $api_dir . DIRECTORY_SEPARATOR . $file;
      if (preg_match('/^[A-Z][A-Za-z0-9]*$/', $file) && is_dir($action_dir)) {
        if (count(glob("$action_dir/[A-Z]*.php")) > 0) {
          $entities[] = $file;
  }
      }
    }
  }
  $entities = array_diff($entities, array('Generic'));
  $entities = array_unique($entities);
  sort($entities);
  return civicrm_api3_create_success($entities);
}

/**
 *  Placeholder function. This should never be called, as it doesn't have any meaning
 */
function civicrm_api3_entity_create($params) {
  return civicrm_api3_create_error("API (Entity, Create) does not exist Creating a new entity means modifying the source code of civiCRM.");
}

/**
 *  Placeholder function. This should never be called, as it doesn't have any meaning
 */
function civicrm_api3_entity_delete($params) {
  return civicrm_api3_create_error("API (Entity, Delete) does not exist Deleting an entity means modifying the source code of civiCRM.");
}

/**
 *  Placeholder function. This should never be called, as it doesn't have any meaning
 */
function civicrm_api3_entity_getfields($params) {
  // we return an empty array so it makes it easier to write generic getdefaults / required tests
  // without putting an exception in for entity
  return civicrm_api3_create_success(array());
}