Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/qase/base-ios
[DEPRECATED] Set of useful pieces of code that can be re-used in any project written in Swift.
https://github.com/qase/base-ios
ios ios-library ios-swift qase reactiveswift swift swift4 util utility utils
Last synced: 4 months ago
JSON representation
[DEPRECATED] Set of useful pieces of code that can be re-used in any project written in Swift.
- Host: GitHub
- URL: https://github.com/qase/base-ios
- Owner: Qase
- License: mit
- Archived: true
- Created: 2018-07-25T13:34:20.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-11-17T12:09:33.000Z (about 3 years ago)
- Last Synced: 2024-09-29T11:40:22.824Z (4 months ago)
- Topics: ios, ios-library, ios-swift, qase, reactiveswift, swift, swift4, util, utility, utils
- Language: Swift
- Homepage:
- Size: 497 MB
- Stars: 3
- Watchers: 5
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/Qase/base-ios)
[](https://codebeat.co/projects/github-com-qase-base-ios-master)
[](https://github.com/Carthage/Carthage)
[](https://cocoapods.org)
[](https://opensource.org/licenses/MIT)
[](mailto:[email protected])
[](https://github.com/Qase/base-ios)
**⚠️ QuantiBase is deprecated. Quanti does not build on 3rd party Rx libraries, but uses Combine / async-await instead.\
Please use and further maintain [Core](https://github.com/Qase/swift-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](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. You can install Carthage with [Homebrew](https://brew.sh) 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](https://cocoapods.org) 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 '' do
pod 'QuantiBase', '~> 0.0.2'
end
```
or for macOS
```
source 'https://github.com/CocoaPods/Specs.git'
platform :osx, '10.13'
use_frameworks!
target '' do
pod 'QuantiBase', '~> 0.0.2'
end
```
Then, run the following command:
```
$ pod install
```
### Swift Package Manager
The [Swift Package Manager](https://swift.org/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](https://www.raywenderlich.com/750-an-introduction-to-the-swift-package-manager).
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](https://github.com/nishanths/license/blob/master/LICENSE)