Now gracefully handles escaping interpolated resource paths in RKRouter, RKMakePathWithObject, and RKPathMatcher. By adding an encoding handler to SOCKit, we now (by default, but optionally) add percent escapes to each object's property value while it's being interpolated into a resource path pattern, like /stuff/things/:others?apikey=:apikey ... that way it won't brutally mangle the slashes and question marks and ampersands that exist in the resource path pattern, while at the same time properly escaping those same characters when they occur inside the object's property value. Closes #221

Vendor/SOCKit/tests/SOCKitTests.m

@@ -20,6 +20,7 @@
 #import "SOCKit.h"
 
 typedef void (^SimpleBlock)(void);
+NSString *sockitBetterURLEncodeString(NSString *unencodedString);
 
 @interface SOCTestObject : NSObject
 
@@ -125,6 +126,30 @@ typedef void (^SimpleBlock)(void);
 }
 
 
+///////////////////////////////////////////////////////////////////////////////////////////////////
+- (void)testBlockTransformations {
+    NSDictionary *obj = [NSDictionary dictionaryWithObjectsAndKeys:
+                            @"JUICE|BOX&121", @"password", @"Joe Bob Briggs", @"name", [NSNumber numberWithInt:15], @"group", nil];
+    SOCPattern *pattern = [SOCPattern patternWithString:@"/people/:group/:name?password=:password"];
+    NSString *expectedString = @"/people/15/Joe Bob Briggs?password=JUICE|BOX&121";
+    NSString *actualString = [pattern stringFromObject:obj withBlock:nil];
+    STAssertTrue([actualString isEqualToString:expectedString], @"Should be the same string (testing nil block parameter).");
+    STAssertTrue([actualString isEqualToString:[pattern stringFromObject:obj]], @"Should be the same string (testing nil block parameter).");
+    actualString = [pattern stringFromObject:obj withBlock:^NSString *(NSString* interpolatedValue) {
+        return @"Test Message";
+    }];
+    expectedString = @"/people/Test Message/Test Message?password=Test Message";
+    STAssertTrue([actualString isEqualToString:expectedString], @"Should be the same string (testing nil block parameter).");
+    STAssertFalse([actualString isEqualToString:[pattern stringFromObject:obj]], @"Should not be the same string, one was transformed with a block.");
+    actualString = [pattern stringFromObject:obj withBlock:^NSString *(NSString* interpolatedValue) {
+        return sockitBetterURLEncodeString(interpolatedValue);
+    }];
+    expectedString = @"/people/15/Joe%20Bob%20Briggs?password=JUICE%7CBOX%26121";
+    STAssertTrue([actualString isEqualToString:expectedString], @"Should be the same string (testing nil block parameter).");
+    STAssertFalse([actualString isEqualToString:[pattern stringFromObject:obj]], @"Should not be the same string, one was transformed with a block.");
+}
+
+
 ///////////////////////////////////////////////////////////////////////////////////////////////////
 - (void)testOutboundParameters {
   SOCPattern* pattern = [SOCPattern patternWithString:@"soc://:ident"];
@@ -193,3 +218,11 @@ typedef void (^SimpleBlock)(void);
 }
 
 @end
+
+// NSString's stringByAddingPercentEscapes doesn't do a complete job (it ignores "/?&", among others)
+NSString *sockitBetterURLEncodeString(NSString *unencodedString) {
+    NSString * encodedString = (NSString *)CFURLCreateStringByAddingPercentEscapes( NULL, (CFStringRef)unencodedString, NULL,
+                                                                                   (CFStringRef)@"!*'();:@&=+$,/?%#[]", NSASCIIStringEncoding );
+    return [encodedString autorelease];
+}
+