Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shakurocom/httpclient

alamofire cocoapods endpoint http-client ios parser swift uikit urlsession xcode

Last synced: about 1 month ago
JSON representation

Host: GitHub
URL: https://github.com/shakurocom/httpclient
Owner: shakurocom
License: mit
Created: 2021-03-23T08:18:23.000Z (almost 4 years ago)
Default Branch: master
Last Pushed: 2024-07-02T14:45:17.000Z (6 months ago)
Last Synced: 2024-12-01T09:46:53.243Z (about 1 month ago)
Topics: alamofire, cocoapods, endpoint, http-client, ios, parser, swift, uikit, urlsession, xcode
Language: Swift
Homepage:
Size: 711 KB
Stars: 4
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE.md

Awesome Lists containing this project

README

![Shakuro HTTPClient](Resources/title_image.png)

# HTTPClient
![Version](https://img.shields.io/badge/version-1.1.4-blue.svg)
![Platform](https://img.shields.io/badge/platform-iOS-lightgrey.svg)
![License MIT](https://img.shields.io/badge/license-MIT-green.svg)

- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [License](#license)

HTTPClient is a Swift library designed to abstract away access to Alamofire. The main purpose of the HTTPClient component is to encapsulate endpoints description inside some network abstraction layer to avoid calling Alamofire directly. Enums are used to define enpoints. This allows to make compile-time checks for correct API endpoint accesses.

![](Resources/HTTPClient.png)

## Requirements

- iOS 13.0+
- Xcode 15.0+
- Swift 5.0+

## Installation

### CocoaPods

To integrate HTTPClient into your Xcode project with CocoaPods, specify it in your `Podfile`:

```ruby
pod 'Shakuro.HTTPClient'
```

Then, run the following command:

```bash
$ pod install
```

### Manually

If you prefer not to use CocoaPods, you can integrate Shakuro.HTTPClient simply by copying it to your project.

## Usage

1. Create a couple of endpoints by adopting `HTTPClientAPIEndPoint` protocol.
2. Create responses parsers by adopting `HTTPClientParser` protocol.
3. Create new instance of `HTTPClient` class.
4. Start your HTTP request by calling `.sendRequest`. You should use completions to handle parsed results.

Take a look at the [HTTPClient_Example](https://github.com/shakurocom/HTTPClient/tree/master/HTTPClient_Example) for more info.

## License

Shakuro.HTTPClient is released under the MIT license. [See LICENSE](https://github.com/shakurocom/HTTPClient/blob/master/LICENSE.md) for details.

## Give it a try and reach us

Star this tool if you like it. This will help us grow and add new useful things. Feel free to reach out and hire our team to develop a mobile or web project for you.