Merge pull request #650 from parse-community/nullsafety

Release V3.1.0

Author: RodrigoSMarques

.gitignore

@@ -1,17 +1,64 @@
+# Miscellaneous
+*.class
+*.lock
+*.log
+*.pyc
+*.swp
 .DS_Store
-.dart_tool/
+.atom/
+.buildlog/
 .history
-.packages
-.pub/
-pubspec.lock
-.example/lib/application_constants.dart
+.svn/
 
 # IntelliJ related
 *.iml
 *.ipr
 *.iws
 .idea/
 
+# Visual Studio Code related
+.classpath
+.project
+.settings/
+.vscode/
+
+# Flutter repo-specific
+/bin/cache/
+/bin/internal/bootstrap.bat
+/bin/internal/bootstrap.sh
+/bin/mingit/
+/dev/benchmarks/mega_gallery/
+/dev/bots/.recipe_deps
+/dev/bots/android_tools/
+/dev/devicelab/ABresults*.json
+/dev/docs/doc/
+/dev/docs/flutter.docs.zip
+/dev/docs/lib/
+/dev/docs/pubspec.yaml
+/dev/integration_tests/**/xcuserdata
+/dev/integration_tests/**/Pods
+/packages/flutter/coverage/
+version
+analysis_benchmark.json
+
+# packages file containing multi-root paths
+.packages.generated
+
+# Flutter/Dart/Pub related
+**/doc/api/
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+**/generated_plugin_registrant.dart
+.packages
+.pub-cache/
+.pub/
+build/
+flutter_*.png
+linked_*.ds
+unlinked.ds
+unlinked_spec.ds
+
 # Android related
 **/android/**/gradle-wrapper.jar
 **/android/.gradle
@@ -20,16 +67,52 @@ pubspec.lock
 **/android/gradlew.bat
 **/android/local.properties
 **/android/**/GeneratedPluginRegistrant.java
+**/android/key.properties
+*.jks
 
+# iOS/XCode related
+**/ios/**/*.mode1v3
+**/ios/**/*.mode2v3
+**/ios/**/*.moved-aside
+**/ios/**/*.pbxuser
+**/ios/**/*.perspectivev3
+**/ios/**/*sync/
+**/ios/**/.sconsign.dblite
+**/ios/**/.tags*
+**/ios/**/.vagrant/
+**/ios/**/DerivedData/
+**/ios/**/Icon?
+**/ios/**/Pods/
+**/ios/**/.symlinks/
+**/ios/**/profile
+**/ios/**/xcuserdata
+**/ios/.generated/
+**/ios/Flutter/.last_build_id
+**/ios/Flutter/App.framework
+**/ios/Flutter/Flutter.framework
+**/ios/Flutter/Flutter.podspec
+**/ios/Flutter/Generated.xcconfig
+**/ios/Flutter/ephemeral
+**/ios/Flutter/app.flx
+**/ios/Flutter/app.zip
+**/ios/Flutter/flutter_assets/
 **/ios/Flutter/flutter_export_environment.sh
+**/ios/ServiceDefinitions.json
+**/ios/Runner/GeneratedPluginRegistrant.*
 
-build/
-.idea
-example/ios/Frameworks/
-example/lib/ui/
+# macOS
+**/macos/Flutter/GeneratedPluginRegistrant.swift
 
-example_livelist/lib/application_constants.dart
+# Coverage
+coverage/
 
-.flutter-plugins-dependencies
+# Symbols
+app.*.symbols
 
-.vscode/
+# Exceptions to above rules.
+!**/ios/**/default.mode1v3
+!**/ios/**/default.mode2v3
+!**/ios/**/default.pbxuser
+!**/ios/**/default.perspectivev3
+!/packages/flutter_tools/test/data/dart_dependencies_test/**/.packages
+!/dev/ci/**/Gemfile.lock

.travis.yml

@@ -11,10 +11,13 @@ install:
 
 script:
   - (cd packages/dart && pub get)
+  - (cd packages/dart && dart run build_runner build --delete-conflicting-outputs)
   - (cd packages/dart && pub run test)
+  - (cd packages/flutter && flutter pub remove parse_server_sdk)
+  - (cd packages/flutter && flutter pub add parse_server_sdk --path ../dart)
   - (cd packages/flutter && flutter pub get)
   - (cd packages/flutter && flutter test --no-pub test/)
 
 cache:
   directories:
-    - "$HOME/.pub-cache"
+    - "$HOME/.pub-cache"

packages/dart/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 3.1.0
+Bug fixes
+General improvements
+Updated dependencies
+
+## 3.0.0
+Stable null safety release.
+
 ## 2.1.0
 Option para uses ParseHTTPClient (default) or ParseDioClient (slow on Flutter Web).
     **BREAKING CHANGE** if use progress callback at the file upload in version 2.0.1
@@ -6,6 +14,7 @@ Changed to the method POST on Login
 Bug fixes
 General improvements
 Updated dependencies
+
 ## 2.0.1
 Fixed network exceptions. [#482](https://github.com/parse-community/Parse-SDK-Flutter/pull/482)
 

packages/dart/README.md

@@ -17,13 +17,8 @@ This is a Dart package that allows communication with a Parse Server, (https://p
 This is a work in progress and we are consistently updating it. Please let us know if you think anything needs changing/adding, and more than ever, please do join in on this project. (Even if it is just to improve our documentation)
 
 ## Getting Started
-To install, either add to your pubspec.yaml
-```yml
-dependencies:  
-    parse_server_sdk: ^2.1.0
-```
-or clone this repository and add to your project. As this is an early development with multiple contributors, it is probably best to download/clone and keep updating as an when a new feature is added.
 
+To install, either add [dependency in your pubspec.yaml file](https://pub.dev/packages/parse_server_sdk/install).
 
 Once you have the library added to your project, upon first call to your app (Similar to what your application class would be) add the following...
 
@@ -66,7 +61,6 @@ When running via express, set [ParseServerOptions](https://parseplatform.org/par
 
 Be aware that for web ParseInstallation does include app name, version or package identifier.
 
-
 ## Objects
 You can create custom objects by calling:
 ```dart
@@ -248,6 +242,15 @@ if (dietPlan.success) {
 }
 ```
 
+### Alternative query methods
+
+The standard query method `query()` returns a `ParseResponse` that contains the result or the error. As an alternative, you can also use `Future<List<T>> find()` for receiving options.
+This method returns an `Future` that either resolves in an error (equivalent of the error in the `ParseResponse`) or an `List` containing the queried objects. One difference, you should be aware of, is the fact, that `Future<List<T>> find()` will return an empty list instead of the 'No results' error you receive in case no object matches you query.
+
+Choosing between `query()` and `find()` comes down to personal preference. Both methods can be used for querying a `ParseQuery`, just the output method differs.
+
+Similar to `find()` the `QueryBuilder` also has a function called `Future<T>? first()`. Just like `find()` `first()` is just a convenience method that makes querying the first object satisfying the query simpler. `first()` returns an `Future`, that resoles in an error or the first object matching the query. In case no object satisfies the query, the result will be `null`.
+
 ## Complex queries
 You can create complex queries to really put your database to the test:
 
@@ -303,6 +306,7 @@ The features available are:-
  * WithinKilometers
  * WithinRadians
  * WithinGeoBox
+ * WithinPolygon
  * MatchesQuery
  * DoesNotMatchQuery
  * MatchesKeyInQuery

packages/dart/analysis_options.yaml

@@ -6,11 +6,9 @@ import 'dart:io';
 import 'dart:math';
 import 'dart:typed_data';
 
+import 'package:dio/dio.dart';
 import 'package:meta/meta.dart';
 import 'package:mime_type/mime_type.dart';
-import 'package:parse_server_sdk/src/network/parse_http_client.dart';
-import 'package:parse_server_sdk/src/network/parse_websocket.dart'
-    as parse_web_socket;
 import 'package:path/path.dart' as path;
 import 'package:sembast/sembast.dart';
 import 'package:sembast/sembast_io.dart';
@@ -19,6 +17,9 @@ import 'package:uuid/uuid.dart';
 import 'package:web_socket_channel/web_socket_channel.dart';
 import 'package:xxtea/xxtea.dart';
 
+import 'src/network/parse_http_client.dart';
+import 'src/network/parse_websocket.dart' as parse_web_socket;
+
 export 'src/network/parse_dio_client.dart';
 export 'src/network/parse_http_client.dart';
 
@@ -60,14 +61,12 @@ part 'src/storage/xxtea_codec.dart';
 part 'src/utils/parse_date_format.dart';
 part 'src/utils/parse_decoder.dart';
 part 'src/utils/parse_encoder.dart';
-part 'src/utils/parse_file_extensions.dart';
 part 'src/utils/parse_live_list.dart';
 part 'src/utils/parse_logger.dart';
 part 'src/utils/parse_login_helpers.dart';
 part 'src/utils/parse_utils.dart';
 
 class Parse {
-  ParseCoreData data;
   bool _hasBeenInitialized = false;
 
   /// To initialize Parse Server in your application
@@ -86,25 +85,25 @@ class Parse {
     String appId,
     String serverUrl, {
     bool debug = false,
-    String appName,
-    String appVersion,
-    String appPackageName,
-    String locale,
-    String liveQueryUrl,
-    String clientKey,
-    String masterKey,
-    String sessionId,
+    String? appName,
+    String? appVersion,
+    String? appPackageName,
+    String? locale,
+    String? liveQueryUrl,
+    String? clientKey,
+    String? masterKey,
+    String? sessionId,
     bool autoSendSessionId = true,
-    SecurityContext securityContext,
-    CoreStore coreStore,
-    Map<String, ParseObjectConstructor> registeredSubClassMap,
-    ParseUserConstructor parseUserConstructor,
-    ParseFileConstructor parseFileConstructor,
-    List<int> liveListRetryIntervals,
-    ParseConnectivityProvider connectivityProvider,
-    String fileDirectory,
-    Stream<void> appResumedStream,
-    ParseClientCreator clientCreator,
+    SecurityContext? securityContext,
+    CoreStore? coreStore,
+    Map<String, ParseObjectConstructor>? registeredSubClassMap,
+    ParseUserConstructor? parseUserConstructor,
+    ParseFileConstructor? parseFileConstructor,
+    List<int>? liveListRetryIntervals,
+    ParseConnectivityProvider? connectivityProvider,
+    String? fileDirectory,
+    Stream<void>? appResumedStream,
+    ParseClientCreator? clientCreator,
   }) async {
     final String url = removeTrailingSlash(serverUrl);
 
@@ -140,10 +139,8 @@ class Parse {
 
   bool hasParseBeenInitialized() => _hasBeenInitialized;
 
-  Future<ParseResponse> healthCheck(
-      {bool debug, ParseClient client, bool sendSessionIdByDefault}) async {
-    ParseResponse parseResponse;
-
+  Future<ParseResponse > healthCheck(
+      {bool? debug, ParseClient? client, bool? sendSessionIdByDefault}) async {
     final bool _debug = isDebugEnabled(objectLevelDebug: debug);
 
     final ParseClient _client = client ??
@@ -158,12 +155,9 @@ class Parse {
     try {
       final ParseNetworkResponse response =
           await _client.get('${ParseCoreData().serverUrl}$keyEndPointHealth');
-      parseResponse =
-          handleResponse<Parse>(null, response, type, _debug, className);
+      return handleResponse<Parse>(null, response, type, _debug, className);
     } on Exception catch (e) {
-      parseResponse = handleException(e, type, _debug, className);
+      return handleException(e, type, _debug, className);
     }
-
-    return parseResponse;
   }
 }

packages/dart/lib/parse_server_sdk.dart

@@ -1,7 +1,7 @@
 part of flutter_parse_sdk;
 
 // Library
-const String keySdkVersion = '2.1.0';
+const String keySdkVersion = '3.1.0';
 const String keyLibraryName = 'Flutter Parse SDK';
 
 // End Points