Feature: obtain repository from filepath within git repository

[mizlan]

Adds functionality to obtain a Repository object given a file anywhere within a Git repository. Includes support for addCeilingDirectories and would be used like so (as an example):

Usage without ceiling directories

(find-repo (io/file "/Users/ml/code/clj-jgit/src/clj_jgit/porcelain.clj"))
;; => #object[org.eclipse.jgit.api.Git 0x1ff2d3f "Git[Repository[/Users/ml/code/clj-jgit/.git]]"]

Usage with ceiling directories

(def ceil [(io/file "/Users/ml/code/clj-jgit/src")])
(find-repo (io/file "/Users/ml/code/clj-jgit/src/clj_jgit/porcelain.clj") :ceiling-dirs ceil)
Execution error (FileNotFoundException) at clj-jgit.porcelain/find-repo (form-init17805399835728471910.clj:234).
Could not load a git repository at '/Users/ml/code/clj-jgit/src/clj_jgit/porcelain.clj' with ceiling dirs: [#object[java.io.File 0xe82bcfe "/Users/ml/code/clj-jgit/src"]]

[mizlan]

Resolves #70

[edannenberg]

Thanks for the swift PR!

I was thinking to change load-repo directly so it would support your use case, should be non-breaking. The only downside is that we can't change with-repo to support the :ceiling-dirs arg in a non-breaking fashion.

If we go with find-repo I would prefer that it only returns the root path of the git repo, if one is found. Which can than be fed to load-repo, etc.

Maybe other users want to chime in with some feedback. /cc @jaromil

[mizlan]

If we go with find-repo I would prefer that it only returns the root path of the git repo, if one is found. Which can than be fed to load-repo, etc.

Ah, this makes much more sense. I will modify the function for now to reflect that. If that's the case, do you think the name of the function should be changed as well?