Added git_repository_open_ext wrapper

Author: glegrain

ObjectiveGit/GTRepository.h

@@ -110,6 +110,16 @@ extern NSString * const GTRepositoryCloneOptionsCloneLocal;
 /// A NSURL pointing to a local file that contains PEM-encoded certificate chain.
 extern NSString *const GTRepositoryCloneOptionsServerCertificateURL;
 
+/// Repository extended open control flags for
+/// +initWithURL:flags:ceilingDirs:error:.
+///
+/// See respository.h for documentation of each individual flag.
+typedef NS_OPTIONS(UInt32, GTRepositoryOpenFlags) {
+	GTRepositoryOpenNoSearch = GIT_REPOSITORY_OPEN_NO_SEARCH,
+	GTRepositoryOpenCrossFS = GIT_REPOSITORY_OPEN_CROSS_FS,
+	GTRepositoryOpenBare = GIT_REPOSITORY_OPEN_BARE,
+};
+
 /// Initialization flags associated with `GTRepositoryInitOptionsFlags` for
 /// +initializeEmptyRepositoryAtFileURL:options:error:.
 ///
@@ -201,6 +211,18 @@ typedef NS_ENUM(NSInteger, GTRepositoryStateType) {
 /// Returns the initialized repository, or nil if an error occurred.
 + (nullable instancetype)repositoryWithURL:(NSURL *)localFileURL error:(NSError **)error;
 
+/// Convenience class initializer to find and open a repository with extended controls.
+///
+/// localFileURL - The file URL for the new repository. Cannot be nil.
+/// flags        - A combination of the `GTRepositoryOpenFlags` flags.
+/// ceilingDirs  - A GIT_PATH_LIST_SEPARATOR delimited list of path prefixes at
+///                which the search for a containing repository should terminate.
+///                Can be NULL.
+/// error        - The error if one occurs.
+///
+/// Returns the initialized repository, or nil if an error occurred.
++ (nullable instancetype)initWithURL:(NSURL *)localFileURL flags:(UInt32)flags ceilingDirs:(nullable const char *)ceilingDirs error:(NSError **)error;
+
 /// Convenience initializer which uses the default options.
 ///
 /// localFileURL - The file URL for the new repository. Cannot be nil.
@@ -209,6 +231,18 @@ typedef NS_ENUM(NSInteger, GTRepositoryStateType) {
 /// Returns the initialized repository, or nil if an error occurred.
 - (nullable instancetype)initWithURL:(NSURL *)localFileURL error:(NSError **)error;
 
+/// Convenience initializer to find and open a repository with extended controls.
+///
+/// localFileURL - The file URL for the new repository. Cannot be nil.
+/// flags        - A combination of the `GTRepositoryOpenFlags` flags.
+/// ceilingDirs  - A GIT_PATH_LIST_SEPARATOR delimited list of path prefixes at
+///                which the search for a containing repository should terminate.
+///                Can be NULL.
+/// error        - The error if one occurs.
+///
+/// Returns the initialized repository, or nil if an error occurred.
+- (nullable instancetype)initWithURL:(NSURL *)localFileURL flags:(UInt32)flags ceilingDirs:(nullable const char *)ceilingDirs error:(NSError **)error;
+
 - (instancetype)init NS_UNAVAILABLE;
 
 /// Initializes the receiver to wrap the given repository object. Designated initializer.

ObjectiveGit/GTRepository.m

@@ -145,6 +145,10 @@ + (instancetype)repositoryWithURL:(NSURL *)localFileURL error:(NSError **)error
 	return [[self alloc] initWithURL:localFileURL error:error];
 }
 
++ (instancetype)initWithURL:(NSURL *)localFileURL flags:(UInt32)flags ceilingDirs:(const char *)ceilingDirs error:(NSError **)error {
+	return [[self alloc] initWithURL:localFileURL flags:flags ceilingDirs:ceilingDirs error:error];
+}
+
 - (instancetype)init {
 	NSAssert(NO, @"Call to an unavailable initializer.");
 	return nil;
@@ -177,6 +181,22 @@ - (instancetype)initWithURL:(NSURL *)localFileURL error:(NSError **)error {
 	return [self initWithGitRepository:r];
 }
 
+- (instancetype)initWithURL:(NSURL *)localFileURL flags:(UInt32)flags ceilingDirs:(const char *)ceilingDirs error:(NSError **)error {
+	if (!localFileURL.isFileURL || localFileURL.path == nil) {
+		if (error != NULL) *error = [NSError errorWithDomain:NSCocoaErrorDomain code:NSFileWriteUnsupportedSchemeError userInfo:@{ NSLocalizedDescriptionKey: NSLocalizedString(@"Invalid file path URL to initialize repository.", @"") }];
+		return nil;
+	}
+
+	git_repository *r;
+	int gitError = git_repository_open_ext(&r, localFileURL.path.fileSystemRepresentation, flags, ceilingDirs);
+	if (gitError < GIT_OK) {
+		if (error != NULL) *error = [NSError git_errorFor:gitError description:@"Failed to open repository at URL %@.", localFileURL];
+		return nil;
+	}
+
+	return [self initWithGitRepository:r];
+}
+
 
 typedef void(^GTTransferProgressBlock)(const git_transfer_progress *progress, BOOL *stop);