Booming

Booming is a base network library for Swift. Developed for Swift 5, it aims to make use of the latest language features. The framework's ultimate goal is to enable easy networking that makes it easy to write well-maintainable code.

RxNetworks is a declarative and reactive networking library for Swift.

🧚. RxSwift + Moya + HandyJSON / Codable + Plugins.👒👒👒

---

English | 简体中文

This is a network api set of infrastructure based on Moya, also support responsive network with RxSwift.

Features

At the moment, the most important features of Booming can be summarized as follows:

• Support reactive network requests combined with RxSwift.
• Support for OOP also support POP network requests.
• Support data parsing with HandyJSON and Codable.
• Support simple customization of various network plugins for Moya.
• Support uploading and downloading files or resources plugin.
• Support configuration of general request and path, general parameters, etc.
• Support for added default plugins with BoomingSetup.basePlugins.
• Support authorization certificate plugin with Alamofire RequestInterceptor.
• Support automatic managed loading plugins hud.
• Support token plugin validation and automatically retries new token requests.
• Support shared plugin that do not request the same network repeatedly.
• Support separate plugin library, eg: Loading / AnimatedLoading / Cache.
• Support 18 plugins have been packaged for you to use.

Usages

How to use CODE_OF_CONDUCT.

SharedAPI.userInfo(name: "yangKJ").request(successed: { response in
    // do somthing..
}, failed: { error in
    print(error.localizedDescription)
})

or use async/await with swift 5.5

Task {
    do {
        let response = try await LoadingAPI.test2("666").requestAsync()
        let json = response.bpm.mappedJson
        // do somthing..
        let model = LoadingModel.deserialize(from: json, designatedPath: "data")
    } catch {
        block(error.localizedDescription)
    }
}

Plugins

This module is mainly based on moya package network related plugins.

• At present, 14 plugins have been packaged for you to use:
  • Header: Network HTTP Header Plugin.
  • Authentication: Interceptor plugin.
  • Debugging: Network printing, built in plugin.
  • GZip: Network data unzip plugin.
  • Shared: Network sharing plugin.
  • Files: Network downloading files And Uploading resources plugin.
  • Token: Token verify plugin.
  • Ignore: Ignore plugin, the purpose is to ignore a plugin in this network request.
  • CustomCache: Custom network data caching plugin.
  • Cache: Network data cache plugin.
  • Lottie: Animation loading plugin based on lottie.

For ios platform:

• Loading: Loading animation plugin.
• Warning: Network failure prompt plugin.
• Indicator: Indicator plugin.

If you want to use token plugin and auth plugin you can refer to the project use case.

• Auth: Authorization plugin.

🎷 Simple to use, implement the protocol method in the API protocol, and then add the plugin to it:

var plugins: APIPlugins {
    let cache = NetworkCachePlugin.init()
    let loading = NetworkLoadingPlugin.init()
    let warning = NetworkWarningPlugin.init()
    let shared = NetworkSharedPlugin.init()
    let gzip = NetworkGZipPlugin.init()
    return [loading, cache, warning, shared, gzip]
}

RxSwift

This module mainly supports responsive data binding.

func request(_ count: Int) -> Observable<[CacheModel]> {
    CacheAPI.cache(count).request()
        .deserialized(ApiResponse<[CacheModel]>.self)
        .compactMap { $0.data }
        .observe(on: MainScheduler.instance)
        .catchAndReturn([])
}

HollowCodable

HollowCodable is a codable customization using property wrappers library for Swift.

This module is serialize and deserialize the data, Replace HandyJSON.

🎷 Example of use in conjunction with the network part:

func request(_ count: Int) -> Observable<[LoadingModel]> {
    CodableAPI.cache(count)
        .request(callbackQueue: DispatchQueue(label: "request.codable"))
        .deserialized(ApiResponse<[LoadingModel]>.self)
        .compactMap({ $0.data })
        .observe(on: MainScheduler.instance)
        .catchAndReturn([])
}

RxSwift deserialized extension.

public extension Observable where Element: Any {
    
    @discardableResult func deserialized<T>(_ type: T.Type) -> Observable<T> where T: HollowCodable {
        return self.map { element -> T in
            return try T.deserialize(element: element)
        }
    }
    
    @discardableResult func deserialized<T>(_ type: [T].Type) -> Observable<[T]> where T: HollowCodable {
        return self.map { element -> [T] in
            return try [T].deserialize(element: element)
        }
    }
    
    @discardableResult func deserialized<T>(_ type: T.Type) -> Observable<ApiResponse<T.DataType>> where T: HasResponsable, T.DataType: HollowCodable {
        return self.map { element -> ApiResponse<T.DataType> in
            return try T.deserialize(element: element)
        }
    }
    
    @discardableResult func deserialized<T>(_ type: T.Type) -> Observable<ApiResponse<[T.DataType.Element]>> where T: HasResponsable, T.DataType: Collection, T.DataType.Element: HollowCodable {
        return self.map { element -> ApiResponse<[T.DataType.Element]> in
            return try T.deserialize(element: element)
        }
    }
}

HandyJSON

⚠️ Note: This module is not recommended because it has stopped maintenance.

This module is based on HandyJSON package network data parsing.

• Roughly divided into the following 3 parts:
  • HandyDataModel: Network outer data model.
  • HandyJSONError: Parse error related.
  • RxHandyJSON: HandyJSON data parsing, currently provides two parsing solutions.

🎷 Example of use in conjunction with the network part:

func request(_ count: Int) -> Driver<[CacheModel]> {
    CacheAPI.cache(count).request()
        .asObservable()
        .mapHandyJSON(HandyDataModel<[CacheModel]>.self)
        .compactMap { $0.data }
        .observe(on: MainScheduler.instance)
        .delay(.seconds(1), scheduler: MainScheduler.instance)
        .asDriver(onErrorJustReturn: [])
}

CocoaPods

CocoaPods is a dependency manager. For usage and installation instructions, visit their website. To integrate using CocoaPods, specify it in your Podfile:

pod 'Booming'

You should define your minimum deployment target explicitly, like:

platform :ios, '11.0'

If you want import cache plugin:

pod 'NetworkCachePlugin'

If you want import loading plugin:

pod 'NetworkHudsPlugin'

If you wang using Codable:

pod 'HollowCodable'

If responsive networking is required:

pod 'RxNetworks/RxSwift'

For other plugins and modules excluded, please read the podspec file.

Remarks

The general process is almost like this, the Demo is also written in great detail, you can check it out for yourself.🎷

BoomingDemo

Tip: If you find it helpful, please help me with a star. If you have any questions or needs, you can also issue.

Thanks.🎇

About the author

• 🎷 E-mail address: yangkj310@gmail.com 🎷
• 🎸 GitHub address: yangKJ 🎸

Buy me a coffee or support me on GitHub.

Alipay or WeChat. Thanks.

---

License

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

---