Commit | Line | Data |
---|---|---|
6a488035 TO |
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) | |
b6708aeb | 70 | .*_ #any number of characters up to the last _ |
6a488035 | 71 | # negative look ahead on string getfields |
b6708aeb | 72 | (?:(?!getfields))/x'; |
6a488035 TO |
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 ) { | |
6a488035 TO |
117 | continue; |
118 | } | |
119 | ||
6a488035 TO |
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 | */ | |
4cbe18b8 EM |
127 | /** |
128 | * @return array | |
129 | */ | |
6a488035 TO |
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 | */ | |
4cbe18b8 EM |
152 | /** |
153 | * @param $files | |
154 | */ | |
6a488035 TO |
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 | */ | |
4cbe18b8 EM |
165 | /** |
166 | * @return array | |
167 | */ | |
6a488035 TO |
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 |