curl を Rust に変換

Q: Rust reqwestとは何ですか？

reqwestは、hyperの上に構築されたRustで最も人気のあるHTTPクライアントです。ブロッキングと非同期の両方のAPI、serdeによる自動JSONシリアライズ、TLS、クッキー処理、およびプロキシサポートを提供します。cargo add reqwest --features jsonで追加できます。curl2codeがRust変換に使用するデフォルトのライブラリです。

Q: reqwest、hyper、ureqのどれを使うべきですか？

reqwestは、高レベルで機能が豊富、かつ非同期であるため、ほとんどのプロジェクトで第一選択となります。hyperはより低レベルで、最大限の制御を提供します（reqwestはこれに基づいています）。ureqは、非同期ランタイムへの依存がない、最小限のブロッキング専用クライアントです。同様の標準ライブラリアプローチについては、curl to Goまたはcurl to Cをご覧ください。

Q: Rustで認証を処理するにはどうすればよいですか？

Bearerの場合：client.get(url).bearer_auth(token)。Basicの場合：client.get(url).basic_auth(user, Some(pass))。または、.header("Authorization", value)で手動でヘッダーを設定します。curl2codeは、-uおよび-H 'Authorization: ...'フラグを適切なreqwestのメソッドに変換します。

Q: Rustでマルチパートフォームデータを送信するにはどうすればよいですか？

reqwest::multipart::Formを使用します。Form::new()で作成し、.text("key", "value")でテキストフィールドを、.file("field", path).await?でファイルを追加します。これをclient.post(url).multipart(form)に渡します。curl2codeはreqwestのマルチパート用に-Fフラグを処理します。

Q: RustでHTTPエラーを処理するにはどうすればよいですか？

reqwestは成功時にResponseを、失敗時にreqwest::ErrorをラップしたResultを返します。伝播には?演算子を使用してください。response.status().is_success()を確認するか、非2xxコードをエラーに変換するresponse.error_for_status()?を呼び出します。Rustの型システムにより、すべてのエラーパスがコンパイル時に明示的に処理されることが保証されます。

Q: reqwestにはどの非同期ランタイムが必要ですか？

reqwestはデフォルトでtokioランタイムを必要とします。main関数に#[tokio::main]を付与してください。非同期ランタイムなしでブロッキングで使用する場合は、blocking機能を有効にしてreqwest::blocking::Clientを使用します。curl2codeはデフォルトでtokioを使用した非同期コードを生成します。別の非同期エコシステムについては、curl to Go (goroutines) をご覧ください。

Q: Rust reqwestでタイムアウトを設定するにはどうすればよいですか？

クライアントに設定する場合：Client::builder().timeout(Duration::from_secs(30)).connect_timeout(Duration::from_secs(10)).build()?。リクエストごとに設定する場合：client.get(url).timeout(Duration::from_secs(5))。これらはcurlの--max-timeおよび--connect-timeoutフラグにマッピングされます。

Q: reqwestでプロキシを使用するにはどうすればよいですか？

クライアントビルダーでプロキシを設定します：Client::builder().proxy(Proxy::https("http://proxy:8080")?).build()?。HTTP、HTTPS、およびSOCKS5プロキシをサポートしています。また、reqwestはデフォルトでHTTP_PROXYおよびHTTPS_PROXY環境変数も尊重します。curl2codeは-xフラグをプロキシ設定に変換します。

Q: RustでJSONボディを含むPOSTリクエストを送信する方法は？

curl2codeを使用して、curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URLのようなcurlのPOSTコマンドをRustに変換します。生成されたコードではclient.post(url).json(&data).send().await?を使用します。curl2codeはJSONコンテンツを含む-d/--dataフラグを自動的に検出し、reqwestのコードに適切なContent-Typeヘッダーを設定します。

Q: RustでBearerトークン認証を追加する方法は？

curl -H "Authorization: Bearer YOUR_TOKEN" URLをcurl2codeに渡すと、認証ヘッダー.bearer_auth("YOUR_TOKEN")を含むreqwestのコードが生成されます。curl2codeは-H "Authorization: Bearer ..."と--oauth2-bearerフラグの両方からBearerトークンを検出します。Basic authの場合は、-u user:passを使用してください。

curl2code は、reqwest クレートを使用して curl コマンドを Rust コードに変換します。変換は完全なプライバシー保護のため、WebAssembly を介してブラウザ内で実行されます。Go については、curl to Go 変換ツールをご確認ください。C 言語については、curl to C をご覧ください。以下に、async/await を使用した実用的な Rust の例を示します。

ブラウザから curl をコピーする方法

1
デベロッパーツールを開く
F12 キーを押すか、Ctrl+Shift+Iを使用してブラウザのデベロッパーツールを開きます。
2
ネットワークタブに移動
ネットワークタブをクリックし、HTTP リクエストをトリガーするアクションを実行します。
3
cURL としてコピー
リクエストを右クリック → コピー → cURL としてコピー を選択します。その後、上に貼り付けてください。

Rust のコード例

1シンプルな GET リクエスト

curl コマンド

curl https://api.example.com/users

Rust · reqwest

extern crate reqwest;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::blocking::Client::builder()
        .redirect(reqwest::redirect::Policy::none())
        .build()
        .unwrap();
    let res = client.get("https://api.example.com/users")
        .send()?
        .text()?;
    println!("{}", res);

    Ok(())
}

2JSON ボディを含む POST

curl コマンド

curl -X POST https://api.example.com/users \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"john@example.com"}'

Rust · reqwest

extern crate reqwest;
use reqwest::header;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut headers = header::HeaderMap::new();
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = reqwest::blocking::Client::builder()
        .redirect(reqwest::redirect::Policy::none())
        .build()
        .unwrap();
    let res = client.post("https://api.example.com/users")
        .headers(headers)
        .body("{\"name\":\"John\",\"email\":\"john@example.com\"}")
        .send()?
        .text()?;
    println!("{}", res);

    Ok(())
}

3Bearer トークンを使用したリクエスト

curl コマンド

curl https://api.example.com/me \
  -H "Authorization: Bearer token123"

Rust · reqwest

extern crate reqwest;
use reqwest::header;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut headers = header::HeaderMap::new();
    headers.insert("Authorization", "Bearer token123".parse().unwrap());

    let client = reqwest::blocking::Client::builder()
        .redirect(reqwest::redirect::Policy::none())
        .build()
        .unwrap();
    let res = client.get("https://api.example.com/me")
        .headers(headers)
        .send()?
        .text()?;
    println!("{}", res);

    Ok(())
}

4マルチパートフォームのアップロード

curl コマンド

curl -X POST https://api.example.com/upload \
  -F "file=@document.pdf" \
  -F "description=My file"

Rust · reqwest

extern crate reqwest;
use reqwest::blocking::multipart;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let form = multipart::Form::new()
        .file("file", "document.pdf")?
        .text("description", "My file");

    let client = reqwest::blocking::Client::builder()
        .redirect(reqwest::redirect::Policy::none())
        .build()
        .unwrap();
    let res = client.post("https://api.example.com/upload")
        .multipart(form)
        .send()?
        .text()?;
    println!("{}", res);

    Ok(())
}

5カスタムヘッダー

curl コマンド

curl https://api.example.com/data \
  -H "X-API-Key: abc123" \
  -H "Accept: application/json" \
  -H "X-Request-ID: req-456"

Rust · reqwest

extern crate reqwest;
use reqwest::header;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut headers = header::HeaderMap::new();
    headers.insert("X-API-Key", "abc123".parse().unwrap());
    headers.insert("Accept", "application/json".parse().unwrap());
    headers.insert("X-Request-ID", "req-456".parse().unwrap());

    let client = reqwest::blocking::Client::builder()
        .redirect(reqwest::redirect::Policy::none())
        .build()
        .unwrap();
    let res = client.get("https://api.example.com/data")
        .headers(headers)
        .send()?
        .text()?;
    println!("{}", res);

    Ok(())
}

よくある質問

Rust reqwestとは何ですか？

reqwestは、hyperの上に構築されたRustで最も人気のあるHTTPクライアントです。ブロッキングと非同期の両方のAPI、serdeによる自動JSONシリアライズ、TLS、クッキー処理、およびプロキシサポートを提供します。cargo add reqwest --features jsonで追加できます。curl2codeがRust変換に使用するデフォルトのライブラリです。

reqwest、hyper、ureqのどれを使うべきですか？

reqwestは、高レベルで機能が豊富、かつ非同期であるため、ほとんどのプロジェクトで第一選択となります。hyperはより低レベルで、最大限の制御を提供します（reqwestはこれに基づいています）。ureqは、非同期ランタイムへの依存がない、最小限のブロッキング専用クライアントです。同様の標準ライブラリアプローチについては、curl to Goまたはcurl to Cをご覧ください。

Rustで認証を処理するにはどうすればよいですか？

Bearerの場合：client.get(url).bearer_auth(token)。Basicの場合：client.get(url).basic_auth(user, Some(pass))。または、.header("Authorization", value)で手動でヘッダーを設定します。curl2codeは、-uおよび-H 'Authorization: ...'フラグを適切なreqwestのメソッドに変換します。

Rustでマルチパートフォームデータを送信するにはどうすればよいですか？

reqwest::multipart::Formを使用します。Form::new()で作成し、.text("key", "value")でテキストフィールドを、.file("field", path).await?でファイルを追加します。これをclient.post(url).multipart(form)に渡します。curl2codeはreqwestのマルチパート用に-Fフラグを処理します。

RustでHTTPエラーを処理するにはどうすればよいですか？

reqwestは成功時にResponseを、失敗時にreqwest::ErrorをラップしたResultを返します。伝播には?演算子を使用してください。response.status().is_success()を確認するか、非2xxコードをエラーに変換するresponse.error_for_status()?を呼び出します。Rustの型システムにより、すべてのエラーパスがコンパイル時に明示的に処理されることが保証されます。

reqwestにはどの非同期ランタイムが必要ですか？

reqwestはデフォルトでtokioランタイムを必要とします。main関数に#[tokio::main]を付与してください。非同期ランタイムなしでブロッキングで使用する場合は、blocking機能を有効にしてreqwest::blocking::Clientを使用します。curl2codeはデフォルトでtokioを使用した非同期コードを生成します。別の非同期エコシステムについては、curl to Go (goroutines) をご覧ください。

Rust reqwestでタイムアウトを設定するにはどうすればよいですか？

クライアントに設定する場合：Client::builder().timeout(Duration::from_secs(30)).connect_timeout(Duration::from_secs(10)).build()?。リクエストごとに設定する場合：client.get(url).timeout(Duration::from_secs(5))。これらはcurlの--max-timeおよび--connect-timeoutフラグにマッピングされます。

reqwestでプロキシを使用するにはどうすればよいですか？

クライアントビルダーでプロキシを設定します：Client::builder().proxy(Proxy::https("http://proxy:8080")?).build()?。HTTP、HTTPS、およびSOCKS5プロキシをサポートしています。また、reqwestはデフォルトでHTTP_PROXYおよびHTTPS_PROXY環境変数も尊重します。curl2codeは-xフラグをプロキシ設定に変換します。

RustでJSONボディを含むPOSTリクエストを送信する方法は？

curl2codeを使用して、curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URLのようなcurlのPOSTコマンドをRustに変換します。生成されたコードではclient.post(url).json(&data).send().await?を使用します。curl2codeはJSONコンテンツを含む-d/--dataフラグを自動的に検出し、reqwestのコードに適切なContent-Typeヘッダーを設定します。

RustでBearerトークン認証を追加する方法は？

curl -H "Authorization: Bearer YOUR_TOKEN" URLをcurl2codeに渡すと、認証ヘッダー.bearer_auth("YOUR_TOKEN")を含むreqwestのコードが生成されます。curl2codeは-H "Authorization: Bearer ..."と--oauth2-bearerフラグの両方からBearerトークンを検出します。Basic authの場合は、-u user:passを使用してください。

RustでContent-Typeヘッダーを設定する方法は？

curl2codeはcurl -H "Content-Type: application/json" URLを、適切なヘッダー.header("Content-Type", "application/json")を含むreqwestのコードに変換します。-dデータの場合、curlはデフォルトでapplication/x-www-form-urlencodedを使用し、-Fフォームアップロードの場合はmultipart/form-dataを使用します。curl2codeはそれぞれを正しいreqwest APIにマッピングします。

便利なリンク

reqwest ドキュメント

docs.rs

標準ライブラリリファレンス

hyper.rs

curl man ページ

curl.se

curl ガイド

curl エラーコード

curl の終了コードを検索 — 原因、修正方法、デバッグのヒント。

curl でファイルをダウンロード

-o、-O でファイルを保存、リダイレクトの追跡、ダウンロードの再開など。

SSL、TLS、プロキシ

証明書、TLS バージョン、HTTP/SOCKS プロキシ、カスタム DNS の設定。

ブラウザから curl をコピーする方法

Rust のコード例

1シンプルな GET リクエスト

2JSON ボディを含む POST

3Bearer トークンを使用したリクエスト

4マルチパートフォームのアップロード

5カスタムヘッダー

よくある質問

便利なリンク

curl ガイド

curl を他の言語に変換

Rust のコード例

1シンプルな GET リクエスト

2JSON ボディを含む POST

3Bearer トークンを使用したリクエスト

4マルチパートフォームのアップロード

5カスタムヘッダー