|
1
|
|
|
<?php |
|
2
|
|
|
/** |
|
3
|
|
|
* PHP: Nelson Martell Library file |
|
4
|
|
|
* |
|
5
|
|
|
* Content: |
|
6
|
|
|
* - Trait definition. |
|
7
|
|
|
* |
|
8
|
|
|
* Copyright © 2016-2017 Nelson Martell (http://nelson6e65.github.io) |
|
9
|
|
|
* |
|
10
|
|
|
* Licensed under The MIT License (MIT) |
|
11
|
|
|
* For full copyright and license information, please see the LICENSE |
|
12
|
|
|
* Redistributions of files must retain the above copyright notice. |
|
13
|
|
|
* |
|
14
|
|
|
* @copyright 2016-2017 Nelson Martell |
|
15
|
|
|
* @link http://nelson6e65.github.io/php_nml/ |
|
16
|
|
|
* @since v0.6.0 |
|
17
|
|
|
* @license http://www.opensource.org/licenses/mit-license.php The MIT License (MIT) |
|
18
|
|
|
* */ |
|
19
|
|
|
|
|
20
|
|
|
namespace NelsonMartell\Test\DataProviders; |
|
21
|
|
|
|
|
22
|
|
|
use NelsonMartell\Test\Helpers\ConstructorMethodTester; |
|
23
|
|
|
use NelsonMartell\Test\Helpers\ExporterPlugin; |
|
24
|
|
|
use NelsonMartell\Test\Helpers\HasReadOnlyProperties; |
|
25
|
|
|
use NelsonMartell\Test\Helpers\HasUnaccesibleProperties; |
|
26
|
|
|
use NelsonMartell\Test\Helpers\IComparableTester; |
|
27
|
|
|
use NelsonMartell\Test\Helpers\IComparerTester; |
|
28
|
|
|
use NelsonMartell\Test\Helpers\IEquatableTester; |
|
29
|
|
|
use NelsonMartell\Test\Helpers\ImplementsIStrictPropertiesContainer; |
|
30
|
|
|
use NelsonMartell\Version; |
|
31
|
|
|
use NelsonMartell\VersionComponent; |
|
32
|
|
|
|
|
33
|
|
|
/** |
|
34
|
|
|
* |
|
35
|
|
|
* @author Nelson Martell <[email protected]> |
|
36
|
|
|
* @internal |
|
37
|
|
|
* */ |
|
38
|
|
|
trait VersionTestProvider |
|
39
|
|
|
{ |
|
40
|
|
|
use ExporterPlugin; |
|
41
|
|
|
use ConstructorMethodTester; |
|
42
|
|
|
use IComparableTester; |
|
43
|
|
|
use IComparerTester; |
|
44
|
|
|
use IEquatableTester; |
|
45
|
|
|
use ImplementsIStrictPropertiesContainer; |
|
46
|
|
|
use HasReadOnlyProperties; |
|
47
|
|
|
use HasUnaccesibleProperties; |
|
48
|
|
|
|
|
49
|
|
|
public function unaccesiblePropertiesProvider() |
|
50
|
|
|
{ |
|
51
|
|
|
$version = Version::parse(NML_VERSION); |
|
52
|
|
|
|
|
53
|
|
|
return [ |
|
54
|
|
|
'$major with case changed' => [$version, 'Major'], |
|
55
|
|
|
'$minor with case changed' => [$version, 'Minor'], |
|
56
|
|
|
'$build with case changed' => [$version, 'Build'], |
|
57
|
|
|
'$revision with case changed' => [$version, 'Revision'], |
|
58
|
|
|
]; |
|
59
|
|
|
} |
|
60
|
|
|
|
|
61
|
|
|
/** |
|
62
|
|
|
* Provides invalid arguments for constructor. |
|
63
|
|
|
* |
|
64
|
|
|
* @return array |
|
65
|
|
|
*/ |
|
66
|
|
|
public function badConstructorArgumentsProvider() |
|
67
|
|
|
{ |
|
68
|
|
|
return [ |
|
69
|
|
|
'Type: null (all)' => [null, null], |
|
70
|
|
|
'Only first argument' => [1, null], |
|
71
|
|
|
'Invalid $major and $minor type' => ['hello', 'world'], |
|
72
|
|
|
'Invalid $major type (string)' => ['hello', 1], |
|
73
|
|
|
'Invalid $minor type (string)' => [1, 'world'], |
|
74
|
|
|
'$major value < 0' => [-1, 0], |
|
75
|
|
|
'$minor value < 0' => [1, -3], |
|
76
|
|
|
'$build value < 0' => [1, 0, -1, null], |
|
77
|
|
|
'$revision value < 0' => [1, 0, 1, -1], |
|
78
|
|
|
'$revision while $build is not' => [1, 0, null, -1], |
|
79
|
|
|
]; |
|
80
|
|
|
} |
|
81
|
|
|
|
|
82
|
|
|
/** |
|
83
|
|
|
* Provides valid arguments for constructor. |
|
84
|
|
|
* |
|
85
|
|
|
* @return array |
|
86
|
|
|
*/ |
|
87
|
|
|
public function goodConstructorArgumentsProvider() |
|
88
|
|
|
{ |
|
89
|
|
|
return [ |
|
90
|
|
|
'SemVer: Normal' => [1, 0, 0], |
|
91
|
|
|
'SemVer: Patch release ' => [1, 0, 1], |
|
92
|
|
|
'SemVer: Minor release' => [1, 1, 0], |
|
93
|
|
|
'SemVer: Major release' => [2, 0, 0], |
|
94
|
|
|
'SemVer: Pre-release alpha' => [1, 0, '0-alpha'], |
|
95
|
|
|
'SemVer: Pre-release beta' => [1, 0, '0-beta', 1], |
|
96
|
|
|
// 'SemVer: Pre-release build metadata' => [1, 0, '0-beta', '1+20130313144700'], |
|
97
|
|
|
'Windows version: Major' => [1, 0, 0, 0], |
|
98
|
|
|
'Windows version: Minor' => [1, 1, 0, 0], |
|
99
|
|
|
'Windows version: Build' => [1, 2, 1, 0], |
|
100
|
|
|
'Windows version: Revision' => [1, 3, 1, 2344234], |
|
101
|
|
|
'Git: describe' => [0, 5, '1-34-g6e5462c'], |
|
102
|
|
|
'Zero (minor)' => [0, 0], // is invalid, but can be created |
|
103
|
|
|
'Zero (build)' => [0, 0, 0], // is invalid, but can be created |
|
104
|
|
|
'Zero (revision)' => [0, 0, 0, 0], // is invalid, but can be created |
|
105
|
|
|
]; |
|
106
|
|
|
} |
|
107
|
|
|
|
|
108
|
|
|
|
|
109
|
|
|
public function objectInstanceProvider() |
|
110
|
|
|
{ |
|
111
|
|
|
return [[new Version(0, 7, '0-beta')]]; |
|
112
|
|
|
} |
|
113
|
|
|
|
|
114
|
|
|
public function readOnlyPropertiesProvider() |
|
115
|
|
|
{ |
|
116
|
|
|
$obj = new Version(0, 7, '0-beta'); |
|
117
|
|
|
|
|
118
|
|
|
return [ |
|
119
|
|
|
[$obj, 'major', 0], |
|
120
|
|
|
[$obj, 'minor', 7], |
|
121
|
|
|
[$obj, 'build', new VersionComponent(0, '-beta')], |
|
122
|
|
|
[$obj, 'revision', new VersionComponent(null)], |
|
123
|
|
|
]; |
|
124
|
|
|
} |
|
125
|
|
|
|
|
126
|
|
|
public function IComparableCompareToMethodArgumentsProvider() |
|
|
|
|
|
|
127
|
|
|
{ |
|
128
|
|
|
$v = new Version(1, 0, 9); |
|
|
|
|
|
|
129
|
|
|
$obj = new \stdClass(); |
|
|
|
|
|
|
130
|
|
|
$obj->major = 1; |
|
|
|
|
|
|
131
|
|
|
$obj->minor = 0; |
|
|
|
|
|
|
132
|
|
|
$obj->build = 9; |
|
|
|
|
|
|
133
|
|
|
$obj->revision = null; |
|
134
|
|
|
|
|
135
|
|
|
|
|
136
|
|
|
$args = [ |
|
137
|
|
|
'Equals by reference' => [0, $v, $v], |
|
138
|
|
|
'Equals by value' => [0, new Version(1, 0, 1), Version::parse('1.0.1')], |
|
|
|
|
|
|
139
|
|
|
'Major difference' => [-1, Version::parse('1.0.0'), Version::parse('2.0.0')], |
|
|
|
|
|
|
140
|
|
|
'Minor difference' => [1, Version::parse('1.1.0'), Version::parse('1.0.0')], |
|
|
|
|
|
|
141
|
|
|
'Build difference' => [1, Version::parse('1.0.1'), Version::parse('1.0.0')], |
|
|
|
|
|
|
142
|
|
|
'Revision difference' => [-1, Version::parse('1.0.0.254'), Version::parse('1.0.0.389')], |
|
|
|
|
|
|
143
|
|
|
'Version < object' => [null, $v, $obj], |
|
144
|
|
|
'Version > array parseable' => [1, Version::parse('1.1.0'), [0, 1, 999]], |
|
145
|
|
|
'Version < array parseable' => [-1, Version::parse('1.1.0'), [2, 0]], |
|
146
|
|
|
'Version > array not parseable' => [1, Version::parse('0.0.0'), ['invalid array']], |
|
147
|
|
|
'Version > string parseable' => [1, Version::parse('1.1.0'), '0.1.999'], |
|
148
|
|
|
'Version < string parseable' => [-1, Version::parse('1.1.0'), '2.0'], |
|
149
|
|
|
'Version > string not parseable' => [1, Version::parse('1.1.0'), 'invalid string'], |
|
150
|
|
|
'integer|Version' => [1, $v, 9976645645656], |
|
151
|
|
|
]; |
|
152
|
|
|
|
|
153
|
|
|
return $args; |
|
154
|
|
|
} |
|
155
|
|
|
|
|
156
|
|
|
public function compareMethodArgumentsProvider() |
|
157
|
|
|
{ |
|
158
|
|
|
$v = new Version(1, 0, 9); |
|
|
|
|
|
|
159
|
|
|
$obj = new \stdClass(); |
|
|
|
|
|
|
160
|
|
|
$obj->major = 1; |
|
|
|
|
|
|
161
|
|
|
$obj->minor = 0; |
|
|
|
|
|
|
162
|
|
|
$obj->build = 9; |
|
|
|
|
|
|
163
|
|
|
$obj->revision = null; |
|
164
|
|
|
|
|
165
|
|
|
$args = [ |
|
166
|
|
|
'stdClass|Version' => [null, $obj, $v], |
|
167
|
|
|
'string|Version' => [-1, '1.0.0.254', $v], |
|
168
|
|
|
'integer|Version' => [-1, 9976645645656, $v], |
|
169
|
|
|
'float|Version' => [-1, 1.342333, $v], |
|
170
|
|
|
'array|Version' => [-1, [0, 1, 999], Version::parse('1.1.0')], |
|
171
|
|
|
]; |
|
172
|
|
|
|
|
173
|
|
|
return $args; |
|
174
|
|
|
} |
|
175
|
|
|
|
|
176
|
|
|
public function compareMethodArraysProvider() |
|
177
|
|
|
{ |
|
178
|
|
|
return [ |
|
179
|
|
|
'Version[]' => [[ |
|
180
|
|
|
new Version(1, 0, 1, 3), |
|
181
|
|
|
new Version(1, 0, 11, 3), |
|
182
|
|
|
new Version(1, 1, 1, 0), |
|
183
|
|
|
new Version(1, 3, 1, 9), |
|
184
|
|
|
Version::parse("2.3.2-3-g"), |
|
|
|
|
|
|
185
|
|
|
Version::parse("2.3.2-3-g726356"), |
|
|
|
|
|
|
186
|
|
|
Version::parse("2.3.2-4-g"), |
|
|
|
|
|
|
187
|
|
|
Version::parse("2.3.4-3-g"), |
|
|
|
|
|
|
188
|
|
|
Version::parse("2.3.4-3-gsh4hajk7"), |
|
|
|
|
|
|
189
|
|
|
Version::parse("2.3.4-3-gsh4hbjk7"), |
|
|
|
|
|
|
190
|
|
|
Version::parse("2.31.0-4-g"), |
|
|
|
|
|
|
191
|
|
|
Version::parse("2.31.1-4-g"), |
|
|
|
|
|
|
192
|
|
|
Version::parse("2.31.11-4-g"), |
|
|
|
|
|
|
193
|
|
|
]], |
|
194
|
|
|
'Version[] + integer[]' => [[ |
|
195
|
|
|
1, |
|
196
|
|
|
new Version(1, 0, 1, 3), |
|
197
|
|
|
new Version(1, 0, 11, 3), |
|
198
|
|
|
new Version(1, 1, 1, 0), |
|
199
|
|
|
]], |
|
200
|
|
|
'Version[] + string[]' => [[ |
|
201
|
|
|
'0.0', |
|
202
|
|
|
new Version(0, 0, 9, 3), |
|
203
|
|
|
'0.1.0', |
|
204
|
|
|
]], |
|
205
|
|
|
'Version[] + string[] (1 non parseable string)' => [[ |
|
206
|
|
|
'0.1.0', |
|
207
|
|
|
'invalid string', |
|
208
|
|
|
new Version(1, 0, 1, 3), |
|
209
|
|
|
]], |
|
210
|
|
|
'Version[] + array[]' => [[ |
|
211
|
|
|
[], |
|
212
|
|
|
[0, 1, 0], |
|
213
|
|
|
new Version(1, 0, 1, 3), |
|
214
|
|
|
]], |
|
215
|
|
|
]; |
|
216
|
|
|
} |
|
217
|
|
|
|
|
218
|
|
|
public function IEquatableMethodArgumentsProvider() |
|
|
|
|
|
|
219
|
|
|
{ |
|
220
|
|
|
return [ |
|
221
|
|
|
[true, new Version(1, 2), new Version(1, 2)], |
|
222
|
|
|
[false, new Version(1, 4), new Version(1, 2)], |
|
223
|
|
|
[false, new Version(1, 2, 1), new Version(1, 2, 2)], |
|
224
|
|
|
[false, new Version(1, 2, 1), 123], |
|
225
|
|
|
[false, new Version(1, 2, 1), 2345654675675675673453], |
|
226
|
|
|
[false, new Version(1, 2, 1), '1.2.1'], |
|
227
|
|
|
[false, new Version(1, 2, 1), [1, 2, 1]], |
|
228
|
|
|
[false, new Version(1, 2, 1), new \stdClass], |
|
229
|
|
|
]; |
|
230
|
|
|
} |
|
231
|
|
|
|
|
232
|
|
|
protected $parseableStrings = [ |
|
233
|
|
|
'valid' => [ |
|
234
|
|
|
'1.0', |
|
235
|
|
|
'0.2', |
|
236
|
|
|
'2.3.2-3-g726351', |
|
237
|
|
|
'2.3.2.3-2-g726352', |
|
238
|
|
|
'3.0.1', |
|
239
|
|
|
'4.0.2.0', |
|
240
|
|
|
'5.0.0.3-beta', |
|
241
|
|
|
'6.0.0-alpha', |
|
242
|
|
|
], |
|
243
|
|
|
'invalid' => [ |
|
244
|
|
|
'0.0', |
|
245
|
|
|
'1.0..1', |
|
246
|
|
|
'2.0.0-alpha.0', |
|
247
|
|
|
'2.3.2-3-g726353.3', |
|
248
|
|
|
'2.3.2-3-g726356.1-2-gyt4f4', |
|
249
|
|
|
'3.0.1-alpha.1', |
|
250
|
|
|
'4.0.0-alpha.0-beta', |
|
251
|
|
|
'5.0.1-alpha.2-beta', |
|
252
|
|
|
], |
|
253
|
|
|
]; |
|
254
|
|
|
|
|
255
|
|
|
public function isValidProvider() |
|
256
|
|
|
{ |
|
257
|
|
|
$args = []; |
|
258
|
|
|
|
|
259
|
|
|
foreach ($this->parseableStrings['valid'] as $str) { |
|
260
|
|
|
$args[$str] = [true, Version::parse($str)]; |
|
261
|
|
|
} |
|
262
|
|
|
|
|
263
|
|
|
foreach ($this->parseableStrings['invalid'] as $str) { |
|
264
|
|
|
$args[$str] = [false, Version::parse($str)]; |
|
265
|
|
|
} |
|
266
|
|
|
|
|
267
|
|
|
return $args; |
|
268
|
|
|
} |
|
269
|
|
|
|
|
270
|
|
|
public function toStringMethodProvider() |
|
271
|
|
|
{ |
|
272
|
|
|
return [ |
|
273
|
|
|
['1.0', new Version(1, 0)], |
|
274
|
|
|
['0.2', new Version(0, 2)], |
|
275
|
|
|
['2.3.2-3-g726351', new Version(2, 3, '2-3-g726351')], |
|
276
|
|
|
['2.3.2.3-2-g726352', new Version(2, 3, 2, '3-2-g726352')], |
|
277
|
|
|
['3.0.1', new Version(3, 0, 1)], |
|
278
|
|
|
['4.0.2.0', new Version(4, 0, 2, 0)], |
|
279
|
|
|
['5.0.0.3-beta', new Version(5, 0, 0, '3-beta')], |
|
280
|
|
|
['6.0.0-alpha', new Version(6, 0, '0-alpha')], |
|
281
|
|
|
]; |
|
282
|
|
|
} |
|
283
|
|
|
} |
|
284
|
|
|
|
This check looks for method names that are not written in camelCase.
In camelCase names are written without any punctuation, the start of each new word being marked by a capital letter. Thus the name database connection seeker becomes
databaseConnectionSeeker.