# LFSPull - a simple pulling tool for git-lfs
[](https://docs.rs/lfspull)

## Features
LFSPull allows you to pull files from git-lfs.
It currently supports:
- Token-auth only
- Pulling single files
- Globbing patterns and pulling all matches
- Cache-compatible with the original git-lfs
- Hash verification of the downloaded file
## CLI guide
The CLI is pretty straight forward.
- `-f / --file-to-pull [FILE]` single file download mode
- e.g. `lfspull -f my_file.tar.gz` downloads the file
- '-r / --recurse-pattern [PATTERN]' downloads everything that matches the pattern
- e.g. 'lfspull -r "*.tgz"' downloads all .tgz files in this folder
- e.g. 'lfspull -r "**/*.tgz"' downloads all .tgz files this folder and all subfolders
- '-a / --access-token [TOKEN]' sets the token - can also be set via $ACCESS_TOKEN from env
## Library API guide
Please see our docs.rs for example code and the gherkin tests for how to check the origin of the file.