Merge pull request #237 from leichunfeng/add-method-to-octclient+octr…

…epository

Add `-fetchRepositoryReadme:reference:` method to `OCTClient+Repositorie...

OctoKit/OCTClient+Repositories.h

@@ -71,6 +71,15 @@
 // Returns a signal which will send zero or one OCTContent.
 - (RACSignal *)fetchRepositoryReadme:(OCTRepository *)repository;
 
+// Fetches the readme of a `repository` by the given `reference`.
+//
+// repository - The repository for which the readme should be fetched.
+// reference  - The name of the commit, branch or tag, may be `nil` in which
+//              case it defaults to the default repo branch.
+//
+// Returns a signal which will send zero or one OCTContent.
+- (RACSignal *)fetchRepositoryReadme:(OCTRepository *)repository reference:(NSString *)reference;
+
 // Fetches a specific repository owned by the given `owner` and named `name`.
 //
 // name  - The name of the repository, must be a non-empty string.

OctoKit/OCTClient+Repositories.m

@@ -70,12 +70,18 @@ - (RACSignal *)fetchRelativePath:(NSString *)relativePath inRepository:(OCTRepos
 }
 
 - (RACSignal *)fetchRepositoryReadme:(OCTRepository *)repository {
+	return [self fetchRepositoryReadme:repository reference:nil];
+}
+
+- (RACSignal *)fetchRepositoryReadme:(OCTRepository *)repository reference:(NSString *)reference {
 	NSParameterAssert(repository != nil);
 	NSParameterAssert(repository.name.length > 0);
 	NSParameterAssert(repository.ownerLogin.length > 0);
 
 	NSString *path = [NSString stringWithFormat:@"repos/%@/%@/readme", repository.ownerLogin, repository.name];
-	NSMutableURLRequest *request = [self requestWithMethod:@"GET" path:path parameters:nil notMatchingEtag:nil];
+	NSDictionary *parameters = (reference.length > 0 ? @{ @"ref": reference } : nil);
+
+	NSMutableURLRequest *request = [self requestWithMethod:@"GET" path:path parameters:parameters notMatchingEtag:nil];
 
 	return [[self enqueueRequest:request resultClass:OCTContent.class] oct_parsedResults];
 }