tests/phpunit/api/v3/APIStandardsTest.php

   1 <?php
   2 // vim: set si ai expandtab tabstop=4 shiftwidth=4 softtabstop=4:
   3
   4 /**
   5  *  File to v3 APIs for Standards compliance
   6  *
   7  *  (PHP 5)
   8  *
   9  *   @copyright Copyright CiviCRM LLC (C) 2009
  10  *   @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html
  11  *              GNU Affero General Public License version 3
  12  *   @version   $Id:
  13  *   @package   CiviCRM
  14  *
  15  *   This file is part of CiviCRM
  16  *
  17  *   CiviCRM is free software; you can redistribute it and/or
  18  *   modify it under the terms of the GNU Affero General Public License
  19  *   as published by the Free Software Foundation; either version 3 of
  20  *   the License, or (at your option) any later version.
  21  *
  22  *   CiviCRM is distributed in the hope that it will be useful,
  23  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
  24  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  25  *   GNU Affero General Public License for more details.
  26  *
  27  *   You should have received a copy of the GNU Affero General Public
  28  *   License along with this program.  If not, see
  29  *   <http://www.gnu.org/licenses/>.
  30  */
  31
  32 /**
  33  *  Include class definitions
  34  */
  35 require_once 'CiviTest/CiviUnitTestCase.php';
  36
  37 /**
  38  *  Test APIv3 civicrm_activity_* functions
  39  *
  40  *  @package CiviCRM_APIv3
  41  *  @todo determine where help functions should sit (here or 'up the tree'), & best way to define API dir
  42  */
  43 class api_v3_APIStandardsTest extends CiviUnitTestCase {
  44
  45   protected $_apiversion;
  46   protected $_apiDir;
  47   protected $_functionFiles;
  48   protected $_regexForGettingAPIStdFunctions;
  49   /* This test case doesn't require DB reset */
  50
  51
  52
  53   public $DBResetRequired = FALSE;
  54
  55   /**
  56    *  Test setup for every test
  57    *
  58    *  Connect to the database, truncate the tables that will be used
  59    *  and redirect stdin to a temporary file
  60    */
  61   public function setUp() {
  62     //  Connect to the database
  63     parent::setUp();
  64     $this->_apiversion = 3;
  65     $this->_apiDir = "../api/v3/";
  66     $this->_functionFiles = array('Entity.php', 'utils.php');
  67
  68     //should possibly insert variable rather than '3' in below
  69     $this->_regexForGettingAPIStdFunctions = '/^civicrm_api3_  #starts with civicrm_api_3 (ignore internal functions)
  70                                                   .*_              #any number of characters up to the last _
  71     # negative look ahead on string getfields
  72                                                   (?:(?!getfields))/x';
  73     // functions to skip from utils.php mainly since they get sucked in via
  74     // a require chain in the include files
  75     $this->_skipFunctionList = array(
  76       // location api is deprecated
  77       'civicrm_api3_location_create',
  78       'civicrm_api3_location_get',
  79       'civicrm_api3_location_delete',
  80       // most of these seem to be internal functions
  81       'civicrm_api3_entity_create',
  82       'civicrm_api3_entity_delete',
  83       'civicrm_api3_survey_respondant_count',
  84       // functions from utils.php
  85       'civicrm_api3_verify_one_mandatory',
  86       'civicrm_api3_verify_mandatory',
  87       'civicrm_api3_get_dao',
  88       'civicrm_api3_create_success',
  89       'civicrm_api3_create_error',
  90       'civicrm_api3_error',
  91       'civicrm_api3_check_contact_dedupe',
  92       'civicrm_api3_api_check_permission',
  93     );
  94   }
  95
  96   /*
  97      * test checks that all v3 API return a standardised error message when
  98      * the $params passed in is not an array.
  99      */
 100   function testParamsNotArray() {
 101     /*I have commented this out as the check for is_array has been moved to civicrm_api. But keeping in place as
 102     * this test, in contrast to the standards test, tests all existing API rather than just CRUD ones
 103     * so want to keep code for re-use
 104         $files = $this->getAllFilesinAPIDir();
 105         $this->assertGreaterThan(1, count($files),"something has gone wrong listing the files in line " . __LINE__);
 106         $this->requireOnceFilesArray($files);
 107         $apiStdFunctions = $this->getAllAPIStdFunctions();
 108         $this->assertGreaterThan(1, count($apiStdFunctions),"something has gone wrong getting the std functions in line " . __LINE__);
 109         $params = 'string';
 110         foreach($apiStdFunctions as $key => $function){
 111             if ( in_array( $function, $this->_skipFunctionList ) ) {
 112                 continue;
 113             }
 114             try {
 115                 $result = $function($params);
 116             } catch ( Exception $e ) {
 117               continue;
 118             }
 119
 120         }*/
 121   }
 122
 123   /*
 124      * Get all the files in the API directory for the relevant version which contain API functions
 125      * @return array $files array of php files in the directory excluding helper files
 126      */
 127   /**
 128    * @return array
 129    */
 130   function getAllFilesinAPIDir() {
 131     $files = array();
 132     $handle = opendir($this->_apiDir);
 133
 134     while (($file = readdir($handle)) !== FALSE) {
 135       if (strstr($file, ".php") &&
 136         $file != 'Entity.php' &&
 137         $file != 'Generic.php' &&
 138         $file != 'utils.php'
 139       ) {
 140         $files[] = $file;
 141       }
 142     }
 143
 144     closedir($handle);
 145     return $files;
 146   }
 147
 148   /*
 149      * Require once  Files
 150      * @files array list of files to load
 151      */
 152   /**
 153    * @param $files
 154    */
 155   function requireOnceFilesArray($files) {
 156     foreach ($files as $key => $file) {
 157       require_once $this->_apiDir . $file;
 158     }
 159   }
 160
 161   /*
 162      * Get all api exposed functions that are expected to conform to standards
 163      * @return array $functionlist
 164      */
 165   /**
 166    * @return array
 167    */
 168   function getAllAPIStdFunctions() {
 169     $functionlist = get_defined_functions();
 170     $functions = preg_grep($this->_regexForGettingAPIStdFunctions, $functionlist['user']);
 171     foreach ($functions as $key => $function) {
 172       if (stristr($function, 'getfields')) {
 173         unset($functions[$key]);
 174       }
 175       if (stristr($function, '_generic_')) {
 176         unset($functions[$key]);
 177       }
 178     }
 179     return $functions;
 180   }
 181 }
 182