-
Notifications
You must be signed in to change notification settings - Fork 4
Add neo properties chapter #278
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
base: neodymium-documentation
Are you sure you want to change the base?
Conversation
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 checked the quick start guide and added some comments, please take care @RobertAvemarg
|
||
* as JUnit test via IDE | ||
* `mvn clean test` for all tests | ||
* `mvn clean test -Dtest=<NameOfTestClass>` for specific tests |
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.
please add how to run a single test method
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.
done
|
||
### Generate Reports | ||
|
||
* `mvn allure:serve` to generate and show the report |
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.
maybe a line to run tests AND generate a report (just for copy and past purposes)
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.
done
|
||
## Useful Annotations | ||
|
||
### Test JUnit5 |
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.
maybe "Define Test"?
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.
what do you mean?
|
||
`@NeodymiumTest` - on test methods | ||
|
||
### Test JUnit4 |
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.
maybe "Define Test"?
|
||
Methods can have multiple `@DataSet()` annotations | ||
|
||
* `@DataSet("<dataSetId>")` - limit method to data set with defined id |
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.
That won't work, you have to use @DataSet(id="<dataSetId>")
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.
you are right. thanks!
|
||
{{< TODO >}}check if the info boxes are useful and move them to a good position{{< /TODO >}} | ||
|
||
{{% note title="most common browser properties" %}} |
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.
nice look and feel, but still maybe a bit much for the sake of this quick start, also you have an additional chapter about configs below.
tests are annotated, so the Neodymium default browser is used. To execute all tests with every configured browser, | ||
we annotate the AbstractTest class with `@Browser("<browserId>")` for each browser. Individual test methods within a | ||
class can also be run with different browsers by annotating them with `@Browser("<browserId>")` or all browsers can be | ||
suppressed using `@SuppressBrowsers`. |
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.
remove the SuppressBrowsers part
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.
done
import com.xceptance.neodymium.util.Neodymium; | ||
import org.junit.jupiter.api.BeforeEach; | ||
@Browser |
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.
remove the default browser?
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.
done
configurations, `dev-*.properties` files can be used to override or add values. It is crucial to exclude these files | ||
from version control to avoid unintended consequences for CI/CD and commiting secrets. Temporary property files can be | ||
created during test execution using | ||
`ConfigFactory.setProperty(Neodymium.TEMPORARY_CONFIG_FILE_PROPERTY_NAME, "file:" + fileLocation);` within a |
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.
the temp config file name is mostly for unit tests isn't it?
recording is added to the Allure report. Otherwise, it's only added if appendAllRecordingsToAllureReport is set to | ||
`true`. | ||
|
||
## Accessibility |
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.
Accessibility Testing
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.
changed it
No description provided.