nano-store 0.5.2 → 0.6.0

data/vendor/Pods/BuildHeaders/NanoStore/NSFNanoSearch.h

@@ -175,7 +175,11 @@
 /** * The sort holds an array of one or more sort descriptors of type \link NSFNanoSortDescriptor NSFNanoSortDescriptor \endlink. */
 @property (nonatomic, strong, readwrite) NSArray *sort;
 /** * The filterClass allows to filter the results based on a specific object class. */
-@property (nonatomic, strong, readwrite) NSString *filterClass;
+@property (nonatomic, copy, readwrite) NSString *filterClass;
+/** * If an expression has an offset clause, then the first M rows are omitted from the result set returned by the search operation and the next N rows are returned, where M and N are the values that the offset and limit clauses evaluate to, respectively. Or, if the search would return less than M+N rows if it did not have a limit clause, then the first M rows are skipped and the remaining rows (if any) are returned. */
+@property (nonatomic, assign, readwrite) NSUInteger offset;
+/** * The limit clause is used to place an upper bound on the number of rows returned by a Search operation. */
+@property (nonatomic, assign, readwrite) NSUInteger limit;
 
 /** @name Creating and Initializing a Search
  */
@@ -277,7 +281,7 @@
  * NSFNanoSearch *search = [NSFNanoSearch searchWithStore:nanoStore];
  *
  * // Perform the search
- * // The query will be rewritten as @"SELECT NSFKey, NSFPlist, NSFObjectClass FROM NSFKeys"
+ * // The query will be rewritten as @"SELECT NSFKey, NSFKeyedArchive, NSFObjectClass FROM NSFKeys"
  * NSDictionary *results = [search executeSQL:@"SELECT foo, bar FROM NSFKeys" returnType:NSFReturnObjects error:nil];
  * @endcode
  * @note The sort descriptor will be ignored when executing custom SQL statements.
@@ -380,4 +384,14 @@
 
 //@}
 
+/** Returns a string representation of the search.
+ */
+
+- (NSString *)description;
+
+/** Returns a JSON representation of the search.
+ */
+
+- (NSString *)JSONDescription;
+
 @end

data/vendor/Pods/BuildHeaders/NanoStore/NSFNanoSortDescriptor.h

@@ -75,7 +75,7 @@
 @interface NSFNanoSortDescriptor : NSObject
 
 /** * The property key to use when performing a comparison */
-@property (nonatomic, readonly) NSString *attribute;
+@property (nonatomic, copy, readonly) NSString *attribute;
 /** * The property to indicate whether the comparison should be performed in ascending mode */
 @property (nonatomic, readonly) BOOL isAscending;
 
@@ -119,6 +119,12 @@
 
 - (NSString *)description;
 
+/** Returns a JSON representation of the sort.
+ * @note Check properties attribute and isAscending to find out the current state of the sort.
+ */
+
+- (NSString *)JSONDescription;
+
 //@}
 
 @end

data/vendor/Pods/BuildHeaders/NanoStore/NSFNanoStore.h

@@ -297,6 +297,13 @@
 
 - (NSFNanoBag *)bagWithName:(NSString *)theName;
 
+/** * Retrieves all bags associated with the specified name.
+ * @param theName the name of the bag.
+ * @returns The bags that match the specified name, an empty array otherwise.
+ */
+
+- (NSArray *)bagsWithName:(NSString *)theName;
+
 /** * Returns a new array containing the bags found in the document store matching the specified list of keys.
  * @param theKeys the list of bag keys.
  * @returns An array with the bags that match the specified list of keys.
@@ -470,6 +477,11 @@
 
 - (NSString *)description;
 
+/** Returns a JSON representation of the store.
+ */
+
+- (NSString *)JSONDescription;
+
 //@}
 
 @end

data/vendor/Pods/BuildHeaders/NanoStore/NSFNanoStore_Private.h

@@ -25,10 +25,12 @@
  */
 
 #import "NSFNanoStore.h"
+#import "NSFOrderedDictionary.h"
 
 /** \cond */
 
 @interface NSFNanoStore (Private)
+- (NSFOrderedDictionary *)dictionaryDescription;
 + (NSFNanoStore *)_createAndOpenDebugDatabase;
 - (NSFNanoResult *)_executeSQL:(NSString *)theSQLStatement;
 - (NSString*)_nestedDescriptionWithPrefixedSpace:(NSString *)prefixedSpace;
@@ -37,7 +39,7 @@
 - (void)_setIsOurTransaction:(BOOL)value;
 - (BOOL)_isOurTransaction;
 - (BOOL)_setupCachingSchema;
-- (BOOL)_storeDictionary:(NSDictionary *)someInfo forKey:(NSString *)aKey forClassNamed:(NSString *)classType usingSQLite3Statement:(sqlite3_stmt *)storeValuesStatement error:(out NSError **)outError;
+- (BOOL)_storeDictionary:(NSDictionary *)someInfo forKey:(NSString *)aKey forClassNamed:(NSString *)classType error:(out NSError **)outError;
 - (BOOL)__storeDictionaries:(NSArray *)someObjects forKeys:(NSArray *)someKeys error:(out NSError **)outError;
 - (BOOL)_bindValue:(id)aValue forAttribute:(NSString *)anAttribute parameterNumber:(NSInteger)aParamNumber usingSQLite3Statement:(sqlite3_stmt *)aStatement;
 - (BOOL)_checkNanoStoreIsReadyAndReturnError:(out NSError **)outError;

data/vendor/Pods/BuildHeaders/NanoStore/NSFOrderedDictionary.h

@@ -0,0 +1,33 @@
+//
+//  NSFOrderedDictionary.h
+//  OrderedDictionary
+//
+//  Created by Matt Gallagher on 19/12/08.
+//  Copyright 2008 Matt Gallagher. All rights reserved.
+//
+//  v2 - ARC-compliant (Tito Ciuro)
+//  v1 - Initial release (Matt Gallagher)
+//
+//  This software is provided 'as-is', without any express or implied
+//  warranty. In no event will the authors be held liable for any damages
+//  arising from the use of this software. Permission is granted to anyone to
+//  use this software for any purpose, including commercial applications, and to
+//  alter it and redistribute it freely, subject to the following restrictions:
+//
+//  1. The origin of this software must not be misrepresented; you must not
+//     claim that you wrote the original software. If you use this software
+//     in a product, an acknowledgment in the product documentation would be
+//     appreciated but is not required.
+//  2. Altered source versions must be plainly marked as such, and must not be
+//     misrepresented as being the original software.
+//  3. This notice may not be removed or altered from any source
+//     distribution.
+//
+
+@interface NSFOrderedDictionary : NSMutableDictionary
+
+- (void)insertObject:(id)anObject forKey:(id)aKey atIndex:(NSUInteger)anIndex;
+- (id)keyAtIndex:(NSUInteger)anIndex;
+- (NSEnumerator *)reverseKeyEnumerator;
+
+@end

data/vendor/Pods/BuildHeaders/NanoStore/NanoStore.h

@@ -64,6 +64,13 @@
  - iOS library runs on the device and simulator
  - ARC compliant
  
+ @section latest_changes Latest changes
+ v2.5 - January 1, 2013
+ 
+ Starting with v2.5, the plist mechanism has been replaced with NSKeyedArchiver. There are several reasons for it: it's more compact, faster and uses less memory. Perhaps the most important reason is that it opens the possibility to store other data types.
+ 
+ NSNull is now supported. Big thanks to Wanny (https://github.com/mrwanny) for taking the time to improve this section of NanoStore.
+ 
  @section installation_sec Installation
  
  Building NanoStore is very easy. Just follow these steps:
@@ -423,6 +430,35 @@
  [sortByLastName release];
  @endcode
 
+ @section paging_limit_sec Paging using Limit and Offset
+ SQLite provides a really cool feature called OFFSET that is usually used with a LIMIT clause.
+ 
+ The LIMIT clause is used to limit the number of results returned in a SQL statement. So if you have 1000 rows in table, but only want to return the first 10, you would do something like this:
+ @code
+ SELECT column FROM table LIMIT 10
+ @endcode
+ Now suppose you wanted to show results 11-20. With the OFFSET keyword it's just as easy. The following query will do:
+ @code
+ SELECT column FROM table LIMIT 10 OFFSET 10
+ @endcode
+ Using pagination is also quite easy with NanoStore. This example based on one of the unit tests provided with the NanoStore distro:
+ @code
+ NSFNanoStore *nanoStore = [NSFNanoStore createAndOpenStoreWithType:NSFMemoryStoreType path:nil error:nil];
+ 
+ // Assume we have added objects to the store
+ 
+ NSFNanoSearch *search = [NSFNanoSearch searchWithStore:nanoStore];
+ search.value = @"Barcelona";
+ search.match = NSFEqualTo;
+ search.limit = 5;
+ search.offset = 3;
+ 
+ NSDictionary *searchResults = [search searchObjectsWithReturnType:NSFReturnObjects error:nil];
+ 
+ // Assuming the query matches some results, NanoStore should have retrieved
+ // the first 5 records right after the 3rd one from the result set.
+ @endcode
+ 
  @section performancetips_sec Performance Tips
  
  NanoStore by defaults saves every object to disk one by one. To speed up inserts and edited objects, increase NSFNanoStore's \link NSFNanoStore::saveInterval saveInterval \endlink property.

data/vendor/Pods/Headers/NanoStore/NSFNanoBag.h

@@ -302,11 +302,16 @@
 
 /** * Returns a string representation of the bag.
  * @note Check properties savedObjects, unsavedObjects and removedObjects to find out the current state of the bag.
- * @see \link dictionaryRepresentation - (NSDictionary *)dictionaryRepresentation \endlink
  */
 
 - (NSString *)description;
 
+/** Returns a JSON representation of the bag.
+ * @note Check properties savedObjects, unsavedObjects and removedObjects to find out the current state of the bag.
+ */
+
+- (NSString *)JSONDescription;
+
 //@}
 
 @end

data/vendor/Pods/Headers/NanoStore/NSFNanoEngine.h

@@ -537,6 +537,11 @@
 
 - (NSString *)description;
 
+/** Returns a JSON representation of the engine.
+ */
+
+- (NSString *)JSONDescription;
+
 //@}
 
 @end

data/vendor/Pods/Headers/NanoStore/NSFNanoEngine_Private.h

@@ -30,10 +30,12 @@
 #import "NSFNanoEngine.h"
 #import "NSFNanoGlobals_Private.h"
 #import "NSFNanoResult.h"
+#import "NSFOrderedDictionary.h"
 
 /** \cond */
 
 @interface NSFNanoEngine (Private)
+- (NSFOrderedDictionary *)dictionaryDescription;
 + (NSArray *)NSFP_sharedROWIDKeywords;
 - (NSString *)NSFP_cacheMethodToString;
 - (NSString*)NSFP_nestedDescriptionWithPrefixedSpace:(NSString *)prefixedSpace;

data/vendor/Pods/Headers/NanoStore/NSFNanoExpression.h

@@ -120,6 +120,12 @@
 
 - (NSString *)description;
 
+/** Returns a JSON representation of the expression.
+ * @note Check properties predicates and operators to find out the current state of the expression.
+ */
+
+- (NSString *)JSONDescription;
+
 //@}
 
 @end

data/vendor/Pods/Headers/NanoStore/NSFNanoExpression_Private.h

@@ -29,7 +29,7 @@
 /** \cond */
 
 @interface NSFNanoExpression (Private)
-// Just a placeholder.
+- (NSArray *)arrayDescription;
 @end
 
 /** \endcond */

data/vendor/Pods/Headers/NanoStore/NSFNanoGlobals.h

@@ -71,7 +71,11 @@ typedef enum {
     /** * Used to store NSDate elements in the format <i>yyyy-MM-dd HH:mm:ss:SSS</i>. Its string equivalent is <b>TEXT</b>. */
     NSFNanoTypeDate,
     /** * Used to store NSNumber elements. Its string equivalent is <b>REAL</b>. */
-    NSFNanoTypeNumber
+    NSFNanoTypeNumber,
+    /** * Used to store NSNull elements. Its string equivalent is <b>NULL</b>. */
+    NSFNanoTypeNULL,
+    /** * Used to store NSURL elements. Its string equivalent is <b>URL</b>. */
+    NSFNanoTypeURL
 } NSFNanoDatatype;
 
 /** * Returns the name of a NSFNanoDatatype datatype as a string. */

data/vendor/Pods/Headers/NanoStore/NSFNanoGlobals_Private.h

@@ -53,6 +53,10 @@
  
  */
 
+extern NSDictionary * safeJSONDictionaryFromDictionary (NSDictionary *dictionary);
+extern NSArray * safeJSONArrayFromArray (NSArray *array);
+extern id safeJSONObjectFromObject (id object);
+
 extern NSString * NSFStringFromMatchType (NSFMatchType aMatchType);
 
 extern void _NSFLog (NSString  *format, ...);
@@ -67,13 +71,13 @@ extern NSString * const NSFValue;
 extern NSString * const NSFDatatype;
 extern NSString * const NSFCalendarDate;
 extern NSString * const NSFObjectClass;
-extern NSString * const NSFPlist;
+extern NSString * const NSFKeyedArchive;
 extern NSString * const NSFAttribute;
 
 #pragma mark -
 
 extern NSString * const NSF_Private_NSFKeys_NSFKey;
-extern NSString * const NSF_Private_NSFKeys_NSFPlist;
+extern NSString * const NSF_Private_NSFKeys_NSFKeyedArchive;
 extern NSString * const NSF_Private_NSFValues_NSFKey;
 extern NSString * const NSF_Private_NSFValues_NSFAttribute;
 extern NSString * const NSF_Private_NSFValues_NSFValue;

data/vendor/Pods/Headers/NanoStore/NSFNanoObject.h

@@ -181,6 +181,8 @@
 
 @interface NSFNanoObject : NSObject <NSFNanoObjectProtocol, NSCopying>
 
+/** * The store where the object is saved.  */
+@property (nonatomic, weak, readonly) NSFNanoStore *store;
 /** * The UUID of the NanoObject.  */
 @property (nonatomic, copy, readonly) NSString *key;
 /** * The user-supplied information of the NanoObject.  */
@@ -304,6 +306,13 @@
 
 - (BOOL)isEqualToNanoObject:(NSFNanoObject *)otherNanoObject;
 
+/** * Saves the uncommitted changes to the document store.
+ * @param outError is used if an error occurs. May be NULL.
+ * @return YES upon success, NO otherwise.
+ */
+
+- (BOOL)saveStoreAndReturnError:(out NSError **)outError;
+
 /** * Returns a dictionary that contains the information stored in the object.
  * @note Check properties info and key to find out the current state of the object.
  * @see \link description - (NSString *)description \endlink
@@ -311,13 +320,16 @@
 
 - (NSDictionary *)dictionaryRepresentation;
 
-/** * Returns a string representation of the bag.
- * @note Check properties info and key to find out the current state of the object.
- * @see \link dictionaryRepresentation - (NSString *)dictionaryRepresentation \endlink
+/** * Returns a string representation of the nano object.
  */
 
 - (NSString *)description;
 
+/** Returns a JSON representation of the nano object.
+ */
+
+- (NSString *)JSONDescription;
+
 //@}
 
 @end

data/vendor/Pods/Headers/NanoStore/NSFNanoObject_Private.h

@@ -30,6 +30,10 @@
 
 @interface NSFNanoObject (Private)
 - (void)_setOriginalClassString:(NSString *)theClassString;
++ (NSString *)_NSObjectToJSONString:(id)object error:(NSError **)error;
++ (NSDictionary *)_safeDictionaryFromDictionary:(NSDictionary *)dictionary;
++ (NSArray *)_safeArrayFromArray:(NSArray *)array;
++ (id)_safeObjectFromObject:(id)object;
 @end
 
 /** \endcond */

data/vendor/Pods/Headers/NanoStore/NSFNanoPredicate.h

@@ -113,11 +113,16 @@
 
 /** * Returns a string representation of the predicate.
  * @note Check properties column, match and value to find out the current state of the predicate.
- * @see \link description - (NSString *)description \endlink
  */
 
 - (NSString *)description;
 
+/** * Returns a JSON representation of the predicate.
+ * @note Check properties column, match and value to find out the current state of the predicate.
+ */
+
+- (NSString *)JSONDescription;
+
 //@}
 
 @end

data/vendor/Pods/Headers/NanoStore/NSFNanoResult.h

@@ -132,6 +132,11 @@
 
 - (NSString *)description;
 
+/** Returns a JSON representation of the result.
+ */
+
+- (NSString *)JSONDescription;
+
 //@}
 
 @end

data/vendor/Pods/Headers/NanoStore/NSFNanoSearch.h

@@ -175,7 +175,11 @@
 /** * The sort holds an array of one or more sort descriptors of type \link NSFNanoSortDescriptor NSFNanoSortDescriptor \endlink. */
 @property (nonatomic, strong, readwrite) NSArray *sort;
 /** * The filterClass allows to filter the results based on a specific object class. */
-@property (nonatomic, strong, readwrite) NSString *filterClass;
+@property (nonatomic, copy, readwrite) NSString *filterClass;
+/** * If an expression has an offset clause, then the first M rows are omitted from the result set returned by the search operation and the next N rows are returned, where M and N are the values that the offset and limit clauses evaluate to, respectively. Or, if the search would return less than M+N rows if it did not have a limit clause, then the first M rows are skipped and the remaining rows (if any) are returned. */
+@property (nonatomic, assign, readwrite) NSUInteger offset;
+/** * The limit clause is used to place an upper bound on the number of rows returned by a Search operation. */
+@property (nonatomic, assign, readwrite) NSUInteger limit;
 
 /** @name Creating and Initializing a Search
  */
@@ -277,7 +281,7 @@
  * NSFNanoSearch *search = [NSFNanoSearch searchWithStore:nanoStore];
  *
  * // Perform the search
- * // The query will be rewritten as @"SELECT NSFKey, NSFPlist, NSFObjectClass FROM NSFKeys"
+ * // The query will be rewritten as @"SELECT NSFKey, NSFKeyedArchive, NSFObjectClass FROM NSFKeys"
  * NSDictionary *results = [search executeSQL:@"SELECT foo, bar FROM NSFKeys" returnType:NSFReturnObjects error:nil];
  * @endcode
  * @note The sort descriptor will be ignored when executing custom SQL statements.
@@ -380,4 +384,14 @@
 
 //@}
 
+/** Returns a string representation of the search.
+ */
+
+- (NSString *)description;
+
+/** Returns a JSON representation of the search.
+ */
+
+- (NSString *)JSONDescription;
+
 @end

data/vendor/Pods/Headers/NanoStore/NSFNanoSortDescriptor.h

@@ -75,7 +75,7 @@
 @interface NSFNanoSortDescriptor : NSObject
 
 /** * The property key to use when performing a comparison */
-@property (nonatomic, readonly) NSString *attribute;
+@property (nonatomic, copy, readonly) NSString *attribute;
 /** * The property to indicate whether the comparison should be performed in ascending mode */
 @property (nonatomic, readonly) BOOL isAscending;
 
@@ -119,6 +119,12 @@
 
 - (NSString *)description;
 
+/** Returns a JSON representation of the sort.
+ * @note Check properties attribute and isAscending to find out the current state of the sort.
+ */
+
+- (NSString *)JSONDescription;
+
 //@}
 
 @end

data/vendor/Pods/Headers/NanoStore/NSFNanoStore.h

@@ -297,6 +297,13 @@
 
 - (NSFNanoBag *)bagWithName:(NSString *)theName;
 
+/** * Retrieves all bags associated with the specified name.
+ * @param theName the name of the bag.
+ * @returns The bags that match the specified name, an empty array otherwise.
+ */
+
+- (NSArray *)bagsWithName:(NSString *)theName;
+
 /** * Returns a new array containing the bags found in the document store matching the specified list of keys.
  * @param theKeys the list of bag keys.
  * @returns An array with the bags that match the specified list of keys.
@@ -470,6 +477,11 @@
 
 - (NSString *)description;
 
+/** Returns a JSON representation of the store.
+ */
+
+- (NSString *)JSONDescription;
+
 //@}
 
 @end