From f975732a44ed36107af6878a7d6e546ff43d089d Mon Sep 17 00:00:00 2001 From: EricFromCanada Date: Mon, 1 Oct 2018 17:14:20 -0400 Subject: [PATCH] docs/Formula-Cookbook: mention newer download strategies Add `:fossil`, `:github_private_release`, `:github_private_repo`, `:s3`, `:scp`. --- docs/Formula-Cookbook.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/Formula-Cookbook.md b/docs/Formula-Cookbook.md index d2dc6de682..4a7d2ef300 100644 --- a/docs/Formula-Cookbook.md +++ b/docs/Formula-Cookbook.md @@ -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: