Command-line tools for macOS. With xrun you can run iOS and iPadOS unit tests through the terminal or CI with more ease and reading.
- Shows the tests that were executed most easily.
- Shows a table with test information.
- If there is an error, it shows a table with failed tests.
- Runs in the terminal and CI with an easy command
Installing
Installing from crates.io (requires Rust/Cargo):
cargo install xrun
How to use?
Example .xcodeproj
Example .xcworkspace
Example with fail
If you want when any test fails at the end, shows the terminal or CI as an error (it is optional if you don't use it and even test fails not to show it at terminal or CI as an error).
__ __ ____ _ _ _ _
\ \/"/ U | _"\ uU |"|u| | | \ |"|
/\ /\ \| |_) |/ \| |\| |<| \| |>
U / \ u | _ < | |_| |U| |\ |u
/_/\_\ |_| \_\ <<\___/ |_| \_|
,-,>> \\_ // \\_(__) )( || \\,-.
\_) (__)(__) (__) (__) (_") (_/ (0.6.0)
💻 https://github.com/heroesofcode/xrun
===================================================
📋 Processing.......
CoreTests
✅ testSuccessWhenRegisteringTheUICollectionViewCellAndDequeuing (0.064 seconds)
✅ testSuccessWhenRegisteringTheUITableViewCellAndDequeuing (0.013 seconds)
✅ testWhenSetupBaseViewWithSuccess (0.001 seconds)
DesignSystemTests
✅ testShouldValidateLayout (0.137 seconds)
CoordinatorTests
✅ testHandleEvent (0.002 seconds)
✅ testInit (0.003 seconds)
✅ testStart (0.001 seconds)
AnalyticsTests
✅ testExample (0.001 seconds)
AuthenticationTests
✅ testShouldValidateLayout (0.093 seconds)
🗳️ The results have been completed below
+---------+-------------+-----------------+------------------+
| Runtime | Total Tests | ✅ Passed Tests | ❌ Failed Tests |
+============================================================+
| 65.45s | 9 | 9 | 0 |
+---------+-------------+-----------------+------------------+
👏 Congratulations, no errors were found!!!
If all tests present errors, a table will be presented with the information and another table with only the errors.
CoordinatorTests
✅ testHandleEvent (0.001 seconds)
❌ testInit, XCTAssertNil failed: "Coordinator.BaseCoordinator"
✅ testStart (0.000 seconds)
AnalyticsTests
✅ testExample (0.001 seconds)
AuthenticationTests
❌ testShouldValidateLayout, failed - Snapshot does not match reference.
🗳️ The results have been completed below
+---------+-------------+-----------------+------------------+
| Runtime | Total Tests | ✅ Passed Tests | ❌ Failed Tests |
+============================================================+
| 35.64s | 48 | 46 | 2 |
+---------+-------------+-----------------+------------------+
⚠️ Below contains the errors
+---------------------+------------------------------------------------------------------------------+
| Module | Errors found |
+====================================================================================================+
| CoordinatorTests | ❌ testInit, XCTAssertNil failed: "Coordinator.BaseCoordinator" |
|---------------------+------------------------------------------------------------------------------|
| AuthenticationTests | ❌ testShouldValidateLayout, failed - Snapshot does not match reference. |
+---------------------+------------------------------------------------------------------------------+
GitHub Actions
It works on any CI, here I'll bring an example on GitHub Action for you to add to your iOS/iPadOS project
- name: Install Rust
uses: actions-rs/toolchain@v1
with:
toolchain: stable
profile: minimal
override: true
- name: Install xrun
run: cargo install xrun
- name: Run tests with xrun
run: xrun project DeliveryApp.xcodeproj DeliveryApp 17.2 15
Contributing
To contribute, just fork this project and then open a pull request, feel free to contribute, bring ideas and raise any problem in the issue tab.
License
xrun is released under the MIT license. See LICENSE for details.