Go to file

rubyist ab5b35a8c0 Progress meter needs to be more dynamic for batches of n This removes the `pb` based progress bar for the transfer queue and add a simpler custom bar. pb really wants to know total counts and byte sizes up front but when doing batches of n we would prefer to not know that. This is due to the fact that the batcher will block until it is drained instead of processing all pointers and storing them in memory while transfer operations run. This also clarifies when files are skipped because the server already has them. Progress output here contains the number of finished transfers/bytes, the number of transfers/bytes currently in the queue, and the number of files skipped, if any.		2015-07-27 12:43:41 -04:00
commands	Progress meter needs to be more dynamic for batches of n	2015-07-27 12:43:41 -04:00
debian	Update deb version to 0.5.3	2015-07-24 21:31:48 +00:00
docs	documents git lfs push --object-id	2015-07-22 16:32:34 -06:00
git	Windows: hide git application window.	2015-06-17 13:14:36 +03:00
lfs	Progress meter needs to be more dynamic for batches of n	2015-07-27 12:43:41 -04:00
rpm	Added shasum to download list so tests can pass	2015-07-13 01:02:18 -04:00
script	don't use install(1) with -D option	2015-07-24 19:20:29 +09:00
test	Progress meter needs to be more dynamic for batches of n	2015-07-27 12:43:41 -04:00
vendor/_nuts/github.com	Update tracerx	2015-06-02 11:15:02 -04:00
.gitignore	Simplified the SUDO variable out, since most people shouldn't need it	2015-07-12 05:37:38 +00:00
.travis.yml	Make it possible to enable Travis on forks	2015-06-15 16:25:51 +01:00
CHANGELOG.md	update changelog	2015-07-23 14:37:52 -06:00
CONTRIBUTING.md	update release guide with the correct script for running all tests	2015-07-23 14:39:30 -06:00
git-lfs.go	Calculate the response header size sooner and outside of the mutex lock	2015-06-05 11:13:57 -04:00
LICENSE	Create LICENSE	2015-03-24 15:12:12 -04:00
Nut.toml	yay v0.5.3	2015-07-22 15:35:15 -06:00
README.md	Use -text instead of -crlf	2015-07-09 10:01:50 -06:00
ROADMAP.md	add a quick overview of the next major releases	2015-07-23 11:44:22 -06:00

README.md

Git Large File Storage

Git LFS is a command line extension and specification for managing large files with Git. The client is written in Go, with pre-compiled binaries available for Mac, Windows, Linux, and FreeBSD. Check out the Git LFS website for a high level overview of features.

See CONTRIBUTING.md for info on working on Git LFS and sending patches. Related projects are listed on the Implementations wiki page.

Getting Started

Download the latest client and run the included install script. The installer should run git lfs init for you, which sets up Git's global configuration settings for Git LFS.

Note: Git LFS requires Git v1.8.2 or higher.

Configuration

Git LFS uses .gitattributes files to configure which are managed by Git LFS. Here is a sample one that saves zips and mp3s:

$ cat .gitattributes
*.mp3 filter=lfs -text
*.zip filter=lfs -text

Git LFS can manage .gitattributes for you:

$ git lfs track "*.mp3"
Tracking *.mp3

$ git lfs track "*.zip"
Tracking *.zip

$ git lfs track
Listing tracked paths
    *.mp3 (.gitattributes)
    *.zip (.gitattributes)

$ git lfs untrack "*.zip"
Untracking *.zip

$ git lfs track
Listing tracked paths
    *.mp3 (.gitattributes)

Pushing commits

Once setup, you're ready to push some commits:

$ git add my.zip
$ git commit -m "add zip"

You can confirm that Git LFS is managing your zip file:

$ git lfs ls-files
my.zip

Once you've made your commits, push your files to the Git remote:

$ git push origin master
Sending my.zip
12.58 MB / 12.58 MB  100.00 %
Counting objects: 2, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (5/5), done.
Writing objects: 100% (5/5), 548 bytes | 0 bytes/s, done.
Total 5 (delta 1), reused 0 (delta 0)
To https://github.com/github/git-lfs-test
   67fcf6a..47b2002  master -> master

See the Git LFS overview and man pages.