המרת curl ל-Rust

Q: מה זה Rust reqwest?

reqwest היא ספריית ה-HTTP client הפופולרית ביותר עבור Rust, הבנויה על גבי hyper. היא מספקת ממשקי API חוסמים (blocking) ואסינכרוניים, סריאליזציית JSON אוטומטית דרך serde, TLS, ניהול עוגיות ותמיכה בפרוקסי. הוסף אותה עם cargo add reqwest --features json. זוהי ספריית ברירת המחדל ש-curl2code משתמש בה להמרות Rust.

Q: reqwest לעומת hyper לעומת ureq — במה כדאי להשתמש?

reqwest היא הבחירה המועדפת לרוב הפרויקטים — ברמה גבוהה, עשירה בתכונות ואסינכרונית. hyper היא ברמה נמוכה יותר ומעניקה שליטה מקסימלית (reqwest בנויה עליה). ureq היא לקוח מינימלי, חוסם בלבד, ללא תלות בזמן ריצה אסינכרוני. לגישה דומה של ספרייה סטנדרטית, ראה curl ל-Go או curl ל-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: איך שולחים נתוני טופס (multipart form data) ב-Rust?

השתמש ב-reqwest::multipart::Form: צור עם Form::new(), הוסף שדות טקסט עם .text("key", "value"), וקבצים עם .file("field", path).await?. העבר ל-client.post(url).multipart(form). curl2code מטפל בדגלי -F עבור multipart ב-reqwest.

Q: איך מטפלים בשגיאות HTTP ב-Rust?

reqwest מחזירה Result העוטף Response בהצלחה או reqwest::Error בכישלון — השתמש באופרטור ? להפצת השגיאה. בדוק את response.status().is_success() או קרא ל-response.error_for_status()? הממירה קודי סטטוס שאינם 2xx לשגיאות. מערכת הטיפוסים של Rust מבטיחה שכל נתיבי השגיאה יטופלו במפורש בזמן ההידור.

Q: איזה זמן ריצה אסינכרוני (async runtime) reqwest דורשת?

reqwest דורשת את זמן הריצה tokio כברירת מחדל. סמן את פונקציית ה-main שלך עם #[tokio::main]. לשימוש חוסם ללא זמן ריצה אסינכרוני, הפעל את תכונת ה-blocking והשתמש ב-reqwest::blocking::Client. curl2code מייצר קוד אסינכרוני עם tokio כברירת מחדל. לאקוסיסטם אסינכרוני אחר, ראה curl ל-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)). אלו ממופים לדגלי --max-time ו---connect-timeout של curl.

Q: איך משתמשים בפרוקסי עם reqwest?

הגדר פרוקסי בבונה הלקוח: Client::builder().proxy(Proxy::https("http://proxy:8080")?).build()?. תומך בפרוקסי HTTP, HTTPS ו-SOCKS5. reqwest מכבדת גם משתני סביבה HTTP_PROXY ו-HTTPS_PROXY כברירת מחדל. curl2code ממיר דגלי -x להגדרת פרוקסי.

Q: איך שולחים בקשת POST עם גוף JSON ב-Rust?

המירו פקודת curl POST כמו curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL ל-Rust באמצעות curl2code. הקוד שנוצר משתמש ב-client.post(url).json(&data).send().await?. curl2code מזהה באופן אוטומטי דגלי -d/--data עם תוכן JSON ומגדיר את כותרת Content-Type המתאימה בקוד ה-reqwest.

Q: איך מוסיפים אימות Bearer token ב-Rust?

העבירו את curl -H "Authorization: Bearer YOUR_TOKEN" URL ל-curl2code והוא יפיק קוד reqwest עם כותרת האימות: .bearer_auth("YOUR_TOKEN"). curl2code מזהה Bearer tokens גם מדגלי -H "Authorization: Bearer ..." וגם מדגלי --oauth2-bearer. עבור Basic auth, השתמשו ב--u user:pass.

curl2code ממיר פקודות curl לקוד Rust באמצעות ה-crate של reqwest. ההמרה מתבצעת בדפדפן שלך דרך WebAssembly לפרטיות מלאה. עבור Go, בדוק את ממיר curl ל-Go. עבור C, ראה curl ל-C. להלן דוגמאות Rust מעשיות עם async/await.

איך להעתיק curl מהדפדפן שלך

1
פתח את DevTools
לחץ על F12 או על Ctrl+Shift+I כדי לפתוח את כלי המפתחים של הדפדפן.
2
עבור ללשונית Network
לחץ על לשונית ה-Network ובצע את הפעולה שמפעילה את בקשת ה-HTTP.
3
העתק כ-cURL
לחץ קליק ימני על הבקשה ← Copy ← Copy as 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(())
}

2POST עם גוף JSON

פקודת 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(())
}

3בקשה עם Bearer Token

פקודת 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העלאת טופס Multipart

פקודת 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כותרות (Headers) מותאמות אישית

פקודת 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(())
}

שאלות נפוצות (FAQ)

מה זה Rust reqwest?

reqwest היא ספריית ה-HTTP client הפופולרית ביותר עבור Rust, הבנויה על גבי hyper. היא מספקת ממשקי API חוסמים (blocking) ואסינכרוניים, סריאליזציית JSON אוטומטית דרך serde, TLS, ניהול עוגיות ותמיכה בפרוקסי. הוסף אותה עם cargo add reqwest --features json. זוהי ספריית ברירת המחדל ש-curl2code משתמש בה להמרות Rust.

reqwest לעומת hyper לעומת ureq — במה כדאי להשתמש?

reqwest היא הבחירה המועדפת לרוב הפרויקטים — ברמה גבוהה, עשירה בתכונות ואסינכרונית. hyper היא ברמה נמוכה יותר ומעניקה שליטה מקסימלית (reqwest בנויה עליה). ureq היא לקוח מינימלי, חוסם בלבד, ללא תלות בזמן ריצה אסינכרוני. לגישה דומה של ספרייה סטנדרטית, ראה curl ל-Go או curl ל-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 המתאימות.

איך שולחים נתוני טופס (multipart form data) ב-Rust?

השתמש ב-reqwest::multipart::Form: צור עם Form::new(), הוסף שדות טקסט עם .text("key", "value"), וקבצים עם .file("field", path).await?. העבר ל-client.post(url).multipart(form). curl2code מטפל בדגלי -F עבור multipart ב-reqwest.

איך מטפלים בשגיאות HTTP ב-Rust?

reqwest מחזירה Result העוטף Response בהצלחה או reqwest::Error בכישלון — השתמש באופרטור ? להפצת השגיאה. בדוק את response.status().is_success() או קרא ל-response.error_for_status()? הממירה קודי סטטוס שאינם 2xx לשגיאות. מערכת הטיפוסים של Rust מבטיחה שכל נתיבי השגיאה יטופלו במפורש בזמן ההידור.

איזה זמן ריצה אסינכרוני (async runtime) reqwest דורשת?

reqwest דורשת את זמן הריצה tokio כברירת מחדל. סמן את פונקציית ה-main שלך עם #[tokio::main]. לשימוש חוסם ללא זמן ריצה אסינכרוני, הפעל את תכונת ה-blocking והשתמש ב-reqwest::blocking::Client. curl2code מייצר קוד אסינכרוני עם tokio כברירת מחדל. לאקוסיסטם אסינכרוני אחר, ראה curl ל-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)). אלו ממופים לדגלי --max-time ו---connect-timeout של curl.

איך משתמשים בפרוקסי עם reqwest?

הגדר פרוקסי בבונה הלקוח: Client::builder().proxy(Proxy::https("http://proxy:8080")?).build()?. תומך בפרוקסי HTTP, HTTPS ו-SOCKS5. reqwest מכבדת גם משתני סביבה HTTP_PROXY ו-HTTPS_PROXY כברירת מחדל. curl2code ממיר דגלי -x להגדרת פרוקסי.

איך שולחים בקשת POST עם גוף JSON ב-Rust?

המירו פקודת curl POST כמו curl -X POST -H "Content-Type: application/json" -d "{"key":"value"}" URL ל-Rust באמצעות curl2code. הקוד שנוצר משתמש ב-client.post(url).json(&data).send().await?. curl2code מזהה באופן אוטומטי דגלי -d/--data עם תוכן JSON ומגדיר את כותרת Content-Type המתאימה בקוד ה-reqwest.

איך מוסיפים אימות Bearer token ב-Rust?

העבירו את curl -H "Authorization: Bearer YOUR_TOKEN" URL ל-curl2code והוא יפיק קוד reqwest עם כותרת האימות: .bearer_auth("YOUR_TOKEN"). curl2code מזהה Bearer tokens גם מדגלי -H "Authorization: Bearer ..." וגם מדגלי --oauth2-bearer. עבור Basic auth, השתמשו ב--u user:pass.

איך מגדירים כותרת Content-Type ב-Rust?

curl2code ממיר את curl -H "Content-Type: application/json" URL לקוד reqwest עם הכותרת המתאימה: .header("Content-Type", "application/json"). עבור נתוני -d, curl משתמש כברירת מחדל ב-application/x-www-form-urlencoded; עבור העלאות טפסים עם -F, הוא משתמש ב-multipart/form-data. curl2code ממפה כל אחד מהם ל-API הנכון של reqwest.

קישורים שימושיים

תיעוד reqwest

docs.rs

תיעוד הספרייה הסטנדרטית

hyper.rs

דף ה-Man של curl

curl.se

מדריכי curl

קודי שגיאה של curl

חפשו כל קוד יציאה של curl — סיבות, תיקונים וטיפים לניפוי שגיאות.

הורדת קבצים עם curl

שמרו קבצים עם -o, -O, עקבו אחר הפניות, חדשו הורדות ועוד.

SSL, TLS ופרוקסי

הגדירו תעודות, גרסאות TLS, פרוקסי HTTP/SOCKS ו-DNS מותאם אישית.

איך להעתיק curl מהדפדפן שלך

דוגמאות קוד ב-Rust

1בקשת GET פשוטה

2POST עם גוף JSON

3בקשה עם Bearer Token

4העלאת טופס Multipart

5כותרות (Headers) מותאמות אישית

שאלות נפוצות (FAQ)

קישורים שימושיים

מדריכי curl

המרת curl לשפות אחרות

דוגמאות קוד ב-Rust

1בקשת GET פשוטה

2POST עם גוף JSON

3בקשה עם Bearer Token

4העלאת טופס Multipart

5כותרות (Headers) מותאמות אישית