Swiftpack.co -  Farfetch/network-monitor-ios as Swift Package
Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
Farfetch/network-monitor-ios
Network Monitor SDK for iOS
.package(url: "https://github.com/Farfetch/network-monitor-ios.git", from: "11.8.0")

FNMNetworkMonitor

CocoaPods Compatible Supported languages Platform

What is this ?

FNMNetworkMonitor is a swift iOS networking framework that can be used to monitor the network of an iOS app. It makes debugging the network easy, allowing you to pinpoint the root cause of network related problems in your app and share those requests via email. it can also mock network requests, making it much easier to use incomplete APIs or model specific states for unit testing.

Supports Swift 5 and is bridged for Obj-C compatibility.

Preview:

Installation ⚙️

Cocoapods

  • Add pod 'FNMNetworkMonitor' to your Podfile

Swift Package Manager

Usage

There are a few ways to monitor the network:

  1. Monitoring URLSession.shared:
FNMNetworkMonitor.registerToLoadingSystem()
FNMNetworkMonitor.shared.startMonitoring()
  1. Monitoring custom URLSessions by supplying the FNMMonitor URL Protocol:
let sessionConfig = URLSessionConfiguration.ephemeral
sessionConfig.protocolClasses = FNMNetworkMonitor.normalizedURLProtocols()
self.customSession = URLSession(configuration: sessionConfig)
FNMNetworkMonitor.shared.startMonitoring()
  1. You can also take advantage of swizzling the URLSessionConfiguration creation to configure the URL Protocol to all sessions, allowing to monitor 3rd party SDKs too.

Additionally, you can mock certain requests using:

let request = FNMProfileRequest(urlPattern: .dynamicPattern(expression: "*farfetch.*robots"))
let profiles = [FNMProfile(request: request,
                           responses: [request.response(statusCode: 200,
                                            headers: [ "Content-Type": "application/json" ],
                                            responseHolder: .keyValue(value: [ "FieldA": 1 ])
                                            delay: 0.25)])]
FNMNetworkMonitor.shared.configure(profiles: profiles)
FNMNetworkMonitor.shared.startMonitoring()

You can also ignore domains using:

FNMNetworkMonitor.shared.configure(ignoredDomains: ["somedomain.com"])

This won't record nor intercept requests for this domain.

Make sure to follow steps 1, 2 or 3, depending on the URLSession that runs that particular request.

How to see it all

A debug UI exists that can be used for easy inspection and export of the network:

FNMNetworkMonitor.shared.showDebugListingViewController(presentingNavigationController: self.navigationController)

Generally, the shake gesture is a great way to show/hide the debug view.

Also, different log levels can be applied to see how the requests are navigating through the monitor:

FNMNetworkMonitor.shared.logScope = [.export, .profile, .urlProtocol]

Finally, you can turn on the passive export and the requests will be exported to a json file inside a folder found the Documents application folder.

FNMNetworkMonitor.shared.passiveExportPreference = FNMRecordExporterPreference.on(setting: .unlimited)

Media payload recording

If you want to allocate less memory while using network monitor, you can disable media paylod recording:

FNMNetworkMonitor.shared.recordMediaPayload(false)

Sample app

The project contains a sample app where you can test the tool. You can run the Sample Target Scheme in NetworkMonitor.xcworkspace to see a working example of the framework.

Contributing

Read the Contributing guidelines

Disclaimer

By sending us your contributions, you are agreeing that your contribution is made subject to the terms of our Contributor Ownership Statement

Maintainers

List of Maintainers

License

The FNMNetworkMonitor is released under the MIT license. See the LICENSE file for more details.

GitHub

link
Stars: 50
Last commit: 5 weeks ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Release Notes

This Release Now Allows for Domain Ignored List
5 weeks ago

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API