admin/brew
1
0
Fork 0
Code Issues Packages Projects Releases 6 Wiki Activity

docs/Formula-Cookbook: mention newer download strategies

Browse Source 
Add `:fossil`, `:github_private_release`, `:github_private_repo`, `:s3`, `:scp`.
This commit is contained in:
EricFromCanada 2018-10-01 17:14:20 -04:00
parent bb038c7048
commit f975732a44
1 changed files with 11 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/Formula-Cookbook.md
View File

@ -552,18 +552,28 @@ class Python3 < Formula
head "https://hg.python.org/cpython", :using => :hg
```
Download strategies offered by Homebrew are:
Homebrew offers both anonymous and authenticated download strategies.
| `:using` value | download strategy |
|----------------|-------------------------------|
| `:bzr` | `BazaarDownloadStrategy` |
| `:curl` | `CurlDownloadStrategy` |
| `:cvs` | `CVSDownloadStrategy` |
| `:fossil` | `FossilDownloadStrategy` |
| `:git` | `GitDownloadStrategy` |
| `:hg` | `MercurialDownloadStrategy` |
| `:nounzip` | `NoUnzipCurlDownloadStrategy` |
| `:post` | `CurlPostDownloadStrategy` |
| `:svn` | `SubversionDownloadStrategy` |
|----------------|-------------------------------|
| `:using` value | download strategy | authentication source |
|---------------------------|--------------------------------------------------|----------------------------------------------|
| `:github_private_release` | `GitHubPrivateRepositoryReleaseDownloadStrategy` | `HOMEBREW_GITHUB_API_TOKEN` |
| `:github_private_repo` | `GitHubPrivateRepositoryDownloadStrategy` | `HOMEBREW_GITHUB_API_TOKEN` |
| `:s3` | `S3DownloadStrategy` | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` |
| `:scp` | `ScpDownloadStrategy` | SSH key pair |
|---------------------------|--------------------------------------------------|----------------------------------------------|
If you need more control over the way files are downloaded and staged, you can create a custom download strategy and specify it using the [`url`](http://www.rubydoc.info/github/Homebrew/brew/master/Formula#url-class_method) method's `:using` option: