-
-
Notifications
You must be signed in to change notification settings - Fork 1.6k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
chore: IntegrationTest - move support of php< requirement to main Integration classes #7448
Conversation
* * Section or any line in it may be omitted. | ||
* ** PHP minimum version. Default to current running php version (no effect). | ||
* *** PHP upper limit, that is first too-high version. Default is empty (no effect). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Using asterisk here is IMHO totally unreadable, because whole phpDoc is behind *
. Single asterisk after section marker can't be there in actual test case, also **
and ***
makes JSON invalid. I would totally change it since you're cleaning this up.
* * Section or any line in it may be omitted. | |
* ** PHP minimum version. Default to current running php version (no effect). | |
* *** PHP upper limit, that is first too-high version. Default is empty (no effect). | |
* IMPORTANT: | |
* - Some sections (like `--CONFIG--`) may be omitted. The required sections are: `--TEST--`, `--RULESET--` and `--EXPECT--` (which works as input too if `--INPUT--` is not provided, that means no changes are expected). | |
* - `--REQUIREMENTS--` section can define additional constraints for running (or not) the test. You can use these fields to fine-tune run conditions for test cases: | |
* - `php` represents minimum PHP version test should be run on. Default to current running PHP version (no effect). | |
* - `php<` represents maximum PHP version test should be run on. Default to PHP's maximum integer value (no effect). | |
* - `os` represents operating system(s) test should be run on. Supported operating systems are Linux, Darwin and Windows. By default test is run on all supported operating systems. |
The asterisks must be removed from the snippet, but I can't make full suggestion here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm not in favour of manually listing which section is obligatory instead marking it in format itself.
if the full suggestion is not working here for you, maybe raise a dedicated PR/subPR?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
But it makes format malformed and unclear, since asterisks are either on the left (phpDoc) and on the right ("annotations"). Your choice 🤷♂️.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I extended the already existing list. If you want to change syntax of this list, please raise a new PR (especially as you had a code in mind, just you couldn't provide full snippet, as you said).
For me, out of scope of this PR, following your reasoning from previous PRs :D
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fair enough 😉.
No description provided.