All the reusable code that we need in each project
SwiftyUtils groups all the reusable code that we need to ship in each project. This framework contains: - Extensions - Protocols - Structs - Subclasses
Working on iOS, macOS, tvOS, and watchOS, everything has been made to be easy to use! :tada:
Check out the repository to find examples / tests for each feature.
Swift, Foundation and CoreGraphics extensions:
SwiftUI:
SwiftUI Extension:
UIKit Extensions:
UIKit Protocols:
AppKit Extensions:
Protocols:
PropertyWrappers:
Others:
Safely access to an element:
var array = [1, 2, 3] print(array[safe: 0]) // Optional(1) print(array[safe: 10]) // nil
Find all the index of an object:
var array = [1, 2, 3, 1] print(array.indexes(of: 1)) // [0,3]
Get index of first / last occurrence of an object:
var array = [1, 2, 3, 1] print(array.firstIndex(of: 1)) // Optional(0) print(array.lastIndex(of: 1)) // Optional(3)
Remove an object:
var array = [1, 2, 3] myArray.remove(object: 2) print(myArray) // [1, 3] myArray.remove(objects: [1, 3]) print(myArray) // []
Remove all the duplicates:
var array = [0, 0, 1, 1, 2] array.removeDuplicates() print(array) // [0,1,2]let array = [0, 0, 1, 1, 2] let newArray.removedDuplicates() print(newArray) // [0,1,2]
Remove all instances of an item:
var array = [0, 0, 1, 1, 2] array.removeAll(0) print(array) // [1,1,2]let array = [0, 0, 1, 1, 2] let newArray = array.removedAll(0) print(newArray) // [1,1,2]
Check if an array is a subset of another array:
var array = [1, 2, 3] print(array.contains([1, 2])) // true print(array.contains([5])) // false
Determine if an array contains an object:
var array = [1, 2, 3] print(array.contains(1)) // true print(array.contains(11)) // false
Get intersection and union of two arrays:
var myArray = [1, 2, 3] print(array.intersection(for: [1, 5, 3])) // [1, 3] print(array.union(values: [5, 6])) // [1, 2, 3, 5, 6]
Get difference between two arrays:
var array = [1, 2, 3] print(array.difference(with: [1])) // [2, 3]
Split into chunk of a specific size:
var array = [1, 2, 3, 4] print(array.split(intoChunksOf: 2)) // [[1, 2], [3, 4]]
Get bundle information:
Bundle.main.appName Bundle(url: url)?.appNameBundle.main.displayName Bundle(url: url)?.displayName
Bundle.main.appVersion Bundle(url: url)?.appVersion
Bundle.main.appBuild Bundle(url: url)?.appBuild
Bundle.main.bundleId Bundle(url: url)?.bundleId
Bundle.main.schemes Bundle(url: url)?.schemes
Bundle.main.mainScheme Bundle(url: url)?.mainScheme
Bundle.main.isInTestFlight Bundle(url: url)?.isInTestFlight
Create a CGFloat from a Float or an Integer:
let imageViewTop = 15.f
Add two
CGPoint:
var point1 = CGPoint(x: 10, y: 10) let point2 = CGPoint(x: 10, y: 10) print(point1 + point2) // CGPoint(x: 20, y: 20)point1 += point2 print(point1) // CGPoint(x: 20, y: 20)
Substract two
CGPoint:
var point1 = CGPoint(x: 10, y: 10) let point2 = CGPoint(x: 10, y: 10) print(point1 - point2) // CGPoint(x: 0, y: 0)point1 -= point2 print(point1) // CGPoint(x: 0, y: 0)
Multiply a
CGPointwith a scalar:
var point1 = CGPoint(x: 10, y: 10) print(point1 * 2) // CGPoint(x: 20, y: 20)point1 *= 2 print(point1) // CGPoint(x: 20, y: 20)
Get the origin's x and y coordinates:
aRect.x // instead of aRect.origin.x aRect.y // instead of aRect.origin.y
Change one property of a
CGRect:
let rect = CGRect(x: 10, y: 20, width: 30, height: 40) let widerRect = rect.with(width: 100) // x: 10, y: 20, width: 100, height: 40 let tallerRect = rect.with(height: 100) // x: 10, y: 20, width: 30, height: 100 let rectAtAnotherPosition = rect.with(x: 100).with(y: 200) // x: 100, y: 200, width: 30, height: 40 let rectWithAnotherSize = rect.with(size: CGSize(width: 200, height: 200)) // x: 10, y: 20, width: 200, height: 200 let rectAtYetAnotherPosition = rect.with(origin: CGPoint(x: 100, y: 100)) // x: 100, y: 100, width: 30, height: 40
Add two
CGSize:
var size1 = CGSize(width: 10, height: 10) let size2 = CGSize(width: 10, height: 10) print(size1 + size2) // CGSize(width: 20, height: 20)size1 += size2 print(size1) // CGSize(width: 20, height: 20)
Substract two
CGSize:
var size1 = CGSize(width: 10, height: 10) let size2 = CGSize(width: 10, height: 10) print(size1 - size2) // CGSize(width: 0, height: 0)size1 -= size2 print(size1) // CGSize(width: 0, height: 0)
Multiply a
CGSizewith a scalar:
var size1 = CGSize(x: 10, y: 10) print(size1 * 2) // CGSize(width: 20, height: 20)size1 *= 2 print(size1) // CGSize(width: 20, height: 20)
Create colors with HEX values:
let myUIColor = UIColor(hex: "233C64") // Equals 35,60,100,1 let myNSColor = NSColor(hex: "233C64") // Equals 35,60,100,1
Access to individual color value:
let myColor = UIColor(red: 120, green: 205, blue: 44, alpha: 0.3) print(myColor.redComponent) // 120 print(myColor.greenComponent) // 205 print(myColor.blueComponent) // 44 print(myColor.alpha) // 0.3
Get lighter or darker variants of colors instances:
let color = UIColor(red: 0.5, green: 0.5, blue: 1.0, alpha: 1.0) let lighter = color.lighter(amount: 0.5) let darker = color.darker(amount: 0.5) // OR let lighter = color.lighter() let darker = color.darker()let color = NSColor(red: 0.5, green: 0.5, blue: 1.0, alpha: 1.0) let lighter = color.lighter(amount: 0.5) let lighter = color.lighter() // OR let darker = color.darker(amount: 0.5) let darker = color.darker()
Initialize from hex string:
let hexString = "6261736520313020697320736F2062617369632E206261736520313620697320776865726520697427732061742C20796F2E" let data = Data(hexString: hexString)
Get hex string from data:
let data = Data(...) let string = data.toHexString() // string = "6261736520313020697320736F2062617369632E206261736520313620697320776865726520697427732061742C20796F2E" if using previous example value
Get UInt8 Array from data:
let data = Data(...) let array = data.bytesArray
Map Data to Dictionary:
let dictionary = try data.toDictionary()
Initialize from string:
let format = "yyyy/MM/dd" let string = "2015/03/11" print(Date(fromString: string, format: format)) // Optional("2015/03/11 00:00:00 +0000")
Convert date to string:
let now = Date() print(now.string()) print(now.string(dateStyle: .medium, timeStyle: .medium)) print(now.string(format: "yyyy/MM/dd HH:mm:ss"))
See how much time passed:
let now = Date() let later = Date(timeIntervalSinceNow: -100000) print(later.days(since: now)) // 1.15740740782409 print(later.hours(since: now)) // 27.7777777733571 print(later.minutes(since: now)) // 1666.66666641732 print(later.seconds(since: now)) // 99999.999984026
Check if a date is in future or past:
let later = Date(timeIntervalSinceNow: -100000) print(now.isInFuture) // true print(now.isInPast) // false
Check if a key exists in the dictionary:
let dic = ["one": 1, "two": 2] print(dic.has(key: "one")) // True print(dic.has(key: "1")) // False
Map Dictionary to Data:
let data = try dictionary.toData()
Easily get union of two dictionaries:
let dic1 = ["one": 1, "two": 2] let dic2 = ["one": 1, "four": 4]let dic3 = dic1.union(values: dic2) print(dic3) // ["one": 1, "two": 2, "four": 4]
mapa dictionary:
let dic = ["a": 1, "b": 2, "c": 3] let result = dic.map { key, value in return (key.uppercased(), "\(value * 2)") } print(dic) // ["A": "2, "B": "4", "C": "6"]
flatMapa dictionary:
let dic = ["a": 1, "b": 2, "c": 3] let result = dic.flatMap { key, value -> (String, String)? in if value % 2 == 0 { return nil } return (key.uppercased(), "\(value * 2)") } print(dic) // ["A": "2, "C": "6"]
Get difference of two dictionaries:
let dic1 = ["one": 1, "two": 2] let dic2 = ["one": 1, "four": 4] difference(with: dic1, dic2) // ["two": 2, "four": 4]
Merge several dictionaries:
let dic1 = ["one": 1, "two": 2] let dic2 = ["three": 3, "four": 4] var finalDic = [String: Int]() finalDic.merge(with: dic1, dic2) print(finalDic) // ["one": 1, "two": 2, "three": 3, "four": 4]
Get the time interval for a number of milliseconds, seconds, hour, or days:
print(1.second) // 1 print(1.minute) // 60 print(1.hour) // 3600 print(1.2.seconds) // 1.2 print(1.5.minutes) // 90.0 print(1.5.hours) // 5400.0 print(1.3.milliseconds) // 0.0013 print(0.5.day) // 43200 print(1.day) // 86400 print(2.day) // 172800
Formatted value with the locale currency:
print(Double(3.24).formattedPrice) // "$3.24" print(Double(10).formattedPrice) // "$10.00"
Get documents directory url following the os:
FileManager.document // OR FileManager.default.document
Create a new directory:
FileManager.createDirectory(at: directoryUrl) // OR FileManager.default.createDirectory(at: directoryUrl)
Delete contents of temporary directory
FileManager.removeTemporaryFiles() // OR FileManager.default.removeTemporaryFiles()
Delete contents of documents directory
FileManager.removeDocumentFiles() // OR FileManager.default.removeDocumentFiles()
var myNumber = -33 print(myNumber.isEven) // false print(myNumber.isOdd) // true print(myNumber.isPositive) // false print(myNumber.isNegative) // true print(myNumber.digits) // 2
Round to the nearest / nearest down / nearest up:
var value = 17572 print(value.nearestDozens) // 17570 print(value.nearestHundreds) // 17600 print(value.nearestThousands) // 18000 print(value.nearest(to: 1000) // 18000value = 17578 print(value.nearestBelowDozens) // 17570 print(value.nearestBelowHundreds) // 17500 print(value.nearestBelowThousands) // 17000 print(value.nearestBelow(to: 1000) // 17000
value = 17442 print(value.nearestUpDozens) // 17450 print(value.nearestUpHundreds) // 17500) print(value.nearestUpThousands) // 18000 print(value.nearestUp(to: 1000) // 18000
Formatted value with the locale currency:
print(10.formattedPrice) // "$10.00"
Sorts the mutable collection in place using
KeyPath:
var articles = [Article(title: "B"), Article(title: "C"), Article(title: "A")] articles.sort(by: \.title) // [A, B, C] articles.sort(by: \.title, order: >) // [C, B, A]
Post a notification from a specific queue:
NotificationCenter.default.postNotification("aNotification", queue: DispatchQueue.main) NotificationCenter.default.postNotification("aNotification", object: aObject queue: DispatchQueue.main) NotificationCenter.default.postNotification("aNotification", object: aObject userInfo: userInfo queue: DispatchQueue.main)
Check if an attribute is applied on the desired substring:
let text = "Hello" let attrString = NSMutableAttributedString(text: "Hello world") attrString = attrString.underlined(occurences: text) attrString.isAttributeActivated(.underlineStyle, appliedOn: text, value: 1) // true
No available for watchOS
Apply a multiplier to a constraint (currently working only for width and height):
let view = UIView(CGRect(x: 0, y: 0, width: 100, height: 200)) let constraint = NSLayoutConstraint(item: view, attribute: .width, ...) constraint.apply(multiplier: 0.5, toView: superview) print(constraint.constants) // 50let constraint = NSLayoutConstraint(item: view, attribute: .height, ...) constraint.apply(multiplier0.5, toView: superview) print(constraint.constants) // 100
Colorize each occurence:
let attrStr: NSMutableAttributedString = NSMutableAttributedString.colored(inText: "hello world", color: .yellow, occurences: "llo")// OR
let attrStr: NSMutableAttributedString = NSMutableAttributedString(string: "Hello world") attrStr.color(.yellow, occurences: "llo")
Colorize everything after an occurence:
let attrStr = NSMutableAttributedString.colored(inText: "Hello world", color: .yellow, afterOcurrence: "llo")// OR
let attrStr = NSMutableAttributedString(string: "Hello world") attrStr.color(.yellow, afterOcurrence: "llo")
Strike each occurence:
let attrStr: NSMutableAttributedString = NSMutableAttributedString.struck(inText: "Hello world", occurences: "llo")// OR
let attrStr = NSMutableAttributedString(string: "Hello world") attrStr.strike(occurences: "llo")
Strike everything after an occurence:
let attrStr: NSMutableAttributedString = NSMutableAttributedString.struck(inText: "Hello world", afterOcurrence: "llo")// OR
let attrStr = NSMutableAttributedString(string: "Hello world") attrStr.strike(ocurrences: "llo")
Underline each occurence:
let attrStr: NSMutableAttributedString = NSMutableAttributedString.underlined(inText: "Hello world", occurences: "llo")// OR
let attrStr = NSMutableAttributedString(string: "Hello world") attrStr.underline(occurences: "llo")
Underline everything after an occurence:
let attrStr: NSMutableAttributedString = NSMutableAttributedString.underlined(inText: "Hello world", afterOcurrence: "llo")// OR
let attrStr = NSMutableAttributedString(string: "Hello world") attrStr.underline(afterOcurrence: "llo")
Use custom font for each occurence:
let font = UIFont.boldSystemFont(ofSize: 15) let attrStr: NSMutableAttributedString = NSMutableAttributedString.font(inText: "hello world", font: font, occurences: "llo")// OR
let attrStr: NSMutableAttributedString = NSMutableAttributedString(string: "Hello world") attrStr.font(font, occurences: "llo")
Custom font for everything after an occurence:
let font = UIFont.boldSystemFont(ofSize: 15) let attrStr = NSMutableAttributedString.colored(inText: "Hello world", font: font, afterOcurrence: "llo")// OR
let attrStr = NSMutableAttributedString(string: "Hello world") attrStr.font(font, afterOcurrence: "llo")
Get the class name of a
NSObject:
#if !os(macOS) let vc = NSViewController() print(vc.className) // NSViewController #else let vc = UIViewController() print(vc.className) // UIViewController print(UIViewController.className) // UIViewController #endif
Range after an occurence:
let string = "Hello world" let range = NSRange(text: string, afterOccurence: "llo") print(range) // location: 3, length: 8
Range of string:
let string = "Hello world" let stringToFind = "ello wo" let range = NSRange(textToFind: stringToFind, in: string) print(range) // location: 1, length: 7
Reuse your formatter to avoid heavy allocation:
SUDateFormatter.shared SUNumberFormatter.shared SUByteCountFormatter.shared SUDateComponentsFormatter.shared SUDateIntervalFormatter.shared SUEnergyFormatter.shared SUMassFormatter.shared
Sort a sequence using
keyPath:
let articles = [Article(title: "B"), Article(title: "C"), Article(title: "A")] var sortedArticles = articles.sorted(by: \.title) // [A, B, C] sortedArticles = articles.sorted(by: \.title, order: >) // [C, B, A]
Access with subscript:
var string = "hello world" print(string[0]) // h print(string[2]) // l print(string[1...3]) // ell
Check if it contains a string:
let string = "Hello world" print (string.contains(text: "hello")) // true print (string.contains(text: "hellooooo")) // false
Check if it's a number:
var string = "4242" print(string.isNumber) // truevar string = "test" print(string.isNumber) // false
Check if it's a valid email:
var string = "[email protected]" print(string.isEmail) // true var string = "[email protected]" print(string.isEmail) // false
Check if it's a valid IP address:
let ip4 = "1.2.3.4" let ip6 = "fc00::" let notIPAtAll = "i'll bribe you to say i'm an ip address!"ip4.isIP4Address //true ip4.isIP6Address //false ip4.isIPAddress //true
ip6.isIP4Address //false ip6.isIP6Address //true ip6.isIPAddress //true
notIPAtAll.isIP4Address //false notIPAtAll.isIP6Address //false notIPAtAll.isIPAddress //false
Uncamelize a string:
var camelString = "isCamelled" print(camelString.uncamelize) // is_camelled
Capitalize the first letter:
var string = "hello world" string = string.capitalizedFirst print(string)// Hello world
Trimmed spaces and new lines:
var string = " I' am a test \n " print(string.trimmed()) // I'am a test
Truncated to have a limit of characters:
var string = "0123456789aaaa" print(string.truncate(limit: 10)) // 0123456789...
Split string in chunks of n elements:
let string = "abcd" print(string.split(intoChunksOf: 2)) // ["ab", "cd"]
Schedule timer every seconds:
var count = 0 Timer.every(1.second, fireImmediately: true) { timer in // fireImmediately is an optional parameter, defaults to false print("Will print every second") if count == 3 { timer.invalidate() } count++ }
Schedule timer after a certain delay:
Timer.after(2.seconds) { _ in print("Prints this 2 seconds later in main queue") }
Manual scheduling a timer:
let timer = Timer.new(every: 2.seconds) { _ in print("Prints this 2 seconds later in main queue") } timer.start(onRunLoop: RunLoop.current, modes: RunLoopMode.defaultRunLoopMode)
Manual scheduling a timer with a delay:
let timer = Timer.new(after: 2.seconds) { _ in print("Prints this 2 seconds later in main queue") } timer.start(onRunLoop: RunLoop.current, modes: RunLoopMode.defaultRunLoopMode)
Get query parameters from URL:
let url = URL(string: "http://example.com/api?v=1.1&q=google") let queryParameters = url?.queryParameters print(queryParameters?["v"]) // 1.1 print(queryParameters?["q"]) // google print(queryParameters?["other"]) // nil
Add skip backup attributes to you URL:
let url = URL(string: "/path/to/your/file") url?.addSkipBackupAttribute() // File at url won't be backupped!
Get and set values from
UserDefaultswith subscripts:
let Defaults = UserDefaults.standard Defaults["userName"] = "test" print(Defaults["userName"]) // test
Check if the
UserDefaultshas a key:
UserDefaults.has(key: "aKey") // OR UserDefaults.standard.has(key: "aKey")
Remove all values in
UserDefaults:
UserDefaults.standard.removeAll()
Generate automatically multiple previews including:
struct ContentView_Previews: PreviewProvider { static var previews: some View { UIElementPreview(ContentView(), previewLayout: .sizeThatFits, // default is `.device` previewDevices: ["iPhone SE"], // default is iPhone SE and iPhone XS Max. Note: it won't be used if `previewLayout` is `.sizeThatFits` dynamicTypeSizes:[.extraSmall] // default is: .extraSmall, .large, .extraExtraExtraLarge ) } }
Pass an interactive value that’ll act as a preview stand-in for a binding:
struct MyButton: View { @Binding var isSelected: Bool // ... }struct MyButton_Previews: PreviewProvider { static var previews: some View { MyButton(isSelected: .mock(true)) } }
Create a custom
UIAlertController:
let alertController1 = UIAlertController(title: "Title", message: "Message")let alertController2 = UIAlertController(title: "Title", message: "Message", defaultActionButtonTitle: "Cancel")
let alertController3 = UIAlertController(title: "Title", message: "Message", defaultActionButtonTitle: "Cancel", defaultActionButtonStyle: .cancel)
let alertController1 = UIAlertController(title: "Title", message: "Message", defaultActionButtonTitle: "Cancel", defaultActionButtonStyle: .cancel, tintColor: .blue)
Show an
UIAlertController:
alertController.show() alertController.show(animated: false) alertController.show(animated: true, completion: { print("Presented") })
Add an action to the
UIAlertController:
alertController.addAction(title: "ActionTitle")alertController.addAction(title: "ActionTitle", style: .destructive)
alertController.addAction(title: "ActionTitle", style: .destructive, isEnabled: false)
alertController.addAction(title: "ActionTitle", style: .destructive, isEnabled: false, handler: nil)
Get the current view controller display:
UIApplication.shared.topViewController() // Using UIWindow's rootViewController as baseVC UIApplication.shared.topViewController(from: baseVC) // topVC from the base view controller
Get the app delegate:
UIApplication.delegate(AppDelegate.self)
Open app settings:
UIApplication.shared.openAppSettings()
Open app review page:
let url = URL(string: "https://itunes.apple.com/app/{APP_ID}?action=write-review") UIApplication.shared.openAppStoreReviewPage(url)
Add right image with custom offset to button:
let button = UIButton(frame: .zero) button.addRightImage(image, offset: 16)
Register and dequeue safely your
UICollectionViewCell:
// 1. Make your `UICollectionCell` conforms to `Reusable` (class-based) or `NibReusable` (nib-based) final class ReusableClassCollectionViewCell: UICollectionViewCell, Reusable {} // 2. Register your cell: collectionView.register(cellType: ReusableClassCollectionViewCell.self) // 3. Dequeue your cell: let cell: ReusableClassCollectionViewCell = collectionView.dequeueReusableCell(at: indexPath)
Register and dequeue safely your
UICollectionReusableView:
// 1. Make your `UICollectionReusableView` conforms to `Reusable` (class-based) or `NibReusable` (nib-based) final class ReusableNibCollectionReusableView: UICollectionReusableView, NibReusable // 2. Register your cell: collectionView.register(supplementaryViewType: ReusableNibCollectionReusableView.self, ofKind: UICollectionView.elementKindSectionHeader) // 3. Dequeue your cell: let header: ReusableNibCollectionReusableView = collectionView.dequeueReusableSupplementaryView(ofKind: UICollectionView.elementKindSectionHeader, at: indexPath)
Apply a corner radius to the cell:
let cell = UICollectionViewCell() cell.applyCornerRadius(10)
Animate when cell is highlighted:
class MyCollectionViewCell: UICollectionViewCell { // ... override var isHighlighted: Bool { willSet { self.animate(scale: newValue, options: .curveEaseInOut) // Note that the animation is customisable, but all parameters as default value } } // ... }
Obtains a font that scale to support Dynamic Type:
let font = UIFont.dynamicStyle(.body, traits: .traitsBold)
Access to your device information:
print(UIDevice.idForVendor) // 104C9F7F-7403-4B3E-B6A2-C222C82074FF print(UIDevice.systemName()) // iPhone OS print(UIDevice.systemVersion()) // 9.0 print(UIDevice.deviceName) // iPhone Simulator / iPhone 6 Wifi print(UIDevice.deviceLanguage) // en print(UIDevice.isPhone) // true or false print(UIDevice.isPad) // true or false
Check your system version:
print(UIDevice.isVersion(8.1)) // false print(UIDevice.isVersionOrLater(8.1)) // true print(UIDevice.isVersionOrEarlier(8.1)) // false
Force device orientation:
UIDevice.forceRotation(.portrait) UIDevice.current.forceRotation(.portrait)
Create an image from a color:
let image = UIImage(color: .green)
Fill an image with a color:
let image = UIImage(named: "image") let greenImage = image.filled(with: .green)
Combined an image with another:
let image = UIImage(named: "image") let image2 = UIImage(named: "image2") let combinedImage = image.combined(with: image2)
Change the rendering mode:
var image = UIImage(named: "image") image = image.template // imageWithRenderingMode(.alwaysTemplate) image = image.original // imageWithRenderingMode(.alwaysOriginal)
Configure a dynamic text style to the label:
label.configureDynamicStyle(.body, traits: .traitBold)
Detect if a label text is truncated:
let label = UILabel(frame: CGRect(x: 0, y: 0, width: 30, height: 40)) label.text = "I will be truncated :(" print(label.isTruncated()) // truelet label = UILabel(frame: CGRect(x: 0, y: 0, width: 30, height: 40)) label.text = ":)" print(label.isTruncated()) // false
Customize label line height:
let label = UILabel(frame: CGRect(x: 0, y: 0, width: 30, height: 40)) label.setText("A long multiline text") label.setLineHeight(0.9)
Customize the label truncated text (replace the default
...):
let label = UILabel(frame: CGRect(x: 0, y: 0, width: 30, height: 40)) label.setText("I will be truncated :(", truncatedText: ".") print(label.text) // I wi.
Get the screen orientation:
if UIInterfaceOrientationIsPortrait(UIScreen.currentOrientation) { // Portrait } else { // Landscape }
Get the screen size:
print(UIScreen.size) // CGSize(375.0, 667.0) on iPhone6 print(UIScreen.width) // 375.0 on iPhone6 print(UIScreen.height) // 667.0 on iPhone6 print(UIScreen.heightWithoutStatusBar) // 647.0 on iPhone6
Get the status bar height:
print(UIScreen.statusBarHeight) // 20.0 on iPhone6
Get the application's main storyboard:
let storyboard = UIStoryboard.main
Toggle
UISwitch:
let aSwitch = UISwitch(frame: CGRect(x: 0, y: 0, width: 100, height: 30)) aSwitch.toggle() print(aSwitch.isOn) // trueaSwitch.toggle(animated: false)
Register and dequeue safely your
UITableViewCell:
// 1. Make your `UITableViewCell` conforms to `Reusable` (class-based) or `NibReusable` (nib-based) final class ReusableClassTableViewCell: UITableViewCell, Reusable {} // 2. Register your cell: tableView.register(cellType: ReusableClassTableViewCell.self) // 3. Dequeue your cell: let cell: ReusableClassTableViewCell = tableView.dequeueReusableCell(at: indexPath)
Register and dequeue safely your
UITableViewHeaderFooterView:
// 1. Make your `UITableViewHeaderFooterView` conforms to `Reusable` (class-based) or `NibReusable` (nib-based) final class ReusableClassHeaderFooterView: UITableViewHeaderFooterView, Reusable {} // 2. Register your header or footer: tableView.register(headerFooterViewType: ReusableClassHeaderFooterView.self) // 3. Dequeue your header or footer: let cell: ReusableClassHeaderFooterView = tableView.dequeueReusableHeaderFooterView()
Configure a dynamic text style to the textfield:
textField.configureDynamicStyle(.body, traits: .traitBold)
Modify clear button image:
let clearButtonImage = UIImage(named: "clear_button") let textField = UITextField() textField.setClearButton(with: clearButtonImage)
Modify placeholder's color:
let textField = UITextField() // set `placeholder` or `attributedPlaceholder` textField.setPlaceHolderTextColor(.blue)
Configure a dynamic text style to the textfield:
textView.configureDynamicStyle(.body, traits: .traitBold)
Change the frame of the view easily:
let aView = UIView(frame: CGRect(x: 0, y: 0, width: 100, height: 100)) aView.x += 100 // move to right aView.y += 100 // move downwards aView.width -= 10 // make the view narrower aView.height -= 10 // make the view shorter
Apply a corner radius to the view:
let view = UIView() view.applyCornerRadius(10) view.applyCornerRadius(20, maskedCorners: [.layerMaxXMaxYCorner])
Find the
ViewControllerwhich contains this view:
let parent: UIViewController? = aView.parentViewController
Find a subview using its `accessibilityIdentifier, useful to tests private outlets:
aView.findView(forIdentifier: "accessibilityIdentifier")
Find the first subview corresponding to a specific type:
let scrollView: UIScrollView? = aView.findView()
Add a SwiftUI
Viewas a subview:
aView.addSubSwiftUIView(SwiftUIView())
Automates your localizables:
aView.translateSubviews()
It will iterate on all the subviews of the view, and use the text / placeholder as key in
NSLocalizedString. By settings your localizable key in your xib / storyboard, all yours string will be automatically translated just by calling the above method.
Add constraints between a view and its superview:
aView.addConstraints() // Add constraints to all edges with zero insets aView.addConstraints(to: [.top, .bottom]) // Add constraints to top and bottom edges with zero insets aView.addConstraints(to: [.top, .left], insets: UIEdgeInsets(top: 10, left: 20, bottom: 0, right: 0)) // Add constraints to top and left edges with custom insets
Generate a Xcode preview for any view controllers:
@available(iOS 13, *) struct MyViewPreview: PreviewProvider { static var previews: some View { MyViewController().preview } }
Reset the navigation stack by deleting previous view controllers:
let navController = UINavigationController() navController.pushViewController(vc1, animated: true) navController.pushViewController(vc2, animated: true) navController.pushViewController(vc3, animated: true) vc3.removePreviousControllers(animated: true) print(navController.viewControllers) // [vc3]
Check if ViewController is onscreen and not hidden:
let viewController = UIViewController() print(viewController.isVisible) // false
Check if ViewController is presented modally:
let viewController = UIViewController() print(viewController.isModal)
Open Safari modally:
let url = URL(string: "https://www.apple.com") vc.openSafariVC(url: url, delegate: self)
Add a child view controller to another controller:
vc.addChildController(childVC, subview: vc.view, animated: true, duration: 0.35, options: [.curveEaseInOut, .transitionCrossDissolve])
Add a child view controller to a container view:
vc.addChildController(childVC, in: containerView)
Remove a child view controller:
vc.removeChildController(childVC)
Add a SwiftUI
Viewas a child of the input
UIView:
vc.addSubSwiftUIView(SwiftUIView(), to: vc.view)
Make your
UIViewsubclasses conform to this protocol to instantiate them from their NIB safely. Note: Be sure that your
UIViewis based on a Nib, and is used as the Xib's root view.
class NibLoadableView: UIView, NibLoadable { // ... }let view = NibLoadableView.loadFromNib()
Make your
UIViewsubclasses conform to this protocol to instantiate them from their Xib's File Owner safely. Note: Be sure that your
UIViewis based on a Nib, and is used as the Xib's File's Owner.
class NibLoadableView: UIView, NibOwnerLoadable { // ...required init?(coder aDecoder: NSCoder) { super.init(coder: aDecoder) self.loadNibContent() }
}
// Then use it directly from another xib or whatever...
Change the frame of the view easily
let aView = NSView(frame: CGRect(x: 0, y: 0, width: 100, height: 100)) aView.x += 100 // move to right aView.y += 100 // move downwards aView.width -= 10 // make the view narrower aView.height -= 10 // make the view shorter
Automates your localizables
aView.convertLocalizables()
It will iterate on all the subviews of the view, and use the text / placeholder as key in
NSLocalizedString. By settings your localizable key in your xib / storyboard, all yours string will be automatically translated just by calling the above method.
Protocol to do
ViewControllerData Injection with Storyboards and Segues in Swift. Inspired from Nastasha's blog:
class RedPillViewController: UIViewController, Injectable {@IBOutlet weak private var mainLabel: UILabel! // the type matches the IOU's type typealias T = String // this is my original dependency (IOU) // I can now make this private! private var mainText: String! override func viewDidLoad() { super.viewDidLoad() // this will crash if the IOU is not set assertDependencies() // using the IOU if needed here, // but using it later is fine as well mainLabel.text = mainText } // Injectable Implementation func inject(text: T) { mainText = text } func assertDependencies() { assert(mainText != nil) }
}
// ViewController that will inject data... override func prepareForSegue(segue: UIStoryboardSegue, sender: AnyObject?) {
switch segueIdentifierForSegue(segue) { case .TheRedPillExperience let redPillVC = segue.destinationViewController as? RedPillViewController redPillVC?.inject("😈") case .TheBluePillExperience: let bluePillVC = segue.destinationViewController as? BluePillViewController bluePillVC?.inject("👼") }
}
The following use cases works for String Array, Dictionary, and Set
isEmpty/
isNotEmpty
No optional types only
var string = "Hello world" print(string.isNotEmpty) // true print(string.isEmpty) // false
isNilOrEmpty
Optional types only
let string: String? = "" print(string.isNilOrEmpty) // true
Syntactic sugar for Swift initializers:
let label = UILabel().then { $0.textAlignment = .Center $0.textColor = .blackColor() $0.text = "Hello, World!" }
Type safe access to UserDefaults with support for default values.
struct SettingsViewModel { @UserDefaultsBacked(key: "search-page-size", defaultValue: 20) var numberOfSearchResultsPerPage: Int@UserDefaultsBacked(key: "signature") var messageSignature: String?
}
Grand Central Dispatch sugar syntax:
Detect if UITests are running:
if UnitTesting.isRunning { // tests are running } else { // everything is fine, move along }
Measure tests performance:
func testPerformance() { let measurement = measure { // run operation } }
Detect if UITests are running:
if UITesting.isRunning { // tests are running } else { // everything is fine, move along }
(macOS only)
Runs a command on a system shell and provides the return code for success, STDOUT, and STDERR.
STDOUT as one continuous String:
let (rCode, stdOut, stdErr) = SystemUtility.shell(["ls", "-l", "/"]) // rCode = 0 (which is "true" in shell) // stdOut = "total 13\ndrwxrwxr-x+ 91 root admin 2912 Feb 11 01:24 Applications" ... etc // stdErr = [""]
STDOUT as array of Strings separated by newlines:
let (rCode, stdOut, stdErr) = SystemUtility.shellArrayOut(["ls", "-l", "/"]) // rCode = 0 (which is "true" in shell) // stdOut = ["total 13", "drwxrwxr-x+ 91 root admin 2912 Feb 11 01:24 Applications" ... etc] // stdErr = [""]
Copy the SwiftyUtils folder into your Xcode project. (Make sure you add the files to your target(s))
Add
pod SwiftyUtilsto your Podfile.
Add
github "tbaranes/SwiftyUtils"to your Cartfile.
You can use The Swift Package Manager to install
SwiftyUtilsby adding the proper description to your
Package.swiftfile:
import PackageDescriptionlet package = Package( dependencies: [ .Package(url: "https://github.com/tbaranes/SwiftyUtils.git", majorVersion: 0) ] )
SwiftyUtils is under the MIT license. See the LICENSE file for more information. dic.testAll