Repository files navigation

Start debugging iOS network calls like a wizard, without extra code! Wormholy makes debugging quick and reliable.

Features:

• No code to write and no imports.
• Record all app traffic that usesNSURLSession.
• Reveal the content of all requests, responses, and headers simply by shaking your phone!
• No headaches with SSL certificates on HTTPS calls.
• Find, isolate, and fix bugs quickly.
• Swift & Objective-C compatibility.
• Also works with external libraries likeAlamofire &AFNetworking.
• Ability to blacklist hosts from being recorded using the arrayignoredHosts.
• Ability to export API requests as a Postman collection.
• Ability to share cURL representations of API requests.
• Programmatically enable or disable Wormholy for specific session configurations.
• Control the shake gesture activation with theshakeEnabled property.
• Filter responses by status code for precise debugging.
• View request stats, including HTTP methods breakdown, status code distribution, error types, response size stats, and more.

• iOS 16.0+
• Xcode 15+
• Swift 5

Integrating Wormholy into your project is simple, and it works like magic!Shake your device or simulator to access Wormholy. There's no need to import the library into your code.

It is recommended to install it only in debug mode and not integrate it into production. Please remove it before sending your apps to production. The easiest way to do this is with CocoaPods:

pod'Wormholy', :configurations => ['Debug']

You can also integrate Wormholy using theSwift Package Manager!

• Ignored Hosts: Specify hosts to be excluded from logging usingWormholy.ignoredHosts. This is useful for ignoring traffic to certain domains.
• Logging Limit: Control the number of logs retained withWormholy.limit. This helps manage memory usage by limiting the amount of data stored.
• Default Filter: Set a default filter for the search box withWormholy.defaultFilter to streamline your debugging process.
• Enable/Disable: UseWormholy.setEnabled(_:) to toggle request tracking globally. You can also enable or disable it for specificURLSessionConfiguration instances usingWormholy.setEnabled(_:sessionConfiguration:).
• Shake Gesture: Control the activation of Wormholy via shake gesture withWormholy.shakeEnabled.

If you prefer not to use the shake gesture, you can disable it using theenvironment variableWORMHOLY_SHAKE_ENABLED =NO.

To trigger Wormholy manually from another point in your app without using the shake gesture, call:

NotificationCenter.default.post(name:NSNotification.Name(rawValue:"wormholy_fire"), object:nil)

By following these steps and configurations, you can effectively integrate Wormholy into your development workflow, enhancing your ability to debug network requests efficiently.

• If youneed help or you'd like toask a general question, open an issue.
• If youfound a bug, open an issue.
• If youhave a feature request, open an issue.
• If youwant to contribute, submit a pull request.

Made with ❤️ byPaolo Musolino.

Follow me on:

Wormholy is available under the MIT license. See the LICENSE file for more information.