Updated imports

* Manual version check and alert presentation

* Fixes #267

* Adds the PerformCheck enum

* Added a deinit

* Reverted appdelegate uncommented method

* Updated rule ordering to be alphabetical

* Standardized naming

* emoved extra space

* Updated docs

.gitattributes

@@ -0,0 +1 @@
+docs/* linguist-vendored

.github/CODEOWNERS

@@ -0,0 +1 @@
+*       @artsabintsev

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,28 @@
+# If you're experiencing a problem integrating Siren into your app, please provide the following information when posting a new issue:
+
+- **Are you using the [latest version](https://github.com/ArtSabintsev/Siren/releases) of Siren?**: 
+- **What is your app's Bundle ID?**: 
+- **When was the latest version of your app published to the App Store?**: 
+- **Is your app published in the US App Store? If not, what App Store is it published in?**:
+- **Does Siren work if you plugin your app's `BundleID` (and `countryCode`, if necessary) into the Example app?**:
+
+---
+
+# Before posting an issue, please make sure your issue has not already been resolved or answered elsewhere.
+
+## Common Issue #1:
+>"Error retrieving iOS version number as there was no data returned."
+
+Check if your app is available in the US App Store, otherwise add the corresponding country code when setting up Siren.
+
+## Common Issue #2:
+> "Support for macOS App Store."
+
+Siren does not and will not support the macOS App Store.
+
+## Common Issue #3:
+> "Support for prompting TestFlight users to update to the newest beta build."
+
+Siren does not support this functionality. There is no publicly accessible TestFlight API akin to that of the public App Store API that Siren can utilize to provide this functionality.
+
+# Please delete this text before submitting a new issue.

.gitignore

@@ -16,11 +16,4 @@ DerivedData
 *.hmap
 *.ipa
 *.xcuserstate
-
-# CocoaPods
-#
-# We recommend against adding the Pods directory to your .gitignore. However
-# you should judge for yourself, the pros and cons are mentioned at:
-# http://guides.cocoapods.org/using/using-cocoapods.html#should-i-ignore-the-pods-directory-in-source-control
-#
-# Pods/
+.DS_Store

.swiftlint.yml

@@ -0,0 +1,15 @@
+reporter: "xcode"
+
+included:
+  - ../Sources/
+
+disabled_rules:
+  - cyclomatic_complexity
+  - line_length
+  - nesting
+  - unused_optional_binding
+  - variable_name
+
+# Specialized Rules
+file_length:
+  - 500

.travis.yml

@@ -0,0 +1,10 @@
+language: objective-c
+osx_image: xcode10
+
+notifications:
+  email: false
+env:
+  - LC_CTYPE=en_US.UTF-8 LANG=en_US.UTF-8
+script:
+  - set -o pipefail
+  - xcodebuild -project Example/Example.xcodeproj -scheme Example -sdk iphonesimulator ONLY_ACTIVE_ARCH=NO | xcpretty -c

CONTRIBUTORS.md

@@ -1,35 +0,0 @@
-### Created and maintained by
-[Arthur Ariel Sabintsev](http://www.sabintsev.com/) and [Aaron Brager](http://twitter.com/GetAaron)
-
-### Siren Project Contributors
-- [Dmitry Bespalov](https://github.com/diamondsky) for [Pull Request #7](https://github.com/ArtSabintsev/Siren/pull/7)
-- [Daniel Bauke](https://github.com/bonkey) for [Pull Request #8](https://github.com/ArtSabintsev/Siren/pull/8)
-- [Jędrek Kostecki](https://github.com/jedrekk) for [Pull Request #10](https://github.com/ArtSabintsev/Siren/pull/10)
-
-
-### Harpy Project Contributors
-This repo is a Swift language port of [Harpy](http://github.com/ArtSabintsev/Harpy). We couldn't have built this port without acknowledging the following developers who were instrumental in getting Harpy to its current state, v3.2.1 at the time this document was written.
-
-A huge **Thank You** to the following developers:
-
-- [Borut Tomažin](https://github.com/borut-t)
-- [Bertie Liu](https://github.com/https://github.com/aceisScope)
-- [Burakkilic](https://github.com/burakkilic)
-- [Claas Lange](https://github.com/claaslange)
-- [Daniel](https://github.com/danieltskv)
-- [David Keegan](https://github.com/kgn)
-- [Erick](https://github.com/dexcell0)
-- [Ercillagorka](https://github.com/ercillagorka)
-- [Jamie Ly](http://github,com/jamiely)
-- [Jon Andersen](https://github.com/jonandersen)
-- [Josh T. Brown](https://github.com/joshuatbrown)
-- [Mark Rickert](https://github.com/markrickert)
-- [Patrick Debois](https://github.com/jedi4ever)
-- [Pius Uzamere](https://github.com/pius)
-- [Rahul Jiresal](https://github.com/rahuljiresal)
-- [Rui Peres](https://github.com/RuiAAPeres)
-- [Thomas Hempel](https://github.com/thomashempel)
-- [TrentW](https://github.com/trentw)
-
-### Special Thanks
-Finally, a massive **Thank You** to [Aaron Brager](http://twitter.com/GetAaron) for the dev-work and issue-moderation he's done on Harpy since 2012. A Swift port could not have happened without him.

Example/Example.xcodeproj/project.pbxproj

@@ -0,0 +1,766 @@
+// !$*UTF8*$!
+{
+	archiveVersion = 1;
+	classes = {
+	};
+	objectVersion = 46;
+	objects = {
+
+/* Begin PBXBuildFile section */
+		4D729C4421A20EDC002F73AB /* Siren.bundle in Resources */ = {isa = PBXBuildFile; fileRef = 55EC365E1E6BB99B00726F13 /* Siren.bundle */; };
+		4D729C4621A213B4002F73AB /* Rules.swift in Sources */ = {isa = PBXBuildFile; fileRef = 4D729C4521A213B4002F73AB /* Rules.swift */; };
+		55EC364B1E6BB98A00726F13 /* Siren.h in Headers */ = {isa = PBXBuildFile; fileRef = 55EC36491E6BB98A00726F13 /* Siren.h */; settings = {ATTRIBUTES = (Public, ); }; };
+		55EC36601E6BB99B00726F13 /* Siren.bundle in Resources */ = {isa = PBXBuildFile; fileRef = 55EC365E1E6BB99B00726F13 /* Siren.bundle */; };
+		55EC36611E6BB99B00726F13 /* Siren.swift in Sources */ = {isa = PBXBuildFile; fileRef = 55EC365F1E6BB99B00726F13 /* Siren.swift */; };
+		8E01817921B379AF006DED05 /* Results.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E01817821B379AF006DED05 /* Results.swift */; };
+		8E01817E21B379DD006DED05 /* PresentationManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E01817B21B379DD006DED05 /* PresentationManager.swift */; };
+		8E01818021B379DD006DED05 /* RulesManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E01817D21B379DD006DED05 /* RulesManager.swift */; };
+		8E01818221B37B43006DED05 /* AlertAction.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E01818121B37B43006DED05 /* AlertAction.swift */; };
+		8E065BA122054E5A00188D4E /* PerformCheck.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E065BA022054E5A00188D4E /* PerformCheck.swift */; };
+		8E1635A91E6A0B9C0060CE27 /* SirenTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8EE6C74C1E6A0AE100DBE454 /* SirenTests.swift */; };
+		8E171DDE215B26B4006FBBCC /* BundleExtension.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E171DD1215B26B4006FBBCC /* BundleExtension.swift */; };
+		8E171DDF215B26B4006FBBCC /* DateExtension.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E171DD2215B26B4006FBBCC /* DateExtension.swift */; };
+		8E171DE2215B26B4006FBBCC /* LookupModel.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E171DD7215B26B4006FBBCC /* LookupModel.swift */; };
+		8E171DE3215B26B4006FBBCC /* UIAlertControllerExtension.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E171DD8215B26B4006FBBCC /* UIAlertControllerExtension.swift */; };
+		8E171DE4215B26B4006FBBCC /* SirenViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E171DDA215B26B4006FBBCC /* SirenViewController.swift */; };
+		8E171DE6215B2701006FBBCC /* Localization.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E171DE5215B2701006FBBCC /* Localization.swift */; };
+		8E171DEE215B2D09006FBBCC /* UserDefaultsExtension.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E171DED215B2D09006FBBCC /* UserDefaultsExtension.swift */; };
+		8E5061EB21C9CDF000A28DE0 /* AlertConstants.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E5061EA21C9CDF000A28DE0 /* AlertConstants.swift */; };
+		8E641D2520C8B44B00908555 /* Siren.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 55EC36471E6BB98A00726F13 /* Siren.framework */; };
+		8EACA9711F380294003134CA /* LaunchScreen.xib in Resources */ = {isa = PBXBuildFile; fileRef = 8EACA9671F37F2D3003134CA /* LaunchScreen.xib */; };
+		8EACA9721F380294003134CA /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 8EACA9691F37F2D3003134CA /* Main.storyboard */; };
+		8EACA9731F380294003134CA /* Images.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 8EACA96B1F37F2D3003134CA /* Images.xcassets */; };
+		8EACA9741F38029B003134CA /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8EACA9661F37F2D3003134CA /* AppDelegate.swift */; };
+		8EACA9751F38029B003134CA /* ViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8EACA96D1F37F2D3003134CA /* ViewController.swift */; };
+		8EE1FAF321B4DC0F009112A8 /* KnownError.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8EE1FAF221B4DC0F009112A8 /* KnownError.swift */; };
+		8EE1FAF521B4E6B8009112A8 /* APIManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8EE1FAF421B4E6B8009112A8 /* APIManager.swift */; };
+		8EEF4AB121AA6DDF00C83AAA /* DataParser.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8EEF4AB021AA6DDF00C83AAA /* DataParser.swift */; };
+/* End PBXBuildFile section */
+
+/* Begin PBXContainerItemProxy section */
+		8E3A6C091D07CB6F00A8B7CF /* PBXContainerItemProxy */ = {
+			isa = PBXContainerItemProxy;
+			containerPortal = 8EC391791A58B465001C121E /* Project object */;
+			proxyType = 1;
+			remoteGlobalIDString = 8EC391801A58B465001C121E;
+			remoteInfo = "Sample App";
+		};
+/* End PBXContainerItemProxy section */
+
+/* Begin PBXFileReference section */
+		4D729C4521A213B4002F73AB /* Rules.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Rules.swift; sourceTree = "<group>"; };
+		55EC36471E6BB98A00726F13 /* Siren.framework */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; path = Siren.framework; sourceTree = BUILT_PRODUCTS_DIR; };
+		55EC36491E6BB98A00726F13 /* Siren.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = Siren.h; sourceTree = "<group>"; };
+		55EC364A1E6BB98A00726F13 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; name = Info.plist; path = ../../Siren/Info.plist; sourceTree = "<group>"; };
+		55EC365E1E6BB99B00726F13 /* Siren.bundle */ = {isa = PBXFileReference; lastKnownFileType = "wrapper.plug-in"; name = Siren.bundle; path = ../../Sources/Siren.bundle; sourceTree = "<group>"; };
+		55EC365F1E6BB99B00726F13 /* Siren.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; name = Siren.swift; path = ../../Sources/Siren.swift; sourceTree = "<group>"; };
+		8E01817821B379AF006DED05 /* Results.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Results.swift; sourceTree = "<group>"; };
+		8E01817B21B379DD006DED05 /* PresentationManager.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = PresentationManager.swift; sourceTree = "<group>"; };
+		8E01817D21B379DD006DED05 /* RulesManager.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = RulesManager.swift; sourceTree = "<group>"; };
+		8E01818121B37B43006DED05 /* AlertAction.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AlertAction.swift; sourceTree = "<group>"; };
+		8E065BA022054E5A00188D4E /* PerformCheck.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PerformCheck.swift; sourceTree = "<group>"; };
+		8E171DD1215B26B4006FBBCC /* BundleExtension.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = BundleExtension.swift; sourceTree = "<group>"; };
+		8E171DD2215B26B4006FBBCC /* DateExtension.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = DateExtension.swift; sourceTree = "<group>"; };
+		8E171DD7215B26B4006FBBCC /* LookupModel.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = LookupModel.swift; sourceTree = "<group>"; };
+		8E171DD8215B26B4006FBBCC /* UIAlertControllerExtension.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = UIAlertControllerExtension.swift; sourceTree = "<group>"; };
+		8E171DDA215B26B4006FBBCC /* SirenViewController.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SirenViewController.swift; sourceTree = "<group>"; };
+		8E171DE5215B2701006FBBCC /* Localization.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Localization.swift; sourceTree = "<group>"; };
+		8E171DED215B2D09006FBBCC /* UserDefaultsExtension.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = UserDefaultsExtension.swift; sourceTree = "<group>"; };
+		8E3A6C041D07CB6F00A8B7CF /* Tests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = Tests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
+		8E5061EA21C9CDF000A28DE0 /* AlertConstants.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AlertConstants.swift; sourceTree = "<group>"; };
+		8EACA9661F37F2D3003134CA /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
+		8EACA9681F37F2D3003134CA /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.xib; name = Base; path = Base.lproj/LaunchScreen.xib; sourceTree = "<group>"; };
+		8EACA96A1F37F2D3003134CA /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = "<group>"; };
+		8EACA96B1F37F2D3003134CA /* Images.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Images.xcassets; sourceTree = "<group>"; };
+		8EACA96C1F37F2D3003134CA /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
+		8EACA96D1F37F2D3003134CA /* ViewController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ViewController.swift; sourceTree = "<group>"; };
+		8EC391811A58B465001C121E /* Example.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = Example.app; sourceTree = BUILT_PRODUCTS_DIR; };
+		8EE1FAF221B4DC0F009112A8 /* KnownError.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = KnownError.swift; sourceTree = "<group>"; };
+		8EE1FAF421B4E6B8009112A8 /* APIManager.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = APIManager.swift; sourceTree = "<group>"; };
+		8EE6C74B1E6A0AE100DBE454 /* Info.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
+		8EE6C74C1E6A0AE100DBE454 /* SirenTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SirenTests.swift; sourceTree = "<group>"; };
+		8EEF4AB021AA6DDF00C83AAA /* DataParser.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DataParser.swift; sourceTree = "<group>"; };
+/* End PBXFileReference section */
+
+/* Begin PBXFrameworksBuildPhase section */
+		55EC36431E6BB98A00726F13 /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		8E3A6C011D07CB6F00A8B7CF /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		8EC3917E1A58B465001C121E /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				8E641D2520C8B44B00908555 /* Siren.framework in Frameworks */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXFrameworksBuildPhase section */
+
+/* Begin PBXGroup section */
+		55EC36481E6BB98A00726F13 /* Siren */ = {
+			isa = PBXGroup;
+			children = (
+				55EC36491E6BB98A00726F13 /* Siren.h */,
+				55EC365F1E6BB99B00726F13 /* Siren.swift */,
+				55EC365E1E6BB99B00726F13 /* Siren.bundle */,
+				8E171DD0215B26B4006FBBCC /* Extensions */,
+				8E01817A21B379DD006DED05 /* Managers */,
+				8E171DD5215B26B4006FBBCC /* Models */,
+				8E171DCC215B26B4006FBBCC /* Utilities */,
+				8E171DD9215B26B4006FBBCC /* View Controllers */,
+			);
+			path = Siren;
+			sourceTree = "<group>";
+		};
+		8E01817A21B379DD006DED05 /* Managers */ = {
+			isa = PBXGroup;
+			children = (
+				8EE1FAF421B4E6B8009112A8 /* APIManager.swift */,
+				8E01817B21B379DD006DED05 /* PresentationManager.swift */,
+				8E01817D21B379DD006DED05 /* RulesManager.swift */,
+			);
+			name = Managers;
+			path = ../../Sources/Managers;
+			sourceTree = "<group>";
+		};
+		8E171DCC215B26B4006FBBCC /* Utilities */ = {
+			isa = PBXGroup;
+			children = (
+				8EEF4AB021AA6DDF00C83AAA /* DataParser.swift */,
+				8EE1FAF221B4DC0F009112A8 /* KnownError.swift */,
+			);
+			name = Utilities;
+			path = ../../Sources/Utilities;
+			sourceTree = "<group>";
+		};
+		8E171DD0215B26B4006FBBCC /* Extensions */ = {
+			isa = PBXGroup;
+			children = (
+				8E171DD1215B26B4006FBBCC /* BundleExtension.swift */,
+				8E171DD2215B26B4006FBBCC /* DateExtension.swift */,
+				8E171DD8215B26B4006FBBCC /* UIAlertControllerExtension.swift */,
+				8E171DED215B2D09006FBBCC /* UserDefaultsExtension.swift */,
+			);
+			name = Extensions;
+			path = ../../Sources/Extensions;
+			sourceTree = "<group>";
+		};
+		8E171DD5215B26B4006FBBCC /* Models */ = {
+			isa = PBXGroup;
+			children = (
+				8E01818121B37B43006DED05 /* AlertAction.swift */,
+				8E5061EA21C9CDF000A28DE0 /* AlertConstants.swift */,
+				8E171DE5215B2701006FBBCC /* Localization.swift */,
+				8E171DD7215B26B4006FBBCC /* LookupModel.swift */,
+				8E065BA022054E5A00188D4E /* PerformCheck.swift */,
+				8E01817821B379AF006DED05 /* Results.swift */,
+				4D729C4521A213B4002F73AB /* Rules.swift */,
+			);
+			name = Models;
+			path = ../../Sources/Models;
+			sourceTree = "<group>";
+		};
+		8E171DD9215B26B4006FBBCC /* View Controllers */ = {
+			isa = PBXGroup;
+			children = (
+				8E171DDA215B26B4006FBBCC /* SirenViewController.swift */,
+			);
+			name = "View Controllers";
+			path = "../../Sources/View Controllers";
+			sourceTree = "<group>";
+		};
+		8E641D2420C8B44B00908555 /* Frameworks */ = {
+			isa = PBXGroup;
+			children = (
+			);
+			name = Frameworks;
+			sourceTree = "<group>";
+		};
+		8EACA9651F37F2D3003134CA /* Example */ = {
+			isa = PBXGroup;
+			children = (
+				8EACA9661F37F2D3003134CA /* AppDelegate.swift */,
+				8EACA96E1F37F2DD003134CA /* Supporting Files */,
+			);
+			path = Example;
+			sourceTree = "<group>";
+		};
+		8EACA96E1F37F2DD003134CA /* Supporting Files */ = {
+			isa = PBXGroup;
+			children = (
+				8EACA9671F37F2D3003134CA /* LaunchScreen.xib */,
+				8EACA9691F37F2D3003134CA /* Main.storyboard */,
+				8EACA96B1F37F2D3003134CA /* Images.xcassets */,
+				8EACA96C1F37F2D3003134CA /* Info.plist */,
+				8EACA96D1F37F2D3003134CA /* ViewController.swift */,
+				55EC364A1E6BB98A00726F13 /* Info.plist */,
+			);
+			path = "Supporting Files";
+			sourceTree = "<group>";
+		};
+		8EC391781A58B465001C121E = {
+			isa = PBXGroup;
+			children = (
+				55EC36481E6BB98A00726F13 /* Siren */,
+				8EACA9651F37F2D3003134CA /* Example */,
+				8EE6C74A1E6A0AE100DBE454 /* Tests */,
+				8EC391821A58B465001C121E /* Products */,
+				8E641D2420C8B44B00908555 /* Frameworks */,
+			);
+			sourceTree = "<group>";
+		};
+		8EC391821A58B465001C121E /* Products */ = {
+			isa = PBXGroup;
+			children = (
+				8EC391811A58B465001C121E /* Example.app */,
+				8E3A6C041D07CB6F00A8B7CF /* Tests.xctest */,
+				55EC36471E6BB98A00726F13 /* Siren.framework */,
+			);
+			name = Products;
+			sourceTree = "<group>";
+		};
+		8EE6C74A1E6A0AE100DBE454 /* Tests */ = {
+			isa = PBXGroup;
+			children = (
+				8EE6C74B1E6A0AE100DBE454 /* Info.plist */,
+				8EE6C74C1E6A0AE100DBE454 /* SirenTests.swift */,
+			);
+			path = Tests;
+			sourceTree = "<group>";
+		};
+/* End PBXGroup section */
+
+/* Begin PBXHeadersBuildPhase section */
+		55EC36441E6BB98A00726F13 /* Headers */ = {
+			isa = PBXHeadersBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				55EC364B1E6BB98A00726F13 /* Siren.h in Headers */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXHeadersBuildPhase section */
+
+/* Begin PBXNativeTarget section */
+		55EC36461E6BB98A00726F13 /* Siren */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 55EC36521E6BB98A00726F13 /* Build configuration list for PBXNativeTarget "Siren" */;
+			buildPhases = (
+				55EC36421E6BB98A00726F13 /* Sources */,
+				55EC36431E6BB98A00726F13 /* Frameworks */,
+				55EC36441E6BB98A00726F13 /* Headers */,
+				55EC36451E6BB98A00726F13 /* Resources */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+			);
+			name = Siren;
+			productName = Siren;
+			productReference = 55EC36471E6BB98A00726F13 /* Siren.framework */;
+			productType = "com.apple.product-type.framework";
+		};
+		8E3A6C031D07CB6F00A8B7CF /* Tests */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 8E3A6C0D1D07CB6F00A8B7CF /* Build configuration list for PBXNativeTarget "Tests" */;
+			buildPhases = (
+				8E3A6C001D07CB6F00A8B7CF /* Sources */,
+				8E3A6C011D07CB6F00A8B7CF /* Frameworks */,
+				8E3A6C021D07CB6F00A8B7CF /* Resources */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+				8E3A6C0A1D07CB6F00A8B7CF /* PBXTargetDependency */,
+			);
+			name = Tests;
+			productName = SirenTests;
+			productReference = 8E3A6C041D07CB6F00A8B7CF /* Tests.xctest */;
+			productType = "com.apple.product-type.bundle.unit-test";
+		};
+		8EC391801A58B465001C121E /* Example */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 8EC391A01A58B466001C121E /* Build configuration list for PBXNativeTarget "Example" */;
+			buildPhases = (
+				8EC3917D1A58B465001C121E /* Sources */,
+				8EC3917E1A58B465001C121E /* Frameworks */,
+				8EE3A3F81E6A0E470010BDCE /* SwiftLint */,
+				8EC3917F1A58B465001C121E /* Resources */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+			);
+			name = Example;
+			productName = Siren;
+			productReference = 8EC391811A58B465001C121E /* Example.app */;
+			productType = "com.apple.product-type.application";
+		};
+/* End PBXNativeTarget section */
+
+/* Begin PBXProject section */
+		8EC391791A58B465001C121E /* Project object */ = {
+			isa = PBXProject;
+			attributes = {
+				LastSwiftMigration = 0700;
+				LastSwiftUpdateCheck = 0730;
+				LastUpgradeCheck = 0930;
+				ORGANIZATIONNAME = "Sabintsev iOS Projects";
+				TargetAttributes = {
+					55EC36461E6BB98A00726F13 = {
+						CreatedOnToolsVersion = 8.2.1;
+						LastSwiftMigration = 0900;
+						ProvisioningStyle = Automatic;
+					};
+					8E3A6C031D07CB6F00A8B7CF = {
+						CreatedOnToolsVersion = 7.3.1;
+						LastSwiftMigration = 0900;
+						TestTargetID = 8EC391801A58B465001C121E;
+					};
+					8EC391801A58B465001C121E = {
+						CreatedOnToolsVersion = 6.1.1;
+						DevelopmentTeam = HT94948NDD;
+						DevelopmentTeamName = "Arthur Sabintsev";
+						LastSwiftMigration = 0900;
+						SystemCapabilities = {
+							com.apple.BackgroundModes = {
+								enabled = 0;
+							};
+							com.apple.InAppPurchase = {
+								enabled = 0;
+							};
+							com.apple.Push = {
+								enabled = 0;
+							};
+						};
+					};
+				};
+			};
+			buildConfigurationList = 8EC3917C1A58B465001C121E /* Build configuration list for PBXProject "Example" */;
+			compatibilityVersion = "Xcode 3.2";
+			developmentRegion = English;
+			hasScannedForEncodings = 0;
+			knownRegions = (
+				en,
+				Base,
+			);
+			mainGroup = 8EC391781A58B465001C121E;
+			productRefGroup = 8EC391821A58B465001C121E /* Products */;
+			projectDirPath = "";
+			projectRoot = "";
+			targets = (
+				8EC391801A58B465001C121E /* Example */,
+				8E3A6C031D07CB6F00A8B7CF /* Tests */,
+				55EC36461E6BB98A00726F13 /* Siren */,
+			);
+		};
+/* End PBXProject section */
+
+/* Begin PBXResourcesBuildPhase section */
+		55EC36451E6BB98A00726F13 /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				55EC36601E6BB99B00726F13 /* Siren.bundle in Resources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		8E3A6C021D07CB6F00A8B7CF /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				4D729C4421A20EDC002F73AB /* Siren.bundle in Resources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		8EC3917F1A58B465001C121E /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				8EACA9711F380294003134CA /* LaunchScreen.xib in Resources */,
+				8EACA9721F380294003134CA /* Main.storyboard in Resources */,
+				8EACA9731F380294003134CA /* Images.xcassets in Resources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXResourcesBuildPhase section */
+
+/* Begin PBXShellScriptBuildPhase section */
+		8EE3A3F81E6A0E470010BDCE /* SwiftLint */ = {
+			isa = PBXShellScriptBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			inputPaths = (
+			);
+			name = SwiftLint;
+			outputPaths = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+			shellPath = /bin/sh;
+			shellScript = "if which swiftlint >/dev/null; then\nswiftlint lint --config ../.swiftlint.yml\nelse\necho \"warning: SwiftLint not installed, download from https://github.com/realm/SwiftLint\"\nfi";
+		};
+/* End PBXShellScriptBuildPhase section */
+
+/* Begin PBXSourcesBuildPhase section */
+		55EC36421E6BB98A00726F13 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				8E01818021B379DD006DED05 /* RulesManager.swift in Sources */,
+				8E01818221B37B43006DED05 /* AlertAction.swift in Sources */,
+				8E171DEE215B2D09006FBBCC /* UserDefaultsExtension.swift in Sources */,
+				8E171DE2215B26B4006FBBCC /* LookupModel.swift in Sources */,
+				55EC36611E6BB99B00726F13 /* Siren.swift in Sources */,
+				8E5061EB21C9CDF000A28DE0 /* AlertConstants.swift in Sources */,
+				8E01817921B379AF006DED05 /* Results.swift in Sources */,
+				8EEF4AB121AA6DDF00C83AAA /* DataParser.swift in Sources */,
+				4D729C4621A213B4002F73AB /* Rules.swift in Sources */,
+				8E171DE4215B26B4006FBBCC /* SirenViewController.swift in Sources */,
+				8E065BA122054E5A00188D4E /* PerformCheck.swift in Sources */,
+				8E171DE6215B2701006FBBCC /* Localization.swift in Sources */,
+				8EE1FAF521B4E6B8009112A8 /* APIManager.swift in Sources */,
+				8E171DDE215B26B4006FBBCC /* BundleExtension.swift in Sources */,
+				8E01817E21B379DD006DED05 /* PresentationManager.swift in Sources */,
+				8E171DE3215B26B4006FBBCC /* UIAlertControllerExtension.swift in Sources */,
+				8EE1FAF321B4DC0F009112A8 /* KnownError.swift in Sources */,
+				8E171DDF215B26B4006FBBCC /* DateExtension.swift in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		8E3A6C001D07CB6F00A8B7CF /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				8E1635A91E6A0B9C0060CE27 /* SirenTests.swift in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		8EC3917D1A58B465001C121E /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				8EACA9741F38029B003134CA /* AppDelegate.swift in Sources */,
+				8EACA9751F38029B003134CA /* ViewController.swift in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXSourcesBuildPhase section */
+
+/* Begin PBXTargetDependency section */
+		8E3A6C0A1D07CB6F00A8B7CF /* PBXTargetDependency */ = {
+			isa = PBXTargetDependency;
+			target = 8EC391801A58B465001C121E /* Example */;
+			targetProxy = 8E3A6C091D07CB6F00A8B7CF /* PBXContainerItemProxy */;
+		};
+/* End PBXTargetDependency section */
+
+/* Begin PBXVariantGroup section */
+		8EACA9671F37F2D3003134CA /* LaunchScreen.xib */ = {
+			isa = PBXVariantGroup;
+			children = (
+				8EACA9681F37F2D3003134CA /* Base */,
+			);
+			name = LaunchScreen.xib;
+			sourceTree = "<group>";
+		};
+		8EACA9691F37F2D3003134CA /* Main.storyboard */ = {
+			isa = PBXVariantGroup;
+			children = (
+				8EACA96A1F37F2D3003134CA /* Base */,
+			);
+			name = Main.storyboard;
+			sourceTree = "<group>";
+		};
+/* End PBXVariantGroup section */
+
+/* Begin XCBuildConfiguration section */
+		55EC36501E6BB98A00726F13 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+				CODE_SIGN_IDENTITY = "";
+				CURRENT_PROJECT_VERSION = 1;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				DEFINES_MODULE = YES;
+				DEVELOPMENT_TEAM = "";
+				DYLIB_COMPATIBILITY_VERSION = 1;
+				DYLIB_CURRENT_VERSION = 1;
+				DYLIB_INSTALL_NAME_BASE = "@rpath";
+				INFOPLIST_FILE = Siren/Info.plist;
+				INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks";
+				IPHONEOS_DEPLOYMENT_TARGET = 8.0;
+				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks @loader_path/Frameworks";
+				PRODUCT_BUNDLE_IDENTIFIER = com.apple.AppStoreConnect;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SKIP_INSTALL = YES;
+				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
+				SWIFT_VERSION = 4.2;
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VERSIONING_SYSTEM = "apple-generic";
+				VERSION_INFO_PREFIX = "";
+			};
+			name = Debug;
+		};
+		55EC36511E6BB98A00726F13 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+				CODE_SIGN_IDENTITY = "";
+				COPY_PHASE_STRIP = NO;
+				CURRENT_PROJECT_VERSION = 1;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				DEFINES_MODULE = YES;
+				DEVELOPMENT_TEAM = "";
+				DYLIB_COMPATIBILITY_VERSION = 1;
+				DYLIB_CURRENT_VERSION = 1;
+				DYLIB_INSTALL_NAME_BASE = "@rpath";
+				INFOPLIST_FILE = Siren/Info.plist;
+				INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks";
+				IPHONEOS_DEPLOYMENT_TARGET = 8.0;
+				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks @loader_path/Frameworks";
+				PRODUCT_BUNDLE_IDENTIFIER = com.apple.AppStoreConnect;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SKIP_INSTALL = YES;
+				SWIFT_OPTIMIZATION_LEVEL = "-Owholemodule";
+				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
+				SWIFT_VERSION = 4.2;
+				TARGETED_DEVICE_FAMILY = "1,2";
+				VERSIONING_SYSTEM = "apple-generic";
+				VERSION_INFO_PREFIX = "";
+			};
+			name = Release;
+		};
+		8E3A6C0B1D07CB6F00A8B7CF /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES;
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CLANG_ANALYZER_NONNULL = YES;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				GCC_NO_COMMON_BLOCKS = YES;
+				INFOPLIST_FILE = Tests/Info.plist;
+				IPHONEOS_DEPLOYMENT_TARGET = 9.3;
+				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks @loader_path/Frameworks";
+				PRODUCT_BUNDLE_IDENTIFIER = com.sabintsev.SirenTests;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
+				SWIFT_VERSION = 4.2;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Example.app/Example";
+			};
+			name = Debug;
+		};
+		8E3A6C0C1D07CB6F00A8B7CF /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES;
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CLANG_ANALYZER_NONNULL = YES;
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				GCC_NO_COMMON_BLOCKS = YES;
+				INFOPLIST_FILE = Tests/Info.plist;
+				IPHONEOS_DEPLOYMENT_TARGET = 9.3;
+				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks @loader_path/Frameworks";
+				PRODUCT_BUNDLE_IDENTIFIER = com.sabintsev.SirenTests;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_OPTIMIZATION_LEVEL = "-Owholemodule";
+				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
+				SWIFT_VERSION = 4.2;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/Example.app/Example";
+			};
+			name = Release;
+		};
+		8EC3919E1A58B466001C121E /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_SYMBOLS_PRIVATE_EXTERN = NO;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 8.0;
+				MTL_ENABLE_DEBUG_INFO = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = iphoneos;
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 4.2;
+			};
+			name = Debug;
+		};
+		8EC3919F1A58B466001C121E /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
+				CLANG_CXX_LIBRARY = "libc++";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				COPY_PHASE_STRIP = YES;
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				GCC_C_LANGUAGE_STANDARD = gnu99;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 8.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SWIFT_VERSION = 4.2;
+				VALIDATE_PRODUCT = YES;
+			};
+			name = Release;
+		};
+		8EC391A11A58B466001C121E /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				DEVELOPMENT_TEAM = HT94948NDD;
+				INFOPLIST_FILE = "$(SRCROOT)/Siren/Info.plist";
+				IPHONEOS_DEPLOYMENT_TARGET = 8.0;
+				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
+				PRODUCT_BUNDLE_IDENTIFIER = com.apple.AppStoreConnect;
+				PRODUCT_NAME = Example;
+				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
+				SWIFT_VERSION = 4.2;
+			};
+			name = Debug;
+		};
+		8EC391A21A58B466001C121E /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				DEVELOPMENT_TEAM = HT94948NDD;
+				INFOPLIST_FILE = "$(SRCROOT)/Siren/Info.plist";
+				IPHONEOS_DEPLOYMENT_TARGET = 8.0;
+				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
+				PRODUCT_BUNDLE_IDENTIFIER = com.apple.AppStoreConnect;
+				PRODUCT_NAME = Example;
+				SWIFT_OPTIMIZATION_LEVEL = "-Owholemodule";
+				SWIFT_SWIFT3_OBJC_INFERENCE = Default;
+				SWIFT_VERSION = 4.2;
+			};
+			name = Release;
+		};
+/* End XCBuildConfiguration section */
+
+/* Begin XCConfigurationList section */
+		55EC36521E6BB98A00726F13 /* Build configuration list for PBXNativeTarget "Siren" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				55EC36501E6BB98A00726F13 /* Debug */,
+				55EC36511E6BB98A00726F13 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		8E3A6C0D1D07CB6F00A8B7CF /* Build configuration list for PBXNativeTarget "Tests" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				8E3A6C0B1D07CB6F00A8B7CF /* Debug */,
+				8E3A6C0C1D07CB6F00A8B7CF /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		8EC3917C1A58B465001C121E /* Build configuration list for PBXProject "Example" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				8EC3919E1A58B466001C121E /* Debug */,
+				8EC3919F1A58B466001C121E /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		8EC391A01A58B466001C121E /* Build configuration list for PBXNativeTarget "Example" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				8EC391A11A58B466001C121E /* Debug */,
+				8EC391A21A58B466001C121E /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+/* End XCConfigurationList section */
+	};
+	rootObject = 8EC391791A58B465001C121E /* Project object */;
+}

Example/Example.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -2,6 +2,6 @@
 <Workspace
    version = "1.0">
    <FileRef
-      location = "self:Sample App.xcodeproj">
+      location = "self:/Users/Arthur/Documents/oss/siren/SirenExample/Example.xcodeproj">
    </FileRef>
 </Workspace>

Example/Example.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>

Example/Example.xcodeproj/xcshareddata/xcschemes/Example.xcscheme

@@ -0,0 +1,101 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0940"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "8EC391801A58B465001C121E"
+               BuildableName = "Example.app"
+               BlueprintName = "Example"
+               ReferencedContainer = "container:Example.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+         <TestableReference
+            skipped = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "8E3A6C031D07CB6F00A8B7CF"
+               BuildableName = "Tests.xctest"
+               BlueprintName = "Tests"
+               ReferencedContainer = "container:Example.xcodeproj">
+            </BuildableReference>
+         </TestableReference>
+      </Testables>
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "8EC391801A58B465001C121E"
+            BuildableName = "Example.app"
+            BlueprintName = "Example"
+            ReferencedContainer = "container:Example.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "8EC391801A58B465001C121E"
+            BuildableName = "Example.app"
+            BlueprintName = "Example"
+            ReferencedContainer = "container:Example.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "8EC391801A58B465001C121E"
+            BuildableName = "Example.app"
+            BlueprintName = "Example"
+            ReferencedContainer = "container:Example.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

Example/Example.xcodeproj/xcshareddata/xcschemes/Siren.xcscheme

@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "0930"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "55EC36461E6BB98A00726F13"
+               BuildableName = "Siren.framework"
+               BlueprintName = "Siren"
+               ReferencedContainer = "container:Example.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "55EC36461E6BB98A00726F13"
+            BuildableName = "Siren.framework"
+            BlueprintName = "Siren"
+            ReferencedContainer = "container:Example.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+      </AdditionalOptions>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "55EC36461E6BB98A00726F13"
+            BuildableName = "Siren.framework"
+            BlueprintName = "Siren"
+            ReferencedContainer = "container:Example.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

Example/Example/AppDelegate.swift

@@ -0,0 +1,258 @@
+//
+//  AppDelegate.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 1/3/15.
+//  Copyright (c) 2015 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Siren
+import UIKit
+
+@UIApplicationMain
+class AppDelegate: UIResponder, UIApplicationDelegate {
+    var window: UIWindow?
+
+    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
+        window?.makeKeyAndVisible()
+
+        /// - Warning:
+        /// Siren should ONLY be placed in UIApplication.didFinishLaunchingWithOptions and only after the `window?.makeKeyAndVisible()` call.
+        /// Siren initializes a listener on `didBecomeActiveNotification` to perform version checks.
+
+//        defaultExample()
+        defaultExampleUsingCompletionHandler()
+//        manualExampleWithCompletionHandler()
+//        minimalCustomizationPresentationExample()
+//        forceLocalizationCustomizationPresentationExample()
+//        customMessagingPresentationExample()
+//        annoyingRuleExample()
+//        hyperCriticalRulesExample()
+//        updateSpecificRulesExample()
+//        customAlertRulesExample()
+//        appStoreCountryChangeExample()
+//        complexExample()
+
+        return true
+    }
+}
+
+// Examples on how to use Siren
+
+private extension AppDelegate {
+
+    /// The simplest implementation of Siren.
+    /// All default rules are implemented and the
+    /// results of the completion handler are ignored.
+    func defaultExample() {
+        Siren.shared.wail()
+    }
+
+    /// The simplest implementation of Siren.
+    /// All default rules are implemented and the
+    /// results of the completion handler are returned or an error is returned.
+    func defaultExampleUsingCompletionHandler() {
+        Siren.shared.wail { (results, error) in
+            if let results = results {
+                print("AlertAction ", results.alertAction)
+                print("Localization ", results.localization)
+                print("LookupModel ", results.lookupModel)
+                print("UpdateType ", results.updateType)
+            } else if let error = error {
+                print(error.localizedDescription)
+            }
+        }
+    }
+
+    /// Rather than waiting for `didBecomeActive` state changes (e.g., app launching/relaunching),
+    /// Siren's version checking and alert presentation methods will be triggered each time this method is called.
+    func manualExampleWithCompletionHandler() {
+        Siren.shared.wail(performCheck: .onDemand) { (results, error) in
+            if let results = results {
+                print("AlertAction ", results.alertAction)
+                print("Localization ", results.localization)
+                print("LookupModel ", results.lookupModel)
+                print("UpdateType ", results.updateType)
+            } else if let error = error {
+                print(error.localizedDescription)
+            }
+        }
+    }
+
+    /// Minor customization to Siren's update alert presentation.
+    func minimalCustomizationPresentationExample() {
+        let siren = Siren.shared
+        siren.presentationManager = PresentationManager(alertTintColor: .purple,
+                                                        appName: "Siren Example App Override!")
+        siren.wail { (results, error) in
+            if let results = results {
+                print("AlertAction ", results.alertAction)
+                print("Localization ", results.localization)
+                print("LookupModel ", results.lookupModel)
+                print("UpdateType ", results.updateType)
+            } else if let error = error {
+                print(error.localizedDescription)
+            }
+        }
+    }
+
+    /// Forcing the language of the update alert to a specific localization (e.g., Russian is force in this function.
+    func forceLocalizationCustomizationPresentationExample() {
+        let siren = Siren.shared
+        siren.presentationManager = PresentationManager(forceLanguageLocalization: .russian)
+        siren.wail { (results, error) in
+            if let results = results {
+                print("AlertAction ", results.alertAction)
+                print("Localization ", results.localization)
+                print("LookupModel ", results.lookupModel)
+                print("UpdateType ", results.updateType)
+            } else if let error = error {
+                print(error.localizedDescription)
+            }
+        }
+    }
+
+    /// Example on how to change specific strings in the update alert.
+    func customMessagingPresentationExample() {
+        let siren = Siren.shared
+        siren.presentationManager = PresentationManager(alertTitle: "Update Now, OK?",
+                                                        nextTimeButtonTitle: "Next time, please!?")
+        siren.wail { (results, error) in
+            if let results = results {
+                print("AlertAction ", results.alertAction)
+                print("Localization ", results.localization)
+                print("LookupModel ", results.lookupModel)
+                print("UpdateType ", results.updateType)
+            } else if let error = error {
+                print(error.localizedDescription)
+            }
+        }
+    }
+
+    /// How to present an alert every time the app is foregrounded.
+    func annoyingRuleExample() {
+        let siren = Siren.shared
+        siren.rulesManager = RulesManager(globalRules: .annoying)
+
+        siren.wail { (results, error) in
+            if let results = results {
+                print("AlertAction ", results.alertAction)
+                print("Localization ", results.localization)
+                print("LookupModel ", results.lookupModel)
+                print("UpdateType ", results.updateType)
+            } else if let error = error {
+                print(error.localizedDescription)
+            }
+        }
+    }
+
+    /// How to present an alert every time the app is foregrounded.
+    /// This will block the user from using the app until they update the app.
+    /// Setting `showAlertAfterCurrentVersionHasBeenReleasedForDays` to `0` IS NOT RECOMMENDED
+    /// as it will cause the user to go into an endless loop to the App Store if the JSON results
+    /// update faster than the App Store CDN.
+    ///
+    /// The `0` value is illustrated in this app as an example on how to change how quickly an alert is presented.
+    func hyperCriticalRulesExample() {
+        let siren = Siren.shared
+        siren.rulesManager = RulesManager(globalRules: .critical,
+                                          showAlertAfterCurrentVersionHasBeenReleasedForDays: 0)
+
+        siren.wail { (results, error) in
+            if let results = results {
+                print("AlertAction ", results.alertAction)
+                print("Localization ", results.localization)
+                print("LookupModel ", results.lookupModel)
+                print("UpdateType ", results.updateType)
+            } else if let error = error {
+                print(error.localizedDescription)
+            }
+        }
+    }
+
+    /// Major, Minor, Patch, and Revision specific rules implementations.
+    func updateSpecificRulesExample() {
+        let siren = Siren.shared
+        siren.rulesManager = RulesManager(majorUpdateRules: .critical,
+                                          minorUpdateRules: .annoying,
+                                          patchUpdateRules: .default,
+                                          revisionUpdateRules: Rules(promptFrequency: .weekly, forAlertType: .option))
+
+        siren.wail { (results, error) in
+            if let results = results {
+                print("AlertAction ", results.alertAction)
+                print("Localization ", results.localization)
+                print("LookupModel ", results.lookupModel)
+                print("UpdateType ", results.updateType)
+            } else if let error = error {
+                print(error.localizedDescription)
+            }
+        }
+    }
+
+    /// An example on how to present your own custom alert using Siren's localized Strings and version checking cadence.
+    func customAlertRulesExample() {
+        let siren = Siren.shared
+        // The key for using custom alerts is to set the `alertType` to `.none`.
+        // The `Results` type will return localized strings for your app's custom modal presentation.
+        // The `promptFrequency` allows you to customize how often Siren performs the version check before returning a non-error result back into your app, prompting your custom alert functionality.
+        let rules = Rules(promptFrequency: .immediately, forAlertType: .none)
+        siren.rulesManager = RulesManager(globalRules: rules)
+
+        siren.wail { (results, error) in
+            if let results = results {
+                print("USE THE VALUES FROM THE `RESULTS` DATA STRUCTURE TO BUILD YOUR UPDATE ALERT WITH LOCALIZED STRINGS.")
+                print("AlertAction ", results.alertAction)
+                print("Localization ", results.localization)
+                print("LookupModel ", results.lookupModel)
+                print("UpdateType ", results.updateType)
+            } else if let error = error {
+                print(error.localizedDescription)
+            }
+        }
+    }
+
+    /// An example on how to change the App Store region that your app in which your app is available.
+    // This should only be used if your app is not available in the US App Store.
+    // This example function illustrates how this can be done by checking against the Russian App Store.
+    func appStoreCountryChangeExample() {
+        let siren = Siren.shared
+        siren.apiManager = APIManager(countryCode: "RU")
+
+        siren.wail { (results, error) in
+            if let results = results {
+                print("AlertAction ", results.alertAction)
+                print("Localization ", results.localization)
+                print("LookupModel ", results.lookupModel)
+                print("UpdateType ", results.updateType)
+            } else if let error = error {
+                print(error.localizedDescription)
+            }
+        }
+    }
+
+    /// An example on how to customize multiple managers at once.
+    func complexExample() {
+        let siren = Siren.shared
+        siren.presentationManager = PresentationManager(alertTintColor: .brown,
+                                                        appName: "Siren's Complex Rule Example App",
+                                                        alertTitle: "Please, Update Now!",
+                                                        skipButtonTitle: "Click here to skip!",
+                                                        forceLanguageLocalization: .spanish)
+        siren.rulesManager = RulesManager(majorUpdateRules: .critical,
+                                          minorUpdateRules: .annoying,
+                                          patchUpdateRules: .default,
+                                          revisionUpdateRules: .relaxed)
+
+        siren.wail { (results, error) in
+            if let results = results {
+                print("AlertAction ", results.alertAction)
+                print("Localization ", results.localization)
+                print("LookupModel ", results.lookupModel)
+                print("UpdateType ", results.updateType)
+            } else if let error = error {
+                print(error.localizedDescription)
+            }
+        }
+    }
+}

Example/Example/Supporting Files/Base.lproj/LaunchScreen.xib

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<document type="com.apple.InterfaceBuilder3.CocoaTouch.XIB" version="3.0" toolsVersion="6254" systemVersion="14B25" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES">
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.XIB" version="3.0" toolsVersion="11191" systemVersion="15G31" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES" colorMatched="YES">
     <dependencies>
-        <deployment identifier="iOS"/>
-        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="6247"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="11156"/>
         <capability name="Constraints with non-1.0 multipliers" minToolsVersion="5.1"/>
+        <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
     </dependencies>
     <objects>
         <placeholder placeholderIdentifier="IBFilesOwner" id="-1" userLabel="File's Owner"/>
@@ -13,19 +13,17 @@
             <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
             <subviews>
                 <label opaque="NO" clipsSubviews="YES" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" text="  Copyright (c) 2015 Sabintsev iOS Projects. All rights reserved." textAlignment="center" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" minimumFontSize="9" translatesAutoresizingMaskIntoConstraints="NO" id="8ie-xW-0ye">
-                    <rect key="frame" x="20" y="439" width="441" height="21"/>
                     <fontDescription key="fontDescription" type="system" pointSize="17"/>
-                    <color key="textColor" red="0.0" green="0.0" blue="0.0" alpha="1" colorSpace="calibratedRGB"/>
+                    <color key="textColor" red="0.0" green="0.0" blue="0.0" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
                     <nil key="highlightedColor"/>
                 </label>
                 <label opaque="NO" clipsSubviews="YES" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" text="Sample App" textAlignment="center" lineBreakMode="middleTruncation" baselineAdjustment="alignBaselines" minimumFontSize="18" translatesAutoresizingMaskIntoConstraints="NO" id="kId-c2-rCX">
-                    <rect key="frame" x="20" y="140" width="441" height="43"/>
                     <fontDescription key="fontDescription" type="boldSystem" pointSize="36"/>
-                    <color key="textColor" red="0.0" green="0.0" blue="0.0" alpha="1" colorSpace="calibratedRGB"/>
+                    <color key="textColor" red="0.0" green="0.0" blue="0.0" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
                     <nil key="highlightedColor"/>
                 </label>
             </subviews>
-            <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="calibratedWhite"/>
+            <color key="backgroundColor" red="1" green="1" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
             <constraints>
                 <constraint firstItem="kId-c2-rCX" firstAttribute="centerY" secondItem="iN0-l3-epB" secondAttribute="bottom" multiplier="1/3" constant="1" id="5cJ-9S-tgC"/>
                 <constraint firstAttribute="centerX" secondItem="kId-c2-rCX" secondAttribute="centerX" id="Koa-jz-hwk"/>

Example/Example/Supporting Files/Base.lproj/Main.storyboard

@@ -1,21 +1,26 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="6211" systemVersion="14A298i" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" initialViewController="vXZ-lx-hvc">
+<?xml version="1.0" encoding="UTF-8"?>
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="14113" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" colorMatched="YES" initialViewController="vXZ-lx-hvc">
+    <device id="retina4_7" orientation="portrait">
+        <adaptation id="fullscreen"/>
+    </device>
     <dependencies>
-        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="6204"/>
+        <deployment identifier="iOS"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="14088"/>
+        <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
     </dependencies>
     <scenes>
         <!--View Controller-->
         <scene sceneID="ufC-wZ-h7g">
             <objects>
-                <viewController id="vXZ-lx-hvc" customClass="ViewController" customModuleProvider="target" sceneMemberID="viewController">
+                <viewController id="vXZ-lx-hvc" customClass="ViewController" customModule="Example" customModuleProvider="target" sceneMemberID="viewController">
                     <layoutGuides>
                         <viewControllerLayoutGuide type="top" id="jyV-Pf-zRb"/>
                         <viewControllerLayoutGuide type="bottom" id="2fi-mo-0CV"/>
                     </layoutGuides>
                     <view key="view" contentMode="scaleToFill" id="kh9-bI-dsS">
-                        <rect key="frame" x="0.0" y="0.0" width="600" height="600"/>
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
                         <autoresizingMask key="autoresizingMask" flexibleMaxX="YES" flexibleMaxY="YES"/>
-                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="calibratedWhite"/>
+                        <color key="backgroundColor" red="1" green="1" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
                     </view>
                 </viewController>
                 <placeholder placeholderIdentifier="IBFirstResponder" id="x5A-6p-PRh" sceneMemberID="firstResponder"/>

Example/Example/Supporting Files/Images.xcassets/AppIcon.appiconset/Contents.json

@@ -1,5 +1,15 @@
 {
   "images" : [
+    {
+      "idiom" : "iphone",
+      "size" : "20x20",
+      "scale" : "2x"
+    },
+    {
+      "idiom" : "iphone",
+      "size" : "20x20",
+      "scale" : "3x"
+    },
     {
       "idiom" : "iphone",
       "size" : "29x29",
@@ -29,6 +39,11 @@
       "idiom" : "iphone",
       "size" : "60x60",
       "scale" : "3x"
+    },
+    {
+      "idiom" : "ios-marketing",
+      "size" : "1024x1024",
+      "scale" : "1x"
     }
   ],
   "info" : {

Example/Example/Supporting Files/Images.xcassets/Contents.json

@@ -0,0 +1,6 @@
+{
+  "info" : {
+    "version" : 1,
+    "author" : "xcode"
+  }
+}

Example/Example/Supporting Files/Info.plist

@@ -3,11 +3,11 @@
 <plist version="1.0">
 <dict>
 	<key>CFBundleDevelopmentRegion</key>
-	<string>en</string>
+	<string>en_US</string>
 	<key>CFBundleExecutable</key>
 	<string>$(EXECUTABLE_NAME)</string>
 	<key>CFBundleIdentifier</key>
-	<string>com.sabintsev.$(PRODUCT_NAME:rfc1034identifier)</string>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
 	<key>CFBundleInfoDictionaryVersion</key>
 	<string>6.0</string>
 	<key>CFBundleName</key>
@@ -15,7 +15,7 @@
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.0.0</string>
+	<string>0.0.9</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
@@ -33,6 +33,8 @@
 	<key>UISupportedInterfaceOrientations</key>
 	<array>
 		<string>UIInterfaceOrientationPortrait</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
 	</array>
 </dict>
 </plist>

Example/Example/Supporting Files/ViewController.swift

@@ -19,7 +19,6 @@ class ViewController: UIViewController {
         super.didReceiveMemoryWarning()
         // Dispose of any resources that can be recreated.
     }
-
-
+    
 }
 

Example/Siren/Info.plist

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>FMWK</string>
+	<key>CFBundleShortVersionString</key>
+	<string>0.0.9</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>NSPrincipalClass</key>
+	<string></string>
+	<key>UILaunchStoryboardName</key>
+	<string>LaunchScreen</string>
+	<key>UIMainStoryboardFile</key>
+	<string>Main</string>
+</dict>
+</plist>

Example/Siren/Siren.h

@@ -0,0 +1,17 @@
+//
+//  Siren.h
+//  Siren
+//
+//  Created by Sabintsev, Arthur on 3/4/17.
+//  Copyright © 2017 Sabintsev iOS Projects. All rights reserved.
+//
+
+#import <UIKit/UIKit.h>
+
+//! Project version number for Siren.
+FOUNDATION_EXPORT double SirenVersionNumber;
+
+//! Project version string for Siren.
+FOUNDATION_EXPORT const unsigned char SirenVersionString[];
+
+// In this header, you should import all the public headers of your framework using statements like #import <Siren/PublicHeader.h>

Example/Tests/Info.plist

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>BNDL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+</dict>
+</plist>

Example/Tests/SirenTests.swift

@@ -0,0 +1,795 @@
+//
+//  SirenTests.swift
+//  SirenTests
+//
+//  Created by Arthur Sabintsev on 6/7/16.
+//  Copyright © 2016 Sabintsev iOS Projects. All rights reserved.
+//
+
+import XCTest
+@testable import Siren
+
+final class SirenTests: XCTestCase {
+
+    var siren: Siren = Siren.shared
+
+}
+
+// MARK: - Updates
+
+extension SirenTests {
+
+    func testSingleDigitVersionUpdate() {
+        siren.currentInstalledVersion = "1"
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2"))
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2.0"))
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2.0.0"))
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2.0.0.0"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "0"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "0.9"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "0.0.9"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "0.0.0.9"))
+    }
+
+    func testDoubleDigitVersionUpdate() {
+        siren.currentInstalledVersion = "1.0"
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2"))
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2.0"))
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2.0.0"))
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2.0.0.0"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                         appStoreVersion: "0"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                         appStoreVersion: "0.9"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                         appStoreVersion: "0.0.9"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                         appStoreVersion: "0.0.0.9"))
+    }
+
+    func testTripleDigitVersionUpdate() {
+        siren.currentInstalledVersion = "1.0.0"
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2"))
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2.0"))
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2.0.0"))
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2.0.0.0"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                         appStoreVersion: "0"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                         appStoreVersion: "0.9"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                         appStoreVersion: "0.0.9"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                         appStoreVersion: "0.0.0.9"))
+    }
+
+    func testQuadrupleDigitVersionUpdate() {
+        siren.currentInstalledVersion = "1.0.0"
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2"))
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2.0"))
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2.0.0"))
+
+        XCTAssertTrue(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                        appStoreVersion: "2.0.0.0"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                         appStoreVersion: "0"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                         appStoreVersion: "0.9"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                         appStoreVersion: "0.0.9"))
+
+        XCTAssertFalse(DataParser.isAppStoreVersionNewer(installedVersion: siren.currentInstalledVersion,
+                                                         appStoreVersion: "0.0.0.9"))
+    }
+}
+
+// MARK: - Localization
+
+extension SirenTests {
+
+    func testArabicLocalization() {
+        let language: Localization.Language = .arabic
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "التحديث متوفر")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "المرة التالية")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "تخطى عن هذه النسخة")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "تحديث")
+    }
+
+    func testArmenianLocalization() {
+        let language: Localization.Language = .armenian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Թարմացումը հասանելի Է")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Հաջորդ անգամ")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Բաց թողնել այս տարբերակը")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Թարմացնել")
+    }
+
+    func testBasqueLocalization() {
+        let language: Localization.Language = .basque
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Eguneratzea erabilgarri")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Hurrengo batean")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Bertsio honetatik jauzi egin")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Eguneratu")
+    }
+
+    func testChineseSimplifiedLocalization() {
+        let language: Localization.Language = .chineseSimplified
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "更新可用")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "下一次")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "跳过此版本")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "更新")
+    }
+
+    func testChineseTraditionalLocalization() {
+        let language: Localization.Language = .chineseTraditional
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "有更新可用")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "下次")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "跳過此版本")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "更新")
+    }
+
+    func testCroatianLocalization() {
+        let language: Localization.Language = .croatian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Nova ažuriranje je stigla")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Sljedeći put")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Preskoči ovu verziju")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Ažuriraj")
+    }
+
+    func testCzechLocalization() {
+        let language: Localization.Language = .czech
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Aktualizace dostupná")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Příště")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Přeskočit tuto verzi")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Aktualizovat")
+    }
+
+    func testDanishLocalization() {
+        let language: Localization.Language = .danish
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Tilgængelig opdatering")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Næste gang")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Spring denne version over")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Opdater")
+    }
+
+    func testDutchLocalization() {
+        let language: Localization.Language = .dutch
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Update beschikbaar")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Volgende keer")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Sla deze versie over")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Updaten")
+    }
+
+    func testEstonianLocalization() {
+        let language: Localization.Language = .estonian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Uuendus saadaval")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Järgmisel korral")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Jäta see version vahele")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Uuenda")
+    }
+
+    func testFinnishLocalization() {
+        let language: Localization.Language = .finnish
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Päivitys saatavilla")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Ensi kerralla")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Jätä tämä versio väliin")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Päivitys")
+    }
+
+    func testFrenchLocalization() {
+        let language: Localization.Language = .french
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Mise à jour disponible")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "La prochaine fois")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Sauter cette version")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Mettre à jour")
+    }
+
+    func testGermanLocalization() {
+        let language: Localization.Language = .german
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Update erhältlich")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Später")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Diese Version überspringen")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Update")
+    }
+    
+    func testGreekLocalization() {
+        let language: Localization.Language = .greek
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Διαθέσιμη Ενημέρωση")
+        
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Άλλη φορά")
+        
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Αγνόησε αυτήν την έκδοση")
+        
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Αναβάθμιση")
+    }
+
+    func testHebrewLocalization() {
+        let language: Localization.Language = .hebrew
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "עדכון זמין")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "בפעם הבאה")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "דלג על גרסה זו")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "עדכן")
+    }
+
+    func testHungarianLocalization() {
+        let language: Localization.Language = .hungarian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Új frissítés érhető el")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Később")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Ennél a verziónál ne figyelmeztessen")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Frissítés")
+    }
+
+    func testIndonesianLocalization() {
+        let language: Localization.Language = .indonesian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Pembaruan Tersedia")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Lain kali")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Lewati versi ini")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Perbarui")
+    }
+
+    func testItalianLocalization() {
+        let language: Localization.Language = .italian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Aggiornamento disponibile")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "La prossima volta")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Salta questa versione")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Aggiorna")
+    }
+
+    func testJapaneseLocalization() {
+        let language: Localization.Language = .japanese
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "アップデートのお知らせ")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "次回")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "このバージョンをスキップ")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "アップデート")
+    }
+
+    func testKoreanLocalization() {
+        let language: Localization.Language = .korean
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "업데이트 가능")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "다음에")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "이 버전 건너뜀")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "업데이트")
+    }
+
+    func testLatvianLocalization() {
+        let language: Localization.Language = .latvian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Atjauninājums pieejams")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Nākamreiz")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Izlaist šo versiju")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Atjaunināt")
+    }
+
+    func testLithuanianLocalization() {
+        let language: Localization.Language = .lithuanian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Atnaujinimas")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Kitą kartą")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Praleisti šią versiją")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Atnaujinti")
+    }
+
+    func testMalayLocalization() {
+        let language: Localization.Language = .malay
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Versi Terkini")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Lain kali")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Langkau versi ini")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Muat turun")
+    }
+
+    func testNorwegianLocalization() {
+        let language: Localization.Language = .norwegian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Oppdatering tilgjengelig")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Neste gang")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Hopp over denne versjonen")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Oppdater")
+    }
+
+    func testPersianLocalization() {
+        let language: Localization.Language = .persian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "بروزرسانی در دسترس")
+        
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "دفعه بعد")
+        
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "رد این نسخه")
+        
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "بروزرسانی")
+    }
+    
+    func testPersianAfghanistanLocalization() {
+        let language: Localization.Language = .persianAfghanistan
+        
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "بروزرسانی در دسترس")
+        
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "دگر بار")
+        
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "رد این نسخه")
+        
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "بروزرسانی")
+    }
+    
+    func testPersianIranLocalization() {
+        let language: Localization.Language = .persianIran
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "بروزرسانی در دسترس")
+        
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "دفعه بعد")
+        
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "رد این نسخه")
+        
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "بروزرسانی")
+    }
+    
+    func testPolishLocalization() {
+        let language: Localization.Language = .polish
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Aktualizacja dostępna")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Następnym razem")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Pomiń wersję")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Zaktualizuj")
+    }
+
+    func testPortugueseBrazilLocalization() {
+        let language: Localization.Language = .portugueseBrazil
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Atualização disponível")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Próxima vez")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Ignorar esta versão")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Atualizar")
+    }
+
+    func testPortuguesePortugalLocalization() {
+        let language: Localization.Language = .portuguesePortugal
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Nova actualização disponível")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Próxima vez")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Ignorar esta versão")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Actualizar")
+    }
+
+    func testRussianLocalization() {
+        let language: Localization.Language = .russian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Доступно обновление")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "В следующий раз")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Пропустить эту версию")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Обновить")
+    }
+
+    func testSerbianCyrillicLocalization() {
+        let language: Localization.Language = .serbianCyrillic
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Ажурирање доступно")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Следећи пут")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Прескочи ову верзију")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Ажурирај")
+    }
+
+    func testSerbianLatinLocalization() {
+        let language: Localization.Language = .serbianLatin
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Ažuriranje dostupno")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Sledeći put")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Preskoči ovu verziju")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Ažuriraj")
+    }
+
+    func testSlovenianLocalization() {
+        let language: Localization.Language = .slovenian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Posodobitev aplikacije")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Naslednjič")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Ne želim")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Namesti")
+    }
+
+    func testSpanishLocalization() {
+        let language: Localization.Language = .spanish
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Actualización disponible")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "La próxima vez")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Saltar esta versión")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Actualizar")
+    }
+
+    func testSwedishLocalization() {
+        let language: Localization.Language = .swedish
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Tillgänglig uppdatering")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Nästa gång")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Hoppa över den här versionen")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Uppdatera")
+    }
+
+    func testThaiLocalization() {
+        let language: Localization.Language = .thai
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "มีการอัพเดท")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "ไว้คราวหน้า")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "ข้ามเวอร์ชั่นนี้")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "อัพเดท")
+    }
+
+    func testTurkishLocalization() {
+        let language: Localization.Language = .turkish
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Güncelleme Mevcut")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Daha sonra")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Boşver")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Güncelle")
+    }
+
+    func testUkrainianLocalization() {
+        let language: Localization.Language = .ukrainian
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Доступне Оновлення")
+        
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Наступного разу")
+        
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Пропустити версію")
+        
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Оновити")
+    }
+    
+    func testUrduLocalization() {
+        let language: Localization.Language = .urdu
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "نیا اپڈیٹ")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "اگلی مرتبہ")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "اس ورزن کو چھوڑ دیں")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "اپڈیٹ کریں")
+    }
+    
+    func testVietnameseLocalization() {
+        let language: Localization.Language = .vietnamese
+
+        // Update Available
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update Available", andForceLocalization: language), "Cập nhật mới")
+
+        // Next time
+        XCTAssertEqual(Bundle.localizedString(forKey: "Next time", andForceLocalization: language), "Lần tới")
+
+        // Skip this version
+        XCTAssertEqual(Bundle.localizedString(forKey: "Skip this version", andForceLocalization: language), "Bỏ qua phiên bản này")
+
+        // Update
+        XCTAssertEqual(Bundle.localizedString(forKey: "Update", andForceLocalization: language), "Cập nhật")
+    }
+    
+}

Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "cocoapods"
+gem "jazzy", :git => "https://www.github.com/realm/jazzy.git"
+gem "rubygems-bundler"

Gemfile.lock

@@ -0,0 +1,114 @@
+GIT
+  remote: https://www.github.com/realm/jazzy.git
+  revision: 04b0cd720f6c25c1582939020757b96331e9472f
+  specs:
+    jazzy (0.9.5)
+      cocoapods (~> 1.5.3)
+      mustache (~> 1.1.0)
+      open4
+      redcarpet (~> 3.4.0)
+      rouge (>= 2.0.6, < 4.0)
+      sass (~> 3.6.0)
+      sqlite3 (~> 1.3.13)
+      xcinvoke (~> 0.3.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    CFPropertyList (3.0.0)
+    activesupport (4.2.11)
+      i18n (~> 0.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    atomos (0.1.3)
+    bundler-unload (1.0.2)
+    claide (1.0.2)
+    cocoapods (1.5.3)
+      activesupport (>= 4.0.2, < 5)
+      claide (>= 1.0.2, < 2.0)
+      cocoapods-core (= 1.5.3)
+      cocoapods-deintegrate (>= 1.0.2, < 2.0)
+      cocoapods-downloader (>= 1.2.0, < 2.0)
+      cocoapods-plugins (>= 1.0.0, < 2.0)
+      cocoapods-search (>= 1.0.0, < 2.0)
+      cocoapods-stats (>= 1.0.0, < 2.0)
+      cocoapods-trunk (>= 1.3.0, < 2.0)
+      cocoapods-try (>= 1.1.0, < 2.0)
+      colored2 (~> 3.1)
+      escape (~> 0.0.4)
+      fourflusher (~> 2.0.1)
+      gh_inspector (~> 1.0)
+      molinillo (~> 0.6.5)
+      nap (~> 1.0)
+      ruby-macho (~> 1.1)
+      xcodeproj (>= 1.5.7, < 2.0)
+    cocoapods-core (1.5.3)
+      activesupport (>= 4.0.2, < 6)
+      fuzzy_match (~> 2.0.4)
+      nap (~> 1.0)
+    cocoapods-deintegrate (1.0.3)
+    cocoapods-downloader (1.2.2)
+    cocoapods-plugins (1.0.0)
+      nap
+    cocoapods-search (1.0.0)
+    cocoapods-stats (1.1.0)
+    cocoapods-trunk (1.3.1)
+      nap (>= 0.8, < 2.0)
+      netrc (~> 0.11)
+    cocoapods-try (1.1.0)
+    colored2 (3.1.2)
+    concurrent-ruby (1.1.4)
+    escape (0.0.4)
+    executable-hooks (1.6.0)
+    ffi (1.10.0)
+    fourflusher (2.0.1)
+    fuzzy_match (2.0.4)
+    gh_inspector (1.1.3)
+    i18n (0.9.5)
+      concurrent-ruby (~> 1.0)
+    liferaft (0.0.6)
+    minitest (5.11.3)
+    molinillo (0.6.6)
+    mustache (1.1.0)
+    nanaimo (0.2.6)
+    nap (1.1.0)
+    netrc (0.11.0)
+    open4 (1.3.4)
+    rb-fsevent (0.10.3)
+    rb-inotify (0.10.0)
+      ffi (~> 1.0)
+    redcarpet (3.4.0)
+    rouge (3.3.0)
+    ruby-macho (1.4.0)
+    rubygems-bundler (1.4.5)
+      bundler-unload (>= 1.0.2)
+      executable-hooks (>= 1.5.0)
+    sass (3.6.0)
+      sass-listen (~> 4.0.0)
+    sass-listen (4.0.0)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+    sqlite3 (1.3.13)
+    thread_safe (0.3.6)
+    tzinfo (1.2.5)
+      thread_safe (~> 0.1)
+    xcinvoke (0.3.0)
+      liferaft (~> 0.0.6)
+    xcodeproj (1.8.1)
+      CFPropertyList (>= 2.3.3, < 4.0)
+      atomos (~> 0.1.3)
+      claide (>= 1.0.2, < 2.0)
+      colored2 (~> 3.1)
+      nanaimo (~> 0.2.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  cocoapods
+  jazzy!
+  rubygems-bundler
+
+BUNDLED WITH
+   1.17.3

Package.swift

@@ -0,0 +1,5 @@
+import PackageDescription
+
+let package = Package(
+  name: "Siren"
+)

README.md

@@ -1,187 +1,198 @@
-# Siren
+# Siren 🚨
 
-### Notify users when a new version of your app is available, and prompt them with the App Store link.
+### Notify users when a new version of your app is available and prompt them to upgrade.
+
+[![Travis CI Status](https://travis-ci.org/ArtSabintsev/Siren.svg?branch=master)](https://travis-ci.org/ArtSabintsev/Siren) ![Documentation](https://github.com/ArtSabintsev/Siren/blob/master/docs/badge.svg) ![Swift Support](https://img.shields.io/badge/Swift-4.2%2C%204.1%2C%203.2%2C%203.1%202.3-orange.svg) [![CocoaPods](https://img.shields.io/cocoapods/v/Siren.svg)](https://cocoapods.org/pods/Siren)  [![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) [![SwiftPM Compatible](https://img.shields.io/badge/SwiftPM-compatible-brightgreen.svg)](https://swift.org/package-manager/)
 
 ---
-### About
+
+# Table of Contents
+- [**Meta**](https://github.com/ArtSabintsev/Siren#meta)
+	- [About](https://github.com/ArtSabintsev/Siren#about)
+	- [Features](https://github.com/ArtSabintsev/Siren#features)
+	- [Screenshots](https://github.com/ArtSabintsev/Siren#screenshots)
+ 	- [Ports](https://github.com/ArtSabintsev/Siren#ports)
+- [**Installation and Integration**](https://github.com/ArtSabintsev/Siren#installation-and-integration)
+	- [Installation Instructions](https://github.com/ArtSabintsev/Siren#installation-instructions)
+	- [Implementation Examples](https://github.com/ArtSabintsev/Siren#implementation-examples)
+- [**Device-Specific Checks**](https://github.com/ArtSabintsev/Siren#device-specific-checks)
+	- [Localization](https://github.com/ArtSabintsev/Siren#localization)
+	- [Device Compatibility](https://github.com/ArtSabintsev/Siren#device-compatibility)
+- [**Testing**](https://github.com/ArtSabintsev/Siren#testing)
+	- [Testing Siren Locally](https://github.com/ArtSabintsev/Siren#testing-siren-locally)
+	- [Words of Caution](https://github.com/ArtSabintsev/Siren#words-of-caution)
+- [**App Submission**](https://github.com/ArtSabintsev/Siren#app-submission)
+	- [App Store Review](https://github.com/ArtSabintsev/Siren#app-store-review)
+	- [Phased Releases](https://github.com/ArtSabintsev/Siren#phased-releases)
+- [**Attribution**](https://github.com/ArtSabintsev/Siren#attribution)
+	- [Special Thanks](https://github.com/ArtSabintsev/Siren#special-thanks)
+	- [Creator](https://github.com/ArtSabintsev/Siren#creator)
+
+---
+
+# Meta
+
+## About
 **Siren** checks a user's currently installed version of your iOS app against the version that is currently available in the App Store.
 
-If a new version is available, an alert can be presented to the user informing them of the newer version, and giving them the option to update the application. Alternatively, Siren can notify your app programmatically, enabling you to inform the user through alternative means, such as a custom interface.
+If a new version is available, a language localized alert can be presented to the user informing them of the newer version, and giving them the option to update the application. Alternatively, Siren can notify your app through alternative means, such as a custom user interface.
 
-- Siren is built to work with the [**Semantic Versioning**](http://semver.org/) system.
-- Siren is a Swift language port of [**Harpy**](http://github.com/ArtSabintsev/Harpy), an Objective-C library that achieves the same functionality.
-- Siren is actively maintained by [**Arthur Sabintsev**](http://github.com/ArtSabintsev) and [**Aaron Brager**](http://twitter.com/getaaron).
+Siren is built to work with the [**Semantic Versioning**](https://semver.org/) system.
+  - Canonical Semantic Versioning uses a three number versioning system (e.g., 1.0.0)
+  - Siren also supports two-number versioning (e.g., 1.0) and four-number versioning (e.g., 1.0.0.0)
 
-### Changelog (v0.3.2)
-- Added Polish localization (thanks to [Jędrek Kostecki](https://github.com/jedrekk))
+## Features
 
-### Features
-- [x] CocoaPods Support
-- [x] Support for `UIAlertController` (iOS 8+) and `UIAlertView` (iOS 7)
-- [x] Localized for 19 languages (See **Localization** Section)
-- [x] Three types of alerts (see **Screenshots & Alert Types**)
-- [x] Optional delegate methods (see **Optional Delegate** section)
+### Current Features
+- [x] CocoaPods, Carthage, and Swift Package Manager Support (see [Installation Instructions](https://github.com/ArtSabintsev/Siren#installation-instructions))
+- [x] Three Types of Alerts (see [Screenshots](https://github.com/ArtSabintsev/Siren#screenshots))
+- [x] Highly Customizable Presentation Rules (see [Implementation Examples](https://github.com/ArtSabintsev/Siren#implementation-examples))
+- [x] Localized for 40+ Languages (see [Localization](https://github.com/ArtSabintsev/Siren#localization))
+- [x] Device Compatibility Check (see [Device Compatibility](https://github.com/ArtSabintsev/Siren#device-compatibility))
+- [x] 100% Documentation Coverage (see https://sabintsev.com/Siren)
 
-### Installation Instructions
+### Future Features
+A list of future development work can be found on [Siren's Kanban Board](https://github.com/ArtSabintsev/Siren/projects/1).
 
-#### CocoaPods Installation
+---
+
+## Screenshots
+- The **left picture** forces the user to update the app.
+- The **center picture** gives the user the option to update the app.
+- The **right picture** gives the user the option to skip the current update.
+- These options are controlled by the `Rules.AlertType` enum.
+
+<img src="https://github.com/ArtSabintsev/Siren/blob/master/Assets/picForcedUpdate.png?raw=true" height="480"><img src="https://github.com/ArtSabintsev/Siren/blob/master/Assets/picOptionalUpdate.png?raw=true" height="480"><img src="https://github.com/ArtSabintsev/Siren/blob/master/Assets/picSkippedUpdate.png?raw=true" height="480">
+
+## Ports
+- **Objective-C (iOS)**
+   - [**Harpy**](https://github.com/ArtSabintsev/Harpy)
+   - Siren was ported _from_ Harpy, as Siren and Harpy are maintained by the same developer.
+   - As of December 2018, Harpy has been deprecated in favor of Siren.
+- **Java (Android)**
+   - [**Egghead Games' Siren library**](https://github.com/eggheadgames/Siren)
+   - The Siren Swift library inspired the Java library.
+- **React Native (iOS)**
+   - [**Gant Laborde's Siren library**](https://github.com/GantMan/react-native-siren)
+   - The Siren Swift library inspired the React Native library.
+
+---
+
+# Installation and Integration
+
+## Installation Instructions
+
+| Swift Version |  Branch Name  | Will Continue to Receive Updates?
+| ------------- | ------------- |  -------------
+| 4.2  | master | **Yes**
+| 4.1  | swift4.1 | No
+| 3.2  | swift3.2 | No
+| 3.1  | swift3.1 | No
+| 2.3  | swift2.3 | No  
+
+### CocoaPods
 ```ruby
-pod 'Siren'
+pod 'Siren' # Swift 4.2
+pod 'Siren', :git => 'https://github.com/ArtSabintsev/Siren.git', :branch => 'swift4.1' # Swift 4.1
+pod 'Siren', :git => 'https://github.com/ArtSabintsev/Siren.git', :branch => 'swift3.2' # Swift 3.2
+pod 'Siren', :git => 'https://github.com/ArtSabintsev/Siren.git', :branch => 'swift3.1' # Swift 3.1
+pod 'Siren', :git => 'https://github.com/ArtSabintsev/Siren.git', :branch => 'swift2.3' # Swift 2.3
 ```
 
-- Requires [CocoaPods 0.36 prerelease](http://blog.cocoapods.org/Pod-Authors-Guide-to-CocoaPods-Frameworks/) or later
-- Only for apps with a minimum deployment target of iOS 8.0 or later
-
-    > CocoaPods does not support pods written in Swift on iOS 7. For more information, please see [this issue](https://github.com/CocoaPods/swift/issues/22).
-  
-If your app needs to support iOS 7, use **Manual Installation**.
-
-#### Manual Installation
-
-1. [Download Siren](//github.com/ArtSabintsev/Siren/archive/master.zip).
-2. Copy the `Siren` folder into your project.
-
-### Setup Instructions	
-
-Here's some commented sample code. Adapt this to meet your app's needs.
-
-```Swift
-func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool 
-{
-	/* Siren code should go below window?.makeKeyAndVisible() */
-	
-	// Siren is a singleton
-	let siren = Siren.SharedInstance
-	
-	// Required: Your app's iTunes App Store ID
-	siren.appID = <#Your_App_ID#>
-	
-	// Required on iOS 8: The controller to present the alert from (usually the UIWindow's rootViewController)
-	siren.presentingViewController = window?.rootViewController
-	
-	// Optional: Defaults to .Option
-	siren.alertType = <#SirenAlertType_Enum_Value#>
-	
-	/*
-	    Replace .Immediately with .Daily or .Weekly to specify a maximum daily or weekly frequency for version
-	    checks.
-	*/
-    siren.checkVersion(.Immediately)
-}
-
-func applicationDidBecomeActive(application: UIApplication) 
-{
-	/*
-	    Perform daily (.Daily) or weekly (.Weekly) checks for new version of your app. 
-	    Useful if user returns to your app from the background after extended period of time.
-    	 Place in applicationDidBecomeActive(_:).	*/
-    	 
-    Siren.sharedInstance.checkVersion(.Daily)
-}
-
-func applicationWillEnterForeground(application: UIApplication) 
-{
-   /*
-	    Useful if user returns to your app from the background after being sent to the
-	    App Store, but doesn't update their app before coming back to your app.
-	    
-       ONLY USE WITH SirenAlertType.Force
-   */
-
-    Siren.sharedInstance.checkVersion(.Immediately)
-}
+### Carthage
+```swift
+github "ArtSabintsev/Siren" // Swift 4.2
+github "ArtSabintsev/Siren" "swift4.1" // Swift 4.1
+github "ArtSabintsev/Siren" "swift3.2" // Swift 3.2
+github "ArtSabintsev/Siren" "swift3.1" // Swift 3.1
+github "ArtSabintsev/Siren" "swift2.3" // Swift 2.3
 ```
 
-And you're all set!
+### Swift Package Manager
+```swift
+.Package(url: "https://github.com/ArtSabintsev/Siren.git", majorVersion: 4)
+```
 
-### Screenshots & Alert Types
-
-Siren can force an update, let the user optionally update, and allow the user to skip an update.
-
-To control this behavior, assign a `SirenAlertType` to `alertType` (or one of the specific alert type properties).
- 
-> #### `siren.alertType = .Force`
->
-> Forces the user to update.
->
-> ![Forced Update](https://github.com/ArtSabintsev/Harpy/blob/master/samplePictures/picForcedUpdate.png?raw=true "Forced Update") 
-> ----
-> #### `siren.alertType = .Option`
-> The default behavior. 
-> 
-> ![Optional Update](https://github.com/ArtSabintsev/Harpy/blob/master/samplePictures/picOptionalUpdate.png?raw=true "Optional Update")
-> ----
-> #### `siren.alertType = .Skip`
-> Allows the user to opt out of future reminders for this version.
->
-> ![Skip Update](https://github.com/ArtSabintsev/Harpy/blob/master/samplePictures/picSkippedUpdate.png?raw=true "Optional Update")
-> ----
-> #### `siren.alertType = .None`
->
-> This option doesn't show an alert view. It's useful for skipping Patch, Minor, or Major updates, or for presenting your own UI.
-
-### Prompting for Updates without Alerts
-
-Some developers may want to display a less obtrusive custom interface, like a banner or small icon. To accomplish this, you can disable alert presentation by doing the following:
+## Implementation Examples
+Implementing Siren is as easy as adding two lines of code to your app: 
 
 ```swift
-func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool 
-{
-	...
-	siren.delegate = self
-	siren.alertType = .None
-	...
-}
+import Siren // Line 1
+import UIKit
 
-extension AppDelegate: SirenDelegate
-{
-	// Returns a localized message to this delegate method upon performing a successful version check
-    func sirenDidDetectNewVersionWithoutAlert(message: String) {
-        println("\(message)")
+@UIApplicationMain
+final class AppDelegate: UIResponder, UIApplicationDelegate {
+    var window: UIWindow?
+
+    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
+        window?.makeKeyAndVisible()
+
+	Siren.shared.wail() // Line 2
+
+        return true
     }
 }
 ```
 
-Siren will call the `sirenDidDetectNewVersionWithoutAlert(message: String)` delegate method, passing a localized, suggested update string suitable for display. Implement this method to display your own messaging, optionally using `message`.
+Siren also has plenty of customization options. All examples can be found in the Example Project's [**AppDelegate**](https://github.com/ArtSabintsev/Siren/blob/master/Example/Example/AppDelegate.swift) file. Uncomment the example you'd like to test.
 
-### Differentiated Alerts for Patch, Minor, and Major Updates
-If you would like to set a different type of alert for patch, minor, and/or major updates, simply add one or all of the following *optional* lines to your setup *before* calling the `checkVersion()` method:
+---
+
+# Device-Specific Checks
+
+## Localization
+Siren is localized for the following languages:
+
+Arabic, Armenian, Basque, Chinese (Simplified and Traditional), Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, German, Greek, Hebrew, Hungarian, Indonesian, Italian, Japanese, Korean, Latvian, Lithuanian, Malay, Norwegian (Bokmål), Persian (Afghanistan, Iran, Persian), Polish, Portuguese (Brazil and Portugal), Russian, Serbian (Cyrillic and Latin), Slovenian, Spanish, Swedish, Thai, Turkish, Ukrainian, Urdu, Vietnamese
+
+If your user's device is set to one of the supported locales, an update message will appear in that language. If a locale is not supported, than the message will appear in English.
+
+You may want the update dialog to *always* appear in a certain language, ignoring the user's device-specific setting. You can enable it like so:
 
 ```swift
-	/* Siren defaults to SirenAlertType.Option for all updates */
-	siren.sharedInstance().patchUpdateAlertType = <#SirenAlertType_Enum_Value#>
-	siren.sharedInstance().minorUpdateAlertType = <#SirenAlertType_Enum_Value#>
-	siren.sharedInstance().majorUpdateAlertType = <#SirenAlertType_Enum_Value#>
+// In this example, we force the `Russian` language.
+Siren.shared.presentationManager = PresentationManager(forceLanguageLocalization: .russian)
 ```
 
-### Optional Delegate and Delegate Methods
-Five delegate methods allow you to handle or track the user's behavior:
+## Device Compatibility
+If an app update is available, Siren checks to make sure that the version of iOS on the user's device is compatible with the one that is required by the app update. For example, if a user has iOS 11 installed on their device, but the app update requires iOS 12, an alert will not be shown. This takes care of the *false positive* case regarding app updating.
 
-```	swift
-@objc protocol SirenDelegate {
-    optional func sirenDidShowUpdateDialog() // User presented with update dialog
-    optional func sirenUserDidLaunchAppStore() // User did click on button that launched App Store.app
-    optional func sirenUserDidSkipVersion() // User did click on button that skips version update
-    optional func sirenUserDidCancel()  // User did click on button that cancels update dialog
-    optional func sirenDidDetectNewVersionWithoutAlert(message: String) // Siren performed version check and did not display alert
-}
-```
+---
 
-### Force Localization
-Siren supports 18 languages: Basque, Chinese (Simplified), Chinese (Traditional), Danish, Dutch, English, French, German, Hebrew, Italian, Japanese, Korean, Polish, Portuguese, Russian, Slovenian, Swedish, Spanish, and Turkish.
+# Testing
 
-You may want the update dialog to *always* appear in a certain language, ignoring iOS's language setting (e.g. apps released in a specific country).
+## Testing Siren Locally
+Temporarily change the version string in Xcode (within the `.xcodeproj` file) to an older version than the one that's currently available in the App Store. Afterwards, build and run your app, and you should see the alert.
 
-You can enable it like this:
+If you currently don't have an app in the store, change your bundleID to one that is already in the store. In the sample app packaged with this library, we use the [App Store Connect](https://itunes.apple.com/app/id1234793120) app's bundleID: `com.apple.AppStoreConnect`.
 
-```swift
-Siren.sharedInstance.forceLanguageLocalization = SirenLanguageType.<#SirenLanguageType_Enum_Value#>
-```
-### How to test Siren
-Temporarily change the version string in Xcode to an older version than the one that's currently available in the App Store. Afterwards, build and run your app, and you should see the alert.
+## Words of Caution
+Occasionally, the iTunes JSON will update faster than the App Store CDN, meaning the JSON may state that the new version of the app has been released, while no new binary is made available for download via the App Store. It is for this reason that Siren will, by default, wait 1 day (24 hours) after the JSON has been updated to prompt the user to update. To change the default setting, please modify the value of `showAlertAfterCurrentVersionHasBeenReleasedForDays`.
 
-### App Store Submissions
+---
+
+# App Submission
+
+## App Store Review
 The App Store reviewer will **not** see the alert. The version in the App Store will always be older than the version being reviewed.
 
-### Created and maintained by
-[Arthur Ariel Sabintsev](http://www.sabintsev.com/) & [Aaron Brager](http://twitter.com/getaaron)
+## Phased Releases
+In 2017, Apple announced the [ability to rollout app updates gradually (a.k.a. Phased Releases)](https://itunespartner.apple.com/en/apps/faq/Managing%20Your%20Apps_Submission%20Process). Siren will continue to work as it has in the past, presenting an update modal to _all_ users. If you opt-in to a phased rollout for a specific version, you have a few choices:
+
+- You can leave Siren configured as normal. Phased rollout will continue to auto-update apps. Since all users can still manually update your app directly from the App Store, Siren will ignore the phased rollout and will prompt users to update.
+- You can set `showAlertAfterCurrentVersionHasBeenReleasedForDays` to `7`, and Siren will not prompt any users until the latest version is 7 days old, after the phased rollout is complete.
+- You can remotely disable Siren until the rollout is done using your own API / backend logic.
+
+---
+
+# Attribution 
+
+## Special Thanks
+A massive shout-out and thank you goes to the following folks: 
+
+- [Aaron Brager](https://twitter.com/@getaaron) for motivating me and assisting me in building the initial proof-of-concept of Siren (based on [Harpy](https:github.com/ArtSabintsev/Harpy)) back in 2015. Without him, Siren may never have been built. 
+- All of [Harpy's Contributors](https://github.com/ArtSabintsev/Harpy/graphs/contributors) for helping building the feature set from 2012-2015 that was used as the basis for the first version of Siren.
+- All of [Siren's Contributors](https://github.com/ArtSabintsev/Siren/graphs/contributors) for helping make Siren as powerful and bug-free as it currently is today.
+
+## Creator
+[Arthur Ariel Sabintsev](http://www.sabintsev.com/)

Sample App/Sample App.xcodeproj/project.pbxproj

@@ -1,304 +0,0 @@
-// !$*UTF8*$!
-{
-	archiveVersion = 1;
-	classes = {
-	};
-	objectVersion = 46;
-	objects = {
-
-/* Begin PBXBuildFile section */
-		8E1005E71A5DD02300509B14 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E1005DF1A5DD02300509B14 /* AppDelegate.swift */; };
-		8E1005E81A5DD02300509B14 /* LaunchScreen.xib in Resources */ = {isa = PBXBuildFile; fileRef = 8E1005E01A5DD02300509B14 /* LaunchScreen.xib */; };
-		8E1005E91A5DD02300509B14 /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 8E1005E21A5DD02300509B14 /* Main.storyboard */; };
-		8E1005EA1A5DD02300509B14 /* Images.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 8E1005E41A5DD02300509B14 /* Images.xcassets */; };
-		8E1005EC1A5DD02300509B14 /* ViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E1005E61A5DD02300509B14 /* ViewController.swift */; };
-		8E1005F01A5DD04500509B14 /* Siren.bundle in Resources */ = {isa = PBXBuildFile; fileRef = 8E1005EE1A5DD04500509B14 /* Siren.bundle */; };
-		8E1005F11A5DD04500509B14 /* Siren.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E1005EF1A5DD04500509B14 /* Siren.swift */; };
-/* End PBXBuildFile section */
-
-/* Begin PBXFileReference section */
-		8E1005DF1A5DD02300509B14 /* AppDelegate.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
-		8E1005E11A5DD02300509B14 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.xib; name = Base; path = Base.lproj/LaunchScreen.xib; sourceTree = "<group>"; };
-		8E1005E31A5DD02300509B14 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = "<group>"; };
-		8E1005E41A5DD02300509B14 /* Images.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Images.xcassets; sourceTree = "<group>"; };
-		8E1005E51A5DD02300509B14 /* Info.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
-		8E1005E61A5DD02300509B14 /* ViewController.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ViewController.swift; sourceTree = "<group>"; };
-		8E1005EE1A5DD04500509B14 /* Siren.bundle */ = {isa = PBXFileReference; lastKnownFileType = "wrapper.plug-in"; path = Siren.bundle; sourceTree = "<group>"; };
-		8E1005EF1A5DD04500509B14 /* Siren.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Siren.swift; sourceTree = "<group>"; };
-		8EC391811A58B465001C121E /* Sample App.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "Sample App.app"; sourceTree = BUILT_PRODUCTS_DIR; };
-/* End PBXFileReference section */
-
-/* Begin PBXFrameworksBuildPhase section */
-		8EC3917E1A58B465001C121E /* Frameworks */ = {
-			isa = PBXFrameworksBuildPhase;
-			buildActionMask = 2147483647;
-			files = (
-			);
-			runOnlyForDeploymentPostprocessing = 0;
-		};
-/* End PBXFrameworksBuildPhase section */
-
-/* Begin PBXGroup section */
-		8E1005DE1A5DD02300509B14 /* Sample App */ = {
-			isa = PBXGroup;
-			children = (
-				8E1005ED1A5DD04500509B14 /* Siren */,
-				8E1005DF1A5DD02300509B14 /* AppDelegate.swift */,
-				8E1005E61A5DD02300509B14 /* ViewController.swift */,
-				8E1005E01A5DD02300509B14 /* LaunchScreen.xib */,
-				8E1005E21A5DD02300509B14 /* Main.storyboard */,
-				8E1005E51A5DD02300509B14 /* Info.plist */,
-				8E1005E41A5DD02300509B14 /* Images.xcassets */,
-			);
-			path = "Sample App";
-			sourceTree = "<group>";
-		};
-		8E1005ED1A5DD04500509B14 /* Siren */ = {
-			isa = PBXGroup;
-			children = (
-				8E1005EE1A5DD04500509B14 /* Siren.bundle */,
-				8E1005EF1A5DD04500509B14 /* Siren.swift */,
-			);
-			name = Siren;
-			path = ../../Siren;
-			sourceTree = "<group>";
-		};
-		8EC391781A58B465001C121E = {
-			isa = PBXGroup;
-			children = (
-				8E1005DE1A5DD02300509B14 /* Sample App */,
-				8EC391821A58B465001C121E /* Products */,
-			);
-			sourceTree = "<group>";
-		};
-		8EC391821A58B465001C121E /* Products */ = {
-			isa = PBXGroup;
-			children = (
-				8EC391811A58B465001C121E /* Sample App.app */,
-			);
-			name = Products;
-			sourceTree = "<group>";
-		};
-/* End PBXGroup section */
-
-/* Begin PBXNativeTarget section */
-		8EC391801A58B465001C121E /* Sample App */ = {
-			isa = PBXNativeTarget;
-			buildConfigurationList = 8EC391A01A58B466001C121E /* Build configuration list for PBXNativeTarget "Sample App" */;
-			buildPhases = (
-				8EC3917D1A58B465001C121E /* Sources */,
-				8EC3917E1A58B465001C121E /* Frameworks */,
-				8EC3917F1A58B465001C121E /* Resources */,
-			);
-			buildRules = (
-			);
-			dependencies = (
-			);
-			name = "Sample App";
-			productName = Siren;
-			productReference = 8EC391811A58B465001C121E /* Sample App.app */;
-			productType = "com.apple.product-type.application";
-		};
-/* End PBXNativeTarget section */
-
-/* Begin PBXProject section */
-		8EC391791A58B465001C121E /* Project object */ = {
-			isa = PBXProject;
-			attributes = {
-				LastUpgradeCheck = 0610;
-				ORGANIZATIONNAME = "Sabintsev iOS Projects";
-				TargetAttributes = {
-					8EC391801A58B465001C121E = {
-						CreatedOnToolsVersion = 6.1.1;
-					};
-				};
-			};
-			buildConfigurationList = 8EC3917C1A58B465001C121E /* Build configuration list for PBXProject "Sample App" */;
-			compatibilityVersion = "Xcode 3.2";
-			developmentRegion = English;
-			hasScannedForEncodings = 0;
-			knownRegions = (
-				en,
-				Base,
-			);
-			mainGroup = 8EC391781A58B465001C121E;
-			productRefGroup = 8EC391821A58B465001C121E /* Products */;
-			projectDirPath = "";
-			projectRoot = "";
-			targets = (
-				8EC391801A58B465001C121E /* Sample App */,
-			);
-		};
-/* End PBXProject section */
-
-/* Begin PBXResourcesBuildPhase section */
-		8EC3917F1A58B465001C121E /* Resources */ = {
-			isa = PBXResourcesBuildPhase;
-			buildActionMask = 2147483647;
-			files = (
-				8E1005F01A5DD04500509B14 /* Siren.bundle in Resources */,
-				8E1005EA1A5DD02300509B14 /* Images.xcassets in Resources */,
-				8E1005E81A5DD02300509B14 /* LaunchScreen.xib in Resources */,
-				8E1005E91A5DD02300509B14 /* Main.storyboard in Resources */,
-			);
-			runOnlyForDeploymentPostprocessing = 0;
-		};
-/* End PBXResourcesBuildPhase section */
-
-/* Begin PBXSourcesBuildPhase section */
-		8EC3917D1A58B465001C121E /* Sources */ = {
-			isa = PBXSourcesBuildPhase;
-			buildActionMask = 2147483647;
-			files = (
-				8E1005EC1A5DD02300509B14 /* ViewController.swift in Sources */,
-				8E1005F11A5DD04500509B14 /* Siren.swift in Sources */,
-				8E1005E71A5DD02300509B14 /* AppDelegate.swift in Sources */,
-			);
-			runOnlyForDeploymentPostprocessing = 0;
-		};
-/* End PBXSourcesBuildPhase section */
-
-/* Begin PBXVariantGroup section */
-		8E1005E01A5DD02300509B14 /* LaunchScreen.xib */ = {
-			isa = PBXVariantGroup;
-			children = (
-				8E1005E11A5DD02300509B14 /* Base */,
-			);
-			name = LaunchScreen.xib;
-			sourceTree = "<group>";
-		};
-		8E1005E21A5DD02300509B14 /* Main.storyboard */ = {
-			isa = PBXVariantGroup;
-			children = (
-				8E1005E31A5DD02300509B14 /* Base */,
-			);
-			name = Main.storyboard;
-			sourceTree = "<group>";
-		};
-/* End PBXVariantGroup section */
-
-/* Begin XCBuildConfiguration section */
-		8EC3919E1A58B466001C121E /* Debug */ = {
-			isa = XCBuildConfiguration;
-			buildSettings = {
-				ALWAYS_SEARCH_USER_PATHS = NO;
-				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
-				CLANG_CXX_LIBRARY = "libc++";
-				CLANG_ENABLE_MODULES = YES;
-				CLANG_ENABLE_OBJC_ARC = YES;
-				CLANG_WARN_BOOL_CONVERSION = YES;
-				CLANG_WARN_CONSTANT_CONVERSION = YES;
-				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
-				CLANG_WARN_EMPTY_BODY = YES;
-				CLANG_WARN_ENUM_CONVERSION = YES;
-				CLANG_WARN_INT_CONVERSION = YES;
-				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
-				CLANG_WARN_UNREACHABLE_CODE = YES;
-				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
-				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
-				COPY_PHASE_STRIP = NO;
-				ENABLE_STRICT_OBJC_MSGSEND = YES;
-				GCC_C_LANGUAGE_STANDARD = gnu99;
-				GCC_DYNAMIC_NO_PIC = NO;
-				GCC_OPTIMIZATION_LEVEL = 0;
-				GCC_PREPROCESSOR_DEFINITIONS = (
-					"DEBUG=1",
-					"$(inherited)",
-				);
-				GCC_SYMBOLS_PRIVATE_EXTERN = NO;
-				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
-				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
-				GCC_WARN_UNDECLARED_SELECTOR = YES;
-				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
-				GCC_WARN_UNUSED_FUNCTION = YES;
-				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 8.1;
-				MTL_ENABLE_DEBUG_INFO = YES;
-				ONLY_ACTIVE_ARCH = YES;
-				SDKROOT = iphoneos;
-				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
-			};
-			name = Debug;
-		};
-		8EC3919F1A58B466001C121E /* Release */ = {
-			isa = XCBuildConfiguration;
-			buildSettings = {
-				ALWAYS_SEARCH_USER_PATHS = NO;
-				CLANG_CXX_LANGUAGE_STANDARD = "gnu++0x";
-				CLANG_CXX_LIBRARY = "libc++";
-				CLANG_ENABLE_MODULES = YES;
-				CLANG_ENABLE_OBJC_ARC = YES;
-				CLANG_WARN_BOOL_CONVERSION = YES;
-				CLANG_WARN_CONSTANT_CONVERSION = YES;
-				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
-				CLANG_WARN_EMPTY_BODY = YES;
-				CLANG_WARN_ENUM_CONVERSION = YES;
-				CLANG_WARN_INT_CONVERSION = YES;
-				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
-				CLANG_WARN_UNREACHABLE_CODE = YES;
-				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
-				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
-				COPY_PHASE_STRIP = YES;
-				ENABLE_NS_ASSERTIONS = NO;
-				ENABLE_STRICT_OBJC_MSGSEND = YES;
-				GCC_C_LANGUAGE_STANDARD = gnu99;
-				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
-				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
-				GCC_WARN_UNDECLARED_SELECTOR = YES;
-				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
-				GCC_WARN_UNUSED_FUNCTION = YES;
-				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 8.1;
-				MTL_ENABLE_DEBUG_INFO = NO;
-				SDKROOT = iphoneos;
-				VALIDATE_PRODUCT = YES;
-			};
-			name = Release;
-		};
-		8EC391A11A58B466001C121E /* Debug */ = {
-			isa = XCBuildConfiguration;
-			buildSettings = {
-				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
-				INFOPLIST_FILE = "$(SRCROOT)/Sample App/Info.plist";
-				IPHONEOS_DEPLOYMENT_TARGET = 7.1;
-				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
-				PRODUCT_NAME = "Sample App";
-			};
-			name = Debug;
-		};
-		8EC391A21A58B466001C121E /* Release */ = {
-			isa = XCBuildConfiguration;
-			buildSettings = {
-				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
-				INFOPLIST_FILE = "$(SRCROOT)/Sample App/Info.plist";
-				IPHONEOS_DEPLOYMENT_TARGET = 7.1;
-				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
-				PRODUCT_NAME = "Sample App";
-			};
-			name = Release;
-		};
-/* End XCBuildConfiguration section */
-
-/* Begin XCConfigurationList section */
-		8EC3917C1A58B465001C121E /* Build configuration list for PBXProject "Sample App" */ = {
-			isa = XCConfigurationList;
-			buildConfigurations = (
-				8EC3919E1A58B466001C121E /* Debug */,
-				8EC3919F1A58B466001C121E /* Release */,
-			);
-			defaultConfigurationIsVisible = 0;
-			defaultConfigurationName = Release;
-		};
-		8EC391A01A58B466001C121E /* Build configuration list for PBXNativeTarget "Sample App" */ = {
-			isa = XCConfigurationList;
-			buildConfigurations = (
-				8EC391A11A58B466001C121E /* Debug */,
-				8EC391A21A58B466001C121E /* Release */,
-			);
-			defaultConfigurationIsVisible = 0;
-			defaultConfigurationName = Release;
-		};
-/* End XCConfigurationList section */
-	};
-	rootObject = 8EC391791A58B465001C121E /* Project object */;
-}

Sample App/Sample App/AppDelegate.swift

@@ -1,77 +0,0 @@
-//
-//  AppDelegate.swift
-//  Siren
-//
-//  Created by Arthur Sabintsev on 1/3/15.
-//  Copyright (c) 2015 Sabintsev iOS Projects. All rights reserved.
-//
-
-import UIKit
-
-@UIApplicationMain
-class AppDelegate: UIResponder, UIApplicationDelegate {
-
-    var window: UIWindow?
-
-    func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
-        
-        window?.makeKeyAndVisible()
-        
-        setupSiren()
-
-        return true
-    }
-    
-    func setupSiren() {
-        
-        
-        let siren = Siren.sharedInstance
-        
-        // Required
-        siren.appID = "376771144" // For this example, we're using the iTunes Connect App (https://itunes.apple.com/us/app/itunes-connect/id376771144?mt=8)
-        
-        // Required
-        siren.presentingViewController = window?.rootViewController
-        
-        // Optional
-        siren.delegate = self
-        
-        // Optional
-        siren.debugEnabled = true;
-        
-        // Optional
-        siren.alertType = .Option
-        
-        // Optional
-//        siren.forceLanguageLocalization = .Spanish // Optional: Sets all messages to appear in Spanish. Siren supports many other languages, not just English and Spanish.
-        
-        // Required
-        siren.checkVersion(.Immediately)
-    }
-}
-
-extension AppDelegate: SirenDelegate
-{
-    func sirenDidShowUpdateDialog() {
-        println("sirenDidShowUpdateDialog")
-    }
-    
-    func sirenUserDidCancel() {
-        println("sirenUserDidCancel")
-    }
-    
-    func sirenUserDidSkipVersion() {
-        println("sirenUserDidSkipVersion")
-    }
-    
-    func sirenUserDidLaunchAppStore() {
-        println("sirenUserDidLaunchAppStore")
-    }
-    
-    /**
-        This method is only hit when alertType is initialized to .None
-    */
-    func sirenDidDetectNewVersionWithoutAlert(message: String) {
-        println("\(message)")
-    }
-}

Siren.podspec

@@ -1,23 +1,23 @@
 Pod::Spec.new do |s|
+  # Version
+  s.version       = "4.2.2"
+  s.swift_version = '4.2'
+
+  # Meta
   s.name         = "Siren"
-  s.version      = "0.3.2"
-  s.summary      = "Notify users when a new version of your iOS app is available, and prompt them with the App Store link.."
-
-  s.description  = <<-DESC
-Siren is checks a user’s currently installed version of your iOS app against the version that is currently available in the App Store. If a new version is available, an instance of UIAlertView (iOS 7) or UIAlertController (iOS 8) can be presented to the user informing them of the newer version, and giving them the option to update the application. Alternatively, Siren can notify your app programmatically, enabling you to inform the user through alternative means, such as a custom interface.
-
-Siren is built to work with the Semantic Versioning system.
-Siren is a Swift port of Harpy, an Objective-C library that achieves the same functionality.
-Siren is actively maintained by Arthur Sabintsev and Aaron Brager.
-                   DESC
-
+  s.summary      = "Notify users that a new version of your iOS app is available, and prompt them with the App Store link."
   s.homepage     = "https://github.com/ArtSabintsev/Siren"
   s.license      = "MIT"
-  s.authors      = { "Arthur Sabintsev" => "arthur@sabintsev.com", "Aaron Brager" => "getaaron@gmail.com" }
+  s.authors      = { "Arthur Ariel Sabintsev" => "arthur@sabintsev.com" }
+  s.description  = <<-DESC
+                    Notify your users when a new version of your iOS app is available, and prompt them with the App Store link.
+                   DESC
+
+  # Compatibility & Sources
   s.platform     = :ios, "8.0"
-  s.source       = { :git => "https://github.com/ArtSabintsev/Siren.git", :tag => "0.3.2" }
-  s.source_files = 'Siren/Siren.swift'
-  s.resources    = 'Siren/Siren.bundle'
+  s.source       = { :git => "https://github.com/ArtSabintsev/Siren.git", :tag => s.version.to_s }
+  s.source_files = 'Sources/**/*.swift'
+  s.resources    = 'Sources/Siren.bundle'
   s.requires_arc = true
 
 end

Siren/Siren.swift

@@ -1,622 +0,0 @@
-//
-//  Siren.swift
-//  Siren
-//
-//  Created by Arthur Sabintsev on 1/3/15.
-//  Copyright (c) 2015 Sabintsev iOS Projects. All rights reserved.
-//
-
-import UIKit
-
-// MARK: SirenDelegate Protocol
-@objc protocol SirenDelegate {
-    optional func sirenDidShowUpdateDialog()                            // User presented with update dialog
-    optional func sirenUserDidLaunchAppStore()                          // User did click on button that launched App Store.app
-    optional func sirenUserDidSkipVersion()                             // User did click on button that skips version update
-    optional func sirenUserDidCancel()                                  // User did click on button that cancels update dialog
-    optional func sirenDidDetectNewVersionWithoutAlert(message: String) // Siren performed version check and did not display alert
-}
-
-// MARK: Enumerations
-/**
-    Determines the type of alert to present after a successful version check has been performed.
-    
-    There are four options:
-        - Force: Forces user to update your app (1 button alert)
-        - Option: (DEFAULT) Presents user with option to update app now or at next launch (2 button alert)
-        - Skip: Presents user with option to update the app now, at next launch, or to skip this version all together (3 button alert)
-        - None: Doesn't show the alert, but instead returns a localized message for use in a custom UI within the sirenDidDetectNewVersionWithoutAlert() delegate method
-
-*/
-public enum SirenAlertType
-{
-    case Force        // Forces user to update your app (1 button alert)
-    case Option       // (DEFAULT) Presents user with option to update app now or at next launch (2 button alert)
-    case Skip         // Presents user with option to update the app now, at next launch, or to skip this version all together (3 button alert)
-    case None         // Doesn't show the alert, but instead returns a localized message for use in a custom UI within the sirenDidDetectNewVersionWithoutAlert() delegate method
-}
-
-/**
-    Determines the frequency in which the the version check is performed
-    
-    - .Immediately: Version check performed every time the app is launched
-    - .Daily: Version check performedonce a day
-    - .Weekly: Version check performed once a week
-
-*/
-public enum SirenVersionCheckType : Int
-{
-    case Immediately = 0    // Version check performed every time the app is launched
-    case Daily = 1          // Version check performed once a day
-    case Weekly = 7         // Version check performed once a week
-}
-
-/**
-    Determines the available languages in which the update message and alert button titles should appear.
-    
-    By default, the operating system's default lanuage setting is used. However, you can force a specific language
-    by setting the forceLanguageLocalization property before calling checkVersion()
-    
-    Supported languages:
-        - Basque
-        - ChineseSimplified
-        - ChineseTraditional
-        - Danish
-        - Dutch
-        - English
-        - French
-        - Hebrew
-        - German
-        - Italian
-        - Japanese
-        - Korean
-        - Portuguese
-        - Russian
-        - Slovenian
-        - Spanish
-        - Swedish
-        - Turkish
-
-*/
-public enum SirenLanguageType: String
-{
-    case Basque = "eu"
-    case ChineseSimplified = "zh-Hans"
-    case ChineseTraditional = "zh-Hant"
-    case Danish = "da"
-    case Dutch = "nl"
-    case English = "en"
-    case French = "fr"
-    case Hebrew = "he"
-    case German = "de"
-    case Italian = "it"
-    case Japanese = "ja"
-    case Korean = "ko"
-    case Polish = "pl"
-    case Portuguese = "pt"
-    case Russian = "ru"
-    case Slovenian = "sl"
-    case Spanish = "es"
-    case Swedish = "sv"
-    case Turkish = "tr"
-}
-
-// MARK: Siren
-/**
-    The Siren Class.
-    
-    A singleton that is initialized using the sharedInstance() method.
-*/
-public class Siren: NSObject
-{
-
-    // MARK: Constants    
-    // NSUserDefault key that stores the timestamp of the last version check
-    let sirenDefaultStoredVersionCheckDate = "Siren Stored Date From Last Version Check"
-    
-    // NSUserDefault key that stores the version that a user decided to skip
-    let sirenDefaultSkippedVersion = "Siren User Decided To Skip Version Update"
-    
-    // Current installed version of your app
-    let currentInstalledVersion = NSBundle.mainBundle().currentInstalledVersion()
-    
-    // NSBundle path for localization
-    let bundlePath = NSBundle.mainBundle().pathForResource("Siren", ofType: "Bundle")
-    
-    // MARK: Variables
-    /**
-        The SirenDelegate variable, which should be set if you'd like to be notified:
-    
-            - When a user views or interacts with the alert
-                - sirenDidShowUpdateDialog()
-                - sirenUserDidLaunchAppStore()
-                - sirenUserDidSkipVersion()     
-                - sirenUserDidCancel()
-            - When a new version has been detected, and you would like to present a localized message in a custom UI
-                - sirenDidDetectNewVersionWithoutAlert(message: String)
-    
-    */
-    weak var delegate: SirenDelegate?
-
-    /**
-        The debug flag, which is disabled by default.
-    
-        When enabled, a stream of println() statements are logged to your console when a version check is performed.
-    */
-    lazy var debugEnabled = false
-    
-    // Alert Vars
-    /**
-        Determines the type of alert that should be shown.
-    
-        See the SirenAlertType enum for full details.
-    */
-    var alertType = SirenAlertType.Option
-    
-    /**
-    Determines the type of alert that should be shown for major version updates: A.b.c
-    
-    Defaults to SirenAlertType.Option.
-    
-    See the SirenAlertType enum for full details.
-    */
-    var majorUpdateAlertType = SirenAlertType.Option
-    
-    /**
-    Determines the type of alert that should be shown for minor version updates: a.B.c
-    
-    Defaults to SirenAlertType.Option.
-    
-    See the SirenAlertType enum for full details.
-    */
-    var minorUpdateAlertType  = SirenAlertType.Option
-    
-    /**
-    Determines the type of alert that should be shown for minor patch updates: a.b.C
-    
-    Defaults to SirenAlertType.Option.
-    
-    See the SirenAlertType enum for full details.
-    */
-    var patchUpdateAlertType = SirenAlertType.Option
-    
-    // Required Vars
-    /**
-        The App Store / iTunes Connect ID for your app.
-    */
-    var appID: String?
-    
-    /**
-        The view controller that will present the instance of UIAlertController.
-        
-        It is recommended that you set this value to window?.rootViewController.
-    
-        This property must be set before calling checkVersion().
-    */
-    var presentingViewController: UIViewController?
-    
-    // Optional Vars
-    /**
-        The name of your app. 
-    
-        By default, it's set to the name of the app that's stored in your plist.
-    */
-    lazy var appName: String = (NSBundle.mainBundle().infoDictionary?[kCFBundleNameKey] as? String) ?? ""
-    
-    /**
-        The region or country of an App Store in which your app is available.
-        
-        By default, all version checks are performed against the US App Store.
-        If your app is not available in the US App Store, you should set it to the identifier 
-        of at least one App Store within which it is available.
-    */
-    var countryCode: String?
-    
-    /**
-        Overrides the default localization of a user's device when presenting the update message and button titles in the alert.
-    
-        See the SirenLanguageType enum for more details.
-    */
-    var forceLanguageLocalization: SirenLanguageType?
-    
-    /**
-        Overrides the tint color for UIAlertController.
-    */
-    var alertControllerTintColor: UIColor?
-    
-    // Private
-    private var lastVersionCheckPerformedOnDate: NSDate?
-    private var currentAppStoreVersion: String?
-    
-    // MARK: Initialization
-    public class var sharedInstance: Siren {
-        struct Singleton {
-            static let instance = Siren()
-        }
-        
-        return Singleton.instance
-    }
-    
-    override init() {
-        lastVersionCheckPerformedOnDate = NSUserDefaults.standardUserDefaults().objectForKey(sirenDefaultStoredVersionCheckDate) as? NSDate;
-    }
-    
-    // MARK: Check Version
-    /**
-        Checks the currently installed version of your app against the App Store.
-        The default check is against the US App Store, but if your app is not listed in the US,
-        you should set the `countryCode` property before calling this method. Please refer to the countryCode property for more information.
-    
-        :param: checkType The frequency in days in which you want a check to be performed. Please refer to the SirenVersionCheckType enum for more details.
-    */
-    func checkVersion(checkType: SirenVersionCheckType) {
-        
-        if (appID == nil) {
-            println("[Siren] Please make sure that you have set 'appID' before calling checkVersion.")
-        } else if (useAlertController && presentingViewController == nil) { // iOS 8 only
-            println("[Siren] Please make sure that you have set 'presentingViewController' before calling checkVersion.")
-        } else {
-            if checkType == .Immediately {
-                performVersionCheck()
-            } else {
-                if let lastCheckDate = lastVersionCheckPerformedOnDate {
-                    if daysSinceLastVersionCheckDate() >= checkType.rawValue {
-                        performVersionCheck()
-                    }
-                } else {
-                    performVersionCheck()
-                }
-            }
-        }
-    }
-    
-    private func performVersionCheck() {
-        
-        // Create Request
-        let itunesURL = iTunesURLFromString()
-        let request = NSMutableURLRequest(URL: itunesURL)
-        request.HTTPMethod = "GET"
-        
-        // Perform Request
-        let session = NSURLSession.sharedSession()
-        let task = session.dataTaskWithRequest(request, completionHandler: { (data, response, error) -> Void in
-            
-            if data.length > 0 {
-                
-                // Convert JSON data to Swift Dictionary of type [String : AnyObject]
-                let appData = NSJSONSerialization.JSONObjectWithData(data, options: NSJSONReadingOptions.AllowFragments, error: nil) as? [String: AnyObject]
-                
-                if let appData = appData {
-                    
-                    dispatch_async(dispatch_get_main_queue(), { () -> Void in
-                        
-                        // Print iTunesLookup results from appData
-                        if self.debugEnabled {
-                            println("[Siren] JSON results: \(appData)");
-                        }
-                        
-                        // Process Results (e.g., extract current version on the AppStore)
-                        self.processVersionCheckResults(appData)
-                        
-                    })
-                    
-                } else { // appData == nil
-                    if self.debugEnabled {
-                        println("[Siren] Error retrieving App Store data as data was nil: \(error.localizedDescription)")
-                    }
-                }
-                
-            } else { // data.length == 0
-                if self.debugEnabled {
-                    println("[Siren] Error retrieving App Store data as no data was returned: \(error.localizedDescription)")
-                }
-            }
-        })
-        
-        task.resume()
-    }
-    
-    private func processVersionCheckResults(lookupResults: [String: AnyObject]) {
-        
-        // Store version comparison date
-        self.storeVersionCheckDate()
-
-        let results = lookupResults["results"] as? [[String: AnyObject]]
-        if let results = results {
-            if results.isEmpty == false { // Conditional that avoids crash when app not in App Store or appID mistyped
-                self.currentAppStoreVersion = results[0]["version"] as? String
-                if let currentAppStoreVersion = self.currentAppStoreVersion {
-                    if self.isAppStoreVersionNewer() {
-                        self.showAlertIfCurrentAppStoreVersionNotSkipped()
-                    } else {
-                        if self.debugEnabled {
-                            println("[Siren] App Store version of app is not newer")
-                        }
-                    }
-                } else { // lookupResults["results"][0] does not contain "version" key
-                    if self.debugEnabled {
-                        println("[Siren] Error retrieving App Store verson number as results[0] does not contain a 'version' key")
-                    }
-                }
-            } else { // lookupResults does not contain any data as the returned array is empty
-                if self.debugEnabled {
-                    println("[Siren] Error retrieving App Store verson number as results returns an empty array")
-                }
-            }
-        } else { // lookupResults does not contain any data
-            if self.debugEnabled {
-                println("[Siren] Error retrieving App Store verson number as there was no data returned")
-            }
-        }
-    }
-}
-
-// MARK: Alert
-private extension Siren {
-    func showAlertIfCurrentAppStoreVersionNotSkipped() {
-        
-        self.alertType = self.setAlertType()
-        
-        if let previouslySkippedVersion = NSUserDefaults.standardUserDefaults().objectForKey(sirenDefaultSkippedVersion) as? String {
-            if currentAppStoreVersion! != previouslySkippedVersion {
-                showAlert()
-            }
-        } else {
-            showAlert()
-        }
-    }
-    
-    func showAlert() {
-        
-        let updateAvailableMessage = NSBundle().localizedString("Update Available", forceLanguageLocalization: forceLanguageLocalization)
-        var newVersionMessage = localizedNewVersionMessage();
-        
-        if (useAlertController) { // iOS 8
-            
-            let alertController = UIAlertController(title: updateAvailableMessage, message: newVersionMessage, preferredStyle: .Alert)
-            
-            if let alertControllerTintColor = alertControllerTintColor {
-                alertController.view.tintColor = alertControllerTintColor
-            }
-            
-            switch alertType {
-            case .Force:
-                alertController.addAction(updateAlertAction());
-            case .Option:
-                alertController.addAction(nextTimeAlertAction());
-                alertController.addAction(updateAlertAction());
-            case .Skip:
-                alertController.addAction(nextTimeAlertAction());
-                alertController.addAction(updateAlertAction());
-                alertController.addAction(skipAlertAction());
-            case .None:
-                delegate?.sirenDidDetectNewVersionWithoutAlert?(newVersionMessage)
-            }
-            
-            if alertType != .None {
-                presentingViewController?.presentViewController(alertController, animated: true, completion: nil)
-            }
-            
-        } else { // iOS 7
-            
-            var alertView: UIAlertView?
-            let updateButtonTitle = localizedUpdateButtonTitle()
-            let nextTimeButtonTitle = localizedNextTimeButtonTitle()
-            let skipButtonTitle = localizedSkipButtonTitle()
-            switch alertType {
-            case .Force:
-                alertView = UIAlertView(title: updateAvailableMessage, message: newVersionMessage, delegate: self, cancelButtonTitle: updateButtonTitle)
-            case .Option:
-                alertView = UIAlertView(title: updateAvailableMessage, message: newVersionMessage, delegate: self, cancelButtonTitle: nextTimeButtonTitle)
-                alertView!.addButtonWithTitle(updateButtonTitle)
-            case .Skip:
-                alertView = UIAlertView(title: updateAvailableMessage, message: newVersionMessage, delegate: self, cancelButtonTitle: skipButtonTitle)
-                alertView!.addButtonWithTitle(updateButtonTitle)
-                alertView!.addButtonWithTitle(nextTimeButtonTitle)
-            case .None:
-                delegate?.sirenDidDetectNewVersionWithoutAlert?(newVersionMessage)
-            }
-            
-            if let alertView = alertView {
-                alertView.show()
-            }
-        }
-    }
-    
-    func updateAlertAction() -> UIAlertAction {
-        let title = localizedUpdateButtonTitle()
-        let action = UIAlertAction(title: title, style: .Default) { (alert: UIAlertAction!) -> Void in
-            self.launchAppStore()
-            self.delegate?.sirenUserDidLaunchAppStore?()
-            return
-        }
-        
-        return action
-    }
-    
-    func nextTimeAlertAction() -> UIAlertAction {
-        let title = localizedNextTimeButtonTitle()
-        let action = UIAlertAction(title: title, style: .Default) { (alert: UIAlertAction!) -> Void in
-            self.delegate?.sirenUserDidCancel?()
-            return
-        }
-        
-        return action
-    }
-    
-    func skipAlertAction() -> UIAlertAction {
-        let title = localizedSkipButtonTitle()
-        let action = UIAlertAction(title: title, style: .Default) { (alert: UIAlertAction!) -> Void in
-            self.delegate?.sirenUserDidSkipVersion?()
-            return
-        }
-        
-        return action
-    }
-}
-
-// MARK: Helpers
-private extension Siren {
-    
-    func iTunesURLFromString() -> NSURL {
-        
-        var storeURLString = "https://itunes.apple.com/lookup?id=\(appID!)"
-        
-        if let countryCode = countryCode {
-            storeURLString += "&country=\(countryCode)"
-        }
-        
-        if debugEnabled {
-            println("[Siren] iTunes Lookup URL: \(storeURLString)");
-        }
-        
-        return NSURL(string: storeURLString)!
-    }
-    
-    func daysSinceLastVersionCheckDate() -> Int {
-        let calendar = NSCalendar.currentCalendar()
-        let components = calendar.components(.CalendarUnitDay, fromDate: NSDate(), toDate: lastVersionCheckPerformedOnDate!, options: nil)
-        return components.day
-    }
-    
-    func isAppStoreVersionNewer() -> Bool {
-        
-        var newVersionExists = false
-        
-        if let currentInstalledVersion = self.currentInstalledVersion {
-            if (currentInstalledVersion.compare(currentAppStoreVersion!, options: .NumericSearch) == NSComparisonResult.OrderedAscending) {
-                newVersionExists = true
-            }
-        }
-        
-        return newVersionExists
-    }
-    
-    func storeVersionCheckDate() {
-        lastVersionCheckPerformedOnDate = NSDate()
-        if let lastVersionCheckPerformedOnDate = self.lastVersionCheckPerformedOnDate {
-            NSUserDefaults.standardUserDefaults().setObject(self.lastVersionCheckPerformedOnDate!, forKey: self.sirenDefaultStoredVersionCheckDate)
-            NSUserDefaults.standardUserDefaults().synchronize()
-        }
-    }
-    
-    func setAlertType() -> SirenAlertType {
-        
-        let oldVersion = split(currentInstalledVersion!) {$0 == "."}.map {$0.toInt() ?? 0}
-        let newVersion = split(currentAppStoreVersion!) {$0 == "."}.map {$0.toInt() ?? 0}
-        
-        if oldVersion.count == 3 && newVersion.count == 3 {
-            if newVersion[0] > oldVersion[0] { // A.b.c
-                alertType = majorUpdateAlertType
-            } else if newVersion[1] > oldVersion[1] { // a.B.c
-                alertType = minorUpdateAlertType
-            } else if newVersion[2] > oldVersion[2] { // a.b.C
-                alertType = patchUpdateAlertType
-            }
-        }
-        
-        return alertType
-    }
-    
-    // iOS 8 Compatibility Check
-    var useAlertController: Bool { // iOS 8 check
-        return objc_getClass("UIAlertController") != nil
-    }
-    
-    // Actions
-    func launchAppStore() {
-        let iTunesString =  "https://itunes.apple.com/app/id\(appID!)";
-        let iTunesURL = NSURL(string: iTunesString);
-        UIApplication.sharedApplication().openURL(iTunesURL!);
-    }
-}
-
-// MARK: String Localization
-private extension Siren {
-
-    func localizedNewVersionMessage() -> String {
-        
-        let newVersionMessageToLocalize = "A new version of %@ is available. Please update to version %@ now."
-        var newVersionMessage = NSBundle().localizedString(newVersionMessageToLocalize, forceLanguageLocalization: forceLanguageLocalization)
-        newVersionMessage = String(format: newVersionMessage!, appName, currentAppStoreVersion!)
-        
-        return newVersionMessage!
-    }
-    
-    func localizedUpdateButtonTitle() -> String {
-        return NSBundle().localizedString("Update", forceLanguageLocalization: forceLanguageLocalization)!
-    }
-    
-    func localizedNextTimeButtonTitle() -> String {
-        return NSBundle().localizedString("Next time", forceLanguageLocalization: forceLanguageLocalization)!
-    }
-    
-    func localizedSkipButtonTitle() -> String {
-        return NSBundle().localizedString("Skip this version", forceLanguageLocalization: forceLanguageLocalization)!;
-    }
-}
-
-// MARK: NSBundle Extension
-private extension NSBundle {
-    
-    func currentInstalledVersion() -> String? {
-        return NSBundle.mainBundle().objectForInfoDictionaryKey("CFBundleShortVersionString") as? String
-    }
-
-    func sirenBundlePath() -> String {
-        return NSBundle.mainBundle().pathForResource("Siren", ofType: "bundle") as String!
-    }
-
-    func sirenForcedBundlePath(forceLanguageLocalization: SirenLanguageType) -> String {
-        let path = sirenBundlePath()
-        let name = forceLanguageLocalization.rawValue
-        return NSBundle(path: path)!.pathForResource(name, ofType: "lproj")!
-    }
-
-    func localizedString(stringKey: String, forceLanguageLocalization: SirenLanguageType?) -> String? {
-        var path: String
-        let table = "SirenLocalizable"
-        if let forceLanguageLocalization = forceLanguageLocalization {
-            path = sirenForcedBundlePath(forceLanguageLocalization)
-        } else {
-            path = sirenBundlePath()
-        }
-        
-        return NSBundle(path: path)?.localizedStringForKey(stringKey, value: stringKey, table: table)
-    }
-}
-
-// MARK: UIAlertViewDelegate
-extension Siren: UIAlertViewDelegate
-{
-    public func alertView(alertView: UIAlertView, clickedButtonAtIndex buttonIndex: Int) {
-        
-        switch alertType {
-            
-        case .Force:
-            launchAppStore()
-        case .Option:
-            if buttonIndex == 1 { // Launch App Store.app
-                launchAppStore()
-                self.delegate?.sirenUserDidLaunchAppStore?()
-            } else { // Ask user on next launch
-                self.delegate?.sirenUserDidCancel?()
-            }
-        case .Skip:
-            if buttonIndex == 0 { // Launch App Store.app
-                NSUserDefaults.standardUserDefaults().setObject(currentAppStoreVersion!, forKey: sirenDefaultSkippedVersion)
-                NSUserDefaults.standardUserDefaults().synchronize()
-                self.delegate?.sirenUserDidSkipVersion?()
-            } else if buttonIndex == 1 {
-                launchAppStore()
-                self.delegate?.sirenUserDidLaunchAppStore?()
-            } else if buttonIndex == 2 { // Ask user on next launch
-                self.delegate?.sirenUserDidCancel?()
-            }
-        case .None:
-            if debugEnabled {
-                 println("[Siren] No alert presented due to alertType == .None")
-            }
-        }
-    }
-}

Sources/Extensions/BundleExtension.swift

@@ -0,0 +1,111 @@
+//
+//  BundleExtension.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 3/17/17.
+//  Copyright © 2017 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+// `Bundle` Extension for Siren.
+extension Bundle {
+    /// Constants used in the `Bundle` extension.
+    struct Constants {
+        /// Constant for the `.bundle` file extension.
+        static let bundleExtension = "bundle"
+        /// Constant for `CFBundleDisplayName`.
+        static let displayName = "CFBundleDisplayName"
+        /// Constant for the default US English localization.
+        static let englishLocalization = "en"
+        /// Constant for the project file extension.
+        static let projectExtension = "lproj"
+        /// Constant for `CFBundleShortVersionString`.
+        static let shortVersionString = "CFBundleShortVersionString"
+        /// Constant for the localization table.
+        static let table = "SirenLocalizable"
+    }
+
+    /// Fetches the current verison of the app.
+    ///
+    /// - Returns: The current installed version of the app.
+    final class func version() -> String? {
+        return Bundle.main.object(forInfoDictionaryKey: Constants.shortVersionString) as? String
+    }
+
+    /// Returns the localized string for a given default string.
+    ///
+    /// By default, the English language localization is used.
+    /// If the device's localization is set to another locale, that local's language is used if it's supported by Siren.
+    /// If `forcedLanguage` is set to `true`, the chosen language is shown for all devices, irrespective of their device's localization.
+    ///
+    ///
+    /// - Parameters:
+    ///   - key: The default string used to search the localization table for a specific translation.
+    ///   - forcedLanguage: Returns
+    /// - Returns: The localized string for a given key.
+    final class func localizedString(forKey key: String, andForceLocalization forcedLanguage: Localization.Language?) -> String {
+        guard var path = sirenBundlePath() else {
+            return key
+        }
+
+        if let deviceLangauge = deviceLanguage(),
+            let devicePath = sirenForcedBundlePath(forceLanguageLocalization: deviceLangauge) {
+            path = devicePath
+        }
+
+        if let forcedLanguage = forcedLanguage,
+            let forcedPath = sirenForcedBundlePath(forceLanguageLocalization: forcedLanguage) {
+            path = forcedPath
+        }
+
+        return Bundle(path: path)?.localizedString(forKey: key, value: key, table: Constants.table) ?? key
+    }
+
+    /// The appropriate name for the app to be displayed in the update alert.
+    ///
+    /// Siren checks `CFBundleDisplayName` first. It then falls back to
+    /// to `kCFBundleNameKey` and ultimately to an empty string
+    /// if the aforementioned values are nil.
+    ///
+    /// - Returns: The name of the app.
+    final class func bestMatchingAppName() -> String {
+        let bundleDisplayName = Bundle.main.object(forInfoDictionaryKey: Constants.displayName) as? String
+        let bundleName = Bundle.main.object(forInfoDictionaryKey: kCFBundleNameKey as String) as? String
+
+        return bundleDisplayName ?? bundleName ?? ""
+    }
+}
+
+private extension Bundle {
+    /// The path to Siren's localization `Bundle`.
+    ///
+    /// - Returns: The bundle's path or `nil`.
+    final class func sirenBundlePath() -> String? {
+        return Bundle(for: Siren.self).path(forResource: "\(Siren.self)", ofType: Constants.bundleExtension)
+    }
+
+    /// The path for a particular language localizationin Siren's localization `Bundle`.
+    ///
+    /// - Parameter forceLanguageLocalization: The language localization that should be searched for in Siren's localization `bundle`.
+    /// - Returns: The path to the forced language localization.
+    final class func sirenForcedBundlePath(forceLanguageLocalization: Localization.Language) -> String? {
+        guard let path = sirenBundlePath() else { return nil }
+        let name = forceLanguageLocalization.rawValue
+
+        return Bundle(path: path)?.path(forResource: name, ofType: Constants.projectExtension)
+    }
+
+    /// The user's preferred language based on their device's localization.
+    ///
+    /// - Returns: The user's preferred language.
+    final class func deviceLanguage() -> Localization.Language? {
+        guard let preferredLocalization = Bundle.main.preferredLocalizations.first,
+            preferredLocalization != Constants.englishLocalization,
+            let preferredLanguage = Localization.Language(rawValue: preferredLocalization) else {
+                return nil
+        }
+
+        return preferredLanguage
+    }
+}

Sources/Extensions/DateExtension.swift

@@ -0,0 +1,38 @@
+//
+//  DateExtension.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 3/21/17.
+//  Copyright © 2017 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+// `Date` Extension for Siren.
+extension Date {
+    /// The amount of days passed from a specific source date.
+    ///
+    /// - Parameter date: The source date.
+    /// - Returns: The amount of days passed since the source date.
+    static func days(since date: Date) -> Int {
+        let calendar = Calendar.current
+        let components = calendar.dateComponents([.day], from: date, to: Date())
+        return components.day ?? 0
+    }
+
+    /// The amount of days passed from a specific source date string.
+    ///
+    /// - Parameter dateString: The source date string.
+    /// - Returns: The amount of days passed since the source date.
+    static func days(since dateString: String) -> Int? {
+        let dateformatter = DateFormatter()
+        dateformatter.locale = Locale(identifier: "en_US_POSIX")
+        dateformatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ss'Z'"
+
+        guard let releaseDate = dateformatter.date(from: dateString) else {
+            return nil
+        }
+
+        return days(since: releaseDate)
+    }
+}

Sources/Extensions/UIAlertControllerExtension.swift

@@ -0,0 +1,27 @@
+//
+//  UIAlertControllerExtension.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 3/17/17.
+//  Copyright © 2017 Sabintsev iOS Projects. All rights reserved.
+//
+
+import UIKit
+
+// `UIAlertController` Extension for Siren.
+extension UIAlertController {
+    /// Presents Siren's `UIAlertController` in a new `UIWindow`.
+    ///
+    /// - Parameter window: The `UIWindow` that _should_ reference Siren's `UIAlertController`.
+    func show(window: UIWindow) {
+        window.makeKeyAndVisible()
+        window.rootViewController?.present(self, animated: true, completion: nil)
+    }
+
+    /// Hides Siren's `UIAlertController` within a given window.
+    ///
+    /// - Parameter window: The `UIWindow` that references Siren's `UIAlertController`.
+    func hide(window: UIWindow) {
+        window.isHidden = true
+    }
+}

Sources/Extensions/UserDefaultsExtension.swift

@@ -0,0 +1,43 @@
+//
+//  UserDefaultsExtension.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 9/25/18.
+//  Copyright © 2018 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+// `UserDefaults` Extension for Siren.
+extension UserDefaults {
+    /// Siren-specific `UserDefaults` Keys
+    private enum SirenKeys: String {
+        /// Key that notifies Siren to perform a version check and present
+        /// the Siren alert the next time the user launches the app.
+        case PerformVersionCheckOnSubsequentLaunch
+
+        /// Key that stores the timestamp of the last version check.
+        case StoredVersionCheckDate
+
+        /// Key that stores the version that a user decided to skip.
+        case StoredSkippedVersion
+    }
+
+    /// Sets and Gets a `UserDefault` around storing a version that the user wants to skip updating.
+    static var storedSkippedVersion: String? {
+        get {
+            return standard.string(forKey: SirenKeys.StoredSkippedVersion.rawValue)
+        } set {
+            standard.set(newValue, forKey: SirenKeys.StoredSkippedVersion.rawValue)
+        }
+    }
+
+    /// Sets and Gets a `UserDefault` around the last time the user was presented a version update alert.
+    static var alertPresentationDate: Date? {
+        get {
+            return standard.object(forKey: SirenKeys.StoredVersionCheckDate.rawValue) as? Date
+        } set {
+            standard.set(newValue, forKey: SirenKeys.StoredVersionCheckDate.rawValue)
+        }
+    }
+}

Sources/Managers/APIManager.swift

@@ -0,0 +1,131 @@
+//
+//  APIManager.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 11/24/18.
+//  Copyright © 2018 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+/// APIManager for Siren
+public struct APIManager {
+    /// Constants used in the `APIManager`.
+    private struct Constants {
+        /// Constant for the `bundleId` parameter in the iTunes Lookup API request.
+        static let bundleID = "bundleId"
+        /// Constant for the `country` parameter in the iTunes Lookup API request.
+        static let country = "country"
+    }
+
+    /// Return results or errors obtained from performing a version check with Siren.
+    typealias CompletionHandler = (LookupModel?, KnownError?) -> Void
+
+    /// The region or country of an App Store in which the app is available.
+    /// By default, all version check requests are performed against the US App Store.
+    /// If the app is not available in the US App Store, set it to the identifier of at least one App Store region within which it is available.
+    ///
+    /// [List of country codes](https://help.apple.com/app-store-connect/#/dev997f9cf7c)
+    ///
+    let countryCode: String?
+
+    /// Initializes `APIManager` to the region or country of an App Store in which the app is available.
+    /// By default, all version check requests are performed against the US App Store.
+    /// If the app is not available in the US App Store, set it to the identifier of at least one App Store region within which it is available.
+    ///
+    /// [List of country codes](https://help.apple.com/app-store-connect/#/dev997f9cf7c)
+    ///
+    /// - Parameter countryCode: The country code for the App Store in which the app is availabe. Defaults to nil (e.g., the US App Store)
+    public init(countryCode: String? = nil) {
+        self.countryCode = countryCode
+    }
+
+    /// The default `APIManager`.
+    ///
+    /// The version check is performed against the  US App Store.
+    public static let `default` = APIManager()
+}
+
+extension APIManager {
+    /// Creates and performs a URLRequest against the iTunes Lookup API.
+    ///
+    /// - Parameter handler: The completion handler for the iTunes Lookup API request.
+    func performVersionCheckRequest(completion handler: CompletionHandler?) {
+        guard Bundle.main.bundleIdentifier != nil else {
+            handler?(nil, .missingBundleID)
+            return
+        }
+
+        do {
+            let url = try makeITunesURL()
+            let request = URLRequest(url: url, cachePolicy: .reloadIgnoringLocalAndRemoteCacheData, timeoutInterval: 30)
+            URLSession.shared.dataTask(with: request) { (data, response, error) in
+                URLCache.shared.removeCachedResponse(for: request)
+                self.processVersionCheckResults(withData: data, response: response, error: error, completion: handler)
+            }.resume()
+        } catch {
+            handler?(nil, .malformedURL)
+        }
+    }
+
+    /// Parses and maps the the results from the iTunes Lookup API request.
+    ///
+    /// - Parameters:
+    ///   - data: The JSON data returned from the request.
+    ///   - response: The response metadata returned from the request.
+    ///   - error: The error returned from the request.
+    ///   - handler: The completion handler to call once the results of the request has been processed.
+    private func processVersionCheckResults(withData data: Data?,
+                                            response: URLResponse?,
+                                            error: Error?,
+                                            completion handler: CompletionHandler?) {
+        if let error = error {
+            handler?(nil, .appStoreDataRetrievalFailure(underlyingError: error))
+        } else {
+            guard let data = data else {
+                handler?(nil, .appStoreDataRetrievalFailure(underlyingError: nil))
+                return
+            }
+            do {
+                let lookupModel = try JSONDecoder().decode(LookupModel.self, from: data)
+
+                guard !lookupModel.results.isEmpty else {
+                    handler?(nil, .appStoreDataRetrievalEmptyResults)
+                    return
+                }
+
+                DispatchQueue.main.async {
+                    handler?(lookupModel, nil)
+                }
+            } catch {
+                handler?(nil, .appStoreJSONParsingFailure(underlyingError: error))
+            }
+        }
+    }
+
+    /// Creates the URL that points to the iTunes Lookup API.
+    ///
+    /// - Returns: The iTunes Lookup API URL.
+    /// - Throws: An error if the URL cannot be created.
+    private func makeITunesURL() throws -> URL {
+        var components = URLComponents()
+        components.scheme = "https"
+        components.host = "itunes.apple.com"
+        components.path = "/lookup"
+
+        var items: [URLQueryItem] = [URLQueryItem(name: Constants.bundleID, value: Bundle.main.bundleIdentifier)]
+
+        if let countryCode = countryCode {
+            let item = URLQueryItem(name: Constants.country, value: countryCode)
+            items.append(item)
+        }
+
+        components.queryItems = items
+
+        guard let url = components.url, !url.absoluteString.isEmpty else {
+            throw KnownError.malformedURL
+        }
+
+        return url
+    }
+}

Sources/Managers/PresentationManager.swift

@@ -0,0 +1,225 @@
+//
+//  PresentationManager.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 12/6/17.
+//  Copyright © 2017 Sabintsev iOS Projects. All rights reserved.
+//
+
+import UIKit
+
+/// PresentationManager for Siren
+public struct PresentationManager {
+    /// Return results or errors obtained from performing a version check with Siren.
+    typealias CompletionHandler = (AlertAction) -> Void
+
+    /// The localization data structure that will be used to construct localized strings for the update alert.
+    let localization: Localization
+
+    /// The tint color of the `UIAlertController` buttons.
+    let tintColor: UIColor?
+
+    /// The descriptive update message of the `UIAlertController`.
+    let alertMessage: String
+
+    /// The main message of the `UIAlertController`.
+    let alertTitle: String
+
+    /// The "Next time" button text of the `UIAlertController`.
+    let nextTimeButtonTitle: String
+
+    /// The "Skip this version" button text of the `UIAlertController`.
+    let skipButtonTitle: String
+
+    /// The "Update" button text of the `UIAlertController`.
+    let updateButtonTitle: String
+
+    /// The instance of the `UIAlertController` used to present the update alert.
+    var alertController: UIAlertController?
+
+    /// The `UIWindow` instance that presents the `SirenViewController`.
+    private var updaterWindow: UIWindow {
+        let window = UIWindow(frame: UIScreen.main.bounds)
+        window.rootViewController = SirenViewController()
+        window.windowLevel = UIWindow.Level.alert + 1
+        return window
+    }
+
+    /// `PresentationManager`'s public initializer.
+    ///
+    /// - Parameters:
+    ///     - tintColor: The alert's tintColor. Settings this to `nil` defaults to the system default color.
+    ///     - appName: The name of the app (overrides the default/bundled name).
+    ///     - alertTitle: The title field of the `UIAlertController`.
+    ///     - alertMessage: The `message` field of the `UIAlertController`.
+    ///     - nextTimeButtonTitle: The `title` field of the Next Time Button `UIAlertAction`.
+    ///     - skipButtonTitle: The `title` field of the Skip Button `UIAlertAction`.
+    ///     - updateButtonTitle: The `title` field of the Update Button `UIAlertAction`.
+    ///     - forceLanguage: The language the alert to which the alert should be set. If `nil`, it falls back to the device's preferred locale.
+    public init(alertTintColor tintColor: UIColor? = nil,
+                appName: String? = nil,
+                alertTitle: String  = AlertConstants.alertTitle,
+                alertMessage: String  = AlertConstants.alertMessage,
+                updateButtonTitle: String  = AlertConstants.updateButtonTitle,
+                nextTimeButtonTitle: String  = AlertConstants.nextTimeButtonTitle,
+                skipButtonTitle: String  = AlertConstants.skipButtonTitle,
+                forceLanguageLocalization forceLanguage: Localization.Language? = nil) {
+        self.alertTitle = alertTitle
+        self.alertMessage = alertMessage
+        self.localization = Localization(appName: appName, andForceLanguageLocalization: forceLanguage)
+        self.nextTimeButtonTitle = nextTimeButtonTitle
+        self.updateButtonTitle = updateButtonTitle
+        self.skipButtonTitle = skipButtonTitle
+        self.tintColor = tintColor
+    }
+
+    /// The default `PresentationManager`.
+    ///
+    /// By default:
+    /// - There is no tint color (defaults to Apple's system `blue` color.)
+    /// - The name of the app is equal to the name that appears in `Info.plist`.
+    /// - The strings are all set to that of the user's device localization (if supported) or it falls back to English.
+    public static let `default` = PresentationManager()
+}
+
+extension PresentationManager {
+
+    /// Constructs the localized update alert `UIAlertController` object.
+    ///
+    /// - Parameters:
+    ///   - rules: The rules that are used to define the type of alert that should be presented.
+    ///   - currentAppStoreVersion: The current version of the app in the App Store.
+    ///   - handler: The completion handler that returns the an `AlertAction` depending on the type of action the end-user took.
+    mutating func presentAlert(withRules rules: Rules,
+                               forCurrentAppStoreVersion currentAppStoreVersion: String,
+                               completion handler: CompletionHandler?) {
+        UserDefaults.alertPresentationDate = Date()
+
+        // Alert Title
+        let alertTitle: String
+        if self.alertTitle == AlertConstants.alertTitle {
+            alertTitle = localization.alertTitle()
+        } else {
+            alertTitle = self.alertTitle
+        }
+
+        // Alert Message
+        let alertMessage: String
+        if self.alertMessage == AlertConstants.alertMessage {
+            alertMessage = localization.alertMessage(forCurrentAppStoreVersion: currentAppStoreVersion)
+        } else {
+            alertMessage = self.alertMessage
+        }
+
+        alertController = UIAlertController(title: alertTitle,
+                                            message: alertMessage,
+                                            preferredStyle: .alert)
+
+        if let tintColor = tintColor {
+            alertController?.view.tintColor = tintColor
+        }
+
+        switch rules.alertType {
+        case .force:
+            alertController?.addAction(updateAlertAction(completion: handler))
+        case .option:
+
+            alertController?.addAction(updateAlertAction(completion: handler))
+            alertController?.addAction(nextTimeAlertAction(completion: handler))
+        case .skip:
+            alertController?.addAction(updateAlertAction(completion: handler))
+            alertController?.addAction(nextTimeAlertAction(completion: handler))
+            alertController?.addAction(skipAlertAction(forCurrentAppStoreVersion: currentAppStoreVersion, completion: handler))
+        case .none:
+            handler?(.unknown)
+        }
+
+        // If the alertType is .none, an alert will not be presented.
+        // If the `updaterWindow` is not hidden, then an alert is already presented.
+        // The latter prevents `UIAlertControllers` from appearing on top of each other.
+        if rules.alertType != .none && updaterWindow.isHidden {
+            alertController?.show(window: updaterWindow)
+
+        }
+    }
+
+    /// The `UIAlertAction` that is executed when the `Update` option is selected.
+    ///
+    /// - Parameters:
+    ///   - handler: The completion handler that returns the `.update` option.
+    /// - Returns: The `Update` alert action.
+    private func updateAlertAction(completion handler: CompletionHandler?) -> UIAlertAction {
+        let title: String
+        if self.updateButtonTitle == AlertConstants.updateButtonTitle {
+            title = localization.updateButtonTitle()
+        } else {
+            title = self.updateButtonTitle
+        }
+
+        let action = UIAlertAction(title: title, style: .default) { _ in
+            self.cleanUpAlertController()
+            Siren.shared.launchAppStore()
+
+            handler?(.appStore)
+            return
+        }
+
+        return action
+    }
+
+    /// The `UIAlertAction` that is executed when the `Next time` option is selected.
+    ///
+    /// - Parameters:
+    ///   - handler: The completion handler that returns the `.nextTime` option.
+    /// - Returns: The `Next time` alert action.
+    private func nextTimeAlertAction(completion handler: CompletionHandler?) -> UIAlertAction {
+        let title: String
+        if self.nextTimeButtonTitle == AlertConstants.nextTimeButtonTitle {
+            title = localization.nextTimeButtonTitle()
+        } else {
+            title = self.nextTimeButtonTitle
+        }
+
+        let action = UIAlertAction(title: title, style: .default) { _ in
+            self.cleanUpAlertController()
+
+            handler?(.nextTime)
+            return
+        }
+
+        return action
+    }
+
+    /// The `UIAlertAction` that is executed when the `Skip this version` option is selected.
+    ///
+    /// - Parameters:
+    ///   - currentAppStoreVersion: The current version of the app in the App Store.
+    ///   - handler: The completion handler that returns the `.skip` option.
+    /// - Returns: The `Skip this version` alert action.
+    private func skipAlertAction(forCurrentAppStoreVersion currentAppStoreVersion: String, completion handler: CompletionHandler?) -> UIAlertAction {
+        let title: String
+        if self.skipButtonTitle == AlertConstants.skipButtonTitle {
+            title = localization.skipButtonTitle()
+        } else {
+            title = self.skipButtonTitle
+        }
+
+        let action = UIAlertAction(title: title, style: .default) { _ in
+            UserDefaults.storedSkippedVersion = currentAppStoreVersion
+            UserDefaults.standard.synchronize()
+
+            self.cleanUpAlertController()
+
+            handler?(.skip)
+            return
+        }
+
+        return action
+    }
+
+    /// Removes the `alertController` from memory.
+    private func cleanUpAlertController() {
+        alertController?.hide(window: self.updaterWindow)
+        alertController?.dismiss(animated: false, completion: nil)
+    }
+}

Sources/Managers/RulesManager.swift

@@ -0,0 +1,125 @@
+//
+//  RulesManager.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 12/1/18.
+//  Copyright © 2018 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+/// RulesManager for Siren
+public struct RulesManager {
+    /// The alert will only show up if the current version has already been released for X days.
+    ///
+    /// This value defaults to 1 day (in `RulesManager`'s initializer) to avoid an issue where
+    /// Apple updates the JSON faster than the app binary propogates to the App Store.
+    let releasedForDays: Int
+
+    /// The `Rules` that should be used when the App Store version of the app signifies that it is a **major** version update (A.b.c.d).
+    var majorUpdateRules: Rules
+
+    /// The `Rules` that should be used when the App Store version of the app signifies that it is a **minor** version update (a.B.c.d).
+    var minorUpdateRules: Rules
+
+    /// The `Rules` that should be used when the App Store version of the app signifies that it is a **patch** version update (a.b.C.d).
+    var patchUpdateRules: Rules
+
+    /// The `Rules` that should be used when the App Store version of the app signifies that it is a **revision** version update (a.b.c.D).
+    var revisionUpdateRules: Rules
+
+    /// Initializer that sets update-specific `Rules` for all updates (e.g., major, minor, patch, revision).
+    /// This means that each of the four update types can have their own specific update rules.
+    ///
+    /// By default, the `releasedForDays` parameter delays the update alert from being presented for _1 day_
+    /// to avoid an issue where the _iTunes Lookup_ API response is updated faster than the time it takes for the binary
+    /// to become available on App Store CDNs across all regions. Usually it takes 6-24 hours, hence the _1 day_ delay.
+    ///
+    /// - Warning: Setting `releasedForDays` to _0 days_ causes the alert to appear right away, even if the binary isn't available.
+    /// If this value is set to _0 days_, and an `AlertType` of type `.force` is set, it will cause your app to infinitely send the
+    /// end-user to the App Store to download a version that's not there and lock them out of your application until the binary is
+    /// is available to be downloaded.
+    ///
+    /// - Parameters:
+    ///   - rules: The rules that should be set for all version updates.
+    ///   - releasedForDays: The amount of time (in days) that the app should delay before presenting the user
+    public init(majorUpdateRules: Rules = .default,
+                minorUpdateRules: Rules = .default,
+                patchUpdateRules: Rules = .default,
+                revisionUpdateRules: Rules = .default,
+                showAlertAfterCurrentVersionHasBeenReleasedForDays releasedForDays: Int = 1) {
+        self.majorUpdateRules = majorUpdateRules
+        self.minorUpdateRules = minorUpdateRules
+        self.patchUpdateRules = patchUpdateRules
+        self.revisionUpdateRules = revisionUpdateRules
+        self.releasedForDays = releasedForDays
+    }
+
+    /// Initializer that sets the same update `Rules` for all types of updates (e.g., major, minor, patch, revision).
+    /// This means that all four update types will use the same presentation rules.
+    ///
+    /// By default, the `releasedForDays` parameter delays the update alert from being presented for _1 day_
+    /// to avoid an issue where the _iTunes Lookup_ API response is updated faster than the time it takes for the binary
+    /// to become available on App Store CDNs across all regions. Usually it takes 6-24 hours, hence the _1 day_ delay.
+    ///
+    /// - Warning: Setting `releasedForDays` to _0 days_ causes the alert to appear right away, even if the binary isn't available.
+    /// If this value is set to _0 days_, and an `AlertType` of type `.force` is set, it will cause your app to infinitely send the
+    /// end-user to the App Store to download a version that's not there and lock them out of your application until the binary is
+    /// is available to be downloaded.
+    ///
+    /// - Parameters:
+    ///   - rules: The rules that should be set for all version updates.
+    ///   - releasedForDays: The amount of time (in days) that the app should delay before presenting the user
+    public init(globalRules rules: Rules = .default,
+                showAlertAfterCurrentVersionHasBeenReleasedForDays releasedForDays: Int = 1) {
+        self.init(majorUpdateRules: rules,
+                  minorUpdateRules: rules,
+                  patchUpdateRules: rules,
+                  revisionUpdateRules: rules,
+                  showAlertAfterCurrentVersionHasBeenReleasedForDays: releasedForDays)
+    }
+
+    /// Returns the appropriate update rules based on the type of version that is returned from the API.
+    ///
+    /// - Parameter type: The type of app update.
+    /// - Returns: The appropriate rule based on the type of app update that is returned by the API.
+    func loadRulesForUpdateType(_ type: UpdateType) -> Rules {
+        switch type {
+        case .major: return majorUpdateRules
+        case .minor: return minorUpdateRules
+        case .patch: return patchUpdateRules
+        case .revision: return revisionUpdateRules
+        case .unknown: return majorUpdateRules
+        }
+    }
+
+    /// The default `RulesManager`.
+    ///
+    /// By default, the `Rules.default` rule is used for all update typs.
+    public static let `default` = RulesManager(globalRules: .default)
+}
+
+// MARK: - RulesManager-related Constants
+
+extension RulesManager {
+    /// Informs Siren of the type of update that is available so that
+    /// the appropriate ruleset is used to present the update alert.
+    ///
+    /// - major: Major release available: A.b.c.d
+    /// - minor: Minor release available: a.B.c.d
+    /// - patch: Patch release available: a.b.C.d
+    /// - revision: Revision release available: a.b.c.D
+    /// - unknown: No information available about the update.
+    public enum UpdateType: String {
+        /// Major release available: A.b.c.d
+        case major
+        /// Minor release available: a.B.c.d
+        case minor
+        /// Patch release available: a.b.C.d
+        case patch
+        /// Revision release available: a.b.c.D
+        case revision
+        /// No information available about the update.
+        case unknown
+    }
+}

Sources/Models/AlertAction.swift

@@ -0,0 +1,21 @@
+//
+//  AlertAction.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 12/1/18.
+//  Copyright © 2018 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+/// The `UIAlertController` button that was pressed upon being presented an update alert.
+public enum AlertAction {
+    /// The user clicked on the `Update` option, which took them to the app's App Store page.
+    case appStore
+    /// The user clicked on the `Next Time` option, which dismissed the alert.
+    case nextTime
+    /// The user clicked on the `Skip this version` option, which dismissed the alert.
+    case skip
+    /// (Default) The user never chose an option. This is returned when an error is thrown by Siren.
+    case unknown
+}

Sources/Models/AlertConstants.swift

@@ -0,0 +1,27 @@
+//
+//  AlertConstants.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 12/18/18.
+//  Copyright © 2018 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+/// The default constants used for the update alert's messaging.
+public struct AlertConstants {
+    /// The text that conveys the message that there is an app update available
+    public static let alertMessage = "A new version of %@ is available. Please update to version %@ now."
+
+    /// The alert title which defaults to *Update Available*.
+    public static let alertTitle = "Update Available"
+
+    /// The button text that conveys the message that the user should be prompted to update next time the app launches.
+    public static let nextTimeButtonTitle = "Next time"
+
+    /// The text that conveys the message that the the user wants to skip this verison update.
+    public static let skipButtonTitle = "Skip this version"
+
+    /// The button text that conveys the message that the user would like to update the app right away.
+    public static let updateButtonTitle = "Update"
+}

Sources/Models/Localization.swift

@@ -0,0 +1,166 @@
+//
+//  Localization.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 9/25/18.
+//  Copyright © 2018 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+/// Localization information and strings for Siren.
+public struct Localization {
+    /// Determines the available languages in which the update message and alert button titles should appear.
+    ///
+    /// By default, the operating system's default lanuage setting is used. However, you can force a specific language
+    /// by setting the forceLanguageLocalization property before calling checkVersion()
+    public enum Language: String {
+        /// Arabic Language Localization
+        case arabic = "ar"
+        /// Armenian Language Localization
+        case armenian = "hy"
+        /// Basque Language Localization
+        case basque = "eu"
+        /// Simplified Chinese Language Localization
+        case chineseSimplified = "zh-Hans"
+        /// Traditional Chinese Localization Localization
+        case chineseTraditional = "zh-Hant"
+        /// Croatian Language Localization
+        case croatian = "hr"
+        /// Czech Language Localization
+        case czech = "cs"
+        /// Danish Language Localization
+        case danish = "da"
+        /// Dutch Language Localization
+        case dutch = "nl"
+        /// English Language Localization
+        case english = "en"
+        /// Estonian Language Localization
+        case estonian = "et"
+        /// Finnish Language Localization
+        case finnish = "fi"
+        /// French Language Localization
+        case french = "fr"
+        /// German Language Localization
+        case german = "de"
+        /// Greek Language Localization
+        case greek = "el"
+        /// Hebrew Language Localization
+        case hebrew = "he"
+        /// Hungarian Language Localization
+        case hungarian = "hu"
+        /// Indonesian Language Localization
+        case indonesian = "id"
+        /// Italian Language Localization
+        case italian = "it"
+        /// Japanese Language Localization
+        case japanese = "ja"
+        /// Korean Language Localization
+        case korean = "ko"
+        /// Latvian Language Localization
+        case latvian = "lv"
+        /// Lithuanian Language Localization
+        case lithuanian = "lt"
+        /// Malay Language Localization
+        case malay = "ms"
+        /// Norwegian Language Localization
+        case norwegian = "nb-NO"
+        /// Persian Language Localization
+        case persian = "fa"
+        /// Persian (Afghanistan) Language Localization
+        case persianAfghanistan = "fa-AF"
+        /// Persian (Iran) Language Localization
+        case persianIran = "fa-IR"
+        /// Polish Language Localization
+        case polish = "pl"
+        /// Brazilian Portuguese Language Localization
+        case portugueseBrazil = "pt"
+        /// Portugal's Portuguese Language Localization
+        case portuguesePortugal = "pt-PT"
+        /// Russian Language Localization
+        case russian = "ru"
+        /// Serbian (Cyrillic) Language Localization
+        case serbianCyrillic = "sr-Cyrl"
+        /// Serbian (Latin) Language Localization
+        case serbianLatin = "sr-Latn"
+        /// Slovenian Language Localization
+        case slovenian = "sl"
+        /// Spanish Language Localization
+        case spanish = "es"
+        /// Swedish Language Localization
+        case swedish = "sv"
+        /// Thai Language Localization
+        case thai = "th"
+        /// Turkish Language Localization
+        case turkish = "tr"
+        /// Urdu Language Localization
+        case urdu = "ur"
+        /// Ukranian Language Localization
+        case ukrainian = "uk"
+        /// Vietnamese Language Localization
+        case vietnamese = "vi"
+    }
+
+    /// The name of the app as defined by the `Info.plist`.
+    private var appName: String = Bundle.bestMatchingAppName()
+
+    /// Overrides the default localization of a user's device when presenting the update message and button titles in the alert.
+    ///
+    /// See the Siren.Localization.Language enum for more details.
+    private let forceLanguage: Language?
+
+    /// Initializes
+    ///
+    /// - Parameters:
+    ///   - appName: Overrides the default name of the app. This is optional and defaults to the app that is defined in the `Info.plist`.
+    ///   - forceLanguage: The language the alert to which the alert should be set. If `nil`, it falls back to the device's preferred locale.
+    init(appName: String?, andForceLanguageLocalization forceLanguage: Language?) {
+        if let appName = appName {
+            self.appName = appName
+        }
+
+        self.forceLanguage = forceLanguage
+    }
+
+    /// The localized string for the `UIAlertController`'s message field.  .
+    ///
+    /// - Returns: A localized string for the update message.
+    public func alertMessage(forCurrentAppStoreVersion currentAppStoreVersion: String) -> String {
+        let message = Bundle.localizedString(forKey: AlertConstants.alertMessage,
+                                             andForceLocalization: forceLanguage)
+
+        return String(format: message, appName, currentAppStoreVersion)
+    }
+
+    /// The localized string for the `UIAlertController`'s title field.  .
+    ///
+    /// - Returns: A localized string for the phrase "Update Available".
+    public func alertTitle() -> String {
+        return Bundle.localizedString(forKey: AlertConstants.alertTitle,
+                                      andForceLocalization: forceLanguage)
+    }
+
+    /// The localized string for the "Next time" `UIAlertAction`.
+    ///
+    /// - Returns: A localized string for the phrase "Next time".
+    public func nextTimeButtonTitle() -> String {
+        return Bundle.localizedString(forKey: AlertConstants.nextTimeButtonTitle,
+                                      andForceLocalization: forceLanguage)
+    }
+
+    /// The localized string for the "Skip this version" `UIAlertAction`.
+    ///
+    /// - Returns: A localized string for the phrase "Skip this version".
+    public func skipButtonTitle() -> String {
+        return Bundle.localizedString(forKey: AlertConstants.skipButtonTitle,
+                                      andForceLocalization: forceLanguage)
+    }
+
+    /// The localized string for the "Update" `UIAlertAction`.
+    ///
+    /// - Returns: A localized string for the phrase "Update".
+    public func updateButtonTitle() -> String {
+        return Bundle.localizedString(forKey: AlertConstants.updateButtonTitle,
+                                      andForceLocalization: forceLanguage)
+    }
+}

Sources/Models/LookupModel.swift

@@ -0,0 +1,53 @@
+//
+//  LookupModel.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 8/6/17.
+//  Copyright © 2017 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+/// Model representing a selection of results from the iTunes Lookup API.
+public struct LookupModel: Decodable {
+    /// Codable Coding Keys for the Top-Level iTunes Lookup API JSON response.
+    private enum CodingKeys: String, CodingKey {
+        /// The results JSON key.
+        case results
+    }
+
+    /// The array of results objects from the iTunes Lookup API.
+    public let results: [Results]
+
+    /// The Results object from the the iTunes Lookup API.
+    public struct Results: Decodable {
+        ///  Codable Coding Keys for the Results array in the iTunes Lookup API JSON response.
+        private enum CodingKeys: String, CodingKey {
+            /// The appID JSON key.
+            case appID = "trackId"
+            /// The current version release date JSON key.
+            case currentVersionReleaseDate
+            /// The minimum device iOS version compatibility JSON key.
+            case minimumOSVersion = "minimumOsVersion"
+            /// The release notes JSON key.
+            case releaseNotes
+            /// The current App Store version JSON key.
+            case version
+        }
+
+        /// The app's App ID.
+        public let appID: Int
+
+        /// The release date for the latest verison of the app.
+        public let currentVersionReleaseDate: String
+
+        /// The minimum verison of iOS that the current verison of the app requires.
+        public let minimumOSVersion: String
+
+        /// The releases notes from the latest version of the app.
+        public let releaseNotes: String?
+
+        /// The latest version of the app.
+        public let version: String
+    }
+}

Sources/Models/PerformCheck.swift

@@ -0,0 +1,24 @@
+//
+//  PerformCheck.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 2/1/19.
+//  Copyright © 2019 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+/// The type of check to perform when Siren's `wail` method is performed.
+///
+/// - Note: Alert presentation will still respct the settings that are set
+///   for `UpdatePromptFrequency` and `showAlertAfterCurrentVersionHasBeenReleasedForDays`
+public enum PerformCheck {
+    /// Performs a version check only when Siren's `wail` method is called,
+    /// as the `UIApplication.didBecomeActiveNotification` is ignored.
+    case onDemand
+
+    /// (DEFAULT) Perform a version check whenever the app enters the foreground.
+    /// This value must be set when Siren's `wail` method is called to enable the
+    /// `UIApplication.didBecomeActiveNotification` observer.
+    case onForeground
+}

Sources/Models/Results.swift

@@ -0,0 +1,25 @@
+//
+//  Results.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 12/1/18.
+//  Copyright © 2018 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+/// The relevant metadata returned from Siren upon completing a successful version check.
+public struct Results {
+    /// The `UIAlertAction` the user chose upon being presented with the update alert.
+    /// Defaults to `unknown` until an alert is actually presented.
+    public var alertAction: AlertAction = .unknown
+
+    /// The Siren-supported locale that was used for the string in the update alert.
+    public let localization: Localization
+
+    /// The Swift-mapped API model, if a successful version check was performed.
+    public let lookupModel: LookupModel
+
+    /// The type of update that was returned for the API.
+    public var updateType: RulesManager.UpdateType = .unknown
+}

Sources/Models/Rules.swift

@@ -0,0 +1,91 @@
+//
+//  Rules.swift
+//  Siren
+//
+//  Created by Sabintsev, Arthur on 11/18/18.
+//  Copyright © 2018 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+/// Alert Presentation Rules for Siren.
+public struct Rules {
+    /// The type of alert that should be presented.
+    let alertType: AlertType
+
+    /// The frequency in which a the user is prompted to update the app
+    /// once a new version is available in the App Store and if they have not updated yet.
+    let frequency: UpdatePromptFrequency
+
+    /// Initializes the alert presentation rules.
+    ///
+    /// - Parameters:
+    ///   - frequency: How often a user should be prompted to update the app once a new version is available in the App Store.
+    ///   - alertType: The type of alert that should be presented.
+    public init(promptFrequency frequency: UpdatePromptFrequency,
+                forAlertType alertType: AlertType) {
+        self.frequency = frequency
+        self.alertType = alertType
+    }
+
+    /// Performs a version check immediately, but allows the user to skip updating the app until the next time the app becomes active.
+    public static var annoying: Rules {
+        return Rules(promptFrequency: .immediately, forAlertType: .option)
+    }
+
+    /// Performs a version check immediately and forces the user to update the app.
+    public static var critical: Rules {
+        return Rules(promptFrequency: .immediately, forAlertType: .force)
+    }
+
+    /// Performs a version check once a day, but allows the user to skip updating the app until
+    /// the next time the app becomes active or skipping the update all together until another version is released.
+    ///
+    /// This is the default setting.
+    public static var `default`: Rules {
+        return Rules(promptFrequency: .daily, forAlertType: .skip)
+    }
+
+    /// Performs a version check weekly, but allows the user to skip updating the app until the next time the app becomes active.
+    public static var hinting: Rules {
+        return Rules(promptFrequency: .weekly, forAlertType: .option)
+    }
+
+    /// Performs a version check daily, but allows the user to skip updating the app until the next time the app becomes active.
+    public static var persistent: Rules {
+        return Rules(promptFrequency: .daily, forAlertType: .option)
+    }
+
+    /// Performs a version check weekly, but allows the user to skip updating the app until
+    /// the next time the app becomes active or skipping the update all together until another version is released.
+    public static var relaxed: Rules {
+        return Rules(promptFrequency: .weekly, forAlertType: .skip)
+    }
+}
+
+// Rules-related Constants
+public extension Rules {
+    /// Determines the type of alert to present after a successful version check has been performed.
+    public enum AlertType {
+        /// Forces the user to update your app (1 button alert).
+        case force
+        /// Presents the user with option to update app now or at next launch (2 button alert).
+        case option
+        /// Presents the user with option to update the app now, at next launch, or to skip this version all together (3 button alert).
+        case skip
+        /// Doesn't present the alert.
+        /// Use this option if you would like to present a custom alert to the end-user.
+        case none
+    }
+
+    /// Determines the frequency in which the user is prompted to update the app
+    /// once a new version is available in the App Store and if they have not updated yet.
+    public enum UpdatePromptFrequency: UInt {
+        /// Version check performed every time the app is launched.
+        case immediately = 0
+        /// Version check performed once a day.
+        case daily = 1
+        /// Version check performed once a week.
+        case weekly = 7
+    }
+}

Sources/Siren.bundle/el.lproj/SirenLocalizable.strings

@@ -0,0 +1,14 @@
+/* Update alert message: A new version of {APP NAME} is available. Please update to version {NEW VERSION} now.*/
+"A new version of %@ is available. Please update to version %@ now." = "Μια νέα έκδοση του %@ είναι  διαθέσιμη. Παρακαλώ κάντε αναβάθμιση στο %@ τώρα.";
+
+/* Update alert title */
+"Update Available" = "Διαθέσιμη Ενημέρωση";
+
+/* Update alert dismiss button title */
+"Next time" = "Άλλη φορά";
+
+/* Update alert skip button title */
+"Skip this version" = "Αγνόησε αυτήν την έκδοση";
+
+/* Update alert skip button title */
+"Update" = "Αναβάθμιση";

Sources/Siren.bundle/et.lproj/SirenLocalizable.strings

@@ -0,0 +1,14 @@
+/* Update alert message: A new version of {APP NAME} is available. Please update to version {NEW VERSION} now.*/
+"A new version of %@ is available. Please update to version %@ now." = "On ilmunud uus %@ versioon. Palun uuendage %@ versioonini.";
+
+/* Update alert title */
+"Update Available" = "Uuendus saadaval";
+
+/* Update alert dismiss button title */
+"Next time" = "Järgmisel korral";
+
+/* Update alert skip button title */
+"Skip this version" = "Jäta see version vahele";
+
+/* Update alert skip button title */
+"Update" = "Uuenda";

Sources/Siren.bundle/fi.lproj/SirenLocalizable.strings

@@ -0,0 +1,14 @@
+/* Update alert message: A new version of {APP NAME} is available. Please update to version {NEW VERSION} now.*/
+"A new version of %@ is available. Please update to version %@ now." = "%@ on päivittynyt. Ole hyvä ja päivitä versioon %@ nyt.";
+
+/* Update alert title */
+"Update Available" = "Päivitys saatavilla";
+
+/* Update alert dismiss button title */
+"Next time" = "Ensi kerralla";
+
+/* Update alert skip button title */
+"Skip this version" = "Jätä tämä versio väliin";
+
+/* Update alert skip button title */
+"Update" = "Päivitys";

Sources/Siren.bundle/hr.lproj/SirenLocalizable.strings

@@ -0,0 +1,14 @@
+/* Update alert message: A new version of {APP NAME} is available. Please update to version {NEW VERSION} now.*/
+"A new version of %@ is available. Please update to version %@ now." = "Nova verzia %@ je stigla. Ažuriraj na verziju %@ sada.";
+
+/* Update alert title */
+"Update Available" = "Nova ažuriranje je stigla";
+
+/* Update alert dismiss button title */
+"Next time" = "Sljedeći put";
+
+/* Update alert skip button title */
+"Skip this version" = "Preskoči ovu verziju";
+
+/* Update alert skip button title */
+"Update" = "Ažuriraj";

Sources/Siren.bundle/hu.lproj/SirenLocalizable.strings

@@ -0,0 +1,14 @@
+/* Update alert message: A new version of {APP NAME} is available. Please update to version {NEW VERSION} now.*/
+"A new version of %@ is available. Please update to version %@ now." = "Új verziója érhető el a %@ alkalmazásnak. Kérjük frissítsen a %@ verzióra.";
+
+/* Update alert title */
+"Update Available" = "Új frissítés érhető el";
+
+/* Update alert dismiss button title */
+"Next time" = "Később";
+
+/* Update alert skip button title */
+"Skip this version" = "Ennél a verziónál ne figyelmeztessen";
+
+/* Update alert skip button title */
+"Update" = "Frissítés";

Sources/Siren.bundle/id.lproj/SirenLocalizable.strings

@@ -0,0 +1,14 @@
+/* Update alert message: A new version of {APP NAME} is available. Please update to version {NEW VERSION} now.*/
+"A new version of %@ is available. Please update to version %@ now." = "Versi baru %@ tersedia. Perbarui ke versi %@ sekarang.";
+
+/* Update alert title */
+"Update Available" = "Pembaruan Tersedia";
+
+/* Update alert dismiss button title */
+"Next time" = "Lain kali";
+
+/* Update alert skip button title */
+"Skip this version" = "Lewati versi ini";
+
+/* Update alert skip button title */
+"Update" = "Perbarui";

Sources/Siren.bundle/lt.lproj/SirenLocalizable.strings

@@ -0,0 +1,14 @@
+/* Update alert message: A new version of {APP NAME} is available. Please update to version {NEW VERSION} now.*/
+"A new version of %@ is available. Please update to version %@ now." = "Atsirado nauja %@ versija. Prašome atsinaujinti iki %@ versijos.";
+
+/* Update alert title */
+"Update Available" = "Atnaujinimas";
+
+/* Update alert dismiss button title */
+"Next time" = "Kitą kartą";
+
+/* Update alert skip button title */
+"Skip this version" = "Praleisti šią versiją";
+
+/* Update alert skip button title */
+"Update" = "Atnaujinti";

Sources/Siren.bundle/lv.lproj/SirenLocalizable.strings

@@ -0,0 +1,14 @@
+/* Update alert message: A new version of {APP NAME} is available. Please update to version {NEW VERSION} now.*/
+"A new version of %@ is available. Please update to version %@ now." = "Pieejama jauna %@ versija.  Lūdzam atjaunot versiju %@.";
+
+/* Update alert title */
+"Update Available" = "Atjauninājums pieejams";
+
+/* Update alert dismiss button title */
+"Next time" = "Nākamreiz";
+
+/* Update alert skip button title */
+"Skip this version" = "Izlaist šo versiju";
+
+/* Update alert skip button title */
+"Update" = "Atjaunināt";

Sources/Siren.bundle/ms.lproj/SirenLocalizable.strings

@@ -0,0 +1,14 @@
+/* Update alert message: A new version of {APP NAME} is available. Please update to version {NEW VERSION} now.*/
+"A new version of %@ is available. Please update to version %@ now." = "Versi terkini untuk %@ telah ada. Sila muat turun versi %@ sekarang.";
+
+/* Update alert title */
+"Update Available" = "Versi Terkini";
+
+/* Update alert dismiss button title */
+"Next time" = "Lain kali";
+
+/* Update alert skip button title */
+"Skip this version" = "Langkau versi ini";
+
+/* Update alert skip button title */
+"Update" = "Muat turun";

Sources/Siren.bundle/nb-NO.lproj/SirenLocalizable.strings

@@ -0,0 +1,14 @@
+/* Update alert message: A new version of {APP NAME} is available. Please update to version {NEW VERSION} now.*/
+"A new version of %@ is available. Please update to version %@ now." = "En ny versjon av %@ er tilgjengelig. Vennligst oppdater til versjon %@ nå.";
+
+/* Update alert title */
+"Update Available" = "Oppdatering tilgjengelig";
+
+/* Update alert dismiss button title */
+"Next time" = "Neste gang";
+
+/* Update alert skip button title */
+"Skip this version" = "Hopp over denne versjonen";
+
+/* Update alert skip button title */
+"Update" = "Oppdater";

Sources/Siren.bundle/pt.lproj/SirenLocalizable.strings

@@ -0,0 +1,15 @@
+/* Update alert message: A new version of {APP NAME} is available. Please update to version {NEW VERSION} now.*/
+"A new version of %@ is available. Please update to version %@ now."="Uma nova versão do %@ está disponível. Por favor atualize para a versão %@.";
+
+/* Update alert title */
+"Update Available"="Atualização disponível";
+
+/* Update alert dismiss button title */
+"Next time"="Próxima vez";
+
+/* Update alert skip button title */
+"Skip this version"="Ignorar esta versão";
+
+/* Update alert skip button title */
+"Update"="Atualizar";
+

Sources/Siren.bundle/vi.lproj/SirenLocalizable.strings

@@ -0,0 +1,14 @@
+/* Update alert message: A new version of {APP NAME} is available. Please update to version {NEW VERSION} now.*/
+"A new version of %@ is available. Please update to version %@ now." = "Đã có phiên bản mới của %@. Xin vui lòng cập nhật lên phiên bản %@.";
+
+/* Update alert title */
+"Update Available" = "Cập nhật mới";
+
+/* Update alert dismiss button title */
+"Next time" = "Lần tới";
+
+/* Update alert skip button title */
+"Skip this version" = "Bỏ qua phiên bản này";
+
+/* Update alert skip button title */
+"Update" = "Cập nhật";

Sources/Siren.swift

@@ -0,0 +1,300 @@
+//
+//  Siren.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 1/3/15.
+//  Copyright (c) 2015 Sabintsev iOS Projects. All rights reserved.
+//
+
+import UIKit
+
+/// The Siren Class.
+public final class Siren: NSObject {
+    /// Return results or errors obtained from performing a version check with Siren.
+    public typealias ResultsHandler = (Results?, KnownError?) -> Void
+
+    /// The Siren singleton. The main point of entry to the Siren library.
+    public static let shared = Siren()
+
+    /// The manager that controls the App Store API that is
+    /// used to fetch the latest version of the app.
+    ///
+    /// Defaults to the US App Store.
+    public lazy var apiManager: APIManager = .default
+
+    /// The manager that controls the update alert's string localization and tint color.
+    ///
+    /// Defaults the string's lange localization to the user's device localization.
+    public lazy var presentationManager: PresentationManager = .default
+
+    /// The manager that controls the type of alert that should be displayed
+    /// and how often an alert should be displayed dpeneding on the type
+    /// of update that is available relative to the installed version of the app
+    /// (e.g., different rules for major, minor, patch and revision updated can be used).
+    ///
+    /// Defaults to performing a version check once a day with an alert that allows
+    /// the user to skip updating the app until the next time the app becomes active or
+    /// skipping the update all together until another version is released.
+    public lazy var rulesManager: RulesManager = .default
+
+    /// The current installed version of your app.
+    lazy var currentInstalledVersion: String? = Bundle.version()
+
+    /// The retained `NotificationCenter` observer that listens for `UIApplication.didBecomeActiveNotification` notifications.
+    var didBecomeActiveObserver: NSObjectProtocol?
+
+    /// The retained `NotificationCenter` observer that listens for `UIApplication.willResignActiveNotification` notifications.
+    var willResignActiveObserver: NSObjectProtocol?
+
+    /// The retained `NotificationCenter` observer that listens for `UIApplication.didEnterBackgroundNotification` notifications.
+    var didEnterBackgroundObserver: NSObjectProtocol?
+
+    /// The last date that an alert was presented to the user.
+    private var alertPresentationDate: Date? = UserDefaults.alertPresentationDate
+
+    /// The App Store's unique identifier for an app.
+    private var appID: Int?
+
+    /// The completion handler used to return the results or errors returned by Siren.
+    private var resultsHandler: ResultsHandler?
+
+    /// The deinitialization method that clears out all observers,
+    deinit {
+        presentationManager.alertController?.dismiss(animated: true, completion: nil)
+        removeForegroundObservers()
+        removeBackgroundObservers()
+    }
+}
+
+// MARK: - Public API Interface
+
+public extension Siren {
+    /// This method executes the Siren version checking and alert presentation flow.
+    ///
+    /// - Parameters:
+    ///   - performCheck: Defines how the version check flow is entered. Defaults to `.onForeground`.
+    ///   - handler: Returns the metadata around a successful version check and interaction with the update modal or it returns nil.
+    func wail(performCheck: PerformCheck = .onForeground,
+              completion handler: ResultsHandler? = nil) {
+        resultsHandler = handler
+
+        switch performCheck {
+        case .onDemand:
+            removeForegroundObservers()
+            performVersionCheck()
+        case .onForeground:
+            addForegroundObservers()
+        }
+
+        // Add background app state change observers.
+        addBackgroundObservers()
+    }
+
+    /// Launches the AppStore in two situations when the user clicked the `Update` button in the UIAlertController modal.
+    ///
+    /// This function is marked `public` as a convenience for those developers who decide to build a custom alert modal
+    /// instead of using Siren's prebuilt update alert.
+    func launchAppStore() {
+        guard let appID = appID,
+            let url = URL(string: "https://itunes.apple.com/app/id\(appID)") else {
+                resultsHandler?(nil, .malformedURL)
+                return
+        }
+
+        DispatchQueue.main.async {
+            if #available(iOS 10.0, *) {
+                UIApplication.shared.open(url, options: [:], completionHandler: nil)
+            } else {
+                UIApplication.shared.openURL(url)
+            }
+        }
+    }
+}
+
+// MARK: - Version Check and Alert Presentation Flow
+
+private extension Siren {
+    /// Initiates the unidirectional version checking flow.
+    func performVersionCheck() {
+        alertPresentationDate = UserDefaults.alertPresentationDate
+        apiManager.performVersionCheckRequest { [weak self] (lookupModel, error) in
+            guard let self = self else { return }
+            guard let lookupModel = lookupModel, error == nil else {
+                self.resultsHandler?(nil, error)
+                return
+            }
+
+            self.validate(model: lookupModel)
+        }
+    }
+
+    /// Validates the parsed and mapped iTunes Lookup Model
+    /// to guarantee all the relevant data was returned before
+    /// attempting to present an alert.
+    ///
+    /// - Parameter model: The iTunes Lookup Model.
+    func validate(model: LookupModel) {
+        // Check if the latest version is compatible with current device's version of iOS.
+        guard DataParser.isUpdateCompatibleWithDeviceOS(for: model) else {
+            resultsHandler?(nil, .appStoreOSVersionUnsupported)
+            return
+        }
+
+        // Check and store the App ID .
+        guard let appID = model.results.first?.appID else {
+            resultsHandler?(nil, .appStoreAppIDFailure)
+            return
+        }
+        self.appID = appID
+
+        // Check and store the current App Store version.
+        guard let currentAppStoreVersion = model.results.first?.version else {
+            resultsHandler?(nil, .appStoreVersionArrayFailure)
+            return
+        }
+
+        // Check if the App Store version is newer than the currently installed version.
+        guard DataParser.isAppStoreVersionNewer(installedVersion: currentInstalledVersion,
+                                                appStoreVersion: currentAppStoreVersion) else {
+            resultsHandler?(nil, .noUpdateAvailable)
+            return
+        }
+
+        // Check the release date of the current version.
+        guard let currentVersionReleaseDate = model.results.first?.currentVersionReleaseDate,
+            let daysSinceRelease = Date.days(since: currentVersionReleaseDate) else {
+                resultsHandler?(nil, .currentVersionReleaseDate)
+                return
+        }
+
+        // Check if applicaiton has been released for the amount of days defined by the app consuming Siren.
+        guard daysSinceRelease >= rulesManager.releasedForDays else {
+            resultsHandler?(nil, .releasedTooSoon(daysSinceRelease: daysSinceRelease,
+                                                     releasedForDays: rulesManager.releasedForDays))
+            return
+        }
+
+        determineIfAlertPresentationRulesAreSatisfied(forCurrentAppStoreVersion: currentAppStoreVersion, andLookupModel: model)
+    }
+
+    /// Determines if the update alert can be presented based on the
+    /// rules set in the `RulesManager` and the the skip version settings.
+    ///
+    /// - Parameters:
+    ///   - currentAppStoreVersion: The curren version of the app in the App Store.
+    ///   - model: The iTunes Lookup Model.
+    func determineIfAlertPresentationRulesAreSatisfied(forCurrentAppStoreVersion currentAppStoreVersion: String, andLookupModel model: LookupModel) {
+        // Did the user:
+        // - request to skip being prompted with version update alerts for a specific version
+        // - and is the latest App Store update the same version that was requested?
+        if let previouslySkippedVersion = UserDefaults.storedSkippedVersion,
+            let currentInstalledVersion = currentInstalledVersion,
+            !currentAppStoreVersion.isEmpty,
+            currentAppStoreVersion == previouslySkippedVersion {
+            resultsHandler?(nil, .skipVersionUpdate(installedVersion: currentInstalledVersion, appStoreVersion: currentAppStoreVersion))
+                return
+        }
+
+        let updateType = DataParser.parseForUpdate(forInstalledVersion: currentInstalledVersion,
+                                                   andAppStoreVersion: currentAppStoreVersion)
+        let rules = rulesManager.loadRulesForUpdateType(updateType)
+
+        if rules.frequency == .immediately {
+            presentAlert(withRules: rules, forCurrentAppStoreVersion: currentAppStoreVersion, model: model, andUpdateType: updateType)
+        } else {
+            guard let alertPresentationDate = alertPresentationDate else {
+                presentAlert(withRules: rules, forCurrentAppStoreVersion: currentAppStoreVersion, model: model, andUpdateType: updateType)
+                return
+            }
+            if Date.days(since: alertPresentationDate) >= rules.frequency.rawValue {
+                presentAlert(withRules: rules, forCurrentAppStoreVersion: currentAppStoreVersion, model: model, andUpdateType: updateType)
+            } else {
+                resultsHandler?(nil, .recentlyPrompted)
+            }
+        }
+    }
+
+    /// Presents the update alert to the end user.
+    /// Upon tapping a value on the alert view, a completion handler will return all relevant metadata to the app.
+    ///
+    /// - Parameters:
+    ///   - rules: The rules for how to present the alert.
+    ///   - currentAppStoreVersion: The current version of the app in the App Store.
+    ///   - model: The iTunes Lookup Model.
+    ///   - updateType: The type of update that is available based on the version found in the App Store.
+    func presentAlert(withRules rules: Rules,
+                      forCurrentAppStoreVersion currentAppStoreVersion: String,
+                      model: LookupModel,
+                      andUpdateType updateType: RulesManager.UpdateType) {
+        presentationManager.presentAlert(withRules: rules, forCurrentAppStoreVersion: currentAppStoreVersion) { [weak self] alertAction in
+            guard let self = self else { return }
+            let results = Results(alertAction: alertAction,
+                                  localization: self.presentationManager.localization,
+                                  lookupModel: model,
+                                  updateType: updateType)
+            self.resultsHandler?(results, nil)
+        }
+    }
+}
+
+// MARK: - Add Observers
+
+private extension Siren {
+    /// Adds an observer that listens for app launching/relaunching.
+    func addForegroundObservers() {
+        guard didBecomeActiveObserver == nil else { return }
+        didBecomeActiveObserver = NotificationCenter
+            .default
+            .addObserver(forName: UIApplication.didBecomeActiveNotification,
+                         object: nil,
+                         queue: nil) { [weak self] _ in
+                            guard let self = self else { return }
+                            self.performVersionCheck()
+        }
+    }
+
+    /// Adds an observer that listens for when the user enters the app switcher
+    /// and when the app is sent to the background.
+    func addBackgroundObservers() {
+        if willResignActiveObserver == nil {
+            didBecomeActiveObserver = NotificationCenter
+                .default
+                .addObserver(forName: UIApplication.willResignActiveNotification,
+                             object: nil,
+                             queue: nil) { [weak self] _ in
+                                guard let self = self else { return }
+                                self.presentationManager.alertController?.dismiss(animated: true, completion: nil)
+            }
+        }
+
+        if didEnterBackgroundObserver == nil {
+            didEnterBackgroundObserver = NotificationCenter
+                .default
+                .addObserver(forName: UIApplication.didEnterBackgroundNotification,
+                             object: nil,
+                             queue: nil) { [weak self] _ in
+                                guard let self = self else { return }
+                                self.presentationManager.alertController?.dismiss(animated: true, completion: nil)
+            }
+        }
+    }
+}
+
+// MARK: - Remove Observers
+
+private extension Siren {
+    /// Removes the observer that listens for app launching/relaunching.
+    func removeForegroundObservers() {
+        NotificationCenter.default.removeObserver(didBecomeActiveObserver as Any)
+        didBecomeActiveObserver = nil
+    }
+
+    /// Remove the observers that list to app resignation and app backgrounding.
+    func removeBackgroundObservers() {
+        NotificationCenter.default.removeObserver(willResignActiveObserver as Any)
+        willResignActiveObserver = nil
+
+        NotificationCenter.default.removeObserver(didEnterBackgroundObserver as Any)
+        didEnterBackgroundObserver = nil
+    }
+}

Sources/Utilities/DataParser.swift

@@ -0,0 +1,92 @@
+//
+//  DataParser.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 11/25/18.
+//  Copyright © 2018 Sabintsev iOS Projects. All rights reserved.
+//
+
+import UIKit
+
+/// Version parsing functions for Siren.
+struct DataParser {
+    /// Checks to see if the App Store version of the app is newer than the installed version.
+    ///
+    /// - Parameters:
+    ///   - installedVersion: The installed version of the app.
+    ///   - appStoreVersion: The App Store version of the app.
+    /// - Returns: `true` if the App Store version is newer. Otherwise, `false`.
+    static func isAppStoreVersionNewer(installedVersion: String?, appStoreVersion: String?) -> Bool {
+        guard let installedVersion = installedVersion,
+            let appStoreVersion = appStoreVersion,
+            (installedVersion.compare(appStoreVersion, options: .numeric) == .orderedAscending) else {
+                return false
+        }
+
+        return true
+    }
+
+    /// Validates that the latest version in the App Store is compatible with the device's current version of iOS.
+    ///
+    /// - Parameter model: The iTunes Lookup Model.
+    /// - Returns: `true` if the latest version is compatible with the device's current version of iOS. Otherwise, `false`.
+    static func isUpdateCompatibleWithDeviceOS(for model: LookupModel) -> Bool {
+        guard let requiredOSVersion = model.results.first?.minimumOSVersion else {
+            return false
+        }
+
+        let systemVersion = UIDevice.current.systemVersion
+
+        guard systemVersion.compare(requiredOSVersion, options: .numeric) == .orderedDescending ||
+            systemVersion.compare(requiredOSVersion, options: .numeric) == .orderedSame else {
+                return false
+        }
+
+        return true
+    }
+
+    /// The type of update that is returned from the API in relation to the verison of the app that is installed.
+    ///
+    /// - Parameters:
+    ///   - installedVersion: The installed version of the app.
+    ///   - appStoreVersion: The App Store version of the app.
+    /// - Returns: The type of update in relation to the verison of the app that is installed.
+    static func parseForUpdate(forInstalledVersion installedVersion: String?,
+                               andAppStoreVersion appStoreVersion: String?) -> RulesManager.UpdateType {
+        guard let installedVersion = installedVersion,
+            let appStoreVersion = appStoreVersion else {
+                return .unknown
+        }
+
+        let oldVersion = split(version: installedVersion)
+        let newVersion = split(version: appStoreVersion)
+
+        guard let newVersionFirst = newVersion.first,
+            let oldVersionFirst = oldVersion.first else {
+            return .unknown
+        }
+
+        if newVersionFirst > oldVersionFirst { // A.b.c.d
+            return .major
+        } else if newVersion.count > 1 && (oldVersion.count <= 1 || newVersion[1] > oldVersion[1]) { // a.B.c.d
+            return .minor
+        } else if newVersion.count > 2 && (oldVersion.count <= 2 || newVersion[2] > oldVersion[2]) { // a.b.C.d
+            return .patch
+        } else if newVersion.count > 3 && (oldVersion.count <= 3 || newVersion[3] > oldVersion[3]) { // a.b.c.D
+            return .revision
+        } else {
+            return .unknown
+        }
+    }
+
+    /// Splits a version-formatted `String into an `[Int]`.
+    ///
+    /// Converts `"a.b.c.d"` into `[a, b, c, d]`.
+    ///
+    /// - Parameter version: The version formatted `String`.
+    ///
+    /// - Returns: An array of integers representing a version of the app.
+    private static func split(version: String) -> [Int] {
+        return version.lazy.split {$0 == "."}.map { String($0) }.map {Int($0) ?? 0}
+    }
+}

Sources/Utilities/KnownError.swift

@@ -0,0 +1,78 @@
+//
+//  KnownError.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 8/6/17.
+//  Copyright © 2017 Sabintsev iOS Projects. All rights reserved.
+//
+
+import Foundation
+
+/// Enumerates all potentials errors that Siren can handle.
+public enum KnownError: LocalizedError {
+    /// Error retrieving trackId as the JSON does not contain a 'trackId' key.
+    case appStoreAppIDFailure
+    /// Error retrieving App Store data as JSON results were empty. Is your app available in the US? If not, change the `countryCode` variable to fix this error.
+    case appStoreDataRetrievalEmptyResults
+    /// Error retrieving App Store data as an error was returned.
+    case appStoreDataRetrievalFailure(underlyingError: Error?)
+    /// Error parsing App Store JSON data.
+    case appStoreJSONParsingFailure(underlyingError: Error)
+    /// The version of iOS on the device is lower than that of the one required by the app verison update.
+    case appStoreOSVersionUnsupported
+    /// Error retrieving App Store verson number as the JSON does not contain a `version` key.
+    case appStoreVersionArrayFailure
+    /// The `currentVersionReleaseDate` key is missing in the JSON payload. Please leave an issue on https://github.com/ArtSabintsev/Siren with as many details as possible.
+    case currentVersionReleaseDate
+    /// One of the iTunes URLs used in Siren is malformed. Please leave an issue on https://github.com/ArtSabintsev/Siren with as many details as possible.
+    case malformedURL
+    /// Please make sure that you have set a `Bundle Identifier` in your project.
+    case missingBundleID
+    /// No new update available.
+    case noUpdateAvailable
+    /// Siren will not present an update alert if it performed one too recently. If you would like to present an alert every time Siren is called, please consider setting the `UpdatePromptFrequency.immediately` rule in `RulesManager`
+    case recentlyPrompted
+    /// The app has been released for X days, but Siren cannot prompt the user until Y (where Y > X) days have passed.
+    case releasedTooSoon(daysSinceRelease: Int, releasedForDays: Int)
+    /// The user has opted to skip updating their current version of the app to the current App Store version.
+    case skipVersionUpdate(installedVersion: String, appStoreVersion: String)
+
+    /// The localized description for each error handled by Siren.
+    public var localizedDescription: String {
+        switch self {
+        case .appStoreAppIDFailure:
+            return "\(KnownError.sirenError) Error retrieving trackId as the JSON does not contain a `trackId` key."
+        case .appStoreDataRetrievalFailure(let error?):
+            return "\(KnownError.sirenError) Error retrieving App Store data as an error was returned\nAlso, the following system level error was returned: \(error)"
+        case .appStoreDataRetrievalEmptyResults:
+            return "\(KnownError.sirenError) Error retrieving App Store data as the JSON results were empty. Is your app available in the US? If not, change the `countryCode` variable to fix this error."
+        case .appStoreDataRetrievalFailure(.none):
+            return "\(KnownError.sirenError) Error retrieving App Store data as an error was returned."
+        case .appStoreJSONParsingFailure(let error):
+            return "\(KnownError.sirenError) Error parsing App Store JSON data.\nAlso, the following system level error was returned: \(error)"
+        case .appStoreOSVersionUnsupported:
+            return "\(KnownError.sirenError) The version of iOS on the device is lower than that of the one required by the app verison update."
+        case .appStoreVersionArrayFailure:
+            return "\(KnownError.sirenError) Error retrieving App Store verson number as the JSON does not contain a `version` key."
+        case .currentVersionReleaseDate:
+            return "\(KnownError.sirenError) The `currentVersionReleaseDate` key is missing in the JSON payload. Please leave an issue on https://github.com/ArtSabintsev/Siren with as many details as possible."
+        case .malformedURL:
+            return "\(KnownError.sirenError) One of the iTunes URLs used in Siren is malformed. Please leave an issue on https://github.com/ArtSabintsev/Siren with as many details as possible."
+        case .missingBundleID:
+            return "\(KnownError.sirenError) Please make sure that you have set a `Bundle Identifier` in your project."
+        case .noUpdateAvailable:
+            return "\(KnownError.sirenError) No new update available."
+        case .recentlyPrompted:
+            return "\(KnownError.sirenError) Siren will not present an update alert if it performed one too recently. If you would like to present an alert every time Siren is called, please consider setting the `\(Rules.UpdatePromptFrequency.self).immediately` rule in `\(RulesManager.self)`"
+        case .releasedTooSoon(let daysSinceRelease, let releasedForDays):
+            return "\(KnownError.sirenError) The app has been released for \(daysSinceRelease) days, but Siren cannot prompt the user until \(releasedForDays) days have passed."
+        case .skipVersionUpdate(let installedVersion, let appStoreVersion):
+            return "\(KnownError.sirenError) The user has opted to skip updating their current version of the app (\(installedVersion)) to the current App Store version (\(appStoreVersion))."
+        }
+    }
+
+    /// An easily identifiable prefix for all errors thrown by Siren.
+    private static var sirenError: String {
+        return "[Siren Error]"
+    }
+}

Sources/View Controllers/SirenViewController.swift

@@ -0,0 +1,17 @@
+//
+//  SirenViewController.swift
+//  Siren
+//
+//  Created by Arthur Sabintsev on 3/17/17.
+//  Copyright © 2017 Sabintsev iOS Projects. All rights reserved.
+//
+
+import UIKit
+
+/// `UIViewController` Extension for Siren
+final class SirenViewController: UIViewController {
+    /// `UIStatusBarStyle` override.
+    override var preferredStatusBarStyle: UIStatusBarStyle {
+        return UIApplication.shared.statusBarStyle
+    }
+}

docs/Classes.html

@@ -0,0 +1,215 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <title>Classes  Reference</title>
+    <link rel="stylesheet" type="text/css" href="css/jazzy.css" />
+    <link rel="stylesheet" type="text/css" href="css/highlight.css" />
+    <meta charset='utf-8'>
+    <script src="js/jquery.min.js" defer></script>
+    <script src="js/jazzy.js" defer></script>
+    
+  </head>
+  <body>
+    <a name="//apple_ref/swift/Section/Classes" class="dashAnchor"></a>
+    <a title="Classes  Reference"></a>
+    <header>
+      <div class="content-wrapper">
+        <p><a href="index.html">Siren Docs</a> (100% documented)</p>
+      </div>
+    </header>
+    <div class="content-wrapper">
+      <p id="breadcrumbs">
+        <a href="index.html">Siren Reference</a>
+        <img id="carat" src="img/carat.png" />
+        Classes  Reference
+      </p>
+    </div>
+    <div class="content-wrapper">
+      <nav class="sidebar">
+        <ul class="nav-groups">
+          <li class="nav-group-name">
+            <a href="Classes.html">Classes</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="Classes/Siren.html">Siren</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Classes/SirenViewController.html">SirenViewController</a>
+              </li>
+            </ul>
+          </li>
+          <li class="nav-group-name">
+            <a href="Enums.html">Enumerations</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="Enums/AlertAction.html">AlertAction</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Enums/KnownError.html">KnownError</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Enums/PerformCheck.html">PerformCheck</a>
+              </li>
+            </ul>
+          </li>
+          <li class="nav-group-name">
+            <a href="Extensions.html">Extensions</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="Extensions/Bundle.html">Bundle</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Extensions/Bundle/Constants.html">– Constants</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Extensions/Date.html">Date</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Extensions/UIAlertController.html">UIAlertController</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Extensions/UserDefaults.html">UserDefaults</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Extensions/UserDefaults/SirenKeys.html">– SirenKeys</a>
+              </li>
+            </ul>
+          </li>
+          <li class="nav-group-name">
+            <a href="Structs.html">Structures</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="Structs/APIManager.html">APIManager</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/APIManager/Constants.html">– Constants</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/AlertConstants.html">AlertConstants</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/DataParser.html">DataParser</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/Localization.html">Localization</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/Localization/Language.html">– Language</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/LookupModel.html">LookupModel</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/LookupModel/CodingKeys.html">– CodingKeys</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/LookupModel/Results.html">– Results</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/PresentationManager.html">PresentationManager</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/Results.html">Results</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/Rules.html">Rules</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/Rules/AlertType.html">– AlertType</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/Rules/UpdatePromptFrequency.html">– UpdatePromptFrequency</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/RulesManager.html">RulesManager</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="Structs/RulesManager/UpdateType.html">– UpdateType</a>
+              </li>
+            </ul>
+          </li>
+        </ul>
+      </nav>
+      <article class="main-content">
+        <section>
+          <section class="section">
+            <h1>Classes</h1>
+            <p>The following classes are available globally.</p>
+
+          </section>
+          <section class="section task-group-section">
+            <div class="task-group">
+              <ul>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/c:@M@Siren@objc(cs)Siren"></a>
+                    <a name="//apple_ref/swift/Class/Siren" class="dashAnchor"></a>
+                    <a class="token" href="#/c:@M@Siren@objc(cs)Siren">Siren</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The Siren Class.</p>
+
+                        <a href="Classes/Siren.html" class="slightly-smaller">See more</a>
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">final</span> <span class="kd">class</span> <span class="kt">Siren</span> <span class="p">:</span> <span class="kt">NSObject</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+              </ul>
+            </div>
+            <div class="task-group">
+              <ul>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/c:@M@Siren@objc(cs)SirenViewController"></a>
+                    <a name="//apple_ref/swift/Class/SirenViewController" class="dashAnchor"></a>
+                    <a class="token" href="#/c:@M@Siren@objc(cs)SirenViewController">SirenViewController</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p><code>UIViewController</code> Extension for Siren</p>
+
+                        <a href="Classes/SirenViewController.html" class="slightly-smaller">See more</a>
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">final</span> <span class="kd">class</span> <span class="kt">SirenViewController</span> <span class="p">:</span> <span class="kt">UIViewController</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+              </ul>
+            </div>
+          </section>
+        </section>
+        <section id="footer">
+          <p>&copy; 2019 <a class="link" href="https://github.com/ArtSabintsev/Siren" target="_blank" rel="external">Arthur Ariel Sabintsev</a>. All rights reserved. (Last updated: 2019-02-09)</p>
+          <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.9.5</a>, a <a class="link" href="https://realm.io" target="_blank" rel="external">Realm</a> project.</p>
+        </section>
+      </article>
+    </div>
+  </body>
+</div>
+</html>

docs/Classes/Siren.html

@@ -0,0 +1,986 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <title>Siren Class Reference</title>
+    <link rel="stylesheet" type="text/css" href="../css/jazzy.css" />
+    <link rel="stylesheet" type="text/css" href="../css/highlight.css" />
+    <meta charset='utf-8'>
+    <script src="../js/jquery.min.js" defer></script>
+    <script src="../js/jazzy.js" defer></script>
+    
+  </head>
+  <body>
+    <a name="//apple_ref/swift/Class/Siren" class="dashAnchor"></a>
+    <a title="Siren Class Reference"></a>
+    <header>
+      <div class="content-wrapper">
+        <p><a href="../index.html">Siren Docs</a> (100% documented)</p>
+      </div>
+    </header>
+    <div class="content-wrapper">
+      <p id="breadcrumbs">
+        <a href="../index.html">Siren Reference</a>
+        <img id="carat" src="../img/carat.png" />
+        Siren Class Reference
+      </p>
+    </div>
+    <div class="content-wrapper">
+      <nav class="sidebar">
+        <ul class="nav-groups">
+          <li class="nav-group-name">
+            <a href="../Classes.html">Classes</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="../Classes/Siren.html">Siren</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Classes/SirenViewController.html">SirenViewController</a>
+              </li>
+            </ul>
+          </li>
+          <li class="nav-group-name">
+            <a href="../Enums.html">Enumerations</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="../Enums/AlertAction.html">AlertAction</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Enums/KnownError.html">KnownError</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Enums/PerformCheck.html">PerformCheck</a>
+              </li>
+            </ul>
+          </li>
+          <li class="nav-group-name">
+            <a href="../Extensions.html">Extensions</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="../Extensions/Bundle.html">Bundle</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Extensions/Bundle/Constants.html">– Constants</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Extensions/Date.html">Date</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Extensions/UIAlertController.html">UIAlertController</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Extensions/UserDefaults.html">UserDefaults</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Extensions/UserDefaults/SirenKeys.html">– SirenKeys</a>
+              </li>
+            </ul>
+          </li>
+          <li class="nav-group-name">
+            <a href="../Structs.html">Structures</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="../Structs/APIManager.html">APIManager</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/APIManager/Constants.html">– Constants</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/AlertConstants.html">AlertConstants</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/DataParser.html">DataParser</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/Localization.html">Localization</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/Localization/Language.html">– Language</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/LookupModel.html">LookupModel</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/LookupModel/CodingKeys.html">– CodingKeys</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/LookupModel/Results.html">– Results</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/PresentationManager.html">PresentationManager</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/Results.html">Results</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/Rules.html">Rules</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/Rules/AlertType.html">– AlertType</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/Rules/UpdatePromptFrequency.html">– UpdatePromptFrequency</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/RulesManager.html">RulesManager</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../Structs/RulesManager/UpdateType.html">– UpdateType</a>
+              </li>
+            </ul>
+          </li>
+        </ul>
+      </nav>
+      <article class="main-content">
+        <section>
+          <section class="section">
+            <h1>Siren</h1>
+              <div class="declaration">
+                <div class="language">
+                  <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">final</span> <span class="kd">class</span> <span class="kt">Siren</span> <span class="p">:</span> <span class="kt">NSObject</span></code></pre>
+
+                </div>
+              </div>
+            <p>The Siren Class.</p>
+
+          </section>
+          <section class="section task-group-section">
+            <div class="task-group">
+              <ul>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC14ResultsHandlera"></a>
+                    <a name="//apple_ref/swift/Alias/ResultsHandler" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC14ResultsHandlera">ResultsHandler</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Return results or errors obtained from performing a version check with Siren.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">typealias</span> <span class="kt">ResultsHandler</span> <span class="o">=</span> <span class="p">(</span><span class="kt"><a href="../Structs/Results.html">Results</a></span><span class="p">?,</span> <span class="kt"><a href="../Enums/KnownError.html">KnownError</a></span><span class="p">?)</span> <span class="o">-&gt;</span> <span class="kt">Void</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC6sharedABvpZ"></a>
+                    <a name="//apple_ref/swift/Variable/shared" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC6sharedABvpZ">shared</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The Siren singleton. The main point of entry to the Siren library.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">static</span> <span class="k">let</span> <span class="nv">shared</span><span class="p">:</span> <span class="kt">Siren</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC10apiManagerAA10APIManagerVvp"></a>
+                    <a name="//apple_ref/swift/Property/apiManager" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC10apiManagerAA10APIManagerVvp">apiManager</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The manager that controls the App Store API that is
+used to fetch the latest version of the app.</p>
+
+<p>Defaults to the US App Store.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">lazy</span> <span class="k">var</span> <span class="nv">apiManager</span><span class="p">:</span> <span class="kt"><a href="../Structs/APIManager.html">APIManager</a></span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC19presentationManagerAA012PresentationC0Vvp"></a>
+                    <a name="//apple_ref/swift/Property/presentationManager" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC19presentationManagerAA012PresentationC0Vvp">presentationManager</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The manager that controls the update alert&rsquo;s string localization and tint color.</p>
+
+<p>Defaults the string&rsquo;s lange localization to the user&rsquo;s device localization.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">lazy</span> <span class="k">var</span> <span class="nv">presentationManager</span><span class="p">:</span> <span class="kt"><a href="../Structs/PresentationManager.html">PresentationManager</a></span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC12rulesManagerAA05RulesC0Vvp"></a>
+                    <a name="//apple_ref/swift/Property/rulesManager" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC12rulesManagerAA05RulesC0Vvp">rulesManager</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The manager that controls the type of alert that should be displayed
+and how often an alert should be displayed dpeneding on the type
+of update that is available relative to the installed version of the app
+(e.g., different rules for major, minor, patch and revision updated can be used).</p>
+
+<p>Defaults to performing a version check once a day with an alert that allows
+the user to skip updating the app until the next time the app becomes active or
+skipping the update all together until another version is released.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">lazy</span> <span class="k">var</span> <span class="nv">rulesManager</span><span class="p">:</span> <span class="kt"><a href="../Structs/RulesManager.html">RulesManager</a></span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC23currentInstalledVersionSSSgvp"></a>
+                    <a name="//apple_ref/swift/Property/currentInstalledVersion" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC23currentInstalledVersionSSSgvp">currentInstalledVersion</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The current installed version of your app.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">lazy</span> <span class="k">var</span> <span class="nv">currentInstalledVersion</span><span class="p">:</span> <span class="kt">String</span><span class="p">?</span> <span class="p">{</span> <span class="k">get</span> <span class="k">set</span> <span class="p">}</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC23didBecomeActiveObserverSo8NSObject_pSgvp"></a>
+                    <a name="//apple_ref/swift/Property/didBecomeActiveObserver" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC23didBecomeActiveObserverSo8NSObject_pSgvp">didBecomeActiveObserver</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The retained <code>NotificationCenter</code> observer that listens for <code>UIApplication.didBecomeActiveNotification</code> notifications.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">didBecomeActiveObserver</span><span class="p">:</span> <span class="kt">NSObjectProtocol</span><span class="p">?</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC24willResignActiveObserverSo8NSObject_pSgvp"></a>
+                    <a name="//apple_ref/swift/Property/willResignActiveObserver" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC24willResignActiveObserverSo8NSObject_pSgvp">willResignActiveObserver</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The retained <code>NotificationCenter</code> observer that listens for <code>UIApplication.willResignActiveNotification</code> notifications.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">willResignActiveObserver</span><span class="p">:</span> <span class="kt">NSObjectProtocol</span><span class="p">?</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC26didEnterBackgroundObserverSo8NSObject_pSgvp"></a>
+                    <a name="//apple_ref/swift/Property/didEnterBackgroundObserver" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC26didEnterBackgroundObserverSo8NSObject_pSgvp">didEnterBackgroundObserver</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The retained <code>NotificationCenter</code> observer that listens for <code>UIApplication.didEnterBackgroundNotification</code> notifications.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="k">var</span> <span class="nv">didEnterBackgroundObserver</span><span class="p">:</span> <span class="kt">NSObjectProtocol</span><span class="p">?</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC21alertPresentationDate33_7DFB1BC200A6C64FBED860A3A8153B65LL10Foundation0D0VSgvp"></a>
+                    <a name="//apple_ref/swift/Property/alertPresentationDate" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC21alertPresentationDate33_7DFB1BC200A6C64FBED860A3A8153B65LL10Foundation0D0VSgvp">alertPresentationDate</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The last date that an alert was presented to the user.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">private</span> <span class="k">var</span> <span class="nv">alertPresentationDate</span><span class="p">:</span> <span class="kt">Date</span><span class="p">?</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC5appID33_7DFB1BC200A6C64FBED860A3A8153B65LLSiSgvp"></a>
+                    <a name="//apple_ref/swift/Property/appID" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC5appID33_7DFB1BC200A6C64FBED860A3A8153B65LLSiSgvp">appID</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The App Store&rsquo;s unique identifier for an app.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">private</span> <span class="k">var</span> <span class="nv">appID</span><span class="p">:</span> <span class="kt">Int</span><span class="p">?</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC14resultsHandler33_7DFB1BC200A6C64FBED860A3A8153B65LLyAA7ResultsVSg_AA10KnownErrorOSgtcSgvp"></a>
+                    <a name="//apple_ref/swift/Property/resultsHandler" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC14resultsHandler33_7DFB1BC200A6C64FBED860A3A8153B65LLyAA7ResultsVSg_AA10KnownErrorOSgtcSgvp">resultsHandler</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The completion handler used to return the results or errors returned by Siren.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">private</span> <span class="k">var</span> <span class="nv">resultsHandler</span><span class="p">:</span> <span class="kt">Siren</span><span class="o">.</span><span class="kt"><a href="../Classes/Siren.html#/s:5SirenAAC14ResultsHandlera">ResultsHandler</a></span><span class="p">?</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/c:@M@Siren@objc(cs)Siren(im)dealloc"></a>
+                    <a name="//apple_ref/swift/Method/deinit" class="dashAnchor"></a>
+                    <a class="token" href="#/c:@M@Siren@objc(cs)Siren(im)dealloc">deinit</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>The deinitialization method that clears out all observers,</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">deinit</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+              </ul>
+            </div>
+            <div class="task-group">
+              <div class="task-name-container">
+                <a name="/Public%20API%20Interface"></a>
+                <a name="//apple_ref/swift/Section/Public API Interface" class="dashAnchor"></a>
+                <a href="#/Public%20API%20Interface">
+                  <h3 class="section-name">Public API Interface</h3>
+                </a>
+              </div>
+              <ul>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC4wail12performCheck10completionyAA07PerformD0O_yAA7ResultsVSg_AA10KnownErrorOSgtcSgtF"></a>
+                    <a name="//apple_ref/swift/Method/wail(performCheck:completion:)" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC4wail12performCheck10completionyAA07PerformD0O_yAA7ResultsVSg_AA10KnownErrorOSgtcSgtF">wail(performCheck:completion:)</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>This method executes the Siren version checking and alert presentation flow.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">wail</span><span class="p">(</span><span class="nv">performCheck</span><span class="p">:</span> <span class="kt"><a href="../Enums/PerformCheck.html">PerformCheck</a></span> <span class="o">=</span> <span class="o">.</span><span class="n">onForeground</span><span class="p">,</span>
+          <span class="n">completion</span> <span class="nv">handler</span><span class="p">:</span> <span class="kt"><a href="../Classes/Siren.html#/s:5SirenAAC14ResultsHandlera">ResultsHandler</a></span><span class="p">?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">)</span></code></pre>
+
+                        </div>
+                      </div>
+                      <div>
+                        <h4>Parameters</h4>
+                        <table class="graybox">
+                          <tbody>
+                            <tr>
+                              <td>
+                                <code>
+                                <em>performCheck</em>
+                                </code>
+                              </td>
+                              <td>
+                                <div>
+                                  <p>Defines how the version check flow is entered. Defaults to <code>.onForeground</code>.</p>
+                                </div>
+                              </td>
+                            </tr>
+                            <tr>
+                              <td>
+                                <code>
+                                <em>handler</em>
+                                </code>
+                              </td>
+                              <td>
+                                <div>
+                                  <p>Returns the metadata around a successful version check and interaction with the update modal or it returns nil.</p>
+                                </div>
+                              </td>
+                            </tr>
+                          </tbody>
+                        </table>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC14launchAppStoreyyF"></a>
+                    <a name="//apple_ref/swift/Method/launchAppStore()" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC14launchAppStoreyyF">launchAppStore()</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Launches the AppStore in two situations when the user clicked the <code>Update</code> button in the UIAlertController modal.</p>
+
+<p>This function is marked <code>public</code> as a convenience for those developers who decide to build a custom alert modal
+instead of using Siren&rsquo;s prebuilt update alert.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">launchAppStore</span><span class="p">()</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+              </ul>
+            </div>
+            <div class="task-group">
+              <div class="task-name-container">
+                <a name="/Version%20Check%20and%20Alert%20Presentation%20Flow"></a>
+                <a name="//apple_ref/swift/Section/Version Check and Alert Presentation Flow" class="dashAnchor"></a>
+                <a href="#/Version%20Check%20and%20Alert%20Presentation%20Flow">
+                  <h3 class="section-name">Version Check and Alert Presentation Flow</h3>
+                </a>
+              </div>
+              <ul>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC19performVersionCheck33_7DFB1BC200A6C64FBED860A3A8153B65LLyyF"></a>
+                    <a name="//apple_ref/swift/Method/performVersionCheck()" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC19performVersionCheck33_7DFB1BC200A6C64FBED860A3A8153B65LLyyF">performVersionCheck()</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Initiates the unidirectional version checking flow.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">performVersionCheck</span><span class="p">()</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC8validate33_7DFB1BC200A6C64FBED860A3A8153B65LL5modelyAA11LookupModelV_tF"></a>
+                    <a name="//apple_ref/swift/Method/validate(model:)" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC8validate33_7DFB1BC200A6C64FBED860A3A8153B65LL5modelyAA11LookupModelV_tF">validate(model:)</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Validates the parsed and mapped iTunes Lookup Model
+to guarantee all the relevant data was returned before
+attempting to present an alert.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">validate</span><span class="p">(</span><span class="nv">model</span><span class="p">:</span> <span class="kt"><a href="../Structs/LookupModel.html">LookupModel</a></span><span class="p">)</span></code></pre>
+
+                        </div>
+                      </div>
+                      <div>
+                        <h4>Parameters</h4>
+                        <table class="graybox">
+                          <tbody>
+                            <tr>
+                              <td>
+                                <code>
+                                <em>model</em>
+                                </code>
+                              </td>
+                              <td>
+                                <div>
+                                  <p>The iTunes Lookup Model.</p>
+                                </div>
+                              </td>
+                            </tr>
+                          </tbody>
+                        </table>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC45determineIfAlertPresentationRulesAreSatisfied33_7DFB1BC200A6C64FBED860A3A8153B65LL25forCurrentAppStoreVersion14andLookupModelySS_AA0wX0VtF"></a>
+                    <a name="//apple_ref/swift/Method/determineIfAlertPresentationRulesAreSatisfied(forCurrentAppStoreVersion:andLookupModel:)" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC45determineIfAlertPresentationRulesAreSatisfied33_7DFB1BC200A6C64FBED860A3A8153B65LL25forCurrentAppStoreVersion14andLookupModelySS_AA0wX0VtF">determineIfAlertPresentationRulesAreSatisfied(forCurrentAppStoreVersion:andLookupModel:)</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Determines if the update alert can be presented based on the
+rules set in the <code><a href="../Structs/RulesManager.html">RulesManager</a></code> and the the skip version settings.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">determineIfAlertPresentationRulesAreSatisfied</span><span class="p">(</span><span class="n">forCurrentAppStoreVersion</span> <span class="nv">currentAppStoreVersion</span><span class="p">:</span> <span class="kt">String</span><span class="p">,</span> <span class="n">andLookupModel</span> <span class="nv">model</span><span class="p">:</span> <span class="kt"><a href="../Structs/LookupModel.html">LookupModel</a></span><span class="p">)</span></code></pre>
+
+                        </div>
+                      </div>
+                      <div>
+                        <h4>Parameters</h4>
+                        <table class="graybox">
+                          <tbody>
+                            <tr>
+                              <td>
+                                <code>
+                                <em>currentAppStoreVersion</em>
+                                </code>
+                              </td>
+                              <td>
+                                <div>
+                                  <p>The curren version of the app in the App Store.</p>
+                                </div>
+                              </td>
+                            </tr>
+                            <tr>
+                              <td>
+                                <code>
+                                <em>model</em>
+                                </code>
+                              </td>
+                              <td>
+                                <div>
+                                  <p>The iTunes Lookup Model.</p>
+                                </div>
+                              </td>
+                            </tr>
+                          </tbody>
+                        </table>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC12presentAlert33_7DFB1BC200A6C64FBED860A3A8153B65LL9withRules25forCurrentAppStoreVersion5model13andUpdateTypeyAA0M0V_SSAA11LookupModelVAA0M7ManagerV0uV0OtF"></a>
+                    <a name="//apple_ref/swift/Method/presentAlert(withRules:forCurrentAppStoreVersion:model:andUpdateType:)" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC12presentAlert33_7DFB1BC200A6C64FBED860A3A8153B65LL9withRules25forCurrentAppStoreVersion5model13andUpdateTypeyAA0M0V_SSAA11LookupModelVAA0M7ManagerV0uV0OtF">presentAlert(withRules:forCurrentAppStoreVersion:model:andUpdateType:)</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Presents the update alert to the end user.
+Upon tapping a value on the alert view, a completion handler will return all relevant metadata to the app.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">presentAlert</span><span class="p">(</span><span class="n">withRules</span> <span class="nv">rules</span><span class="p">:</span> <span class="kt"><a href="../Structs/Rules.html">Rules</a></span><span class="p">,</span>
+                  <span class="n">forCurrentAppStoreVersion</span> <span class="nv">currentAppStoreVersion</span><span class="p">:</span> <span class="kt">String</span><span class="p">,</span>
+                  <span class="nv">model</span><span class="p">:</span> <span class="kt"><a href="../Structs/LookupModel.html">LookupModel</a></span><span class="p">,</span>
+                  <span class="n">andUpdateType</span> <span class="nv">updateType</span><span class="p">:</span> <span class="kt"><a href="../Structs/RulesManager.html">RulesManager</a></span><span class="o">.</span><span class="kt">UpdateType</span><span class="p">)</span></code></pre>
+
+                        </div>
+                      </div>
+                      <div>
+                        <h4>Parameters</h4>
+                        <table class="graybox">
+                          <tbody>
+                            <tr>
+                              <td>
+                                <code>
+                                <em>rules</em>
+                                </code>
+                              </td>
+                              <td>
+                                <div>
+                                  <p>The rules for how to present the alert.</p>
+                                </div>
+                              </td>
+                            </tr>
+                            <tr>
+                              <td>
+                                <code>
+                                <em>currentAppStoreVersion</em>
+                                </code>
+                              </td>
+                              <td>
+                                <div>
+                                  <p>The current version of the app in the App Store.</p>
+                                </div>
+                              </td>
+                            </tr>
+                            <tr>
+                              <td>
+                                <code>
+                                <em>model</em>
+                                </code>
+                              </td>
+                              <td>
+                                <div>
+                                  <p>The iTunes Lookup Model.</p>
+                                </div>
+                              </td>
+                            </tr>
+                            <tr>
+                              <td>
+                                <code>
+                                <em>updateType</em>
+                                </code>
+                              </td>
+                              <td>
+                                <div>
+                                  <p>The type of update that is available based on the version found in the App Store.</p>
+                                </div>
+                              </td>
+                            </tr>
+                          </tbody>
+                        </table>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+              </ul>
+            </div>
+            <div class="task-group">
+              <div class="task-name-container">
+                <a name="/Add%20Observers"></a>
+                <a name="//apple_ref/swift/Section/Add Observers" class="dashAnchor"></a>
+                <a href="#/Add%20Observers">
+                  <h3 class="section-name">Add Observers</h3>
+                </a>
+              </div>
+              <ul>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC22addForegroundObservers33_7DFB1BC200A6C64FBED860A3A8153B65LLyyF"></a>
+                    <a name="//apple_ref/swift/Method/addForegroundObservers()" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC22addForegroundObservers33_7DFB1BC200A6C64FBED860A3A8153B65LLyyF">addForegroundObservers()</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Adds an observer that listens for app launching/relaunching.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">addForegroundObservers</span><span class="p">()</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC22addBackgroundObservers33_7DFB1BC200A6C64FBED860A3A8153B65LLyyF"></a>
+                    <a name="//apple_ref/swift/Method/addBackgroundObservers()" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC22addBackgroundObservers33_7DFB1BC200A6C64FBED860A3A8153B65LLyyF">addBackgroundObservers()</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Adds an observer that listens for when the user enters the app switcher
+and when the app is sent to the background.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">addBackgroundObservers</span><span class="p">()</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+              </ul>
+            </div>
+            <div class="task-group">
+              <div class="task-name-container">
+                <a name="/Remove%20Observers"></a>
+                <a name="//apple_ref/swift/Section/Remove Observers" class="dashAnchor"></a>
+                <a href="#/Remove%20Observers">
+                  <h3 class="section-name">Remove Observers</h3>
+                </a>
+              </div>
+              <ul>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC25removeForegroundObservers33_7DFB1BC200A6C64FBED860A3A8153B65LLyyF"></a>
+                    <a name="//apple_ref/swift/Method/removeForegroundObservers()" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC25removeForegroundObservers33_7DFB1BC200A6C64FBED860A3A8153B65LLyyF">removeForegroundObservers()</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Removes the observer that listens for app launching/relaunching.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">removeForegroundObservers</span><span class="p">()</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC25removeBackgroundObservers33_7DFB1BC200A6C64FBED860A3A8153B65LLyyF"></a>
+                    <a name="//apple_ref/swift/Method/removeBackgroundObservers()" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC25removeBackgroundObservers33_7DFB1BC200A6C64FBED860A3A8153B65LLyyF">removeBackgroundObservers()</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Remove the observers that list to app resignation and app backgrounding.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">removeBackgroundObservers</span><span class="p">()</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+              </ul>
+            </div>
+          </section>
+        </section>
+        <section id="footer">
+          <p>&copy; 2019 <a class="link" href="https://github.com/ArtSabintsev/Siren" target="_blank" rel="external">Arthur Ariel Sabintsev</a>. All rights reserved. (Last updated: 2019-02-09)</p>
+          <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.9.5</a>, a <a class="link" href="https://realm.io" target="_blank" rel="external">Realm</a> project.</p>
+        </section>
+      </article>
+    </div>
+  </body>
+</div>
+</html>

docs/Classes/Siren/AlertType.html

@@ -0,0 +1,225 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <title>AlertType Enumeration Reference</title>
+    <link rel="stylesheet" type="text/css" href="../../css/jazzy.css" />
+    <link rel="stylesheet" type="text/css" href="../../css/highlight.css" />
+    <meta charset='utf-8'>
+    <script src="../../js/jquery.min.js" defer></script>
+    <script src="../../js/jazzy.js" defer></script>
+    
+  </head>
+  <body>
+    <a name="//apple_ref/swift/Enum/AlertType" class="dashAnchor"></a>
+    <a title="AlertType Enumeration Reference"></a>
+    <header>
+      <div class="content-wrapper">
+        <p><a href="../../index.html">Siren Docs</a> (100% documented)</p>
+      </div>
+    </header>
+    <div class="content-wrapper">
+      <p id="breadcrumbs">
+        <a href="../../index.html">Siren Reference</a>
+        <img id="carat" src="../../img/carat.png" />
+        AlertType Enumeration Reference
+      </p>
+    </div>
+    <div class="content-wrapper">
+      <nav class="sidebar">
+        <ul class="nav-groups">
+          <li class="nav-group-name">
+            <a href="../../Classes.html">Classes</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="../../Classes/Siren.html">Siren</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Classes/Siren/AlertType.html">– AlertType</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Classes/Siren/VersionCheckType.html">– VersionCheckType</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Classes/Siren/LanguageType.html">– LanguageType</a>
+              </li>
+            </ul>
+          </li>
+          <li class="nav-group-name">
+            <a href="../../Enums.html">Enumerations</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="../../Enums/UpdateType.html">UpdateType</a>
+              </li>
+            </ul>
+          </li>
+          <li class="nav-group-name">
+            <a href="../../Protocols.html">Protocols</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="../../Protocols/SirenDelegate.html">SirenDelegate</a>
+              </li>
+            </ul>
+          </li>
+          <li class="nav-group-name">
+            <a href="../../Structs.html">Structures</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="../../Structs/AlertMessaging.html">AlertMessaging</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Structs/AlertMessaging/Constants.html">– Constants</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Structs/CapturedError.html">CapturedError</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Structs/CapturedError/Known.html">– Known</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Structs/LookupModel.html">LookupModel</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Structs/LookupModel/Results.html">– Results</a>
+              </li>
+            </ul>
+          </li>
+        </ul>
+      </nav>
+      <article class="main-content">
+        <section>
+          <section class="section">
+            <h1>AlertType</h1>
+              <div class="declaration">
+                <div class="language">
+                  <pre class="highlight swift"><code><span class="kd">enum</span> <span class="kt">AlertType</span></code></pre>
+
+                </div>
+              </div>
+            <p>Determines the type of alert to present after a successful version check has been performed.</p>
+
+          </section>
+          <section class="section task-group-section">
+            <div class="task-group">
+              <ul>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC9AlertTypeO5forceA2DmF"></a>
+                    <a name="//apple_ref/swift/Element/force" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC9AlertTypeO5forceA2DmF">force</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Forces user to update your app (1 button alert).</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="k">case</span> <span class="n">force</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC9AlertTypeO6optionA2DmF"></a>
+                    <a name="//apple_ref/swift/Element/option" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC9AlertTypeO6optionA2DmF">option</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>(DEFAULT) Presents user with option to update app now or at next launch (2 button alert).</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="k">case</span> <span class="n">option</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC9AlertTypeO4skipA2DmF"></a>
+                    <a name="//apple_ref/swift/Element/skip" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC9AlertTypeO4skipA2DmF">skip</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Presents user with option to update the app now, at next launch, or to skip this version all together (3 button alert).</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="k">case</span> <span class="n">skip</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC9AlertTypeO4noneA2DmF"></a>
+                    <a name="//apple_ref/swift/Element/none" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC9AlertTypeO4noneA2DmF">none</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Doesn&rsquo;t show the alert, but instead returns a localized message
+for use in a custom UI within the sirenDidDetectNewVersionWithoutAlert() delegate method.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="k">case</span> <span class="k">none</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+              </ul>
+            </div>
+          </section>
+        </section>
+        <section id="footer">
+          <p>&copy; 2018 <a class="link" href="https://github.com/ArtSabintsev/Siren" target="_blank" rel="external">Arthur Ariel Sabintsev and Aaron Brager</a>. All rights reserved. (Last updated: 2018-11-17)</p>
+          <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.9.4</a>, a <a class="link" href="https://realm.io" target="_blank" rel="external">Realm</a> project.</p>
+        </section>
+      </article>
+    </div>
+  </body>
+</div>
+</html>

docs/Classes/Siren/VersionCheckType.html

@@ -0,0 +1,197 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <title>VersionCheckType Enumeration Reference</title>
+    <link rel="stylesheet" type="text/css" href="../../css/jazzy.css" />
+    <link rel="stylesheet" type="text/css" href="../../css/highlight.css" />
+    <meta charset='utf-8'>
+    <script src="../../js/jquery.min.js" defer></script>
+    <script src="../../js/jazzy.js" defer></script>
+    
+  </head>
+  <body>
+    <a name="//apple_ref/swift/Enum/VersionCheckType" class="dashAnchor"></a>
+    <a title="VersionCheckType Enumeration Reference"></a>
+    <header>
+      <div class="content-wrapper">
+        <p><a href="../../index.html">Siren Docs</a> (100% documented)</p>
+      </div>
+    </header>
+    <div class="content-wrapper">
+      <p id="breadcrumbs">
+        <a href="../../index.html">Siren Reference</a>
+        <img id="carat" src="../../img/carat.png" />
+        VersionCheckType Enumeration Reference
+      </p>
+    </div>
+    <div class="content-wrapper">
+      <nav class="sidebar">
+        <ul class="nav-groups">
+          <li class="nav-group-name">
+            <a href="../../Classes.html">Classes</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="../../Classes/Siren.html">Siren</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Classes/Siren/AlertType.html">– AlertType</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Classes/Siren/VersionCheckType.html">– VersionCheckType</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Classes/Siren/LanguageType.html">– LanguageType</a>
+              </li>
+            </ul>
+          </li>
+          <li class="nav-group-name">
+            <a href="../../Enums.html">Enumerations</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="../../Enums/UpdateType.html">UpdateType</a>
+              </li>
+            </ul>
+          </li>
+          <li class="nav-group-name">
+            <a href="../../Protocols.html">Protocols</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="../../Protocols/SirenDelegate.html">SirenDelegate</a>
+              </li>
+            </ul>
+          </li>
+          <li class="nav-group-name">
+            <a href="../../Structs.html">Structures</a>
+            <ul class="nav-group-tasks">
+              <li class="nav-group-task">
+                <a href="../../Structs/AlertMessaging.html">AlertMessaging</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Structs/AlertMessaging/Constants.html">– Constants</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Structs/CapturedError.html">CapturedError</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Structs/CapturedError/Known.html">– Known</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Structs/LookupModel.html">LookupModel</a>
+              </li>
+              <li class="nav-group-task">
+                <a href="../../Structs/LookupModel/Results.html">– Results</a>
+              </li>
+            </ul>
+          </li>
+        </ul>
+      </nav>
+      <article class="main-content">
+        <section>
+          <section class="section">
+            <h1>VersionCheckType</h1>
+              <div class="declaration">
+                <div class="language">
+                  <pre class="highlight swift"><code><span class="kd">enum</span> <span class="kt">VersionCheckType</span> <span class="p">:</span> <span class="kt">Int</span></code></pre>
+
+                </div>
+              </div>
+            <p>Determines the frequency in which the the version check is performed and the user is prompted to update the app.</p>
+
+          </section>
+          <section class="section task-group-section">
+            <div class="task-group">
+              <ul>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC16VersionCheckTypeO11immediatelyA2DmF"></a>
+                    <a name="//apple_ref/swift/Element/immediately" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC16VersionCheckTypeO11immediatelyA2DmF">immediately</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Version check performed every time the app is launched.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="k">case</span> <span class="n">immediately</span> <span class="o">=</span> <span class="mi">0</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC16VersionCheckTypeO5dailyA2DmF"></a>
+                    <a name="//apple_ref/swift/Element/daily" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC16VersionCheckTypeO5dailyA2DmF">daily</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Version check performed once a day.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="k">case</span> <span class="n">daily</span> <span class="o">=</span> <span class="mi">1</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+                <li class="item">
+                  <div>
+                    <code>
+                    <a name="/s:5SirenAAC16VersionCheckTypeO6weeklyA2DmF"></a>
+                    <a name="//apple_ref/swift/Element/weekly" class="dashAnchor"></a>
+                    <a class="token" href="#/s:5SirenAAC16VersionCheckTypeO6weeklyA2DmF">weekly</a>
+                    </code>
+                  </div>
+                  <div class="height-container">
+                    <div class="pointer-container"></div>
+                    <section class="section">
+                      <div class="pointer"></div>
+                      <div class="abstract">
+                        <p>Version check performed once a week.</p>
+
+                      </div>
+                      <div class="declaration">
+                        <h4>Declaration</h4>
+                        <div class="language">
+                          <p class="aside-title">Swift</p>
+                          <pre class="highlight swift"><code><span class="k">case</span> <span class="n">weekly</span> <span class="o">=</span> <span class="mi">7</span></code></pre>
+
+                        </div>
+                      </div>
+                    </section>
+                  </div>
+                </li>
+              </ul>
+            </div>
+          </section>
+        </section>
+        <section id="footer">
+          <p>&copy; 2018 <a class="link" href="https://github.com/ArtSabintsev/Siren" target="_blank" rel="external">Arthur Ariel Sabintsev and Aaron Brager</a>. All rights reserved. (Last updated: 2018-11-17)</p>
+          <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.9.4</a>, a <a class="link" href="https://realm.io" target="_blank" rel="external">Realm</a> project.</p>
+        </section>
+      </article>
+    </div>
+  </body>
+</div>
+</html>