markdown-body entry-content container-lg" itemprop="text">

⚠️ QuantiBase is deprecated. Quanti does not build on 3rd party Rx libraries, but uses Combine / async-await instead.
Please use and further maintain Core instead. ⚠️

QuantiBase

Base-ios repository consists of useful extensions, general classes and protocols that we gather and use while working on our projects. The main goal is to create a central point of such snippets that can be reused across various projects. We constantly review and enrich the repository aiming to reach maximum reusability. We take full advantage of functional programming with reactive layer. For that purpose we use external libraries and thus QuantiBase will require following:

Overture (https://github.com/pointfreeco/swift-overture)
A library providing helpful generic functions that enhance functional programming approach.
RxSwift (https://github.com/ReactiveX/RxSwift)
A library providing reactive layer that enables to enhance reactive programming approach.
Action (https://github.com/RxSwiftCommunity/Action)
A library used with RxSwift to provide an abstraction on top of observables: actions.
RxDataSources (https://github.com/RxSwiftCommunity/RxDataSources)
A library used with RxSwift to provide reactive API for table and collection views.

Features

Services:
- AppLifecycleService: providing app lifecycle callbacks (such as “didFinishLaunchingNotification”) via reactive observables instead of using global notifications
- KeyboardService: providing keyboard callbacks (such as “keyboardWillShow”) via reactive observables instead of using global notifications
- ReachabilityService: providing reachability status (such as “ReachableViaWiFi”) via reactive observables
- BluetoothService: wrapper around CoreBluetooth’s CBPeripheralManager providing its callbacks via reactive observables
JSONParser: our own implementation of JSON parsing & serialization
HTTPNetworking: our own reactive implementation of REST network communication that fully supports our JSONParser
UserDefaultsStorable protocol: used to group models that support UserDefaults storing
ViewModelBindable protocol: used by classes and structs that bind viewModels (useful for MVVM architecture)
BinaryCodable protocol: used to group models that support Binary encoding & decoding
Queue: implementation of queue using array
TableModel class: used when creating table views aiming to encapsulate the data structure of the table (will be soon obsolete since it is mostly replaced by RxDataSources external library)
MultipleDelegating protocol: extending the highly used Delegate pattern that supports multiple delegates (will be soon obsolete since it is mostly replaces by reactive observables)
3rd party:
- LoremSwiftum: helpful class providing random strings of variable length
- Overture operators: operators on top of existing functions introduced in Overture library
  - |> for with
  - ^ for get and prop
  - <> for concat
  - >>> and <<< for pipe
  - >=> for chain
Useful subclasses of UIViewController & UIView
Binary extensions for basic data types
Other useful extensions for basic data types, reactive types and UIKit classes
Other

Installation

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate QuantiLogger into your Xcode project using Carthage, specify it in your Cartfile:

github "Qase/base-ios" ~> 0.0.2

Run carthage update to build the framework and drag the built QuantiBase.framework and its dependencies into your Xcode project.

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate QuantiLogger into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!

target '<Your Target Name>' do
  pod 'QuantiBase', '~> 0.0.2'
end

or for macOS

source 'https://github.com/CocoaPods/Specs.git'
platform :osx, '10.13'
use_frameworks!

target '<Your Target Name>' do
  pod 'QuantiBase', '~> 0.0.2'
end

Then, run the following command:

$ pod install

Swift Package Manager

The Swift Package Manager is a tool for managing the distribution of Swift code. The Package Manager is included in Swift 3.0 and above.

It doesn't support iOS, macOS, tvOS or watchOS projects. It only compiles for host platforms (macOS/linux). It is useful for commanline apps. To create a commandline app using SPM please read this great RayWenderlich article. In file Package.swift in the dependencies parameter add the following:

.package(url: "https://github.com/Qase/Base-ios", from: "0.0.2)

so it should look something like this:

let package = Package(
    name: "YOUR_APP_NAME",
    dependencies: [
        .package(url: "https://github.com/Qase/Base-ios", from: "0.0.2"),
    ]
)

then run $ swift build and $ swift package generate-xcodeproj

For updating use $ swift package update

Future development

Code base is still under active development and it is going to grow steadily. You can send requests for other usefull snippets, that can be integrated into library.

License

MIT

License

Qase/Base-ios

ErrorLooks like something went wrong!

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors 6

Uh oh!

Languages

Error
Looks like something went wrong!

Packages