Awesome
<p align="center"> <img src ="https://cloud.githubusercontent.com/assets/3276768/22606144/035a4a28-ea53-11e6-8359-323c214c2439.png"/> </p>Dotzu
In-App iOS Debugging Tool With Enhanced Logging, Networking Info, Crash reporting And More.
<img src="https://img.shields.io/badge/platform-iOS-blue.svg?style=flat" alt="Platform iOS" /> <img src="https://img.shields.io/badge/Carthage-compatible-brightgreen.svg?style=flat" alt="Carthage compatible" /> <img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat" alt="License MIT" />The debugger tool for iOS developer. Display logs, network request, device informations, crash logs while using the app. Easy accessible with its bubble head button 🔘. Easy to integrate in any apps, to handle development or testing apps easier. First version, there is plenty of room for improvement.
</br> <p align="center"> <img src ="https://cloud.githubusercontent.com/assets/3276768/22604003/dd161210-ea49-11e6-923d-b4b32acfd642.gif"/> </p>Usage
In the AppDelegate
instanciate Dotzu manager
.
Be careful to use Dotzu for development purpose only.
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
#if DEBUG
Dotzu.sharedManager.enable()
#endif
return true
}
Logs
Dotzu override print
, so you can use it and see your logs. otherwise, you can add level, and get more details (file, and line) about your logs. With the Logger
class provided by the framework. Get new logs count on the badge, or warning/error notification on the bubble head.
<a href="http://promisesaplus.com/">
<img src="https://cloud.githubusercontent.com/assets/3276768/22610650/ba71cf2a-ea66-11e6-8f94-6d3c9916740e.gif" align="right" />
</a>
print("logs")
Logger.verbose("some logs")
Logger.info("infos")
Logger.warning("warning ! ⚠️")
Logger.error("error ❌")
Network
Dotzu use URLProcotol
to logg the request. Can can add the logger on a custom URLSessionConfiguration. Works with Alamofire. Works by default with URLSession.shared
. You can disabled the networking logging in the settings screen. Get notified by a 🚀, when a request is launched.
//Your custom configuration
let configuration = URLSessionConfiguration.default
///Add the network logger on the configuration
Dotzu.sharedManager.addLogger(session: configuration)
//Use it:
//For Alamofire
let sessionManager = Alamofire.SessionManager(configuration: configuration)
//For URLSession
let session = URLSession(configuration: configuration)
Installation
CocoaPods
You can use CocoaPods to install Dotzu
by adding it to your Podfile
:
platform :ios, '9.0'
use_frameworks!
pod 'Dotzu'
For Objective-c use :
pod 'DotzuObjc'
Carthage
Add this to your Cartfile:
github "remirobert/Dotzu"
Manually
Drag the source files into your project.
Installation - Objective-c
CocoaPods
You can use CocoaPods to install DotzuObjc
by adding it to your Podfile
:
platform :ios, '9.0'
use_frameworks!
pod 'DotzuObjc'
Contact
- Rémi ROBERT
- Twitter: @remi936
License
Dotzu is released under the MIT License.