Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/damonthecricket/my-utils
Simple Cocoa Swift library.
https://github.com/damonthecricket/my-utils
apple code framework ios iphone ipod library macos osx swift swift-3 swift-4 tvos watchos
Last synced: about 1 month ago
JSON representation
Simple Cocoa Swift library.
- Host: GitHub
- URL: https://github.com/damonthecricket/my-utils
- Owner: damonthecricket
- License: mit
- Created: 2017-05-03T16:13:34.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-08-30T16:30:39.000Z (over 6 years ago)
- Last Synced: 2024-11-11T09:50:07.645Z (about 1 month ago)
- Topics: apple, code, framework, ios, iphone, ipod, library, macos, osx, swift, swift-3, swift-4, tvos, watchos
- Language: Swift
- Homepage:
- Size: 3.26 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# MYUtils.
[![Version](https://img.shields.io/github/release/damonthecricket/my-utils.svg)](https://github.com/damonthecricket/my-utils/releases)
[![Travis CI](https://travis-ci.org/damonthecricket/my-utils.svg?branch=master)](https://travis-ci.org/damonthecricket/my-utils)
![CocoaPods](https://img.shields.io/cocoapods/v/MYUtils.svg)
[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)
[![GitHub license](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://raw.githubusercontent.com/damonthecricket/my-utils/master/LICENSE)
![Platform](https://img.shields.io/badge/platforms-iOS%208.0+%20%7C%20macOS%2010.10+%20%7C%20tvOS%209.0+%20%7C%20watchOS%202.0+-333333.svg)![MYJSON](https://github.com/damonthecricket/my-utils/blob/README/my-utils-lib.jpg)
MYUtils is a simple Swift library, that extends Cocoa frameworks.
1. [Features](#features)
2. [Installation](#installation)
3. [Requirements](#requirements)
4. [Usage](#usage)### Features.
1. [UI](#ui)
- Classes
- Storyboard Segues
- Extensions
- CoreGraphics
- Image
- View
- ViewController
2. [Foundation](#foundation)
- Classes
- Cache
- Result
- Extensions
- Array
- Dictionary
- Double
- Float
- Int
- NotificationCenter
- NSNumber
- OperationQueue
- String
- Timer
- UserDefaults### Installation.
- #### [CocoaPods](http://cocoapods.org/)```ruby
use_frameworks!
pod 'MYUtils'
```- #### [Carthage](https://github.com/Carthage/Carthage)
```
github "damonthecricket/my-utils"
```- #### [Git](https://git-scm.com/)
```
$ git submodule add https://github.com/damonthecricket/my-utils.git
```
- #### Manually- Copy MYUtils to the root of your project.
- Add it in file inspector of your project.
- Go to Targets -> Add MYUtils to Embedded Binaries.### Requirements.
- iOS 8.0+ | macOS 10.10+ | tvOS 9.0+ | watchOS 2.0+.
- Xcode 8.3
- Swift 3.### Usage.
#### UI:
##### - Classes:
- ```DismissStoryboardSegue``` is intended to dismiss ViewController using Storyboard, not programmatically. All we need
is control-click an appropriate element in the first ViewController and drag to the target ViewController (or to itself)
that was presented via ``` func present(UIViewController, animated: Bool, completion: (() -> Void)? = nil) ``` method.
Then make storyboard segue kind custom and assign ```DismissStoryboardSegue``` to its class in appropriate text field.
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+.
- ```ShowStoryboardSegue``` is intended to add ViewController as a child ViewController using Storyboard. All we need is
control-click an appropriate element in the first ViewController and drag to the target ViewController. Then make
storyboard segue kind custom and assign ```ShowStoryboardSegue``` to its class in appropriate text field.
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+.
- ```HideStoryboardSegue``` is intended to remove ViewController from its parent ViewController using Storyboard. All we
need is control-click an appropriate element in the first ViewController and drag to the target ViewController. Then
make storyboard segue kind custom and assign ```HideStoryboardSegue``` to its class in appropriate text field.
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+.
- ```PopStoryboardSegue``` is intended to pop ViewController from its UINavigationController stack using Storyboard.
All we need is control-click an appropriate element in the source ViewController and drag to itsel. Then make storyboard
segue kind custom and assign ```PopStoryboardSegue``` to its class in appropriate text field.
Available in iOS 8.0+ | tvOS 9.0+.
##### - Extensions:
```CGRect``` extensions provides easy way to perform arithmetic operations on the ```CGRect, CGPoint, CGSize```
structures.
```swift
let firstRect = CGRect(x: 10.0, y: 0.0, width: 100.0, height: 100.0)
let secondRect = CGRect(x: 10.0, y: 100.0, width: 200.0, height: 10.0)
let sumResultRect = firstRect + secondRect
let minusResultRect = firstRect - secondRect
let multiplicationResultRect = firstRect * secondRect
let divisionResultRect = firstRect / secodeRect
// sumResultRect will be equal to x: 20.0 y: 100.0 width: 300.0 height: 110.0 rect.
// minusResultRect will be equal to x: 0.0 y: -100.0 width: -100.0 height: 90.0 rect.
// multiplicationResultRect will be equal to x: 100.0 y: 0.0 width: 20 000.0 height: 1 000.0 rect.
// divisionResultRect will be equal to x: 1.0 y: 0.0 width: 0.5 height: 10.0 rect.
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+ | watchOS 2.0+.```CGFloat``` extensions includes opportunities to generate random numbers.
```swift
let randomNumberInRange = CGFloat.random(min: 0.0, max: 10.0)
let random = CGFloat.random
let randomSign = CGFloat.randomSign
// randomNumberInRange will be equal to number in range between 0.0 and 10.0 inclusive.
// random will be equal to number in range between 0.0 and 1.0 inclusive.
// randomSign will be equal to number 1.0 or -1.0.
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+ | watchOS 2.0+.
```Image``` extensions provides next opportunites:
- Identify image orientation:
```swift
let image =
switch image.orientation {
case .portret:
// When image has portret orientation.
case .album:
// When image has album orientation.
case .square:
// When image has square form.
}
// Or use follow.
if image.isPortret {
// When image has portret orientation.
} else if image.isAlbum {
// When image has album orientation.
} else if image.isSquare {
// When image has square form.
}
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+ | watchOS 2.0+.- Load image from rest resource:
```swift
let url =
UIImage.from(URL: url) {image in
// In case of success this method loads / returns cached and provides in closure an image.
// Oterwise, an image equals to `nil`.
}
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+ | watchOS 2.0+.- Draw image:
```swift
let size =
let image = MYImageDraw(size: size) {ctx in
ctx.setFillColor(color.cgColor)
}
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+ | watchOS 2.0+.
- Image cache:
```MYImage.cache``` is used by ```MYImage.imageFrom(URL url: URL, completion: MYImageDownloadCompletion? = nil)``` and
```MYImageView.imageFrom(URL url: URL, completion: MYImageDownloadCompletion? = nil)``` methods to cache downloaded
images.
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+ | watchOS 2.0+.
```ImageView``` extensions provides next opportunities:
```swift
let url =
let imageView =
imageView.imageFrom(URL: url) {image
// In case of success this method loads or returns cached, sets to reciever and provides in closure an image.
// Oterwise, image equals to nil.
}
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+ | watchOS 2.0+.
```CollectionView``` extensions provides next opportunity:
- Adjusting of number of columns:
```swift
let collectionView =
collectionView.numberOfCellsPerRow = 3 // CollectionView will layout three collection view cells in each row.
```
Available in iOS 8.0+ | macOS 10.11+ | tvOS 9.0+.
```ScrollView``` extensions provodes next opportunites:
- Identify current scroll content position:
```swift
let scrollView =
switch scrollView.position {
case .top:
// When scroll content position on top.
case .right:
// When scroll content position on right.
case .bottom:
// When scroll content position on bottom.
case .left:
// When scroll content position on left.
case .center:
// When scroll content position on center.
}
// Or you can use next methods.
if scrollView.onTop {
// When scroll content position on center.
} else if scrollView.onRight {
// When scroll content position on right.
} else if scrollView.onBottom {
// When scroll content position on bottom.
} else if scrollView.onLeft {
// When scroll content position on left.
} else if scrollView.onCenter {
// When scroll content position on center.
}
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+ | watchOS 2.0+.
- Get content offset for macOS 10.11+:
```swift
let scrollView =
let contentOffset = scrollView.contentOffset
```
Available in macOS 10.11+.- Identify current scroll direction:
```swift
let scrollView =
switch scrollView.direction {
case .vertical:
// When scroll direction is vertical.
case .horizontal:
// When scroll direction is horizontal.
}
// Or you can use next methods.
if scrollView.isVertical {
// When scroll direction is vertical.
} else if scrollView.isHorizontal {
// When scroll direction is horizontal.
}
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+.
- Get actual scroll view content size:
```swift
let scrollView =
let contentSize = scrollView.contentSize
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+.
```UIActivityViewController``` extensions provides next opportunities:
- Easy way to initialize ```UIActivityViewController```:
```swift
let string =
let url =
let activityViewController = UIActivityViewController(activityItems: [string, url], applicationActivities: nil) {
activityType, completed, returnedItems, activityError in
// Completion code.
}
```
Available in iOS 8.0+.
```UIAlertController``` extensions provides next opportunities:
- Easy way to present ```UIAlertController```:
```swift
let title =
let message =
let actions =
let style =
let vc =
UIAlertShow(title, message, actions, style, vc) // vc presents UIAlertController with specified attributes.
```
Available in iOS 8.0+.- Easy way to make ```UIAlertAction```:
```swift
let action = UIAlertActionMake(title: "Ok", .default) {action in
// Completion code.
}
let cancelAction = UIAlertActionMakeCancel(title: "Cancel", .cancel) {action in
// Completion code.
}
let defaultAction = UIAlertActionMake(title: "Done") {action in
// Completion code.
}
```
Available in iOS 8.0+ | tvOS 9.0+.
```UINavigationController``` extensions provides next opportunities: [#ui_view_cotroller_extensions]
- Get root view controller:
```swift
let navigatioController =
let rootViewController = navigationController.rootViewController
```
Available in iOS 8.0+ | tvOS 9.0+.```ViewController``` extensions provides next opportunities:
- Get current child view controller:
```swift
let viewController =
let currentChildViewController = viewController.currentViewController
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+.
- Get previous child view controller:
```swift
let viewController =
let currentChildViewController = viewController.previousViewController
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+.
- Add view controller:
```swift
let parentViewController =
let childViewController =
parentViewController.addChild(viewController: childViewController) {
childViewController.view.frame = CGRect(x: 0.0, y: 10.0, width: 100.0, height: 200.0)
}
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+.
- Remove all child view controllers:
```swift
let parentViewCotroller =
let parentViewCotroller.removeChildViewControllers()
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+.
- Remove child view controller:
```swift
let parentViewController =
let childViewController =
parentViewController.removeChild(viewController: childViewController) {
}
// Or.
childViewController.removeFromSuperViewController()
```
Available in iOS 8.0+ | macOS 10.10+ | tvOS 9.0+.#### Foundation:
##### - Classes:
- ```Cache``` is convenience wrapper of stanard Foundation ```NSCache``` class. ```Cache``` corresponds easy way to access
to cached value through subscript:
```swift
let cache =
let value = cache["key"]
```
Or we can cache the value using same subscript:
```swift
let cache =
let anyObjectValue =
cache["key"] = anyObjectValue as! AnyObject
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.
- ```Result``` is the two value enum, intended to emulate two posible values to any operation - ```success``` or
```failure``` case:
```swift
let result = .success()
switch result {
case .success(let ):
// Code to handle success case.
case .failure(_):
}
```
Or failure ```case```:
```swift
let result = .failure()
switch result {
case .success(_):
case .failure(let error):
// Code to handle failure case.
}
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.##### - Extensions:
```Array``` extensions provides next opportunites:
- Easy way to concatenate two arrays using ```+``` or ```+=``` operations:
```swift
let firstArray =
let secondArray =
let thirdArray = firstArray + secondArray
var fourthArray =
fourthArray += thirdArray
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.- Make an array containing the results of mapping the given closure over the sequence’s elements:
```swift
let firstArray = [1, 2, 3]
let secondArray = firstArray.make {idx, firstArrayElement in
return firstArrayElement*2
}
// secondArray == [2, 4, 6]
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.
- Iterate through all elements in an array:
```swift
let array = [1, 2, 3]
array.enumerate {idx, element in
// idx is index of element in an array
// element of an array
}
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.- Remove specified element:
```swift
var array = [1, 2, 3]
array.remove(element: 2)
// array == [1, 3]
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.```Dictionary``` extensions provides next opportunites:
- Compare two dictionaries:
```swift
let firstDictionary = ["key": "value"]
let secondDictionary = ["key": "value"]
if firstDictionary == secondDictionary {
// True
}
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.- Easy way to concatenate two dictionaries using ```+``` or ```+=``` operations:
```swift
let firstDictionary = ["key1": "value1"]
let secondDictionary = ["key2": "value2"]
let thirdDictionary = firstDictionary + secondDictionary
// thirdDictionary == ["key1": "value1", "key2": "value2"]
var fourthDictionary = ["key3": "value3"]
fourthDictionary += thirdDictionary
// fourthDictionary == ["key1": "value1", "key2": "value2", "key3": "value3"]
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.
- Make a dictionary containing the results of mapping the given closure over the sequence’s elements:
```swift
let firstDictionary = ["key1": "value1"]
let resultDictionary = firstDictionary.make {key, value in
retrun ["result_key": value]
}
// resultDictionary == ["result_key": "value1"]
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.- Iterate through all elements in a dictionary:
```swift
let dictionary = ["key1": "value1"]
dictionary.enumerate {key, value in
// key == "key1"
// value == "value1"
}
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.
- Get all keys and values of a dictionary:
```swift
let dictionary = ["key1": "value1", "key2": "value2"]
let keys = dictionary.keys
let values = dictionary.values
// keys == ["key1", "key2"]
// values == ["value1", "value2"]
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.```Double``` extensions provides opportunity to generate random double numbers:
```swift
let randomNumberInRange = Double.random(min: 0.0, max: 10.0)
let random = Double.random
let randomSign = Double.randomSign
// randomNumberInRange will be equal to number in range between 0.0 and 10.0 inclusive.
// random will be equal to number in range between 0.0 and 1.0 inclusive.
// randomSign will be equal to number 1.0 or -1.0.
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.```Float``` extensions provides opportunity to generate random float numbers:
```swift
let randomNumberInRange = Float.random(min: 0.0, max: 10.0)
let random = Float.random
let randomSign = Float.randomSign
// randomNumberInRange will be equal to number in range between 0.0 and 10.0 inclusive.
// random will be equal to number in range between 0.0 and 1.0 inclusive.
// randomSign will be equal to number 1.0 or -1.0.
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.```Int``` extensions provides opportunity to generate random int numbers:
```swift
let randomNumberInRange = Float.random(min: 0.0, max: 10.0)
let random = Float.random
let randomSign = Float.randomSign
// randomNumberInRange will be equal to number in range between 0.0 and 10.0 inclusive.
// random will be equal to number in range between 0.0 and 1.0 inclusive.
// randomSign will be equal to number 1.0 or -1.0.
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.```NotificationCenter``` extensions provides opportunity to add an entry to the receiver’s dispatch table with a block
to add to the current queue:
```swift
let token = NotificationCenter.default.addObserver(forName: NotificationName) {notification -> Void in
// Performs on the current queue. When specified notification performs.
}
NotificationCenter.default.removeObserver(token)
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.
```NSNumber``` extensions provides opportunity to check, whether stored value is bool or not:
```swift
let number = NSNumber(value: true)
if number.isBool {
// true
}
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.
```OperationQueue``` extensions provides next opportunities:
- Convenience way to perform code synchronously / asynchronous on the main queue:
```swift
PerformOnMainThreadSync {
// Code to perform synchronously on the main queue.
}
PerformOnMainThreadAsync {
// Code to perform asynchronous on the main queue.
}
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.- Convenience way to perform code synchronously / asynchronous on the background queue:
```swift
PerformOnBackgroundThreadSync {
// Code to perform synchronously on the background queue.
}
PerformOnBackgroundThreadAsync {
// Code to perform asynchronous on the background queue.
}
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.
```String``` extensions provides next opportunities:
- Convenience way to convert string object to ```Int```, ```UInt``` or ```NSString```:
```swift
let intString = "-10"
let intValue = intString.int!
// intValue == -10
let uintString = "123"
let uintValue = uintString.uint
// uintValue == 123
let string = "qwerty"
let nsstring = string.ns_string
// nsstring.isEqual(to: "qwerty")
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.
- Generate random string:
```swift
let randomStringWithStandardAlphabet = String.random(wihtLength: 7)
// randomStringWithStandardAlphabet.characters.count == 7
// randomStringWithStandardAlphabet contains characters only from
// "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789" string
let randomStringWithSpecifiedAlphabet = String.random(wihtLength: 10, fromLetters: "123456789")
// randomStringWithSpecifiedAlphabet.characters.count == 10
// randomStringWithSpecifiedAlphabet contains characters only from "123456789"
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.
- Convenience way to get string length:
```swift
let string = "qwerty"
let length = string.length
// length == 6
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.- Convenience way to get url encode / decode string:
```swift
let string = "Lorem ipsum dolor sit amet, "
let urlEncodedString = string.URLEncodedString
// urlEncodedString == "Lorem%20ipsum%20dolor%20sit%20amet,%20"
let urlDecodedString = urlEncodedString.URLDecodedString
// urlDecodedString == "Lorem ipsum dolor sit amet, "
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.
```Timer``` extensions provides next opportunities:
- Convenience way to schedule timer:
```swift
_ = Timer.schedule(delay: 5.0) {timer in
// Performs only once after 5.0 seconds delay
}
_ = Timer.schedule(repeatInterval: 2.0) {timer in
// Performs every 2.0 seconds.
}
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.
```UserDefaults``` provides next opportunities:
- Store NSCoding objects:
```swift
let object =
UserDefaults.standard.set(object, forKey: "key")
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.
- Sets / returns the value using subscript:
```swift
let value = "value"
UserDefaults.standard["key"] = value
let storedValue = UserDefaults.standard["key"]
// value == storedValue
```
Available in iOS 8.0+ | macOS 10.10+ | watchOS 2.0+ | tvOS 9.0+.