A very early version of an Git LFS (https://git-lfs.github.com/) REST API interface plugin for Atlassian BitBucket (https://www.atlassian.com/software/bitbucket).

This is a very early release! Use at your own risk!

• Install git-lfs (see https://git-lfs.github.com/ for details)
• Download (see releases) and install the plugin in your bitbucket instance
• Init LFS and add the LFS endpoint to your repo

git lfs init
git config remote.origin.lfsurl "https://your.server.com/bitbucket/rest/lfs/1.0/<project>/<repo>"

• Add files to track by LFS git lfs track "*.tar.gz"
• Commit, push, whatever

Cloning a repo with LFS content is currently not possible since the default LFS url is different from this plugins REST url (see TODO).

Well, get familiar with the atlassian sdk (https://developer.atlassian.com/docs/getting-started/set-up-the-atlassian-plugin-sdk-and-build-a-project), clone the repo and go with atlas-run.

The file to get you started is Lfs.java. Pretty much everything is in there. The Objects (LfsObject.java and BatchLfsObject.java) are direct mappings of the input JSON coming from the git-lfs client. The Models (LfsModel.java and BatchLfsModel.java) are the output/return Objects which will be mapped to JSON for the response.

There are a lot of TODOs. I definitely can not do all of them by myself, so please contact me or just send a pull request if you have anything.

• Checksum verification of uploaded file
  • CON: High CPU load for big files
  • PRO: Especially for big files you want to have file consistency
• Validate JSON (LfsObject.validateJSON)
• Fix Hypermedia links to only include needed links?? (check if needed)
• Check batch API
  • (DONE) push
  • pull (in my tests client did not use batch even if told to do so...)
• Hook to delete the lfs repo if bitbucket repo is deleted
• Make 404 etc. empty and not return massive bitbucket thing
• Move path from /rest... to default LFS path ...repo.git/info/lfs
  • I am not sure if this is possible at all
• Add SSH implementation (https://github.com/github/git-lfs/tree/master/docs/api#authentication)
• Fix passing of lfsStore path everywhere (HOW???)
• Add JavaDoc
• Add tests
• Add more tests