terminal curlコマンド生成ツール star

curlの簡単な歴史

curlは1998年、スウェーデン人開発者のDaniel Stenbergによって作られました。彼が最初のバージョンを書いたきっかけは、スウェーデンのチャットチャンネルにあるIRCボットのために為替レートを自動的に取得することでした — 壮大なインフラ構築計画ではなく、小さな個人的な必要性からの出発でした。人々はより多くのプロトコルやオプションを求め続け、この小さなユーティリティは、HTTP、HTTPS、FTP、そしてやがて数十もの他のプロトコルを介してデータを転送する汎用コマンドラインツールへと成長しました。Stenbergはその後、事実上curlの全歴史を通じて主要なメンテナーであり続けています。現在curlは、macOS、事実上すべてのLinuxディストリビューション、そして2018年以降はWindows 10以降にも標準搭載されており、ルーターや自動車からゲーム機、APIと通信するほぼすべての継続的インテグレーションパイプラインに至るまで、世界中の数十億台のデバイスで動作していると推定されています。1つの狭い個人的な問題の解決策として始まったものが、今日ではおそらく現存する中で最も広く使われているコマンドラインHTTPクライアントであり、インターネットが静かに最も依存しているオープンソースソフトウェアの1つとなっています。

このツールが生成するフラグを読み解く

デフォルトでは、curlはHTTPリダイレクトを追跡しません。サーバーが301や302のステータスと、別の場所を指すLocationヘッダーで応答した場合、素のcurlはそのリダイレクト応答 — あるいは空のボディ — を表示して停止します。Webブラウザが静かに行うように、自動的に新しいURLを追いかけることはありません。これは初めてcurlを使う非常に多くの人を混乱させます。ブラウザでは完璧に動作するURLが、curlでは一見理由もなく分かりにくい空の応答や誤った応答を返すのです — これは単に、ブラウザがcurlが追跡しなかったリダイレクトを追跡したからにすぎません。解決策は-L(--location)フラグで、これはcurlにリダイレクトの連鎖を最終的な行き先まで追跡するよう指示します。これはあまりに一般的な要件であるため、多くのエンジニアは、意図的にリダイレクトの挙動自体をテストしているのでない限り、デフォルトで-Lを使うようにしています。

コマンドに空白、引用符、あるいはシェル特有の文字($、&、;、バッククォート)を含むヘッダーやボディの内容が含まれるようになると、クォーティングの方法はもはや見た目だけの問題ではなくなります — それは、動作するリクエストと、curlが目にする前にシェルによって壊されてしまうリクエストとの違いを分けるものです。Authorization: Bearer abc 123のようなヘッダーを引用符なしで入力すると、シェルによって空白の箇所で分割されてしまい、curlは1つのまとまりではなくAuthorization:とBearerという2つの壊れた別々の引数を受け取ることになります。値全体をシングルクォートで囲むと、シェルは空白を含めて中身をすべてそのまま扱うようになります — ただし、シングルクォート自体の中にリテラルなシングルクォート文字を含めることはできません。その文字自体がクォートを閉じてしまうからです。この場合の標準的なエスケープ方法は、クォートを閉じ、バックスラッシュでエスケープしたシングルクォートを挿入し、再びクォートを開くというものです: '\''。このツールは、挿入するすべての値にこのエスケープ処理を自動的に適用するため、空白、引用符、その他の特殊文字を含むヘッダー、ボディの内容、認証情報が、常に正しく動作するコマンドを生成します — エスケープのルールを自分で覚えておく必要はありません。