Reqres

KO | EN

gitlite — search

#hacktoberfest #react #typescript #golang #rust #linux #docker #macos #java #awesome #cli #kubernetes #mcp #openai

(★ 93)

Simple network activity logger for iOS

파일 탐색기

최종 버전 다운로드 (.zip)

- - checks.yml
  - deploy.yml
  - docs.yml
  - stale.yml
  - tests.yml
- PULL_REQUEST_TEMPLATE.md
- xcode-version
- - contents.xcworkspacedata
- project.pbxproj
- - LaunchScreen.storyboard
  - Main.storyboard
- AppDelegate.swift
- Info.plist
- ViewController.swift
- cover-image.png
- - Reqres.h
  - Reqres.swift
  - ReqresDefaultLogger.swift
  - ReqresLogging.swift
- Reqres.plist
- - ReqresDefaultLoggerTests.swift
  - ReqresDefaultNSLogger.swift
.gitignore
.swiftlint.yml
CHANGELOG.md
LICENSE
Package.swift
README.md
Reqres.podspec

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![ackee|Reqres](https://raw.githubusercontent.com/AckeeCZ/Reqres/main/Resources/cover-image.png)

![Tests](https://github.com/AckeeCZ/ACKategories/workflows/Tests/badge.svg)
[![Version](https://img.shields.io/cocoapods/v/Reqres.svg?style=flat)](http://cocoapods.org/pods/Reqres)
[![License](https://img.shields.io/cocoapods/l/Reqres.svg?style=flat)](http://cocoapods.org/pods/Reqres)
[![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)
[![Platform](https://img.shields.io/cocoapods/p/Reqres.svg?style=flat)](http://cocoapods.org/pods/Reqres)

Reqres is a simple library for logging all requests and responses in your app. It supports Alamofire and also requests made via native NSURLSession.

```
⬆️ POST 'https://ackee.cz/examples'
Headers: [
    Accept-Encoding : gzip;q=1.0, compress;q=0.5
    Accept-Language : en-US;q=1.0
    Content-Type : application/json
    User-Agent : Reqres_Example/org.cocoapods.demo.Reqres-Example (1; OS Version 9.3 (Build 13E230))
    Content-Length : 13
]
Body: {
    "foo" : "bar"
}

...

⬇️ POST https://ackee.cz/examples (✅ 201 Created) [time: 0.54741 s]
Headers: [
    Vary : Authorization,Accept-Encoding
    Content-Encoding : gzip
    Content-Length : 13
    Server : Apache
    Content-Type : application/json
    Date : Mon, 05 Sep 2016 07:33:51 GMT
    Cache-Control : no-cache
]
Body: {
    "foo" : "bar"
}
```

## Installation

### CocoaPods

Reqres is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:

```ruby
pod "Reqres"
```

### Carthage

You can use [Carthage](https://github.com/Carthage/Carthage).
Specify in Cartfile:

```ruby
github "AckeeCZ/Reqres"
```

Run `carthage update` to build the framework and drag the built Reqres.framework into your Xcode project. Follow [build instructions](https://github.com/Carthage/Carthage#getting-started). [New Issue](https://github.com/AckeeCZ/Reqres/issues/new).

## Usage
Initialization is different for usage with Alamofire and NSURLSession.

### Alamofire
Create your `SessionManager` with proper configuration to make it work with Alamofire.
```swift
let configuration = Reqres.defaultSessionConfiguration()
configuration.httpAdditionalHeaders = SessionManager.defaultHTTPHeaders
let alamofireManager = SessionManager(configuration: configuration)
Reqres.sessionDelegate = alamofireManager.delegate
```
Then you must use this manager for all requests, so replace all `Alamofire.request(...)` to `alamofireManager.request(...)`

### Usage without Alamofire
Register Reqres on application startup and it will monitor and log any requests you make via NSURLSession or NSURLConnection.

```swift
ReqresLogger.register()
```

## Customization
You can do some settings to make it fit your needs.

### Custom logger
Reqres uses default `print()` for logging to avoid unnecessary dependencies but it's ready for any logging framework. Make your custom logger class which complies to `ReqresLogging` protocol and set it to Reqres, that's all.
```
class MyLogger: ReqresLogging {
    ...
}

ReqresLogger.logger = MyLogger()
```

### Log level
You can use 3 different log levels:
- **None** - made for production use, it completely disables all Reqres functionality
- **Light** - Logs only basic info (method, url, status code and time)
```
⬆️ POST 'https://ackee.cz/examples'
...
⬇️ POST https://ackee.cz/examples (✅ 201 Created) [time: 0.54741 s]
```
- **Verbose** - Logs also headers and body (see example above)

Reqres uses `Verbose` log level by default. To change log level just set right value to `Reqres.logger.logLevel`

### Emoji
Reqres uses emoji to make log better to read and to make it at least a little funny and nice. If you dont't like that, you can turn it off of course.
```swift
ReqresLogger.allowUTF8Emoji = false
```

## Forking this repository
If you use Reqres in your projects drop us as tweet at [@ackeecz][1]. We would love to hear about it!

## Sharing is caring
This tool and repo has been opensourced within our `#sharingiscaring` action when we have decided to opensource our internal projects.

## Author

[Ackee](https://www.ackee.cz) team. We were inspired by andysmart's [Timberjack](https://github.com/andysmart/Timberjack)

## License

Reqres is available under the MIT license. See the LICENSE file for more info.

[1]:	https://twitter.com/AckeeCZ

Reqres

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Reqres

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README