Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Subito-it/SBTUITestTunnel
Enable network mocks and more in UI Tests
https://github.com/Subito-it/SBTUITestTunnel
cocoapods network-monitoring stub testing-tools ui-automated-tests xcode xcodebuild xctest xcuitest
Last synced: 10 days ago
JSON representation
Enable network mocks and more in UI Tests
- Host: GitHub
- URL: https://github.com/Subito-it/SBTUITestTunnel
- Owner: Subito-it
- License: other
- Created: 2016-04-28T08:10:04.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-09-22T16:29:20.000Z (about 2 months ago)
- Last Synced: 2024-10-25T14:00:11.392Z (14 days ago)
- Topics: cocoapods, network-monitoring, stub, testing-tools, ui-automated-tests, xcode, xcodebuild, xctest, xcuitest
- Language: Objective-C
- Size: 4.63 MB
- Stars: 345
- Watchers: 21
- Forks: 75
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-awesome-swift - SBTUITestTunnel - UI testing library for interact with network requests, stub CLLocationManager and UNUserNotificationCenter, and fine grain scrolling in table/collection/scroll views (Libs / Testing)
- awesome-swift - SBTUITestTunnel - UI testing library for interact with network requests, stub CLLocationManager and UNUserNotificationCenter, and fine grain scrolling in table/collection/scroll views (Libs / Testing)
README
# SBTUITestTunnel
[](https://github.com/Subito-it/SBTUITestTunnel/actions/workflows/build-and-test.yml)
[](https://cocoapods.org/pods/SBTUITestTunnel)
[](https://cocoapods.org/pods/SBTUITestTunnel)
[](https://cocoapods.org/pods/SBTUITestTunnel)
[](https://img.shields.io/badge/Swift_Package_Manager-compatible-green?style=flat)
## Overview
Apple introduced a new UI Testing feature starting from Xcode 7 that is, quoting Will Turner [on stage at the WWDC](https://developer.apple.com/videos/play/wwdc2015/406/), a huge expansion of the testing technology in the developer tools. The framework is easy to use and the integration with the IDE is great however there is a major problem with the way tests are launched. Testing code runs as a separate process which prevents to directly share data with the app under test making it hard to do things like dynamically inject data or stub network calls.
SBTUITestTunnel extends UI testing functionality allowing to dynamically:
* stub network calls
* download/upload files from/to the app's sandbox
* monitor network calls
* rewrite network calls
* block cookies
* interact with NSUserDefaults
* define custom blocks of codes executed in the application target
* fine grain fast-scrolling in table/collection/scroll views
* CLLocationManager stubbing
* UNUserNotificationCenter stubbing
The library supports concurrent parallel testing, so multiple Simulators can be used at once.
The library consists of two separated components which communicate with each other, one to be instantiate in the application's target and the other in the testing target.
## Should I use this?
SBTUITestTunnel is intended to extend Apple's XCTest framework, not to replace it. It all boils down to a single subclass of XCUIApplication which comes with the additional features listed above, so it is very easy to integrate with your existing testing code.
## Documentation
- [Installation](https://github.com/Subito-it/SBTUITestTunnel/tree/master/Documentation/Installation.md): Describes how to install the library
- [Setup](https://github.com/Subito-it/SBTUITestTunnel/tree/master/Documentation/Setup.md): Describes how to integrate the library in your code
- [Usage](https://github.com/Subito-it/SBTUITestTunnel/tree/master/Documentation/Usage.md): Describes how to use the library
- [Example](https://github.com/Subito-it/SBTUITestTunnel/tree/master/Documentation/Example.md): Describes how to setup and use the example app
## Additional resources?
We made additional resources available to improve the UI Testing experience:
- [Mendoza](https://github.com/Subito-it/Mendoza): parallelize UI tests over multiple physical machines
- [Cachi](https://github.com/tcamin/Cachi): parse Xcode's 11 .xcresult bundles
- [SBTUITestTunnelHost](https://github.com/Subito-it/SBTUITestTunnelHost): access the mac host from your test target
## Thanks
Kudos to the developers of the following pods which we use in SBTUITestTunnel:
* [GCDWebServer](https://github.com/swisspol/GCDWebServer)
* [DetoxIPC](https://github.com/wix/DetoxIPC)
## Contributions
Contributions are welcome! If you have a bug to report, feel free to help out by opening a new issue or sending a pull request.
## Authors
[Tomas Camin](https://github.com/tcamin) ([@tomascamin](https://twitter.com/tomascamin))
## License
SBTUITestTunnel is available under the Apache License, Version 2.0. See the LICENSE file for more info.