Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pmusolino/Wormholy
iOS network debugging, like a wizard 🧙♂️
https://github.com/pmusolino/Wormholy
alamofire charles debugger https ios logger logging network nsurlsession
Last synced: about 2 months ago
JSON representation
iOS network debugging, like a wizard 🧙♂️
- Host: GitHub
- URL: https://github.com/pmusolino/Wormholy
- Owner: pmusolino
- License: mit
- Created: 2018-04-09T14:11:55.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-03-25T06:54:25.000Z (3 months ago)
- Last Synced: 2024-03-30T20:42:29.650Z (3 months ago)
- Topics: alamofire, charles, debugger, https, ios, logger, logging, network, nsurlsession
- Language: Swift
- Homepage:
- Size: 2.02 MB
- Stars: 2,274
- Watchers: 24
- Forks: 180
- Open Issues: 27
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Lists
- awesome-ios - Wormholy - iOS network debugging, like a wizard. (Debugging / Getting Started)
- awesome-swift - Wormholy - iOS network debugging, like a wizard 🧙. (Libs / Network)
- awesome-swift - Wormholy - iOS network debugging, like a wizard 🧙. (Libs / Network)
- awesome-swift4 - Wormholy - iOS network debugging, like a wizard 🧙. (Libs / Network)
- awesome-ios-star - Wormholy - iOS network debugging, like a wizard. (Debugging / Getting Started)
- learn.awesome.ios - Wormholy - iOS network debugging, like a wizard. (Debugging / Linter)
- awesome-ios - Wormholy - iOS network debugging, like a wizard. (Debugging / Linter)
- awesome-swift - Wormholy - iOS network debugging, like a wizard 🧙. (Libs / Network)
- awesome-ios - Wormholy - iOS network debugging, like a wizard. (Debugging / Linter)
- awesome-from-stars - pmusolino/Wormholy
- awesome-iosx - Wormholy - iOS network debugging, like a wizard. (Debugging / Getting Started)
- awesome-ios - Wormholy - iOS network debugging, like a wizard. (Debugging / Linter)
- awesome-iosr - Wormholy - iOS network debugging, like a wizard. (Debugging / Getting Started)
- awesome-swiftxx - Wormholy - iOS network debugging, like a wizard 🧙. (Libs / Network)
- awesome-stars - pmusolino/Wormholy - iOS network debugging, like a wizard 🧙♂️ (Swift)
- awesome-ios - Wormholy - iOS network debugging, like a wizard. (Debugging / Linter)
- awesome-stars - pmusolino/Wormholy - iOS network debugging, like a wizard 🧙♂️ (Swift)
- fucking-awesome-swift - Wormholy - iOS network debugging, like a wizard 🧙. (Libs / Network)
- awesome-swifty - Wormholy - iOS network debugging, like a wizard 🧙. (Libs / Network)
- awesome-stars - pmusolino/Wormholy - `★2311` iOS network debugging, like a wizard 🧙♂️ (Swift)
- awesome-swiftqq - Wormholy - iOS network debugging, like a wizard 🧙. (Libs / Network)
- awesome-swifte - Wormholy - iOS network debugging, like a wizard 🧙. (Libs / Network)
- awesome-swift - Wormholy - iOS network debugging, like a wizard ` 📝 6 months ago ` (Network [🔝](#readme))
README
[]()
[](https://cocoapods.org/pods/Wormholy)
[](https://github.com/Carthage/Carthage)
Start debugging iOS network calls like a wizard, without extra code! Wormholy makes debugging quick and reliable.
**What you can do:**
- [x] No code to write and no imports.
- [x] Record all app traffic that uses `NSURLSession`.
- [x] Reveal the content of all requests, responses, and headers simply by shaking your phone!
- [x] No headaches with SSL certificates on HTTPS calls.
- [x] Find, isolate and fix bugs quickly.
- [x] Swift & Objective-C compatibility.
- [x] Also works with external libraries like `Alamofire` & `AFNetworking`.
- [x] Ability to blacklist hosts from being recorded using the array `ignoredHosts`.
- [x] Ability to export API requests as Postman collection
- [x] Ability to share cURL rappresentation of API requests
## Requirements
----------------
- iOS 11.0+
- Xcode 10+
- Swift 4, 4.1, 4.2 and Swift 5
## Usage
----------------
Add it to your project, and that's all! **Shake your device** or your simulator and Wormholy will appear! You don't need to import the library into your code, it works magically!
I suggest you install it only in debug mode. The easiest way is with CocoaPods:
```
pod 'Wormholy', :configurations => ['Debug']
```
If you want to disable the shake, and fire Wormholy from another point inside your app, you need to set the [environment variable](https://medium.com/@derrickho_28266/xcode-custom-environment-variables-681b5b8674ec) `WORMHOLY_SHAKE_ENABLED` = `NO`, and call this local notification:
```
NotificationCenter.default.post(name: NSNotification.Name(rawValue: "wormholy_fire"), object: nil)
```
You can also programmatically enable/disable the shake gesture at any time. You can do `Wormholy.shakeEnabled = false` to disable (or enable) the shake gesture.
## Carthage
----------------
You can also install Wormholy using [Carthage](https://github.com/Carthage/Carthage).
To integrate Wormholy into your Xcode project using Carthage, specify it in your `Cartfile`:
```ogdl
github "pmusolino/Wormholy"
```
Run `carthage update` to build the framework and drag the built `Wormholy.framework` into your Xcode project.
## Contributing
- If you **need help** or you'd like to **ask a general question**, open an issue.
- If you **found a bug**, open an issue.
- If you **have a feature request**, open an issue.
- If you **want to contribute**, submit a pull request.
## Acknowledgements
**Made with ❤️ by [Paolo Musolino](https://github.com/pmusolino).**
***Follow me on:***
#### 💼 [Linkedin](https://www.linkedin.com/in/paolomusolino/)
#### 🤖 [Twitter](https://twitter.com/pmusolino)
#### 🌇 [Instagram](https://www.instagram.com/pmusolino/)
#### 👨🏼🎤 [Facebook](https://www.facebook.com/paolomusolino)
## MIT License
----------------
Wormholy is available under the MIT license. See the LICENSE file for more info.