feat: add extension and sample project

InitialsImageView.podspec

@@ -0,0 +1,15 @@
+Pod::Spec.new do |s|
+  s.name         = "InitialsImageView"
+  s.version      = "0.1.0"
+  s.summary      = "A simple UIImageView extension for using initials as a profile image, written in swift"
+  s.description  = "An easy, helpful UIImageView extension that generates letter initials as a placeholder for user profile images, with a randomized background color."
+  s.homepage     = "https://github.com/bachonk/InitialsImageView"
+  s.screenshots  = "http://i.imgur.com/xSBjVQ7.png"
+  s.license      = { :type => 'MIT', :file => 'LICENSE' }
+  s.author       = { "Tom Bachant" => "tom@dashride.com" }
+  s.platform     = :ios, '8.0'
+  s.source = { :git => "https://github.com/bachonk/InitialsImageView.git",
+               :tag => '0.1.0' }
+  s.source_files  = 'InitialsImageView.swift'
+  s.requires_arc = true
+end

InitialsImageView.swift

@@ -0,0 +1,136 @@
+//
+//  InitialsImageView.swift
+//  
+//
+//  Created by Tom Bachant on 1/28/17.
+//
+//
+
+import UIKit
+
+let kFontResizingProportion: CGFloat = 0.4
+let kColorMinComponent: Int = 30
+let kColorMaxComponent: Int = 214
+
+extension UIImageView {
+
+    public func setImageForName(string: String, backgroundColor: UIColor?, circular: Bool, textAttributes: [String: AnyObject]?) {
+
+        let initials: String = initialsFromString(string: string)
+        let color: UIColor = (backgroundColor != nil) ? backgroundColor! : randomColor()
+        let attributes: [String: AnyObject] = (textAttributes != nil) ? textAttributes! : [
+            NSFontAttributeName: self.fontForFontName(name: nil),
+            NSForegroundColorAttributeName: UIColor.white
+        ]
+
+        self.image = imageSnapshot(text: initials, backgroundColor: color, circular: circular, textAttributes: attributes)
+    }
+
+    private func fontForFontName(name: String?) -> UIFont {
+
+        let fontSize = self.bounds.width * kFontResizingProportion;
+        if name != nil {
+            return UIFont(name: name!, size: fontSize)!
+        }
+        else {
+            return UIFont.systemFont(ofSize: fontSize)
+        }
+
+    }
+
+    private func imageSnapshot(text imageText: String, backgroundColor: UIColor, circular: Bool, textAttributes: [String : AnyObject]) -> UIImage {
+
+        let scale: CGFloat = UIScreen.main.scale
+
+        var size: CGSize = self.bounds.size
+        if (self.contentMode == .scaleToFill ||
+            self.contentMode == .scaleAspectFill ||
+            self.contentMode == .scaleAspectFit ||
+            self.contentMode == .redraw) {
+
+            size.width = (size.width * scale) / scale
+            size.height = (size.height * scale) / scale
+        }
+
+        UIGraphicsBeginImageContextWithOptions(size, false, scale)
+
+        let context: CGContext = UIGraphicsGetCurrentContext()!
+
+        if circular {
+            // Clip context to a circle
+            let path: CGPath = CGPath(ellipseIn: self.bounds, transform: nil)
+            context.addPath(path)
+            context.clip()
+        }
+
+        // Fill background of context
+        context.setFillColor(backgroundColor.cgColor)
+        context.fill(CGRect(x: 0, y: 0, width: size.width, height: size.height))
+
+        // Draw text in the context
+        let textSize: CGSize = imageText.size(attributes: textAttributes)
+        let bounds: CGRect = self.bounds
+
+        imageText.draw(in: CGRect(x: bounds.midX - textSize.width / 2,
+                                  y: bounds.midY - textSize.height / 2,
+                                  width: textSize.width,
+                                  height: textSize.height),
+                       withAttributes: textAttributes)
+
+        let snapshot: UIImage = UIGraphicsGetImageFromCurrentImageContext()!;
+        UIGraphicsEndImageContext();
+
+        return snapshot;
+    }
+}
+
+private func initialsFromString(string: String) -> String {
+
+    var displayString: String = ""
+    var words: [String] = string.components(separatedBy: .whitespacesAndNewlines)
+
+    // Get first letter of the first and last word
+    if words.count > 0 {
+        let firstWord: String = words.first!
+        if firstWord.characters.count > 0 {
+            // Get character range to handle emoji (emojis consist of 2 characters in sequence)
+            let range: Range<String.Index> = firstWord.startIndex..<firstWord.index(firstWord.startIndex, offsetBy: 1)
+            let firstLetterRange: Range = firstWord.rangeOfComposedCharacterSequences(for: range)
+
+            displayString.append(firstWord.substring(with: firstLetterRange).uppercased())
+        }
+
+        if words.count >= 2 {
+            var lastWord: String = words.last!
+
+            while lastWord.characters.count == 0 && words.count >= 2 {
+                words.removeLast()
+                lastWord = words.last!
+            }
+
+            if words.count > 1 {
+                // Get character range to handle emoji (emojis consist of 2 characters in sequence)
+                let range: Range<String.Index> = lastWord.startIndex..<lastWord.index(lastWord.startIndex, offsetBy: 1)
+                let lastLetterRange: Range = lastWord.rangeOfComposedCharacterSequences(for: range)
+
+                displayString.append(lastWord.substring(with: lastLetterRange).uppercased())
+            }
+        }
+    }
+
+    return displayString
+}
+
+private func randomColorComponent() -> Int {
+    let limit = kColorMaxComponent - kColorMinComponent
+
+    return kColorMinComponent + Int(arc4random_uniform(UInt32(limit)))
+}
+
+private func randomColor() -> UIColor {
+    let red = CGFloat(randomColorComponent()) / 255.0
+    let green = CGFloat(randomColorComponent()) / 255.0
+    let blue = CGFloat(randomColorComponent()) / 255.0
+
+    return UIColor(red: red, green: green, blue: blue, alpha: 1.0)
+}