GitHubから1ファイルだけ取得する方法

どうにかクローンできないかと調べてたけど GitHub API 使って curl 等から HTTP でダウンロードできた。
プログラムから GitHub リポジトリのファイルを読み込みたいときに便利。

準備

GitHub の OAuthToken が必要。
Personal access tokens のページから Generate new token して以下の権限にチェックを入れる。

  • public_repo
  • read:org ※Organization リポジトリの場合のみ必要

Generate token して表示されるトークンをコピー。

実行方法

OAuthToken を利用しているので、Public リポジトリだけでなく Private リポジトリからも取得できる。
curl コマンドを使う場合は以下の形式となる。

$ curl -H 'Authorization: token <token>' -H 'Accept: application/vnd.github.v3.raw' -L https://api.github.com/repos/<owner>/<repo>/contents/<path>

<token>, <owner>, <repo>, <path> の部分を任意の文字列に置き換える。
例えば github.com/jnst/dotfiles.bashrc をダウンロードしたいときは

$ curl -H 'Authorization: token XXXXXXXXXXXXXXXXXXXXXXXX' -H 'Accept: application/vnd.github.v3.raw' -L https://api.github.com/repos/jnst/dotfiles/contents/.bashrc

# alias
alias ll='ls -AlhF'

# prompt
PS1="\W \u\[\e[1;31m\]$\[\e[00m\] "

# history
HISTSIZE=5000
HISTFILESIZE=5000
HISTTIMEFORMAT='%Y-%m-%d %T '

また、ブランチ名を指定したいときは末尾に &ref=develop のように付与すればいい。