VersionParserTest.php 39 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863
  1. <?php
  2. /*
  3. * This file is part of composer/semver.
  4. *
  5. * (c) Composer <https://github.com/composer>
  6. *
  7. * For the full copyright and license information, please view
  8. * the LICENSE file that was distributed with this source code.
  9. */
  10. namespace Composer\Semver;
  11. use Composer\Semver\Constraint\MatchAllConstraint;
  12. use Composer\Semver\Constraint\MultiConstraint;
  13. use Composer\Semver\Constraint\Constraint;
  14. use PHPUnit\Framework\TestCase;
  15. class VersionParserTest extends TestCase
  16. {
  17. /**
  18. * @dataProvider numericAliasVersions
  19. * @param string $input
  20. * @param string $expected
  21. */
  22. public function testParseNumericAliasPrefix($input, $expected)
  23. {
  24. $parser = new VersionParser();
  25. $this->assertSame($expected, $parser->parseNumericAliasPrefix($input));
  26. }
  27. /**
  28. * @return array<mixed>
  29. */
  30. public function numericAliasVersions()
  31. {
  32. return array(
  33. array('0.x-dev', '0.'),
  34. array('1.0.x-dev', '1.0.'),
  35. array('1.x-dev', '1.'),
  36. array('1.2.x-dev', '1.2.'),
  37. array('1.2-dev', '1.2.'),
  38. array('1-dev', '1.'),
  39. array('dev-develop', false),
  40. array('dev-master', false),
  41. );
  42. }
  43. /**
  44. * @dataProvider successfulNormalizedVersions
  45. * @param string $input
  46. * @param string $expected
  47. */
  48. public function testNormalizeSucceeds($input, $expected)
  49. {
  50. $parser = new VersionParser();
  51. $this->assertSame($expected, $parser->normalize($input));
  52. }
  53. /**
  54. * @return array<mixed>
  55. */
  56. public function successfulNormalizedVersions()
  57. {
  58. return array(
  59. 'none' => array('1.0.0', '1.0.0.0'),
  60. 'none/2' => array('1.2.3.4', '1.2.3.4'),
  61. 'parses state' => array('1.0.0RC1dev', '1.0.0.0-RC1-dev'),
  62. 'CI parsing' => array('1.0.0-rC15-dev', '1.0.0.0-RC15-dev'),
  63. 'delimiters' => array('1.0.0.RC.15-dev', '1.0.0.0-RC15-dev'),
  64. 'RC uppercase' => array('1.0.0-rc1', '1.0.0.0-RC1'),
  65. 'patch replace' => array('1.0.0.pl3-dev', '1.0.0.0-patch3-dev'),
  66. 'forces w.x.y.z' => array('1.0-dev', '1.0.0.0-dev'),
  67. 'forces w.x.y.z/2' => array('0', '0.0.0.0'),
  68. 'parses long' => array('10.4.13-beta', '10.4.13.0-beta'),
  69. 'parses long/2' => array('10.4.13beta2', '10.4.13.0-beta2'),
  70. 'parses long/semver' => array('10.4.13beta.2', '10.4.13.0-beta2'),
  71. 'parses long/semver2' => array('v1.13.11-beta.0', '1.13.11.0-beta0'),
  72. 'parses long/semver3' => array('1.13.11.0-beta0', '1.13.11.0-beta0'),
  73. 'expand shorthand' => array('10.4.13-b', '10.4.13.0-beta'),
  74. 'expand shorthand/2' => array('10.4.13-b5', '10.4.13.0-beta5'),
  75. 'strips leading v' => array('v1.0.0', '1.0.0.0'),
  76. 'parses dates y-m as classical' => array('2010.01', '2010.01.0.0'),
  77. 'parses dates w/ . as classical' => array('2010.01.02', '2010.01.02.0'),
  78. 'parses dates y.m.Y as classical' => array('2010.1.555', '2010.1.555.0'),
  79. 'parses dates y.m.Y/2 as classical' => array('2010.10.200', '2010.10.200.0'),
  80. 'parses CalVer YYYYMMDD (as MAJOR) versions' => array('20230131.0.0', '20230131.0.0'),
  81. 'parses CalVer YYYYMMDDhhmm (as MAJOR) versions' => array('202301310000.0.0', '202301310000.0.0'),
  82. 'strips v/datetime' => array('v20100102', '20100102'),
  83. 'parses dates no delimiter' => array('20100102', '20100102'),
  84. 'parses dates no delimiter/2' => array('20100102.0', '20100102.0'),
  85. 'parses dates no delimiter/3' => array('20100102.1.0', '20100102.1.0'),
  86. 'parses dates no delimiter/4' => array('20100102.0.3', '20100102.0.3'),
  87. 'parses dates w/ - and .' => array('2010-01-02-10-20-30.0.3', '2010.01.02.10.20.30.0.3'),
  88. 'parses dates w/ - and ./2' => array('2010-01-02-10-20-30.5', '2010.01.02.10.20.30.5'),
  89. 'parses dates w/ -' => array('2010-01-02', '2010.01.02'),
  90. 'parses dates w/ .' => array('2012.06.07', '2012.06.07.0'),
  91. 'parses numbers' => array('2010-01-02.5', '2010.01.02.5'),
  92. 'parses dates y.m.Y' => array('2010.1.555', '2010.1.555.0'),
  93. 'parses datetime' => array('20100102-203040', '20100102.203040'),
  94. 'parses date dev' => array('20100102.x-dev', '20100102.9999999.9999999.9999999-dev'),
  95. 'parses datetime dev' => array('20100102.203040.x-dev', '20100102.203040.9999999.9999999-dev'),
  96. 'parses dt+number' => array('20100102203040-10', '20100102203040.10'),
  97. 'parses dt+patch' => array('20100102-203040-p1', '20100102.203040-patch1'),
  98. 'parses dt Ym' => array('201903.0', '201903.0'),
  99. 'parses dt Ym dev' => array('201903.x-dev', '201903.9999999.9999999.9999999-dev'),
  100. 'parses dt Ym+patch' => array('201903.0-p2', '201903.0-patch2'),
  101. 'parses master' => array('dev-master', 'dev-master'),
  102. 'parses master w/o dev' => array('master', 'dev-master'),
  103. 'parses trunk' => array('dev-trunk', 'dev-trunk'),
  104. 'parses branches' => array('1.x-dev', '1.9999999.9999999.9999999-dev'),
  105. 'parses arbitrary' => array('dev-feature-foo', 'dev-feature-foo'),
  106. 'parses arbitrary/2' => array('DEV-FOOBAR', 'dev-FOOBAR'),
  107. 'parses arbitrary/3' => array('dev-feature/foo', 'dev-feature/foo'),
  108. 'parses arbitrary/4' => array('dev-feature+issue-1', 'dev-feature+issue-1'),
  109. 'ignores aliases' => array('dev-master as 1.0.0', 'dev-master'),
  110. 'ignores aliases/2' => array('dev-load-varnish-only-when-used as ^2.0', 'dev-load-varnish-only-when-used'),
  111. 'ignores aliases/3' => array('dev-load-varnish-only-when-used@dev as ^2.0@dev', 'dev-load-varnish-only-when-used'),
  112. 'ignores stability' => array('1.0.0+foo@dev', '1.0.0.0'),
  113. 'ignores stability/2' => array('dev-load-varnish-only-when-used@stable', 'dev-load-varnish-only-when-used'),
  114. 'semver metadata/2' => array('1.0.0-beta.5+foo', '1.0.0.0-beta5'),
  115. 'semver metadata/3' => array('1.0.0+foo', '1.0.0.0'),
  116. 'semver metadata/4' => array('1.0.0-alpha.3.1+foo', '1.0.0.0-alpha3.1'),
  117. 'semver metadata/5' => array('1.0.0-alpha2.1+foo', '1.0.0.0-alpha2.1'),
  118. 'semver metadata/6' => array('1.0.0-alpha-2.1-3+foo', '1.0.0.0-alpha2.1-3'),
  119. // not supported for BC 'semver metadata/7' => array('1.0.0-0.3.7', '1.0.0.0-0.3.7'),
  120. // not supported for BC 'semver metadata/8' => array('1.0.0-x.7.z.92', '1.0.0.0-x.7.z.92'),
  121. 'metadata w/ alias' => array('1.0.0+foo as 2.0', '1.0.0.0'),
  122. 'keep zero-padding' => array('00.01.03.04', '00.01.03.04'),
  123. 'keep zero-padding/2' => array('000.001.003.004', '000.001.003.004'),
  124. 'keep zero-padding/3' => array('0.000.103.204', '0.000.103.204'),
  125. 'keep zero-padding/4' => array('0700', '0700.0.0.0'),
  126. 'keep zero-padding/5' => array('041.x-dev', '041.9999999.9999999.9999999-dev'),
  127. 'keep zero-padding/6' => array('dev-041.003', 'dev-041.003'),
  128. 'dev with mad name' => array('dev-1.0.0-dev<1.0.5-dev', 'dev-1.0.0-dev<1.0.5-dev'),
  129. 'dev prefix with spaces' => array('dev-foo bar', 'dev-foo bar'),
  130. 'space padding' => array(' 1.0.0', '1.0.0.0'),
  131. 'space padding/2' => array('1.0.0 ', '1.0.0.0'),
  132. );
  133. }
  134. /**
  135. * @dataProvider failingNormalizedVersions
  136. * @param string $input
  137. */
  138. public function testNormalizeFails($input)
  139. {
  140. $this->doExpectException('UnexpectedValueException');
  141. $parser = new VersionParser();
  142. $parser->normalize($input);
  143. }
  144. /**
  145. * @return array<mixed>
  146. */
  147. public function failingNormalizedVersions()
  148. {
  149. return array(
  150. 'empty ' => array(''),
  151. 'invalid chars' => array('a'),
  152. 'invalid type' => array('1.0.0-meh'),
  153. 'too many bits' => array('1.0.0.0.0'),
  154. 'non-dev arbitrary' => array('feature-foo'),
  155. 'metadata w/ space' => array('1.0.0+foo bar'),
  156. 'maven style release' => array('1.0.1-SNAPSHOT'),
  157. 'dev with less than' => array('1.0.0<1.0.5-dev'),
  158. 'dev with less than/2' => array('1.0.0-dev<1.0.5-dev'),
  159. 'dev suffix with spaces' => array('foo bar-dev'),
  160. 'any with spaces' => array('1.0 .2'),
  161. 'no version, no alias' => array(' as '),
  162. 'no version, only alias' => array(' as 1.2'),
  163. 'just an operator' => array('^'),
  164. 'just an operator/2' => array('^8 || ^'),
  165. 'just an operator/3' => array('~'),
  166. 'just an operator/4' => array('~1 ~'),
  167. 'constraint' => array('~1'),
  168. 'constraint/2' => array('^1'),
  169. 'constraint/3' => array('1.*'),
  170. 'date versions with 4 bits' => array('20100102.0.3.4', '20100102.0.3.4'),
  171. );
  172. }
  173. /**
  174. * @dataProvider failingNormalizedVersionsWithBadAlias
  175. * @param string $fullInput
  176. */
  177. public function testNormalizeFailsAndReportsAliasIssue($fullInput)
  178. {
  179. preg_match('{^([^,\s#]+)(?:#[^ ]+)? +as +([^,\s]+)$}', $fullInput, $match);
  180. $parser = new VersionParser();
  181. $parser->normalize($match[1], $fullInput);
  182. try {
  183. $parser->normalize($match[2], $fullInput);
  184. } catch (\UnexpectedValueException $e) {
  185. $this->assertEquals('Invalid version string "'.$match[2].'" in "'.$fullInput.'", the alias must be an exact version', $e->getMessage());
  186. }
  187. }
  188. /**
  189. * @return array<mixed>
  190. */
  191. public function failingNormalizedVersionsWithBadAlias()
  192. {
  193. return array(
  194. 'Alias and caret' => array('1.0.0+foo as ^2.0'),
  195. 'Alias and tilde' => array('1.0.0+foo as ~2.0'),
  196. 'Alias and greater than' => array('1.0.0+foo as >2.0'),
  197. 'Alias and less than' => array('1.0.0+foo as <2.0'),
  198. 'Bad alias with stability' => array('1.0.0+foo@dev as <2.0@dev'),
  199. );
  200. }
  201. /**
  202. * @dataProvider failingNormalizedVersionsWithBadAliasee
  203. * @param string $fullInput
  204. */
  205. public function testNormalizeFailsAndReportsAliaseeIssue($fullInput)
  206. {
  207. preg_match('{^([^,\s#]+)(?:#[^ ]+)? +as +([^,\s]+)$}', $fullInput, $match);
  208. $parser = new VersionParser();
  209. try {
  210. $parser->normalize($match[1], $fullInput);
  211. } catch (\UnexpectedValueException $e) {
  212. $this->assertEquals('Invalid version string "'.$match[1].'" in "'.$fullInput.'", the alias source must be an exact version, if it is a branch name you should prefix it with dev-', $e->getMessage());
  213. }
  214. $parser->normalize($match[2], $fullInput);
  215. }
  216. /**
  217. * @return array<mixed>
  218. */
  219. public function failingNormalizedVersionsWithBadAliasee()
  220. {
  221. return array(
  222. 'Alias and caret' => array('^2.0 as 1.0.0+foo'),
  223. 'Alias and tilde' => array('~2.0 as 1.0.0+foo'),
  224. 'Alias and greater than' => array('>2.0 as 1.0.0+foo'),
  225. 'Alias and less than' => array('<2.0 as 1.0.0+foo'),
  226. 'Bad aliasee with stability' => array('<2.0@dev as 1.2.3@dev'),
  227. );
  228. }
  229. /**
  230. * @dataProvider successfulNormalizedBranches
  231. * @param string $input
  232. * @param string $expected
  233. */
  234. public function testNormalizeBranch($input, $expected)
  235. {
  236. $parser = new VersionParser();
  237. $this->assertSame((string) $expected, (string) $parser->normalizeBranch($input));
  238. }
  239. /**
  240. * @return array<mixed>
  241. */
  242. public function successfulNormalizedBranches()
  243. {
  244. return array(
  245. 'parses x' => array('v1.x', '1.9999999.9999999.9999999-dev'),
  246. 'parses *' => array('v1.*', '1.9999999.9999999.9999999-dev'),
  247. 'parses digits' => array('v1.0', '1.0.9999999.9999999-dev'),
  248. 'parses digits/2' => array('2.0', '2.0.9999999.9999999-dev'),
  249. 'parses long x' => array('v1.0.x', '1.0.9999999.9999999-dev'),
  250. 'parses long *' => array('v1.0.3.*', '1.0.3.9999999-dev'),
  251. 'parses long digits' => array('v2.4.0', '2.4.0.9999999-dev'),
  252. 'parses long digits/2' => array('2.4.4', '2.4.4.9999999-dev'),
  253. 'parses master' => array('master', 'dev-master'),
  254. 'parses trunk' => array('trunk', 'dev-trunk'),
  255. 'parses arbitrary' => array('feature-a', 'dev-feature-a'),
  256. 'parses arbitrary/2' => array('FOOBAR', 'dev-FOOBAR'),
  257. 'parses arbitrary/3' => array('feature+issue-1', 'dev-feature+issue-1'),
  258. );
  259. }
  260. public function testParseConstraintsIgnoresStabilityFlag()
  261. {
  262. $parser = new VersionParser();
  263. $this->assertSame((string) new Constraint('=', '1.0.0.0'), (string) $parser->parseConstraints('1.0@dev'));
  264. $this->assertSame((string) new Constraint('>=', '1.0.0.0-beta'), (string) $parser->parseConstraints('>=1.0@beta'));
  265. $this->assertSame((string) new Constraint('=', 'dev-load-varnish-only-when-used'), (string) $parser->parseConstraints('dev-load-varnish-only-when-used as ^2.0@dev'));
  266. $this->assertSame((string) new Constraint('=', 'dev-load-varnish-only-when-used'), (string) $parser->parseConstraints('dev-load-varnish-only-when-used@dev as ^2.0@dev'));
  267. }
  268. public function testParseConstraintsIgnoresReferenceOnDevVersion()
  269. {
  270. $parser = new VersionParser();
  271. $this->assertSame((string) new Constraint('=', '1.0.9999999.9999999-dev'), (string) $parser->parseConstraints('1.0.x-dev#abcd123'));
  272. $this->assertSame((string) new Constraint('=', '1.0.9999999.9999999-dev'), (string) $parser->parseConstraints('1.0.x-dev#trunk/@123'));
  273. }
  274. public function testParseConstraintsFailsOnBadReference()
  275. {
  276. $this->doExpectException('UnexpectedValueException');
  277. $parser = new VersionParser();
  278. $this->assertSame((string) new Constraint('=', '1.0.0.0'), (string) $parser->parseConstraints('1.0#abcd123'));
  279. $this->assertSame((string) new Constraint('=', '1.0.0.0'), (string) $parser->parseConstraints('1.0#trunk/@123'));
  280. }
  281. public function testParseConstraintsNudgesRubyDevsTowardsThePathOfRighteousness()
  282. {
  283. $this->doExpectException('UnexpectedValueException', 'Invalid operator "~>", you probably meant to use the "~" operator');
  284. $parser = new VersionParser();
  285. $parser->parseConstraints('~>1.2');
  286. }
  287. /**
  288. * @dataProvider simpleConstraints
  289. *
  290. * @param string $input
  291. * @param Constraint $expected
  292. */
  293. public function testParseConstraintsSimple($input, $expected)
  294. {
  295. $parser = new VersionParser();
  296. $this->assertSame((string) $expected, (string) $parser->parseConstraints($input));
  297. }
  298. /**
  299. * @return array<mixed>
  300. */
  301. public function simpleConstraints()
  302. {
  303. return array(
  304. 'match any' => array('*', new MatchAllConstraint()),
  305. 'match any/v' => array('v*', new Constraint('>=', '0.0.0.0-dev')),
  306. 'match any/2' => array('*.*', new Constraint('>=', '0.0.0.0-dev')),
  307. 'match any/2v' => array('v*.*', new Constraint('>=', '0.0.0.0-dev')),
  308. 'match any/3' => array('*.x.*', new Constraint('>=', '0.0.0.0-dev')),
  309. 'match any/4' => array('x.X.x.*', new Constraint('>=', '0.0.0.0-dev')),
  310. 'not equal' => array('<>1.0.0', new Constraint('<>', '1.0.0.0')),
  311. 'not equal/2' => array('!=1.0.0', new Constraint('!=', '1.0.0.0')),
  312. 'greater than' => array('>1.0.0', new Constraint('>', '1.0.0.0')),
  313. 'lesser than' => array('<1.2.3.4', new Constraint('<', '1.2.3.4-dev')),
  314. 'less/eq than' => array('<=1.2.3', new Constraint('<=', '1.2.3.0')),
  315. 'great/eq than' => array('>=1.2.3', new Constraint('>=', '1.2.3.0-dev')),
  316. 'equals' => array('=1.2.3', new Constraint('=', '1.2.3.0')),
  317. 'double equals' => array('==1.2.3', new Constraint('=', '1.2.3.0')),
  318. 'no op means eq' => array('1.2.3', new Constraint('=', '1.2.3.0')),
  319. 'completes version' => array('=1.0', new Constraint('=', '1.0.0.0')),
  320. 'shorthand beta' => array('1.2.3b5', new Constraint('=', '1.2.3.0-beta5')),
  321. 'shorthand alpha' => array('1.2.3a1', new Constraint('=', '1.2.3.0-alpha1')),
  322. 'shorthand patch' => array('1.2.3p1234', new Constraint('=', '1.2.3.0-patch1234')),
  323. 'shorthand patch/2' => array('1.2.3pl1234', new Constraint('=', '1.2.3.0-patch1234')),
  324. 'accepts spaces' => array('>= 1.2.3', new Constraint('>=', '1.2.3.0-dev')),
  325. 'accepts spaces/2' => array('< 1.2.3', new Constraint('<', '1.2.3.0-dev')),
  326. 'accepts spaces/3' => array('> 1.2.3', new Constraint('>', '1.2.3.0')),
  327. 'accepts master' => array('>=dev-master', new Constraint('>=', 'dev-master')),
  328. 'accepts master/2' => array('dev-master', new Constraint('=', 'dev-master')),
  329. 'accepts arbitrary' => array('dev-feature-a', new Constraint('=', 'dev-feature-a')),
  330. 'regression #550' => array('dev-some-fix', new Constraint('=', 'dev-some-fix')),
  331. 'regression #935' => array('dev-CAPS', new Constraint('=', 'dev-CAPS')),
  332. 'ignores aliases' => array('dev-master as 1.0.0', new Constraint('=', 'dev-master')),
  333. 'lesser than override' => array('<1.2.3.4-stable', new Constraint('<', '1.2.3.4')),
  334. 'great/eq than override' => array('>=1.2.3.4-stable', new Constraint('>=', '1.2.3.4')),
  335. );
  336. }
  337. /**
  338. * @dataProvider wildcardConstraints
  339. *
  340. * @param string $input
  341. * @param Constraint|null $min
  342. * @param Constraint $max
  343. */
  344. public function testParseConstraintsWildcard($input, $min, $max)
  345. {
  346. $parser = new VersionParser();
  347. if ($min) {
  348. $expected = new MultiConstraint(array($min, $max));
  349. } else {
  350. $expected = $max;
  351. }
  352. $this->assertSame((string) $expected, (string) $parser->parseConstraints($input));
  353. }
  354. /**
  355. * @return array<mixed>
  356. */
  357. public function wildcardConstraints()
  358. {
  359. return array(
  360. array('v2.*', new Constraint('>=', '2.0.0.0-dev'), new Constraint('<', '3.0.0.0-dev')),
  361. array('2.*.*', new Constraint('>=', '2.0.0.0-dev'), new Constraint('<', '3.0.0.0-dev')),
  362. array('20.*', new Constraint('>=', '20.0.0.0-dev'), new Constraint('<', '21.0.0.0-dev')),
  363. array('20.*.*', new Constraint('>=', '20.0.0.0-dev'), new Constraint('<', '21.0.0.0-dev')),
  364. array('2.0.*', new Constraint('>=', '2.0.0.0-dev'), new Constraint('<', '2.1.0.0-dev')),
  365. array('2.x', new Constraint('>=', '2.0.0.0-dev'), new Constraint('<', '3.0.0.0-dev')),
  366. array('2.x.x', new Constraint('>=', '2.0.0.0-dev'), new Constraint('<', '3.0.0.0-dev')),
  367. array('2.2.x', new Constraint('>=', '2.2.0.0-dev'), new Constraint('<', '2.3.0.0-dev')),
  368. array('2.10.X', new Constraint('>=', '2.10.0.0-dev'), new Constraint('<', '2.11.0.0-dev')),
  369. array('2.1.3.*', new Constraint('>=', '2.1.3.0-dev'), new Constraint('<', '2.1.4.0-dev')),
  370. array('0.*', null, new Constraint('<', '1.0.0.0-dev')),
  371. array('0.*.*', null, new Constraint('<', '1.0.0.0-dev')),
  372. array('0.x', null, new Constraint('<', '1.0.0.0-dev')),
  373. array('0.x.x', null, new Constraint('<', '1.0.0.0-dev')),
  374. );
  375. }
  376. /**
  377. * @dataProvider tildeConstraints
  378. *
  379. * @param string $input
  380. * @param Constraint|null $min
  381. * @param Constraint $max
  382. */
  383. public function testParseTildeWildcard($input, $min, $max)
  384. {
  385. $parser = new VersionParser();
  386. if ($min) {
  387. $expected = new MultiConstraint(array($min, $max));
  388. } else {
  389. $expected = $max;
  390. }
  391. $this->assertSame((string) $expected, (string) $parser->parseConstraints($input));
  392. }
  393. /**
  394. * @return array<mixed>
  395. */
  396. public function tildeConstraints()
  397. {
  398. return array(
  399. array('~v1', new Constraint('>=', '1.0.0.0-dev'), new Constraint('<', '2.0.0.0-dev')),
  400. array('~1.0', new Constraint('>=', '1.0.0.0-dev'), new Constraint('<', '2.0.0.0-dev')),
  401. array('~1.0.0', new Constraint('>=', '1.0.0.0-dev'), new Constraint('<', '1.1.0.0-dev')),
  402. array('~1.2', new Constraint('>=', '1.2.0.0-dev'), new Constraint('<', '2.0.0.0-dev')),
  403. array('~1.2.3', new Constraint('>=', '1.2.3.0-dev'), new Constraint('<', '1.3.0.0-dev')),
  404. array('~1.2.3.4', new Constraint('>=', '1.2.3.4-dev'), new Constraint('<', '1.2.4.0-dev')),
  405. array('~1.2-beta',new Constraint('>=', '1.2.0.0-beta'), new Constraint('<', '2.0.0.0-dev')),
  406. array('~1.2-b2', new Constraint('>=', '1.2.0.0-beta2'), new Constraint('<', '2.0.0.0-dev')),
  407. array('~1.2-BETA2', new Constraint('>=', '1.2.0.0-beta2'), new Constraint('<', '2.0.0.0-dev')),
  408. array('~1.2.2-dev', new Constraint('>=', '1.2.2.0-dev'), new Constraint('<', '1.3.0.0-dev')),
  409. array('~1.2.2-stable', new Constraint('>=', '1.2.2.0'), new Constraint('<', '1.3.0.0-dev')),
  410. array('~201903.0', new Constraint('>=', '201903.0-dev'), new Constraint('<', '201904.0.0.0-dev')),
  411. array('~201903.0-beta', new Constraint('>=', '201903.0-beta'), new Constraint('<', '201904.0.0.0-dev')),
  412. array('~201903.0-stable', new Constraint('>=', '201903.0'), new Constraint('<', '201904.0.0.0-dev')),
  413. array('~201903.205830.1-stable', new Constraint('>=', '201903.205830.1'), new Constraint('<', '201903.205831.0.0-dev')),
  414. array('~2.x-dev', new Constraint('>=', '2.9999999.9999999.9999999-dev'), new Constraint('<', '3.0.0.0-dev')),
  415. array('~2.0.x-dev', new Constraint('>=', '2.0.9999999.9999999-dev'), new Constraint('<', '2.1.0.0-dev')),
  416. array('~2.0.3.x-dev', new Constraint('>=', '2.0.3.9999999-dev'), new Constraint('<', '2.0.4.0-dev')),
  417. array('~0.x-dev', new Constraint('>=', '0.9999999.9999999.9999999-dev'), new Constraint('<', '1.0.0.0-dev')),
  418. );
  419. }
  420. /**
  421. * @dataProvider caretConstraints
  422. *
  423. * @param string $input
  424. * @param Constraint|null $min
  425. * @param Constraint $max
  426. */
  427. public function testParseCaretWildcard($input, $min, $max)
  428. {
  429. $parser = new VersionParser();
  430. if ($min) {
  431. $expected = new MultiConstraint(array($min, $max));
  432. } else {
  433. $expected = $max;
  434. }
  435. $this->assertSame((string) $expected, (string) $parser->parseConstraints($input));
  436. }
  437. /**
  438. * @return array<mixed>
  439. */
  440. public function caretConstraints()
  441. {
  442. return array(
  443. array('^v1', new Constraint('>=', '1.0.0.0-dev'), new Constraint('<', '2.0.0.0-dev')),
  444. array('^0', new Constraint('>=', '0.0.0.0-dev'), new Constraint('<', '1.0.0.0-dev')),
  445. array('^0.0', new Constraint('>=', '0.0.0.0-dev'), new Constraint('<', '0.1.0.0-dev')),
  446. array('^1.2', new Constraint('>=', '1.2.0.0-dev'), new Constraint('<', '2.0.0.0-dev')),
  447. array('^1.2.3-beta.2', new Constraint('>=', '1.2.3.0-beta2'), new Constraint('<', '2.0.0.0-dev')),
  448. array('^1.2.3.4', new Constraint('>=', '1.2.3.4-dev'), new Constraint('<', '2.0.0.0-dev')),
  449. array('^1.2.3', new Constraint('>=', '1.2.3.0-dev'), new Constraint('<', '2.0.0.0-dev')),
  450. array('^0.2.3', new Constraint('>=', '0.2.3.0-dev'), new Constraint('<', '0.3.0.0-dev')),
  451. array('^0.2', new Constraint('>=', '0.2.0.0-dev'), new Constraint('<', '0.3.0.0-dev')),
  452. array('^0.2.0', new Constraint('>=', '0.2.0.0-dev'), new Constraint('<', '0.3.0.0-dev')),
  453. array('^0.0.3', new Constraint('>=', '0.0.3.0-dev'), new Constraint('<', '0.0.4.0-dev')),
  454. array('^0.0.3-alpha', new Constraint('>=', '0.0.3.0-alpha'), new Constraint('<', '0.0.4.0-dev')),
  455. array('^0.0.3-dev', new Constraint('>=', '0.0.3.0-dev'), new Constraint('<', '0.0.4.0-dev')),
  456. array('^0.0.3-stable', new Constraint('>=', '0.0.3.0'), new Constraint('<', '0.0.4.0-dev')),
  457. array('^201903.0', new Constraint('>=', '201903.0-dev'), new Constraint('<', '201904.0.0.0-dev')),
  458. array('^201903.0-beta', new Constraint('>=', '201903.0-beta'), new Constraint('<', '201904.0.0.0-dev')),
  459. array('^201903.205830.1-stable', new Constraint('>=', '201903.205830.1'), new Constraint('<', '201904.0.0.0-dev')),
  460. array('^2.x-dev', new Constraint('>=', '2.9999999.9999999.9999999-dev'), new Constraint('<', '3.0.0.0-dev')),
  461. array('^2.0.*-dev', new Constraint('>=', '2.0.9999999.9999999-dev'), new Constraint('<', '3.0.0.0-dev')),
  462. array('^2.0.x-dev', new Constraint('>=', '2.0.9999999.9999999-dev'), new Constraint('<', '3.0.0.0-dev')),
  463. array('^2.0.3.x-dev', new Constraint('>=', '2.0.3.9999999-dev'), new Constraint('<', '3.0.0.0-dev')),
  464. array('^0.x-dev', new Constraint('>=', '0.9999999.9999999.9999999-dev'), new Constraint('<', '1.0.0.0-dev')),
  465. );
  466. }
  467. /**
  468. * @dataProvider hyphenConstraints
  469. *
  470. * @param string $input
  471. * @param Constraint|null $min
  472. * @param Constraint $max
  473. */
  474. public function testParseHyphen($input, $min, $max)
  475. {
  476. $parser = new VersionParser();
  477. if ($min) {
  478. $expected = new MultiConstraint(array($min, $max));
  479. } else {
  480. $expected = $max;
  481. }
  482. $this->assertSame((string) $expected, (string) $parser->parseConstraints($input));
  483. }
  484. /**
  485. * @return array<mixed>
  486. */
  487. public function hyphenConstraints()
  488. {
  489. return array(
  490. array('v1 - v2', new Constraint('>=', '1.0.0.0-dev'), new Constraint('<', '3.0.0.0-dev')),
  491. array('1.2.3 - 2.3.4.5', new Constraint('>=', '1.2.3.0-dev'), new Constraint('<=', '2.3.4.5')),
  492. array('1.2-beta - 2.3', new Constraint('>=', '1.2.0.0-beta'), new Constraint('<', '2.4.0.0-dev')),
  493. array('1.2-beta - 2.3-dev', new Constraint('>=', '1.2.0.0-beta'), new Constraint('<=', '2.3.0.0-dev')),
  494. array('1.2-RC - 2.3.1', new Constraint('>=', '1.2.0.0-RC'), new Constraint('<=', '2.3.1.0')),
  495. array('1.2.3-alpha - 2.3-RC', new Constraint('>=', '1.2.3.0-alpha'), new Constraint('<=', '2.3.0.0-RC')),
  496. array('1 - 2.0', new Constraint('>=', '1.0.0.0-dev'), new Constraint('<', '2.1.0.0-dev')),
  497. array('1 - 2.1', new Constraint('>=', '1.0.0.0-dev'), new Constraint('<', '2.2.0.0-dev')),
  498. array('1.2 - 2.1.0', new Constraint('>=', '1.2.0.0-dev'), new Constraint('<=', '2.1.0.0')),
  499. array('1.3 - 2.1.3', new Constraint('>=', '1.3.0.0-dev'), new Constraint('<=', '2.1.3.0')),
  500. array('2.0.3.x-dev - 3.0.3.x-dev', new Constraint('>=', '2.0.3.9999999-dev'), new Constraint('<=', '3.0.3.9999999-dev')),
  501. array('2.0.x-dev - 3.0.x-dev', new Constraint('>=', '2.0.9999999.9999999-dev'), new Constraint('<=', '3.0.9999999.9999999-dev')),
  502. array('2.x-dev - 3.x-dev', new Constraint('>=', '2.9999999.9999999.9999999-dev'), new Constraint('<=', '3.9999999.9999999.9999999-dev')),
  503. array('0.x-dev - 1.x-dev', new Constraint('>=', '0.9999999.9999999.9999999-dev'), new Constraint('<=', '1.9999999.9999999.9999999-dev')),
  504. );
  505. }
  506. /**
  507. * @dataProvider constraintProvider
  508. * @param string $constraint
  509. * @param string $expected
  510. */
  511. public function testParseConstraints($constraint, $expected)
  512. {
  513. $parser = new VersionParser();
  514. $this->assertSame($expected, (string) $parser->parseConstraints($constraint));
  515. }
  516. /**
  517. * @return array<mixed>
  518. */
  519. public function constraintProvider()
  520. {
  521. return array(
  522. // numeric branch
  523. array('3.x-dev', '== 3.9999999.9999999.9999999-dev'),
  524. array('3-dev', '== 3.0.0.0-dev'),
  525. // non-numeric branches
  526. array('dev-3.x', '== dev-3.x'),
  527. array('xsd2php-dev', '== dev-xsd2php'),
  528. array('3.next-dev', '== dev-3.next'),
  529. array('foobar-dev', '== dev-foobar'),
  530. array('dev-xsd2php', '== dev-xsd2php'),
  531. array('dev-3.next', '== dev-3.next'),
  532. array('dev-foobar', '== dev-foobar'),
  533. array('dev-1.0.0-dev<1.0.5-dev', '== dev-1.0.0-dev<1.0.5-dev'),
  534. array('dev-1.0.0-dev<1.0.5', '== dev-1.0.0-dev<1.0.5'),
  535. array('foobar-dev as 2.1.0', '== dev-foobar'),
  536. array('foobar-dev as 2.1.0 || 3.5', '[== dev-foobar || == 3.5.0.0]'),
  537. array('foobar-dev as 2.1.0 || 3.5 as 1.5', '[== dev-foobar || == 3.5.0.0]'),
  538. array('2.1.0 - 2.3-dev', '[>= 2.1.0.0-dev <= 2.3.0.0-dev]'),
  539. array('1.0 - 2.0.x-dev', '[>= 1.0.0.0-dev <= 2.0.9999999.9999999-dev]'),
  540. // borked typo constraints but so common historically that we gotta keep them working
  541. array('^1.', '[>= 1.0.0.0-dev < 2.0.0.0-dev]'),
  542. array('~1.', '[>= 1.0.0.0-dev < 2.0.0.0-dev]'),
  543. array('1.2.', '== 1.2.0.0'),
  544. array('1.2..dev', '== 1.2.0.0-dev'),
  545. array('1.2-.dev', '== 1.2.0.0-dev'),
  546. array('1.2_-dev', '== 1.2.0.0-dev'),
  547. // complex constraints
  548. array('~2.5.9|~2.6,>=2.6.2', '[[>= 2.5.9.0-dev < 2.6.0.0-dev] || [>= 2.6.0.0-dev < 3.0.0.0-dev >= 2.6.2.0-dev]]'),
  549. );
  550. }
  551. /**
  552. * @dataProvider multiConstraintProvider
  553. * @param string $constraint
  554. */
  555. public function testParseConstraintsMulti($constraint)
  556. {
  557. $parser = new VersionParser();
  558. $first = new Constraint('>', '2.0.0.0');
  559. $second = new Constraint('<=', '3.0.0.0');
  560. $multi = new MultiConstraint(array($first, $second));
  561. $this->assertSame((string) $multi, (string) $parser->parseConstraints($constraint));
  562. }
  563. /**
  564. * @return array<mixed>
  565. */
  566. public function multiConstraintProvider()
  567. {
  568. return array(
  569. array('>2.0,<=3.0'),
  570. array('>2.0 <=3.0'),
  571. array('>2.0 <=3.0'),
  572. array('>2.0, <=3.0'),
  573. array('>2.0 ,<=3.0'),
  574. array('>2.0 , <=3.0'),
  575. array('>2.0 , <=3.0'),
  576. array('> 2.0 <= 3.0'),
  577. array('> 2.0 , <= 3.0'),
  578. array(' > 2.0 , <= 3.0 '),
  579. );
  580. }
  581. public function testParseConstraintsMultiWithStabilitySuffix()
  582. {
  583. $parser = new VersionParser();
  584. $first = new Constraint('>=', '1.1.0.0-alpha4');
  585. $second = new Constraint('<', '1.2.9999999.9999999-dev');
  586. $multi = new MultiConstraint(array($first, $second));
  587. $this->assertSame((string) $multi, (string) $parser->parseConstraints('>=1.1.0-alpha4,<1.2.x-dev'));
  588. $first = new Constraint('>=', '1.1.0.0-alpha4');
  589. $second = new Constraint('<', '1.2.0.0-beta2');
  590. $multi = new MultiConstraint(array($first, $second));
  591. $this->assertSame((string) $multi, (string) $parser->parseConstraints('>=1.1.0-alpha4,<1.2-beta2'));
  592. }
  593. /**
  594. * @dataProvider multiConstraintProvider2
  595. *
  596. * @param string $constraint
  597. */
  598. public function testParseConstraintsMultiDisjunctiveHasPrioOverConjuctive($constraint)
  599. {
  600. $parser = new VersionParser();
  601. $first = new Constraint('>', '2.0.0.0');
  602. $second = new Constraint('<', '2.0.5.0-dev');
  603. $third = new Constraint('>', '2.0.6.0');
  604. $multi1 = new MultiConstraint(array($first, $second));
  605. $multi2 = new MultiConstraint(array($multi1, $third), false);
  606. $this->assertSame((string) $multi2, (string) $parser->parseConstraints($constraint));
  607. }
  608. /**
  609. * @return array<mixed>
  610. */
  611. public function multiConstraintProvider2()
  612. {
  613. return array(
  614. array('>2.0,<2.0.5 | >2.0.6'),
  615. array('>2.0,<2.0.5 || >2.0.6'),
  616. array('> 2.0 , <2.0.5 | > 2.0.6'),
  617. );
  618. }
  619. public function testParseConstraintsMultiWithStabilities()
  620. {
  621. $parser = new VersionParser();
  622. $first = new Constraint('>', '2.0.0.0');
  623. $second = new Constraint('<=', '3.0.0.0-dev');
  624. $multi = new MultiConstraint(array($first, $second));
  625. $this->assertSame((string) $multi, (string) $parser->parseConstraints('>2.0@stable,<=3.0@dev'));
  626. }
  627. public function testParseConstraintsMultiWithStabilitiesWildcard()
  628. {
  629. $parser = new VersionParser();
  630. $first = new Constraint('>', '2.0.0.0');
  631. $second = new MatchAllConstraint();
  632. $multi = new MultiConstraint(array($first, $second));
  633. $this->assertSame((string) $multi, (string) $parser->parseConstraints('>2.0@stable,@dev'));
  634. }
  635. public function testParseConstraintsMultiWithStabilitiesZero()
  636. {
  637. $parser = new VersionParser();
  638. $first = new Constraint('>', '2.0.0.0');
  639. $second = new Constraint('==', '0.0.0.0');
  640. $multi = new MultiConstraint(array($first, $second), false);
  641. $this->assertSame((string) $multi, (string) $parser->parseConstraints('>2.0@stable || 0@dev'));
  642. }
  643. /**
  644. * @dataProvider failingConstraints
  645. *
  646. * @param string $input
  647. */
  648. public function testParseConstraintsFails($input)
  649. {
  650. $this->doExpectException('UnexpectedValueException');
  651. $parser = new VersionParser();
  652. $parser->parseConstraints($input);
  653. }
  654. /**
  655. * @return array<mixed>
  656. */
  657. public function failingConstraints()
  658. {
  659. return array(
  660. 'empty ' => array(''),
  661. 'invalid version' => array('1.0.0-meh'),
  662. 'operator abuse' => array('>2.0,,<=3.0'),
  663. 'operator abuse/2' => array('>2.0 ,, <=3.0'),
  664. 'operator abuse/3' => array('>2.0 ||| <=3.0'),
  665. 'leading operator' => array(',^1@dev || ^4@dev'),
  666. 'leading operator/2' => array(',^1@dev'),
  667. 'leading operator/3' => array('|| ^1@dev'),
  668. 'trailing operator' => array('^1@dev ||'),
  669. 'trailing operator/2' => array('^1@dev ,'),
  670. 'caret+wildcard w/o -dev' => array('^2.0.*'),
  671. 'caret+wildcard w/o -dev/2' => array('^2.0.x'),
  672. 'caret+wildcard w/o -dev/3' => array('^2.0.x-beta'),
  673. 'caret+wildcard w/o -dev/4' => array('^2.*'),
  674. 'caret+wildcard w/o -dev/5' => array('^2.x'),
  675. 'caret+wildcard w/o -dev/6' => array('^2.x-beta'),
  676. 'caret+wildcard w/o -dev/7' => array('^2.1.2.*'),
  677. 'caret+wildcard w/o -dev/8' => array('^2.1.2.x'),
  678. 'caret+wildcard w/o -dev/9' => array('^2.1.2.x-beta'),
  679. 'tilde+wildcard w/o -dev' => array('~2.0.*'),
  680. 'tilde+wildcard w/o -dev/2' => array('~2.0.x'),
  681. 'tilde+wildcard w/o -dev/3' => array('~2.0.x-beta'),
  682. 'tilde+wildcard w/o -dev/4' => array('~2.*'),
  683. 'tilde+wildcard w/o -dev/5' => array('~2.x'),
  684. 'tilde+wildcard w/o -dev/6' => array('~2.x-beta'),
  685. 'tilde+wildcard w/o -dev/7' => array('~2.1.2.*'),
  686. 'tilde+wildcard w/o -dev/8' => array('~2.1.2.x'),
  687. 'tilde+wildcard w/o -dev/9' => array('~2.1.2.x-beta'),
  688. 'dash range with wildcard' => array('1.x - 2.*'),
  689. 'dash range with wildcards' => array('2.x.x.x-dev - 3.x.x.x-dev'),
  690. 'broken constraint with dev suffix' => array('^1.*-beta-dev'),
  691. 'broken constraint with dev suffix/2' => array('^1. *-dev'),
  692. 'broken constraint with dev suffix/3' => array('~1.*-beta-dev'),
  693. 'dev suffix conversion only works on simple strings' => array('1.0.0-dev<1.0.5-dev'),
  694. 'dev suffix conversion only works on simple strings/2' => array('*-dev'),
  695. 'just an operator' => array('^'),
  696. 'just an operator/2' => array('^8 || ^'),
  697. 'just an operator/3' => array('~'),
  698. 'just an operator/4' => array('~1 ~'),
  699. );
  700. }
  701. /**
  702. * @dataProvider stabilityProvider
  703. *
  704. * @param string $expected
  705. * @param string $version
  706. */
  707. public function testParseStability($expected, $version)
  708. {
  709. $this->assertSame($expected, VersionParser::parseStability($version));
  710. }
  711. /**
  712. * @return array<mixed>
  713. */
  714. public function stabilityProvider()
  715. {
  716. return array(
  717. array('stable', '1'),
  718. array('stable', '1.0'),
  719. array('stable', '3.2.1'),
  720. array('stable', 'v3.2.1'),
  721. array('dev', 'v2.0.x-dev'),
  722. array('dev', 'v2.0.x-dev#abc123'),
  723. array('dev', 'v2.0.x-dev#trunk/@123'),
  724. array('RC', '3.0-RC2'),
  725. array('dev', 'dev-master'),
  726. array('dev', '3.1.2-dev'),
  727. array('dev', 'dev-feature+issue-1'),
  728. array('stable', '3.1.2-p1'),
  729. array('stable', '3.1.2-pl2'),
  730. array('stable', '3.1.2-patch'),
  731. array('alpha', '3.1.2-alpha5'),
  732. array('beta', '3.1.2-beta'),
  733. array('beta', '2.0B1'),
  734. array('alpha', '1.2.0a1'),
  735. array('alpha', '1.2_a1'),
  736. array('RC', '2.0.0rc1'),
  737. array('alpha', '1.0.0-alpha11+cs-1.1.0'),
  738. array('dev', '1-2_dev'),
  739. );
  740. }
  741. public function testNormalizeStability()
  742. {
  743. $parser = new VersionParser();
  744. $stability = 'rc';
  745. $expectedValue = 'RC';
  746. $result = $parser->normalizeStability($stability);
  747. $this->assertSame($expectedValue, $result);
  748. $stability = 'no-rc';
  749. $expectedValue = $stability;
  750. $result = $parser->normalizeStability($stability);
  751. $this->assertSame($expectedValue, $result);
  752. }
  753. public function testManipulateVersionStringWithReturnNull()
  754. {
  755. $position = 1;
  756. $increment = 2;
  757. $matches = array(-1, -3, -2, -5, -9);
  758. $parser = new \ReflectionClass('\Composer\Semver\VersionParser');
  759. $manipulateVersionStringMethod = $parser->getMethod('manipulateVersionString');
  760. $manipulateVersionStringMethod->setAccessible(true);
  761. $result = $manipulateVersionStringMethod->invoke(new VersionParser(), $matches, $position, $increment);
  762. $this->assertNull($result);
  763. }
  764. public function testComplexConjunctive()
  765. {
  766. $parser = new VersionParser();
  767. $version = new Constraint('=', '1.0.1.0');
  768. $parsed = $parser->parseConstraints('~0.1 || ~1.0 !=1.0.1');
  769. $this->assertFalse($parsed->matches($version), '"~0.1 || ~1.0 !=1.0.1" should not allow version "1.0.1.0"');
  770. }
  771. /**
  772. * @param class-string $class
  773. * @param string|null $message
  774. * @return void
  775. */
  776. private function doExpectException($class, $message = null)
  777. {
  778. if (method_exists($this, 'expectException')) {
  779. $this->expectException($class);
  780. if ($message) {
  781. $this->expectExceptionMessage($message);
  782. }
  783. } else {
  784. // @phpstan-ignore-next-line
  785. $this->setExpectedException($class, $message);
  786. }
  787. }
  788. }