Version 1.0.0 for release

Author: phillwiggins

.idea/workspace.xml

@@ -1,3 +1,7 @@
+## 1.0.1
+
+Added documentation and GeoPoints
+
 ## 1.0.0
 
 First full release!

CHANGELOG.md

@@ -4,7 +4,7 @@
 ## Parse For Flutter! 
 Hi, this is a Flutter plugin that allows communication with a Parse Server, (https://parseplatform.org) either hosted on your own server or another, like (http://Back4App.com).
 
-This is a work in project 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.
+This is a work in project 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.
 
 ## Join in!
 Want to get involved? Join our Slack channel and help out! (http://flutter-parse-sdk.slack.com)
@@ -13,7 +13,7 @@ Want to get involved? Join our Slack channel and help out! (http://flutter-parse
 To install, either add to your pubspec.yaml
 ```
 dependencies:  
-	parse_server_sdk: ^0.0.4
+	parse_server_sdk: ^1.0.1
 ```
 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.
 
@@ -170,6 +170,7 @@ Main:
 * Objects
 * Queries
 * LiveQueries
+* GeoPoints
 * Debug Mode - Logging API calls
 * Manage Session ID's tokens
 

README.md

@@ -75,7 +75,7 @@ class _MyAppState extends State<MyApp> {
   }
 
   void getSingleItem() async {
-    var response = await DietPlan().get('R5EonpUDWy');
+    var response = await DietPlan().getObject('R5EonpUDWy');
 
     if (response.success) {
       print(ApplicationConstants.APP_NAME + ": " + (response.result as DietPlan).toString());

example/lib/main.dart

@@ -11,7 +11,6 @@ import 'package:web_socket_channel/io.dart';
 
 part 'src/base/parse_constants.dart';
 part 'src/data/parse_data.dart';
-part 'src/data/parse_data_objects.dart';
 part 'src/data/parse_data_server.dart';
 part 'src/data/parse_data_user.dart';
 part 'src/enums/parse_enum_function_call.dart';
@@ -23,30 +22,44 @@ part 'src/network/parse_query.dart';
 part 'src/objects/parse_base.dart';
 part 'src/objects/parse_exception.dart';
 part 'src/objects/parse_function.dart';
+part 'src/objects/parse_geo_point.dart';
 part 'src/objects/parse_object.dart';
 part 'src/objects/parse_response.dart';
 part 'src/objects/parse_user.dart';
-
 part 'src/utils/parse_utils_date.dart';
 part 'src/utils/parse_utils_objects.dart';
+part 'src/utils/parse_utils.dart';
 
 class Parse {
   ParseDataServer data;
   final ParseHTTPClient client = new ParseHTTPClient();
 
-  Parse initialize(appId, serverUrl, {debug, appName, liveQueryUrl, masterKey, sessionId}) {
-    ParseDataServer.init(appId,
-        serverUrl,
+  /// To initialise Parse Server in your application
+  ///
+  /// This should be initialised in MyApp() creation
+  ///
+  /// ```
+  /// Parse().initialize(
+  //        "PARSE_APP_ID",
+  //        "https://parse.myaddress.com/parse/,
+  //        masterKey: "asd23rjh234r234r234r",
+  //        debug: true,
+  //        liveQuery: true);
+  // ```
+  Parse initialize(appId, serverUrl,
+      {debug, appName, liveQueryUrl, masterKey, sessionId}) {
+    ParseDataServer.init(appId, serverUrl,
         debug: debug,
         appName: appName,
         liveQueryUrl: liveQueryUrl,
         masterKey: masterKey,
         sessionId: sessionId);
 
-    return newInstance(ParseDataServer());
+    return _newInstance(ParseDataServer());
   }
 
-  Parse newInstance(ParseDataServer data) {
+  /// Creates a singleton instance of [ParseDataServer] that contains all the server information
+  Parse _newInstance(ParseDataServer data) {
     var parse = Parse();
     parse.data = data;
     parse.client.data = data;

lib/parse.dart

@@ -1,5 +1,6 @@
 part of flutter_parse_sdk;
 
+/// Class containing all constants for this library
 class ParseConstants {
 
   static const String PARSE_DATE_FORMAT = "yyyy-MM-dd'T'HH:mm";

lib/src/base/parse_constants.dart

@@ -1,9 +1,14 @@
 part of flutter_parse_sdk;
 
+/// Singleton class that defines all user keys and data
 class ParseDataServer {
   static ParseDataServer _instance;
   static ParseDataServer get instance => _instance;
 
+  /// Creates an instance of Parse Server
+  ///
+  /// This class should not be user unless switching servers during the app,
+  /// which is odd. Should only be user by Parse.init
   static void init(appId, serverUrl, {debug, appName, liveQueryUrl, masterKey, sessionId}){
       _instance = ParseDataServer._init(appId, serverUrl);
 
@@ -28,6 +33,10 @@ class ParseDataServer {
 
   factory ParseDataServer() => _instance;
 
+  /// Sets the current sessionId.
+  ///
+  /// This is generated when a users logs in, or calls currentUser to update
+  /// their keys
   void setSessionId(String sessionId){
     this.sessionId = sessionId;
   }

lib/src/data/parse_data.dart

@@ -1,38 +1,48 @@
 part of flutter_parse_sdk;
 
+/// User class that contains the current user data
 class User extends ParseBase {
   static User _instance;
 
   static User get instance => _instance;
 
+  /// Creates an instance of a ParseUser
   static void init(username, password, emailAddress) =>
       _instance ??= User._init(username, password, emailAddress);
 
+  /// Clears user data to mimic logout
+  static void logout() => _instance = null;
+
   String acl;
   String username;
   String password;
   String emailAddress;
 
+  /// Creates a singleton instance of a user.
+  ///
+  /// There can only be one user
   User._init(this.username, this.password, this.emailAddress): super();
 
   factory User() => _instance;
 
+  /// Returns a [User] from a [Map] object
   fromJson(Map objectData) {
     if (getObjectData() == null) setObjectData(objectData);
     getObjectData().addAll(objectData);
-    if (getObjectData().containsKey(ParseConstants.OBJECT_ID)) objectId = getValue(ParseConstants.OBJECT_ID).toString();
-    if (getObjectData().containsKey(ParseConstants.CREATED_AT)) createdAt = convertStringToDateTime(getValue(ParseConstants.CREATED_AT).toString());
-    if (getObjectData().containsKey(ParseConstants.UPDATED_AT)) updatedAt = convertStringToDateTime(getValue(ParseConstants.UPDATED_AT).toString());
-    if (getObjectData().containsKey(ACL)) acl = getValue(ACL).toString();
-    if (getObjectData().containsKey(USERNAME)) username = getValue(USERNAME).toString();
-    if (getObjectData().containsKey(PASSWORD)) password = getValue(PASSWORD).toString();
-    if (getObjectData().containsKey(EMAIL)) emailAddress = getValue(EMAIL).toString();
+    if (getObjectData().containsKey(ParseConstants.OBJECT_ID)) objectId = get(ParseConstants.OBJECT_ID).toString();
+    if (getObjectData().containsKey(ParseConstants.CREATED_AT)) createdAt = convertStringToDateTime(get(ParseConstants.CREATED_AT).toString());
+    if (getObjectData().containsKey(ParseConstants.UPDATED_AT)) updatedAt = convertStringToDateTime(get(ParseConstants.UPDATED_AT).toString());
+    if (getObjectData().containsKey(ACL)) acl = get(ACL).toString();
+    if (getObjectData().containsKey(USERNAME)) username = get(USERNAME).toString();
+    if (getObjectData().containsKey(PASSWORD)) password = get(PASSWORD).toString();
+    if (getObjectData().containsKey(EMAIL)) emailAddress = get(EMAIL).toString();
 
     if (updatedAt == null) updatedAt = createdAt;
 
     return this;
   }
 
+  /// Returns a JSON string of the current user
   Map<String, dynamic> toJson() => {
         ACL: acl,
         USERNAME: username,