Add ParseAnalytics (#148)

* Add analytics

* testcases

* add testcases and playgrounds

* Use for iOS only

* test cases use iOS

* Test debugDescritption

* prep

* Add == query

* only run on iOS

* Fix ACL debugDescription

* another fix to ACL unit test

* Fix delete file. Increase codecov. Improve playground examples

* Add app tracking check. Make properties public. Make types Hashable when possible.

* Fix macOS Analytics tests

* nits

* Add non-mutating version of tracking an event

* nit

* nit testcases

Author: cbaker6

CHANGELOG.md

@@ -1,12 +1,22 @@
 # Parse-Swift Changelog
 
 ### main
-[Full Changelog](https://github.com/parse-community/Parse-Swift/compare/1.7.2...main)
+[Full Changelog](https://github.com/parse-community/Parse-Swift/compare/1.8.0...main)
 * _Contributing to this repo? Add info about your change here to be included in the next release_
 
+### 1.8.0
+[Full Changelog](https://github.com/parse-community/Parse-Swift/compare/1.7.2...1.8.0)
+
+__New features__
+- Add ParseAnalytics. Requires app tracking authorization in latest OS's ([#147](https://github.com/parse-community/Parse-Swift/pull/147)), thanks to [Corey Baker](https://github.com/cbaker6).
+
 __Improvements__
+- Adds the ability to directly use == as a QueryConstraint on a field that's a ParseObject ([#147](https://github.com/parse-community/Parse-Swift/pull/147)), thanks to [Corey Baker](https://github.com/cbaker6).
 - Future proof SDK by always sending client version header. Also added http method PATCH to API for future use ([#146](https://github.com/parse-community/Parse-Swift/pull/146)), thanks to [Corey Baker](https://github.com/cbaker6).
 
+__Fixes__
+- Fixed an error that occured when deleting a ParseFile which resulted in the file being downloaded locally ([#147](https://github.com/parse-community/Parse-Swift/pull/147)), thanks to [Corey Baker](https://github.com/cbaker6).
+
 ### 1.7.2
 [Full Changelog](https://github.com/parse-community/Parse-Swift/compare/1.7.1...1.7.2)
 

ParseSwift.playground/Pages/16 - Analytics.xcplaygroundpage/Contents.swift

@@ -0,0 +1,40 @@
+//: [Previous](@previous)
+
+//: For this page, make sure your build target is set to ParseSwift (macOS) and targeting
+//: `My Mac` or whatever the name of your mac is. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = macOS`. This is because
+//: Keychain in iOS Playgrounds behaves differently. Every page in Playgrounds should
+//: be set to build for `macOS` unless specified.
+
+import PlaygroundSupport
+import Foundation
+import ParseSwift
+
+PlaygroundPage.current.needsIndefiniteExecution = true
+initializeParse()
+
+//: To track when the app has been opened, do the following.
+ParseAnalytics.trackAppOpened { result in
+    if case .success = result {
+        print("Saved analytics for app opened.")
+    }
+}
+
+//: To track any event, do the following.
+var friendEvent = ParseAnalytics(name: "openedFriendList")
+friendEvent.track { result in
+    if case .success = result {
+        print("Saved analytics for custom event.")
+    }
+}
+
+//: You can also add dimensions to your analytics.
+friendEvent.track(dimensions: ["more": "info"]) { result in
+    if case .success = result {
+        print("Saved analytics for custom event with dimensions.")
+    }
+}
+
+PlaygroundPage.current.finishExecution()
+
+//: [Next](@next)

ParseSwift.playground/Pages/8 - Pointers.xcplaygroundpage/Contents.swift

@@ -47,7 +47,7 @@ struct Author: ParseObject {
     }
 }
 
-let newBook = Book(title: "hello")
+var newBook = Book(title: "hello")
 let author = Author(name: "Alice", book: newBook)
 
 author.save { result in
@@ -114,6 +114,9 @@ let query2 = Author.query("name" == "Bruce")
 query2.first { results in
     switch results {
     case .success(let author):
+        //: Save the book to use later
+        newBook = author.book
+
         print("Found author and included \"book\": \(author)")
 
     case .failure(let error):
@@ -139,5 +142,23 @@ query3.first { results in
     }
 }
 
+//: You can also check if a field is equal to a ParseObject.
+do {
+    let query4 = try Author.query("book" == newBook)
+        .includeAll()
+
+    query4.first { results in
+        switch results {
+        case .success(let author):
+            print("Found author and included all: \(author)")
+
+        case .failure(let error):
+            assertionFailure("Error querying: \(error)")
+        }
+    }
+} catch {
+    print("\(error)")
+}
+
 PlaygroundPage.current.finishExecution()
 //: [Next](@next)

ParseSwift.playground/contents.xcplayground

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<playground version='6.0' target-platform='macos' display-mode='raw' buildActiveScheme='true' timelineScrubberEnabled='true' last-migration='1130'>
+<playground version='6.0' target-platform='macos' display-mode='raw' buildActiveScheme='true' last-migration='1130'>
     <pages>
         <page name='1 - Your first Object'/>
         <page name='2 - Finding Objects'/>
@@ -16,5 +16,6 @@
         <page name='13 - Operations'/>
         <page name='14 - Config'/>
         <page name='15 - Custom ObjectId'/>
+        <page name='16 - Analytics'/>
     </pages>
-</playground>
+</playground>

ParseSwift.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name     = "ParseSwift"
-  s.version  = "1.7.2"
+  s.version  = "1.8.0"
   s.summary  = "Parse Pure Swift SDK"
   s.homepage = "https://github.com/parse-community/Parse-Swift"
   s.authors = {