A simple jQuery plugin that pulls a file from github.com and returns it.
This uses the public GitHub API (v3) over JSONP to pull a raw file from GitHub.
API:
$.getGithubFile(user, repo, sha, callback, startLineNum, endLineNum)
or
$.getGithubFileByFilePath(user, repo, filePath, callback, startLineNum, endLineNum)
Examples:
// fetch this README.md file and return all of the lines
$.getGithubFile("jamesward", "github-files", "2e7bf4aa35758d7a9cf87549d6299e924737ff05", function(contents) {
console.log(contents)
});
// fetch this README.md file and return all of the lines beginning with line 6
$.getGithubFile("jamesward", "github-files", "2e7bf4aa35758d7a9cf87549d6299e924737ff05", function(contents) {
console.log(contents)
}, 6);
// fetch this README.md file and return lines 6 - 15
$.getGithubFile("jamesward", "github-files", "2e7bf4aa35758d7a9cf87549d6299e924737ff05", function(contents) {
console.log(contents)
}, 6, 15);
// fetch this README.md file and return all of the lines
$.getGithubFileByFilePath("jamesward", "github-files", "README.md", function(contents) {
console.log(contents)
});
To get the sha for a file in git run something like:
git rev-parse HEAD:README.md
or use the $.getGithubFileByFilePath method as documented above.