Categories

Objective-C

@interface NSObject (AWSFMDatabasePoolDelegate)

Objective-C

@interface NSData (AWSGZIP)

- (NSData *)awsgzip_gzippedDataWithCompressionLevel:(float)level;
- (NSData *)awsgzip_gzippedData;
- (NSData *)awsgzip_gunzippedData;

@end

Objective-C

@interface NSArray (AWSMTLManipulationAdditions)

// The first object in the array or nil if the array is empty.
// Forwards to `firstObject` which has been first declared in iOS7, but works with iOS4/10.6.
@property (nonatomic, readonly, strong) id awsmtl_firstObject;

// Returns a new array without all instances of the given object.
- (NSArray *)awsmtl_arrayByRemovingObject:(id)object;

// Returns a new array without the first object. If the array is empty, it
// returns the empty array.
- (NSArray *)awsmtl_arrayByRemovingFirstObject;

// Returns a new array without the last object. If the array is empty, it
// returns the empty array.
- (NSArray *)awsmtl_arrayByRemovingLastObject;

@end

Objective-C

@interface NSDictionary (AWSMTLManipulationAdditions)

// Merges the keys and values from the given dictionary into the receiver. If
// both the receiver and `dictionary` have a given key, the value from
// `dictionary` is used.
//
// Returns a new dictionary containing the entries of the receiver combined with
// those of `dictionary`.
- (NSDictionary *)awsmtl_dictionaryByAddingEntriesFromDictionary:(NSDictionary *)dictionary;

// Creates a new dictionary with all the entries for the given keys removed from
// the receiver.
- (NSDictionary *)awsmtl_dictionaryByRemovingEntriesWithKeys:(NSSet *)keys;

@end

Objective-C

@interface NSValueTransformer (AWSMTLInversionAdditions)

// Flips the direction of the receiver's transformation, such that
// -transformedValue: will become -reverseTransformedValue:, and vice-versa.
//
// The receiver must allow reverse transformation.
//
// Returns an inverted transformer.
- (NSValueTransformer *)awsmtl_invertedTransformer;

@end

Objective-C

@interface NSValueTransformer (AWSMTLPredefinedTransformerAdditions)

// Creates a reversible transformer to convert a JSON dictionary into a MTLModel
// object, and vice-versa.
//
// modelClass - The MTLModel subclass to attempt to parse from the JSON. This
//              class must conform to <MTLJSONSerializing>. This argument must
//              not be nil.
//
// Returns a reversible transformer which uses MTLJSONAdapter for transforming
// values back and forth.
+ (NSValueTransformer *)awsmtl_JSONDictionaryTransformerWithModelClass:(Class)modelClass;

// Creates a reversible transformer to convert an array of JSON dictionaries
// into an array of MTLModel objects, and vice-versa.
//
// modelClass - The MTLModel subclass to attempt to parse from each JSON
//              dictionary. This class must conform to <MTLJSONSerializing>.
//              This argument must not be nil.
//
// Returns a reversible transformer which uses MTLJSONAdapter for transforming
// array elements back and forth.
+ (NSValueTransformer *)awsmtl_JSONArrayTransformerWithModelClass:(Class)modelClass;

// A reversible value transformer to transform between the keys and objects of a
// dictionary.
//
// dictionary          - The dictionary whose keys and values should be
//                       transformed between. This argument must not be nil.
// defaultValue        - The result to fall back to, in case no key matching the
//                       input value was found during a forward transformation.
// reverseDefaultValue - The result to fall back to, in case no value matching
//                       the input value was found during a reverse
//                       transformation.
//
// Can for example be used for transforming between enum values and their string
// representation.
//
//   NSValueTransformer *valueTransformer = [NSValueTransformer awsmtl_valueMappingTransformerWithDictionary:@{
//     @"foo": @(EnumDataTypeFoo),
//     @"bar": @(EnumDataTypeBar),
//   } defaultValue: @(EnumDataTypeUndefined) reverseDefaultValue: @"undefined"];
//
// Returns a transformer that will map from keys to values in dictionary
// for forward transformation, and from values to keys for reverse
// transformations. If no matching key or value can be found, the respective
// default value is returned.
+ (NSValueTransformer *)awsmtl_valueMappingTransformerWithDictionary:(NSDictionary *)dictionary defaultValue:(id)defaultValue reverseDefaultValue:(id)reverseDefaultValue;

// Returns a value transformer created by calling
// `+mtl_valueMappingTransformerWithDictionary:defaultValue:reverseDefaultValue:`
// with a default value of `nil` and a reverse default value of `nil`.
+ (NSValueTransformer *)awsmtl_valueMappingTransformerWithDictionary:(NSDictionary *)dictionary;

@end

Objective-C

@interface NSValueTransformer (UnavailableAWSMTLPredefinedTransformerAdditions)

+ (NSValueTransformer *)awsmtl_externalRepresentationTransformerWithModelClass:(Class)modelClass __attribute__((deprecated("Replaced by +mtl_JSONDictionaryTransformerWithModelClass:")));
+ (NSValueTransformer *)awsmtl_externalRepresentationArrayTransformerWithModelClass:(Class)modelClass __attribute__((deprecated("Replaced by +mtl_JSONArrayTransformerWithModelClass:")));

@end

Objective-C

@interface NSString (AWSHTTPMethod)

+ (instancetype)aws_stringWithHTTPMethod:(AWSHTTPMethod)HTTPMethod;

@end

Objective-C

@interface NSDate (AWS)

+ (NSDate *)aws_clockSkewFixedDate;

+ (NSDate *)aws_dateFromString:(NSString *)string;
+ (NSDate *)aws_dateFromString:(NSString *)string format:(NSString *)dateFormat;
- (NSString *)aws_stringValue:(NSString *)dateFormat;

/**
 * Set the clock skew for the current device.  This clock skew will be used for calculating
 * signatures to AWS signatures and for parsing/converting date values from responses.
 *
 * @param clockskew the skew (in seconds) for this device.  If the clock on the device is fast, pass positive skew to correct.  If the clock on the device is slow, pass negative skew to correct.
 */
+ (void)aws_setRuntimeClockSkew:(NSTimeInterval)clockskew;

/**
 * Get the clock skew for the current device.
 *
 * @return the skew (in seconds) currently set for this device.  Positive clock skew implies the device is fast, negative implies the device is slow.
 */
+ (NSTimeInterval)aws_getRuntimeClockSkew;

@end

Objective-C

@interface NSDictionary (AWS)

- (NSDictionary *)aws_removeNullValues;
- (id)aws_objectForCaseInsensitiveKey:(id)aKey;

@end

Objective-C

@interface NSJSONSerialization (AWS)

+ (NSData *)aws_dataWithJSONObject:(id)obj
                           options:(NSJSONWritingOptions)opt
                             error:(NSError **)error;

@end

Objective-C

@interface NSNumber (AWS)

+ (NSNumber *)aws_numberFromString:(NSString *)string;

@end

Objective-C

@interface NSObject (AWS)

- (NSDictionary *)aws_properties;
- (void)aws_copyPropertiesFromObject:(NSObject *)object;

@end

Objective-C

@interface NSString (AWS)

/// A convenience method for calculating an MD5 hash of `data`.
///
/// MD5 is not suited for cryptographically-sensitive operations. Usages of this
/// method in the AWS Mobile SDK are limited to calculating checksums for AWS S3
/// operations that require a `Content-MD5` HTTP header, and do not repesent a
/// security risk. We are exposing this method as a convenience API for
/// applications that need to calculate that value manually.
+ (NSString *)aws_base64md5FromData:(NSData *)data;

- (BOOL)aws_isBase64Data;
- (NSString *)aws_stringWithURLEncoding;
- (NSString *)aws_stringWithURLEncodingPath;
- (NSString *)aws_stringWithURLEncodingPathWithoutPriorDecoding;

- (BOOL)aws_isVirtualHostedStyleCompliant;

- (AWSRegionType)aws_regionTypeValue;

@end

Objective-C

@interface NSFileManager (AWS)

- (BOOL)aws_atomicallyCopyItemAtURL:(NSURL *)sourceURL
                              toURL:(NSURL *)destinationURL
                     backupItemName:(NSString *)backupItemName
                              error:(NSError **)outError;

@end

Objective-C

@interface NSDictionary (AWSXMLDictionary)

+ (NSDictionary *)awsxml_dictionaryWithXMLParser:(NSXMLParser *)parser;
+ (NSDictionary *)awsxml_dictionaryWithXMLData:(NSData *)data;
+ (NSDictionary *)awsxml_dictionaryWithXMLString:(NSString *)string;
+ (NSDictionary *)awsxml_dictionaryWithXMLFile:(NSString *)path;

- (NSDictionary *)awsxml_attributes;
- (NSDictionary *)awsxml_childNodes;
- (NSArray *)awsxml_comments;
- (NSString *)awsxml_nodeName;
- (NSString *)awsxml_innerText;
- (NSString *)awsxml_innerXML;
- (NSString *)awsxml_XMLString;

- (NSArray *)awsxml_arrayValueForKeyPath:(NSString *)keyPath;
- (NSString *)awsxml_stringValueForKeyPath:(NSString *)keyPath;
- (NSDictionary *)awsxml_dictionaryValueForKeyPath:(NSString *)keyPath;

@end

Objective-C

@interface NSString (AWSXMLDictionary)

- (NSString *)awsxml_XMLEncodedString;

@end